GFS_PIO_SET_VIEW_LOCAL(3)
NAME
gfs_pio_set_view_local - change file view to the corresponding fragment
SYNOPSIS
#include <gfarm/gfarm.h> char *gfs_pio_set_view_local (GFS_File gf, int flags);
DESCRIPTION
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.
- GFARM_ERR_NO_MEMORY
- Insufficient memory was available.
- GFARM_ERR_OPERATION_NOT_PERMITTED
- The file is not a fragmented file.
- GFARM_ERR_FRAGMENT_NUMBER_DOES_NOT_MATCH
- The total number of file fragments is different from the existence one.
- Others An error except the above occurred. The reason is shown by its
- pointed strings.