runuser - Unix, Linux Command

previous next AddThis Social Bookmark Button


runuser - run a shell with substitute user and group IDs, similar to su, but will not run PAM hooks


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


Change the effective user id and group id to that of USER. No PAM hooks are run, and there will be no password prompt. This command is useful when run as the root user. If run as a non-root user without privilege to set user ID, the command will fail.

-, -l, --login
  make the shell a login shell
-g --group=group
  specify the primary group
-G --supp-group=group
  specify a supplemental group
-c, --command=COMMAND
  pass a single COMMAND to the shell with -c
  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
  output version information and exit
A mere - implies -l. If USER not given, assume root.


Written by David MacKenzie, Dan Walsh.


Report bugs to <>.


Copyright © 2006 Free Software Foundation, Inc.
This is free software. You may redistribute copies of it under the terms of the GNU General Public License <>. There is NO WARRANTY, to the extent permitted by law.


More detailed Texinfo documentation could be found by command
        info su invocation      
as command su is very similar to command runuser.
The full documentation for runuser is maintained as a Texinfo manual. If the info and runuser programs are properly installed at your site, the command
info runuser
should give you access to the complete manual.
previous next Printer Friendly