summaryrefslogtreecommitdiffstats
path: root/man2/llseek.2
diff options
context:
space:
mode:
Diffstat (limited to 'man2/llseek.2')
-rw-r--r--man2/llseek.225
1 files changed, 19 insertions, 6 deletions
diff --git a/man2/llseek.2 b/man2/llseek.2
index d9cd6fe0d..3f43b0147 100644
--- a/man2/llseek.2
+++ b/man2/llseek.2
@@ -1,5 +1,6 @@
.\" Copyright (C) 1995 Andries Brouwer (aeb@cwi.nl)
.\" Written 10 June 1995 by Andries Brouwer <aeb@cwi.nl>
+.\" and Copyright (C) 2007, 2015, 2020, Michael Kerrisk <mtk.manpages@gmail.com>
.\"
.\" %%%LICENSE_START(VERBATIM)
.\" Permission is granted to make and distribute verbatim copies of this
@@ -25,7 +26,7 @@
.\"
.\" Modified Thu Oct 31 15:16:23 1996 by Eric S. Raymond <esr@thyrsus.com>
.\"
-.TH LLSEEK 2 2017-09-15 "Linux" "Linux Programmer's Manual"
+.TH LLSEEK 2 2020-12-21 "Linux" "Linux Programmer's Manual"
.SH NAME
_llseek \- reposition read/write file offset
.SH SYNOPSIS
@@ -41,14 +42,22 @@ _llseek \- reposition read/write file offset
.IR Note :
There is no glibc wrapper for this system call; see NOTES.
.SH DESCRIPTION
+Note: for information about the
+.BR llseek (3)
+library function, see
+.BR lseek64 (3).
+.PP
The
.BR _llseek ()
system call repositions the offset of the open file description associated
with the file descriptor
.I fd
-to
-.I (offset_high<<32) | offset_low
-bytes relative to the beginning of the file, the current file offset,
+to the value
+.IP
+(offset_high << 32) | offset_low
+.PP
+This new offset is a byte offset
+relative to the beginning of the file, the current file offset,
or the end of the file, depending on whether
.I whence
is
@@ -57,8 +66,12 @@ is
or
.BR SEEK_END ,
respectively.
-It returns the resulting file position in the argument
+.PP
+The new file offset is returned in the argument
.IR result .
+The type
+.I loff_t
+is a 64-bit signed type.
.PP
This system call exists on various 32-bit platforms to support
seeking to large file offsets.
@@ -96,7 +109,7 @@ wrapper function instead.
.BR open (2),
.BR lseek64 (3)
.SH COLOPHON
-This page is part of release 5.09 of the Linux
+This page is part of release 5.10 of the Linux
.I man-pages
project.
A description of the project,