xnu-3248.20.55.tar.gz

[apple/xnu.git] / bsd / man / man2 / lseek.2

diff --git a/bsd/man/man2/lseek.2 b/bsd/man/man2/lseek.2
index 09374f7641927970f9440811be68aeaf83d64e0b..0487277c6c3f77eccf186e6455e30b829dc53402 100644 (file)
--- a/bsd/man/man2/lseek.2
+++ b/bsd/man/man2/lseek.2
@@ -42,7 +42,11 @@
 .Sh SYNOPSIS
 .Fd #include <unistd.h>
 .Ft off_t
 .Sh SYNOPSIS
 .Fd #include <unistd.h>
 .Ft off_t

-.Fn lseek "int fildes" "off_t offset" "int whence"
+.Fo lseek
+.Fa "int fildes"
+.Fa "off_t offset"
+.Fa "int whence"
+.Fc

 .Sh DESCRIPTION
 The
 .Fn lseek
 .Sh DESCRIPTION
 The
 .Fn lseek


@@ -50,9 +54,9 @@ function repositions the offset of the file descriptor
 .Fa fildes
 to the
 argument
 .Fa fildes
 to the
 argument

-.Fa offset
+.Fa offset ,

 according to the directive
 according to the directive

-.Fa whence.
+.Fa whence .

 The argument
 .Fa fildes
 must be an open
 The argument
 .Fa fildes
 must be an open


@@ -112,15 +116,29 @@ the error.
 .Fn Lseek
 will fail and the file pointer will remain unchanged if:
 .Bl -tag -width Er
 .Fn Lseek
 will fail and the file pointer will remain unchanged if:
 .Bl -tag -width Er

+.\" ==========

 .It Bq Er EBADF
 .Em Fildes
 is not an open file descriptor.
 .It Bq Er EBADF
 .Em Fildes
 is not an open file descriptor.

-.It Bq Er ESPIPE
-.Em Fildes
-is associated with a pipe, socket, or FIFO.
+.\" ==========

 .It Bq Er EINVAL
 .Fa Whence
 is not a proper value.
 .It Bq Er EINVAL
 .Fa Whence
 is not a proper value.

+.\" ==========
+.It Bq Er EINVAL
+The seek location (calculated from
+.Fa offset
+and
+.Fa whence )
+is negative.
+.\" ==========
+.It Bq Er EOVERFLOW
+The seek location is too large to be stored
+in an object of type off_t.
+.\" ==========
+.It Bq Er ESPIPE
+.Em Fildes
+is associated with a pipe, socket, or FIFO.

 .El
 .Sh SEE ALSO
 .Xr dup 2 ,
 .El
 .Sh SEE ALSO
 .Xr dup 2 ,