<!-- ---
title: SU(1) sudo-rs 0.2.3 | sudo-rs
--- -->

# 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)