mirror of https://github.com/mkerrisk/man-pages
_syscall.2, accept.2, epoll_create.2, inotify_add_watch.2, ioctl.2, msgget.2, msgop.2, open.2, prctl.2, sched_setscheduler.2, semctl.2, semget.2, swapon.2, addseverity.3, cacosh.3, csqrt.3, dirfd.3, drand48.3, fputws.3, mq_send.3, posix_openpt.3, puts.3, sched_getcpu.3, shm_open.3, sqrt.3, sysconf.3, tgamma.3, ulimit.3, credentials.7, svipc.7: Global fix: s/non-negative/nonnegative/
The tendency in English, as prescribed in style guides like Chicago MoS, is towards removing hyphens after prefixes like "non-" etc. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
parent
ff40dbb354
commit
2fda57bd09
|
@ -97,7 +97,7 @@ You need to read the source to be sure how it will return errors.
|
||||||
Usually, it is the negative of a standard error code,
|
Usually, it is the negative of a standard error code,
|
||||||
for example, \-\fBEPERM\fP.
|
for example, \-\fBEPERM\fP.
|
||||||
The _syscall() macros will return the result \fIr\fP of the system call
|
The _syscall() macros will return the result \fIr\fP of the system call
|
||||||
when \fIr\fP is non-negative, but will return \-1 and set the variable
|
when \fIr\fP is nonnegative, but will return \-1 and set the variable
|
||||||
.I errno
|
.I errno
|
||||||
to \-\fIr\fP when \fIr\fP is negative.
|
to \-\fIr\fP when \fIr\fP is negative.
|
||||||
For the error codes, see
|
For the error codes, see
|
||||||
|
|
|
@ -177,7 +177,7 @@ flag in
|
||||||
for reasons why this may be useful.
|
for reasons why this may be useful.
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
On success,
|
On success,
|
||||||
these system calls return a non-negative integer that is a descriptor
|
these system calls return a nonnegative integer that is a descriptor
|
||||||
for the accepted socket.
|
for the accepted socket.
|
||||||
On error, \-1 is returned, and
|
On error, \-1 is returned, and
|
||||||
.I errno
|
.I errno
|
||||||
|
|
|
@ -83,7 +83,7 @@ for reasons why this may be useful.
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
On success,
|
On success,
|
||||||
these system calls
|
these system calls
|
||||||
return a non-negative file descriptor.
|
return a nonnegative file descriptor.
|
||||||
On error, \-1 is returned, and
|
On error, \-1 is returned, and
|
||||||
.I errno
|
.I errno
|
||||||
is set to indicate the error.
|
is set to indicate the error.
|
||||||
|
|
|
@ -80,7 +80,7 @@ the object for which the event occurred.
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
On success,
|
On success,
|
||||||
.BR inotify_add_watch ()
|
.BR inotify_add_watch ()
|
||||||
returns a non-negative watch descriptor.
|
returns a nonnegative watch descriptor.
|
||||||
On error \-1 is returned and
|
On error \-1 is returned and
|
||||||
.I errno
|
.I errno
|
||||||
is set appropriately.
|
is set appropriately.
|
||||||
|
|
|
@ -83,7 +83,7 @@ Usually, on success zero is returned.
|
||||||
A few
|
A few
|
||||||
.BR ioctl ()
|
.BR ioctl ()
|
||||||
requests use the return value as an output parameter
|
requests use the return value as an output parameter
|
||||||
and return a non-negative 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 appropriately.
|
||||||
|
|
|
@ -134,7 +134,7 @@ verified, and a check is made to see if it is marked for
|
||||||
destruction.
|
destruction.
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
If successful, the return value will be the message queue identifier (a
|
If successful, the return value will be the message queue identifier (a
|
||||||
non-negative integer), otherwise \-1
|
nonnegative integer), otherwise \-1
|
||||||
with
|
with
|
||||||
.I errno
|
.I errno
|
||||||
indicating the error.
|
indicating the error.
|
||||||
|
|
|
@ -79,7 +79,7 @@ The
|
||||||
.I mtext
|
.I mtext
|
||||||
field is an array (or other structure) whose size is specified by
|
field is an array (or other structure) whose size is specified by
|
||||||
.IR msgsz ,
|
.IR msgsz ,
|
||||||
a non-negative integer value.
|
a nonnegative integer value.
|
||||||
Messages of zero length (i.e., no
|
Messages of zero length (i.e., no
|
||||||
.I mtext
|
.I mtext
|
||||||
field) are permitted.
|
field) are permitted.
|
||||||
|
|
|
@ -67,7 +67,7 @@ Given a
|
||||||
.I pathname
|
.I pathname
|
||||||
for a file,
|
for a file,
|
||||||
.BR open ()
|
.BR open ()
|
||||||
returns a file descriptor, a small, non-negative integer
|
returns a file descriptor, a small, nonnegative integer
|
||||||
for use in subsequent system calls
|
for use in subsequent system calls
|
||||||
.RB ( read "(2), " write "(2), " lseek "(2), " fcntl "(2), etc.)."
|
.RB ( read "(2), " write "(2), " lseek "(2), " fcntl "(2), etc.)."
|
||||||
The file descriptor returned by a successful call will be
|
The file descriptor returned by a successful call will be
|
||||||
|
|
|
@ -327,7 +327,7 @@ On success,
|
||||||
.BR PR_GET_SECUREBITS ,
|
.BR PR_GET_SECUREBITS ,
|
||||||
and (if it returns)
|
and (if it returns)
|
||||||
.BR PR_GET_SECCOMP
|
.BR PR_GET_SECCOMP
|
||||||
return the non-negative values described above.
|
return the nonnegative values described above.
|
||||||
All other
|
All other
|
||||||
.I option
|
.I option
|
||||||
values return 0 on success.
|
values return 0 on success.
|
||||||
|
|
|
@ -367,7 +367,7 @@ On success,
|
||||||
returns zero.
|
returns zero.
|
||||||
On success,
|
On success,
|
||||||
.BR sched_getscheduler ()
|
.BR sched_getscheduler ()
|
||||||
returns the policy for the process (a non-negative integer).
|
returns the policy for the process (a nonnegative integer).
|
||||||
On error, \-1 is returned, and
|
On error, \-1 is returned, and
|
||||||
.I errno
|
.I errno
|
||||||
is set appropriately.
|
is set appropriately.
|
||||||
|
|
|
@ -343,7 +343,7 @@ with
|
||||||
.I errno
|
.I errno
|
||||||
indicating the error.
|
indicating the error.
|
||||||
|
|
||||||
Otherwise the system call returns a non-negative value depending on
|
Otherwise the system call returns a nonnegative value depending on
|
||||||
.I cmd
|
.I cmd
|
||||||
as follows:
|
as follows:
|
||||||
.TP 12
|
.TP 12
|
||||||
|
|
|
@ -154,7 +154,7 @@ verified.
|
||||||
.\" and a check is made to see if it is marked for destruction.
|
.\" and a check is made to see if it is marked for destruction.
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
If successful, the return value will be the semaphore set identifier
|
If successful, the return value will be the semaphore set identifier
|
||||||
(a non-negative integer), otherwise \-1
|
(a nonnegative integer), otherwise \-1
|
||||||
is returned, with
|
is returned, with
|
||||||
.I errno
|
.I errno
|
||||||
indicating the error.
|
indicating the error.
|
||||||
|
|
|
@ -84,7 +84,7 @@ newer areas are even lower priority than older areas.
|
||||||
All priorities set with
|
All priorities set with
|
||||||
.I swapflags
|
.I swapflags
|
||||||
are high-priority, higher than default.
|
are high-priority, higher than default.
|
||||||
They may have any non-negative value chosen by the caller.
|
They may have any nonnegative value chosen by the caller.
|
||||||
Higher numbers mean higher priority.
|
Higher numbers mean higher priority.
|
||||||
.PP
|
.PP
|
||||||
Swap pages are allocated from areas in priority order,
|
Swap pages are allocated from areas in priority order,
|
||||||
|
|
|
@ -42,7 +42,7 @@ is NULL, the severity class with the numeric value
|
||||||
is removed.
|
is removed.
|
||||||
It is not possible to overwrite or remove one of the default
|
It is not possible to overwrite or remove one of the default
|
||||||
severity classes.
|
severity classes.
|
||||||
The severity value must be non-negative.
|
The severity value must be nonnegative.
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
Upon success, the value
|
Upon success, the value
|
||||||
.B MM_OK
|
.B MM_OK
|
||||||
|
|
|
@ -25,7 +25,7 @@ The imaginary part of
|
||||||
is chosen in the interval [\-pi,pi].
|
is chosen in the interval [\-pi,pi].
|
||||||
The real part of
|
The real part of
|
||||||
.I y
|
.I y
|
||||||
is chosen non-negative.
|
is chosen nonnegative.
|
||||||
.LP
|
.LP
|
||||||
One has:
|
One has:
|
||||||
.nf
|
.nf
|
||||||
|
|
|
@ -16,7 +16,7 @@ csqrt, csqrtf, csqrtl \- complex square root
|
||||||
Link with \fI\-lm\fP.
|
Link with \fI\-lm\fP.
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
Calculate the square root of a given complex number,
|
Calculate the square root of a given complex number,
|
||||||
with non-negative real part, and
|
with nonnegative real part, and
|
||||||
with a branch cut along the negative real axis.
|
with a branch cut along the negative real axis.
|
||||||
(That means that \fIcsqrt(\-1+eps*I)\fP will be close to I while
|
(That means that \fIcsqrt(\-1+eps*I)\fP will be close to I while
|
||||||
\fIcsqrt(\-1\-eps*I)\fP will be close to \-I, \fIif eps\fP is a small positive
|
\fIcsqrt(\-1\-eps*I)\fP will be close to \-I, \fIif eps\fP is a small positive
|
||||||
|
|
|
@ -53,7 +53,7 @@ It will be automatically closed when
|
||||||
.BR closedir (3)
|
.BR closedir (3)
|
||||||
is called.
|
is called.
|
||||||
.SH RETURN VALUE
|
.SH RETURN VALUE
|
||||||
On success, a non-negative file descriptor is returned.
|
On success, a nonnegative file descriptor is returned.
|
||||||
On error, \-1 is returned.
|
On error, \-1 is returned.
|
||||||
.SH ERRORS
|
.SH ERRORS
|
||||||
POSIX.1-2008 specifies two errors,
|
POSIX.1-2008 specifies two errors,
|
||||||
|
|
|
@ -78,7 +78,7 @@ The
|
||||||
.BR drand48 ()
|
.BR drand48 ()
|
||||||
and
|
and
|
||||||
.BR erand48 ()
|
.BR erand48 ()
|
||||||
functions return non-negative
|
functions return nonnegative
|
||||||
double-precision floating-point values uniformly distributed between
|
double-precision floating-point values uniformly distributed between
|
||||||
[0.0, 1.0).
|
[0.0, 1.0).
|
||||||
.PP
|
.PP
|
||||||
|
@ -86,7 +86,7 @@ The
|
||||||
.BR lrand48 ()
|
.BR lrand48 ()
|
||||||
and
|
and
|
||||||
.BR nrand48 ()
|
.BR nrand48 ()
|
||||||
functions return non-negative
|
functions return nonnegative
|
||||||
long integers uniformly distributed between 0 and 2^31.
|
long integers uniformly distributed between 0 and 2^31.
|
||||||
.PP
|
.PP
|
||||||
The
|
The
|
||||||
|
|
|
@ -36,7 +36,7 @@ For a non-locking counterpart, see
|
||||||
The
|
The
|
||||||
.BR fputws ()
|
.BR fputws ()
|
||||||
function returns a
|
function returns a
|
||||||
non-negative integer if the operation was
|
nonnegative integer if the operation was
|
||||||
successful, or \-1 to indicate an error.
|
successful, or \-1 to indicate an error.
|
||||||
.SH "CONFORMING TO"
|
.SH "CONFORMING TO"
|
||||||
C99, POSIX.1-2001.
|
C99, POSIX.1-2001.
|
||||||
|
|
|
@ -60,7 +60,7 @@ Zero-length messages are allowed.
|
||||||
|
|
||||||
The
|
The
|
||||||
.I msg_prio
|
.I msg_prio
|
||||||
argument is a non-negative integer that specifies the priority
|
argument is a nonnegative integer that specifies the priority
|
||||||
of this message.
|
of this message.
|
||||||
Messages are placed on the queue in decreasing order of priority,
|
Messages are placed on the queue in decreasing order of priority,
|
||||||
with newer messages of the same priority being placed after
|
with newer messages of the same priority being placed after
|
||||||
|
|
|
@ -62,7 +62,7 @@ Do not make this device the controlling terminal for the process.
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
On success,
|
On success,
|
||||||
.BR posix_openpt ()
|
.BR posix_openpt ()
|
||||||
returns a non-negative file descriptor which is the lowest
|
returns a nonnegative file descriptor which is the lowest
|
||||||
numbered unused descriptor.
|
numbered unused descriptor.
|
||||||
On failure, \-1 is returned, and
|
On failure, \-1 is returned, and
|
||||||
.I errno
|
.I errno
|
||||||
|
|
|
@ -96,7 +96,7 @@ on error.
|
||||||
.BR puts ()
|
.BR puts ()
|
||||||
and
|
and
|
||||||
.BR fputs ()
|
.BR fputs ()
|
||||||
return a non-negative number on success, or
|
return a nonnegative number on success, or
|
||||||
.B EOF
|
.B EOF
|
||||||
on error.
|
on error.
|
||||||
.SH "CONFORMING TO"
|
.SH "CONFORMING TO"
|
||||||
|
|
|
@ -45,7 +45,7 @@ returns the number of the CPU on which the calling thread is currently executing
|
||||||
.SH RETURN VALUE
|
.SH RETURN VALUE
|
||||||
On success,
|
On success,
|
||||||
.BR sched_getcpu ()
|
.BR sched_getcpu ()
|
||||||
returns a non-negative CPU number.
|
returns a nonnegative CPU number.
|
||||||
On error, \-1 is returned and
|
On error, \-1 is returned and
|
||||||
.I errno
|
.I errno
|
||||||
is set to indicate the error.
|
is set to indicate the error.
|
||||||
|
|
|
@ -169,7 +169,7 @@ was specified, in which case a new, distinct object is created).
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
On success,
|
On success,
|
||||||
.BR shm_open ()
|
.BR shm_open ()
|
||||||
returns a non-negative file descriptor.
|
returns a nonnegative file descriptor.
|
||||||
On failure,
|
On failure,
|
||||||
.BR shm_open ()
|
.BR shm_open ()
|
||||||
returns \-1.
|
returns \-1.
|
||||||
|
|
|
@ -59,7 +59,7 @@ _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE; or
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
The
|
The
|
||||||
.BR sqrt ()
|
.BR sqrt ()
|
||||||
function returns the non-negative square root of \fIx\fP.
|
function returns the nonnegative square root of \fIx\fP.
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
On success, these functions return the square root of
|
On success, these functions return the square root of
|
||||||
.IR x .
|
.IR x .
|
||||||
|
|
|
@ -122,7 +122,7 @@ First, the POSIX.1 compatible values.
|
||||||
.\" (if _POSIX_ASYNCHRONOUS_IO)
|
.\" (if _POSIX_ASYNCHRONOUS_IO)
|
||||||
.\" The maximum amount by which a process can decrease its
|
.\" The maximum amount by which a process can decrease its
|
||||||
.\" asynchronous I/O priority level from its own scheduling priority.
|
.\" asynchronous I/O priority level from its own scheduling priority.
|
||||||
.\" Must be non-negative.
|
.\" Must be nonnegative.
|
||||||
.TP
|
.TP
|
||||||
.BR ARG_MAX " - " _SC_ARG_MAX
|
.BR ARG_MAX " - " _SC_ARG_MAX
|
||||||
The maximum length of the arguments to the
|
The maximum length of the arguments to the
|
||||||
|
|
|
@ -37,7 +37,7 @@ The Gamma function is defined by
|
||||||
Gamma(x) = integral from 0 to infinity of t^(x\-1) e^\-t dt
|
Gamma(x) = integral from 0 to infinity of t^(x\-1) e^\-t dt
|
||||||
.sp
|
.sp
|
||||||
It is defined for every real number except for non-positive integers.
|
It is defined for every real number except for non-positive integers.
|
||||||
For non-negative integral \fIm\fP one has
|
For nonnegative integral \fIm\fP one has
|
||||||
.sp
|
.sp
|
||||||
Gamma(m+1) = m!
|
Gamma(m+1) = m!
|
||||||
.sp
|
.sp
|
||||||
|
|
|
@ -67,7 +67,7 @@ Return the maximum number of files that the calling process can open.
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
On success,
|
On success,
|
||||||
.BR ulimit ()
|
.BR ulimit ()
|
||||||
returns a non-negative value.
|
returns a nonnegative value.
|
||||||
On error, \-1 is returned, and
|
On error, \-1 is returned, and
|
||||||
.I errno
|
.I errno
|
||||||
is set appropriately.
|
is set appropriately.
|
||||||
|
|
|
@ -27,7 +27,7 @@
|
||||||
credentials \- process identifiers
|
credentials \- process identifiers
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
.SS Process ID (PID)
|
.SS Process ID (PID)
|
||||||
Each process has a unique non-negative integer identifier
|
Each process has a unique nonnegative integer identifier
|
||||||
that is assigned when the process is created using
|
that is assigned when the process is created using
|
||||||
.BR fork (2).
|
.BR fork (2).
|
||||||
A process can obtain its PID using
|
A process can obtain its PID using
|
||||||
|
|
|
@ -220,7 +220,7 @@ semaphore belonging to the set.
|
||||||
.TP
|
.TP
|
||||||
.I sem_nsems
|
.I sem_nsems
|
||||||
Number of semaphores in the set.
|
Number of semaphores in the set.
|
||||||
Each semaphore of the set is referenced by a non-negative integer
|
Each semaphore of the set is referenced by a nonnegative integer
|
||||||
ranging from
|
ranging from
|
||||||
.B 0
|
.B 0
|
||||||
to
|
to
|
||||||
|
@ -242,7 +242,7 @@ struct sem {
|
||||||
.in
|
.in
|
||||||
.TP 11
|
.TP 11
|
||||||
.I semval
|
.I semval
|
||||||
Semaphore value: a non-negative integer.
|
Semaphore value: a nonnegative integer.
|
||||||
.TP
|
.TP
|
||||||
.I sempid
|
.I sempid
|
||||||
ID of the last process that performed a semaphore operation
|
ID of the last process that performed a semaphore operation
|
||||||
|
|
Loading…
Reference in New Issue