gfs_pio_set_view_local3
Change file view to the corresponding fragment
Usage
#include <gfarm/gfarm.h>
char *gfs_pio_set_view_local (GFS_File gf, int flags);
Overview
gfs_pio_set_view_local() changes the process's view of the data in the file specified by gf to a file fragment in the local file view. The local file view model assumes each process has its own file fragment which is specified by the argument node of gfs_pio_set_local(3).
The total number of file fragments is also specified by the argument nnode of gfs_pio_set_local(3). If it is different from the total fragment number of the existent file, it is erroneous.
Before changing to the local file view, it is necessary to call gfs_pio_set_local(3) in advance.
Values of flag are constructed by a bitwise-inclusive-OR of GFARM_FILE_SEQUENTIAL, GFARM_FILE_REPLICATE, and GFARM_FILE_NOT_REPLICATE. For details, refer to gfs_pio_set_view_index(3).
By default, Gfarm files are accessed as a whole file in global file view where each fragment can be seamlessly accessed.
Return values
NULL
|
The function terminated successfully. |
|---|---|
|
Insufficient memory was available. |
|
The file is not a fragmented file. |
|
The total number of file fragments is different from the existence one. |
|
An error except the above occurred. The reason is shown by its pointed strings. |
Releases
Unchanged in 2 releases since Debian 6.0 (Squeeze).