.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH vmexec-exec 1  "exec " 
.SH NAME
vmexec\-exec \- Run a command in an existing virtual machine
.SH SYNOPSIS
\fBvmexec exec\fR [\fB\-e\fR|\fB\-\-env\fR] [\fB\-w\fR|\fB\-\-workdir\fR] [\fB\-s\fR|\fB\-\-ssh\-timeout\fR] [\fB\-i\fR|\fB\-\-interactive\fR] [\fB\-t\fR|\fB\-\-tty\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fIVMID\fR> [\fIARGS\fR] 
.SH DESCRIPTION
Run a command in an existing virtual machine
.SH OPTIONS
.TP
\fB\-e\fR, \fB\-\-env\fR \fI<ENV>\fR
Set environment variables for the process inside the virtual machine

Can be provided multiple times.

Expected format: KEY=VALUE
.TP
\fB\-w\fR, \fB\-\-workdir\fR \fI<WORKDIR>\fR
Working directory inside the virtual machine

The default wokring directory for running binaries within a virtual machine is dependent on the image. Most commonly, it\*(Aqll be /root.
.TP
\fB\-s\fR, \fB\-\-ssh\-timeout\fR \fI<SSH_TIMEOUT>\fR [default: 20]
SSH connection timeout

Try for this long (in seconds) to connect to the virtual machine\*(Aqs SSH server.
.TP
\fB\-i\fR, \fB\-\-interactive\fR \fI<INTERACTIVE>\fR [default: auto]
Make STDIN available to the virtual machine\*(Aqs process

If \*(Aqauto\*(Aq, this will try to read from stdin if it is available, and do nothing when stdin is not available. If \*(Aqalways\*(Aq, this will try to read from stdin and abort when stdin is not available.
.br

.br
\fIPossible values:\fR
.RS 14
.IP \(bu 2
always
.IP \(bu 2
never
.IP \(bu 2
auto
.RE
.TP
\fB\-t\fR, \fB\-\-tty\fR \fI<TTY>\fR [default: auto]
Allocate a pseudo\-TTY for the virtual machine

If \*(Aqauto\*(Aq, this will be enabled in case vmexec is run from an interactive terminal.
.br

.br
\fIPossible values:\fR
.RS 14
.IP \(bu 2
always
.IP \(bu 2
never
.IP \(bu 2
auto
.RE
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help (see a summary with \*(Aq\-h\*(Aq)
.TP
<\fIVMID\fR>
Identifier of a running virtual machine
.TP
[\fIARGS\fR]
Arguments to run in the virtual machine