mirror of https://github.com/mkerrisk/man-pages
s/nonzero/non-zero/
This commit is contained in:
parent
1f04cc9731
commit
eba722884d
|
@ -37,11 +37,11 @@ This value can be tested (e.g., in most shells the variable
|
||||||
contains the status of the last executed command)
|
contains the status of the last executed command)
|
||||||
to see whether the command completed successfully.
|
to see whether the command completed successfully.
|
||||||
A zero exit status is conventionally used to indicate success,
|
A zero exit status is conventionally used to indicate success,
|
||||||
and a nonzero status means that the command was unsuccessful.
|
and a non-zero status means that the command was unsuccessful.
|
||||||
(Details of the exit status can be found in
|
(Details of the exit status can be found in
|
||||||
.BR wait (2).)
|
.BR wait (2).)
|
||||||
A nonzero exit status can be in the range 1 to 255, and some commands
|
A non-zero exit status can be in the range 1 to 255, and some commands
|
||||||
use different nonzero status values to indicate the reason why the
|
use different non-zero status values to indicate the reason why the
|
||||||
command failed.
|
command failed.
|
||||||
.SH NOTES
|
.SH NOTES
|
||||||
Linux is a flavor of Unix, and as a first approximation
|
Linux is a flavor of Unix, and as a first approximation
|
||||||
|
|
|
@ -59,7 +59,7 @@ was invoked, the exit status is that of
|
||||||
Otherwise it is 127 if
|
Otherwise it is 127 if
|
||||||
.I command
|
.I command
|
||||||
could not be found, 126 if it could be found but could not be invoked,
|
could not be found, 126 if it could be found but could not be invoked,
|
||||||
and some other nonzero value (1-125) if something else went wrong.
|
and some other non-zero value (1-125) if something else went wrong.
|
||||||
.SH ENVIRONMENT
|
.SH ENVIRONMENT
|
||||||
The variables
|
The variables
|
||||||
.BR LANG ,
|
.BR LANG ,
|
||||||
|
|
|
@ -134,7 +134,7 @@ is the system timer interrupt frequency.
|
||||||
.TP
|
.TP
|
||||||
.B EPERM
|
.B EPERM
|
||||||
.I buf.mode
|
.I buf.mode
|
||||||
is nonzero and the caller does not have sufficient privilege.
|
is non-zero and the caller does not have sufficient privilege.
|
||||||
Under Linux the
|
Under Linux the
|
||||||
.B CAP_SYS_TIME
|
.B CAP_SYS_TIME
|
||||||
capability is required.
|
capability is required.
|
||||||
|
|
|
@ -81,7 +81,7 @@ The calls operate on the capabilities of the thread specified by the
|
||||||
.I pid
|
.I pid
|
||||||
field of
|
field of
|
||||||
.I hdrp
|
.I hdrp
|
||||||
when that is nonzero, or on the capabilities of the calling thread if
|
when that is non-zero, or on the capabilities of the calling thread if
|
||||||
.I pid
|
.I pid
|
||||||
is 0.
|
is 0.
|
||||||
If
|
If
|
||||||
|
@ -137,7 +137,7 @@ capability is required.
|
||||||
occur if a thread without this capability tried to change its
|
occur if a thread without this capability tried to change its
|
||||||
own capabilities by specifying the
|
own capabilities by specifying the
|
||||||
.I pid
|
.I pid
|
||||||
field as a nonzero value (i.e., the value returned by
|
field as a non-zero value (i.e., the value returned by
|
||||||
.BR getpid (2))
|
.BR getpid (2))
|
||||||
instead of 0.)
|
instead of 0.)
|
||||||
.TP
|
.TP
|
||||||
|
|
|
@ -46,7 +46,7 @@ eventfd object.
|
||||||
The following operations can be performed on the file descriptor:
|
The following operations can be performed on the file descriptor:
|
||||||
.TP
|
.TP
|
||||||
.BR read (2)
|
.BR read (2)
|
||||||
If the eventfd counter has a nonzero value, then a
|
If the eventfd counter has a non-zero value, then a
|
||||||
.BR read (2)
|
.BR read (2)
|
||||||
returns 8 bytes containing that value,
|
returns 8 bytes containing that value,
|
||||||
and the counter's value is reset to zero.
|
and the counter's value is reset to zero.
|
||||||
|
@ -55,7 +55,7 @@ i.e., the native byte order for integers on the host machine.)
|
||||||
.IP
|
.IP
|
||||||
If the counter is zero at the time of the
|
If the counter is zero at the time of the
|
||||||
.BR read (2),
|
.BR read (2),
|
||||||
then the call either blocks until the counter becomes nonzero,
|
then the call either blocks until the counter becomes non-zero,
|
||||||
or fails with the error
|
or fails with the error
|
||||||
.B EAGAIN
|
.B EAGAIN
|
||||||
if the file descriptor has been made non-blocking
|
if the file descriptor has been made non-blocking
|
||||||
|
@ -180,7 +180,7 @@ is set to indicate the error.
|
||||||
.SH ERRORS
|
.SH ERRORS
|
||||||
.TP EINVAL
|
.TP EINVAL
|
||||||
.I flags
|
.I flags
|
||||||
is nonzero.
|
is non-zero.
|
||||||
.\" Eventually glibc may support some flags
|
.\" Eventually glibc may support some flags
|
||||||
.TP
|
.TP
|
||||||
.B EMFILE
|
.B EMFILE
|
||||||
|
|
|
@ -469,7 +469,7 @@ would report the socket as having an "exceptional condition".)
|
||||||
.\" refers to a terminal device, then SIGIO
|
.\" refers to a terminal device, then SIGIO
|
||||||
.\" signals are sent to the foreground process group of the terminal.
|
.\" signals are sent to the foreground process group of the terminal.
|
||||||
|
|
||||||
If a nonzero value is given to
|
If a non-zero value is given to
|
||||||
.B F_SETSIG
|
.B F_SETSIG
|
||||||
in a multi-threaded process running with a threading library
|
in a multi-threaded process running with a threading library
|
||||||
that supports thread groups (e.g., NPTL),
|
that supports thread groups (e.g., NPTL),
|
||||||
|
@ -543,7 +543,7 @@ is the signal to send instead, and in this case additional info
|
||||||
is available to the signal handler if installed with
|
is available to the signal handler if installed with
|
||||||
.BR SA_SIGINFO .
|
.BR SA_SIGINFO .
|
||||||
|
|
||||||
Additionally, passing a nonzero value to
|
Additionally, passing a non-zero value to
|
||||||
.B F_SETSIG
|
.B F_SETSIG
|
||||||
changes the signal recipient from a whole process to a specific thread
|
changes the signal recipient from a whole process to a specific thread
|
||||||
within a process.
|
within a process.
|
||||||
|
@ -553,7 +553,7 @@ for more details.
|
||||||
|
|
||||||
By using
|
By using
|
||||||
.B F_SETSIG
|
.B F_SETSIG
|
||||||
with a nonzero value, and setting
|
with a non-zero value, and setting
|
||||||
.B SA_SIGINFO
|
.B SA_SIGINFO
|
||||||
for the
|
for the
|
||||||
signal handler (see
|
signal handler (see
|
||||||
|
|
|
@ -84,7 +84,7 @@ sets the indicated timer to the value in
|
||||||
.IR value .
|
.IR value .
|
||||||
If
|
If
|
||||||
.I ovalue
|
.I ovalue
|
||||||
is nonzero, the old value of the timer is stored there.
|
is non-zero, the old value of the timer is stored there.
|
||||||
.LP
|
.LP
|
||||||
Timers decrement from
|
Timers decrement from
|
||||||
.I it_value
|
.I it_value
|
||||||
|
|
|
@ -137,7 +137,7 @@ Maximum size of
|
||||||
.I core
|
.I core
|
||||||
file.
|
file.
|
||||||
When 0 no core dump files are created.
|
When 0 no core dump files are created.
|
||||||
When nonzero, larger dumps are truncated to this size.
|
When non-zero, larger dumps are truncated to this size.
|
||||||
.TP
|
.TP
|
||||||
.B RLIMIT_CPU
|
.B RLIMIT_CPU
|
||||||
CPU time limit in seconds.
|
CPU time limit in seconds.
|
||||||
|
|
|
@ -122,7 +122,7 @@ parameter for
|
||||||
.IR optval .
|
.IR optval .
|
||||||
For
|
For
|
||||||
.BR setsockopt (),
|
.BR setsockopt (),
|
||||||
the parameter should be nonzero to enable a boolean option, or zero if the
|
the parameter should be non-zero to enable a boolean option, or zero if the
|
||||||
option is to be disabled.
|
option is to be disabled.
|
||||||
.PP
|
.PP
|
||||||
For a description of the available socket options see
|
For a description of the available socket options see
|
||||||
|
|
|
@ -178,7 +178,7 @@ argument, the
|
||||||
.I tv
|
.I tv
|
||||||
argument is NULL and the
|
argument is NULL and the
|
||||||
.I tz_minuteswest
|
.I tz_minuteswest
|
||||||
field is nonzero.
|
field is non-zero.
|
||||||
In such a case it is assumed that the CMOS clock
|
In such a case it is assumed that the CMOS clock
|
||||||
is on local time, and that it has to be incremented by this amount
|
is on local time, and that it has to be incremented by this amount
|
||||||
to get UTC system time.
|
to get UTC system time.
|
||||||
|
|
|
@ -51,7 +51,7 @@ absolute value into the
|
||||||
variable, and returns \-1 as the return value of the wrapper.
|
variable, and returns \-1 as the return value of the wrapper.
|
||||||
|
|
||||||
The value returned by a successful system call depends on the call.
|
The value returned by a successful system call depends on the call.
|
||||||
Many system calls return 0 on success, but some can return nonzero
|
Many system calls return 0 on success, but some can return non-zero
|
||||||
values from a successful call.
|
values from a successful call.
|
||||||
The details are described in the individual manual pages.
|
The details are described in the individual manual pages.
|
||||||
|
|
||||||
|
|
|
@ -733,13 +733,13 @@ takes a
|
||||||
.IR "struct floppy raw_cmd *" .
|
.IR "struct floppy raw_cmd *" .
|
||||||
If
|
If
|
||||||
.I flags & FD_RAW_WRITE
|
.I flags & FD_RAW_WRITE
|
||||||
is nonzero, then
|
is non-zero, then
|
||||||
.I data
|
.I data
|
||||||
points to an input buffer of length
|
points to an input buffer of length
|
||||||
.IR length .
|
.IR length .
|
||||||
If
|
If
|
||||||
.I flags & FD_RAW_READ
|
.I flags & FD_RAW_READ
|
||||||
is nonzero, then
|
is non-zero, then
|
||||||
.I data
|
.I data
|
||||||
points to an output buffer of length
|
points to an output buffer of length
|
||||||
.IR length .
|
.IR length .
|
||||||
|
|
|
@ -48,7 +48,7 @@ ioperm \- set port input/output permissions
|
||||||
sets the port access permission bits for the calling process for
|
sets the port access permission bits for the calling process for
|
||||||
\fInum\fP bytes starting from port address \fIfrom\fP to the value
|
\fInum\fP bytes starting from port address \fIfrom\fP to the value
|
||||||
\fIturn_on\fP.
|
\fIturn_on\fP.
|
||||||
If \fIturn_on\fP is nonzero, the calling process must be privileged
|
If \fIturn_on\fP is non-zero, the calling process must be privileged
|
||||||
.RB ( CAP_SYS_RAWIO ).
|
.RB ( CAP_SYS_RAWIO ).
|
||||||
|
|
||||||
.\" FIXME is the following ("Only the first 0x3ff I/O ports can be
|
.\" FIXME is the following ("Only the first 0x3ff I/O ports can be
|
||||||
|
|
|
@ -123,7 +123,7 @@ address space of the process.
|
||||||
.SH ERRORS
|
.SH ERRORS
|
||||||
.TP
|
.TP
|
||||||
.B ENOMEM
|
.B ENOMEM
|
||||||
(Linux 2.6.9 and later) the caller had a nonzero
|
(Linux 2.6.9 and later) the caller had a non-zero
|
||||||
.B RLIMIT_MEMLOCK
|
.B RLIMIT_MEMLOCK
|
||||||
soft resource limit, but tried to lock more memory than the limit
|
soft resource limit, but tried to lock more memory than the limit
|
||||||
permitted.
|
permitted.
|
||||||
|
@ -306,7 +306,7 @@ Since kernel 2.6.9, if a privileged process calls
|
||||||
and later drops privileges (loses the
|
and later drops privileges (loses the
|
||||||
.B CAP_IPC_LOCK
|
.B CAP_IPC_LOCK
|
||||||
capability by, for example,
|
capability by, for example,
|
||||||
setting its effective UID to a nonzero value),
|
setting its effective UID to a non-zero value),
|
||||||
then subsequent memory allocations (e.g.,
|
then subsequent memory allocations (e.g.,
|
||||||
.BR mmap (2),
|
.BR mmap (2),
|
||||||
.BR brk (2))
|
.BR brk (2))
|
||||||
|
|
|
@ -71,7 +71,7 @@ They must be directories.
|
||||||
\fInew_root\fP and \fIput_old\fP must not be on the same file system as
|
\fInew_root\fP and \fIput_old\fP must not be on the same file system as
|
||||||
the current root.
|
the current root.
|
||||||
.IP \- 3
|
.IP \- 3
|
||||||
\fIput_old\fP must be underneath \fInew_root\fP, that is, adding a nonzero
|
\fIput_old\fP must be underneath \fInew_root\fP, that is, adding a non-zero
|
||||||
number of \fI/..\fP to the string pointed to by \fIput_old\fP must yield
|
number of \fI/..\fP to the string pointed to by \fIput_old\fP must yield
|
||||||
the same directory as \fInew_root\fP.
|
the same directory as \fInew_root\fP.
|
||||||
.IP \- 3
|
.IP \- 3
|
||||||
|
|
|
@ -238,7 +238,7 @@ is specified as NULL, then
|
||||||
can block indefinitely.
|
can block indefinitely.
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
On success, a positive number is returned; this is
|
On success, a positive number is returned; this is
|
||||||
the number of structures which have nonzero
|
the number of structures which have non-zero
|
||||||
.I revents
|
.I revents
|
||||||
fields (in other words, those descriptors with events or errors reported).
|
fields (in other words, those descriptors with events or errors reported).
|
||||||
A value of 0 indicates that the call timed out and no file
|
A value of 0 indicates that the call timed out and no file
|
||||||
|
|
|
@ -96,7 +96,7 @@ Return (as the function result) the current state of the calling
|
||||||
process's dumpable flag.
|
process's dumpable flag.
|
||||||
.\" Since Linux 2.6.13, the dumpable flag can have the value 2,
|
.\" Since Linux 2.6.13, the dumpable flag can have the value 2,
|
||||||
.\" but in 2.6.13 PR_GET_DUMPABLE simply returns 1 if the dumpable
|
.\" but in 2.6.13 PR_GET_DUMPABLE simply returns 1 if the dumpable
|
||||||
.\" flags has a nonzero value. This was fixed in 2.6.14.
|
.\" flags has a non-zero value. This was fixed in 2.6.14.
|
||||||
.TP
|
.TP
|
||||||
.B PR_SET_KEEPCAPS
|
.B PR_SET_KEEPCAPS
|
||||||
(Since Linux 2.2.18)
|
(Since Linux 2.2.18)
|
||||||
|
@ -104,7 +104,7 @@ Set the state of the process's "keep capabilities" flag,
|
||||||
which determines whether the process's effective and permitted
|
which determines whether the process's effective and permitted
|
||||||
capability sets are cleared when a change is made to the process's user IDs
|
capability sets are cleared when a change is made to the process's user IDs
|
||||||
such that the process's real UID, effective UID, and saved set-user-ID
|
such that the process's real UID, effective UID, and saved set-user-ID
|
||||||
all become nonzero when at least one of them previously had the value 0.
|
all become non-zero when at least one of them previously had the value 0.
|
||||||
(By default, these credential sets are cleared).
|
(By default, these credential sets are cleared).
|
||||||
.I arg2
|
.I arg2
|
||||||
must be either 0 (capabilities are cleared) or 1 (capabilities are kept).
|
must be either 0 (capabilities are cleared) or 1 (capabilities are kept).
|
||||||
|
|
|
@ -301,7 +301,7 @@ for
|
||||||
.TP
|
.TP
|
||||||
.B PTRACE_CONT
|
.B PTRACE_CONT
|
||||||
Restarts the stopped child process.
|
Restarts the stopped child process.
|
||||||
If \fIdata\fP is nonzero and not
|
If \fIdata\fP is non-zero and not
|
||||||
.BR SIGSTOP ,
|
.BR SIGSTOP ,
|
||||||
it is interpreted as a signal to be delivered to the child;
|
it is interpreted as a signal to be delivered to the child;
|
||||||
otherwise, no signal is delivered.
|
otherwise, no signal is delivered.
|
||||||
|
|
|
@ -244,7 +244,7 @@ policies).
|
||||||
.SS Privileges and resource limits
|
.SS Privileges and resource limits
|
||||||
In Linux kernels before 2.6.12, only privileged
|
In Linux kernels before 2.6.12, only privileged
|
||||||
.RB ( CAP_SYS_NICE )
|
.RB ( CAP_SYS_NICE )
|
||||||
processes can set a nonzero static priority.
|
processes can set a non-zero static priority.
|
||||||
The only change that an unprivileged process can make is to set the
|
The only change that an unprivileged process can make is to set the
|
||||||
.B SCHED_OTHER
|
.B SCHED_OTHER
|
||||||
policy, and this can only be done if the effective user ID of the caller of
|
policy, and this can only be done if the effective user ID of the caller of
|
||||||
|
@ -262,7 +262,7 @@ priority for the
|
||||||
and
|
and
|
||||||
.B SCHED_FIFO
|
.B SCHED_FIFO
|
||||||
policies.
|
policies.
|
||||||
If an unprivileged process has a nonzero
|
If an unprivileged process has a non-zero
|
||||||
.B RLIMIT_RTPRIO
|
.B RLIMIT_RTPRIO
|
||||||
soft limit, then it can change its scheduling policy and priority,
|
soft limit, then it can change its scheduling policy and priority,
|
||||||
subject to the restriction that the priority cannot be set to a
|
subject to the restriction that the priority cannot be set to a
|
||||||
|
|
|
@ -119,7 +119,7 @@ descriptor is still present in the set with the
|
||||||
.BR FD_ISSET ()
|
.BR FD_ISSET ()
|
||||||
macro.
|
macro.
|
||||||
.BR FD_ISSET ()
|
.BR FD_ISSET ()
|
||||||
returns nonzero if the descriptor is present and zero if
|
returns non-zero if the descriptor is present and zero if
|
||||||
it is not.
|
it is not.
|
||||||
.BR FD_CLR ()
|
.BR FD_CLR ()
|
||||||
removes a file descriptor from the set.
|
removes a file descriptor from the set.
|
||||||
|
|
|
@ -273,7 +273,7 @@ or a
|
||||||
.B SETALL
|
.B SETALL
|
||||||
operation on the semaphore set.
|
operation on the semaphore set.
|
||||||
(Where multiple peers do not know who will be the first to
|
(Where multiple peers do not know who will be the first to
|
||||||
initialize the set, checking for a nonzero
|
initialize the set, checking for a non-zero
|
||||||
.I sem_otime
|
.I sem_otime
|
||||||
in the associated data structure retrieved by a
|
in the associated data structure retrieved by a
|
||||||
.BR semctl (2)
|
.BR semctl (2)
|
||||||
|
|
|
@ -134,7 +134,7 @@ outside of the process's address space.
|
||||||
.TP
|
.TP
|
||||||
.B EINVAL
|
.B EINVAL
|
||||||
\fIss\fP is not NULL and the \fIss_flags\fP field contains
|
\fIss\fP is not NULL and the \fIss_flags\fP field contains
|
||||||
a nonzero value other than
|
a non-zero value other than
|
||||||
.BR SS_DISABLE .
|
.BR SS_DISABLE .
|
||||||
.TP
|
.TP
|
||||||
.B ENOMEM
|
.B ENOMEM
|
||||||
|
|
|
@ -260,7 +260,7 @@ file descriptor is not a valid file descriptor.
|
||||||
is not a valid signalfd file descriptor;
|
is not a valid signalfd file descriptor;
|
||||||
or,
|
or,
|
||||||
.I flags
|
.I flags
|
||||||
is nonzero.
|
is non-zero.
|
||||||
.\" Eventually glibc may support some flags
|
.\" Eventually glibc may support some flags
|
||||||
.\" or, the
|
.\" or, the
|
||||||
.\" .I sizemask
|
.\" .I sizemask
|
||||||
|
|
|
@ -86,9 +86,9 @@ was not found.
|
||||||
No search permission for one of the encountered "directories",
|
No search permission for one of the encountered "directories",
|
||||||
or no read permission where
|
or no read permission where
|
||||||
.I oldval
|
.I oldval
|
||||||
was nonzero, or no write permission where
|
was non-zero, or no write permission where
|
||||||
.I newval
|
.I newval
|
||||||
was nonzero.
|
was non-zero.
|
||||||
.SH "CONFORMING TO"
|
.SH "CONFORMING TO"
|
||||||
This call is Linux-specific, and should not be used in programs
|
This call is Linux-specific, and should not be used in programs
|
||||||
intended to be portable.
|
intended to be portable.
|
||||||
|
|
|
@ -115,14 +115,14 @@ specifies the initial expiration of the timer,
|
||||||
in seconds and nanoseconds.
|
in seconds and nanoseconds.
|
||||||
Setting either field of
|
Setting either field of
|
||||||
.I new_value.it_value
|
.I new_value.it_value
|
||||||
to a nonzero value arms the timer.
|
to a non-zero value arms the timer.
|
||||||
Setting both fields of
|
Setting both fields of
|
||||||
.I new_value.it_value
|
.I new_value.it_value
|
||||||
to zero disarms the timer.
|
to zero disarms the timer.
|
||||||
|
|
||||||
Setting one or both fields of
|
Setting one or both fields of
|
||||||
.I new_value.it_interval
|
.I new_value.it_interval
|
||||||
to nonzero values specifies the period, in seconds and nanoseconds,
|
to non-zero values specifies the period, in seconds and nanoseconds,
|
||||||
for repeated timer expirations after the initial expiration.
|
for repeated timer expirations after the initial expiration.
|
||||||
If both fields of
|
If both fields of
|
||||||
.I new_value.it_interval
|
.I new_value.it_interval
|
||||||
|
|
|
@ -346,7 +346,7 @@ is unspecified.
|
||||||
To distinguish this case from that where a child was in a
|
To distinguish this case from that where a child was in a
|
||||||
waitable state, zero out the
|
waitable state, zero out the
|
||||||
.I si_pid
|
.I si_pid
|
||||||
field before the call and check for a nonzero value in this field
|
field before the call and check for a non-zero value in this field
|
||||||
after the call returns.
|
after the call returns.
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
.BR wait ():
|
.BR wait ():
|
||||||
|
|
|
@ -56,7 +56,7 @@ These functions are glibc-specific.
|
||||||
An argz vector is a pointer to a character buffer together with a length.
|
An argz vector is a pointer to a character buffer together with a length.
|
||||||
The intended interpretation of the character buffer is an array
|
The intended interpretation of the character buffer is an array
|
||||||
of strings, where the strings are separated by null bytes ('\\0').
|
of strings, where the strings are separated by null bytes ('\\0').
|
||||||
If the length is nonzero, the last byte of the buffer must be a null byte.
|
If the length is non-zero, the last byte of the buffer must be a null byte.
|
||||||
.LP
|
.LP
|
||||||
These functions are for handling argz vectors.
|
These functions are for handling argz vectors.
|
||||||
The pair (NULL,0) is an argz vector, and, conversely,
|
The pair (NULL,0) is an argz vector, and, conversely,
|
||||||
|
|
|
@ -48,7 +48,7 @@ by calling
|
||||||
.BR abort (3)
|
.BR abort (3)
|
||||||
if
|
if
|
||||||
.I errnum
|
.I errnum
|
||||||
is nonzero.
|
is non-zero.
|
||||||
The message contains the filename, function name and
|
The message contains the filename, function name and
|
||||||
line number of the macro call, and the output of
|
line number of the macro call, and the output of
|
||||||
.IR strerror(errnum) .
|
.IR strerror(errnum) .
|
||||||
|
|
|
@ -64,7 +64,7 @@ all registrations are removed.
|
||||||
The
|
The
|
||||||
.BR atexit ()
|
.BR atexit ()
|
||||||
function returns the value 0 if successful; otherwise
|
function returns the value 0 if successful; otherwise
|
||||||
it returns a nonzero value.
|
it returns a non-zero value.
|
||||||
.SH "CONFORMING TO"
|
.SH "CONFORMING TO"
|
||||||
SVr4, 4.3BSD, C89, C99, POSIX.1-2001.
|
SVr4, 4.3BSD, C89, C99, POSIX.1-2001.
|
||||||
.SH NOTES
|
.SH NOTES
|
||||||
|
|
|
@ -141,7 +141,7 @@ Note the following:
|
||||||
Omission of the frame pointers (as
|
Omission of the frame pointers (as
|
||||||
implied by any of
|
implied by any of
|
||||||
.BR gcc (1)'s
|
.BR gcc (1)'s
|
||||||
nonzero optimization levels) may cause these assumptions to be
|
non-zero optimization levels) may cause these assumptions to be
|
||||||
violated.
|
violated.
|
||||||
.IP *
|
.IP *
|
||||||
Inlined functions do not have stack frames.
|
Inlined functions do not have stack frames.
|
||||||
|
|
|
@ -50,12 +50,12 @@ If they are equal, and in particular if
|
||||||
is zero,
|
is zero,
|
||||||
.BR bcmp ()
|
.BR bcmp ()
|
||||||
returns 0.
|
returns 0.
|
||||||
Otherwise it returns a nonzero result.
|
Otherwise it returns a non-zero result.
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
The
|
The
|
||||||
.BR bcmp ()
|
.BR bcmp ()
|
||||||
function returns 0 if the byte sequences are equal,
|
function returns 0 if the byte sequences are equal,
|
||||||
otherwise a nonzero result is returned.
|
otherwise a non-zero result is returned.
|
||||||
.SH "CONFORMING TO"
|
.SH "CONFORMING TO"
|
||||||
4.3BSD.
|
4.3BSD.
|
||||||
This function is deprecated (marked as LEGACY in POSIX.1-2001): use
|
This function is deprecated (marked as LEGACY in POSIX.1-2001): use
|
||||||
|
|
|
@ -48,10 +48,10 @@ to NULL.
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
The
|
The
|
||||||
.BR clearenv ()
|
.BR clearenv ()
|
||||||
function returns zero on success, and a nonzero
|
function returns zero on success, and a non-zero
|
||||||
value on failure.
|
value on failure.
|
||||||
.\" Most versions of Unix return -1 on error, or do not even have errors.
|
.\" Most versions of Unix return -1 on error, or do not even have errors.
|
||||||
.\" Glibc info and the Watcom C library document "a nonzero value".
|
.\" Glibc info and the Watcom C library document "a non-zero value".
|
||||||
.SH VERSIONS
|
.SH VERSIONS
|
||||||
Not in libc4, libc5.
|
Not in libc4, libc5.
|
||||||
In glibc since glibc 2.0.
|
In glibc since glibc 2.0.
|
||||||
|
|
|
@ -192,7 +192,7 @@ The function acts as if it called
|
||||||
and sets the external variables \fItzname\fP with
|
and sets the external variables \fItzname\fP with
|
||||||
information about the current time zone, \fItimezone\fP with the difference
|
information about the current time zone, \fItimezone\fP with the difference
|
||||||
between Coordinated Universal Time (UTC) and local standard time in
|
between Coordinated Universal Time (UTC) and local standard time in
|
||||||
seconds, and \fIdaylight\fP to a nonzero value if daylight savings
|
seconds, and \fIdaylight\fP to a non-zero value if daylight savings
|
||||||
time rules apply during some part of the year.
|
time rules apply during some part of the year.
|
||||||
The return value points to a statically allocated struct which might be
|
The return value points to a statically allocated struct which might be
|
||||||
overwritten by subsequent calls to any of the date and time functions.
|
overwritten by subsequent calls to any of the date and time functions.
|
||||||
|
|
|
@ -54,13 +54,13 @@ controlling terminal and run in the background as system daemons.
|
||||||
.PP
|
.PP
|
||||||
Unless the argument
|
Unless the argument
|
||||||
.I nochdir
|
.I nochdir
|
||||||
is nonzero,
|
is non-zero,
|
||||||
.BR daemon ()
|
.BR daemon ()
|
||||||
changes the current working directory to the root ("/").
|
changes the current working directory to the root ("/").
|
||||||
.PP
|
.PP
|
||||||
Unless the argument
|
Unless the argument
|
||||||
.I noclose
|
.I noclose
|
||||||
is nonzero,
|
is non-zero,
|
||||||
.BR daemon ()
|
.BR daemon ()
|
||||||
will redirect standard input, standard output and standard error
|
will redirect standard input, standard output and standard error
|
||||||
to \fI/dev/null\fP.
|
to \fI/dev/null\fP.
|
||||||
|
|
|
@ -49,7 +49,7 @@ application's shared objects and calls the function
|
||||||
once for each object,
|
once for each object,
|
||||||
until either all shared objects have been processed or
|
until either all shared objects have been processed or
|
||||||
.I callback
|
.I callback
|
||||||
returns a nonzero value.
|
returns a non-zero value.
|
||||||
|
|
||||||
Each call to
|
Each call to
|
||||||
.I callback
|
.I callback
|
||||||
|
|
|
@ -283,7 +283,7 @@ symbols in it, then the dynamic library is unloaded.
|
||||||
.LP
|
.LP
|
||||||
The function
|
The function
|
||||||
.BR dlclose ()
|
.BR dlclose ()
|
||||||
returns 0 on success, and nonzero on error.
|
returns 0 on success, and non-zero on error.
|
||||||
.SS "The obsolete symbols _init() and _fini()"
|
.SS "The obsolete symbols _init() and _fini()"
|
||||||
The linker recognizes special symbols
|
The linker recognizes special symbols
|
||||||
.B _init
|
.B _init
|
||||||
|
@ -357,7 +357,7 @@ typedef struct {
|
||||||
.in
|
.in
|
||||||
.sp
|
.sp
|
||||||
.BR dladdr ()
|
.BR dladdr ()
|
||||||
returns 0 on error, and nonzero on success.
|
returns 0 on error, and non-zero on success.
|
||||||
.PP
|
.PP
|
||||||
The function
|
The function
|
||||||
.BR dlvsym ()
|
.BR dlvsym ()
|
||||||
|
|
|
@ -55,7 +55,7 @@ string of \fIndigits\fP digits (where \fIndigits\fP is reduced to a
|
||||||
system-specific limit determined by the precision of a
|
system-specific limit determined by the precision of a
|
||||||
.IR double ),
|
.IR double ),
|
||||||
and returns a pointer to the string.
|
and returns a pointer to the string.
|
||||||
The high-order digit is nonzero, unless
|
The high-order digit is non-zero, unless
|
||||||
.I number
|
.I number
|
||||||
is zero.
|
is zero.
|
||||||
The low order digit is rounded.
|
The low order digit is rounded.
|
||||||
|
@ -65,7 +65,7 @@ is stored in \fI*decpt\fP.
|
||||||
A negative value for \fI*decpt\fP means that
|
A negative value for \fI*decpt\fP means that
|
||||||
the decimal point is to the left of the start of the string.
|
the decimal point is to the left of the start of the string.
|
||||||
If the sign of
|
If the sign of
|
||||||
\fInumber\fP is negative, \fI*sign\fP is set to a nonzero value,
|
\fInumber\fP is negative, \fI*sign\fP is set to a non-zero value,
|
||||||
otherwise it is set to 0.
|
otherwise it is set to 0.
|
||||||
If
|
If
|
||||||
.I number
|
.I number
|
||||||
|
|
|
@ -57,7 +57,7 @@ may be a macro.
|
||||||
\fIerrno\fP is thread-local; setting it in one thread
|
\fIerrno\fP is thread-local; setting it in one thread
|
||||||
does not affect its value in any other thread.
|
does not affect its value in any other thread.
|
||||||
|
|
||||||
Valid error numbers are all nonzero; \fIerrno\fP is never set to zero
|
Valid error numbers are all non-zero; \fIerrno\fP is never set to zero
|
||||||
by any library function.
|
by any library function.
|
||||||
All the error names specified by POSIX.1
|
All the error names specified by POSIX.1
|
||||||
must have distinct values, with the exception of
|
must have distinct values, with the exception of
|
||||||
|
|
|
@ -54,7 +54,7 @@ and then outputs to
|
||||||
the program name, a colon and a space, the message specified by the
|
the program name, a colon and a space, the message specified by the
|
||||||
.BR printf (3)-style
|
.BR printf (3)-style
|
||||||
format string \fIformat\fP, and, if \fIerrnum\fP is
|
format string \fIformat\fP, and, if \fIerrnum\fP is
|
||||||
nonzero, a second colon and a space followed by the string given by
|
non-zero, a second colon and a space followed by the string given by
|
||||||
\fBperror(\fIerrnum\fB)\fP.
|
\fBperror(\fIerrnum\fB)\fP.
|
||||||
Any arguments required for
|
Any arguments required for
|
||||||
.I format
|
.I format
|
||||||
|
@ -74,7 +74,7 @@ initially has the same value as
|
||||||
The value of this variable can be modified to change the output of
|
The value of this variable can be modified to change the output of
|
||||||
.BR error ().
|
.BR error ().
|
||||||
|
|
||||||
If \fIstatus\fP has a nonzero value, then
|
If \fIstatus\fP has a non-zero value, then
|
||||||
.BR error ()
|
.BR error ()
|
||||||
calls
|
calls
|
||||||
.BR exit (3)
|
.BR exit (3)
|
||||||
|
@ -100,7 +100,7 @@ The preprocessor values \fB__LINE__\fP and
|
||||||
but other values can also be used.
|
but other values can also be used.
|
||||||
For example, these arguments could refer to a location in an input file.
|
For example, these arguments could refer to a location in an input file.
|
||||||
|
|
||||||
If the global variable \fIerror_one_per_line\fP is set nonzero,
|
If the global variable \fIerror_one_per_line\fP is set non-zero,
|
||||||
a sequence of
|
a sequence of
|
||||||
.BR error_at_line ()
|
.BR error_at_line ()
|
||||||
calls with the
|
calls with the
|
||||||
|
|
|
@ -77,14 +77,14 @@ The
|
||||||
function maps an Ethernet address to the
|
function maps an Ethernet address to the
|
||||||
corresponding hostname in
|
corresponding hostname in
|
||||||
.I /etc/ethers
|
.I /etc/ethers
|
||||||
and returns nonzero if it cannot be found.
|
and returns non-zero if it cannot be found.
|
||||||
.PP
|
.PP
|
||||||
The
|
The
|
||||||
.BR ether_hostton ()
|
.BR ether_hostton ()
|
||||||
function maps a hostname to the
|
function maps a hostname to the
|
||||||
corresponding Ethernet address in
|
corresponding Ethernet address in
|
||||||
.I /etc/ethers
|
.I /etc/ethers
|
||||||
and returns nonzero if it cannot be found.
|
and returns non-zero if it cannot be found.
|
||||||
.PP
|
.PP
|
||||||
The
|
The
|
||||||
.BR ether_line ()
|
.BR ether_line ()
|
||||||
|
@ -92,7 +92,7 @@ function parses a line in
|
||||||
.I /etc/ethers
|
.I /etc/ethers
|
||||||
format (ethernet address followed by whitespace followed by
|
format (ethernet address followed by whitespace followed by
|
||||||
hostname; '#' introduces a comment) and returns an address
|
hostname; '#' introduces a comment) and returns an address
|
||||||
and hostname pair, or nonzero if it cannot be parsed.
|
and hostname pair, or non-zero if it cannot be parsed.
|
||||||
The buffer pointed to by
|
The buffer pointed to by
|
||||||
.I hostname
|
.I hostname
|
||||||
must be sufficiently long, for example, have the same length as
|
must be sufficiently long, for example, have the same length as
|
||||||
|
|
|
@ -100,7 +100,7 @@ The use of
|
||||||
and
|
and
|
||||||
.B EXIT_FAILURE
|
.B EXIT_FAILURE
|
||||||
is slightly more portable
|
is slightly more portable
|
||||||
(to non-Unix environments) than the use of 0 and some nonzero value
|
(to non-Unix environments) than the use of 0 and some non-zero value
|
||||||
like 1 or \-1.
|
like 1 or \-1.
|
||||||
In particular, VMS uses a different convention.
|
In particular, VMS uses a different convention.
|
||||||
.LP
|
.LP
|
||||||
|
|
|
@ -206,7 +206,7 @@ As before, the object
|
||||||
.I *envp
|
.I *envp
|
||||||
must be known to be valid.
|
must be known to be valid.
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
These functions return zero on success and nonzero if an error occurred.
|
These functions return zero on success and non-zero if an error occurred.
|
||||||
.\" Earlier seven of these functions were listed as returning void.
|
.\" Earlier seven of these functions were listed as returning void.
|
||||||
.\" This was corrected in Corrigendum 1 (ISO/IEC 9899:1999/Cor.1:2001(E))
|
.\" This was corrected in Corrigendum 1 (ISO/IEC 9899:1999/Cor.1:2001(E))
|
||||||
.\" of the C99 Standard.
|
.\" of the C99 Standard.
|
||||||
|
|
|
@ -70,7 +70,7 @@ The function
|
||||||
.BR feof ()
|
.BR feof ()
|
||||||
tests the end-of-file indicator for the stream pointed to by
|
tests the end-of-file indicator for the stream pointed to by
|
||||||
.IR stream ,
|
.IR stream ,
|
||||||
returning nonzero if it is set.
|
returning non-zero if it is set.
|
||||||
The end-of-file indicator can only be
|
The end-of-file indicator can only be
|
||||||
cleared by the function
|
cleared by the function
|
||||||
.BR clearerr ().
|
.BR clearerr ().
|
||||||
|
@ -79,7 +79,7 @@ The function
|
||||||
.BR ferror ()
|
.BR ferror ()
|
||||||
tests the error indicator for the stream pointed to by
|
tests the error indicator for the stream pointed to by
|
||||||
.IR stream ,
|
.IR stream ,
|
||||||
returning nonzero if it is set.
|
returning non-zero if it is set.
|
||||||
The error indicator can only be reset by the
|
The error indicator can only be reset by the
|
||||||
.BR clearerr ()
|
.BR clearerr ()
|
||||||
function.
|
function.
|
||||||
|
|
|
@ -71,12 +71,12 @@ _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
The
|
The
|
||||||
.BR finite ()
|
.BR finite ()
|
||||||
functions return a nonzero value if \fIx\fP is neither infinite
|
functions return a non-zero value if \fIx\fP is neither infinite
|
||||||
nor a "not-a-number" (NaN) value, and 0 otherwise.
|
nor a "not-a-number" (NaN) value, and 0 otherwise.
|
||||||
|
|
||||||
The
|
The
|
||||||
.BR isnan ()
|
.BR isnan ()
|
||||||
functions return a nonzero value if \fIx\fP is a NaN value,
|
functions return a non-zero value if \fIx\fP is a NaN value,
|
||||||
and 0 otherwise.
|
and 0 otherwise.
|
||||||
|
|
||||||
The
|
The
|
||||||
|
|
|
@ -48,7 +48,7 @@ The stdio functions are thread-safe.
|
||||||
This is achieved by assigning
|
This is achieved by assigning
|
||||||
to each
|
to each
|
||||||
.I FILE
|
.I FILE
|
||||||
object a lockcount and (if the lockcount is nonzero)
|
object a lockcount and (if the lockcount is non-zero)
|
||||||
an owning thread.
|
an owning thread.
|
||||||
For each library call, these functions wait until the
|
For each library call, these functions wait until the
|
||||||
.I FILE
|
.I FILE
|
||||||
|
@ -110,7 +110,7 @@ the lockcount otherwise.
|
||||||
The
|
The
|
||||||
.BR ftrylockfile ()
|
.BR ftrylockfile ()
|
||||||
function returns zero for success
|
function returns zero for success
|
||||||
(the lock was obtained), and nonzero for failure.
|
(the lock was obtained), and non-zero for failure.
|
||||||
.SH ERRORS
|
.SH ERRORS
|
||||||
None.
|
None.
|
||||||
.SH "CONFORMING TO"
|
.SH "CONFORMING TO"
|
||||||
|
|
|
@ -89,7 +89,7 @@ Zero if
|
||||||
matches
|
matches
|
||||||
.IR pattern ,
|
.IR pattern ,
|
||||||
.B FNM_NOMATCH
|
.B FNM_NOMATCH
|
||||||
if there is no match or another nonzero value if there is an error.
|
if there is no match or another non-zero value if there is an error.
|
||||||
.SH "CONFORMING TO"
|
.SH "CONFORMING TO"
|
||||||
POSIX.2.
|
POSIX.2.
|
||||||
The
|
The
|
||||||
|
|
|
@ -115,7 +115,7 @@ The corresponding macro is
|
||||||
.BR _POSIX_PIPE_BUF .
|
.BR _POSIX_PIPE_BUF .
|
||||||
.TP
|
.TP
|
||||||
.B _PC_CHOWN_RESTRICTED
|
.B _PC_CHOWN_RESTRICTED
|
||||||
returns nonzero if the
|
returns non-zero if the
|
||||||
.BR chown (2)
|
.BR chown (2)
|
||||||
call may not be used on this file.
|
call may not be used on this file.
|
||||||
If
|
If
|
||||||
|
@ -128,14 +128,14 @@ The corresponding macro is
|
||||||
.BR _POSIX_CHOWN_RESTRICTED .
|
.BR _POSIX_CHOWN_RESTRICTED .
|
||||||
.TP
|
.TP
|
||||||
.B _PC_NO_TRUNC
|
.B _PC_NO_TRUNC
|
||||||
returns nonzero if accessing filenames longer than
|
returns non-zero if accessing filenames longer than
|
||||||
.B _POSIX_NAME_MAX
|
.B _POSIX_NAME_MAX
|
||||||
generates an error.
|
generates an error.
|
||||||
The corresponding macro is
|
The corresponding macro is
|
||||||
.BR _POSIX_NO_TRUNC .
|
.BR _POSIX_NO_TRUNC .
|
||||||
.TP
|
.TP
|
||||||
.B _PC_VDISABLE
|
.B _PC_VDISABLE
|
||||||
returns nonzero if special character processing can be disabled, where
|
returns non-zero if special character processing can be disabled, where
|
||||||
.I fd
|
.I fd
|
||||||
or
|
or
|
||||||
.I path
|
.I path
|
||||||
|
|
|
@ -80,16 +80,16 @@ normal floating-point number.
|
||||||
The other macros provide a short answer to some standard questions.
|
The other macros provide a short answer to some standard questions.
|
||||||
.TP
|
.TP
|
||||||
.BI isfinite( x )
|
.BI isfinite( x )
|
||||||
returns a nonzero value if
|
returns a non-zero value if
|
||||||
.br
|
.br
|
||||||
(fpclassify(x) != FP_NAN && fpclassify(x) != FP_INFINITE)
|
(fpclassify(x) != FP_NAN && fpclassify(x) != FP_INFINITE)
|
||||||
.TP
|
.TP
|
||||||
.BI isnormal( x )
|
.BI isnormal( x )
|
||||||
returns a nonzero value if
|
returns a non-zero value if
|
||||||
(fpclassify(x) == FP_NORMAL)
|
(fpclassify(x) == FP_NORMAL)
|
||||||
.TP
|
.TP
|
||||||
.BI isnan( x )
|
.BI isnan( x )
|
||||||
returns a nonzero value if
|
returns a non-zero value if
|
||||||
(fpclassify(x) == FP_NAN)
|
(fpclassify(x) == FP_NAN)
|
||||||
.TP
|
.TP
|
||||||
.BI isinf( x )
|
.BI isinf( x )
|
||||||
|
@ -103,7 +103,7 @@ C99
|
||||||
.SH NOTES
|
.SH NOTES
|
||||||
In glibc 2.01 and earlier,
|
In glibc 2.01 and earlier,
|
||||||
.BR isinf ()
|
.BR isinf ()
|
||||||
returns a nonzero value (actually: 1) if
|
returns a non-zero value (actually: 1) if
|
||||||
.I x
|
.I x
|
||||||
is an infinity (positive or negative).
|
is an infinity (positive or negative).
|
||||||
(This is all that C99 requires.)
|
(This is all that C99 requires.)
|
||||||
|
|
|
@ -54,7 +54,7 @@ Here \fItime\fP is the number of seconds since the Epoch,
|
||||||
\fImillitm\fP is the number of milliseconds since \fItime\fP
|
\fImillitm\fP is the number of milliseconds since \fItime\fP
|
||||||
seconds since the Epoch, \fItimezone\fP is the local time zone
|
seconds since the Epoch, \fItimezone\fP is the local time zone
|
||||||
measured in minutes of time west of Greenwich, and \fIdstflag\fP
|
measured in minutes of time west of Greenwich, and \fIdstflag\fP
|
||||||
is a flag that, if nonzero, indicates that Daylight Saving time
|
is a flag that, if non-zero, indicates that Daylight Saving time
|
||||||
applies locally during the appropriate part of the year.
|
applies locally during the appropriate part of the year.
|
||||||
.LP
|
.LP
|
||||||
These days the contents of the \fItimezone\fP and \fIdstflag\fP
|
These days the contents of the \fItimezone\fP and \fIdstflag\fP
|
||||||
|
|
|
@ -44,7 +44,7 @@ function uses the identity of the file named by the given
|
||||||
(which must refer to an existing, accessible file)
|
(which must refer to an existing, accessible file)
|
||||||
and the least significant 8 bits of
|
and the least significant 8 bits of
|
||||||
.I proj_id
|
.I proj_id
|
||||||
(which must be nonzero) to generate a
|
(which must be non-zero) to generate a
|
||||||
.I key_t
|
.I key_t
|
||||||
type System V IPC key, suitable for use with
|
type System V IPC key, suitable for use with
|
||||||
.BR msgget (2),
|
.BR msgget (2),
|
||||||
|
|
|
@ -121,7 +121,7 @@ that it is undefined whether \fBFTW_NS\fP or \fBFTW_SL\fP (see below)
|
||||||
is passed in
|
is passed in
|
||||||
.IR typeflag .
|
.IR typeflag .
|
||||||
.PP
|
.PP
|
||||||
To stop the tree walk, \fIfn\fP() returns a nonzero value; this
|
To stop the tree walk, \fIfn\fP() returns a non-zero value; this
|
||||||
value will become the return value of
|
value will become the return value of
|
||||||
.BR ftw ().
|
.BR ftw ().
|
||||||
As long as \fIfn\fP() returns 0,
|
As long as \fIfn\fP() returns 0,
|
||||||
|
@ -135,7 +135,7 @@ failure), in which case it will return \-1.
|
||||||
Because
|
Because
|
||||||
.BR ftw ()
|
.BR ftw ()
|
||||||
uses dynamic data structures, the only safe way to
|
uses dynamic data structures, the only safe way to
|
||||||
exit out of a tree walk is to return a nonzero value from \fIfn\fP().
|
exit out of a tree walk is to return a non-zero value from \fIfn\fP().
|
||||||
To allow a signal to terminate the walk without causing a memory leak,
|
To allow a signal to terminate the walk without causing a memory leak,
|
||||||
have the handler set a global flag that is checked by \fIfn\fP().
|
have the handler set a global flag that is checked by \fIfn\fP().
|
||||||
\fIDon't\fP use
|
\fIDon't\fP use
|
||||||
|
@ -290,7 +290,7 @@ which has depth 0).
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
These functions return 0 on success, and \-1 if an error occurs.
|
These functions return 0 on success, and \-1 if an error occurs.
|
||||||
|
|
||||||
If \fIfn\fP() returns nonzero,
|
If \fIfn\fP() returns non-zero,
|
||||||
then the tree walk is terminated and the value returned by \fIfn\fP()
|
then the tree walk is terminated and the value returned by \fIfn\fP()
|
||||||
is returned as the result of
|
is returned as the result of
|
||||||
.BR ftw ()
|
.BR ftw ()
|
||||||
|
@ -300,7 +300,7 @@ or
|
||||||
If
|
If
|
||||||
.BR nftw ()
|
.BR nftw ()
|
||||||
is called with the \fBFTW_ACTIONRETVAL\fP flag,
|
is called with the \fBFTW_ACTIONRETVAL\fP flag,
|
||||||
then the only nonzero value that should be used by \fIfn\fP()
|
then the only non-zero value that should be used by \fIfn\fP()
|
||||||
to terminate the tree walk is \fBFTW_STOP\fP,
|
to terminate the tree walk is \fBFTW_STOP\fP,
|
||||||
and that value is returned as the result of
|
and that value is returned as the result of
|
||||||
.BR nftw ().
|
.BR nftw ().
|
||||||
|
|
|
@ -48,7 +48,7 @@ operation).
|
||||||
Once a stream has an orientation, it cannot be changed and persists until
|
Once a stream has an orientation, it cannot be changed and persists until
|
||||||
the stream is closed.
|
the stream is closed.
|
||||||
.PP
|
.PP
|
||||||
When \fImode\fP is nonzero, the
|
When \fImode\fP is non-zero, the
|
||||||
.BR fwide ()
|
.BR fwide ()
|
||||||
function first attempts to set
|
function first attempts to set
|
||||||
\fIstream\fP's orientation (to wide-character oriented if \fImode\fP > 0, or
|
\fIstream\fP's orientation (to wide-character oriented if \fImode\fP > 0, or
|
||||||
|
|
|
@ -371,7 +371,7 @@ flags respectively to be used in the IDNA handling.
|
||||||
.\" #define EAI_IDN_ENCODE -105 /* IDN encoding failed. */
|
.\" #define EAI_IDN_ENCODE -105 /* IDN encoding failed. */
|
||||||
.\" #endif
|
.\" #endif
|
||||||
.BR getaddrinfo ()
|
.BR getaddrinfo ()
|
||||||
returns 0 if it succeeds, or one of the following nonzero error codes:
|
returns 0 if it succeeds, or one of the following non-zero error codes:
|
||||||
.TP
|
.TP
|
||||||
.B EAI_ADDRFAMILY
|
.B EAI_ADDRFAMILY
|
||||||
The specified network host does not have any network addresses in the
|
The specified network host does not have any network addresses in the
|
||||||
|
|
|
@ -150,7 +150,7 @@ thread-safe variant.
|
||||||
The functionality is the same.
|
The functionality is the same.
|
||||||
The result is returned in the buffer pointed to by
|
The result is returned in the buffer pointed to by
|
||||||
.I res
|
.I res
|
||||||
and in case of an error the return value is nonzero with the same
|
and in case of an error the return value is non-zero with the same
|
||||||
values as given above for
|
values as given above for
|
||||||
.IR getdate_err .
|
.IR getdate_err .
|
||||||
.LP
|
.LP
|
||||||
|
|
|
@ -374,7 +374,7 @@ will point to the result on success. In case of an error
|
||||||
or if no entry is found
|
or if no entry is found
|
||||||
.I result
|
.I result
|
||||||
will be NULL.
|
will be NULL.
|
||||||
The functions return 0 on success and a nonzero error number on failure.
|
The functions return 0 on success and a non-zero error number on failure.
|
||||||
In addition to the errors returned by the non-reentrant
|
In addition to the errors returned by the non-reentrant
|
||||||
versions of these functions, if
|
versions of these functions, if
|
||||||
.I buf
|
.I buf
|
||||||
|
|
|
@ -97,7 +97,7 @@ precisely because the user can set \fBLOGNAME\fP arbitrarily.
|
||||||
returns a pointer to the user name when successful,
|
returns a pointer to the user name when successful,
|
||||||
and NULL on failure.
|
and NULL on failure.
|
||||||
.BR getlogin_r ()
|
.BR getlogin_r ()
|
||||||
returns 0 when successful, and nonzero on failure.
|
returns 0 when successful, and non-zero on failure.
|
||||||
.SH ERRORS
|
.SH ERRORS
|
||||||
POSIX specifies
|
POSIX specifies
|
||||||
.TP
|
.TP
|
||||||
|
|
|
@ -126,7 +126,7 @@ flags respectively to be used in the IDNA handling.
|
||||||
On success 0 is returned, and node and service names, if requested,
|
On success 0 is returned, and node and service names, if requested,
|
||||||
are filled with null-terminated strings, possibly truncated to fit
|
are filled with null-terminated strings, possibly truncated to fit
|
||||||
the specified buffer lengths.
|
the specified buffer lengths.
|
||||||
On error one of the following nonzero error codes is returned:
|
On error one of the following non-zero error codes is returned:
|
||||||
.TP
|
.TP
|
||||||
.B EAI_AGAIN
|
.B EAI_AGAIN
|
||||||
The name could not be resolved at this time.
|
The name could not be resolved at this time.
|
||||||
|
|
|
@ -167,7 +167,7 @@ returns ':' instead of '?' to
|
||||||
indicate a missing option argument.
|
indicate a missing option argument.
|
||||||
If an error was detected, and
|
If an error was detected, and
|
||||||
the first character of \fIoptstring\fP is not a colon, and
|
the first character of \fIoptstring\fP is not a colon, and
|
||||||
the external variable \fIopterr\fP is nonzero (which is the default),
|
the external variable \fIopterr\fP is non-zero (which is the default),
|
||||||
.BR getopt ()
|
.BR getopt ()
|
||||||
prints an error message.
|
prints an error message.
|
||||||
.PP
|
.PP
|
||||||
|
|
|
@ -60,7 +60,7 @@ reads the next line of the file, opening the file if necessary.
|
||||||
opens and rewinds the file.
|
opens and rewinds the file.
|
||||||
If the
|
If the
|
||||||
.I stayopen
|
.I stayopen
|
||||||
flag is nonzero,
|
flag is non-zero,
|
||||||
the net data base will not be closed after each call to
|
the net data base will not be closed after each call to
|
||||||
.BR getrpcent ()
|
.BR getrpcent ()
|
||||||
(either directly, or indirectly through one of
|
(either directly, or indirectly through one of
|
||||||
|
|
|
@ -226,7 +226,7 @@ or
|
||||||
.BR stat (2).
|
.BR stat (2).
|
||||||
If
|
If
|
||||||
.I errfunc
|
.I errfunc
|
||||||
returns nonzero, or if
|
returns non-zero, or if
|
||||||
.B GLOB_ERR
|
.B GLOB_ERR
|
||||||
is set,
|
is set,
|
||||||
.BR glob ()
|
.BR glob ()
|
||||||
|
|
|
@ -118,7 +118,7 @@ must be zeroed before the first call to
|
||||||
and
|
and
|
||||||
.BR hcreate_r ()
|
.BR hcreate_r ()
|
||||||
return 0 when allocation of the memory
|
return 0 when allocation of the memory
|
||||||
for the hash table fails, nonzero otherwise.
|
for the hash table fails, non-zero otherwise.
|
||||||
.LP
|
.LP
|
||||||
.BR hsearch ()
|
.BR hsearch ()
|
||||||
returns NULL if \fIaction\fP is \fBENTER\fP and
|
returns NULL if \fIaction\fP is \fBENTER\fP and
|
||||||
|
@ -127,7 +127,7 @@ cannot be found in the hash table.
|
||||||
.LP
|
.LP
|
||||||
.BR hsearch_r ()
|
.BR hsearch_r ()
|
||||||
returns 0 if \fIaction\fP is \fBENTER\fP and
|
returns 0 if \fIaction\fP is \fBENTER\fP and
|
||||||
the hash table is full, and nonzero otherwise.
|
the hash table is full, and non-zero otherwise.
|
||||||
.SH ERRORS
|
.SH ERRORS
|
||||||
POSIX documents
|
POSIX documents
|
||||||
.TP
|
.TP
|
||||||
|
|
|
@ -56,19 +56,19 @@ to zero and call
|
||||||
before calling these functions.
|
before calling these functions.
|
||||||
On return, if
|
On return, if
|
||||||
.I errno
|
.I errno
|
||||||
is nonzero or
|
is non-zero or
|
||||||
.I fetestexcept(FE_INVALID | FE_DIVBYZERO | FE_OVERFLOW | FE_UNDERFLOW)
|
.I fetestexcept(FE_INVALID | FE_DIVBYZERO | FE_OVERFLOW | FE_UNDERFLOW)
|
||||||
is nonzero, an error has occurred.
|
is non-zero, an error has occurred.
|
||||||
.LP
|
.LP
|
||||||
If an error occurs and
|
If an error occurs and
|
||||||
.I "(math_errhandling & MATH_ERRNO)"
|
.I "(math_errhandling & MATH_ERRNO)"
|
||||||
is nonzero, then
|
is non-zero, then
|
||||||
.I errno
|
.I errno
|
||||||
is set to
|
is set to
|
||||||
.BR EDOM .
|
.BR EDOM .
|
||||||
If an error occurs and
|
If an error occurs and
|
||||||
.I "(math_errhandling & MATH_ERREXCEPT)"
|
.I "(math_errhandling & MATH_ERREXCEPT)"
|
||||||
is nonzero, then the invalid floating-point exception is raised.
|
is non-zero, then the invalid floating-point exception is raised.
|
||||||
.LP
|
.LP
|
||||||
A domain error occurs when
|
A domain error occurs when
|
||||||
.I x
|
.I x
|
||||||
|
|
|
@ -72,7 +72,7 @@ standard numbers-and-dots notation into binary data and stores it in
|
||||||
the structure that \fIinp\fP points to.
|
the structure that \fIinp\fP points to.
|
||||||
.BR inet_aton ()
|
.BR inet_aton ()
|
||||||
returns
|
returns
|
||||||
nonzero if the address is valid, zero if not.
|
non-zero if the address is valid, zero if not.
|
||||||
.PP
|
.PP
|
||||||
The
|
The
|
||||||
.BR inet_addr ()
|
.BR inet_addr ()
|
||||||
|
|
|
@ -150,7 +150,7 @@ checks for a hexadecimal digits, that is, one of
|
||||||
.br
|
.br
|
||||||
.BR "0 1 2 3 4 5 6 7 8 9 a b c d e f A B C D E F" .
|
.BR "0 1 2 3 4 5 6 7 8 9 a b c d e f A B C D E F" .
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
The values returned are nonzero if the character
|
The values returned are non-zero if the character
|
||||||
.I c
|
.I c
|
||||||
falls into the tested class, and a zero value
|
falls into the tested class, and a zero value
|
||||||
if not.
|
if not.
|
||||||
|
|
|
@ -53,7 +53,7 @@ to 'Z', 'a' to 'z' and the digits '0' to '9'.
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
The
|
The
|
||||||
.BR iswalnum ()
|
.BR iswalnum ()
|
||||||
function returns nonzero
|
function returns non-zero
|
||||||
if \fIwc\fP is a wide character
|
if \fIwc\fP is a wide character
|
||||||
belonging to the wide-character class "alnum".
|
belonging to the wide-character class "alnum".
|
||||||
Otherwise it returns zero.
|
Otherwise it returns zero.
|
||||||
|
|
|
@ -57,7 +57,7 @@ to 'Z' and 'a' to 'z'.
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
The
|
The
|
||||||
.BR iswalpha ()
|
.BR iswalpha ()
|
||||||
function returns nonzero
|
function returns non-zero
|
||||||
if \fIwc\fP is a wide character
|
if \fIwc\fP is a wide character
|
||||||
belonging to the wide-character class "alpha".
|
belonging to the wide-character class "alpha".
|
||||||
Otherwise it returns zero.
|
Otherwise it returns zero.
|
||||||
|
|
|
@ -55,7 +55,7 @@ and the control character '\\t'.
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
The
|
The
|
||||||
.BR iswblank ()
|
.BR iswblank ()
|
||||||
function returns nonzero
|
function returns non-zero
|
||||||
if \fIwc\fP is a wide character
|
if \fIwc\fP is a wide character
|
||||||
belonging to the wide-character class "blank".
|
belonging to the wide-character class "blank".
|
||||||
Otherwise it returns zero.
|
Otherwise it returns zero.
|
||||||
|
|
|
@ -39,7 +39,7 @@ but not vice versa.
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
The
|
The
|
||||||
.BR iswcntrl ()
|
.BR iswcntrl ()
|
||||||
function returns nonzero if \fIwc\fP is a
|
function returns non-zero if \fIwc\fP is a
|
||||||
wide character belonging to the wide-character class "cntrl".
|
wide character belonging to the wide-character class "cntrl".
|
||||||
Otherwise it returns zero.
|
Otherwise it returns zero.
|
||||||
.SH "CONFORMING TO"
|
.SH "CONFORMING TO"
|
||||||
|
|
|
@ -25,7 +25,7 @@ If \fIwc\fP is a wide character having the character property designated by
|
||||||
\fIdesc\fP (or in other words: belongs to the character class designated by
|
\fIdesc\fP (or in other words: belongs to the character class designated by
|
||||||
\fIdesc\fP), the
|
\fIdesc\fP), the
|
||||||
.BR iswctype ()
|
.BR iswctype ()
|
||||||
function returns nonzero.
|
function returns non-zero.
|
||||||
Otherwise it
|
Otherwise it
|
||||||
returns zero.
|
returns zero.
|
||||||
If \fIwc\fP is
|
If \fIwc\fP is
|
||||||
|
@ -38,7 +38,7 @@ function.
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
The
|
The
|
||||||
.BR iswctype ()
|
.BR iswctype ()
|
||||||
function returns nonzero if
|
function returns non-zero if
|
||||||
the \fIwc\fP has the designated
|
the \fIwc\fP has the designated
|
||||||
property.
|
property.
|
||||||
Otherwise it returns 0.
|
Otherwise it returns 0.
|
||||||
|
|
|
@ -56,7 +56,7 @@ contains exactly the digits '0' to '9'.
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
The
|
The
|
||||||
.BR iswdigit ()
|
.BR iswdigit ()
|
||||||
function returns nonzero
|
function returns non-zero
|
||||||
if \fIwc\fP is a wide character
|
if \fIwc\fP is a wide character
|
||||||
belonging to the wide-character class "digit".
|
belonging to the wide-character class "digit".
|
||||||
Otherwise it returns zero.
|
Otherwise it returns zero.
|
||||||
|
|
|
@ -49,7 +49,7 @@ the wide-character classes "alnum" and "punct".
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
The
|
The
|
||||||
.BR iswgraph ()
|
.BR iswgraph ()
|
||||||
function returns nonzero
|
function returns non-zero
|
||||||
if \fIwc\fP is a wide character
|
if \fIwc\fP is a wide character
|
||||||
belonging to the wide-character class "graph".
|
belonging to the wide-character class "graph".
|
||||||
Otherwise it returns zero.
|
Otherwise it returns zero.
|
||||||
|
|
|
@ -61,7 +61,7 @@ to 'z'.
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
The
|
The
|
||||||
.BR iswlower ()
|
.BR iswlower ()
|
||||||
function returns nonzero
|
function returns non-zero
|
||||||
if \fIwc\fP is a wide character
|
if \fIwc\fP is a wide character
|
||||||
belonging to the wide-character class "lower".
|
belonging to the wide-character class "lower".
|
||||||
Otherwise it returns zero.
|
Otherwise it returns zero.
|
||||||
|
|
|
@ -36,7 +36,7 @@ The wide-character class "print" contains the wide-character class "graph".
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
The
|
The
|
||||||
.BR iswprint ()
|
.BR iswprint ()
|
||||||
function returns nonzero if \fIwc\fP is a
|
function returns non-zero if \fIwc\fP is a
|
||||||
wide character belonging to the wide-character class "print".
|
wide character belonging to the wide-character class "print".
|
||||||
Otherwise it returns zero.
|
Otherwise it returns zero.
|
||||||
.SH "CONFORMING TO"
|
.SH "CONFORMING TO"
|
||||||
|
|
|
@ -47,7 +47,7 @@ the wide-character class
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
The
|
The
|
||||||
.BR iswpunct ()
|
.BR iswpunct ()
|
||||||
function returns nonzero
|
function returns non-zero
|
||||||
if \fIwc\fP is a wide-character
|
if \fIwc\fP is a wide-character
|
||||||
belonging to the wide-character class "punct".
|
belonging to the wide-character class "punct".
|
||||||
Otherwise it returns zero.
|
Otherwise it returns zero.
|
||||||
|
|
|
@ -43,7 +43,7 @@ and the control characters '\\f', '\\n', '\\r', '\\t', '\\v'.
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
The
|
The
|
||||||
.BR iswspace ()
|
.BR iswspace ()
|
||||||
function returns nonzero if \fIwc\fP is a wide character
|
function returns non-zero if \fIwc\fP is a wide character
|
||||||
belonging to the wide-character class "space".
|
belonging to the wide-character class "space".
|
||||||
Otherwise it returns zero.
|
Otherwise it returns zero.
|
||||||
.SH "CONFORMING TO"
|
.SH "CONFORMING TO"
|
||||||
|
|
|
@ -54,7 +54,7 @@ to 'Z'.
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
The
|
The
|
||||||
.BR iswupper ()
|
.BR iswupper ()
|
||||||
function returns nonzero if \fIwc\fP is a wide character
|
function returns non-zero if \fIwc\fP is a wide character
|
||||||
belonging to the wide-character class "upper".
|
belonging to the wide-character class "upper".
|
||||||
Otherwise it returns zero.
|
Otherwise it returns zero.
|
||||||
.SH "CONFORMING TO"
|
.SH "CONFORMING TO"
|
||||||
|
|
|
@ -48,7 +48,7 @@ to 'F', 'a' to 'f' and the digits '0' to '9'.
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
The
|
The
|
||||||
.BR iswxdigit ()
|
.BR iswxdigit ()
|
||||||
function returns nonzero if \fIwc\fP is a wide character
|
function returns non-zero if \fIwc\fP is a wide character
|
||||||
belonging to the wide-character class "xdigit".
|
belonging to the wide-character class "xdigit".
|
||||||
Otherwise it returns zero.
|
Otherwise it returns zero.
|
||||||
.SH "CONFORMING TO"
|
.SH "CONFORMING TO"
|
||||||
|
|
|
@ -92,9 +92,9 @@ to zero and call
|
||||||
before calling these functions.
|
before calling these functions.
|
||||||
On return, if
|
On return, if
|
||||||
.I errno
|
.I errno
|
||||||
is nonzero or
|
is non-zero or
|
||||||
.I fetestexcept(FE_INVALID | FE_DIVBYZERO | FE_OVERFLOW | FE_UNDERFLOW)
|
.I fetestexcept(FE_INVALID | FE_DIVBYZERO | FE_OVERFLOW | FE_UNDERFLOW)
|
||||||
is nonzero, an error has occurred.
|
is non-zero, an error has occurred.
|
||||||
.LP
|
.LP
|
||||||
A range error occurs if
|
A range error occurs if
|
||||||
.I x
|
.I x
|
||||||
|
|
|
@ -88,18 +88,18 @@ to zero and call
|
||||||
before calling these functions.
|
before calling these functions.
|
||||||
On return, if
|
On return, if
|
||||||
.I errno
|
.I errno
|
||||||
is nonzero or
|
is non-zero or
|
||||||
.I fetestexcept(FE_INVALID | FE_DIVBYZERO | FE_OVERFLOW | FE_UNDERFLOW)
|
.I fetestexcept(FE_INVALID | FE_DIVBYZERO | FE_OVERFLOW | FE_UNDERFLOW)
|
||||||
is nonzero, an error has occurred.
|
is non-zero, an error has occurred.
|
||||||
.LP
|
.LP
|
||||||
If an error occurs and
|
If an error occurs and
|
||||||
.I "(math_errhandling & MATH_ERRNO)"
|
.I "(math_errhandling & MATH_ERRNO)"
|
||||||
is nonzero, then
|
is non-zero, then
|
||||||
.I errno is set to
|
.I errno is set to
|
||||||
.BR ERANGE .
|
.BR ERANGE .
|
||||||
If an error occurs and
|
If an error occurs and
|
||||||
.I "(math_errhandling & MATH_ERREXCEPT)"
|
.I "(math_errhandling & MATH_ERREXCEPT)"
|
||||||
is nonzero, then the divide-by-zero floating-point exception is raised.
|
is non-zero, then the divide-by-zero floating-point exception is raised.
|
||||||
.LP
|
.LP
|
||||||
A pole error occurs when
|
A pole error occurs when
|
||||||
.I x
|
.I x
|
||||||
|
|
|
@ -73,7 +73,7 @@ its \fIenv\fP argument.
|
||||||
If the
|
If the
|
||||||
.BR sigsetjmp (3)
|
.BR sigsetjmp (3)
|
||||||
call that set this
|
call that set this
|
||||||
\fIenv\fP used a nonzero \fIsavesigs\fP flag,
|
\fIenv\fP used a non-zero \fIsavesigs\fP flag,
|
||||||
.BR siglongjmp ()
|
.BR siglongjmp ()
|
||||||
also
|
also
|
||||||
restores the set of blocked signals.
|
restores the set of blocked signals.
|
||||||
|
|
|
@ -65,7 +65,7 @@ The rounded integer value.
|
||||||
.B EDOM
|
.B EDOM
|
||||||
The magnitude of \fIx\fP is too large and
|
The magnitude of \fIx\fP is too large and
|
||||||
.I "(math_errhandling & MATH_ERRNO)"
|
.I "(math_errhandling & MATH_ERRNO)"
|
||||||
is nonzero.
|
is non-zero.
|
||||||
.SH "CONFORMING TO"
|
.SH "CONFORMING TO"
|
||||||
C99.
|
C99.
|
||||||
.SH "SEE ALSO"
|
.SH "SEE ALSO"
|
||||||
|
|
|
@ -71,7 +71,7 @@ that of their arguments.
|
||||||
.B EDOM
|
.B EDOM
|
||||||
The magnitude of \fIx\fP is too large and
|
The magnitude of \fIx\fP is too large and
|
||||||
.I "(math_errhandling & MATH_ERRNO)"
|
.I "(math_errhandling & MATH_ERRNO)"
|
||||||
is nonzero.
|
is non-zero.
|
||||||
.SH "CONFORMING TO"
|
.SH "CONFORMING TO"
|
||||||
C99.
|
C99.
|
||||||
.SH "SEE ALSO"
|
.SH "SEE ALSO"
|
||||||
|
|
|
@ -46,7 +46,7 @@ The comparison function referenced by
|
||||||
\fIcompar\fP is expected to have two arguments which point to the
|
\fIcompar\fP is expected to have two arguments which point to the
|
||||||
\fIkey\fP object and to an array member, in that order, and which
|
\fIkey\fP object and to an array member, in that order, and which
|
||||||
returns zero if the \fIkey\fP object matches the array member, and
|
returns zero if the \fIkey\fP object matches the array member, and
|
||||||
nonzero otherwise.
|
non-zero otherwise.
|
||||||
.PP
|
.PP
|
||||||
If
|
If
|
||||||
.BR lsearch ()
|
.BR lsearch ()
|
||||||
|
|
|
@ -218,7 +218,7 @@ if set to 2,
|
||||||
is called immediately;
|
is called immediately;
|
||||||
if set to 3, a diagnostic message is printed on \fIstderr\fP
|
if set to 3, a diagnostic message is printed on \fIstderr\fP
|
||||||
and the program is aborted.
|
and the program is aborted.
|
||||||
Using a nonzero
|
Using a non-zero
|
||||||
.B MALLOC_CHECK_
|
.B MALLOC_CHECK_
|
||||||
value can be useful because otherwise
|
value can be useful because otherwise
|
||||||
a crash may happen much later, and the true cause for the problem
|
a crash may happen much later, and the true cause for the problem
|
||||||
|
|
|
@ -51,7 +51,7 @@ function
|
||||||
.\" The Dinkumware doc and the Single Unix specification say this, but
|
.\" The Dinkumware doc and the Single Unix specification say this, but
|
||||||
.\" glibc doesn't implement this.
|
.\" glibc doesn't implement this.
|
||||||
resets the shift state, only known to this function, to the initial state, and
|
resets the shift state, only known to this function, to the initial state, and
|
||||||
returns nonzero if the encoding has nontrivial shift state, or zero if the
|
returns non-zero if the encoding has nontrivial shift state, or zero if the
|
||||||
encoding is stateless.
|
encoding is stateless.
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
The
|
The
|
||||||
|
|
|
@ -68,7 +68,7 @@ tests whether \fI*ps\fP corresponds to an
|
||||||
initial state.
|
initial state.
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
.BR mbsinit ()
|
.BR mbsinit ()
|
||||||
returns nonzero if \fI*ps\fP is an initial state, or if
|
returns non-zero if \fI*ps\fP is an initial state, or if
|
||||||
\fIps\fP is a null pointer.
|
\fIps\fP is a null pointer.
|
||||||
Otherwise it returns 0.
|
Otherwise it returns 0.
|
||||||
.SH "CONFORMING TO"
|
.SH "CONFORMING TO"
|
||||||
|
|
|
@ -59,7 +59,7 @@ function
|
||||||
.\" glibc doesn't implement this.
|
.\" glibc doesn't implement this.
|
||||||
resets the shift state, only known to this function,
|
resets the shift state, only known to this function,
|
||||||
to the initial state, and
|
to the initial state, and
|
||||||
returns nonzero if the encoding has nontrivial shift state, or zero if the
|
returns non-zero if the encoding has nontrivial shift state, or zero if the
|
||||||
encoding is stateless.
|
encoding is stateless.
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
If \fIs\fP is not NULL, the
|
If \fIs\fP is not NULL, the
|
||||||
|
@ -71,7 +71,7 @@ or \-1 upon failure.
|
||||||
If \fIs\fP is NULL, the
|
If \fIs\fP is NULL, the
|
||||||
.BR mbtowc ()
|
.BR mbtowc ()
|
||||||
function
|
function
|
||||||
returns nonzero if the encoding
|
returns non-zero if the encoding
|
||||||
has nontrivial shift state, or zero if the encoding is stateless.
|
has nontrivial shift state, or zero if the encoding is stateless.
|
||||||
.SH "CONFORMING TO"
|
.SH "CONFORMING TO"
|
||||||
C99
|
C99
|
||||||
|
|
|
@ -58,7 +58,7 @@ and the \fIarg\fP argument from
|
||||||
The
|
The
|
||||||
.BR on_exit ()
|
.BR on_exit ()
|
||||||
function returns the value 0 if successful; otherwise
|
function returns the value 0 if successful; otherwise
|
||||||
it returns a nonzero value.
|
it returns a non-zero value.
|
||||||
.SH "CONFORMING TO"
|
.SH "CONFORMING TO"
|
||||||
This function comes from SunOS 4, but is also present in
|
This function comes from SunOS 4, but is also present in
|
||||||
libc4, libc5 and glibc.
|
libc4, libc5 and glibc.
|
||||||
|
|
|
@ -246,7 +246,7 @@ For
|
||||||
.B x
|
.B x
|
||||||
and
|
and
|
||||||
.B X
|
.B X
|
||||||
conversions, a nonzero result has the string `0x' (or `0X' for
|
conversions, a non-zero result has the string `0x' (or `0X' for
|
||||||
.B X
|
.B X
|
||||||
conversions) prepended to it.
|
conversions) prepended to it.
|
||||||
For
|
For
|
||||||
|
@ -367,7 +367,7 @@ For example, since glibc 2.2.3 this will give Arabic-Indic digits
|
||||||
in the Persian (`fa_IR') locale.
|
in the Persian (`fa_IR') locale.
|
||||||
.\" outdigits keyword in locale file
|
.\" outdigits keyword in locale file
|
||||||
.SS "The field width"
|
.SS "The field width"
|
||||||
An optional decimal digit string (with nonzero first digit) specifying
|
An optional decimal digit string (with non-zero first digit) specifying
|
||||||
a minimum field width.
|
a minimum field width.
|
||||||
If the converted value has fewer characters
|
If the converted value has fewer characters
|
||||||
than the field width, it will be padded with spaces on the left
|
than the field width, it will be padded with spaces on the left
|
||||||
|
@ -685,7 +685,7 @@ if an exact representation in base 2 exists
|
||||||
and otherwise is sufficiently large to distinguish values of type
|
and otherwise is sufficiently large to distinguish values of type
|
||||||
.IR double .
|
.IR double .
|
||||||
The digit before the decimal point is unspecified for non-normalized
|
The digit before the decimal point is unspecified for non-normalized
|
||||||
numbers, and nonzero but otherwise unspecified for normalized numbers.
|
numbers, and non-zero but otherwise unspecified for normalized numbers.
|
||||||
.TP
|
.TP
|
||||||
.B c
|
.B c
|
||||||
If no
|
If no
|
||||||
|
|
|
@ -49,7 +49,7 @@ On failure, a NULL pointer is returned.
|
||||||
On success,
|
On success,
|
||||||
.BR ptsname_r ()
|
.BR ptsname_r ()
|
||||||
returns 0.
|
returns 0.
|
||||||
On failure, a nonzero value is returned
|
On failure, a non-zero value is returned
|
||||||
and
|
and
|
||||||
.I errno
|
.I errno
|
||||||
is set to indicate the error.
|
is set to indicate the error.
|
||||||
|
|
|
@ -66,7 +66,7 @@ so altering the string changes the environment.
|
||||||
The
|
The
|
||||||
.BR putenv ()
|
.BR putenv ()
|
||||||
function returns zero on success,
|
function returns zero on success,
|
||||||
or nonzero if an error occurs.
|
or non-zero if an error occurs.
|
||||||
.SH ERRORS
|
.SH ERRORS
|
||||||
.TP
|
.TP
|
||||||
.B ENOMEM
|
.B ENOMEM
|
||||||
|
|
|
@ -33,7 +33,7 @@ struct group {
|
||||||
.fi
|
.fi
|
||||||
.in
|
.in
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
The function returns zero on success, and a nonzero value on error.
|
The function returns zero on success, and a non-zero value on error.
|
||||||
.SH "CONFORMING TO"
|
.SH "CONFORMING TO"
|
||||||
This function is a GNU extension.
|
This function is a GNU extension.
|
||||||
.SH "SEE ALSO"
|
.SH "SEE ALSO"
|
||||||
|
|
|
@ -42,7 +42,7 @@ It is equivalent to
|
||||||
.BI "kill(getpid(), " "sig" );
|
.BI "kill(getpid(), " "sig" );
|
||||||
.RE
|
.RE
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
0 on success, nonzero for failure.
|
0 on success, non-zero for failure.
|
||||||
.SH "CONFORMING TO"
|
.SH "CONFORMING TO"
|
||||||
C89, C99.
|
C89, C99.
|
||||||
.SH "SEE ALSO"
|
.SH "SEE ALSO"
|
||||||
|
|
|
@ -116,7 +116,7 @@ and
|
||||||
.IR stdout .
|
.IR stdout .
|
||||||
If
|
If
|
||||||
.I fd2p
|
.I fd2p
|
||||||
is nonzero, then an auxiliary channel to a control
|
is non-zero, then an auxiliary channel to a control
|
||||||
process will be set up, and a descriptor for it will be placed
|
process will be set up, and a descriptor for it will be placed
|
||||||
in
|
in
|
||||||
.IR *fd2p .
|
.IR *fd2p .
|
||||||
|
|
|
@ -220,7 +220,7 @@ If both
|
||||||
.I errbuf
|
.I errbuf
|
||||||
and
|
and
|
||||||
.I errbuf_size
|
.I errbuf_size
|
||||||
are nonzero,
|
are non-zero,
|
||||||
.I errbuf
|
.I errbuf
|
||||||
is filled in with the first
|
is filled in with the first
|
||||||
.I "errbuf_size \- 1"
|
.I "errbuf_size \- 1"
|
||||||
|
|
|
@ -90,7 +90,7 @@ and
|
||||||
.IR stdout .
|
.IR stdout .
|
||||||
If
|
If
|
||||||
.I fd2p
|
.I fd2p
|
||||||
is nonzero, then an auxiliary channel to a control
|
is non-zero, then an auxiliary channel to a control
|
||||||
process will be setup, and a descriptor for it will be placed
|
process will be setup, and a descriptor for it will be placed
|
||||||
in
|
in
|
||||||
.IR *fd2p .
|
.IR *fd2p .
|
||||||
|
|
|
@ -791,7 +791,7 @@ is zero, the service is not registered with the
|
||||||
service.
|
service.
|
||||||
If
|
If
|
||||||
.I protocol
|
.I protocol
|
||||||
is nonzero, then a mapping of the triple
|
is non-zero, then a mapping of the triple
|
||||||
.RI [ prognum , versnum , protocol\fR]
|
.RI [ prognum , versnum , protocol\fR]
|
||||||
to
|
to
|
||||||
\fB\%xprt\->xp_port\fR
|
\fB\%xprt\->xp_port\fR
|
||||||
|
|
|
@ -71,7 +71,7 @@ of \fIresponse\fP is unrecognized.
|
||||||
.SH ERRORS
|
.SH ERRORS
|
||||||
A return value of \-1 may indicate either an invalid input, or some
|
A return value of \-1 may indicate either an invalid input, or some
|
||||||
other error.
|
other error.
|
||||||
It is incorrect to only test if the return value is nonzero.
|
It is incorrect to only test if the return value is non-zero.
|
||||||
|
|
||||||
.BR rpmatch ()
|
.BR rpmatch ()
|
||||||
can fail for any of the reasons that
|
can fail for any of the reasons that
|
||||||
|
|
|
@ -49,7 +49,7 @@ is the running length of the attribute buffer.
|
||||||
When not true then you must assume there are no more attributes in the
|
When not true then you must assume there are no more attributes in the
|
||||||
message, even if
|
message, even if
|
||||||
.I attrlen
|
.I attrlen
|
||||||
is nonzero.
|
is non-zero.
|
||||||
.PP
|
.PP
|
||||||
.BI RTA_DATA( rta )
|
.BI RTA_DATA( rta )
|
||||||
returns a pointer to the start of this attribute's data.
|
returns a pointer to the start of this attribute's data.
|
||||||
|
|
|
@ -66,7 +66,7 @@ The
|
||||||
function scans the directory \fIdir\fP, calling
|
function scans the directory \fIdir\fP, calling
|
||||||
\fIfilter\fP() on each directory entry.
|
\fIfilter\fP() on each directory entry.
|
||||||
Entries for which
|
Entries for which
|
||||||
\fIfilter\fP() returns nonzero are stored in strings allocated via
|
\fIfilter\fP() returns non-zero are stored in strings allocated via
|
||||||
.BR malloc (3),
|
.BR malloc (3),
|
||||||
sorted using
|
sorted using
|
||||||
.BR qsort (3)
|
.BR qsort (3)
|
||||||
|
|
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in New Issue