summaryrefslogtreecommitdiff
path: root/static/unix-v10/man2/lseek.2
diff options
context:
space:
mode:
authorJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-26 16:38:00 -0400
committerJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-26 16:38:00 -0400
commit97d5c458cfa039d857301e1ca7d5af3beb37131d (patch)
treeb460cd850d0537eb71806ba30358840377b27688 /static/unix-v10/man2/lseek.2
parentb89dc2331a50c63f8b33272a5c4c61ab98abdaa3 (diff)
build: Better Build System
Diffstat (limited to 'static/unix-v10/man2/lseek.2')
-rw-r--r--static/unix-v10/man2/lseek.247
1 files changed, 47 insertions, 0 deletions
diff --git a/static/unix-v10/man2/lseek.2 b/static/unix-v10/man2/lseek.2
new file mode 100644
index 00000000..ff982262
--- /dev/null
+++ b/static/unix-v10/man2/lseek.2
@@ -0,0 +1,47 @@
+.TH LSEEK 2
+.CT 2 file_io
+.SH NAME
+lseek \(mi seek, move read/write pointer
+.SH SYNOPSIS
+.nf
+.B long lseek(fildes, offset, whence)
+.B long offset;
+.fi
+.SH DESCRIPTION
+.I Lseek
+sets the file pointer for the file
+associated with
+.I fildes
+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 new file pointer value is returned.
+.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"
+.IR open (2),
+.IR fseek (3)
+.SH DIAGNOSTICS
+.BR EBADF ,
+.BR ESPIPE
+.SH BUGS
+.I Lseek
+doesn't affect some special files.