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: big, start: int): big;

     DESCRIPTION
          Seek sets the 64-bit offset for the file associated with fd
          as follows:

               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 pipe is not allowed.  Seeking in a directory is
          allowed only if the new offset is zero.

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

     Page 1                       Plan 9            (printed 11/18/24)