1 cfa37a7b 2004-04-10 devnull .TH SEEK 3
 2 cfa37a7b 2004-04-10 devnull .SH NAME
 3 cfa37a7b 2004-04-10 devnull seek \- change file offset
 4 cfa37a7b 2004-04-10 devnull .SH SYNOPSIS
 5 cfa37a7b 2004-04-10 devnull .B #include <u.h>
 6 cfa37a7b 2004-04-10 devnull .br
 7 cfa37a7b 2004-04-10 devnull .B #include <libc.h>
 8 cfa37a7b 2004-04-10 devnull .PP
 9 cfa37a7b 2004-04-10 devnull .B
10 cfa37a7b 2004-04-10 devnull vlong seek(int fd, vlong n, int type)
11 cfa37a7b 2004-04-10 devnull .SH DESCRIPTION
12 cfa37a7b 2004-04-10 devnull .I Seek
13 cfa37a7b 2004-04-10 devnull sets the offset for the file
14 cfa37a7b 2004-04-10 devnull associated with
15 cfa37a7b 2004-04-10 devnull .I fd
16 cfa37a7b 2004-04-10 devnull as follows:
17 cfa37a7b 2004-04-10 devnull .IP
18 cfa37a7b 2004-04-10 devnull If
19 cfa37a7b 2004-04-10 devnull .I type
20 cfa37a7b 2004-04-10 devnull is 0, the offset is set to
21 cfa37a7b 2004-04-10 devnull .I n
22 cfa37a7b 2004-04-10 devnull bytes.
23 cfa37a7b 2004-04-10 devnull .IP
24 cfa37a7b 2004-04-10 devnull If
25 cfa37a7b 2004-04-10 devnull .I type
26 cfa37a7b 2004-04-10 devnull is 1, the pointer is set to its current location plus
27 cfa37a7b 2004-04-10 devnull .IR n .
28 cfa37a7b 2004-04-10 devnull .IP
29 cfa37a7b 2004-04-10 devnull If
30 cfa37a7b 2004-04-10 devnull .I type
31 cfa37a7b 2004-04-10 devnull is 2, the pointer is set to the size of the
32 cfa37a7b 2004-04-10 devnull file plus
33 cfa37a7b 2004-04-10 devnull .IR n .
34 cfa37a7b 2004-04-10 devnull .PP
35 cfa37a7b 2004-04-10 devnull The new file offset value is returned.
36 cfa37a7b 2004-04-10 devnull .PP
37 cfa37a7b 2004-04-10 devnull Seeking in a directory is not allowed.
38 cfa37a7b 2004-04-10 devnull Seeking in a pipe is a no-op.
39 cfa37a7b 2004-04-10 devnull .SH SOURCE
40 c3674de4 2005-01-11 devnull .B \*9/src/lib9/seek.c
41 cfa37a7b 2004-04-10 devnull .SH SEE ALSO
42 d32deab1 2020-08-16 rsc .MR intro (3) ,
43 d32deab1 2020-08-16 rsc .MR open (3)
44 cfa37a7b 2004-04-10 devnull .SH DIAGNOSTICS
45 cfa37a7b 2004-04-10 devnull Sets
46 cfa37a7b 2004-04-10 devnull .IR errstr .
47 c8b6342d 2005-01-13 devnull .SH BUGS
48 c8b6342d 2005-01-13 devnull To avoid name conflicts with the underlying system,
49 c8b6342d 2005-01-13 devnull .I seek
50 c8b6342d 2005-01-13 devnull is a preprocessor macro defined as
51 c8b6342d 2005-01-13 devnull .IR p9seek ;
52 c8b6342d 2005-01-13 devnull see
53 d32deab1 2020-08-16 rsc .MR intro (3) .