---
name: "vusu"
section: "1"
platform: "linux"
package: "vuos-cmds"
version: "0.9.2-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/vusu"
---

# vusu(1)

set the default networking stack

## NAME

**vusu** – set the default networking stack

## SYNOPSIS

**vusu** \[*options*\] \[-\] \[*user* \[\*argment...\]\]

## DESCRIPTION

**vusu** allows one to run commands with a substitute user and group ID (in VUOS). It requires a module loaded in VUOS able to redefine uid/gid, e.g. **unrealuidgid**.

When called without arguments, **vusu** defaults to running an interactive shell as (virtual) *root*.

For compatibility with [**su**(1)](/su/1.md), **vusu** defaults to not change the current directory and to only set the environment variables **HOME** and **SHELL** (plus **USER** and **LOGNAME** if the target user is not root). It is recommended to always use the **--login** option (instead of its shortcut -) to avoid side effects caused by mixing environments.

## OPTIONS

- **-c** *command*, **--command** *command*

  Pass command to the shell with the **-c** option.

- **-**, **-l**, **--login**

  Start the shell as a login shell with an environment similar to a real login:

- \- clears all the environment variables except **TERM**

  - \- initializes the environment variables **HOME**,

  **SHELL**, **USER**, **LOGNAME**, and **PATH**

- \- changes to the target user’s home directory

  - \- sets argv\[0\] of the shell to \`-' in order to make the shell a login

  shell

- **-m**, **-p**, **--preserve-environment**

  Preserve the entire environment, i.e. it does not set **HOME**, **SHELL**, **USER** nor **LOGNAME**. This option is ignored if the option **--login** is specified.

- **-s** *shell*, **--shell** *shell*

  Run the specified shell instead of the default. The shell to run is selected according to the following rules, in order:

- \- the shell specified with **--shell**

  - \- the shell specified in the environment variable **SHELL**, if

  the **--preserve-environment** option is used

- \- the shell listed in the passwd entry of the target user

  - \- /bin/sh

  - **-h**, **--help**

  Display a short help message and exit.

## SEE ALSO

[umvu(1)](/umvu/1.md), [su(1)](/su/1.md)

## AUTHOR

VirtualSquare. Project leader: Renzo Davoli. (most of this man page is a derivative work from [**su**(1)](/su/1.md) man page)