Mention what characters need to be escaped in names.

diff --git a/sudoers.cat b/sudoers.cat
index cf256e305e9fa061fa6c6589606bf37517ef9cad..8e177315d56c95c9cb33a157db3101c7c7fce0a4 100644 (file)
--- a/sudoers.cat
+++ b/sudoers.cat
@@ -1,7 +1,7 @@
 
 
 
-SUDOERS(5)                 FILE FORMATS                SUDOERS(5)
+sudoers(5)                 FILE FORMATS                sudoers(5)
 
 
 N\bN\bN\bNA\bA\bA\bAM\bM\bM\bME\bE\bE\bE
@@ -61,13 +61,13 @@ D\bD\bD\bDE\bE\bE\bES\bS\bS\bSC\bC\bC\bCR\bR\bR\bRI\bI\bI\bIP\bP\bP\bPT\bT\bT\bTI\bI\bI\bIO\bO\bO\bON\bN\bN\bN
 
 
 
-11/Oct/1999                    1.6                              1
+8/Nov/1999                     1.6                              1
 
 
 
 
 
-SUDOERS(5)                 FILE FORMATS                SUDOERS(5)
+sudoers(5)                 FILE FORMATS                sudoers(5)
 
 
         Host_Alias ::= NAME '=' Host_List
@@ -127,13 +127,13 @@ SUDOERS(5)                 FILE FORMATS                SUDOERS(5)
 
 
 
-11/Oct/1999                    1.6                              2
+8/Nov/1999                     1.6                              2
 
 
 
 
 
-SUDOERS(5)                 FILE FORMATS                SUDOERS(5)
+sudoers(5)                 FILE FORMATS                sudoers(5)
 
 
         Host ::= '!'* hostname |
@@ -181,7 +181,7 @@ SUDOERS(5)                 FILE FORMATS                SUDOERS(5)
        the user on the command line (or match the wildcards if
        there are any).  Note that the following characters must
        be escaped with a '\' if they are used in command
-       arguments: ',', ':', '=', '\\'.
+       arguments: ',', ':', '=', '\'.
 
        D\bD\bD\bDe\be\be\bef\bf\bf\bfa\ba\ba\bau\bu\bu\bul\bl\bl\blt\bt\bt\bts\bs\bs\bs
 
@@ -193,13 +193,13 @@ SUDOERS(5)                 FILE FORMATS                SUDOERS(5)
 
 
 
-11/Oct/1999                    1.6                              3
+8/Nov/1999                     1.6                              3
 
 
 
 
 
-SUDOERS(5)                 FILE FORMATS                SUDOERS(5)
+sudoers(5)                 FILE FORMATS                sudoers(5)
 
 
        there are conflicting values, the last value on a matching
@@ -259,13 +259,13 @@ SUDOERS(5)                 FILE FORMATS                SUDOERS(5)
 
 
 
-11/Oct/1999                    1.6                              4
+8/Nov/1999                     1.6                              4
 
 
 
 
 
-SUDOERS(5)                 FILE FORMATS                SUDOERS(5)
+sudoers(5)                 FILE FORMATS                sudoers(5)
 
 
        shell_noargs
@@ -325,13 +325,13 @@ SUDOERS(5)                 FILE FORMATS                SUDOERS(5)
 
 
 
-11/Oct/1999                    1.6                              5
+8/Nov/1999                     1.6                              5
 
 
 
 
 
-SUDOERS(5)                 FILE FORMATS                SUDOERS(5)
+sudoers(5)                 FILE FORMATS                sudoers(5)
 
 
                    successfully
@@ -391,13 +391,13 @@ SUDOERS(5)                 FILE FORMATS                SUDOERS(5)
 
 
 
-11/Oct/1999                    1.6                              6
+8/Nov/1999                     1.6                              6
 
 
 
 
 
-SUDOERS(5)                 FILE FORMATS                SUDOERS(5)
+sudoers(5)                 FILE FORMATS                sudoers(5)
 
 
        Runas_Spec in the user specification, a default Runas_Spec
@@ -457,13 +457,13 @@ SUDOERS(5)                 FILE FORMATS                SUDOERS(5)
 
 
 
-11/Oct/1999                    1.6                              7
+8/Nov/1999                     1.6                              7
 
 
 
 
 
-SUDOERS(5)                 FILE FORMATS                SUDOERS(5)
+sudoers(5)                 FILE FORMATS                sudoers(5)
 
 
        [!...]  Matches any character n\bn\bn\bno\bo\bo\bot\bt\bt\bt in the specified range.
@@ -512,25 +512,28 @@ SUDOERS(5)                 FILE FORMATS                SUDOERS(5)
        allow a user to run "all but a few" commands rarely works
        as intended (see SECURITY NOTES below).
 
-       Long lines can be continued with a backslash ('\\') as the
+       Long lines can be continued with a backslash ('\') as the
        last character on the line.
 
        Whitespace between elements in a list as well as specicial
        syntactic characters in a _\bU_\bs_\be_\br _\bS_\bp_\be_\bc_\bi_\bf_\bi_\bc_\ba_\bt_\bi_\bo_\bn ('=', ':',
        '(', ')') is optional.
 
+       The following characters must be escaped with a backslash
 
 
 
+8/Nov/1999                     1.6                              8
 
-11/Oct/1999                    1.6                              8
 
 
 
 
+sudoers(5)                 FILE FORMATS                sudoers(5)
 
-SUDOERS(5)                 FILE FORMATS                SUDOERS(5)
 
+       ('\') when used as part of a word (eg. a username or
+       hostname): '@', '!', '=', ':', ',', '(', ')', '\'.
 
 E\bE\bE\bEX\bX\bX\bXA\bA\bA\bAM\bM\bM\bMP\bP\bP\bPL\bL\bL\bLE\bE\bE\bES\bS\bS\bS
        Below are example _\bs_\bu_\bd_\bo_\be_\br_\bs entries.  Admittedly, some of
@@ -583,20 +586,20 @@ E\bE\bE\bEX\bX\bX\bXA\bA\bA\bAM\bM\bM\bMP\bP\bP\bPL\bL\bL\bLE\bE\bE\bES\bS\bS\bS
         Defaults:millert       !authenticate
         Defaults@SERVERS       log_year, logfile=/var/log/sudo.log
 
-       The _\bU_\bs_\be_\br _\bs_\bp_\be_\bc_\bi_\bf_\bi_\bc_\ba_\bt_\bi_\bo_\bn is the part that actually
-       determines who may run what.
 
 
 
+8/Nov/1999                     1.6                              9
 
-11/Oct/1999                    1.6                              9
 
 
 
 
+sudoers(5)                 FILE FORMATS                sudoers(5)
 
-SUDOERS(5)                 FILE FORMATS                SUDOERS(5)
 
+       The _\bU_\bs_\be_\br _\bs_\bp_\be_\bc_\bi_\bf_\bi_\bc_\ba_\bt_\bi_\bo_\bn is the part that actually
+       determines who may run what.
 
         root           ALL = (ALL) ALL
         %wheel         ALL = (ALL) ALL
@@ -649,21 +652,21 @@ SUDOERS(5)                 FILE FORMATS                SUDOERS(5)
        assumes _\bp_\ba_\bs_\bs_\bw_\bd(1) does not take multiple usernames on the
        command line.
 
-        bob            SPARC = (OP) ALL : SGI = (OP) ALL
 
-       The user b\bb\bb\bbo\bo\bo\bob\bb\bb\bb may run anything on the _\bS_\bP_\bA_\bR_\bC and _\bS_\bG_\bI
 
 
+8/Nov/1999                     1.6                             10
 
-11/Oct/1999                    1.6                             10
 
 
 
 
+sudoers(5)                 FILE FORMATS                sudoers(5)
 
-SUDOERS(5)                 FILE FORMATS                SUDOERS(5)
 
+        bob            SPARC = (OP) ALL : SGI = (OP) ALL
 
+       The user b\bb\bb\bbo\bo\bo\bob\bb\bb\bb may run anything on the _\bS_\bP_\bA_\bR_\bC and _\bS_\bG_\bI
        machines as any user listed in the _\bO_\bP Runas_Alias (r\br\br\bro\bo\bo\boo\bo\bo\bot\bt\bt\bt
        and o\bo\bo\bop\bp\bp\bpe\be\be\ber\br\br\bra\ba\ba\bat\bt\bt\bto\bo\bo\bor\br\br\br).
 
@@ -715,20 +718,19 @@ SUDOERS(5)                 FILE FORMATS                SUDOERS(5)
 
        On the host www, any user in the _\bW_\bE_\bB_\bM_\bA_\bS_\bT_\bE_\bR_\bS User_Alias
        (will, wendy, and wim), may run any command as user www
-       (which owns the web pages) or simply _\bs_\bu(1) to www.
-
 
 
 
+8/Nov/1999                     1.6                             11
 
-11/Oct/1999                    1.6                             11
 
 
 
 
+sudoers(5)                 FILE FORMATS                sudoers(5)
 
-SUDOERS(5)                 FILE FORMATS                SUDOERS(5)
 
+       (which owns the web pages) or simply _\bs_\bu(1) to www.
 
         ALL            CDROM = NOPASSWD: /sbin/umount /CDROM,\
                        /sbin/mount -o nosuid\,nodev /dev/cd0a /CDROM
@@ -785,15 +787,13 @@ S\bS\bS\bSE\bE\bE\bEE\bE\bE\bE A\bA\bA\bAL\bL\bL\bLS\bS\bS\bSO\bO\bO\bO
 
 
 
-
-
-11/Oct/1999                    1.6                             12
+8/Nov/1999                     1.6                             12
 
 
 
 
 
-SUDOERS(5)                 FILE FORMATS                SUDOERS(5)
+sudoers(5)                 FILE FORMATS                sudoers(5)
 
 
 
@@ -853,6 +853,6 @@ SUDOERS(5)                 FILE FORMATS                SUDOERS(5)
 
 
 
-11/Oct/1999                    1.6                             13
+8/Nov/1999                     1.6                             13
 
 

diff --git a/sudoers.html b/sudoers.html
index 075ca36e16a34cbf65cc4a13cb59836f9fa4dac4..c34f50e6a74a1c98bc5da2a69eb9dadfa6582f65 100644 (file)
--- a/sudoers.html
+++ b/sudoers.html
@@ -214,7 +214,7 @@ any subdirectories therein).
 If a <CODE>Cmnd</CODE> has associated command line arguments, then the arguments in the <CODE>Cmnd</CODE> must match exactly those given by the user on the command line (or match
 the wildcards if there are any). Note that the following characters must be
 escaped with a '\' if they are used in command arguments: ',', ':', '=',
-'\\'.
+'\'.
 
 <P>
 <HR>
@@ -562,13 +562,18 @@ An exclamation point ('!') can be used as a logical <EM>not</EM> operator both i
 intended (see SECURITY NOTES below).
 
 <P>
-Long lines can be continued with a backslash ('\\') as the last character
-on the line.
+Long lines can be continued with a backslash ('\') as the last character on
+the line.
 
 <P>
 Whitespace between elements in a list as well as specicial syntactic
 characters in a <EM>User Specification</EM> ('=', ':', '(', ')') is optional.
 
+<P>
+The following characters must be escaped with a backslash ('\') when used
+as part of a word (eg. a username or hostname): '@', '!', '=', ':', ',',
+'(', ')', '\'.
+
 <P>
 <HR>
 <H1><A NAME="EXAMPLES">EXAMPLES</A></H1>

diff --git a/sudoers.man b/sudoers.man
index 9115a487f40817ae253b6c61098b3041b5d4f1f3..46572187bb3f9670791daf9c0e86edd121af6633 100644 (file)
--- a/sudoers.man
+++ b/sudoers.man
@@ -2,8 +2,8 @@
 ''' $RCSfile$$Revision$$Date$
 '''
 ''' $Log$
-''' Revision 1.13  1999/10/20 15:23:42  millert
-''' change ital to bold
+''' Revision 1.14  1999/11/09 00:00:29  millert
+''' Mention what characters need to be escaped in names.
 '''
 '''
 .de Sh
@@ -96,7 +96,7 @@
 .nr % 0
 .rr F
 .\}
-.TH SUDOERS 5 "1.6" "11/Oct/1999" "FILE FORMATS"
+.TH sudoers 5 "1.6" "8/Nov/1999" "FILE FORMATS"
 .UC
 .if n .hy 0
 .if n .na
@@ -346,7 +346,7 @@ If a \f(CWCmnd\fR has associated command line arguments, then the arguments
 in the \f(CWCmnd\fR must match exactly those given by the user on the command line
 (or match the wildcards if there are any).  Note that the following
 characters must be escaped with a \*(L'\e\*(R' if they are used in command
-arguments: \*(L',\*(R', \*(L':\*(R', \*(L'=\*(R', \*(L'\e\e\*(R'.
+arguments: \*(L',\*(R', \*(L':\*(R', \*(L'=\*(R', \*(L'\e\*(R'.
 .Sh "Defaults"
 Certain configuration options may be changed from their default
 values at runtime via one or more \f(CWDefault_Entry\fR lines.  These
@@ -577,11 +577,15 @@ conjunction with the built in \f(CWALL\fR alias to allow a user to
 run \*(L"all but a few\*(R" commands rarely works as intended (see \s-1SECURITY\s0
 \s-1NOTES\s0 below).
 .PP
-Long lines can be continued with a backslash (\*(R'\e\e') as the last
+Long lines can be continued with a backslash (\*(R'\e') as the last
 character on the line.
 .PP
 Whitespace between elements in a list as well as specicial syntactic
 characters in a \fIUser Specification\fR ('=\*(R', \*(L':\*(R', \*(L'(\*(R', \*(L')') is optional.
+.PP
+The following characters must be escaped with a backslash (\*(R'\e') when
+used as part of a word (eg. a username or hostname):
+\&'@\*(R', \*(L'!\*(R', \*(L'=\*(R', \*(L':\*(R', \*(L',\*(R', \*(L'(\*(R', \*(L')\*(R', \*(L'\e\*(R'.
 .SH "EXAMPLES"
 Below are example \fIsudoers\fR entries.  Admittedly, some of
 these are a bit contrived.  First, we define our \fIaliases\fR:
@@ -798,7 +802,7 @@ will not run with a syntactically incorrect \fIsudoers\fR file.
 \fIsudo\fR\|(8), \fIvisudo\fR\|(8), \fIsu\fR\|(1), \fIfnmatch\fR\|(3).
 
 .rn }` ''
-.IX Title "SUDOERS 5"
+.IX Title "sudoers 5"
 .IX Name "sudoers - list of which users may execute what"
 
 .IX Header "NAME"

diff --git a/sudoers.pod b/sudoers.pod
index 0bf596093ff9db766f4ec5c26ed32b4f43f504eb..d7ad822dc64c2535a0eb9c8200edd6bc9321d717 100644 (file)
--- a/sudoers.pod
+++ b/sudoers.pod
@@ -190,7 +190,7 @@ If a C<Cmnd> has associated command line arguments, then the arguments
 in the C<Cmnd> must match exactly those given by the user on the command line
 (or match the wildcards if there are any).  Note that the following
 characters must be escaped with a '\' if they are used in command
-arguments: ',', ':', '=', '\\'.
+arguments: ',', ':', '=', '\'.
 
 =head2 Defaults
 
@@ -532,12 +532,16 @@ conjunction with the built in C<ALL> alias to allow a user to
 run "all but a few" commands rarely works as intended (see SECURITY
 NOTES below).
 
-Long lines can be continued with a backslash ('\\') as the last
+Long lines can be continued with a backslash ('\') as the last
 character on the line.
 
 Whitespace between elements in a list as well as specicial syntactic
 characters in a I<User Specification> ('=', ':', '(', ')') is optional.
 
+The following characters must be escaped with a backslash ('\') when
+used as part of a word (eg. a username or hostname):
+'@', '!', '=', ':', ',', '(', ')', '\'.
+
 =head1 EXAMPLES
 
 Below are example I<sudoers> entries.  Admittedly, some of