SYS-SEEK(2)                                           SYS-SEEK(2)

     NAME
          seek - change file offset

     SYNOPSIS
          include "sys.m";
          sys := load Sys Sys->PATH;

          seek:  fn(fd: ref FD, off, start: int): int;

     DESCRIPTION
          Seek sets the offset for the file associated with fd as fol-
          lows:

               If start is Sys->SEEKSTART, the offset is set to off
               bytes.

               If start is Sys->SEEKRELA, the pointer is set to its
               current location plus off.

               If start is Sys->SEEKEND, the pointer is set to the
               size of the file plus off.

          The new file offset value is returned.

          Seeking in a directory is not allowed.

     SEE ALSO
          sys-intro(2), sys-open(2), bufio(2),

     Page 1                       Plan 9             (printed 4/26/24)