blob: 15124007cbfd64ee96a79c93e5704fd8da160902 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
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),
|
