---
# NAME
`su` - run a shell or command as another user
# SYNOPSIS
`su` [options] [-] [<*user*> [<*argument*>...]]
# OPTIONS
`-c` *command*, `--command`=*command*
: Pass a single command to the shell with `-c`.
`-g` *group*, `--group`=*group*
: Specify the primary group
`-G` *group*, `--supp-group`=*group*
: Specify a supplemental group
`-h`, `--help`
: Show a help message.
`-`, `-l`, `--login`
: Make the shell a login shell
`-m`, `-p`, `--preserve-environment`
: Do not reset environment variables
`-P`, `--pty`
: Create a new pseudo-terminal when running the shell.
`-w` *list*, `--whitelist-environment`=*list*
: Do not reset the environment variables specified by the *list*. Multiple
variables can be separated by commas.
`-s` *shell*, `--shell`=*shell*
: Run *shell* if `/etc/shells` allows running as that shell instead of the
default shell for the user.
`-V`, `--version`
: Show the program version.
# SEE ALSO
[sudo(8)](sudo.8.md)