1RUNUSER(1)                       User Commands                      RUNUSER(1)
2
3
4

NAME

6       runuser - run a shell with substitute user and group IDs
7

SYNOPSIS

9       runuser [OPTION]... [-] [USER [ARG]...]
10

DESCRIPTION

12       Change  the  effective user id and group id to that of USER.  Only ses‐
13       sion PAM hooks are run, and there is no password prompt.  This  command
14       is  useful  only  when run as the root user.  If run as a non-root user
15       without privilege to set user ID, the command will fail as  the  binary
16       is  not  setuid.  As runuser doesn't run auth and account PAM hooks, it
17       runs with lower overhead than su.
18
19       -, -l, --login
20              make the shell a login shell, uses runuser-l PAM file instead of
21              default one
22
23       -g --group=group
24              specify the primary group
25
26       -G --supp-group=group
27              specify a supplemental group
28
29       -c, --command=COMMAND
30              pass a single COMMAND to the shell with -c
31
32       --session-command=COMMAND
33              pass  a  single COMMAND to the shell with -c and do not create a
34              new session
35
36       -f, --fast
37              pass -f to the shell (for csh or tcsh)
38
39       -m, --preserve-environment
40              do not reset environment variables
41
42       -p     same as -m
43
44       -s, --shell=SHELL
45              run SHELL if /etc/shells allows it
46
47       --help display this help and exit
48
49       --version
50              output version information and exit
51
52       A mere - implies -l.   If USER not given, assume root.
53

AUTHOR

55       Written by David MacKenzie, Dan Walsh.
56

REPORTING BUGS

58       Report runuser bugs to bug-coreutils@gnu.org
59       GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
60       General help using GNU software: <http://www.gnu.org/gethelp/>
61       Report   runuser   translation    bugs    to    <http://translationpro‐
62       ject.org/team/>
63

65       Copyright  ©  2010  Free Software Foundation, Inc.  License GPLv3+: GNU
66       GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
67       This is free software: you are free  to  change  and  redistribute  it.
68       There is NO WARRANTY, to the extent permitted by law.
69

SEE ALSO

71       More detailed Texinfo documentation could be found by command
72
73            info coreutils 'su invocation'
74
75       since the command runuser is trimmed down version of command su.
76
77
78
79GNU coreutils 8.5                November 2010                      RUNUSER(1)
Impressum