Document behavior when the command dies from a signal in EXIT STATUS.
This commit is contained in:
22
doc/sudo.cat
22
doc/sudo.cat
@@ -412,19 +412,21 @@ CCOOMMMMAANNDD EEXXEECCUUTTIIOONN
|
|||||||
architecture.
|
architecture.
|
||||||
|
|
||||||
EEXXIITT VVAALLUUEE
|
EEXXIITT VVAALLUUEE
|
||||||
Upon successful execution of a program, the exit status from _s_u_d_o will
|
Upon successful execution of a command, the exit status from ssuuddoo will be
|
||||||
simply be the exit status of the program that was executed.
|
the exit status of the program that was executed. If the command
|
||||||
|
terminated due to receipt of a signal, ssuuddoo will send itself the signal
|
||||||
|
that terminated the command.
|
||||||
|
|
||||||
Otherwise, ssuuddoo exits with a value of 1 if there is a
|
Otherwise, ssuuddoo exits with a value of 1 if there is a
|
||||||
configuration/permission problem or if ssuuddoo cannot execute the given
|
configuration/permission problem or if ssuuddoo cannot execute the given
|
||||||
command. In the latter case the error string is printed to the standard
|
command. In the latter case, the error string is printed to the standard
|
||||||
error. If ssuuddoo cannot stat(2) one or more entries in the user's PATH, an
|
error. If ssuuddoo cannot stat(2) one or more entries in the user's PATH, an
|
||||||
error is printed on stderr. (If the directory does not exist or if it is
|
error is printed to the standard error. (If the directory does not exist
|
||||||
not really a directory, the entry is ignored and no error is printed.)
|
or if it is not really a directory, the entry is ignored and no error is
|
||||||
This should not happen under normal circumstances. The most common
|
printed.) This should not happen under normal circumstances. The most
|
||||||
reason for stat(2) to return ``permission denied'' is if you are running
|
common reason for stat(2) to return ``permission denied'' is if you are
|
||||||
an automounter and one of the directories in your PATH is on a machine
|
running an automounter and one of the directories in your PATH is on a
|
||||||
that is currently unreachable.
|
machine that is currently unreachable.
|
||||||
|
|
||||||
SSEECCUURRIITTYY NNOOTTEESS
|
SSEECCUURRIITTYY NNOOTTEESS
|
||||||
ssuuddoo tries to be safe when executing external commands.
|
ssuuddoo tries to be safe when executing external commands.
|
||||||
@@ -608,4 +610,4 @@ DDIISSCCLLAAIIMMEERR
|
|||||||
file distributed with ssuuddoo or http://www.sudo.ws/license.html for
|
file distributed with ssuuddoo or http://www.sudo.ws/license.html for
|
||||||
complete details.
|
complete details.
|
||||||
|
|
||||||
Sudo 1.8.15 September 15, 2015 Sudo 1.8.15
|
Sudo 1.8.15 September 27, 2015 Sudo 1.8.15
|
||||||
|
@@ -21,7 +21,7 @@
|
|||||||
.\" Agency (DARPA) and Air Force Research Laboratory, Air Force
|
.\" Agency (DARPA) and Air Force Research Laboratory, Air Force
|
||||||
.\" Materiel Command, USAF, under agreement number F39502-99-1-0512.
|
.\" Materiel Command, USAF, under agreement number F39502-99-1-0512.
|
||||||
.\"
|
.\"
|
||||||
.TH "SUDO" "8" "September 15, 2015" "Sudo @PACKAGE_VERSION@" "System Manager's Manual"
|
.TH "SUDO" "8" "September 27, 2015" "Sudo @PACKAGE_VERSION@" "System Manager's Manual"
|
||||||
.nh
|
.nh
|
||||||
.if n .ad l
|
.if n .ad l
|
||||||
.SH "NAME"
|
.SH "NAME"
|
||||||
@@ -824,9 +824,12 @@ manual for more information about the
|
|||||||
\fBsudo\fR
|
\fBsudo\fR
|
||||||
plugin architecture.
|
plugin architecture.
|
||||||
.SH "EXIT VALUE"
|
.SH "EXIT VALUE"
|
||||||
Upon successful execution of a program, the exit status from
|
Upon successful execution of a command, the exit status from
|
||||||
\fIsudo\fR
|
\fBsudo\fR
|
||||||
will simply be the exit status of the program that was executed.
|
will be the exit status of the program that was executed.
|
||||||
|
If the command terminated due to receipt of a signal,
|
||||||
|
\fBsudo\fR
|
||||||
|
will send itself the signal that terminated the command.
|
||||||
.PP
|
.PP
|
||||||
Otherwise,
|
Otherwise,
|
||||||
\fBsudo\fR
|
\fBsudo\fR
|
||||||
@@ -834,14 +837,14 @@ exits with a value of 1 if there is a configuration/permission
|
|||||||
problem or if
|
problem or if
|
||||||
\fBsudo\fR
|
\fBsudo\fR
|
||||||
cannot execute the given command.
|
cannot execute the given command.
|
||||||
In the latter case the error string is printed to the standard error.
|
In the latter case, the error string is printed to the standard error.
|
||||||
If
|
If
|
||||||
\fBsudo\fR
|
\fBsudo\fR
|
||||||
cannot
|
cannot
|
||||||
stat(2)
|
stat(2)
|
||||||
one or more entries in the user's
|
one or more entries in the user's
|
||||||
\fRPATH\fR,
|
\fRPATH\fR,
|
||||||
an error is printed on stderr.
|
an error is printed to the standard error.
|
||||||
(If the directory does not exist or if it is not really a directory,
|
(If the directory does not exist or if it is not really a directory,
|
||||||
the entry is ignored and no error is printed.)
|
the entry is ignored and no error is printed.)
|
||||||
This should not happen under normal circumstances.
|
This should not happen under normal circumstances.
|
||||||
|
@@ -19,7 +19,7 @@
|
|||||||
.\" Agency (DARPA) and Air Force Research Laboratory, Air Force
|
.\" Agency (DARPA) and Air Force Research Laboratory, Air Force
|
||||||
.\" Materiel Command, USAF, under agreement number F39502-99-1-0512.
|
.\" Materiel Command, USAF, under agreement number F39502-99-1-0512.
|
||||||
.\"
|
.\"
|
||||||
.Dd September 15, 2015
|
.Dd September 27, 2015
|
||||||
.Dt SUDO @mansectsu@
|
.Dt SUDO @mansectsu@
|
||||||
.Os Sudo @PACKAGE_VERSION@
|
.Os Sudo @PACKAGE_VERSION@
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
@@ -759,9 +759,12 @@ manual for more information about the
|
|||||||
.Nm
|
.Nm
|
||||||
plugin architecture.
|
plugin architecture.
|
||||||
.Sh EXIT VALUE
|
.Sh EXIT VALUE
|
||||||
Upon successful execution of a program, the exit status from
|
Upon successful execution of a command, the exit status from
|
||||||
.Em sudo
|
.Nm
|
||||||
will simply be the exit status of the program that was executed.
|
will be the exit status of the program that was executed.
|
||||||
|
If the command terminated due to receipt of a signal,
|
||||||
|
.Nm
|
||||||
|
will send itself the signal that terminated the command.
|
||||||
.Pp
|
.Pp
|
||||||
Otherwise,
|
Otherwise,
|
||||||
.Nm
|
.Nm
|
||||||
@@ -769,14 +772,14 @@ exits with a value of 1 if there is a configuration/permission
|
|||||||
problem or if
|
problem or if
|
||||||
.Nm
|
.Nm
|
||||||
cannot execute the given command.
|
cannot execute the given command.
|
||||||
In the latter case the error string is printed to the standard error.
|
In the latter case, the error string is printed to the standard error.
|
||||||
If
|
If
|
||||||
.Nm
|
.Nm
|
||||||
cannot
|
cannot
|
||||||
.Xr stat 2
|
.Xr stat 2
|
||||||
one or more entries in the user's
|
one or more entries in the user's
|
||||||
.Ev PATH ,
|
.Ev PATH ,
|
||||||
an error is printed on stderr.
|
an error is printed to the standard error.
|
||||||
(If the directory does not exist or if it is not really a directory,
|
(If the directory does not exist or if it is not really a directory,
|
||||||
the entry is ignored and no error is printed.)
|
the entry is ignored and no error is printed.)
|
||||||
This should not happen under normal circumstances.
|
This should not happen under normal circumstances.
|
||||||
|
Reference in New Issue
Block a user