IBM General Parallel File System for AIX: Administration and Programming Reference

gpfsDataShipStop_t Structure

Name

gpfsDataShipStop_t - Takes a file out of data shipping mode.

Structure

typedef struct
{
  int  structLen;
  int  structType;
} gpfsDataShipStop_t;

Description

GPFS takes the file out of data shipping mode:

• 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.
• While a gpfs_fcntl( ) call is blocked waiting for other threads, the call can be interrupted by any signal. If a signal is delivered to any of the waiting calls, all waiting calls on every node will be interrupted and will return EINTR. GPFS will 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 makes the gpfs_fcntl( ) call should use sigthreadmask to mask off delivery of this signal while inside the call.

Members

structLen

Length of the gpfsDataShipStop_t structure.

structType

The directive 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( ) call. All waiting calls, 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.