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

−c, −−command=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 su bugs to bug−coreutils@gnu.org

GNU coreutils home page: <http://www.gnu.org/software/coreutils/>

General help using GNU software: <http://www.gnu.org/gethelp/>

Report su translation bugs to <http://translationproject.org/team/>

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 command

  • info coreutils 'su invocation'

should give you access to the complete manual.

COPYRIGHT

Copyright © 2012 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.

This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.