59 lines
1.4 KiB
Groff
59 lines
1.4 KiB
Groff
|
.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. By default the shell started is
|
||
|
|
the shell of the invoker, and the environment is passed on as is.
|
||
|
|
.PP
|
||
|
|
The activities of
|
||
|
|
.B su
|
||
|
|
are logged through
|
||
|
|
.BR syslog (3)
|
||
|
|
under Minix-vmd.
|
||
|
|
.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, the shell of the user-to-be
|
||
|
|
is run, and it is started as a login shell, with the first character a minus
|
||
|
|
sign.
|
||
|
|
.TP
|
||
|
|
.B \-e
|
||
|
|
Like above, but the shell is started normally, not as a login shell.
|
||
|
|
.SH "SEE ALSO"
|
||
|
|
.BR sh (1),
|
||
|
|
.BR login (1),
|
||
|
|
.BR syslog (3).
|
||
|
|
.SH AUTHOR
|
||
|
|
Kees J. Bot <kjb@cs.vu.nl>
|