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), 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), su(1)

AUTHOR

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

VirtualSquare-VUOS                                November 2024                                          VUSU(1)