SU

Section: User Commands (1)
Updated: December 2009
Index Return to Main Contents

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
--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 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/>

COPYRIGHT

Copyright © 2009 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.