# fseek(3)

    NAME
         fseek, ftell, rewind - reposition a stream

    SYNOPSIS
         #include <stdio.h>

         int fseek(FILE *stream, long offset, int ptrname)
         long ftell(FILE *stream)
         void rewind(FILE *stream)

    DESCRIPTION
         Fseek sets the position of the next input  or  output  operation  on  the
         stream.  The new position is at the signed distance offset bytes from the
         beginning, the current position, or the end of  the  file,  according  as
         ptrname has the value 0, 1, or 2.

         Fseek undoes any effects of ungetc(3).

         Ftell returns the current value of the offset relative to  the  beginning
         of the file associated with the named stream.  It is measured in bytes on
         UNIX; on some other systems it is a magic cookie, and the only  foolproof
         way to obtain an offset for fseek.

         Rewind(stream) is equivalent to fseek(stream, 0L, 0).

    SEE ALSO
         lseek(2), fopen(3).

    DIAGNOSTICS
         Fseek returns -1 for improper seeks, otherwise zero.