Otherwise it is 127 if
.I command
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 "SEE ALSO"
.BR times (2)
.sp 2
The calls refer to the capabilities of the process indicated by
the pid field of
.I hdr
-when that is nonzero, or to the current process otherwise.
+when that is non-zero, or to the current process otherwise.
For details on the data, see
.BR capabilities (7).
.IR value .
If
.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
Timers decrement from
.I it_value
Maximum size of
.I core
file. 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
.B RLIMIT_CPU
CPU time limit in seconds.
.I tv
argument is NULL and the
.I tz_minuteswest
-field is nonzero. In such a case it is assumed that the CMOS clock
+field is non-zero. 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
to get UTC system time.
No doubt it is a bad idea to use this feature.
(effective) user ID of the current process.
Unprivileged user processes (i.e., processes with each of
-real, effective and saved user ID nonzero) may change the real,
+real, effective and saved user ID non-zero) may change the real,
effective and saved user ID, each to one of:
the current uid, the current effective uid or the current saved uid.
.B setresgid
sets the real, effective and saved group ID's of the current process,
with the same restrictions for processes with each of
-real, effective and saved user ID nonzero.
+real, effective and saved user ID non-zero.
.SH "RETURN VALUE"
On success, zero is returned. On error, \-1 is returned, and
No search permission for one of the encountered `directories',
or no read permission where
.I oldval
-was nonzero, or no write permission where
+was non-zero, or no write permission where
.I newval
-was nonzero.
+was non-zero.
.SH "CONFORMING TO"
This call is Linux-specific, and should not be used in programs
intended to be portable.
An argz vector is a pointer to a character buffer together with a length.
The intended interpretation of the character buffer is array
of strings, where the strings are separated by NUL bytes.
-If the length is nonzero, the last byte of the buffer must be a NUL.
+If the length is non-zero, the last byte of the buffer must be a NUL.
.LP
These functions are for handling argz vectors.
The pair (NULL,0) is an argz vector, and, conversely,
.B abort()
if
.I errnum
-is nonzero. The message contains the filename, function name and
+is non-zero. The message contains the filename, function name and
line number of the macro call, and the output of
.IR strerror(errnum) .
.SH "RETURN VALUE"
the registrations of all process termination functions are removed.
.SH "RETURN VALUE"
The \fBatexit()\fP function returns the value 0 if successful; otherwise
-it returns a nonzero value.
+it returns a non-zero value.
.SH EXAMPLE
.nf
#include <stdio.h>
The \fBclearenv()\fP function returns zero on success, and a non-zero
value on failure.
.\" 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 AVAILABILITY
Not in libc4, libc5. In glibc since glibc 2.0.
The \fBecvt()\fP function converts \fInumber\fP to a null-terminated
string of \fIndigits\fP digits (where \fIndigits\fP is reduced to an
system-specific limit determined by the precision of a double),
-and returns a pointer to the string. The high-order digit is nonzero,
+and returns a pointer to the string. The high-order digit is non-zero,
unless
.I number
is zero. The low order digit is rounded.
functions calls either \fBexit()\fP or \fBlongjmp()\fP.
.LP
The use of EXIT_SUCCESS and EXIT_FAILURE is slightly more portable
-(to non-Unix environments) than that of 0 and some nonzero value
+(to non-Unix environments) than that of 0 and some non-zero value
like 1 or \-1. In particular, VMS uses a different convention.
.LP
BSD has attempted to standardize exit codes - see the file
.fi
.SH DESCRIPTION
The stdio functions are thread-safe. This is achieved by assigning
-to each FILE object a lockcount and (if the lockcount is nonzero)
+to each FILE object a lockcount and (if the lockcount is non-zero)
an owning thread.
For each library call, these functions wait until the FILE object
is no longer locked by a different thread, then lock it, do the
the lockcount otherwise.
.SH "RETURN VALUE"
The \fBftrylockfile()\fP function returns zero for success
-(the lock was obtained), and nonzero for failure.
+(the lock was obtained), and non-zero for failure.
.SH ERRORS
None.
.SH AVAILABILITY
.BR _POSIX_PIPE_BUF .
.TP
.B _PC_CHOWN_RESTRICTED
-returns nonzero if the
+returns non-zero if the
.BR chown (2)
call may not be used on this file. If
.I filedes
.BR _POSIX_CHOWN_RESTRICTED .
.TP
.B _PC_NO_TRUNC
-returns nonzero if accessing filenames longer than
+returns non-zero if accessing filenames longer than
.B _POSIX_NAME_MAX
generates an error. The corresponding macro is
.BR _POSIX_NO_TRUNC .
.TP
.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 filedes
or
.I path
The other macros provide a short answer to some standard questions.
.TP
.BI isfinite( x )
-returns a nonzero value if
+returns a non-zero value if
.br
(fpclassify(x) != FP_NAN && fpclassify(x) != FP_INFINITE)
.TP
.BI isnormal( x )
-returns a nonzero value if
+returns a non-zero value if
(fpclassify(x) == FP_NORMAL)
.TP
.BI isnan( x )
-returns a nonzero value if
+returns a non-zero value if
(fpclassify(x) == FP_NAN)
.TP
.BI isinf( x )
-returns a nonzero value if
+returns a non-zero value if
(fpclassify(x) == FP_INFINITE)
.SH NOTE
On systems conforming to BSD 4.3,
\fImillitm\fP is the number of milliseconds since \fItime\fP
seconds since the epoch, \fItimezone\fP is the local time zone
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.
.LP
These days the contents of the \fItimezone\fP and \fIdstflag\fP
(which must refer to an existing, accessible file)
and the least significant 8 bits of
.I proj_id
-(which must be nonzero) to generate a
+(which must be non-zero) to generate a
.B key_t
type System V IPC key, suitable for use with
.BR msgget (2),
thread-safe variant. The functionality is the same. The result
is returned in the buffer pointed to by
.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
.IR getdate_err .
.LP
.B gethostbyname_r()
and
.BR gethostbyname2_r() .
-These return 0 on success and nonzero on error. The result of the call
+These return 0 on success and non-zero on error. The result of the call
is now stored in the struct with address
.IR ret .
After the call,
.SH "RETURN VALUE"
\fBgetlogin\fP returns a pointer to the user name when successful,
and NULL on failure.
-\fBgetlogin_r\fP returns 0 when successful, and nonzero on failure.
+\fBgetlogin_r\fP returns 0 when successful, and non-zero on failure.
.SH ERRORS
POSIX specifies
.TP
is a colon (':'), then \fBgetopt()\fP returns ':' instead of '?' to
indicate a missing option argument. If an error was detected, 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),
\fBgetopt()\fP prints an error message.
.PP
The
.BR hcreate_r() .
.SH "RETURN VALUE"
\fBhcreate()\fP and \fBhcreate_r()\fP return 0 when allocation of the memory
-for the hash table fails, nonzero otherwise.
+for the hash table fails, non-zero otherwise.
.LP
\fBhsearch()\fP returns \fBNULL\fP if \fIaction\fP is \fBENTER\fP and
the hash table is full, or \fIaction\fP is \fBFIND\fP and \fIitem\fP
cannot be found in the hash table.
.LP
\fBhsearch_r()\fP 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
POSIX documents
.TP
\fBinet_aton()\fP converts the Internet host address \fIcp\fP from the
standard numbers-and-dots notation into binary data and stores it in
the structure that \fIinp\fP points to. \fBinet_aton\fP returns
-nonzero if the address is valid, zero if not.
+non-zero if the address is valid, zero if not.
.PP
The \fBinet_addr()\fP function converts the Internet host address
\fIcp\fP from numbers-and-dots notation into binary data in network
.nl
.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"
-The values returned are nonzero if the character
+The values returned are non-zero if the character
.I c
falls into the tested class, and a zero value
if not.
.P
\fBsiglongjmp()\fP is similar to \fBlongjmp()\fP except for the type of
its \fIenv\fP argument. If the \fBsigsetjmp()\fP call that set this
-\fIenv\fP used a nonzero \fIsavesigs\fP flag, \fBsiglongjmp()\fP also
+\fIenv\fP used a non-zero \fIsavesigs\fP flag, \fBsiglongjmp()\fP also
restores the set of blocked signals.
.SH "RETURN VALUE"
These functions never return.
in the Persian (`fa_IR') locale.
.\" outdigits keyword in locale file
.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. If the converted value has fewer characters
than the field width, it will be padded with spaces on the left
(or right, if the left-adjustment flag has been given).
and otherwise is sufficiently large to distinguish values of type
.IR double .
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
.B c
If no
.BI "kill(getpid(), " "sig" );
.RE
.SH "RETURN VALUE"
-0 on success, nonzero for failure.
+0 on success, non-zero for failure.
.SH "CONFORMING TO"
ANSI\-C
.SH "SEE ALSO"
The function
.B setvbuf
returns 0 on success.
-It can return any value on failure, but returns nonzero when
+It can return any value on failure, but returns non-zero when
.I mode
is invalid or the request cannot be honoured. It may set
.I errno
later use by \fBlongjmp()\fP. The stack context will be invalidated
if the function which called \fBsetjmp()\fP returns.
.P
-\fBsigsetjmp()\fP is similar to \fBsetjmp()\fP. If \fIsavesigs\fP is nonzero,
+\fBsigsetjmp()\fP is similar to \fBsetjmp()\fP. If \fIsavesigs\fP is non-zero,
the set of blocked signals is saved in \fIenv\fP and will be restored
if a \fBsiglongjmp()\fP is later performed with this \fIenv\fP.
.SH "RETURN VALUE"
Compile with -std=c99; link with \-lm.
.SH DESCRIPTION
`signbit' is a generic macro which can work on all real floating-point
-types. It returns a nonzero value if the value of X has its sign
+types. It returns a non-zero value if the value of X has its sign
bit set.
.PP
This is not the same as `x < 0.0', because IEEE 754 floating point
allows zero to be signed. The comparison `-0.0 < 0.0' is false,
-but `signbit (-0.0)' will return a nonzero value.
+but `signbit (-0.0)' will return a non-zero value.
.SH "CONFORMING TO"
This function is defined in IEC 559 (and the appendix with
recommended functions in IEEE 754/IEEE 854).
.LP
The
.B __flbf()
-function returns a nonzero value if the stream is line-buffered,
+function returns a non-zero value if the stream is line-buffered,
and zero otherwise.
.LP
The
.B __freadable()
-function returns a nonzero value if the stream allows reading,
+function returns a non-zero value if the stream allows reading,
and zero otherwise.
.LP
The
.B __fwritable()
-function returns a nonzero value if the stream allows writing,
+function returns a non-zero value if the stream allows writing,
and zero otherwise.
.LP
The
.B __freading()
-function returns a nonzero value if the stream is read-only, or
+function returns a non-zero value if the stream is read-only, or
if the last operation on the stream was a read operation,
and zero otherwise.
.LP
The
.B __fwriting()
-function returns a nonzero value if the stream is write-only (or
+function returns a non-zero value if the stream is write-only (or
append-only), or if the last operation on the stream was a write
operation, and zero otherwise.
.LP
The \fBstrerror()\fP function returns the appropriate error description
string, or an unknown error message if the error code is unknown.
The value of \fIerrno\fP is not changed for a successful call, and is
-set to a nonzero value upon error.
+set to a non-zero value upon error.
The \fBstrerror_r()\fP function returns 0 on success and \-1 on failure,
setting \fIerrno\fP.
is
.BR NULL ,
.BR system ()
-returns nonzero if the shell is available, and zero if not.
+returns non-zero if the shell is available, and zero if not.
.PP
.BR system ()
does not affect the wait status of any other children.
is specified, the modem control lines shall no longer be asserted.
Normally, this will disconnect the line. \fBCBAUDEX\fP is a mask
for the speeds beyond those defined in POSIX.1 (57600 and above).
-Thus, \fBB57600\fP & \fBCBAUDEX\fP is nonzero.
+Thus, \fBB57600\fP & \fBCBAUDEX\fP is non-zero.
.LP
.B cfgetispeed()
returns the input baud rate stored in the \fBtermios\fP structure.
two constants EXTA, EXTB ("External A" and "External B").
Many systems extend the list with much higher baud rates.
.LP
-The effect of a nonzero \fIduration\fP with \fBtcsendbreak\fP varies.
+The effect of a non-zero \fIduration\fP with \fBtcsendbreak\fP varies.
SunOS specifies a break of
.IB duration * N
seconds, where \fIN\fP is at least 0.25, and not more than 0.5.
.IR duration .
Under Solaris and Unixware,
.B tcsendbreak
-with nonzero
+with non-zero
.I duration
behaves like
.BR tcdrain .
other time conversion functions that depend on the time zone.
In a SysV-like environment it will also set the variables \fItimezone\fP
(seconds West of GMT) and \fIdaylight\fP (0 if this time zone does not
-have any daylight savings time rules, nonzero if there is a time during
+have any daylight savings time rules, non-zero if there is a time during
the year when daylight savings time applies).
.PP
If the TZ variable does not appear in the environment, the \fItzname\fP
.LP
If the
.I interval
-argument is nonzero, further SIGALRM signals will be sent every
+argument is non-zero, further SIGALRM signals will be sent every
.I interval
microseconds after the first.
.SH "RETURN VALUE"
.SS "Locking the termios structure"
The termios structure of a tty can be locked. The lock is itself
-a termios structure, with nonzero bits or fields indicating a
+a termios structure, with non-zero bits or fields indicating a
locked value.
.TP
.BI "TIOCGLCKTRMIOS struct termios *" argp
returns without doing anything.
When
.I arg
-is nonzero, nobody knows what will happen.
+is non-zero, nobody knows what will happen.
(SVR4, UnixWare, Solaris, Linux treat
.I "tcsendbreak(fd,arg)"
-with nonzero
+with non-zero
.I arg
like
.IR "tcdrain(fd)" .
.IR arg .
DG-UX and AIX treat
.I arg
-(when nonzero) as a timeinterval measured in milliseconds.
+(when non-zero) as a timeinterval measured in milliseconds.
HP-UX ignores
.IR arg .)
.TP
.BI "TCSBRKP int " arg
-So-called "POSIX version" of TCSBRK. It treats nonzero
+So-called "POSIX version" of TCSBRK. It treats non-zero
.I arg
as a timeinterval measured in deciseconds, and does nothing
when the driver does not support breaks.
.BI "TIOCPKT const int *" argp
Enable (when
.RI * argp
-is nonzero) or disable packet mode.
+is non-zero) or disable packet mode.
Can be applied to the master side of a pseudotty only (and will return
ENOTTY otherwise). In packet mode, each subsequent
.BR read (2)
-will return a packet that either contains a single nonzero control byte,
+will return a packet that either contains a single non-zero control byte,
or has a single zero byte followed by data written on the slave side of
the pty. If the first byte is not TIOCPKT_DATA (0), it is an OR of one
or more of the following bits:
("Set software carrier flag")
Set the CLOCAL flag in the termios structure when
.RI * argp
-is nonzero, and clear it otherwise.
+is non-zero, and clear it otherwise.
.LP
If the CLOCAL flag for a line is off, the hardware carrier detect (DCD)
signal is significant, and an
nr_unused seems to be the number of unused dentries.
age_limit is the age in seconds after which dcache entries
can be reclaimed when memory is short and want_pages is
-nonzero when the kernel has called shrink_dcache_pages() and the
+non-zero when the kernel has called shrink_dcache_pages() and the
dcache isn't pruned yet.
.TP
.I /proc/sys/fs/dir-notify-enable
allocated. This can be slightly more than inode-max because
Linux allocates them one pageful at a time.
nr_free_inodes represents the number of free inodes.
-preshrink is nonzero when the nr_inodes > inode-max and the
+preshrink is non-zero when the nr_inodes > inode-max and the
system needs to prune the inode list instead of allocating
more.
.TP
.I /proc/sys/kernel/l2cr
(PowerPC only) This file
contains a flag that controls the L2 cache of G3 processor
-boards. If 0, the cache is disabled. Enabled if nonzero.
+boards. If 0, the cache is disabled. Enabled if non-zero.
.TP
.I /proc/sys/kernel/modprobe
This file
.I /proc/sys/kernel/panic
gives read/write access to the kernel variable
.IR panic_timeout .
-If this is zero, the kernel will loop on a panic; if nonzero
+If this is zero, the kernel will loop on a panic; if non-zero
it indicates that the kernel should autoreboot after this number
of seconds. When you use the
software watchdog device driver, the recommended setting is 60.
.BR mmap (2)
with MAP_NORESERVE set are not checked, and the default check is very weak,
leading to the risk of getting a process "OOM-killed".
-Under Linux 2.4 any nonzero value implies mode 1.
+Under Linux 2.4 any non-zero value implies mode 1.
In mode 2 (available since Linux 2.6), the total virtual address space
on the system is limited to (SS + RAM*(r/100)),
where SS is the size of the swap space, and RAM
if one wishes to find out where the kernel is spending its CPU cycles.
Profiling is enabled by setting the variable
.I prof_shift
-to a nonzero value. This is done either by specifying CONFIG_PROFILE at
+to a non-zero value. This is done either by specifying CONFIG_PROFILE at
compile time, or by giving the `profile=' option.
Now the value that
.I prof_shift
\fBTZDIR\fP\fI/\fP\fITZ\fP
Time zone data file for time zone \fITZ\fP.
.SH "EXIT STATUS"
-The exit status is zero if a time zone was successfully obtained from the user,
-nonzero otherwise.
+The exit status is zero if a time zone was successfully obtained
+from the user, non-zero otherwise.
.SH "SEE ALSO"
.BR tzfile (5),
.BR zdump (8),
projects / thirdparty / man-pages.git / commitdiff
