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>
This commit is contained in:
Michael Kerrisk 2021-01-07 08:12:28 +01:00
parent 855d489a7f
commit f6a4078be5
157 changed files with 167 additions and 165 deletions

View File

@ -211,7 +211,7 @@ is
and the file does not exist, or some other error occurred), and the file does not exist, or some other error occurred),
\-1 is returned, and \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.BR access () .BR access ()
and and

View File

@ -69,7 +69,7 @@ An argument of NULL causes accounting to be turned off.
On success, zero is returned. On success, zero is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EACCES .B EACCES

View File

@ -113,7 +113,7 @@ returns the allocated virtual address, and
returns zero. returns zero.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B ENOSYS .B ENOSYS

View File

@ -154,7 +154,7 @@ See EXAMPLES below.
On success, zero is returned. On success, zero is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EACCES .B EACCES

View File

@ -985,7 +985,7 @@ Zero.
.PP .PP
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B E2BIG .B E2BIG

View File

@ -167,7 +167,7 @@ to all members of the process group whose ID is \-\fIpid\fP.
On success, zero is returned. On success, zero is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.PP .PP
The calls fail with the error The calls fail with the error
.BR EINVAL , .BR EINVAL ,

View File

@ -68,7 +68,7 @@ open file descriptor.
On success, zero is returned. On success, zero is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
Depending on the filesystem, other errors can be returned. Depending on the filesystem, other errors can be returned.
The more The more

View File

@ -231,7 +231,7 @@ for an explanation of the need for
On success, zero is returned. On success, zero is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
Depending on the filesystem, Depending on the filesystem,
errors other than those listed below can be returned. errors other than those listed below can be returned.

View File

@ -218,7 +218,7 @@ for an explanation of the need for
On success, zero is returned. On success, zero is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
Depending on the filesystem, Depending on the filesystem,
errors other than those listed below can be returned. errors other than those listed below can be returned.

View File

@ -112,7 +112,7 @@ descriptors may allow access to files outside the chroot tree.
On success, zero is returned. On success, zero is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
Depending on the filesystem, other errors can be returned. Depending on the filesystem, other errors can be returned.
The more general errors are listed below: The more general errors are listed below:

View File

@ -1200,7 +1200,7 @@ in the caller's thread of execution.
On failure, \-1 is returned On failure, \-1 is returned
in the caller's context, no child process will be created, and in the caller's context, no child process will be created, and
.I errno .I errno
will be set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EAGAIN .B EAGAIN

View File

@ -67,7 +67,7 @@ the file is deleted.
returns zero on success. returns zero on success.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EBADF .B EBADF

View File

@ -137,7 +137,7 @@ is supported on Linux since kernel 2.2.)
If the connection or binding succeeds, zero is returned. If the connection or binding succeeds, zero is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
The following are general socket errors only. The following are general socket errors only.
There may be other domain-specific error codes. There may be other domain-specific error codes.

View File

@ -31,7 +31,7 @@ This system call requires privilege.
On success, returns the kernel address at which the module will reside. On success, returns the kernel address at which the module will reside.
On error, \-1 is returned and On error, \-1 is returned and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EEXIST .B EEXIST

View File

@ -125,7 +125,7 @@ Using this flag taints the kernel (TAINT_FORCED_RMMOD).
On success, zero is returned. On success, zero is returned.
On error, \-1 is returned and On error, \-1 is returned and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EBUSY .B EBUSY

View File

@ -152,7 +152,7 @@ On success, these system calls
return the new file descriptor. return the new file descriptor.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EBADF .B EBADF

View File

@ -316,7 +316,7 @@ When an error occurs,
.BR epoll_ctl () .BR epoll_ctl ()
returns \-1 and returns \-1 and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EBADF .B EBADF

View File

@ -181,7 +181,7 @@ When an error occurs,
.BR epoll_wait () .BR epoll_wait ()
returns \-1 and returns \-1 and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EBADF .B EBADF

View File

@ -441,7 +441,7 @@ On success,
.BR execve () .BR execve ()
does not return, on error \-1 is returned, and does not return, on error \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B E2BIG .B E2BIG

View File

@ -111,7 +111,7 @@ On success,
does not return. does not return.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
The same errors that occur for The same errors that occur for
.BR execve (2) .BR execve (2)

View File

@ -1661,7 +1661,7 @@ Zero.
.PP .PP
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.BR EACCES " or " EAGAIN .BR EACCES " or " EAGAIN

View File

@ -115,7 +115,7 @@ mode in which the file was opened.
On success, zero is returned. On success, zero is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EBADF .B EBADF

View File

@ -218,7 +218,7 @@ and 0 is returned in the child.
On failure, \-1 is returned in the parent, On failure, \-1 is returned in the parent,
no child process is created, and no child process is created, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EAGAIN .B EAGAIN

View File

@ -119,7 +119,7 @@ require all metadata to be synchronized with the disk.
On success, these system calls return zero. On success, these system calls return zero.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EBADF .B EBADF

View File

@ -53,7 +53,7 @@ On success, returns the number of symbols copied to
.IR table . .IR table .
On error, \-1 is returned and On error, \-1 is returned and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
There is only one possible error return: There is only one possible error return:
.TP .TP

View File

@ -55,7 +55,7 @@ is no longer current by the time the call returns.
On success, 0 is returned. On success, 0 is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EFAULT .B EFAULT

View File

@ -186,7 +186,7 @@ On success, the number of bytes read is returned.
On end of directory, 0 is returned. On end of directory, 0 is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EBADF .B EBADF

View File

@ -83,7 +83,7 @@ returns the first \fIlen\fP bytes (glibc) or gives an error (libc).
On success, zero is returned. On success, zero is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.BR setdomainname () .BR setdomainname ()
can fail with the following errors: can fail with the following errors:

View File

@ -109,14 +109,14 @@ On success,
returns the number of supplementary group IDs. returns the number of supplementary group IDs.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.PP .PP
On success, On success,
.BR setgroups () .BR setgroups ()
returns 0. returns 0.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EFAULT .B EFAULT

View File

@ -94,7 +94,7 @@ includes a terminating null byte.
On success, zero is returned. On success, zero is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EFAULT .B EFAULT

View File

@ -134,7 +134,7 @@ if both of its subfields are zero, the timer is single-shot.
On success, zero is returned. On success, zero is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EFAULT .B EFAULT

View File

@ -71,7 +71,7 @@ will return a value greater than was supplied to the call.
On success, zero is returned. On success, zero is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EBADF .B EBADF

View File

@ -138,7 +138,7 @@ source or the system call was interrupted by a signal.
.PP .PP
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EAGAIN .B EAGAIN

View File

@ -51,7 +51,7 @@ performs the analogous task for the process's group IDs.
On success, zero is returned. On success, zero is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EFAULT .B EFAULT

View File

@ -508,7 +508,7 @@ must match the real group ID of the caller.
On success, these system calls return 0. On success, these system calls return 0.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EFAULT .B EFAULT

View File

@ -188,7 +188,7 @@ exceeded its time slice.
On success, zero is returned. On success, zero is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EFAULT .B EFAULT

View File

@ -61,7 +61,7 @@ returns the session ID of the calling process.
On success, a session ID is returned. On success, a session ID is returned.
On error, \fI(pid_t)\ \-1\fP will be returned, and On error, \fI(pid_t)\ \-1\fP will be returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EPERM .B EPERM

View File

@ -68,7 +68,7 @@ will return a value greater than was supplied to the call.
On success, zero is returned. On success, zero is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EBADF .B EBADF

View File

@ -131,7 +131,7 @@ and the appropriate protocol man pages.
On success, zero is returned for the standard options. On success, zero is returned for the standard options.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.PP .PP
Netfilter allows the programmer Netfilter allows the programmer
to define custom socket options with associated handlers; for such to define custom socket options with associated handlers; for such

View File

@ -106,7 +106,7 @@ On success, these calls return a nonnegative value which is
the size (in bytes) of the extended attribute value. the size (in bytes) of the extended attribute value.
On failure, \-1 is returned and On failure, \-1 is returned and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B E2BIG .B E2BIG

View File

@ -150,7 +150,7 @@ as expected for malformed modules.
On success, these system calls return 0. On success, these system calls return 0.
On error, \-1 is returned and On error, \-1 is returned and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.BR EBADMSG " (since Linux 3.7)" .BR EBADMSG " (since Linux 3.7)"

View File

@ -82,7 +82,7 @@ On success,
returns a watch descriptor (a nonnegative integer). returns a watch descriptor (a nonnegative integer).
On error, \-1 is returned and On error, \-1 is returned and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EACCES .B EACCES

View File

@ -93,7 +93,7 @@ requests use the return value as an output parameter
and return a nonnegative value on success. and return a nonnegative value on success.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EBADF .B EBADF

View File

@ -79,7 +79,7 @@ return an error.
On success, zero is returned. On success, zero is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EINVAL .B EINVAL

View File

@ -59,7 +59,7 @@ return an error.
On success, zero is returned. On success, zero is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EINVAL .B EINVAL

View File

@ -242,7 +242,7 @@ but ordering information is unavailable.
.PP .PP
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.PP .PP
.BR kcmp () .BR kcmp ()
was designed to return values suitable for sorting. was designed to return values suitable for sorting.

View File

@ -100,7 +100,7 @@ processes belong to the same session.
On success (at least one signal was sent), zero is returned. On success (at least one signal was sent), zero is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EINVAL .B EINVAL

View File

@ -182,7 +182,7 @@ for an explanation of the need for
On success, zero is returned. On success, zero is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EACCES .B EACCES

View File

@ -82,7 +82,7 @@ ignored so that a later reattempt at connection succeeds.
On success, zero is returned. On success, zero is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EADDRINUSE .B EADDRINUSE

View File

@ -128,7 +128,7 @@ On success, a nonnegative number is returned indicating the size of the
extended attribute name list. extended attribute name list.
On failure, \-1 is returned and On failure, \-1 is returned and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B E2BIG .B E2BIG

View File

@ -48,7 +48,7 @@ On success,
returns the length of the path string copied into the buffer. returns the length of the path string copied into the buffer.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EFAULT .B EFAULT

View File

@ -456,7 +456,7 @@ On success,
returns zero. returns zero.
On error, it returns \-1 and On error, it returns \-1 and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EACCES .B EACCES

View File

@ -249,7 +249,7 @@ operations return zero.
On error, \-1 is returned, On error, \-1 is returned,
and and
.I errno .I errno
is set appropriately. is set to indicate the error.
.PP .PP
For a given command, with For a given command, with
.I flags .I flags

View File

@ -103,7 +103,7 @@ On success,
returns zero. returns zero.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.B EAGAIN .B EAGAIN
kernel is temporarily out of resources. kernel is temporarily out of resources.

View File

@ -57,7 +57,7 @@ On success,
returns a pointer to the mapped area. returns a pointer to the mapped area.
On error, \-1 is returned and On error, \-1 is returned and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EFAULT .B EFAULT

View File

@ -627,7 +627,7 @@ to modify the behavior of the call.
On success, zero is returned. On success, zero is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
The error values given below result from filesystem type independent The error values given below result from filesystem type independent
errors. errors.

View File

@ -144,7 +144,7 @@ and
return zero. return zero.
On error, these system calls return \-1, and On error, these system calls return \-1, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EACCES .B EACCES

View File

@ -164,7 +164,7 @@ returns a pointer to the new virtual memory area.
On error, the value On error, the value
.B MAP_FAILED .B MAP_FAILED
(that is, \fI(void\ *)\ \-1\fP) is returned, (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 .SH ERRORS
.TP .TP
.B EAGAIN .B EAGAIN

View File

@ -74,7 +74,7 @@ Asks to invalidate other mappings of the same file
On success, zero is returned. On success, zero is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EBUSY .B EBUSY

View File

@ -57,7 +57,7 @@ union nfsctl_res {
On success, zero is returned. On success, zero is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH VERSIONS .SH VERSIONS
This system call was removed from the Linux kernel in version 3.1. This system call was removed from the Linux kernel in version 3.1.
Library support was removed from glibc in version 2.28. Library support was removed from glibc in version 2.28.

View File

@ -71,7 +71,7 @@ for details.
On success, the new nice value is returned (but see NOTES below). On success, the new nice value is returned (but see NOTES below).
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.PP .PP
A successful call can legitimately return \-1. A successful call can legitimately return \-1.
To detect an error, set To detect an error, set

View File

@ -394,7 +394,7 @@ an error is returned.
On success, a new file descriptor is returned. On success, a new file descriptor is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
The set of errors returned by The set of errors returned by
.BR openat2 () .BR openat2 ()

View File

@ -52,13 +52,13 @@ the IO base for PIO cycles, or the ISA holes if any.
On success, zero is returned. On success, zero is returned.
On error, \-1 is returned and On error, \-1 is returned and
.I errno .I errno
is set appropriately. is set to indicate the error.
.TP .TP
.BR pciconfig_write () .BR pciconfig_write ()
On success, zero is returned. On success, zero is returned.
On error, \-1 is returned and On error, \-1 is returned and
.I errno .I errno
is set appropriately. is set to indicate the error.
.TP .TP
.BR pciconfig_iobase () .BR pciconfig_iobase ()
Returns information on locations of various I/O Returns information on locations of various I/O

View File

@ -254,7 +254,7 @@ On success, the previous
is returned. is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EINVAL .B EINVAL

View File

@ -96,7 +96,7 @@ The current root directory must be a mount point.
.SH RETURN VALUE .SH RETURN VALUE
On success, zero is returned. On success, zero is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
\fIerrno\fP is set appropriately. \fIerrno\fP is set to indicate the error.
.SH ERRORS .SH ERRORS
.BR pivot_root () .BR pivot_root ()
may fail with any of the same errors as may fail with any of the same errors as

View File

@ -76,7 +76,7 @@ On success,
returns zero. returns zero.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EINVAL .B EINVAL

View File

@ -1932,7 +1932,7 @@ All other
values return 0 on success. values return 0 on success.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EACCES .B EACCES

View File

@ -227,7 +227,7 @@ a partial read/write occurred.
.PP .PP
On error, \-1 is returned and On error, \-1 is returned and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EFAULT .B EFAULT

View File

@ -2332,7 +2332,7 @@ other requests return zero.
.PP .PP
On error, all requests return \-1, and On error, all requests return \-1, and
.I errno .I errno
is set appropriately. is set to indicate the error.
Since the value returned by a successful Since the value returned by a successful
.B PTRACE_PEEK* .B PTRACE_PEEK*
request may be \-1, the caller must clear request may be \-1, the caller must clear

View File

@ -130,7 +130,7 @@ structure.
On success, zero is returned. On success, zero is returned.
On error, \-1 is returned and On error, \-1 is returned and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EFAULT .B EFAULT

View File

@ -93,7 +93,7 @@ See also NOTES.
.PP .PP
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
In this case, it is left unspecified whether In this case, it is left unspecified whether
the file position (if any) changes. the file position (if any) changes.
.SH ERRORS .SH ERRORS

View File

@ -95,7 +95,7 @@ On success, 1 is returned.
On end of directory, 0 is returned. On end of directory, 0 is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EBADF .B EBADF

View File

@ -282,7 +282,7 @@ than requested (see
and and
.BR write (2)). .BR write (2)).
.PP .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 .SH ERRORS
The errors are as given for The errors are as given for
.BR read (2) .BR read (2)

View File

@ -221,7 +221,7 @@ For the other
values, zero is returned on success. values, zero is returned on success.
In all cases, \-1 is returned on failure, and In all cases, \-1 is returned on failure, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EFAULT .B EFAULT

View File

@ -141,7 +141,7 @@ On success,
returns 0. returns 0.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EINVAL .B EINVAL

View File

@ -79,7 +79,7 @@ namespaces associated with an individual inode.
On success, zero is returned. On success, zero is returned.
On failure, \-1 is returned and On failure, \-1 is returned and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B ENODATA .B ENODATA

View File

@ -294,7 +294,7 @@ and ubifs (since Linux 4.9).
On success, zero is returned. On success, zero is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EACCES .B EACCES

View File

@ -43,7 +43,7 @@ deletes a directory, which must be empty.
On success, zero is returned. On success, zero is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EACCES .B EACCES

View File

@ -112,7 +112,7 @@ is 0.
.PP .PP
On error, \-1 is returned, and On error, \-1 is returned, and
.IR errno .IR errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EFAULT .B EFAULT

View File

@ -99,7 +99,7 @@ The return values 1 and 2 are reserved.
.PP .PP
On error, \-1 is returned, and On error, \-1 is returned, and
.IR errno .IR errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EFAULT .B EFAULT

View File

@ -105,7 +105,7 @@ return the maximum/minimum priority value for the named scheduling
policy. policy.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EINVAL .B EINVAL

View File

@ -78,7 +78,7 @@ On success,
returns 0. returns 0.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EFAULT .B EFAULT

View File

@ -114,7 +114,7 @@ which notes that the underlying
differs in its return value). differs in its return value).
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EFAULT .B EFAULT

View File

@ -91,7 +91,7 @@ and
return 0. return 0.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EINVAL .B EINVAL

View File

@ -138,7 +138,7 @@ On success,
returns the policy for the thread (a nonnegative integer). returns the policy for the thread (a nonnegative integer).
On error, both calls return \-1, and On error, both calls return \-1, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EINVAL .B EINVAL

View File

@ -46,7 +46,7 @@ On success,
returns 0. returns 0.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
In the Linux implementation, In the Linux implementation,
.BR sched_yield () .BR sched_yield ()

View File

@ -317,7 +317,7 @@ field is ignored.
On success, these calls return the number of bytes sent. On success, these calls return the number of bytes sent.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
These are some standard errors generated by the socket layer. These are some standard errors generated by the socket layer.
Additional errors Additional errors

View File

@ -112,7 +112,7 @@ See also NOTES.
.PP .PP
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EAGAIN .B EAGAIN

View File

@ -133,7 +133,7 @@ segments, although clearing a segment is still acceptable.
On x86, these system calls On x86, these system calls
return 0 on success, and \-1 on failure, with return 0 on success, and \-1 on failure, with
.I errno .I errno
set appropriately. set to indicate the error.
.PP .PP
On MIPS and m68k, On MIPS and m68k,
.BR set_thread_area () .BR set_thread_area ()

View File

@ -67,7 +67,7 @@ with "group" instead of "user".
On success, zero is returned. On success, zero is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.PP .PP
.IR Note : .IR Note :
there are cases where there are cases where

View File

@ -58,7 +58,7 @@ effective group ID in a secure manner.
On success, zero is returned. On success, zero is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EINVAL .B EINVAL

View File

@ -194,7 +194,7 @@ and
return zero. return zero.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.PP .PP
The POSIX.1 The POSIX.1
.BR getpgrp () .BR getpgrp ()
@ -206,7 +206,7 @@ and the BSD-specific
return a process group on success. return a process group on success.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EACCES .B EACCES

View File

@ -65,7 +65,7 @@ with the same restrictions for unprivileged processes.
On success, zero is returned. On success, zero is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.PP .PP
.IR Note : .IR Note :
there are cases where there are cases where

View File

@ -95,7 +95,7 @@ and all of the above holds with "group" instead of "user".
On success, zero is returned. On success, zero is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.PP .PP
.IR Note : .IR Note :
there are cases where there are cases where

View File

@ -75,7 +75,7 @@ You can accomplish this with
On success, zero is returned. On success, zero is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.PP .PP
.IR Note : .IR Note :
there are cases where there are cases where

View File

@ -110,7 +110,7 @@ which fails if the named attribute does not already exist.
On success, zero is returned. On success, zero is returned.
On failure, \-1 is returned and On failure, \-1 is returned and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EDQUOT .B EDQUOT

View File

@ -385,7 +385,7 @@ Other operations return 0 on success.
.PP .PP
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EACCES .B EACCES

View File

@ -72,7 +72,7 @@ further receptions and transmissions will be disallowed.
On success, zero is returned. On success, zero is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EBADF .B EBADF

View File

@ -418,7 +418,7 @@ are used to set and get options.
On success, a file descriptor for the new socket is returned. On success, a file descriptor for the new socket is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EACCES .B EACCES

View File

@ -368,7 +368,7 @@ for an explanation of the need for
On success, zero is returned. On success, zero is returned.
On error, \-1 is returned, and On error, \-1 is returned, and
.I errno .I errno
is set appropriately. is set to indicate the error.
.SH ERRORS .SH ERRORS
.TP .TP
.B EACCES .B EACCES

Some files were not shown because too many files have changed in this diff Show More