1SU(1) User Commands SU(1)
2
3
4
6 su - run a shell with substitute user and group IDs
7
9 su [OPTION]... [-] [USER [ARG]...]
10
12 Change the effective user id and group id to that of USER.
13
14 -, -l, --login
15 make the shell a login shell, clears all envvars except for
16 TERM, initializes HOME, SHELL, USER, LOGNAME and PATH
17
18 -c, --command=COMMAND
19 pass a single COMMAND to the shell with -c
20
21 --session-command=COMMAND
22 pass a single COMMAND to the shell with -c and do not create a
23 new session
24
25 -f, --fast
26 pass -f to the shell (for csh or tcsh)
27
28 -m, --preserve-environment
29 do not reset HOME, SHELL, USER, LOGNAME environment variables
30
31 -p same as -m
32
33 -s, --shell=SHELL
34 run SHELL if /etc/shells allows it
35
36 --help display this help and exit
37
38 --version
39 output version information and exit
40
41 A mere - implies -l. If USER not given, assume root.
42
44 Written by David MacKenzie.
45
47 Report su bugs to bug-coreutils@gnu.org
48 GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
49 General help using GNU software: <http://www.gnu.org/gethelp/>
50 Report su translation bugs to <http://translationproject.org/team/>
51
53 Copyright © 2010 Free Software Foundation, Inc. License GPLv3+: GNU
54 GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
55 This is free software: you are free to change and redistribute it.
56 There is NO WARRANTY, to the extent permitted by law.
57
59 The full documentation for su is maintained as a Texinfo manual. If
60 the info and su programs are properly installed at your site, the com‐
61 mand
62
63 info coreutils 'su invocation'
64
65 should give you access to the complete manual.
66
67
68
69GNU coreutils 8.4 June 2018 SU(1)