summaryrefslogtreecommitdiff
path: root/static/inferno/man2/sys-seek.2
diff options
context:
space:
mode:
Diffstat (limited to 'static/inferno/man2/sys-seek.2')
-rw-r--r--static/inferno/man2/sys-seek.248
1 files changed, 48 insertions, 0 deletions
diff --git a/static/inferno/man2/sys-seek.2 b/static/inferno/man2/sys-seek.2
new file mode 100644
index 00000000..15124007
--- /dev/null
+++ b/static/inferno/man2/sys-seek.2
@@ -0,0 +1,48 @@
+.TH SYS-SEEK 2
+.SH NAME
+seek \- change file offset
+.SH SYNOPSIS
+.EX
+include "sys.m";
+sys := load Sys Sys->PATH;
+
+seek: fn(fd: ref FD, off: big, start: int): big;
+.EE
+.SH DESCRIPTION
+.B Seek
+sets the 64-bit offset for the file
+associated with
+.I fd
+as follows:
+.IP
+If
+.I start
+is
+.BR Sys->SEEKSTART ,
+the offset is set to
+.I off
+bytes.
+.IP
+If
+.I start
+is
+.BR Sys->SEEKRELA ,
+the pointer is set to its current location plus
+.IR off .
+.IP
+If
+.I start
+is
+.BR Sys->SEEKEND ,
+the pointer is set to the size of the
+file plus
+.IR off .
+.PP
+The new file offset value is returned.
+.PP
+Seeking in a pipe is not allowed.
+Seeking in a directory is allowed only if the new offset is zero.
+.SH SEE ALSO
+.IR sys-intro (2),
+.IR sys-open (2),
+.IR bufio (2),