SU(1)               UNIX Programmer's Manual                SU(1)

NAME
     su  -  substitute user id temporarily

SYNTAX
     su [ - ] [ userid ]

DESCRIPTION
     _S_u demands the password of the specified _u_s_e_r_i_d, and if it
     is given, changes to that _u_s_e_r_i_d and invokes a shell without
     changing the current directory or the user environment.  The
     new user ID stays in force until the shell exits.  If the
     `SHELL' environment variable is set, it is used as the name
     of the new shell, and, if necessary, the previous user
     environment is restored for that shell. This allows for the
     use of multiple shells with _s_u.  If the optional - flag is
     given, the shell of the specified user will be the new
     shell, the environment is set as for that user, and the new
     shell is started in the new home directory.  This can be
     used to simulate the login environment of a specified user.

     If no _u_s_e_r_i_d is specified, `root' is assumed.  To remind the
     super-user of his responsibilities, the shell substitutes
     `#' for its usual prompt.

SEE ALSO
     csh(1), newgrp(1), sh(1)

Printed 5/16/83                                                 1