20 Jun 2019
gfs_pio_seek 3 Gfarm
gfs_pio_seek reposition a stream

    #include <gfarm/gfarm.h>

`gfarm_error_t gfs_pio_seek` GFS_File gf gfarm_off_t offset int whence gfarm_off_t * result

## DESCRIPTION

The `gfs_pio_seek()` function sets the file position indicator for the file gf. The new position, measured in bytes, is obtained by adding offset bytes to the position specified by whence. If whence is set to GFARM_SEEK_SET, GFARM_SEEK_CUR, or GFARM_SEEK_END, the offset is relative to the start of the file, the current position indicator, or end-of-file, respectively. When result is not NULL, the new position returns to the address pointed by result.

## RETURN VALUES

`GFARM_ERR_NO_ERROR`

  The function terminated successfully.

`GFARM_ERR_NO_MEMORY`

  Insufficient memory was available.

`GFARM_ERR_INVALID_ARGUMENT`

  Specified whence or offset is invalid.

Other

  An error except the above occurred. The reason is shown by gfarm_error_string 3.

## SEE ALSO

gfs_pio_create 3, gfs_pio_open 3