.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH vmexec-pull 1  "pull " 
.SH NAME
vmexec\-pull \- Pull an image without running a virtual machine
.SH SYNOPSIS
\fBvmexec pull\fR [\fB\-\-prepare\fR] [\fB\-\-disable\-kvm\fR] [\fB\-m\fR|\fB\-\-memory\fR] [\fB\-\-show\-vm\-window\fR] [\fB\-s\fR|\fB\-\-ssh\-timeout\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fIOS_TYPE\fR> 
.SH DESCRIPTION
Pull an image without running a virtual machine
.SH OPTIONS
.TP
\fB\-\-prepare\fR
Additionally prepare the image so that the first run is fast

This extracts the kernel, creates the overlay image and performs the warmup boot that would otherwise happen on the first run.
.TP
\fB\-\-disable\-kvm\fR
Run the warmup virtual machine with TCG instead of KVM

This would be mostly useful in environments where KVM is not available. It will be a lot slower but might be acceptable in some contexts.
.TP
\fB\-m\fR, \fB\-\-memory\fR \fI<MEMORY>\fR
Memory limit for the warmup virtual machine in GBs

Must be an integer of at least 1.

If not provided, all available host memory is used.
.TP
\fB\-\-show\-vm\-window\fR
Show a window with the warmup virtual machine running in it

This is mostly useful for debugging boot failures.
.TP
\fB\-s\fR, \fB\-\-ssh\-timeout\fR \fI<SSH_TIMEOUT>\fR [default: 20]
SSH connection timeout during warmup

Try for this long (in seconds) to connect to the virtual machine\*(Aqs SSH server.
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help (see a summary with \*(Aq\-h\*(Aq)
.TP
<\fIOS_TYPE\fR>
The operating system image to pull
.br

.br
\fIPossible values:\fR
.RS 14
.IP \(bu 2
archlinux
.RE