diff --git a/man2/access.2 b/man2/access.2 index 93e83c6dd..7f796d00a 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 856c4a409..40b813d02 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 88aea0f91..619442429 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 ee01d2157..548391f1d 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 d8ce40943..9034f3216 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 cf680af6e..ac6834295 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 e49c62b88..e157e5417 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 38d523030..a54aec7ed 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 22f760315..304fef293 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 2ac7b04e7..70a7dde17 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 84a367d49..5e5780268 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 d19fbeb93..fed770719 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 e8ad37314..9572676ef 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 712147913..9b47d4854 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 1030e9698..cb78cf484 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 5c5f0c76e..dedc4b2ef 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 3ee192fab..538b370c0 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 55890c82a..8ade43297 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 b6698da45..2280c03ae 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 b5d1cd57e..ef3606d8b 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 f8d15f602..e5289043e 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 beb89d128..61d4b5396 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 ffc1bc1f6..c93e9fa78 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 5e577e379..8b2151c41 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 27661f0be..063f533fc 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 59089bd74..5954cc5e8 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 2a0576ffd..db8b945f3 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 96ccb5fa7..c83b01b12 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 a59573064..ffe01fbb1 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 b7fa3cf57..6508e06ce 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 e1e748f61..b435c343e 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 5b7eacce6..ef84b9ef1 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 1a9fea7bf..4c93e8111 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 ce24005b4..7ecc4fea5 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 40e4c9dcd..7775d5444 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 ffd2b030b..dfc5abbf0 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 f6cf4d1df..d88755d9f 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 9b949715d..55db4b84c 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 be4a92cf2..9e33b2d4f 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 5e3c54bf1..5299f7856 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 51e00ca65..31229ea93 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 f35ede144..37b675d6d 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 562bf2728..b71b84b0c 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 991f8c49d..48a0466a1 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 8e4ef95f4..efce64c52 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 2d8e1d126..f2f55ab65 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 0c7cf89c1..b6fa289ab 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 fd8618d85..d6f3b76bd 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 37e358c5d..7c944ff4c 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 40fcf377c..afd117869 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 f98d771dc..c2f2a87e6 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 362960e04..688581b36 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 c51d357a7..173195484 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 87b94aeab..9371d58b1 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 c571cc302..349ee45e5 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 8f933ebf1..57d01d4de 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 45eb5e60c..f08cca2df 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 be4354e51..0b5aaf980 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 22aae6bb7..f5234df89 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 626c483b3..1c68c3af2 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 f9beae6c7..f018f095c 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 3bda20620..dbe6df533 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 ee60b364e..cec6f58e9 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 4931635f3..219af317d 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 3871b6e5b..6012f4284 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 b0ae983c2..1b5500afb 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 f25f05fdb..3e27b71f5 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 43fed8be2..2fc292d70 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 fc9b99367..a3028476b 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 10b99a99a..f3d07fd3d 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 5ac058572..7e5848f97 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 e024b9f11..b30f746a3 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 b5a3fe7f4..4edca704f 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 869971ea7..c881e1266 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 8f2945e28..d2c352702 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 d8549fd2e..6ef3349e6 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 fca3fd24b..527bafacf 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 366af448f..fe32f93b1 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 c20230786..af7ad5baf 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 91fc622bc..4da6c3a0a 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 0f9fa258d..29b5fedcf 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 bce1ee0d3..e1adca4e5 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 61bb7bb38..2dfb28589 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 1bca5b48f..942584793 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 07bcf733d..2c7982a09 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 515fc0b83..ae112bb64 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 fb3f83504..42fa5bf54 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 5e3380cb8..d2bffd011 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 01cfdc0d9..eab3dec10 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 e402e1645..0bc20b268 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 4135e8713..728b57398 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 42b5b0a29..9a126c11e 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 21d81c6ee..7d1a2af57 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 fc85b8f13..90ca93a9a 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 fa4636fcb..d8e461552 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 02bc4014e..ebcfa4ded 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 3ff58f1e4..cf9ed4092 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 1c865be90..87d39f492 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 e780426ac..2a22567c7 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 2f46e03db..f40312490 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 a47bec9a9..83d0847fb 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 9148fbbb0..9539ccb2b 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 68ab8425f..4a9bb3dec 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 f9c5d23d9..2e67229f0 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 387129e8b..38d51c82e 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 a037d1c9d..6064efcc3 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 3cc215339..4e140ae7d 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 f9a53d2be..eb5896a02 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 b505f2bbd..4b4eae312 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 812469dbf..b9bcdcd4d 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 7942df49a..6d0684149 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 897ba0e11..9491a2969 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 f683b5363..5f3125c14 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 9c4ca5bf2..8896c1df6 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 82ebf4e25..f1ef67468 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 25c28486f..d09a17845 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 24f397b1b..d3e894db3 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 fd88a2bca..6b197ef3a 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 9b8c0ae1a..6ee81300e 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 3bfba5fc7..42191bc71 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 dcd45dd9e..c43c35729 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 cee4aab9a..062dce2cf 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 00aa180eb..91c35fc04 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 3db634403..40747faeb 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 d922fc724..c79d5c8f9 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 91a94b7c0..fbf226bf9 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 50399212b..0472e8265 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 5c6f6decf..9bcc93849 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 8968aa76e..3a1686df1 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 7259aab07..845466da0 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 c756f8167..0deff6371 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 7c1a2bd77..7e55e7628 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 ffd4b6d92..0f296fd24 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 8ce5ef85c..ba6301fba 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 cfc3cc5eb..57df41b7d 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 922c160c0..45fde871d 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 f949a7369..e60900515 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 93e9a7ed3..f6f59fcde 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 232e415e7..d5abd21c0 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 114eff6a8..1293fd356 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 0e2e95563..590403e45 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 7d1998ad4..5e8caa4e6 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 c0cf5f8a8..83720dd2c 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 1e364be4d..b0ba65af3 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 3ff554ccc..67b772e20 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 c748a71e3..fefc5a876 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 cea3d5472..f670acb25 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 408ea15c6..442d039ab 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 508c1fc8d..4b22053d3 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 97ba72d93..6a5c2b8a6 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 e06ee6783..4f2788614 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 ced798d26..219c9be8a 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 ba452bc8f..e939a95bd 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 3fac0ebbc..aa76bc877 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 1f8c36fdc..7dc3a75d5 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 d95564566..b6d0b3250 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 b7b34dff1..b08522e41 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