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.
SEE ALSO
gfs_pio_create(3), gfs_pio_open(3), gfs_pio_set_local(3), gfs_pio_set_view_index(3)