2015-02-02 12:34:26 -05:00
|
|
|
.Dd February 2, 2015
|
|
|
|
|
.Dt SU 1
|
|
|
|
|
.Os ubase
|
|
|
|
|
.Sh NAME
|
|
|
|
|
.Nm su
|
|
|
|
|
.Nd run a command with a substitute user and group ID
|
|
|
|
|
.Sh SYNOPSIS
|
|
|
|
|
.Nm
|
|
|
|
|
.Op Fl lp
|
|
|
|
|
.Op Ar username
|
|
|
|
|
.Sh DESCRIPTION
|
|
|
|
|
.Nm
|
|
|
|
|
allows to run commands with a substitute user and group ID. When called
|
|
|
|
|
without arguments,
|
|
|
|
|
.Nm
|
|
|
|
|
defaults to running an interactive shell as root. For backward compatibility
|
|
|
|
|
.Nm
|
|
|
|
|
defaults to not change the current directory and to only set the environment
|
|
|
|
|
variables
|
|
|
|
|
.Ev HOME
|
|
|
|
|
and
|
|
|
|
|
.Ev SHELL
|
|
|
|
|
(plus
|
|
|
|
|
.Ev USER
|
|
|
|
|
and
|
|
|
|
|
.Ev LOGNAME
|
|
|
|
|
if the target
|
|
|
|
|
.Ar username
|
|
|
|
|
is not root).
|
|
|
|
|
.Sh OPTIONS
|
|
|
|
|
.Bl -tag -width Ds
|
|
|
|
|
.It Fl l
|
2014-04-13 12:23:04 -04:00
|
|
|
Starts the shell as login shell with an environment similar to a real
|
|
|
|
|
login.
|
2015-02-02 12:34:26 -05:00
|
|
|
.It Fl p
|
|
|
|
|
Preserves the whole environment. This option is ignored if the
|
|
|
|
|
.Fl l
|
2014-04-13 12:23:04 -04:00
|
|
|
option is specified.
|
2015-02-02 12:34:26 -05:00
|
|
|
.El
|
