===================================================================
RCS file: /cvsrepo/anoncvs/cvs/src/usr.bin/su/su.1,v
retrieving revision 1.7
retrieving revision 1.8
diff -c -r1.7 -r1.8
*** src/usr.bin/su/su.1	1998/09/27 16:57:54	1.7
--- src/usr.bin/su/su.1	1999/06/05 01:21:41	1.8
***************
*** 1,4 ****
! .\"	$OpenBSD: su.1,v 1.7 1998/09/27 16:57:54 aaron Exp $
  .\" Copyright (c) 1988, 1990 The Regents of the University of California.
  .\" All rights reserved.
  .\"
--- 1,4 ----
! .\"	$OpenBSD: su.1,v 1.8 1999/06/05 01:21:41 aaron Exp $
  .\" Copyright (c) 1988, 1990 The Regents of the University of California.
  .\" All rights reserved.
  .\"
***************
*** 43,49 ****
  .Op Fl Kflm
  .Op Ar login Op Ar "shell arguments"
  .Sh DESCRIPTION
! .Nm su
  requests the Kerberos password for
  .Ar login
  (or for
--- 43,49 ----
  .Op Fl Kflm
  .Op Ar login Op Ar "shell arguments"
  .Sh DESCRIPTION
! .Nm
  requests the Kerberos password for
  .Ar login
  (or for
***************
*** 54,65 ****
  .Ar "shell arguments"
  after the login name
  are passed to the shell.
! .Nm su
  will resort to the local password file to find the password for
  .Ar login
  if there is a Kerberos error or if Kerberos is not installed.
  If
! .Nm su
  is executed by root, no password is requested and a shell
  with the appropriate user ID is executed; no additional Kerberos tickets
  are obtained.
--- 54,65 ----
  .Ar "shell arguments"
  after the login name
  are passed to the shell.
! .Nm
  will resort to the local password file to find the password for
  .Ar login
  if there is a Kerberos error or if Kerberos is not installed.
  If
! .Nm
  is executed by root, no password is requested and a shell
  with the appropriate user ID is executed; no additional Kerberos tickets
  are obtained.
***************
*** 122,128 ****
  .Ev TERM
  is imported from your current environment.
  The invoked shell is the target login's, and
! .Nm su
  will change directory to the target login's home directory.
  .It Fl m
  Leave the environment unmodified.
--- 122,128 ----
  .Ev TERM
  is imported from your current environment.
  The invoked shell is the target login's, and
! .Nm
  will change directory to the target login's home directory.
  .It Fl m
  Leave the environment unmodified.
***************
*** 132,138 ****
  .Xr getusershell 3 )
  and the caller's real UID is
  non-zero,
! .Nm su
  will fail.
  .El
  .Pp
--- 132,138 ----
  .Xr getusershell 3 )
  and the caller's real UID is
  non-zero,
! .Nm
  will fail.
  .El
  .Pp
***************
*** 142,163 ****
  .Fl m
  options are mutually exclusive; the last one specified
  overrides any previous ones.
! .Pp                                                                     
! If the optional                                                              
  .Ar "shell arguments"
! are provided on the command line, they are passed to the login shell of 
  the target login.  This allows it to pass arbitrary commands via
! the                                                                        
! .Fl c                                                                 
  option as understood by most shells.  Note that
! .Fl c                                                                
  usually expects a single argument only; you have to quote it when
! passing multiple words.                               
  .Pp
  If group 0 (normally
  .Dq wheel )
  has users listed then only those users can
! .Nm su
  to
  .Dq root .
  It is not sufficient to change a user's
--- 142,163 ----
  .Fl m
  options are mutually exclusive; the last one specified
  overrides any previous ones.
! .Pp
! If the optional
  .Ar "shell arguments"
! are provided on the command line, they are passed to the login shell of
  the target login.  This allows it to pass arbitrary commands via
! the
! .Fl c
  option as understood by most shells.  Note that
! .Fl c
  usually expects a single argument only; you have to quote it when
! passing multiple words.
  .Pp
  If group 0 (normally
  .Dq wheel )
  has users listed then only those users can
! .Nm
  to
  .Dq root .
  It is not sufficient to change a user's
***************
*** 169,175 ****
  If no one is in the
  .Dq wheel
  group, it is ignored, and anyone who knows the root password is permitted to
! .Nm su
  to
  .Dq root .
  .Pp
--- 169,175 ----
  If no one is in the
  .Dq wheel
  group, it is ignored, and anyone who knows the root password is permitted to
! .Nm
  to
  .Dq root .
  .Pp
***************
*** 177,199 ****
  prompt is set to
  .Dq Sy \&#
  to remind one of its awesome power.
! .Sh EXAMPLES                                   
! .Bl -tag -width 5n -compact                                          
! .It Li "su bin -c makewhatis"                                        
! Runs the command                                      
! .Li makewhatis                                                                  
! as user                                        
! .Li bin .                                                
! You will be asked for bin's password unless your real UID is 0.            
  .Pp
  .It Li "su bin -c 'makewhatis /usr/local/man'"
! Same as above, but the target command consists of more than a              
! single word.                                                                
  .Pp
! .It Li "su -l foo"                                                             
! Pretend a login for user                                                       
! .Li foo .                                                                      
! .El                                                                            
  .Sh SEE ALSO
  .Xr csh 1 ,
  .Xr kerberos 1 ,
--- 177,199 ----
  prompt is set to
  .Dq Sy \&#
  to remind one of its awesome power.
! .Sh EXAMPLES
! .Bl -tag -width 5n -compact
! .It Li "su bin -c makewhatis"
! Runs the command
! .Li makewhatis
! as user
! .Li bin .
! You will be asked for bin's password unless your real UID is 0.
  .Pp
  .It Li "su bin -c 'makewhatis /usr/local/man'"
! Same as above, but the target command consists of more than a
! single word.
  .Pp
! .It Li "su -l foo"
! Pretend a login for user
! .Li foo .
! .El
  .Sh SEE ALSO
  .Xr csh 1 ,
  .Xr kerberos 1 ,
***************
*** 218,224 ****
  user ID.
  .It Ev LOGNAME
  The user ID is always the effective ID (the target user ID) after an
! .Nm su
  unless the user ID is 0 (root).
  .It Ev USER
  Same as
--- 218,224 ----
  user ID.
  .It Ev LOGNAME
  The user ID is always the effective ID (the target user ID) after an
! .Nm
  unless the user ID is 0 (root).
  .It Ev USER
  Same as