Return to lseek.2 CVS log

Up to [Research Unix] / researchv10dc / man / man2

Annotation of researchv10dc/man/man2/lseek.2, revision 1.1.1.1

1.1       root        1: .TH LSEEK 2
                      2: .CT 2 file_io
                      3: .SH NAME
                      4: lseek, llseek \(mi seek, move read/write pointer
                      5: .SH SYNOPSIS
                      6: .B long lseek(fildes, offset, whence)
                      7: .br
                      8: .B long offset;
                      9: .PP
                     10: .B Long llseek(fildes, offset, whence)
                     11: .br
                     12: .B Long offset;
                     13: .SH DESCRIPTION
                     14: .I Lseek
                     15: and
                     16: .I llseek
                     17: set the file pointer for the file
                     18: associated with
                     19: .I fildes
                     20: as follows:
                     21: .IP
                     22: If
                     23: .I whence
                     24: is 0, the pointer is set to
                     25: .I offset
                     26: bytes.
                     27: .IP
                     28: If
                     29: .I whence
                     30: is 1, the pointer is set to its current location plus
                     31: .IR offset .
                     32: .IP
                     33: If
                     34: .I whence
                     35: is 2, the pointer is set to the size of the
                     36: file plus
                     37: .IR offset .
                     38: .PP
                     39: The new file pointer value is returned.
                     40: .PP
                     41: Type
                     42: .I Long
                     43: is a 64-bit quantity.
                     44: .PP
                     45: Seeking far beyond the end of a file, then writing,
                     46: creates a gap or `hole,' which occupies no
                     47: physical space and reads as zeros.
                     48: .SH "SEE ALSO"
                     49: .IR open (2),
                     50: .IR fseek (3)
                     51: .SH DIAGNOSTICS
                     52: .BR EBADF ,
                     53: .BR ESPIPE
                     54: .SH BUGS
                     55: .I Lseek
                     56: doesn't affect some special files.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.