Merge branch 'upstream'
[debian/sudo] / sudo.cat
index 2fc093328f9fa04a47a5de46f1adc4073b7373a5..1bb8ece41eb622d3caf1ac091f32476a2ab26f96 100644 (file)
--- a/sudo.cat
+++ b/sudo.cat
@@ -61,7 +61,11 @@ D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
 
 
 
-1.6.9p6                  October  9, 2007                       1
+<<<<<<< HEAD:sudo.cat
+1.6.9p15                  March 23, 2008                        1
+=======
+1.6.9p16                   May  8, 2008                         1
+>>>>>>> 17fe41bae8a65fb88683c9795414556ed9b636e9:sudo.cat
 
 
 
@@ -127,7 +131,11 @@ O\bOP\bPT\bTI\bIO\bON\bNS\bS
 
 
 
-1.6.9p6                  October  9, 2007                       2
+<<<<<<< HEAD:sudo.cat
+1.6.9p15                  March 23, 2008                        2
+=======
+1.6.9p16                   May  8, 2008                         2
+>>>>>>> 17fe41bae8a65fb88683c9795414556ed9b636e9:sudo.cat
 
 
 
@@ -193,7 +201,11 @@ SUDO(1m)               MAINTENANCE COMMANDS              SUDO(1m)
 
 
 
-1.6.9p6                  October  9, 2007                       3
+<<<<<<< HEAD:sudo.cat
+1.6.9p15                  March 23, 2008                        3
+=======
+1.6.9p16                   May  8, 2008                         3
+>>>>>>> 17fe41bae8a65fb88683c9795414556ed9b636e9:sudo.cat
 
 
 
@@ -222,6 +234,10 @@ SUDO(1m)               MAINTENANCE COMMANDS              SUDO(1m)
            %h  expanded to the local hostname without the domain
                name
 
+           %p  expanded to the user whose password is being asked
+               for (respects the _\br_\bo_\bo_\bt_\bp_\bw, _\bt_\ba_\br_\bg_\be_\bt_\bp_\bw and _\br_\bu_\bn_\ba_\bs_\bp_\bw
+               flags in _\bs_\bu_\bd_\bo_\be_\br_\bs)
+
            %U  expanded to the login name of the user the command
                will be run as (defaults to root)
 
@@ -253,13 +269,13 @@ SUDO(1m)               MAINTENANCE COMMANDS              SUDO(1m)
            defaults s\bsu\bud\bdo\bo was compiled with as well as the
            machine's local network addresses.
 
-       -v  If given the -\b-v\bv (_\bv_\ba_\bl_\bi_\bd_\ba_\bt_\be) option, s\bsu\bud\bdo\bo will update
-           the user's timestamp, prompting for the user's pass­
-           word if necessary.  This extends the s\bsu\bud\bdo\bo timeout for
-
 
 
-1.6.9p6                  October  9, 2007                       4
+<<<<<<< HEAD:sudo.cat
+1.6.9p15                  March 23, 2008                        4
+=======
+1.6.9p16                   May  8, 2008                         4
+>>>>>>> 17fe41bae8a65fb88683c9795414556ed9b636e9:sudo.cat
 
 
 
@@ -268,6 +284,9 @@ SUDO(1m)               MAINTENANCE COMMANDS              SUDO(1m)
 SUDO(1m)               MAINTENANCE COMMANDS              SUDO(1m)
 
 
+       -v  If given the -\b-v\bv (_\bv_\ba_\bl_\bi_\bd_\ba_\bt_\be) option, s\bsu\bud\bdo\bo will update
+           the user's timestamp, prompting for the user's pass­
+           word if necessary.  This extends the s\bsu\bud\bdo\bo timeout for
            another 5 minutes (or whatever the timeout is set to
            in _\bs_\bu_\bd_\bo_\be_\br_\bs) but does not run a command.
 
@@ -281,9 +300,10 @@ SUDO(1m)               MAINTENANCE COMMANDS              SUDO(1m)
        passed on the command line are subject to the same
        restrictions as normal environment variables with one
        important exception.  If the _\bs_\be_\bt_\be_\bn_\bv option is set in _\bs_\bu_\bd_\bo_\b­
-       _\be_\br_\bs or the command to be run has the SETENV tag set the
-       user may set variables that would overwise be forbidden.
-       See _\bs_\bu_\bd_\bo_\be_\br_\bs(4) for more information.
+       _\be_\br_\bs, the command to be run has the SETENV tag set or the
+       command 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
        Upon successful execution of a program, the return value
@@ -317,15 +337,15 @@ S\bSE\bEC\bCU\bUR\bRI\bIT\bTY\bY N\bNO\bOT\bTE\bES\bS
 
        If, however, the _\be_\bn_\bv_\b__\br_\be_\bs_\be_\bt option is disabled in _\bs_\bu_\bd_\bo_\be_\br_\bs,
        any variables not explicitly denied by the _\be_\bn_\bv_\b__\bc_\bh_\be_\bc_\bk and
-       _\be_\bn_\bv_\b__\bd_\be_\bl_\be_\bt_\be options are inherited from the invoking pro­
-       cess.  In this case, _\be_\bn_\bv_\b__\bc_\bh_\be_\bc_\bk and _\be_\bn_\bv_\b__\bd_\be_\bl_\be_\bt_\be behave like
-       a blacklist.  Since it is not possible to blacklist all
-       potentially dangerous environment variables, use of the
-       default _\be_\bn_\bv_\b__\br_\be_\bs_\be_\bt behavior is encouraged.
+       _\be_\bn_\bv_\b__\bd_\be_\bl_\be_\bt_\be options are inherited from the invoking
 
 
 
-1.6.9p6                  October  9, 2007                       5
+<<<<<<< HEAD:sudo.cat
+1.6.9p15                  March 23, 2008                        5
+=======
+1.6.9p16                   May  8, 2008                         5
+>>>>>>> 17fe41bae8a65fb88683c9795414556ed9b636e9:sudo.cat
 
 
 
@@ -334,6 +354,11 @@ S\bSE\bEC\bCU\bUR\bRI\bIT\bTY\bY N\bNO\bOT\bTE\bES\bS
 SUDO(1m)               MAINTENANCE COMMANDS              SUDO(1m)
 
 
+       process.  In this case, _\be_\bn_\bv_\b__\bc_\bh_\be_\bc_\bk and _\be_\bn_\bv_\b__\bd_\be_\bl_\be_\bt_\be behave
+       like a blacklist.  Since it is not possible to blacklist
+       all potentially dangerous environment variables, use of
+       the default _\be_\bn_\bv_\b__\br_\be_\bs_\be_\bt behavior is encouraged.
+
        In all cases, environment variables with a value beginning
        with () are removed as they could be interpreted as b\bba\bas\bsh\bh
        functions.  The list of environment variables that s\bsu\bud\bdo\bo
@@ -383,15 +408,14 @@ SUDO(1m)               MAINTENANCE COMMANDS              SUDO(1m)
        timestamp with a bogus date on systems that allow users to
        give away files.
 
-       Please note that s\bsu\bud\bdo\bo will normally only log the command
-       it explicitly runs.  If a user runs a command such as sudo
-       su or sudo sh, subsequent commands run from that shell
-       will _\bn_\bo_\bt be logged, nor will s\bsu\bud\bdo\bo's access control affect
-       them.  The same is true for commands that offer shell
 
 
 
-1.6.9p6                  October  9, 2007                       6
+<<<<<<< HEAD:sudo.cat
+1.6.9p15                  March 23, 2008                        6
+=======
+1.6.9p16                   May  8, 2008                         6
+>>>>>>> 17fe41bae8a65fb88683c9795414556ed9b636e9:sudo.cat
 
 
 
@@ -400,6 +424,11 @@ SUDO(1m)               MAINTENANCE COMMANDS              SUDO(1m)
 SUDO(1m)               MAINTENANCE COMMANDS              SUDO(1m)
 
 
+       Please note that s\bsu\bud\bdo\bo will normally only log the command
+       it explicitly runs.  If a user runs a command such as sudo
+       su or sudo sh, subsequent commands run from that shell
+       will _\bn_\bo_\bt be logged, nor will s\bsu\bud\bdo\bo's access control affect
+       them.  The same is true for commands that offer shell
        escapes (including most editors).  Because of this, care
        must be taken when giving users access to commands via
        s\bsu\bud\bdo\bo to verify that the command does not inadvertently
@@ -445,19 +474,18 @@ E\bEN\bNV\bVI\bIR\bRO\bON\bNM\bME\bEN\bNT\bT
                        mode
 
 F\bFI\bIL\bLE\bES\bS
-       _\b/_\be_\bt_\bc_\b/_\bs_\bu_\bd_\bo_\be_\br_\bs        List of who can run what
-       _\b/_\bv_\ba_\br_\b/_\br_\bu_\bn_\b/_\bs_\bu_\bd_\bo       Directory containing timestamps
-
-E\bEX\bXA\bAM\bMP\bPL\bLE\bES\bS
-       Note: the following examples assume suitable _\bs_\bu_\bd_\bo_\be_\br_\bs(4)
-       entries.
+       _\b/_\be_\bt_\bc_\b/_\bs_\bu_\bd_\bo_\be_\br_\bs            List of who can run what
 
-       To get a file listing of an unreadable directory:
+       _\b/_\bv_\ba_\br_\b/_\br_\bu_\bn_\b/_\bs_\bu_\bd_\bo           Directory containing timestamps
 
 
 
 
-1.6.9p6                  October  9, 2007                       7
+<<<<<<< HEAD:sudo.cat
+1.6.9p15                  March 23, 2008                        7
+=======
+1.6.9p16                   May  8, 2008                         7
+>>>>>>> 17fe41bae8a65fb88683c9795414556ed9b636e9:sudo.cat
 
 
 
@@ -466,6 +494,12 @@ E\bEX\bXA\bAM\bMP\bPL\bLE\bES\bS
 SUDO(1m)               MAINTENANCE COMMANDS              SUDO(1m)
 
 
+E\bEX\bXA\bAM\bMP\bPL\bLE\bES\bS
+       Note: the following examples assume suitable _\bs_\bu_\bd_\bo_\be_\br_\bs(4)
+       entries.
+
+       To get a file listing of an unreadable directory:
+
         $ sudo ls /usr/local/protected
 
        To list the home directory of user yazza on a machine
@@ -490,7 +524,7 @@ SUDO(1m)               MAINTENANCE COMMANDS              SUDO(1m)
 
 S\bSE\bEE\bE A\bAL\bLS\bSO\bO
        _\bg_\br_\be_\bp(1), _\bs_\bu(1), _\bs_\bt_\ba_\bt(2), _\bl_\bo_\bg_\bi_\bn_\b__\bc_\ba_\bp(3), _\bp_\ba_\bs_\bs_\bw_\bd(4),
-       _\bs_\bu_\bd_\bo_\be_\br_\bs(4), _\bv_\bi_\bs_\bu_\bd_\bo(1m)
+       _\bs_\bu_\bd_\bo_\be_\br_\bs(5), _\bv_\bi_\bs_\bu_\bd_\bo(1m)
 
 A\bAU\bUT\bTH\bHO\bOR\bRS\bS
        Many people have worked on s\bsu\bud\bdo\bo over the years; this ver­
@@ -515,22 +549,26 @@ C\bCA\bAV\bVE\bEA\bAT\bTS\bS
        It is not meaningful to run the cd command directly via
        sudo, e.g.,
 
-        $ sudo cd /usr/local/protected
 
-       since when the command exits the parent process (your
-       shell) will still be the same.  Please see the EXAMPLES
-       section for more information.
 
+<<<<<<< HEAD:sudo.cat
+1.6.9p15                  March 23, 2008                        8
+=======
+1.6.9p16                   May  8, 2008                         8
+>>>>>>> 17fe41bae8a65fb88683c9795414556ed9b636e9:sudo.cat
 
 
-1.6.9p6                  October  9, 2007                       8
 
 
 
+SUDO(1m)               MAINTENANCE COMMANDS              SUDO(1m)
 
 
-SUDO(1m)               MAINTENANCE COMMANDS              SUDO(1m)
+        $ sudo cd /usr/local/protected
 
+       since when the command exits the parent process (your
+       shell) will still be the same.  Please see the EXAMPLES
+       section for more information.
 
        If users have sudo ALL there is nothing to prevent them
        from creating their own program that gives them a root
@@ -583,12 +621,10 @@ D\bDI\bIS\bSC\bCL\bLA\bAI\bIM\bME\bER\bR
 
 
 
-
-
-
-
-
-
-1.6.9p6                  October  9, 2007                       9
+<<<<<<< HEAD:sudo.cat
+1.6.9p15                  March 23, 2008                        9
+=======
+1.6.9p16                   May  8, 2008                         9
+>>>>>>> 17fe41bae8a65fb88683c9795414556ed9b636e9:sudo.cat