.TH SU 1
.SH NAME
su \- temporary become superuser or another user
.SH SYNOPSIS
.B su
.RB [ \- [ e ]]
.RI [ user
.RI [ shell-arguments " ...]]"
.SH DESCRIPTION
.de SP
.if t .sp 0.4
.if n .sp
..
.B Su
can be used to temporarily run a shell under the identity of the superuser
or another user.  Unless the caller is a member of the operator group, one
is prompted for the password of the user-to-be.  Calls that need a password
are logged, whether they succeed or not.  The default user is
.BR root .
Further arguments are handed to the shell.  The shell started is the login
shell of the user-to-be, the environment is by default passed on as is.
.SH OPTIONS
.TP
.B \-
Constructs a new environment consisting of the
.BR PATH ,
.BR USER ,
.BR LOGNAME ,
.BR HOME ,
.BR SHELL ,
.BR TERM ,
.BR TERMCAP ,
and
.BR TZ
variables.  The environment is the same as on a normal login, except that
.BR TERM ,
.B TERMCAP
and
.B TZ
are copied from the current environment if set.  The current working
directory is changed to the user home directory, and the shell is started as
a login shell, with the first character a minus sign.
.TP
.B \-e
Like above, but a normal shell is started, not a login shell.
.SH FILES
.TP 25n
/usr/adm/authlog
Log of security related events.
.SH "SEE ALSO"
.BR sh (1),
.BR login (1).
.SH AUTHOR
Kees J. Bot (kjb@cs.vu.nl)