su.1 - ubase - suckless linux base utils
 (HTM) git clone git://git.suckless.org/ubase
 (DIR) Log
 (DIR) Files
 (DIR) Refs
 (DIR) README
 (DIR) LICENSE
       ---
       su.1 (750B)
       ---
            1 .Dd February 2, 2015
            2 .Dt SU 1
            3 .Os ubase
            4 .Sh NAME
            5 .Nm su
            6 .Nd run a command with a substitute user and group ID
            7 .Sh SYNOPSIS
            8 .Nm
            9 .Op Fl lp
           10 .Op Ar username
           11 .Sh DESCRIPTION
           12 .Nm
           13 allows to run commands with a substitute user and group ID. When called
           14 without arguments,
           15 .Nm
           16 defaults to running an interactive shell as root. For backward compatibility
           17 .Nm
           18 defaults to not change the current directory and to only set the environment
           19 variables
           20 .Ev HOME
           21 and
           22 .Ev SHELL
           23 (plus
           24 .Ev USER
           25 and
           26 .Ev LOGNAME
           27 if the target
           28 .Ar username
           29 is not root).
           30 .Sh OPTIONS
           31 .Bl -tag -width Ds
           32 .It Fl l
           33 Starts the shell as login shell with an environment similar to a real
           34 login.
           35 .It Fl p
           36 Preserves the whole environment. This option is ignored if the
           37 .Fl l
           38 option is specified.
           39