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)