.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "GFS_PIO_SEEK" "3" "18 March 2003" "Gfarm" ""
.SH NAME
gfs_pio_seek \- reposition a stream
.SH SYNOPSIS
.sp
\fB#include <gfarm/gfarm.h>
.sp
char *gfs_pio_seek (GFS_File \fIgf\fB, file_offset_t \fIoffset\fB, int \fIwhence\fB, file_offset_t * \fIresult\fB);
\fR
.SH "DESCRIPTION"
.PP
The \fBgfs_pio_seek()\fR function sets the file position indicator for
the file \fIgf\fR.  The new position, measured in bytes, is obtained
by adding \fIoffset\fR bytes to the position specified by
\fIwhence\fR.  If \fIwhence\fR 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 \fIresult\fR is not NULL, the new
position returns to the address pointed by \fIresult\fR.
.SH "RETURN VALUES"
.TP
\fBNULL\fR
The function terminated successfully.
.TP
\fBGFARM_ERR_NO_MEMORY\fR
Insufficient memory was available.
.TP
\fBOthers\fR
An error except the above occurred.  The reason is shown by its
pointed strings.
.SH "SEE ALSO"
.PP
\fBgfs_pio_create\fR(3),
\fBgfs_pio_open\fR(3)