[src/trunk]: src/lib/libc/sys Sort ERRORS section.

[wiz <wiz%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/a5d7f0a887c8
branches:  trunk
changeset: 753635:a5d7f0a887c8
user:      wiz <wiz%NetBSD.org@localhost>
date:      Mon Apr 05 07:53:47 2010 +0000

description:
Sort ERRORS section.

diffstat:

 lib/libc/sys/acct.2   |   30 +++++-----
 lib/libc/sys/lseek.2  |    8 +-
 lib/libc/sys/open.2   |  139 ++++++++++++++++++++++++-------------------------
 lib/libc/sys/read.2   |   35 +++++------
 lib/libc/sys/unlink.2 |   36 ++++++------
 lib/libc/sys/write.2  |   66 +++++++++++------------
 6 files changed, 152 insertions(+), 162 deletions(-)

diffs (truncated from 508 to 300 lines):

diff -r 2664e1b893ed -r a5d7f0a887c8 lib/libc/sys/acct.2
--- a/lib/libc/sys/acct.2       Mon Apr 05 07:44:28 2010 +0000
+++ b/lib/libc/sys/acct.2       Mon Apr 05 07:53:47 2010 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: acct.2,v 1.17 2010/04/03 14:40:34 jruoho Exp $
+.\"    $NetBSD: acct.2,v 1.18 2010/04/05 07:53:47 wiz Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -86,10 +86,16 @@
 .Fn acct
 will fail if one of the following is true:
 .Bl -tag -width Er
-.It Bq Er EPERM
-The caller is not the super-user.
-.It Bq Er ENOTDIR
-A component of the path prefix is not a directory.
+.It Bq Er EACCES
+Search permission is denied for a component of the path prefix,
+or the path name is not a regular file.
+.It Bq Er EFAULT
+.Fa file
+points outside the process's allocated address space.
+.It Bq Er EIO
+An I/O error occurred while reading from or writing to the file system.
+.It Bq Er ELOOP
+Too many symbolic links were encountered in translating the pathname.
 .It Bq Er ENAMETOOLONG
 A component of a pathname exceeded
 .Dv {NAME_MAX}
@@ -98,18 +104,12 @@
 characters.
 .It Bq Er ENOENT
 The named file does not exist.
-.It Bq Er EACCES
-Search permission is denied for a component of the path prefix,
-or the path name is not a regular file.
-.It Bq Er ELOOP
-Too many symbolic links were encountered in translating the pathname.
+.It Bq Er ENOTDIR
+A component of the path prefix is not a directory.
+.It Bq Er EPERM
+The caller is not the super-user.
 .It Bq Er EROFS
 The named file resides on a read-only file system.
-.It Bq Er EFAULT
-.Fa file
-points outside the process's allocated address space.
-.It Bq Er EIO
-An I/O error occurred while reading from or writing to the file system.
 .El
 .Pp
 Also,
diff -r 2664e1b893ed -r a5d7f0a887c8 lib/libc/sys/lseek.2
--- a/lib/libc/sys/lseek.2      Mon Apr 05 07:44:28 2010 +0000
+++ b/lib/libc/sys/lseek.2      Mon Apr 05 07:53:47 2010 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: lseek.2,v 1.23 2010/04/03 15:42:22 jruoho Exp $
+.\"    $NetBSD: lseek.2,v 1.24 2010/04/05 07:53:47 wiz Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -115,12 +115,12 @@
 .It Bq Er EBADF
 .Fa fildes
 is not an open file descriptor.
+.It Bq Er EINVAL
+.Fa whence
+is not a proper value, or the resulting file offset would be invalid.
 .It Bq Er ESPIPE
 .Fa fildes
 is associated with a pipe, socket, or FIFO.
-.It Bq Er EINVAL
-.Fa whence
-is not a proper value, or the resulting file offset would be invalid.
 .El
 .Sh SEE ALSO
 .Xr dup 2 ,
diff -r 2664e1b893ed -r a5d7f0a887c8 lib/libc/sys/open.2
--- a/lib/libc/sys/open.2       Mon Apr 05 07:44:28 2010 +0000
+++ b/lib/libc/sys/open.2       Mon Apr 05 07:53:47 2010 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: open.2,v 1.40 2010/04/03 15:48:52 jruoho Exp $
+.\"    $NetBSD: open.2,v 1.41 2010/04/05 07:53:47 wiz Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -228,12 +228,51 @@
 .Sh ERRORS
 The named file is opened unless:
 .Bl -tag -width Er
-.It Bq Er EPERM
-The file's flags (see
-.Xr chflags 2 )
-don't allow the file to be opened.
-.It Bq Er ENOTDIR
-A component of the path prefix is not a directory.
+.It Bq Er EACCES
+Search permission is denied for a component of the path prefix,
+the required permissions (for reading and/or writing)
+are denied for the given flags, or
+.Dv O_CREAT
+is specified,
+the file does not exist,
+and the directory in which it is to be created
+does not permit writing.
+.It Bq Er EDQUOT
+.Dv O_CREAT
+is specified,
+the file does not exist,
+and the directory in which the entry for the new file
+is being placed cannot be extended because the
+user's quota of disk blocks on the file system
+containing the directory has been exhausted; or
+.Dv O_CREAT
+is specified,
+the file does not exist,
+and the user's quota of inodes on the file system on
+which the file is being created has been exhausted.
+.It Bq Er EEXIST
+.Dv O_CREAT
+and
+.Dv O_EXCL
+were specified and the file exists.
+.It Bq Er EFAULT
+.Fa path
+points outside the process's allocated address space.
+.It Bq Er EINTR
+The
+.Fn open
+operation was interrupted by a signal.
+.It Bq Er EIO
+An I/O error occurred while making the directory entry or
+allocating the inode for
+.Dv O_CREAT .
+.It Bq Er EISDIR
+The named file is a directory, and the arguments specify
+it is to be opened for writing.
+.It Bq Er ELOOP
+Too many symbolic links were encountered in translating the pathname.
+.It Bq Er EMFILE
+The process has already reached its limit for open file descriptors.
 .It Bq Er ENAMETOOLONG
 A component of a pathname exceeded
 .Dv NAME_MAX
@@ -244,27 +283,22 @@
 .Dv O_CREAT
 is not set and the named file does not exist, or
 a component of the path name that must exist does not exist.
-.It Bq Er EACCES
-Search permission is denied for a component of the path prefix,
-the required permissions (for reading and/or writing)
-are denied for the given flags, or
+.It Bq Er ENFILE
+The system file table is full.
+.It Bq Er ENOSPC
 .Dv O_CREAT
 is specified,
 the file does not exist,
-and the directory in which it is to be created
-does not permit writing.
-.It Bq Er ELOOP
-Too many symbolic links were encountered in translating the pathname.
-.It Bq Er EISDIR
-The named file is a directory, and the arguments specify
-it is to be opened for writing.
-.It Bq Er EROFS
-The named file resides on a read-only file system,
-and the file is to be modified.
-.It Bq Er EMFILE
-The process has already reached its limit for open file descriptors.
-.It Bq Er ENFILE
-The system file table is full.
+and the directory in which the entry for the new file is being placed
+cannot be extended because there is no space left on the file
+system containing the directory; or
+.Dv O_CREAT
+is specified,
+the file does not exist,
+and there are no free inodes on the file system on which the
+file is being created.
+.It Bq Er ENOTDIR
+A component of the path prefix is not a directory.
 .It Bq Er ENXIO
 The named file is a character special or block
 special file, and the device associated with this special file
@@ -275,61 +309,24 @@
 and
 .Dv O_WRONLY
 is set and no process has the file open for reading.
-.It Bq Er EINTR
-The
-.Fn open
-operation was interrupted by a signal.
 .It Bq Er EOPNOTSUPP
 .Dv O_SHLOCK
 or
 .Dv O_EXLOCK
-is specified but the underlying filesystem does not support locking.
-.It Bq Er ENOSPC
-.Dv O_CREAT
-is specified,
-the file does not exist,
-and the directory in which the entry for the new file is being placed
-cannot be extended because there is no space left on the file
-system containing the directory.
-.It Bq Er ENOSPC
-.Dv O_CREAT
-is specified,
-the file does not exist,
-and there are no free inodes on the file system on which the
-file is being created.
-.It Bq Er EDQUOT
-.Dv O_CREAT
-is specified,
-the file does not exist,
-and the directory in which the entry for the new file
-is being placed cannot be extended because the
-user's quota of disk blocks on the file system
-containing the directory has been exhausted.
-.It Bq Er EDQUOT
-.Dv O_CREAT
-is specified,
-the file does not exist,
-and the user's quota of inodes on the file system on
-which the file is being created has been exhausted.
-.It Bq Er EIO
-An I/O error occurred while making the directory entry or
-allocating the inode for
-.Dv O_CREAT .
+is specified but the underlying filesystem does not support locking; or
+an attempt was made to open a socket (not currently implemented).
+.It Bq Er EPERM
+The file's flags (see
+.Xr chflags 2 )
+don't allow the file to be opened.
+.It Bq Er EROFS
+The named file resides on a read-only file system,
+and the file is to be modified.
 .It Bq Er ETXTBSY
 The file is a pure procedure (shared text) file that is being
 executed and the
 .Fn open
 call requests write access.
-.It Bq Er EFAULT
-.Fa path
-points outside the process's allocated address space.
-.It Bq Er EEXIST
-.Dv O_CREAT
-and
-.Dv O_EXCL
-were specified and the file exists.
-.It Bq Er EOPNOTSUPP
-An attempt was made to open a socket (not currently implemented).
 .El
 .Sh SEE ALSO
 .Xr chmod 2 ,
diff -r 2664e1b893ed -r a5d7f0a887c8 lib/libc/sys/read.2
--- a/lib/libc/sys/read.2       Mon Apr 05 07:44:28 2010 +0000
+++ b/lib/libc/sys/read.2       Mon Apr 05 07:53:47 2010 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: read.2,v 1.32 2010/04/03 15:43:46 jruoho Exp $
+.\"    $NetBSD: read.2,v 1.33 2010/04/05 07:53:47 wiz Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -135,14 +135,15 @@
 .Fn preadv
 will succeed unless:
 .Bl -tag -width Er
+.It Bq Er EAGAIN
+The file was marked for non-blocking I/O,
+and no data were ready to be read.
 .It Bq Er EBADF
 .Fa d
 is not a valid file or socket descriptor open for reading.
 .It Bq Er EFAULT
 .Fa buf
 points outside the allocated address space.
-.It Bq Er EIO
-An I/O error occurred while reading from the file system.
 .It Bq Er EINTR
 A read from a slow device
 (i.e. one that might block for an arbitrary amount of time)
@@ -155,13 +156,11 @@
 .It Bq Er EINVAL
 The file pointer associated with
 .Fa d
-was negative.
-.It Bq Er EINVAL
-The total length of the I/O is more than can be expressed by the ssize_t
+was negative; or
+the total length of the I/O is more than can be expressed by the ssize_t
 return value.
-.It Bq Er EAGAIN
-The file was marked for non-blocking I/O,
-and no data were ready to be read.
+.It Bq Er EIO
+An I/O error occurred while reading from the file system.
 .El