|
DataMuseum.dkPresents historical artifacts from the history of: ICL Comet 32 |
This is an automatic "excavation" of a thematic subset of
See our Wiki for more about ICL Comet 32 Excavated with: AutoArchaeologist - Free & Open Source Software. |
top - metrics - download
Length: 1142 (0x476)
Types: TextFile
Notes: UNIX file
Names: »lseek.2«
└─⟦26887b7e0⟧ Bits:30009717 Comet 32 harddisk image
└─⟦28c352965⟧ »/a« UNIX Filesystem
└─⟦this⟧ »usr/man/man2/lseek.2«
.ig @(#)lseek.2 2.1 7/1/84 @(#)Copyright (C) 1983 by National Semiconductor Corp. .. .TH LSEEK 2 .SH NAME lseek, tell \- move read/write pointer .SH SYNOPSIS .nf .B long lseek(fildes, offset, whence) .B long offset; .PP .B long tell(fildes) .fi .SH DESCRIPTION The file descriptor refers to a file open for reading or writing. The read (resp. write) pointer for the file is set as follows: .IP If .I whence is 0, the pointer is set to .I offset bytes. .IP If .I whence is 1, the pointer is set to its current location plus .IR offset . .IP If .I whence is 2, the pointer is set to the size of the file plus .IR offset . .PP The returned value is the resulting pointer location. .PP The obsolete function .IR tell ( fildes ) is identical to .IR lseek ( "fildes, 0L, 1" ). .PP Seeking far beyond the end of a file, then writing, creates a gap or `hole', which occupies no physical space and reads as zeros. .SH "SEE ALSO" open(2), creat(2), fseek(3) .SH DIAGNOSTICS \-1 is returned for an undefined file descriptor, seek on a pipe, or seek to a position before the beginning of file. .SH BUGS .I Lseek is a no-op on character special files.