GPFS: Administration and Programming Reference - IRA Home

gpfsDataShipStop_t Structure
Name
gpfsDataShipStop_t – Takes a file out of data shipping mode.
Library
GPFS Library (libgpfs.a for AIX, libgpfs.so for Linux)
Structure
typedef struct
{
int structLen;
int structType;
} gpfsDataShipStop_t;
Description
The gpfsDataShipStop_t structure takes a file out of data shipping mode.
GPFS takes the file out of data shipping mode:
v GPFS waits for all threads that issued the GPFS_DATA_SHIP_START directive to issue this directive,
then flushes all dirty file data to disk.
v While a gpfs_fcntl() invocation is blocked waiting for other threads, the subroutine can be interrupted
by any signal. If a signal is delivered to any of the waiting invocations, all waiting subroutines on every
node are interrupted and return EINTR. GPFS does not cancel data shipping mode if such a signal
occurs. It is the responsibility of the application to mask off any signals that might normally occur while
waiting for another node in the data shipping collective. Several libraries use SIGALRM; the thread that
issues the gpfs_fcntl() should use sigthreadmask to mask off delivery of this signal while inside the
subroutine.
Members
structLen Length of the gpfsDataShipStop_t structure.
structType Structure identifier GPFS_DATA_SHIP_STOP.
Error status
EIO An error occurred while flushing dirty data.
EINTR A signal was delivered to a blocked gpfs_fcntl() subroutine. All waiting subroutines, on
every node, are interrupted.
EINVAL An attempt has been made to issue the GPFS_DATA_SHIP_STOP directive from a node
or thread that is not part of this data shipping collective.
An attempt has been made to issue the GPFS_DATA_SHIP_STOP directive on a file that
is not in data shipping mode.
ESTALE A node in the data shipping collective has gone down.
Location
/usr/lpp/mmfs/lib/libgpfs.a for AIX, /usr/lpp/mmfs/lib/libgpfs.so for Linux
352 GPFS: Administration and Programming Reference