Source-Changes-HG archive
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]
[src/trunk]: src/lib/libc/sys Sort ERRORS section.
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
Home |
Main Index |
Thread Index |
Old Index