diff options
author | Michael Kerrisk <mtk.manpages@gmail.com> | 2021-01-07 08:12:28 +0100 |
---|---|---|
committer | Michael Kerrisk <mtk.manpages@gmail.com> | 2021-01-07 14:27:35 +0100 |
commit | f6a4078be5cf1248a561e89b1fb1f1fb61515f41 (patch) | |
tree | 7a0d8ff61f066add969457a1baf017370b702d93 | |
parent | 855d489a7f90cfeaae45c55f80a65dc2135aaa75 (diff) | |
download | man-pages-f6a4078be5cf1248a561e89b1fb1f1fb61515f41.tar.gz |
Various pages: Standardize wording around setting of 'errno' on error
In the RETURN VALUE sections, a number of different wordings
are used in to describe the fact that 'errno' is set on error.
There's no reason for the difference in wordings, since the same
thing is being described in each case. Switch to a standard
wording that is the same as FreeBSD and similar to the wording
used in POSIX.1.
In this change, fix some instances stating that 'errno' is set
"appropriately" to instead say "to indicate the error".
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
157 files changed, 167 insertions, 165 deletions
diff --git a/man2/access.2 b/man2/access.2 index 93e83c6dd2..7f796d00af 100644 --- a/man2/access.2 +++ b/man2/access.2 @@ -211,7 +211,7 @@ is and the file does not exist, or some other error occurred), \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .BR access () and diff --git a/man2/acct.2 b/man2/acct.2 index 856c4a4099..40b813d02b 100644 --- a/man2/acct.2 +++ b/man2/acct.2 @@ -69,7 +69,7 @@ An argument of NULL causes accounting to be turned off. On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EACCES diff --git a/man2/alloc_hugepages.2 b/man2/alloc_hugepages.2 index 88aea0f912..6194424291 100644 --- a/man2/alloc_hugepages.2 +++ b/man2/alloc_hugepages.2 @@ -113,7 +113,7 @@ returns the allocated virtual address, and returns zero. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B ENOSYS diff --git a/man2/bind.2 b/man2/bind.2 index ee01d2157a..548391f1dc 100644 --- a/man2/bind.2 +++ b/man2/bind.2 @@ -154,7 +154,7 @@ See EXAMPLES below. On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EACCES diff --git a/man2/bpf.2 b/man2/bpf.2 index d8ce409437..9034f32160 100644 --- a/man2/bpf.2 +++ b/man2/bpf.2 @@ -985,7 +985,7 @@ Zero. .PP On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B E2BIG diff --git a/man2/capget.2 b/man2/capget.2 index cf680af6ef..ac68342954 100644 --- a/man2/capget.2 +++ b/man2/capget.2 @@ -167,7 +167,7 @@ to all members of the process group whose ID is \-\fIpid\fP. On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .PP The calls fail with the error .BR EINVAL , diff --git a/man2/chdir.2 b/man2/chdir.2 index e49c62b883..e157e5417e 100644 --- a/man2/chdir.2 +++ b/man2/chdir.2 @@ -68,7 +68,7 @@ open file descriptor. On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS Depending on the filesystem, other errors can be returned. The more diff --git a/man2/chmod.2 b/man2/chmod.2 index 38d523030d..a54aec7ed9 100644 --- a/man2/chmod.2 +++ b/man2/chmod.2 @@ -231,7 +231,7 @@ for an explanation of the need for On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS Depending on the filesystem, errors other than those listed below can be returned. diff --git a/man2/chown.2 b/man2/chown.2 index 22f7603159..304fef293f 100644 --- a/man2/chown.2 +++ b/man2/chown.2 @@ -218,7 +218,7 @@ for an explanation of the need for On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS Depending on the filesystem, errors other than those listed below can be returned. diff --git a/man2/chroot.2 b/man2/chroot.2 index 2ac7b04e72..70a7dde17c 100644 --- a/man2/chroot.2 +++ b/man2/chroot.2 @@ -112,7 +112,7 @@ descriptors may allow access to files outside the chroot tree. On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS Depending on the filesystem, other errors can be returned. The more general errors are listed below: diff --git a/man2/clone.2 b/man2/clone.2 index 84a367d49f..5e57802682 100644 --- a/man2/clone.2 +++ b/man2/clone.2 @@ -1200,7 +1200,7 @@ in the caller's thread of execution. On failure, \-1 is returned in the caller's context, no child process will be created, and .I errno -will be set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EAGAIN diff --git a/man2/close.2 b/man2/close.2 index d19fbeb934..fed7707198 100644 --- a/man2/close.2 +++ b/man2/close.2 @@ -67,7 +67,7 @@ the file is deleted. returns zero on success. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EBADF diff --git a/man2/connect.2 b/man2/connect.2 index e8ad37314f..9572676efc 100644 --- a/man2/connect.2 +++ b/man2/connect.2 @@ -137,7 +137,7 @@ is supported on Linux since kernel 2.2.) If the connection or binding succeeds, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS The following are general socket errors only. There may be other domain-specific error codes. diff --git a/man2/create_module.2 b/man2/create_module.2 index 7121479138..9b47d48547 100644 --- a/man2/create_module.2 +++ b/man2/create_module.2 @@ -31,7 +31,7 @@ This system call requires privilege. On success, returns the kernel address at which the module will reside. On error, \-1 is returned and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EEXIST diff --git a/man2/delete_module.2 b/man2/delete_module.2 index 1030e96986..cb78cf4847 100644 --- a/man2/delete_module.2 +++ b/man2/delete_module.2 @@ -125,7 +125,7 @@ Using this flag taints the kernel (TAINT_FORCED_RMMOD). On success, zero is returned. On error, \-1 is returned and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EBUSY diff --git a/man2/dup.2 b/man2/dup.2 index 5c5f0c76e6..dedc4b2ef6 100644 --- a/man2/dup.2 +++ b/man2/dup.2 @@ -152,7 +152,7 @@ On success, these system calls return the new file descriptor. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EBADF diff --git a/man2/epoll_ctl.2 b/man2/epoll_ctl.2 index 3ee192fabd..538b370c06 100644 --- a/man2/epoll_ctl.2 +++ b/man2/epoll_ctl.2 @@ -316,7 +316,7 @@ When an error occurs, .BR epoll_ctl () returns \-1 and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EBADF diff --git a/man2/epoll_wait.2 b/man2/epoll_wait.2 index 55890c82a5..8ade432979 100644 --- a/man2/epoll_wait.2 +++ b/man2/epoll_wait.2 @@ -181,7 +181,7 @@ When an error occurs, .BR epoll_wait () returns \-1 and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EBADF diff --git a/man2/execve.2 b/man2/execve.2 index b6698da45a..2280c03aea 100644 --- a/man2/execve.2 +++ b/man2/execve.2 @@ -441,7 +441,7 @@ On success, .BR execve () does not return, on error \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B E2BIG diff --git a/man2/execveat.2 b/man2/execveat.2 index b5d1cd57ed..ef3606d8b0 100644 --- a/man2/execveat.2 +++ b/man2/execveat.2 @@ -111,7 +111,7 @@ On success, does not return. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS The same errors that occur for .BR execve (2) diff --git a/man2/fcntl.2 b/man2/fcntl.2 index f8d15f6026..e5289043e2 100644 --- a/man2/fcntl.2 +++ b/man2/fcntl.2 @@ -1661,7 +1661,7 @@ Zero. .PP On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .BR EACCES " or " EAGAIN diff --git a/man2/flock.2 b/man2/flock.2 index beb89d1288..61d4b53968 100644 --- a/man2/flock.2 +++ b/man2/flock.2 @@ -115,7 +115,7 @@ mode in which the file was opened. On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EBADF diff --git a/man2/fork.2 b/man2/fork.2 index ffc1bc1f65..c93e9fa78f 100644 --- a/man2/fork.2 +++ b/man2/fork.2 @@ -218,7 +218,7 @@ and 0 is returned in the child. On failure, \-1 is returned in the parent, no child process is created, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EAGAIN diff --git a/man2/fsync.2 b/man2/fsync.2 index 5e577e3794..8b2151c413 100644 --- a/man2/fsync.2 +++ b/man2/fsync.2 @@ -119,7 +119,7 @@ require all metadata to be synchronized with the disk. On success, these system calls return zero. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EBADF diff --git a/man2/get_kernel_syms.2 b/man2/get_kernel_syms.2 index 27661f0bee..063f533fc1 100644 --- a/man2/get_kernel_syms.2 +++ b/man2/get_kernel_syms.2 @@ -53,7 +53,7 @@ On success, returns the number of symbols copied to .IR table . On error, \-1 is returned and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS There is only one possible error return: .TP diff --git a/man2/getcpu.2 b/man2/getcpu.2 index 59089bd746..5954cc5e8c 100644 --- a/man2/getcpu.2 +++ b/man2/getcpu.2 @@ -55,7 +55,7 @@ is no longer current by the time the call returns. On success, 0 is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EFAULT diff --git a/man2/getdents.2 b/man2/getdents.2 index 2a0576ffd1..db8b945f30 100644 --- a/man2/getdents.2 +++ b/man2/getdents.2 @@ -186,7 +186,7 @@ On success, the number of bytes read is returned. On end of directory, 0 is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EBADF diff --git a/man2/getdomainname.2 b/man2/getdomainname.2 index 96ccb5fa78..c83b01b125 100644 --- a/man2/getdomainname.2 +++ b/man2/getdomainname.2 @@ -83,7 +83,7 @@ returns the first \fIlen\fP bytes (glibc) or gives an error (libc). On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .BR setdomainname () can fail with the following errors: diff --git a/man2/getgroups.2 b/man2/getgroups.2 index a59573064b..ffe01fbb1f 100644 --- a/man2/getgroups.2 +++ b/man2/getgroups.2 @@ -109,14 +109,14 @@ On success, returns the number of supplementary group IDs. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .PP On success, .BR setgroups () returns 0. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EFAULT diff --git a/man2/gethostname.2 b/man2/gethostname.2 index b7fa3cf579..6508e06ce0 100644 --- a/man2/gethostname.2 +++ b/man2/gethostname.2 @@ -94,7 +94,7 @@ includes a terminating null byte. On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EFAULT diff --git a/man2/getitimer.2 b/man2/getitimer.2 index e1e748f61d..b435c343e6 100644 --- a/man2/getitimer.2 +++ b/man2/getitimer.2 @@ -134,7 +134,7 @@ if both of its subfields are zero, the timer is single-shot. On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EFAULT diff --git a/man2/getpeername.2 b/man2/getpeername.2 index 5b7eacce62..ef84b9ef10 100644 --- a/man2/getpeername.2 +++ b/man2/getpeername.2 @@ -71,7 +71,7 @@ will return a value greater than was supplied to the call. On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EBADF diff --git a/man2/getrandom.2 b/man2/getrandom.2 index 1a9fea7bf3..4c93e81118 100644 --- a/man2/getrandom.2 +++ b/man2/getrandom.2 @@ -138,7 +138,7 @@ source or the system call was interrupted by a signal. .PP On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EAGAIN diff --git a/man2/getresuid.2 b/man2/getresuid.2 index ce24005b4e..7ecc4fea5a 100644 --- a/man2/getresuid.2 +++ b/man2/getresuid.2 @@ -51,7 +51,7 @@ performs the analogous task for the process's group IDs. On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EFAULT diff --git a/man2/getrlimit.2 b/man2/getrlimit.2 index 40e4c9dcde..7775d54444 100644 --- a/man2/getrlimit.2 +++ b/man2/getrlimit.2 @@ -508,7 +508,7 @@ must match the real group ID of the caller. On success, these system calls return 0. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EFAULT diff --git a/man2/getrusage.2 b/man2/getrusage.2 index ffd2b030bb..dfc5abbf07 100644 --- a/man2/getrusage.2 +++ b/man2/getrusage.2 @@ -188,7 +188,7 @@ exceeded its time slice. On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EFAULT diff --git a/man2/getsid.2 b/man2/getsid.2 index f6cf4d1df0..d88755d9f8 100644 --- a/man2/getsid.2 +++ b/man2/getsid.2 @@ -61,7 +61,7 @@ returns the session ID of the calling process. On success, a session ID is returned. On error, \fI(pid_t)\ \-1\fP will be returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EPERM diff --git a/man2/getsockname.2 b/man2/getsockname.2 index 9b949715d9..55db4b84c2 100644 --- a/man2/getsockname.2 +++ b/man2/getsockname.2 @@ -68,7 +68,7 @@ will return a value greater than was supplied to the call. On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EBADF diff --git a/man2/getsockopt.2 b/man2/getsockopt.2 index be4a92cf28..9e33b2d4f5 100644 --- a/man2/getsockopt.2 +++ b/man2/getsockopt.2 @@ -131,7 +131,7 @@ and the appropriate protocol man pages. On success, zero is returned for the standard options. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .PP Netfilter allows the programmer to define custom socket options with associated handlers; for such diff --git a/man2/getxattr.2 b/man2/getxattr.2 index 5e3c54bf15..5299f78560 100644 --- a/man2/getxattr.2 +++ b/man2/getxattr.2 @@ -106,7 +106,7 @@ On success, these calls return a nonnegative value which is the size (in bytes) of the extended attribute value. On failure, \-1 is returned and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B E2BIG diff --git a/man2/init_module.2 b/man2/init_module.2 index 51e00ca65c..31229ea93b 100644 --- a/man2/init_module.2 +++ b/man2/init_module.2 @@ -150,7 +150,7 @@ as expected for malformed modules. On success, these system calls return 0. On error, \-1 is returned and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .BR EBADMSG " (since Linux 3.7)" diff --git a/man2/inotify_add_watch.2 b/man2/inotify_add_watch.2 index f35ede1447..37b675d6d2 100644 --- a/man2/inotify_add_watch.2 +++ b/man2/inotify_add_watch.2 @@ -82,7 +82,7 @@ On success, returns a watch descriptor (a nonnegative integer). On error, \-1 is returned and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EACCES diff --git a/man2/ioctl.2 b/man2/ioctl.2 index 562bf27289..b71b84b0c2 100644 --- a/man2/ioctl.2 +++ b/man2/ioctl.2 @@ -93,7 +93,7 @@ requests use the return value as an output parameter and return a nonnegative value on success. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EBADF diff --git a/man2/ioperm.2 b/man2/ioperm.2 index 991f8c49d6..48a0466a10 100644 --- a/man2/ioperm.2 +++ b/man2/ioperm.2 @@ -79,7 +79,7 @@ return an error. On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EINVAL diff --git a/man2/iopl.2 b/man2/iopl.2 index 8e4ef95f4d..efce64c52d 100644 --- a/man2/iopl.2 +++ b/man2/iopl.2 @@ -59,7 +59,7 @@ return an error. On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EINVAL diff --git a/man2/kcmp.2 b/man2/kcmp.2 index 2d8e1d1260..f2f55ab65c 100644 --- a/man2/kcmp.2 +++ b/man2/kcmp.2 @@ -242,7 +242,7 @@ but ordering information is unavailable. .PP On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .PP .BR kcmp () was designed to return values suitable for sorting. diff --git a/man2/kill.2 b/man2/kill.2 index 0c7cf89c1b..b6fa289ab6 100644 --- a/man2/kill.2 +++ b/man2/kill.2 @@ -100,7 +100,7 @@ processes belong to the same session. On success (at least one signal was sent), zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EINVAL diff --git a/man2/link.2 b/man2/link.2 index fd8618d853..d6f3b76bde 100644 --- a/man2/link.2 +++ b/man2/link.2 @@ -182,7 +182,7 @@ for an explanation of the need for On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EACCES diff --git a/man2/listen.2 b/man2/listen.2 index 37e358c5dc..7c944ff4cc 100644 --- a/man2/listen.2 +++ b/man2/listen.2 @@ -82,7 +82,7 @@ ignored so that a later reattempt at connection succeeds. On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EADDRINUSE diff --git a/man2/listxattr.2 b/man2/listxattr.2 index 40fcf377c3..afd117869d 100644 --- a/man2/listxattr.2 +++ b/man2/listxattr.2 @@ -128,7 +128,7 @@ On success, a nonnegative number is returned indicating the size of the extended attribute name list. On failure, \-1 is returned and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B E2BIG diff --git a/man2/lookup_dcookie.2 b/man2/lookup_dcookie.2 index f98d771dcd..c2f2a87e67 100644 --- a/man2/lookup_dcookie.2 +++ b/man2/lookup_dcookie.2 @@ -48,7 +48,7 @@ On success, returns the length of the path string copied into the buffer. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EFAULT diff --git a/man2/madvise.2 b/man2/madvise.2 index 362960e045..688581b369 100644 --- a/man2/madvise.2 +++ b/man2/madvise.2 @@ -456,7 +456,7 @@ On success, returns zero. On error, it returns \-1 and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EACCES diff --git a/man2/membarrier.2 b/man2/membarrier.2 index c51d357a7e..173195484e 100644 --- a/man2/membarrier.2 +++ b/man2/membarrier.2 @@ -249,7 +249,7 @@ operations return zero. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .PP For a given command, with .I flags diff --git a/man2/mincore.2 b/man2/mincore.2 index 87b94aeab5..9371d58b10 100644 --- a/man2/mincore.2 +++ b/man2/mincore.2 @@ -103,7 +103,7 @@ On success, returns zero. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .B EAGAIN kernel is temporarily out of resources. diff --git a/man2/mmap2.2 b/man2/mmap2.2 index c571cc3021..349ee45e56 100644 --- a/man2/mmap2.2 +++ b/man2/mmap2.2 @@ -57,7 +57,7 @@ On success, returns a pointer to the mapped area. On error, \-1 is returned and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EFAULT diff --git a/man2/mount.2 b/man2/mount.2 index 8f933ebf1e..57d01d4de1 100644 --- a/man2/mount.2 +++ b/man2/mount.2 @@ -627,7 +627,7 @@ to modify the behavior of the call. On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS The error values given below result from filesystem type independent errors. diff --git a/man2/mprotect.2 b/man2/mprotect.2 index 45eb5e60c6..f08cca2dfa 100644 --- a/man2/mprotect.2 +++ b/man2/mprotect.2 @@ -144,7 +144,7 @@ and return zero. On error, these system calls return \-1, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EACCES diff --git a/man2/mremap.2 b/man2/mremap.2 index be4354e514..0b5aaf9801 100644 --- a/man2/mremap.2 +++ b/man2/mremap.2 @@ -164,7 +164,7 @@ returns a pointer to the new virtual memory area. On error, the value .B MAP_FAILED (that is, \fI(void\ *)\ \-1\fP) is returned, -and \fIerrno\fP is set appropriately. +and \fIerrno\fP is set to indicate the error. .SH ERRORS .TP .B EAGAIN diff --git a/man2/msync.2 b/man2/msync.2 index 22aae6bb74..f5234df89a 100644 --- a/man2/msync.2 +++ b/man2/msync.2 @@ -74,7 +74,7 @@ Asks to invalidate other mappings of the same file On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EBUSY diff --git a/man2/nfsservctl.2 b/man2/nfsservctl.2 index 626c483b35..1c68c3af2c 100644 --- a/man2/nfsservctl.2 +++ b/man2/nfsservctl.2 @@ -57,7 +57,7 @@ union nfsctl_res { On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH VERSIONS This system call was removed from the Linux kernel in version 3.1. Library support was removed from glibc in version 2.28. diff --git a/man2/nice.2 b/man2/nice.2 index f9beae6c7d..f018f095cc 100644 --- a/man2/nice.2 +++ b/man2/nice.2 @@ -71,7 +71,7 @@ for details. On success, the new nice value is returned (but see NOTES below). On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .PP A successful call can legitimately return \-1. To detect an error, set diff --git a/man2/openat2.2 b/man2/openat2.2 index 3bda206205..dbe6df5335 100644 --- a/man2/openat2.2 +++ b/man2/openat2.2 @@ -394,7 +394,7 @@ an error is returned. On success, a new file descriptor is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS The set of errors returned by .BR openat2 () diff --git a/man2/pciconfig_read.2 b/man2/pciconfig_read.2 index ee60b364ec..cec6f58e95 100644 --- a/man2/pciconfig_read.2 +++ b/man2/pciconfig_read.2 @@ -52,13 +52,13 @@ the IO base for PIO cycles, or the ISA holes if any. On success, zero is returned. On error, \-1 is returned and .I errno -is set appropriately. +is set to indicate the error. .TP .BR pciconfig_write () On success, zero is returned. On error, \-1 is returned and .I errno -is set appropriately. +is set to indicate the error. .TP .BR pciconfig_iobase () Returns information on locations of various I/O diff --git a/man2/personality.2 b/man2/personality.2 index 4931635f39..219af317d5 100644 --- a/man2/personality.2 +++ b/man2/personality.2 @@ -254,7 +254,7 @@ On success, the previous is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EINVAL diff --git a/man2/pivot_root.2 b/man2/pivot_root.2 index 3871b6e5bd..6012f42847 100644 --- a/man2/pivot_root.2 +++ b/man2/pivot_root.2 @@ -96,7 +96,7 @@ The current root directory must be a mount point. .SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and -\fIerrno\fP is set appropriately. +\fIerrno\fP is set to indicate the error. .SH ERRORS .BR pivot_root () may fail with any of the same errors as diff --git a/man2/pkey_alloc.2 b/man2/pkey_alloc.2 index b0ae983c2e..1b5500afb6 100644 --- a/man2/pkey_alloc.2 +++ b/man2/pkey_alloc.2 @@ -76,7 +76,7 @@ On success, returns zero. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EINVAL diff --git a/man2/prctl.2 b/man2/prctl.2 index f25f05fdb5..3e27b71f58 100644 --- a/man2/prctl.2 +++ b/man2/prctl.2 @@ -1932,7 +1932,7 @@ All other values return 0 on success. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EACCES diff --git a/man2/process_vm_readv.2 b/man2/process_vm_readv.2 index 43fed8be20..2fc292d700 100644 --- a/man2/process_vm_readv.2 +++ b/man2/process_vm_readv.2 @@ -227,7 +227,7 @@ a partial read/write occurred. .PP On error, \-1 is returned and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EFAULT diff --git a/man2/ptrace.2 b/man2/ptrace.2 index fc9b993673..a3028476ba 100644 --- a/man2/ptrace.2 +++ b/man2/ptrace.2 @@ -2332,7 +2332,7 @@ other requests return zero. .PP On error, all requests return \-1, and .I errno -is set appropriately. +is set to indicate the error. Since the value returned by a successful .B PTRACE_PEEK* request may be \-1, the caller must clear diff --git a/man2/query_module.2 b/man2/query_module.2 index 10b99a99a8..f3d07fd3d0 100644 --- a/man2/query_module.2 +++ b/man2/query_module.2 @@ -130,7 +130,7 @@ structure. On success, zero is returned. On error, \-1 is returned and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EFAULT diff --git a/man2/read.2 b/man2/read.2 index 5ac0585720..7e5848f971 100644 --- a/man2/read.2 +++ b/man2/read.2 @@ -93,7 +93,7 @@ See also NOTES. .PP On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. In this case, it is left unspecified whether the file position (if any) changes. .SH ERRORS diff --git a/man2/readdir.2 b/man2/readdir.2 index e024b9f110..b30f746a31 100644 --- a/man2/readdir.2 +++ b/man2/readdir.2 @@ -95,7 +95,7 @@ On success, 1 is returned. On end of directory, 0 is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EBADF diff --git a/man2/readv.2 b/man2/readv.2 index b5a3fe7f4a..4edca704f7 100644 --- a/man2/readv.2 +++ b/man2/readv.2 @@ -282,7 +282,7 @@ than requested (see and .BR write (2)). .PP -On error, \-1 is returned, and \fIerrno\fP is set appropriately. +On error, \-1 is returned, and \fIerrno\fP is set to indicate the error. .SH ERRORS The errors are as given for .BR read (2) diff --git a/man2/reboot.2 b/man2/reboot.2 index 869971ea75..c881e12663 100644 --- a/man2/reboot.2 +++ b/man2/reboot.2 @@ -221,7 +221,7 @@ For the other values, zero is returned on success. In all cases, \-1 is returned on failure, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EFAULT diff --git a/man2/remap_file_pages.2 b/man2/remap_file_pages.2 index 8f2945e28d..d2c352702d 100644 --- a/man2/remap_file_pages.2 +++ b/man2/remap_file_pages.2 @@ -141,7 +141,7 @@ On success, returns 0. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EINVAL diff --git a/man2/removexattr.2 b/man2/removexattr.2 index d8549fd2e7..6ef3349e69 100644 --- a/man2/removexattr.2 +++ b/man2/removexattr.2 @@ -79,7 +79,7 @@ namespaces associated with an individual inode. On success, zero is returned. On failure, \-1 is returned and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B ENODATA diff --git a/man2/rename.2 b/man2/rename.2 index fca3fd24bf..527bafacf4 100644 --- a/man2/rename.2 +++ b/man2/rename.2 @@ -294,7 +294,7 @@ and ubifs (since Linux 4.9). On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EACCES diff --git a/man2/rmdir.2 b/man2/rmdir.2 index 366af448f7..fe32f93b11 100644 --- a/man2/rmdir.2 +++ b/man2/rmdir.2 @@ -43,7 +43,7 @@ deletes a directory, which must be empty. On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EACCES diff --git a/man2/s390_guarded_storage.2 b/man2/s390_guarded_storage.2 index c20230786e..af7ad5baf2 100644 --- a/man2/s390_guarded_storage.2 +++ b/man2/s390_guarded_storage.2 @@ -112,7 +112,7 @@ is 0. .PP On error, \-1 is returned, and .IR errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EFAULT diff --git a/man2/s390_sthyi.2 b/man2/s390_sthyi.2 index 91fc622bc3..4da6c3a0ae 100644 --- a/man2/s390_sthyi.2 +++ b/man2/s390_sthyi.2 @@ -99,7 +99,7 @@ The return values 1 and 2 are reserved. .PP On error, \-1 is returned, and .IR errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EFAULT diff --git a/man2/sched_get_priority_max.2 b/man2/sched_get_priority_max.2 index 0f9fa258d9..29b5fedcf7 100644 --- a/man2/sched_get_priority_max.2 +++ b/man2/sched_get_priority_max.2 @@ -105,7 +105,7 @@ return the maximum/minimum priority value for the named scheduling policy. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EINVAL diff --git a/man2/sched_rr_get_interval.2 b/man2/sched_rr_get_interval.2 index bce1ee0d37..e1adca4e56 100644 --- a/man2/sched_rr_get_interval.2 +++ b/man2/sched_rr_get_interval.2 @@ -78,7 +78,7 @@ On success, returns 0. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EFAULT diff --git a/man2/sched_setaffinity.2 b/man2/sched_setaffinity.2 index 61bb7bb38d..2dfb285895 100644 --- a/man2/sched_setaffinity.2 +++ b/man2/sched_setaffinity.2 @@ -114,7 +114,7 @@ which notes that the underlying differs in its return value). On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EFAULT diff --git a/man2/sched_setparam.2 b/man2/sched_setparam.2 index 1bca5b48f1..9425847933 100644 --- a/man2/sched_setparam.2 +++ b/man2/sched_setparam.2 @@ -91,7 +91,7 @@ and return 0. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EINVAL diff --git a/man2/sched_setscheduler.2 b/man2/sched_setscheduler.2 index 07bcf733da..2c7982a094 100644 --- a/man2/sched_setscheduler.2 +++ b/man2/sched_setscheduler.2 @@ -138,7 +138,7 @@ On success, returns the policy for the thread (a nonnegative integer). On error, both calls return \-1, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EINVAL diff --git a/man2/sched_yield.2 b/man2/sched_yield.2 index 515fc0b832..ae112bb648 100644 --- a/man2/sched_yield.2 +++ b/man2/sched_yield.2 @@ -46,7 +46,7 @@ On success, returns 0. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS In the Linux implementation, .BR sched_yield () diff --git a/man2/send.2 b/man2/send.2 index fb3f835049..42fa5bf542 100644 --- a/man2/send.2 +++ b/man2/send.2 @@ -317,7 +317,7 @@ field is ignored. On success, these calls return the number of bytes sent. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS These are some standard errors generated by the socket layer. Additional errors diff --git a/man2/sendfile.2 b/man2/sendfile.2 index 5e3380cb83..d2bffd011c 100644 --- a/man2/sendfile.2 +++ b/man2/sendfile.2 @@ -112,7 +112,7 @@ See also NOTES. .PP On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EAGAIN diff --git a/man2/set_thread_area.2 b/man2/set_thread_area.2 index 01cfdc0d9b..eab3dec100 100644 --- a/man2/set_thread_area.2 +++ b/man2/set_thread_area.2 @@ -133,7 +133,7 @@ segments, although clearing a segment is still acceptable. On x86, these system calls return 0 on success, and \-1 on failure, with .I errno -set appropriately. +set to indicate the error. .PP On MIPS and m68k, .BR set_thread_area () diff --git a/man2/seteuid.2 b/man2/seteuid.2 index e402e16458..0bc20b268e 100644 --- a/man2/seteuid.2 +++ b/man2/seteuid.2 @@ -67,7 +67,7 @@ with "group" instead of "user". On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .PP .IR Note : there are cases where diff --git a/man2/setgid.2 b/man2/setgid.2 index 4135e87132..728b573988 100644 --- a/man2/setgid.2 +++ b/man2/setgid.2 @@ -58,7 +58,7 @@ effective group ID in a secure manner. On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EINVAL diff --git a/man2/setpgid.2 b/man2/setpgid.2 index 42b5b0a296..9a126c11ee 100644 --- a/man2/setpgid.2 +++ b/man2/setpgid.2 @@ -194,7 +194,7 @@ and return zero. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .PP The POSIX.1 .BR getpgrp () @@ -206,7 +206,7 @@ and the BSD-specific return a process group on success. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EACCES diff --git a/man2/setresuid.2 b/man2/setresuid.2 index 21d81c6ee5..7d1a2af577 100644 --- a/man2/setresuid.2 +++ b/man2/setresuid.2 @@ -65,7 +65,7 @@ with the same restrictions for unprivileged processes. On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .PP .IR Note : there are cases where diff --git a/man2/setreuid.2 b/man2/setreuid.2 index fc85b8f13b..90ca93a9a9 100644 --- a/man2/setreuid.2 +++ b/man2/setreuid.2 @@ -95,7 +95,7 @@ and all of the above holds with "group" instead of "user". On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .PP .IR Note : there are cases where diff --git a/man2/setuid.2 b/man2/setuid.2 index fa4636fcba..d8e461552f 100644 --- a/man2/setuid.2 +++ b/man2/setuid.2 @@ -75,7 +75,7 @@ You can accomplish this with On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .PP .IR Note : there are cases where diff --git a/man2/setxattr.2 b/man2/setxattr.2 index 02bc4014e8..ebcfa4ded5 100644 --- a/man2/setxattr.2 +++ b/man2/setxattr.2 @@ -110,7 +110,7 @@ which fails if the named attribute does not already exist. On success, zero is returned. On failure, \-1 is returned and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EDQUOT diff --git a/man2/shmctl.2 b/man2/shmctl.2 index 3ff58f1e4d..cf9ed40926 100644 --- a/man2/shmctl.2 +++ b/man2/shmctl.2 @@ -385,7 +385,7 @@ Other operations return 0 on success. .PP On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EACCES diff --git a/man2/shutdown.2 b/man2/shutdown.2 index 1c865be902..87d39f492d 100644 --- a/man2/shutdown.2 +++ b/man2/shutdown.2 @@ -72,7 +72,7 @@ further receptions and transmissions will be disallowed. On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EBADF diff --git a/man2/socket.2 b/man2/socket.2 index e780426acf..2a22567c77 100644 --- a/man2/socket.2 +++ b/man2/socket.2 @@ -418,7 +418,7 @@ are used to set and get options. On success, a file descriptor for the new socket is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EACCES diff --git a/man2/stat.2 b/man2/stat.2 index 2f46e03db5..f403124902 100644 --- a/man2/stat.2 +++ b/man2/stat.2 @@ -368,7 +368,7 @@ for an explanation of the need for On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EACCES diff --git a/man2/statfs.2 b/man2/statfs.2 index a47bec9a93..83d0847fb5 100644 --- a/man2/statfs.2 +++ b/man2/statfs.2 @@ -226,7 +226,7 @@ returns the same information about an open file referenced by descriptor On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EACCES diff --git a/man2/statx.2 b/man2/statx.2 index 9148fbbb0f..9539ccb2b1 100644 --- a/man2/statx.2 +++ b/man2/statx.2 @@ -496,7 +496,7 @@ for more information. On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EACCES diff --git a/man2/stime.2 b/man2/stime.2 index 68ab8425f0..4a9bb3dec7 100644 --- a/man2/stime.2 +++ b/man2/stime.2 @@ -67,7 +67,7 @@ may be executed only by the superuser. On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EFAULT diff --git a/man2/swapon.2 b/man2/swapon.2 index f9c5d23d98..2e67229f0a 100644 --- a/man2/swapon.2 +++ b/man2/swapon.2 @@ -114,7 +114,7 @@ but there are exceptions. On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EBUSY diff --git a/man2/symlink.2 b/man2/symlink.2 index 387129e8b3..38d51c82ef 100644 --- a/man2/symlink.2 +++ b/man2/symlink.2 @@ -135,7 +135,7 @@ is ignored. On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EACCES diff --git a/man2/sysfs.2 b/man2/sysfs.2 index a037d1c9d7..6064efcc39 100644 --- a/man2/sysfs.2 +++ b/man2/sysfs.2 @@ -84,7 +84,7 @@ and the number of currently configured filesystems for option .BR 3 . On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EFAULT diff --git a/man2/time.2 b/man2/time.2 index 3cc215339f..4e140ae7df 100644 --- a/man2/time.2 +++ b/man2/time.2 @@ -47,8 +47,9 @@ the return value is also stored in the memory pointed to by .IR tloc . .SH RETURN VALUE On success, the value of time in seconds since the Epoch is returned. -On error, \fI((time_t)\ \-1)\fP is returned, and \fIerrno\fP is set -appropriately. +On error, \fI((time_t)\ \-1)\fP is returned, and +.I errno +is set to indicate the error. .SH ERRORS .TP .B EFAULT diff --git a/man2/times.2 b/man2/times.2 index f9a53d2bef..eb5896a026 100644 --- a/man2/times.2 +++ b/man2/times.2 @@ -109,7 +109,7 @@ The return value may overflow the possible range of type .IR clock_t . On error, \fI(clock_t)\ \-1\fP is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EFAULT diff --git a/man2/tkill.2 b/man2/tkill.2 index b505f2bbd1..4b4eae3121 100644 --- a/man2/tkill.2 +++ b/man2/tkill.2 @@ -91,7 +91,7 @@ thread library use. .SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and \fIerrno\fP -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EAGAIN diff --git a/man2/truncate.2 b/man2/truncate.2 index 812469dbf8..b9bcdcd4d3 100644 --- a/man2/truncate.2 +++ b/man2/truncate.2 @@ -107,7 +107,7 @@ the file must be writable. On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS For .BR truncate (): diff --git a/man2/umount.2 b/man2/umount.2 index 7942df49a9..6d06841493 100644 --- a/man2/umount.2 +++ b/man2/umount.2 @@ -113,7 +113,7 @@ programs that allow unprivileged users to unmount filesystems. On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS The error values given below result from filesystem type independent errors. diff --git a/man2/uname.2 b/man2/uname.2 index 897ba0e115..9491a29699 100644 --- a/man2/uname.2 +++ b/man2/uname.2 @@ -67,7 +67,7 @@ the fields are terminated by a null byte (\(aq\e0\(aq). On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EFAULT diff --git a/man2/unlink.2 b/man2/unlink.2 index f683b5363f..5f3125c147 100644 --- a/man2/unlink.2 +++ b/man2/unlink.2 @@ -148,7 +148,7 @@ for an explanation of the need for On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EACCES diff --git a/man2/uselib.2 b/man2/uselib.2 index 9c4ca5bf29..8896c1df6a 100644 --- a/man2/uselib.2 +++ b/man2/uselib.2 @@ -54,7 +54,7 @@ binary format. On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS In addition to all of the error codes returned by .BR open (2) diff --git a/man2/userfaultfd.2 b/man2/userfaultfd.2 index 82ebf4e256..f1ef674684 100644 --- a/man2/userfaultfd.2 +++ b/man2/userfaultfd.2 @@ -422,7 +422,7 @@ On success, returns a new file descriptor that refers to the userfaultfd object. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EINVAL diff --git a/man2/ustat.2 b/man2/ustat.2 index 25c28486f1..d09a178454 100644 --- a/man2/ustat.2 +++ b/man2/ustat.2 @@ -73,7 +73,7 @@ structure pointed to by will be filled in. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EFAULT diff --git a/man2/utime.2 b/man2/utime.2 index 24f397b1be..d3e894db30 100644 --- a/man2/utime.2 +++ b/man2/utime.2 @@ -124,7 +124,7 @@ set to the current time. On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EACCES diff --git a/man2/vhangup.2 b/man2/vhangup.2 index fd88a2bca2..6b197ef3a6 100644 --- a/man2/vhangup.2 +++ b/man2/vhangup.2 @@ -59,7 +59,7 @@ users to have a \*(lqclean\*(rq terminal at login time. On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EPERM diff --git a/man2/vm86.2 b/man2/vm86.2 index 9b8c0ae1a5..6ee81300ec 100644 --- a/man2/vm86.2 +++ b/man2/vm86.2 @@ -56,7 +56,7 @@ VM86 mode is an emulation of real mode within a protected mode task. On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EFAULT diff --git a/man3/aio_fsync.3 b/man3/aio_fsync.3 index 3bfba5fc7d..42191bc71e 100644 --- a/man3/aio_fsync.3 +++ b/man3/aio_fsync.3 @@ -77,7 +77,7 @@ On success (the sync request was successfully queued) this function returns 0. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EAGAIN diff --git a/man3/aio_read.3 b/man3/aio_read.3 index dcd45dd9e1..c43c35729f 100644 --- a/man3/aio_read.3 +++ b/man3/aio_read.3 @@ -92,7 +92,7 @@ On success, 0 is returned. On error, the request is not enqueued, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. If an error is detected only later, it will be reported via .BR aio_return (3) diff --git a/man3/aio_return.3 b/man3/aio_return.3 index cee4aab9ab..062dce2cf3 100644 --- a/man3/aio_return.3 +++ b/man3/aio_return.3 @@ -57,7 +57,7 @@ the value that would have been returned in case of a synchronous or .BR fdatasync (2), call. -On error, \-1 is returned, and \fIerrno\fP is set appropriately. +On error, \-1 is returned, and \fIerrno\fP is set to indicate the error. .PP If the asynchronous I/O operation has not yet completed, the return value and effect of diff --git a/man3/aio_write.3 b/man3/aio_write.3 index 00aa180eb1..91c35fc043 100644 --- a/man3/aio_write.3 +++ b/man3/aio_write.3 @@ -99,7 +99,7 @@ On success, 0 is returned. On error, the request is not enqueued, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. If an error is detected only later, it will be reported via .BR aio_return (3) diff --git a/man3/closedir.3 b/man3/closedir.3 index 3db6344031..40747faeba 100644 --- a/man3/closedir.3 +++ b/man3/closedir.3 @@ -57,7 +57,7 @@ The function returns 0 on success. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EBADF diff --git a/man3/euidaccess.3 b/man3/euidaccess.3 index d922fc7247..c79d5c8f9e 100644 --- a/man3/euidaccess.3 +++ b/man3/euidaccess.3 @@ -62,7 +62,7 @@ On error (at least one bit in asked for a permission that is denied, or some other error occurred), \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS As for .BR access (2). diff --git a/man3/fexecve.3 b/man3/fexecve.3 index 91a94b7c0b..fbf226bf92 100644 --- a/man3/fexecve.3 +++ b/man3/fexecve.3 @@ -66,7 +66,7 @@ A successful call to never returns. On error, the function does return, with a result value of \-1, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS Errors are as for .BR execve (2), diff --git a/man3/fpurge.3 b/man3/fpurge.3 index 50399212b3..0472e8265d 100644 --- a/man3/fpurge.3 +++ b/man3/fpurge.3 @@ -60,7 +60,7 @@ Upon successful completion returns 0. On error, it returns \-1 and sets .I errno -appropriately. +to indicate the error. .SH ERRORS .TP .B EBADF diff --git a/man3/fts.3 b/man3/fts.3 index 5c6f6decf9..9bcc938499 100644 --- a/man3/fts.3 +++ b/man3/fts.3 @@ -561,7 +561,7 @@ returns NULL and sets .I errno -appropriately. +to indicate the error. If an error related to a returned file occurs, a pointer to an .I FTSENT structure is returned, and @@ -630,7 +630,7 @@ returns NULL and sets .I errno -appropriately. +to indicate the error. .PP The .I FTSENT diff --git a/man3/futimes.3 b/man3/futimes.3 index 8968aa76ef..3a1686df16 100644 --- a/man3/futimes.3 +++ b/man3/futimes.3 @@ -66,7 +66,7 @@ instead, the timestamps of the symbolic link are changed. On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS Errors are as for .BR utimes (2), diff --git a/man3/getcontext.3 b/man3/getcontext.3 index 7259aab078..845466da06 100644 --- a/man3/getcontext.3 +++ b/man3/getcontext.3 @@ -151,7 +151,7 @@ returns 0 and does not return. On error, both return \-1 and set .I errno -appropriately. +to indicate the error. .SH ERRORS None defined. .SH ATTRIBUTES diff --git a/man3/getdirentries.3 b/man3/getdirentries.3 index c756f81678..0deff6371d 100644 --- a/man3/getdirentries.3 +++ b/man3/getdirentries.3 @@ -65,7 +65,7 @@ is updated with the new position after reading. returns the number of bytes read or zero when at the end of the directory. If an error occurs, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS See the Linux library source code for details. .SH ATTRIBUTES diff --git a/man3/getentropy.3 b/man3/getentropy.3 index 7c1a2bd773..7e55e7628d 100644 --- a/man3/getentropy.3 +++ b/man3/getentropy.3 @@ -60,7 +60,7 @@ always provides the requested number of bytes of entropy. On success, this function returns zero. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EFAULT diff --git a/man3/getgrnam.3 b/man3/getgrnam.3 index ffd4b6d926..0f296fd24c 100644 --- a/man3/getgrnam.3 +++ b/man3/getgrnam.3 @@ -139,7 +139,7 @@ structure, or NULL if the matching entry is not found or an error occurs. If an error occurs, .I errno -is set appropriately. +is set to indicate the error. If one wants to check .I errno after the call, it should be set to zero before the call. diff --git a/man3/getifaddrs.3 b/man3/getifaddrs.3 index 8ce5ef85c7..ba6301fbab 100644 --- a/man3/getifaddrs.3 +++ b/man3/getifaddrs.3 @@ -144,7 +144,7 @@ On success, returns zero; on error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .BR getifaddrs () may fail and set diff --git a/man3/getpwent.3 b/man3/getpwent.3 index cfc3cc5ebb..57df41b7d4 100644 --- a/man3/getpwent.3 +++ b/man3/getpwent.3 @@ -107,7 +107,7 @@ structure, or NULL if there are no more entries or an error occurred. If an error occurs, .I errno -is set appropriately. +is set to indicate the error. If one wants to check .I errno after the call, it should be set to zero before the call. diff --git a/man3/getpwnam.3 b/man3/getpwnam.3 index 922c160c03..45fde871d5 100644 --- a/man3/getpwnam.3 +++ b/man3/getpwnam.3 @@ -145,7 +145,7 @@ structure, or NULL if the matching entry is not found or an error occurs. If an error occurs, .I errno -is set appropriately. +is set to indicate the error. If one wants to check .I errno after the call, it should be set to zero before the call. diff --git a/man3/grantpt.3 b/man3/grantpt.3 index f949a73693..e609005157 100644 --- a/man3/grantpt.3 +++ b/man3/grantpt.3 @@ -47,7 +47,7 @@ When successful, returns 0. Otherwise, it returns \-1 and sets .I errno -appropriately. +to indicate the error. .SH ERRORS .TP .B EACCES diff --git a/man3/if_nameindex.3 b/man3/if_nameindex.3 index 93e9a7ed34..f6f59fcdea 100644 --- a/man3/if_nameindex.3 +++ b/man3/if_nameindex.3 @@ -74,7 +74,7 @@ On success, returns pointer to the array; on error, NULL is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .BR if_nameindex () may fail and set diff --git a/man3/if_nametoindex.3 b/man3/if_nametoindex.3 index 232e415e77..d5abd21c02 100644 --- a/man3/if_nametoindex.3 +++ b/man3/if_nametoindex.3 @@ -56,7 +56,7 @@ On success, returns the index number of the network interface; on error, 0 is returned and .I errno -is set appropriately. +is set to indicate the error. .PP On success, .BR if_indextoname () @@ -64,7 +64,7 @@ returns .IR ifname ; on error, NULL is returned and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .BR if_nametoindex () may fail and set diff --git a/man3/initgroups.3 b/man3/initgroups.3 index 114eff6a83..1293fd356a 100644 --- a/man3/initgroups.3 +++ b/man3/initgroups.3 @@ -76,7 +76,7 @@ The function returns 0 on success. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B ENOMEM diff --git a/man3/killpg.3 b/man3/killpg.3 index 0e2e955630..590403e451 100644 --- a/man3/killpg.3 +++ b/man3/killpg.3 @@ -86,7 +86,7 @@ For the permissions required to send a signal to another process, see On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EINVAL diff --git a/man3/lockf.3 b/man3/lockf.3 index 7d1998ad48..5e8caa4e6d 100644 --- a/man3/lockf.3 +++ b/man3/lockf.3 @@ -119,7 +119,7 @@ if another process holds a lock. On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .BR EACCES " or " EAGAIN diff --git a/man3/makecontext.3 b/man3/makecontext.3 index c0cf5f8a8e..83720dd2cc 100644 --- a/man3/makecontext.3 +++ b/man3/makecontext.3 @@ -92,8 +92,9 @@ activated, in which case it looks like returns 0.) On error, .BR swapcontext () -returns \-1 and -sets \fIerrno\fP appropriately. +returns \-1 and sets +.I errno +to indicate the error. .SH ERRORS .TP .B ENOMEM diff --git a/man3/mkdtemp.3 b/man3/mkdtemp.3 index 1e364be4d9..b0ba65af3e 100644 --- a/man3/mkdtemp.3 +++ b/man3/mkdtemp.3 @@ -63,7 +63,7 @@ The function returns a pointer to the modified template string on success, and NULL on failure, in which case .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EINVAL diff --git a/man3/mkstemp.3 b/man3/mkstemp.3 index 3ff554cccb..67b772e20e 100644 --- a/man3/mkstemp.3 +++ b/man3/mkstemp.3 @@ -157,7 +157,7 @@ On success, these functions return the file descriptor of the temporary file. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EEXIST diff --git a/man3/opendir.3 b/man3/opendir.3 index c748a71e30..fefc5a8760 100644 --- a/man3/opendir.3 +++ b/man3/opendir.3 @@ -81,7 +81,7 @@ and functions return a pointer to the directory stream. On error, NULL is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EACCES diff --git a/man3/popen.3 b/man3/popen.3 index cea3d5472c..f670acb254 100644 --- a/man3/popen.3 +++ b/man3/popen.3 @@ -157,7 +157,7 @@ or .BR pipe (2) fails, .I errno -is set appropriately. +is set to indicate the error. If the .I type argument is invalid, and this condition is detected, diff --git a/man3/readdir.3 b/man3/readdir.3 index 408ea15c6e..442d039ab5 100644 --- a/man3/readdir.3 +++ b/man3/readdir.3 @@ -176,7 +176,7 @@ If the end of the directory stream is reached, NULL is returned and is not changed. If an error occurs, NULL is returned and .I errno -is set appropriately. +is set to indicate the error. To distinguish end of stream from an error, set .I errno to zero before calling diff --git a/man3/remove.3 b/man3/remove.3 index 508c1fc8dd..4b22053d35 100644 --- a/man3/remove.3 +++ b/man3/remove.3 @@ -63,7 +63,7 @@ but processes which have the object open may continue to use it. On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS The errors that occur are those for .BR unlink (2) diff --git a/man3/rtime.3 b/man3/rtime.3 index 97ba72d936..6a5c2b8a60 100644 --- a/man3/rtime.3 +++ b/man3/rtime.3 @@ -38,7 +38,7 @@ On success, 0 is returned, and the obtained 32-bit time value is stored in .IR timep\->tv_sec . In case of error \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS All errors for underlying functions .RB ( sendto (2), diff --git a/man3/statvfs.3 b/man3/statvfs.3 index e06ee67831..4f27886145 100644 --- a/man3/statvfs.3 +++ b/man3/statvfs.3 @@ -130,7 +130,7 @@ returns the same information about an open file referenced by descriptor On success, zero is returned. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EACCES diff --git a/man3/tcgetpgrp.3 b/man3/tcgetpgrp.3 index ced798d268..219c9be8a7 100644 --- a/man3/tcgetpgrp.3 +++ b/man3/tcgetpgrp.3 @@ -76,14 +76,14 @@ When does not refer to the controlling terminal of the calling process, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .PP When successful, .BR tcsetpgrp () returns 0. Otherwise, it returns \-1, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EBADF diff --git a/man3/tcgetsid.3 b/man3/tcgetsid.3 index ba452bc8f1..e939a95bd7 100644 --- a/man3/tcgetsid.3 +++ b/man3/tcgetsid.3 @@ -49,7 +49,7 @@ the function will return the session ID of this session. Otherwise, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EBADF diff --git a/man3/telldir.3 b/man3/telldir.3 index 3fac0ebbc9..aa76bc8777 100644 --- a/man3/telldir.3 +++ b/man3/telldir.3 @@ -60,7 +60,7 @@ function returns the current location in the directory stream. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EBADF diff --git a/man3/ttyname.3 b/man3/ttyname.3 index 1f8c36fdc0..7dc3a75d58 100644 --- a/man3/ttyname.3 +++ b/man3/ttyname.3 @@ -54,7 +54,7 @@ The function returns a pointer to a pathname on success. On error, NULL is returned, and .I errno -is set appropriately. +is set to indicate the error. The function .BR ttyname_r () returns 0 on success, and an error number upon error. diff --git a/man3/ulimit.3 b/man3/ulimit.3 index d95564566d..b6d0b3250e 100644 --- a/man3/ulimit.3 +++ b/man3/ulimit.3 @@ -72,7 +72,7 @@ On success, returns a nonnegative value. On error, \-1 is returned, and .I errno -is set appropriately. +is set to indicate the error. .SH ERRORS .TP .B EPERM diff --git a/man3/unlockpt.3 b/man3/unlockpt.3 index b7b34dff11..b08522e41b 100644 --- a/man3/unlockpt.3 +++ b/man3/unlockpt.3 @@ -41,7 +41,7 @@ When successful, returns 0. Otherwise, it returns \-1 and sets .I errno -appropriately. +to indicate the error. .SH ERRORS .TP .B EBADF |