SU(1)                                     User Commands                                     SU(1)



NAME
       su - run a shell with substitute user and group IDs

SYNOPSIS
       su [OPTION]... [-] [USER [ARG]...]

DESCRIPTION
       Change the effective user id and group id to that of USER.

       -, -l, --login
              make the shell a login shell

       -g, --group=group
              specify the primary group (runuser)

       -G, --supp-group=group
              specify a supplemental group (runuser)

       -c, --commmand=COMMAND
              pass a single COMMAND to the shell with -c

       -f, --fast
              pass -f to the shell (for csh or tcsh)

       -m, --preserve-environment
              do not reset environment variables

       -p     same as -m

       -s, --shell=SHELL
              run SHELL if /etc/shells allows it

       --help display this help and exit

       --version
              output version information and exit

       A mere - implies -l.   If USER not given, assume root.

AUTHOR
       Written by David MacKenzie.

REPORTING BUGS
       Report bugs to <>.

COPYRIGHT
       Copyright (C) 2004 Free Software Foundation, Inc.
       This  is  free software; see the source for copying conditions.  There is NO warranty; not
       even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

SEE ALSO
       The full documentation for su is maintained as a Texinfo manual.  If the info and su  pro-
       grams are properly installed at your site, the command

              info coreutils su

       should give you access to the complete manual.



su (coreutils) 5.2.1                      November 2008                                     SU(1)