su

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 <bug-coreutils@gnu.org>.

COPYRIGHT
       Copyright © 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 PARTICU-
       LAR PURPOSE.

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

	      info coreutils su

       should give you access to the complete manual.



su (coreutils) 5.2.1		November 2008				SU(1)