-n The -\b-n\bn (_\bn_\bo_\bn_\b-_\bi_\bn_\bt_\be_\br_\ba_\bc_\bt_\bi_\bv_\be) option prevents s\bsu\bud\bdo\bo from
prompting the user for a password. If a password is
required for the command to run, s\bsu\bud\bdo\bo will display an error
- messages and exit.
+ message and exit.
-P The -\b-P\bP (_\bp_\br_\be_\bs_\be_\br_\bv_\be _\bg_\br_\bo_\bu_\bp _\bv_\be_\bc_\bt_\bo_\br) option causes s\bsu\bud\bdo\bo to
preserve the invoking user's group vector unaltered. By
matched is ALL, the user may set variables that would overwise be
forbidden. See _\bs_\bu_\bd_\bo_\be_\br_\bs(4) for more information.
-R\bRE\bET\bTU\bUR\bRN\bN V\bVA\bAL\bLU\bUE\bES\bS
+E\bEX\bXI\bIT\bT V\bVA\bAL\bLU\bUE\bE
Upon successful execution of a program, the exit status from s\bsu\bud\bdo\bo will
simply be the exit status of the program that was executed.
s\bsu\bud\bdo\bo utilizes the following environment variables:
EDITOR Default editor to use in -\b-e\be (sudoedit) mode if neither
- SUDO_EDITOR nor VISUAL is set
+ SUDO_EDITOR nor VISUAL is set.
MAIL In -\b-i\bi mode or when _\be_\bn_\bv_\b__\br_\be_\bs_\be_\bt is enabled in _\bs_\bu_\bd_\bo_\be_\br_\bs, set
- to the mail spool of the target user
+ to the mail spool of the target user.
HOME Set to the home directory of the target user if -\b-i\bi or
-\b-H\bH are specified, _\be_\bn_\bv_\b__\br_\be_\bs_\be_\bt or _\ba_\bl_\bw_\ba_\by_\bs_\b__\bs_\be_\bt_\b__\bh_\bo_\bm_\be are set
in _\bs_\bu_\bd_\bo_\be_\br_\bs, or when the -\b-s\bs option is specified and
- _\bs_\be_\bt_\b__\bh_\bo_\bm_\be is set in _\bs_\bu_\bd_\bo_\be_\br_\bs
+ _\bs_\be_\bt_\b__\bh_\bo_\bm_\be is set in _\bs_\bu_\bd_\bo_\be_\br_\bs.
PATH Set to a sane value if the _\bs_\be_\bc_\bu_\br_\be_\b__\bp_\ba_\bt_\bh sudoers option
is set.
- SHELL Used to determine shell to run with -s option
+ SHELL Used to determine shell to run with -\b-s\bs option.
SUDO_ASKPASS Specifies the path to a helper program used to read the
- password if no terminal is available or if the -A
+ password if no terminal is available or if the -\b-A\bA
option is specified.
- SUDO_COMMAND Set to the command run by sudo
+ SUDO_COMMAND Set to the command run by sudo.
- SUDO_EDITOR Default editor to use in -\b-e\be (sudoedit) mode
+ SUDO_EDITOR Default editor to use in -\b-e\be (sudoedit) mode.
- SUDO_GID Set to the group ID of the user who invoked sudo
+ SUDO_GID Set to the group ID of the user who invoked sudo.
- SUDO_PROMPT Used as the default password prompt
+ SUDO_PROMPT Used as the default password prompt.
SUDO_PS1 If set, PS1 will be set to its value for the program
- being run
+ being run.
- SUDO_UID Set to the user ID of the user who invoked sudo
+ SUDO_UID Set to the user ID of the user who invoked sudo.
- SUDO_USER Set to the login of the user who invoked sudo
+ SUDO_USER Set to the login of the user who invoked sudo.
USER Set to the target user (root unless the -\b-u\bu option is
- specified)
+ specified).
VISUAL Default editor to use in -\b-e\be (sudoedit) mode if
- SUDO_EDITOR is not set
+ SUDO_EDITOR is not set.
F\bFI\bIL\bLE\bES\bS
_\b/_\be_\bt_\bc_\b/_\bs_\bu_\bd_\bo_\be_\br_\bs List of who can run what
-1.7.10 May 23, 2012 SUDO(1m)
+1.7.10 July 12, 2012 SUDO(1m)
.\" ========================================================================
.\"
.IX Title "SUDO @mansectsu@"
-.TH SUDO @mansectsu@ "May 23, 2012" "1.7.10" "MAINTENANCE COMMANDS"
+.TH SUDO @mansectsu@ "July 12, 2012" "1.7.10" "MAINTENANCE COMMANDS"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.IX Item "-n"
The \fB\-n\fR (\fInon-interactive\fR) option prevents \fBsudo\fR from prompting
the user for a password. If a password is required for the command
-to run, \fBsudo\fR will display an error messages and exit.
+to run, \fBsudo\fR will display an error message and exit.
.IP "\-P" 12
.IX Item "-P"
The \fB\-P\fR (\fIpreserve\fR \fIgroup vector\fR) option causes \fBsudo\fR to
is set in \fIsudoers\fR, the command to be run has the \f(CW\*(C`SETENV\*(C'\fR tag
set or the command matched is \f(CW\*(C`ALL\*(C'\fR, the user may set variables
that would overwise be forbidden. See \fIsudoers\fR\|(@mansectform@) for more information.
-.SH "RETURN VALUES"
-.IX Header "RETURN VALUES"
+.SH "EXIT VALUE"
+.IX Header "EXIT VALUE"
Upon successful execution of a program, the exit status from \fBsudo\fR
will simply be the exit status of the program that was executed.
.PP
.el .IP "\f(CW\*(C`EDITOR\*(C'\fR" 16
.IX Item "EDITOR"
Default editor to use in \fB\-e\fR (sudoedit) mode if neither \f(CW\*(C`SUDO_EDITOR\*(C'\fR
-nor \f(CW\*(C`VISUAL\*(C'\fR is set
+nor \f(CW\*(C`VISUAL\*(C'\fR is set.
.ie n .IP "\*(C`MAIL\*(C'" 16
.el .IP "\f(CW\*(C`MAIL\*(C'\fR" 16
.IX Item "MAIL"
In \fB\-i\fR mode or when \fIenv_reset\fR is enabled in \fIsudoers\fR, set
-to the mail spool of the target user
+to the mail spool of the target user.
.ie n .IP "\*(C`HOME\*(C'" 16
.el .IP "\f(CW\*(C`HOME\*(C'\fR" 16
.IX Item "HOME"
Set to the home directory of the target user if \fB\-i\fR or \fB\-H\fR are
specified, \fIenv_reset\fR or \fIalways_set_home\fR are set in \fIsudoers\fR,
or when the \fB\-s\fR option is specified and \fIset_home\fR is set in
-\&\fIsudoers\fR
+\&\fIsudoers\fR.
.ie n .IP "\*(C`PATH\*(C'" 16
.el .IP "\f(CW\*(C`PATH\*(C'\fR" 16
.IX Item "PATH"
.ie n .IP "\*(C`SHELL\*(C'" 16
.el .IP "\f(CW\*(C`SHELL\*(C'\fR" 16
.IX Item "SHELL"
-Used to determine shell to run with \f(CW\*(C`\-s\*(C'\fR option
+Used to determine shell to run with \fB\-s\fR option.
.ie n .IP "\*(C`SUDO_ASKPASS\*(C'" 16
.el .IP "\f(CW\*(C`SUDO_ASKPASS\*(C'\fR" 16
.IX Item "SUDO_ASKPASS"
Specifies the path to a helper program used to read the password
-if no terminal is available or if the \f(CW\*(C`\-A\*(C'\fR option is specified.
+if no terminal is available or if the \fB\-A\fR option is specified.
.ie n .IP "\*(C`SUDO_COMMAND\*(C'" 16
.el .IP "\f(CW\*(C`SUDO_COMMAND\*(C'\fR" 16
.IX Item "SUDO_COMMAND"
-Set to the command run by sudo
+Set to the command run by sudo.
.ie n .IP "\*(C`SUDO_EDITOR\*(C'" 16
.el .IP "\f(CW\*(C`SUDO_EDITOR\*(C'\fR" 16
.IX Item "SUDO_EDITOR"
-Default editor to use in \fB\-e\fR (sudoedit) mode
+Default editor to use in \fB\-e\fR (sudoedit) mode.
.ie n .IP "\*(C`SUDO_GID\*(C'" 16
.el .IP "\f(CW\*(C`SUDO_GID\*(C'\fR" 16
.IX Item "SUDO_GID"
-Set to the group \s-1ID\s0 of the user who invoked sudo
+Set to the group \s-1ID\s0 of the user who invoked sudo.
.ie n .IP "\*(C`SUDO_PROMPT\*(C'" 16
.el .IP "\f(CW\*(C`SUDO_PROMPT\*(C'\fR" 16
.IX Item "SUDO_PROMPT"
-Used as the default password prompt
+Used as the default password prompt.
.ie n .IP "\*(C`SUDO_PS1\*(C'" 16
.el .IP "\f(CW\*(C`SUDO_PS1\*(C'\fR" 16
.IX Item "SUDO_PS1"
-If set, \f(CW\*(C`PS1\*(C'\fR will be set to its value for the program being run
+If set, \f(CW\*(C`PS1\*(C'\fR will be set to its value for the program being run.
.ie n .IP "\*(C`SUDO_UID\*(C'" 16
.el .IP "\f(CW\*(C`SUDO_UID\*(C'\fR" 16
.IX Item "SUDO_UID"
-Set to the user \s-1ID\s0 of the user who invoked sudo
+Set to the user \s-1ID\s0 of the user who invoked sudo.
.ie n .IP "\*(C`SUDO_USER\*(C'" 16
.el .IP "\f(CW\*(C`SUDO_USER\*(C'\fR" 16
.IX Item "SUDO_USER"
-Set to the login of the user who invoked sudo
+Set to the login of the user who invoked sudo.
.ie n .IP "\*(C`USER\*(C'" 16
.el .IP "\f(CW\*(C`USER\*(C'\fR" 16
.IX Item "USER"
-Set to the target user (root unless the \fB\-u\fR option is specified)
+Set to the target user (root unless the \fB\-u\fR option is specified).
.ie n .IP "\*(C`VISUAL\*(C'" 16
.el .IP "\f(CW\*(C`VISUAL\*(C'\fR" 16
.IX Item "VISUAL"
Default editor to use in \fB\-e\fR (sudoedit) mode if \f(CW\*(C`SUDO_EDITOR\*(C'\fR
-is not set
+is not set.
.SH "FILES"
.IX Header "FILES"
.ie n .IP "\fI@sysconfdir@/sudoers\fR" 24
The B<-n> (I<non-interactive>) option prevents B<sudo> from prompting
the user for a password. If a password is required for the command
-to run, B<sudo> will display an error messages and exit.
+to run, B<sudo> will display an error message and exit.
=item -P
set or the command matched is C<ALL>, the user may set variables
that would overwise be forbidden. See L<sudoers(5)> for more information.
-=head1 RETURN VALUES
+=head1 EXIT VALUE
Upon successful execution of a program, the exit status from B<sudo>
will simply be the exit status of the program that was executed.
=item C<EDITOR>
Default editor to use in B<-e> (sudoedit) mode if neither C<SUDO_EDITOR>
-nor C<VISUAL> is set
+nor C<VISUAL> is set.
=item C<MAIL>
In B<-i> mode or when I<env_reset> is enabled in I<sudoers>, set
-to the mail spool of the target user
+to the mail spool of the target user.
=item C<HOME>
Set to the home directory of the target user if B<-i> or B<-H> are
specified, I<env_reset> or I<always_set_home> are set in I<sudoers>,
or when the B<-s> option is specified and I<set_home> is set in
-I<sudoers>
+I<sudoers>.
=item C<PATH>
=item C<SHELL>
-Used to determine shell to run with C<-s> option
+Used to determine shell to run with B<-s> option.
=item C<SUDO_ASKPASS>
Specifies the path to a helper program used to read the password
-if no terminal is available or if the C<-A> option is specified.
+if no terminal is available or if the B<-A> option is specified.
=item C<SUDO_COMMAND>
-Set to the command run by sudo
+Set to the command run by sudo.
=item C<SUDO_EDITOR>
-Default editor to use in B<-e> (sudoedit) mode
+Default editor to use in B<-e> (sudoedit) mode.
=item C<SUDO_GID>
-Set to the group ID of the user who invoked sudo
+Set to the group ID of the user who invoked sudo.
=item C<SUDO_PROMPT>
-Used as the default password prompt
+Used as the default password prompt.
=item C<SUDO_PS1>
-If set, C<PS1> will be set to its value for the program being run
+If set, C<PS1> will be set to its value for the program being run.
=item C<SUDO_UID>
-Set to the user ID of the user who invoked sudo
+Set to the user ID of the user who invoked sudo.
=item C<SUDO_USER>
-Set to the login of the user who invoked sudo
+Set to the login of the user who invoked sudo.
=item C<USER>
-Set to the target user (root unless the B<-u> option is specified)
+Set to the target user (root unless the B<-u> option is specified).
=item C<VISUAL>
Default editor to use in B<-e> (sudoedit) mode if C<SUDO_EDITOR>
-is not set
+is not set.
=back
projects / sudo / commitdiff