NOTE: click here if you get an empty page.

SU(1)                            User Commands                           SU(1)


su - run a shell with substitute user and group IDs


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


Change the effective user id and group id to that of USER. -, -l, --login make the shell a login shell, clears all envvars except for TERM, initializes HOME, SHELL, USER, LOGNAME and PATH -c, --command=COMMAND pass a single COMMAND to the shell with -c --session-command=COMMAND pass a single COMMAND to the shell with -c and do not create a new session -f, --fast pass -f to the shell (for csh or tcsh) -m, --preserve-environment do not reset HOME, SHELL, USER, LOGNAME 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.


Written by David MacKenzie.


Report su bugs to GNU coreutils home page: <> General help using GNU software: <> Report su translation bugs to <>


Copyright (C) 2010 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <>. This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.


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 invocation' should give you access to the complete manual. GNU coreutils 8.4 July 2014 SU(1)