.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "DEBVM-CREATE 1"
.TH DEBVM-CREATE 1 "2023-01-01" "perl v5.36.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
debvm\-create \- Create a VM image for various Debian releases and architectures
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBdebvm-create\fR [\fB\-a\fR \fIarchitecture\fR] [\fB\-h\fR \fIhostname\fR] [\fB\-k\fR \fIsshkey\fR] [\fB\-m\fR \fImirror\fR] [\fB\-o\fR \fIoutput\fR] [\fB\-p\fR \fIpackage\fR] [\fB\-r\fR \fIrelease\fR] [\fB\-z\fR \fIsize_in_GB\fR] [\fB\-\-\fR \fImmdebstrap options\fR]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBdebvm-create\fR is essentially a thin wrapper around \fBmmdebstrap\fR for creating a raw ext4 filesystem image for booting with \fBdebvm-run\fR.
The purpose of these images primarily is testing the different releases and architectures without access to a physical machine of that architecture.
Beyond essential packages, the image will contain \fBapt\fR, an init system and a suitable kernel package.
Notably absent is a bootloader and a partition table.
In order to boot such an image, one is supposed to extract the kernel and initrd from the image and pass it to a suitable bootloader.
No user account is created and root can login without specifying a password.
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-a\fR \fIarchitecture\fR, \fB\-\-architecture\fR=\fIarchitecture\fR" 8
.IX Item "-a architecture, --architecture=architecture"
Specify a Debian architecture name.
By default, the native architecture is being used.
A suitable kernel image is automatically selected and installed into the image.
.IP "\fB\-h\fR \fIhostname\fR, \fB\-\-hostname\fR=\fIhostname\fR" 8
.IX Item "-h hostname, --hostname=hostname"
Set the hostname of the virtual machine.
By default, the hostname is \fBtestvm\fR.
.IP "\fB\-k\fR \fIsshkey\fR, \fB\-\-sshkey\fR=\fIsshkey\fR" 8
.IX Item "-k sshkey, --sshkey=sshkey"
Install the given ssh public key file into the virtual machine image for the root user.
This option also causes the ssh server to be installed.
By default, no key or server is installed.
.IP "\fB\-m\fR \fImirror\fR, \fB\-\-mirror\fR=\fImirror\fR" 8
.IX Item "-m mirror, --mirror=mirror"
Specify the Debian mirror to be used for downloading packages and to be configured inside the virtual machine image.
By default, \fBhttp://deb.debian.org/debian\fR is being used.
.IP "\fB\-o\fR \fIoutput\fR, \fB\-\-output\fR=\fIoutput\fR" 8
.IX Item "-o output, --output=output"
Specify the file name of the resulting virtual machine image.
By default, it is written to \fBrootfs.ext4\fR.
.IP "\fB\-p\fR \fIpackage\fR, \fB\-\-package\fR=\fIpackage\fR" 8
.IX Item "-p package, --package=package"
Request additional packages to be installed into the virtual machine image.
This option can be specified multiple times and packages can be separated by a comma.
Package recommendations are not honoured.
If a linux-image is passed here, it will replace the one selected by default.
.IP "\fB\-r\fR \fIrelease\fR, \fB\-\-release\fR=\fIrelease\fR" 8
.IX Item "-r release, --release=release"
Use the given Debian release.
By default, \fBunstable\fR is being used.
.IP "\fB\-z\fR \fIsize_in_GB\fR, \fB\-\-size\fR=\fIsize_in_GB\fR" 8
.IX Item "-z size_in_GB, --size=size_in_GB"
Specify the minimum image size in giga bytes.
The resulting image will be grown as a sparse file to this size if necessary.
The default is 1 \s-1GB.\s0
.IP "\fB\-\-\fR \fImmdebstrap options\fR" 8
.IX Item "-- mmdebstrap options"
All options beyond a double dash are passed to \fBmmdebstrap\fR before the suite, target and mirror specification.
This can be used to provide additional hooks for image customization.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
.Vb 1
\&    debvm\-run(1) mmdebstrap(1)
.Ve