---
name: "su-rs"
section: "1"
platform: "linux"
package: "sudo-rs"
version: "0.2.15-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/su-rs"
---

# su-rs(1)

run a shell or command as another user

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

  Ignored for backwards compatibility. This version of su always creates a new pseudo-terminal if it is attached to a TTY

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