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),
|
||||
\-1 is returned, and
|
||||
.I errno
|
||||
is set appropriately.
|
||||
is set to indicate the error.
|
||||
.SH ERRORS
|
||||
.BR access ()
|
||||
and
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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 ,
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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.
|
||||
|
|
|
@ -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.
|
||||
|
|
|
@ -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:
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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.
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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)
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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:
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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)"
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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.
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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.
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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.
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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.
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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 ()
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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)
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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 ()
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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 ()
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in New Issue