NAME¶
gfs_pio_seek - reposition a stream
SYNOPSIS¶
#include <gfarm/gfarm.h>
char *gfs_pio_seek (GFS_File
gf, file_offset_t offset,
int whence, file_offset_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 0, 1, or 2, 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¶
- NULL
- The function terminated successfully.
- GFARM_ERR_NO_MEMORY
- Insufficient memory was available.
- 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)