fuse.4: ffix

[thirdparty/man-pages.git] / man2 / llseek.2

diff --git a/man2/llseek.2 b/man2/llseek.2
index 090bf646ecd23e5705f16245b3718ea96418d6d5..8947d4ca1378248a89558caf3916829ad4e6e17b 100644 (file)
--- a/man2/llseek.2
+++ b/man2/llseek.2
@@ -1,4 +1,5 @@
 .\" Copyright (C) 1995 Andries Brouwer (aeb@cwi.nl)
+.\" Written 10 June 1995 by Andries Brouwer <aeb@cwi.nl>
 .\"
 .\" %%%LICENSE_START(VERBATIM)
 .\" Permission is granted to make and distribute verbatim copies of this
@@ -22,35 +23,34 @@
 .\" the source, must acknowledge the copyright and authors of this work.
 .\" %%%LICENSE_END
 .\"
-.\" Written 10 June 1995 by Andries Brouwer <aeb@cwi.nl>
 .\" Modified Thu Oct 31 15:16:23 1996 by Eric S. Raymond <esr@thyrsus.com>
 .\"
-.TH LLSEEK 2 2012-07-13 "Linux" "Linux Programmer's Manual"
+.TH LLSEEK 2 2017-09-15 "Linux" "Linux Programmer's Manual"
 .SH NAME
 _llseek \- reposition read/write file offset
 .SH SYNOPSIS
 .nf
 .B #include <sys/types.h>
 .B #include <unistd.h>
-.sp
+.PP
 .BI "int _llseek(unsigned int " fd ", unsigned long " offset_high ,
 .BI "            unsigned long " offset_low ", loff_t *" result ,
 .BI "            unsigned int " whence );
 .fi
-
+.PP
 .IR Note :
 There is no glibc wrapper for this system call; see NOTES.
 .SH DESCRIPTION
 The
 .BR _llseek ()
-function repositions the offset of the open file associated
+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 position in the file,
+bytes relative to the beginning of the file, the current file offset,
 or the end of the file, depending on whether
-.I  whence
+.I whence
 is
 .BR SEEK_SET ,
 .BR SEEK_CUR ,
@@ -59,6 +59,9 @@ or
 respectively.
 It returns the resulting file position in the argument
 .IR result .
+.PP
+This system call exists on various 32-bit platforms to support
+seeking to large file offsets.
 .SH RETURN VALUE
 Upon successful completion,
 .BR _llseek ()
@@ -82,8 +85,13 @@ is invalid.
 This function is Linux-specific, and should not be used in programs
 intended to be portable.
 .SH NOTES
-Glibc does not provide a wrapper for this system call; call it using
+Glibc does not provide a wrapper for this system call.
+To invoke it directly, use
 .BR syscall (2).
+However, you probably want to use the
+.BR lseek (2)
+wrapper function instead.
 .SH SEE ALSO
 .BR lseek (2),
+.BR open (2),
 .BR lseek64 (3)