GFS_PIO_SET_VIEW

GFS_PIO_SET_VIEW_LOCAL

Section: (3) Updated: 18 March 2003 Local index Up

NAME

gfs_pio_set_view_local - change file view to the corresponding fragment

SYNOPSIS

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.