Manual pages: use the term "exit status"

The manual pages currently use a multitude of terms--"exit code",
"error code", "return code", "exit code", and so on--when what
is always meant is "exit status" (the POSIX term). This patch fixes
as many of these erroneous terms as I could find.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk (man-pages) 2020-05-19 14:54:07 +02:00 committed by Karel Zak
parent 7e765c93dc
commit a87f49f662
18 changed files with 34 additions and 34 deletions

View File

@ -41,7 +41,7 @@ serially. This is equivalent to the
.B \-As
options.
.PP
The exit code returned by
The exit status returned by
.B fsck
is the sum of the following conditions:
.PP
@ -74,8 +74,8 @@ Shared-library error
.PD
.RE
.PP
The exit code returned when multiple filesystems are checked
is the bit-wise OR of the exit codes for each
The exit status returned when multiple filesystems are checked
is the bit-wise OR of the exit statuses for each
filesystem that is checked.
.PP
In actuality,
@ -280,7 +280,7 @@ a progress bar at a time. GUI front-ends may specify a file descriptor
in which case the progress bar information will be sent to that file descriptor.
.TP
.B \-M
Do not check mounted filesystems and return an exit code of 0
Do not check mounted filesystems and return an exit status of 0
for mounted filesystems.
.TP
.B \-N

View File

@ -93,7 +93,7 @@ a MINIX filesystem,
.B fsck.minix
will print "bad magic number in super-block".
.SH EXIT STATUS
The exit code returned by
The exit status returned by
.B fsck.minix
is the sum of the following:
.PP
@ -111,7 +111,7 @@ mounted
Filesystem errors left uncorrected
.TP
.B 7
Combination of exit codes 3 and 4
Combination of exit statuses 3 and 4
.TP
.B 8
Operational error
@ -126,7 +126,7 @@ Usage or syntax error
Linus Torvalds
.ME
.br
Error code values by
Exit status values by
.MT faith@\:cs.\:unc.\:edu
Rik Faith
.ME

View File

@ -20,7 +20,7 @@ or a regular file that shall contain the filesystem. The
.I size
argument is the number of blocks to be used for the filesystem.
.PP
The exit code returned by
The exit status returned by
.B mkfs
is 0 on success and 1 on failure.
.PP

View File

@ -48,7 +48,7 @@ only works as
.B \-\-version
when it is the only option.
.SH EXIT STATUS
The exit code returned by
The exit status returned by
.B mkfs.bfs
is 0 when all went well, and 1 when something went wrong.
.SH SEE ALSO

View File

@ -34,7 +34,7 @@ will contain the cram file system, which later can be mounted.
Enable verbose messaging.
.TP
\fB\-E\fR
Treat all warnings as errors, which are reflected as command return value.
Treat all warnings as errors, which are reflected as command exit status.
.TP
\fB\-b\fR \fIblocksize\fR
Use defined block size, which has to be divisible by page size.

View File

@ -71,7 +71,7 @@ with other options.
\fB\-h\fR, \fB\-\-help\fR
Display help text and exit.
.SH EXIT STATUS
The exit code returned by
The exit status returned by
.B mkfs.minix
is one of the following:
.IP 0

View File

@ -13,7 +13,7 @@ intended as a replacement shell field to deny login access to an account.
If the file /etc/nologin.txt exists, nologin displays its contents to the
user instead of the default message.
.PP
The exit code returned by
The exit status returned by
.B nologin
is always 1.
.PP

View File

@ -91,7 +91,7 @@ For security reasons
.B blkid
silently ignores all devices where the probing result is ambivalent (multiple
colliding filesystems are detected). The low-level probing mode (\fB\-p\fR)
provides more information and extra return code in this case.
provides more information and extra exit status in this case.
It's recommended to use
.BR wipefs (8)
to get a detailed overview and to erase obsolete stuff (magic strings) from the device.
@ -289,16 +289,16 @@ Display version number and exit.
.SH EXIT STATUS
If the specified device or device addressed by specified token (option
\fB\-\-match\-token\fR) was found and it's possible to gather any information about the
device, an exit code 0 is returned. Note the option \fB\-\-match\-tag\fR filters output
tags, but it does not affect return code.
device, an exit status 0 is returned. Note the option \fB\-\-match\-tag\fR filters output
tags, but it does not affect exit status.
If the specified token was not found, or no (specified) devices could be
identified, or it is impossible to gather any information about the device
identifiers or device content an exit code of 2 is returned.
identifiers or device content an exit status of 2 is returned.
For usage or other errors, an exit code of 4 is returned.
For usage or other errors, an exit status of 4 is returned.
If an ambivalent probing result was detected by low-level probing mode (\fB\-p\fR), an exit code of 8 is
If an ambivalent probing result was detected by low-level probing mode (\fB\-p\fR), an exit status of 8 is
returned.
.SH CONFIGURATION FILE
The standard location of the

View File

@ -173,7 +173,7 @@ the executable is to use full path when calling the command, for example:
.B "/bin/kill \-\-version"
.SH EXIT STATUS
.B kill
has the following return codes:
has the following exit status values:
.PP
.RS
.PD 0

View File

@ -262,7 +262,7 @@ before version 2.26 used openlog, and hence was unable to detected loss of
messages sent to Unix sockets.
.IP
The default mode is \fBauto\fR. When errors are not enabled lost messages are
not communicated and will result to successful return value of
not communicated and will result to successful exit status of
.BR logger (1)
invocation.
.TP

View File

@ -79,7 +79,7 @@ Display help text and exit.
.SH EXIT STATUS
.B chcpu
has the following return codes:
has the following exit status values:
.TP
.B 0
success

View File

@ -81,7 +81,7 @@ progress.
Print the version number, then exit.
.SH EXIT STATUS
.B chmem
has the following return codes:
has the following exit status values:
.TP
.B 0
success

View File

@ -33,7 +33,7 @@ preallocation is done quickly by allocating blocks and marking them as
uninitialized, requiring no IO to the data blocks.
This is much faster than creating a file by filling it with zeroes.
.PP
The exit code returned by
The exit status returned by
.B fallocate
is 0 on success and 1 on failure.
.SH OPTIONS

View File

@ -66,7 +66,7 @@ Pass a single \fIcommand\fR, without arguments, to the shell with
.BR \-c .
.TP
.BR \-E , " \-\-conflict\-exit\-code " \fInumber
The exit code used when the \fB\-n\fP option is in use, and the
The exit status used when the \fB\-n\fP option is in use, and the
conflicting lock exists, or the \fB\-w\fP option is in use,
and the timeout is reached. The default value is \fB1\fR.
.TP
@ -87,7 +87,7 @@ Fail rather than wait if the lock cannot be
immediately acquired.
See the
.B \-E
option for the exit code used.
option for the exit status used.
.TP
.BR \-o , " \-\-close"
Close the file descriptor on which the lock is held before executing
@ -111,7 +111,7 @@ Fail if the lock cannot be acquired within
Decimal fractional values are allowed.
See the
.B \-E
option for the exit code used. The zero number of
option for the exit status used. The zero number of
.I seconds
is interpreted as \fB\-\-nonblock\fR.
.TP
@ -178,11 +178,11 @@ then flock is used to lock the descriptor.
.SH EXIT STATUS
The command uses
.B sysexits.h
return values for everything, except when using either of the options
exit status values for everything, except when using either of the options
.B \-n
or
.B \-w
which report a failure to acquire the lock with a return value given by the
which report a failure to acquire the lock with a exit status given by the
.B \-E
option, or 1 by default.
.PP

View File

@ -2503,7 +2503,7 @@ a filesystem corruption.
.SH EXIT STATUS
.B mount
has the following return codes (the bits can be ORed):
has the following exit status values (the bits can be ORed):
.TP
.B 0
success

View File

@ -184,7 +184,7 @@ If applying any specified option fails,
.I program
will not be run and
.B setpriv
will return with exit code 127.
will return with exit status 127.
.PP
Be careful with this tool \-\- it may have unexpected security consequences.
For example, setting no_new_privs and then execing a program that is

View File

@ -24,8 +24,8 @@ Set the controlling terminal to the current one.
Always create a new process.
.TP
.BR \-w , " \-\-wait"
Wait for the execution of the program to end, and return the exit value of
this program as the return value of
Wait for the execution of the program to end, and return the exit status of
this program as the exit status of
.BR setsid .
.TP
.BR \-V , " \-\-version"

View File

@ -104,8 +104,8 @@ terminal to avoid double-echo, and enabled if standard input is not terminal
to avoid missing input in the session log.
.TP
\fB\-e\fR, \fB\-\-return\fR
Return the exit code of the child process. Uses the same format as bash
termination on signal termination exit code is 128+n. The exit code of
Return the exit status of the child process. Uses the same format as bash
termination on signal termination exit status is 128+n. The exit status of
the child process is always stored in type script file too.
.TP
\fB\-f\fR, \fB\-\-flush\fR