X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=visudo.man.in;h=563fd3bcebd6363e1d5c2dc8328019e3b1178650;hb=f77e86575347d9b13db3615e7640c84dceafb0eb;hp=0cc7b8fbcfdcf8c843540646ed27498a9845af7b;hpb=967e372b4817accfd07afe09c8934052beed1a2c;p=debian%2Fsudo diff --git a/visudo.man.in b/visudo.man.in index 0cc7b8f..563fd3b 100644 --- a/visudo.man.in +++ b/visudo.man.in @@ -1,4 +1,4 @@ -.\" Copyright (c) 1996,1998-2005, 2007-2008 +.\" Copyright (c) 1996,1998-2005, 2007-2010 .\" Todd C. Miller .\" .\" Permission to use, copy, modify, and distribute this software for any @@ -18,19 +18,10 @@ .\" Agency (DARPA) and Air Force Research Laboratory, Air Force .\" Materiel Command, USAF, under agreement number F39502-99-1-0512. .\" -.\" $Sudo: visudo.man.in,v 1.34 2009/06/11 20:29:12 millert Exp $ -.\" Automatically generated by Pod::Man 2.16 (Pod::Simple 3.05) +.\" Automatically generated by Pod::Man 2.22 (Pod::Simple 3.07) .\" .\" Standard preamble: .\" ======================================================================== -.de Sh \" Subsection heading -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp @@ -74,7 +65,7 @@ .el .ds Aq ' .\" .\" If the F register is turned on, we'll generate index entries on stderr for -.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index +.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .ie \nF \{\ @@ -153,7 +144,7 @@ .\" ======================================================================== .\" .IX Title "VISUDO @mansectsu@" -.TH VISUDO @mansectsu@ "June 11, 2009" "1.7.2" "MAINTENANCE COMMANDS" +.TH VISUDO @mansectsu@ "July 14, 2010" "1.7.4" "MAINTENANCE COMMANDS" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l @@ -171,21 +162,16 @@ simultaneous edits, provides basic sanity checks, and checks for parse errors. If the \fIsudoers\fR file is currently being edited you will receive a message to try again later. .PP -There is a hard-coded list of editors that \fBvisudo\fR will use set -at compile-time that may be overridden via the \fIeditor\fR \fIsudoers\fR -\&\f(CW\*(C`Default\*(C'\fR variable. -On Debian systems, this list defaults to /usr/bin/editor, which is meant to -be a system-wide default editor chosen through the alternatives system. -Normally, \&\fBvisudo\fR does not honor the \f(CW\*(C`VISUAL\*(C'\fR or -\f(CW\*(C`EDITOR\*(C'\fR environment +There is a hard-coded list of one or more editors that \fBvisudo\fR will +use set at compile-time that may be overridden via the \fIeditor\fR \fIsudoers\fR +\&\f(CW\*(C`Default\*(C'\fR variable. This list defaults to \f(CW"@editor@"\fR. Normally, +\&\fBvisudo\fR does not honor the \f(CW\*(C`VISUAL\*(C'\fR or \f(CW\*(C`EDITOR\*(C'\fR environment variables unless they contain an editor in the aforementioned editors -list. However, if \fBvisudo\fR is configured with the \fI\-\-with\-enveditor\fR +list. However, if \fBvisudo\fR is configured with the \fI\-\-with\-env\-editor\fR option or the \fIenv_editor\fR \f(CW\*(C`Default\*(C'\fR variable is set in \fIsudoers\fR, \&\fBvisudo\fR will use any the editor defines by \f(CW\*(C`VISUAL\*(C'\fR or \f(CW\*(C`EDITOR\*(C'\fR. Note that this can be a security hole since it allows the user to execute any program they wish simply by setting \f(CW\*(C`VISUAL\*(C'\fR or \f(CW\*(C`EDITOR\*(C'\fR. -Despite this potential risk, sudo on Debian is compiled with the -\fI\-\-with\-enveditor\fR flag. .PP \&\fBvisudo\fR parses the \fIsudoers\fR file after the edit and will not save the changes if there is a syntax error. Upon finding @@ -227,7 +213,7 @@ the \fB\-c\fR option. Enable \fBstrict\fR checking of the \fIsudoers\fR file. If an alias is used before it is defined, \fBvisudo\fR will consider this a parse error. Note that it is not possible to differentiate between an -alias and a hostname or username that consists solely of uppercase +alias and a host name or user name that consists solely of uppercase letters, digits, and the underscore ('_') character. .IP "\-V" 12 .IX Item "-V" @@ -270,7 +256,7 @@ Your userid does not appear in the system passwd file. .IP "Warning: {User,Runas,Host,Cmnd}_Alias referenced but not defined" 4 .IX Item "Warning: {User,Runas,Host,Cmnd}_Alias referenced but not defined" Either you are trying to use an undeclare {User,Runas,Host,Cmnd}_Alias -or you have a user or hostname listed that consists solely of +or you have a user or host name listed that consists solely of uppercase letters, digits, and the underscore ('_') character. In the latter case, you can ignore the warnings (\fBsudo\fR will not complain). In \fB\-s\fR (strict) mode these are errors, not warnings.