Document behavior when the command dies from a signal in EXIT STATUS.

This commit is contained in:
Todd C. Miller
2015-09-27 08:59:46 -06:00
parent 99322bcf31
commit 4be48e7845
3 changed files with 30 additions and 22 deletions

View File

@@ -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

View File

@@ -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.

View File

@@ -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.