RUNUSER(1) RUNUSER(1) (NAME) runuser - (SYNOPSIS) runuser [options] -u user [[--] command [argument...]] runuser [options] [-] [user [argument...]] (DESCRIPTION) runuser . -u runuser su . runuser su runuser ( root ) PAM . runuser set-user-ID . PAM setpriv(1) . runuser root . runuser HOME SHELL ( USER LOGNAME root ) . runuser PAM . runuser PAM (pam_getenvlist(3)) . --login --preserve-environment PAM . . runuser RLIMIT_NICE RLIMIT_RTPRIO RLIMIT_FSIZE RLIMIT_AS RLIMIT_NOFILE . (OPTIONS) -c, --command=command command -c. setsid(2) . --session-command . -f, --fast -f . -g, --group=group . root . -G, --supp-group=group . root . --group . -, -l, --login (login shell) : o TERM COLORTERM NO_COLOR --whitelist-environment o HOME SHELL USER LOGNAME PATH o o argv[0] '-' -m, -p, --preserve-environment HOME SHELL USER LOGNAME. --login . -P, --pty (pseudo-terminal) . . TIOCSTI . ( runuser --pty -u user -- command &). runuser ( stdin stdout). . (pipe) ( echo "date" | runuser --pty -u user) ECHO . -s, --shell=shell shell . : o --shell o SHELL --preserve-environment o passwd o /bin/sh ( /etc/shells ) --shell SHELL root . --session-command=command -c . ( .) TIOCSTI . -T, --no-pty --pty -P. TIOCSTI . -u, --user=user command (UID) (GID) user. -w, --whitelist-environment=list --login list . HOME SHELL USER LOGNAME PATH . -h, --help . -V, --version . (CONFIG FILES) runuser /etc/default/runuser /etc/login.defs . runuser : ENV_PATH () PATH . /usr/local/bin:/bin:/usr/bin . ENV_ROOTPATH () ENV_SUPATH () PATH root . ENV_SUPATH . /usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin . ALWAYS_SET_PATH () yes --login --preserve-environment runuser PATH . PATH /bin /sbin /usr --login PAM ( pam_env(8)) . (EXIT STATUS) runuser . runuser . runuser: 1 126 127 (FILES) /etc/pam.d/runuser PAM /etc/pam.d/runuser-l PAM --login /etc/default/runuser logindef runuser /etc/login.defs logindef (SECURITY NOTES) runuser ioctl TIOCSTI/TIOCLINUX . : runuser -c setsid(2) . ( ) --pty -P runuser . (HISTORY) runuser su coreutils David MacKenzie runuser Dan Walsh . (SEE ALSO) setpriv(1), su(1), login.defs(5), shells(5), pam(8) (REPORTING BUGS) . . (AVAILABILITY) runuser util-linux . . util-linux 2.42.3 2026-09-02 RUNUSER(1)