qvm-run – Run a command in a specified VM

Synopsis

qvm-run [options] VMNAME COMMAND qvm-run [options] –all [–exclude EXCLUDE] COMMAND qvm-run [options] –dispvm [BASE_APPVM] COMMAND

Options

--help, -h

Show the help message and exit.

--verbose, -v

Increase verbosity.

--quiet, -q

Decrease verbosity.

--all

Run the command on all qubes. You can use --exclude to limit the qubes set. Command is never run on the dom0.

--exclude

Exclude the qube from --all.

--dispvm [BASE_APPVM]

Run the command fresh DisposableVM created out of BASE_APPVM. This option is mutually exclusive with VMNAME, –all and –exclude.

--user=USER, -u USER

Run command in a qube as USER.

--auto, --autostart, -a

Ignored. Qube is autostarted by default.

--no-auto, --no-autostart, -n

Do not start the qube automatically, fail the operation if not running.

--pass-io, -p

Pass standard input and output to and from the remote program.

--localcmd=COMMAND

With --pass-io, pass standard input and output to and from the given program.

--gui

Run the command with GUI forwarding enabled, which is the default. This switch can be used to counter --no-gui.

--no-gui, --nogui

Run the command without GUI forwarding enabled. Can be switched back with --gui.

--service

Start RPC service instead of shell command. Specify name of the service in place of COMMAND argument. You can also specify service argument, appending it to the service name after + character.

--colour-output=COLOUR, --color-output=COLOR

Mark the qube output with given ANSI colour (ie. “31” for red). The exact mapping of numbers to colours and styles depends of the particular terminal emulator.

Colouring can be disabled with --no-colour-output.

--colour-stderr=COLOUR, --color-stderr=COLOR

Mark the qube stderr with given ANSI colour (ie. “31” for red). The exact mapping of numbers to colours and styles depends of the particular terminal emulator.

Colouring can be disabled with --no-colour-stderr.

--no-colour-output, --no-color-output

Disable colouring the stdout.

--no-colour-stderr, --no-color-stderr

Disable colouring the stderr.

--filter-escape-chars

Filter terminal escape sequences (default if output is terminal).

Terminal control characters are a security issue, which in worst case amount to arbitrary command execution. In the simplest case this requires two often found codes: terminal title setting (which puts arbitrary string in the window title) and title repo reporting (which puts that string on the shell’s standard input.

--no-filter-escape-chars

Do not filter terminal escape sequences. This is DANGEROUS when output is a terminal emulator. See --filter-escape-chars for explanation.

Authors

Joanna Rutkowska <joanna at invisiblethingslab dot com>
Rafal Wojtczuk <rafal at invisiblethingslab dot com>
Marek Marczykowski <marmarek at invisiblethingslab dot com>
Wojtek Porczyk <woju at invisiblethingslab dot com>