mirror of https://github.com/mkerrisk/man-pages
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:
parent
855d489a7f
commit
f6a4078be5
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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 ,
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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.
|
||||||
|
|
|
@ -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.
|
||||||
|
|
|
@ -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:
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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.
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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)
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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:
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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)"
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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.
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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.
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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.
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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.
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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 ()
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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)
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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 ()
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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 ()
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
Loading…
Reference in New Issue