document -S flag
authorTodd C. Miller <Todd.Miller@courtesan.com>
Sun, 27 Feb 2000 03:56:41 +0000 (03:56 +0000)
committerTodd C. Miller <Todd.Miller@courtesan.com>
Sun, 27 Feb 2000 03:56:41 +0000 (03:56 +0000)
sudo.cat
sudo.man
sudo.pod

index ed0d4187b382848aee2bd0ef2804f66377e0d974..99cde97ef0a3eea41c9ab6628e83fc85565cdb9b 100644 (file)
--- a/sudo.cat
+++ b/sudo.cat
@@ -8,8 +8,8 @@ N\bN\bN\bNA\bA\bA\bAM\bM\bM\bME\bE\bE\bE
        sudo - execute a command as another user
 
 S\bS\bS\bSY\bY\bY\bYN\bN\bN\bNO\bO\bO\bOP\bP\bP\bPS\bS\bS\bSI\bI\bI\bIS\bS\bS\bS
-       s\bs\bs\bsu\bu\bu\bud\bd\bd\bdo\bo\bo\bo -\b-\b-\b-V\bV\bV\bV | -\b-\b-\b-h\bh\bh\bh | -\b-\b-\b-l\bl\bl\bl | -\b-\b-\b-L\bL\bL\bL | -\b-\b-\b-v\bv\bv\bv | -\b-\b-\b-k\bk\bk\bk | -\b-\b-\b-K\bK\bK\bK | -\b-\b-\b-s\bs\bs\bs | -\b-\b-\b-H\bH\bH\bH | [ -\b-\b-\b-b\bb\bb\bb ] |
-       [ -\b-\b-\b-p\bp\bp\bp prompt ] [ -\b-\b-\b-u\bu\bu\bu username/#uid] _\bc_\bo_\bm_\bm_\ba_\bn_\bd
+       s\bs\bs\bsu\bu\bu\bud\bd\bd\bdo\bo\bo\bo -\b-\b-\b-V\bV\bV\bV | -\b-\b-\b-h\bh\bh\bh | -\b-\b-\b-l\bl\bl\bl | -\b-\b-\b-L\bL\bL\bL | -\b-\b-\b-v\bv\bv\bv | -\b-\b-\b-k\bk\bk\bk | -\b-\b-\b-K\bK\bK\bK | -\b-\b-\b-s\bs\bs\bs | [ -\b-\b-\b-H\bH\bH\bH ] [-\b-\b-\b-S\bS\bS\bS ]
+       [ -\b-\b-\b-b\bb\bb\bb ] | [ -\b-\b-\b-p\bp\bp\bp prompt ] [ -\b-\b-\b-u\bu\bu\bu username/#uid ] _\bc_\bo_\bm_\bm_\ba_\bn_\bd
 
 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
        s\bs\bs\bsu\bu\bu\bud\bd\bd\bdo\bo\bo\bo allows a permitted user to execute a _\bc_\bo_\bm_\bm_\ba_\bn_\bd as the
@@ -61,7 +61,7 @@ O\bO\bO\bOP\bP\bP\bPT\bT\bT\bTI\bI\bI\bIO\bO\bO\bON\bN\bN\bNS\bS\bS\bS
 
 
 
-15/Feb/2000                   1.6.3                             1
+26/Feb/2000                   1.6.3                             1
 
 
 
@@ -115,19 +115,19 @@ sudo(8)                MAINTENANCE COMMANDS               sudo(8)
            default) as specified in _\bp_\ba_\bs_\bs_\bw_\bd(5).  By default, s\bs\bs\bsu\bu\bu\bud\bd\bd\bdo\bo\bo\bo
            does not modify _\bH_\bO_\bM_\bE.
 
+       -S  The -S (_\bs_\bt_\bd_\bi_\bn) option causes s\bs\bs\bsu\bu\bu\bud\bd\bd\bdo\bo\bo\bo to read the password
+           from standard input instead of the terminal device.
+
        --  The -- flag indicates that s\bs\bs\bsu\bu\bu\bud\bd\bd\bdo\bo\bo\bo should stop processing
            command line arguments.  It is most useful in
            conjunction with the -s flag.
 
 R\bR\bR\bRE\bE\bE\bET\bT\bT\bTU\bU\bU\bUR\bR\bR\bRN\bN\bN\bN V\bV\bV\bVA\bA\bA\bAL\bL\bL\bLU\bU\bU\bUE\bE\bE\bES\bS\bS\bS
        s\bs\bs\bsu\bu\bu\bud\bd\bd\bdo\bo\bo\bo quits with an exit value of 1 if there is a
-       configuration/permission problem or if s\bs\bs\bsu\bu\bu\bud\bd\bd\bdo\bo\bo\bo cannot execute
-       the given command.  In the latter case the error string is
-       printed to stderr.  If s\bs\bs\bsu\bu\bu\bud\bd\bd\bdo\bo\bo\bo cannot _\bs_\bt_\ba_\bt(2) one or more
 
 
 
-15/Feb/2000                   1.6.3                             2
+26/Feb/2000                   1.6.3                             2
 
 
 
@@ -136,6 +136,9 @@ R\bR\bR\bRE\bE\bE\bET\bT\bT\bTU\bU\bU\bUR\bR\bR\bRN\bN\bN\bN V\bV\bV\bVA\bA\bA\bAL\bL\bL\bLU\bU\bU\bUE\bE\bE\bES\b
 sudo(8)                MAINTENANCE COMMANDS               sudo(8)
 
 
+       configuration/permission problem or if s\bs\bs\bsu\bu\bu\bud\bd\bd\bdo\bo\bo\bo cannot execute
+       the given command.  In the latter case the error string is
+       printed to stderr.  If s\bs\bs\bsu\bu\bu\bud\bd\bd\bdo\bo\bo\bo cannot _\bs_\bt_\ba_\bt(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 not really a
        directory, the entry is ignored and no error is printed.)
@@ -188,12 +191,9 @@ S\bS\bS\bSE\bE\bE\bEC\bC\bC\bCU\bU\bU\bUR\bR\bR\bRI\bI\bI\bIT\bT\bT\bTY\bY\bY\bY N\bN\bN\bNO\bO\bO\bOT\bT\bT\bTE\b
        instance) or create /tmp/.odus with the appropriate owner
        (root) and permissions (0700) in the system startup files.
 
-       s\bs\bs\bsu\bu\bu\bud\bd\bd\bdo\bo\bo\bo will not honor timestamps set far in the future.
-       Timestamps with a date greater than current_time + 2 *
-
 
 
-15/Feb/2000                   1.6.3                             3
+26/Feb/2000                   1.6.3                             3
 
 
 
@@ -202,6 +202,8 @@ S\bS\bS\bSE\bE\bE\bEC\bC\bC\bCU\bU\bU\bUR\bR\bR\bRI\bI\bI\bIT\bT\bT\bTY\bY\bY\bY N\bN\bN\bNO\bO\bO\bOT\bT\bT\bTE\b
 sudo(8)                MAINTENANCE COMMANDS               sudo(8)
 
 
+       s\bs\bs\bsu\bu\bu\bud\bd\bd\bdo\bo\bo\bo will not honor timestamps set far in the future.
+       Timestamps with a date greater than current_time + 2 *
        TIMEOUT will be ignored and sudo will log and complain.
        This is done to keep a user from creating his/her own
        timestamp with a bogus date on system that allow users to
@@ -254,12 +256,10 @@ E\bE\bE\bEN\bN\bN\bNV\bV\bV\bVI\bI\bI\bIR\bR\bR\bRO\bO\bO\bON\bN\bN\bNM\bM\bM\bME\bE\bE\bEN\bN\bN\bNT\bT\bT\bT
         SUDO_PS1               If set, PS1 will be set to its value
 
 
-F\bF\bF\bFI\bI\bI\bIL\bL\bL\bLE\bE\bE\bES\bS\bS\bS
-
 
 
 
-15/Feb/2000                   1.6.3                             4
+26/Feb/2000                   1.6.3                             4
 
 
 
@@ -268,6 +268,7 @@ F\bF\bF\bFI\bI\bI\bIL\bL\bL\bLE\bE\bE\bES\bS\bS\bS
 sudo(8)                MAINTENANCE COMMANDS               sudo(8)
 
 
+F\bF\bF\bFI\bI\bI\bIL\bL\bL\bLE\bE\bE\bES\bS\bS\bS
         /etc/sudoers           List of who can run what
         /var/run/sudo          Directory containing timestamps
 
@@ -321,11 +322,10 @@ C\bC\bC\bCA\bA\bA\bAV\bV\bV\bVE\bE\bE\bEA\bA\bA\bAT\bT\bT\bTS\bS\bS\bS
        escapes.
 
        If users have sudo ALL there is nothing to prevent them
-       from creating their own program that gives them a root
 
 
 
-15/Feb/2000                   1.6.3                             5
+26/Feb/2000                   1.6.3                             5
 
 
 
@@ -334,6 +334,7 @@ C\bC\bC\bCA\bA\bA\bAV\bV\bV\bVE\bE\bE\bEA\bA\bA\bAT\bT\bT\bTS\bS\bS\bS
 sudo(8)                MAINTENANCE COMMANDS               sudo(8)
 
 
+       from creating their own program that gives them a root
        shell regardless of any '!'  elements in the user
        specification.
 
@@ -390,7 +391,6 @@ S\bS\bS\bSE\bE\bE\bEE\bE\bE\bE A\bA\bA\bAL\bL\bL\bLS\bS\bS\bSO\bO\bO\bO
 
 
 
-
-15/Feb/2000                   1.6.3                             6
+26/Feb/2000                   1.6.3                             6
 
 
index ef1157fe78df19622f42f01b3b39657c3626e18f..81f6bfdb3a82098b44951e311d59062c310f6fd7 100644 (file)
--- a/sudo.man
+++ b/sudo.man
@@ -2,8 +2,8 @@
 ''' $RCSfile$$Revision$$Date$
 '''
 ''' $Log$
-''' Revision 1.44  2000/02/16 00:07:28  millert
-''' crank versino to 1.6.3
+''' Revision 1.45  2000/02/27 03:56:40  millert
+''' document -S flag
 '''
 '''
 .de Sh
@@ -96,7 +96,7 @@
 .nr % 0
 .rr F
 .\}
-.TH sudo 8 "1.6.3" "15/Feb/2000" "MAINTENANCE COMMANDS"
+.TH sudo 8 "1.6.3" "26/Feb/2000" "MAINTENANCE COMMANDS"
 .UC
 .if n .hy 0
 .if n .na
 .SH "NAME"
 sudo \- execute a command as another user
 .SH "SYNOPSIS"
-\fBsudo\fR \fB\-V\fR | \fB\-h\fR | \fB\-l\fR | \fB\-L\fR | \fB\-v\fR | \fB\-k\fR | \fB\-K\fR | \fB\-s\fR | \fB\-H\fR |
-[ \fB\-b\fR ] | [ \fB\-p\fR prompt ] [ \fB\-u\fR username/#uid] \fIcommand\fR
+\fBsudo\fR \fB\-V\fR | \fB\-h\fR | \fB\-l\fR | \fB\-L\fR | \fB\-v\fR | \fB\-k\fR | \fB\-K\fR | \fB\-s\fR |
+[ \fB\-H\fR ] [\fB\-S\fR ] [ \fB\-b\fR ] | [ \fB\-p\fR prompt ]
+[ \fB\-u\fR username/#uid ] \fIcommand\fR
 .SH "DESCRIPTION"
 \fBsudo\fR allows a permitted user to execute a \fIcommand\fR as the
 superuser or another user, as specified in the sudoers file.  The
@@ -275,6 +276,9 @@ in \fIpasswd\fR\|(5).
 The \f(CW-H\fR (\fI\s-1HOME\s0\fR) option sets the \fI\s-1HOME\s0\fR environment variable
 to the homedir of the target user (root by default) as specified
 in \fIpasswd\fR\|(5).  By default, \fBsudo\fR does not modify \fI\s-1HOME\s0\fR.
+.Ip "-S" 4
+The \f(CW-S\fR (\fIstdin\fR) option causes \fBsudo\fR to read the password from
+standard input instead of the terminal device.
 .Ip "--" 4
 The \f(CW--\fR flag indicates that \fBsudo\fR should stop processing command
 line arguments.  It is most useful in conjunction with the \f(CW-s\fR flag.
@@ -482,6 +486,8 @@ are generally safe).
 
 .IX Item "-H"
 
+.IX Item "-S"
+
 .IX Item "--"
 
 .IX Header "RETURN VALUES"
index c92cd300039aa4f9a3c23f6e33ea255890048eab..9169e88268448f5e3ba570a1d152abffa43ade31 100644 (file)
--- a/sudo.pod
+++ b/sudo.pod
@@ -41,8 +41,9 @@ sudo - execute a command as another user
 
 =head1 SYNOPSIS
 
-B<sudo> B<-V> | B<-h> | B<-l> | B<-L> | B<-v> | B<-k> | B<-K> | B<-s> | B<-H> |
-[ B<-b> ] | [ B<-p> prompt ] [ B<-u> username/#uid] I<command>
+B<sudo> B<-V> | B<-h> | B<-l> | B<-L> | B<-v> | B<-k> | B<-K> | B<-s> |
+[ B<-H> ] [B<-S> ] [ B<-b> ] | [ B<-p> prompt ]
+[ B<-u> username/#uid ] I<command>
 
 =head1 DESCRIPTION
 
@@ -154,6 +155,11 @@ The C<-H> (I<HOME>) option sets the I<HOME> environment variable
 to the homedir of the target user (root by default) as specified
 in passwd(5).  By default, B<sudo> does not modify I<HOME>.
 
+=item -S
+
+The C<-S> (I<stdin>) option causes B<sudo> to read the password from
+standard input instead of the terminal device.
+
 =item --
 
 The C<--> flag indicates that B<sudo> should stop processing command