char *gfs_pio_set_view_index (GFS_File gf, int fragment_number, int fragment_index, char *host, int flags);
gfs_pio_set_view_index() changes the process's view of the data
in the file specified by gf to a file fragment with the index
When creating a new file, it is necessary to specify the total number
of file fragments fragment_number. Every parallel process
should specify the same fragment_number for the corresponding
file. When the file exists, GFARM_FILE_DONTCARE can be
specified. If fragment_number is different from the total
fragment number of the existent file, it is erroneous.
host is used for explicitly specifying a filesystem node. If
host is NULL, appropriate filesystem node is chosen.
Values of flag are constructed by a bitwise-inclusive-OR of
the following list.
File will be accessed sequentially.
File may be replicated to a local filesystem when accessing remotely.
This flag cannot be specified with GFARM_FILE_NOT_REPLICATE.
File may not be replicated to a local filesystem when accessing
remotely. This flag cannot be specified with
By default, Gfarm files are accessed as a whole file in global file
view where each fragment can be seamlessly accessed.
The function terminated successfully.
Insufficient memory was available.
The file is not a regular fragmented file.
The total number of file fragments is different from the existence
Invalid arguments are specified, for instance,
GFARM_FILE_DONTCARE is specified as the total number of
fragments of a newly created file.
An error except the above occurred. The reason is shown by its