]> git.ipfire.org Git - thirdparty/man-pages.git/commitdiff
man/man2/[_]llseek.2: Change which is the page and which is the link page
authorAlejandro Colomar <alx@kernel.org>
Sat, 6 Jun 2026 17:53:17 +0000 (19:53 +0200)
committerAlejandro Colomar <alx@kernel.org>
Sat, 6 Jun 2026 17:59:36 +0000 (19:59 +0200)
The system call is __NR__llseek, and thus _llseek.  Make _llseek.2 be
the actual page.  Since the system call is called sys_llseek within the
kernel, keep llseek.2 as a link page.

Signed-off-by: Alejandro Colomar <alx@kernel.org>
man/man2/_llseek.2
man/man2/llseek.2

index d15dbee55dd00d15f0166f234801ba8ba41f67d1..6056c3e643268089dc540357910b64e9b6b97fe7 100644 (file)
@@ -1 +1,86 @@
-.so man2/llseek.2
+.\" Copyright 1995, Andries E. Brouwer <aeb@cwi.nl>
+.\" Copyright 2007-2020, Michael Kerrisk <mtk.manpages@gmail.com>
+.\" Copyright, the authors of the Linux man-pages project
+.\"
+.\" SPDX-License-Identifier: Linux-man-pages-copyleft
+.\"
+.TH _llseek 2 (date) "Linux man-pages (unreleased)"
+.SH NAME
+_llseek \- reposition read/write file offset
+.SH LIBRARY
+Standard C library
+.RI ( libc ,\~ \-lc )
+.SH SYNOPSIS
+.nf
+.BR "#include <sys/syscall.h>" "      /* Definition of " SYS_* " constants */"
+.B #include <unistd.h>
+.P
+.BI "int syscall(SYS__llseek, unsigned int " fd ", unsigned long " offset_high ,
+.BI "            unsigned long " offset_low ", loff_t *" result ,
+.BI "            unsigned int " whence );
+.fi
+.P
+.IR Note :
+glibc provides no wrapper for
+.BR _llseek (),
+necessitating the use of
+.BR syscall (2).
+.SH DESCRIPTION
+The
+.BR _llseek ()
+system call repositions the offset of the open file description associated
+with the file descriptor
+.I fd
+to the value
+.IP
+(offset_high << 32) | offset_low
+.P
+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
+.BR SEEK_SET ,
+.BR SEEK_CUR ,
+or
+.BR SEEK_END ,
+respectively.
+.P
+The new file offset is returned in the argument
+.IR result .
+The type
+.I loff_t
+is a 64-bit signed type.
+.P
+This system call exists on various 32-bit platforms to support
+seeking to large file offsets.
+.SH RETURN VALUE
+Upon successful completion,
+.BR _llseek ()
+returns 0.
+Otherwise, a value of \-1 is returned and
+.I errno
+is set to indicate the error.
+.SH ERRORS
+.TP
+.B EBADF
+.I fd
+is not an open file descriptor.
+.TP
+.B EFAULT
+Problem with copying results to user space.
+.TP
+.B EINVAL
+.I whence
+is invalid.
+.SH VERSIONS
+You probably want to use the
+.BR lseek (2)
+wrapper function instead.
+.SH STANDARDS
+Linux.
+.SH SEE ALSO
+.BR llseek (3),
+.BR lseek (2),
+.BR open (2),
+.BR lseek64 (3)
index 6056c3e643268089dc540357910b64e9b6b97fe7..29814a674b1ae03e6c6d0fface687025fab69fa4 100644 (file)
@@ -1,86 +1 @@
-.\" Copyright 1995, Andries E. Brouwer <aeb@cwi.nl>
-.\" Copyright 2007-2020, Michael Kerrisk <mtk.manpages@gmail.com>
-.\" Copyright, the authors of the Linux man-pages project
-.\"
-.\" SPDX-License-Identifier: Linux-man-pages-copyleft
-.\"
-.TH _llseek 2 (date) "Linux man-pages (unreleased)"
-.SH NAME
-_llseek \- reposition read/write file offset
-.SH LIBRARY
-Standard C library
-.RI ( libc ,\~ \-lc )
-.SH SYNOPSIS
-.nf
-.BR "#include <sys/syscall.h>" "      /* Definition of " SYS_* " constants */"
-.B #include <unistd.h>
-.P
-.BI "int syscall(SYS__llseek, unsigned int " fd ", unsigned long " offset_high ,
-.BI "            unsigned long " offset_low ", loff_t *" result ,
-.BI "            unsigned int " whence );
-.fi
-.P
-.IR Note :
-glibc provides no wrapper for
-.BR _llseek (),
-necessitating the use of
-.BR syscall (2).
-.SH DESCRIPTION
-The
-.BR _llseek ()
-system call repositions the offset of the open file description associated
-with the file descriptor
-.I fd
-to the value
-.IP
-(offset_high << 32) | offset_low
-.P
-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
-.BR SEEK_SET ,
-.BR SEEK_CUR ,
-or
-.BR SEEK_END ,
-respectively.
-.P
-The new file offset is returned in the argument
-.IR result .
-The type
-.I loff_t
-is a 64-bit signed type.
-.P
-This system call exists on various 32-bit platforms to support
-seeking to large file offsets.
-.SH RETURN VALUE
-Upon successful completion,
-.BR _llseek ()
-returns 0.
-Otherwise, a value of \-1 is returned and
-.I errno
-is set to indicate the error.
-.SH ERRORS
-.TP
-.B EBADF
-.I fd
-is not an open file descriptor.
-.TP
-.B EFAULT
-Problem with copying results to user space.
-.TP
-.B EINVAL
-.I whence
-is invalid.
-.SH VERSIONS
-You probably want to use the
-.BR lseek (2)
-wrapper function instead.
-.SH STANDARDS
-Linux.
-.SH SEE ALSO
-.BR llseek (3),
-.BR lseek (2),
-.BR open (2),
-.BR lseek64 (3)
+.so man2/_llseek.2