Since manpages are generated during build, having them in the
repository is useless, so this patch removes them and makes them (and
similar) ignored properly by git.
---
.gitignore | 1 +
man/en/virt-clone.1 | 311 -----------
man/en/virt-convert.1 | 253 ---------
man/en/virt-image.1 | 307 -----------
man/en/virt-image.5 | 329 ------------
man/en/virt-install.1 | 1359 -------------------------------------------------
6 files changed, 1 insertion(+), 2559 deletions(-)
delete mode 100644 man/en/virt-clone.1
delete mode 100644 man/en/virt-convert.1
delete mode 100644 man/en/virt-image.1
delete mode 100644 man/en/virt-image.5
delete mode 100644 man/en/virt-install.1
diff --git a/.gitignore b/.gitignore
index e380643..82165c1 100644
--- a/.gitignore
+++ b/.gitignore
@@ -6,5 +6,6 @@ MANIFEST
python-virtinst.spec
.coverage
/man/en/virt-install.pod
+/man/en/*.[0-9]
/virtconv/_config.py
/virtinst/_config.py
diff --git a/man/en/virt-clone.1 b/man/en/virt-clone.1
deleted file mode 100644
index 07430da..0000000
--- a/man/en/virt-clone.1
+++ /dev/null
@@ -1,311 +0,0 @@
-.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
-.\"
-.\" 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" ''
-'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 turned on, 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.
-.ie \nF \{\
-. de IX
-. tm Index:\\$1\t\\n%\t"\\$2"
-..
-. nr % 0
-. rr F
-.\}
-.el \{\
-. de IX
-..
-.\}
-.\"
-.\" 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 "VIRT-CLONE 1"
-.TH VIRT-CLONE 1 "2012-07-29" "" "Virtual Machine Install Tools"
-.\" 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"
-virt\-clone \- clone existing virtual machine images
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-\&\fBvirt-clone\fR [\s-1OPTION\s0]...
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-\&\fBvirt-clone\fR is a command line tool for cloning existing virtual machine
-images using the \f(CW\*(C`libvirt\*(C'\fR hypervisor management library. It will copy
-the disk images of any existing virtual machine, and define a new guest
-with an identical virtual hardware configuration. Elements which require
-uniqueness will be updated to avoid a clash between old and new guests.
-.PP
-By default, virt-clone will show an error if the necessary information to
-clone the guest is not provided. The \-\-auto\-clone option will generate
-all needed input, aside from the source guest to clone. An interactive mode
-is available with the \-\-prompt option, but this will only ask for the
-minimum required options.
-.SH "OPTIONS"
-.IX Header "OPTIONS"
-Most options are not required. Minimum requirements are \-\-original or
-\&\-\-original\-xml (to specify the guest to clone), \-\-name, and appropriate
-storage options via \-file.
-.IP "\-h, \-\-help" 4
-.IX Item "-h, --help"
-Show the help message and exit
-.IP "\-\-connect=URI" 4
-.IX Item "--connect=URI"
-Connect to a non-default hypervisor. See \fIvirt\-install\fR\|(1) for details
-.SS "General Options"
-.IX Subsection "General Options"
-General configuration parameters that apply to all guest clones.
-.IP "\-o \s-1ORIGINAL_GUEST\s0, \-\-original=ORIGINAL_GUEST" 2
-.IX Item "-o ORIGINAL_GUEST, --original=ORIGINAL_GUEST"
-Name of the original guest to be cloned. This guest must be shut off or paused
-since it is not possible to safely clone active guests at this time.
-.IP "\-\-original\-xml=ORIGINAL_XML" 2
-.IX Item "--original-xml=ORIGINAL_XML"
-Libvirt guest xml file to use as the original guest. The guest does not need to
-be defined on the libvirt connection. This takes the place of the
-\&\f(CW\*(C`\-\-original\*(C'\fR parameter.
-.IP "\-\-auto\-clone" 2
-.IX Item "--auto-clone"
-Generate a new guest name, and paths for new storage.
-.Sp
-An example or possible generated output:
-.Sp
-.Vb 2
-\& Original name : MyVM
-\& Generated clone name : MyVM\-clone
-\&
-\& Original disk path : /home/user/foobar.img
-\& Generated disk path : /home/user/foobar\-clone.img
-.Ve
-.Sp
-If generated names collide with existing VMs or storage, a number is appended,
-such as foobar\-clone\-1.img, or MyVM\-clone\-3.
-.IP "\-n \s-1NAME\s0, \-\-name=NAME" 2
-.IX Item "-n NAME, --name=NAME"
-Name of the new guest virtual machine instance. This must be unique amongst
-all guests known to the hypervisor connection, including those not
-currently active.
-.IP "\-u \s-1UUID\s0, \-\-uuid=UUID" 2
-.IX Item "-u UUID, --uuid=UUID"
-\&\s-1UUID\s0 for the guest; if none is given a random \s-1UUID\s0 will be generated. If you
-specify \s-1UUID\s0, you should use a 32\-digit hexadecimal number. \s-1UUID\s0 are intended
-to be unique across the entire data center, and indeed world. Bear this in
-mind if manually specifying a \s-1UUID\s0
-.SS "Storage Configuration"
-.IX Subsection "Storage Configuration"
-.IP "\-f \s-1DISKFILE\s0, \-\-file=DISKFILE" 2
-.IX Item "-f DISKFILE, --file=DISKFILE"
-Path to the file, disk partition, or logical volume to use as the backing store
-for the new guest's virtual disk. If the original guest has multiple disks,
-this parameter must be repeated multiple times, once per disk in the original
-virtual machine.
-.IP "\-\-force\-copy=TARGET" 2
-.IX Item "--force-copy=TARGET"
-Force cloning the passed disk target ('hdc', 'sda', etc.). By default,
-\&\f(CW\*(C`virt\-clone\*(C'\fR will skip certain disks, such as those marked 'readonly' or
-\&'shareable'.
-.IP "\-\-nonsparse" 2
-.IX Item "--nonsparse"
-Fully allocate the new storage if the path being cloned is a sparse file.
-See \fIvirt\-install\fR\|(1) for more details on sparse vs. nonsparse.
-.IP "\-\-preserve\-data" 2
-.IX Item "--preserve-data"
-No storage is cloned: disk images specific by \-\-file are preserved as is,
-and referenced in the new clone \s-1XML\s0. This is useful if you want to clone
-a \s-1VM\s0 \s-1XML\s0 template, but not the storage contents.
-.SS "Networking Configuration"
-.IX Subsection "Networking Configuration"
-.IP "\-m \s-1MAC\s0, \-\-mac=MAC" 2
-.IX Item "-m MAC, --mac=MAC"
-Fixed \s-1MAC\s0 address for the guest; If this parameter is omitted, or the value
-\&\f(CW\*(C`RANDOM\*(C'\fR is specified a suitable address will be randomly generated. Addresses
-are applied sequentially to the networks as they are listed in the original
-guest \s-1XML\s0.
-.SS "Miscellaneous Options"
-.IX Subsection "Miscellaneous Options"
-.IP "\-\-print\-xml" 2
-.IX Item "--print-xml"
-Print the generated clone \s-1XML\s0 and exit without cloning.
-.IP "\-\-replace" 2
-.IX Item "--replace"
-Shutdown and remove any existing guest with the passed \f(CW\*(C`\-\-name\*(C'\fR before
-cloning the original guest.
-.IP "\-d, \-\-debug" 2
-.IX Item "-d, --debug"
-Print debugging information to the terminal when running the install process.
-The debugging information is also stored in \f(CW\*(C`$HOME/.virtinst/virt\-clone.log\*(C'\fR
-even if this parameter is omitted.
-.IP "\-\-force" 2
-.IX Item "--force"
-Prevent interactive prompts. If the intended prompt was a yes/no prompt, always
-say yes. For any other prompts, the application will exit.
-.IP "\-\-prompt" 2
-.IX Item "--prompt"
-Specifically enable prompting for required information. Default prompting
-is off.
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-Clone the guest called \f(CW\*(C`demo\*(C'\fR on the default connection, auto generating
-a new name and disk clone path.
-.PP
-.Vb 3
-\& # virt\-clone \e
-\& \-\-original demo \e
-\& \-\-auto\-clone
-.Ve
-.PP
-Clone the guest called \f(CW\*(C`demo\*(C'\fR which has a single disk to copy
-.PP
-.Vb 4
-\& # virt\-clone \e
-\& \-\-original demo \e
-\& \-\-name newdemo \e
-\& \-\-file /var/lib/xen/images/newdemo.img
-.Ve
-.PP
-Clone a \s-1QEMU\s0 guest with multiple disks
-.PP
-.Vb 6
-\& # virt\-clone \e
-\& \-\-connect qemu:///system \e
-\& \-\-original demo \e
-\& \-\-name newdemo \e
-\& \-\-file /var/lib/xen/images/newdemo.img \e
-\& \-\-file /var/lib/xen/images/newdata.img
-.Ve
-.PP
-Clone a guest to a physical device which is at least as big as the
-original guests disks. If the destination device is bigger, the
-new guest can do a filesystem resize when it boots.
-.PP
-.Vb 6
-\& # virt\-clone \e
-\& \-\-connect qemu:///system \e
-\& \-\-original demo \e
-\& \-\-name newdemo \e
-\& \-\-file /dev/HostVG/DemoVM \e
-\& \-\-mac 52:54:00:34:11:54
-.Ve
-.SH "AUTHOR"
-.IX Header "AUTHOR"
-Written by Kazuki Mizushima, Cole Robinson, and a team of many other
-contributors. See the \s-1AUTHORS\s0 file in the source distribution for the
-complete list of credits.
-.SH "BUGS"
-.IX Header "BUGS"
-Please see http://virt\-manager.org/page/BugReporting
-.SH "COPYRIGHT"
-.IX Header "COPYRIGHT"
-Copyright (C) Fujitsu Limited, and various contributors.
-This is free software. You may redistribute copies of it under the terms
-of the \s-1GNU\s0 General Public License \f(CW\*(C`http://www.gnu.org/licenses/gpl.html\*(C'\fR.
-There is \s-1NO\s0 \s-1WARRANTY\s0, to the extent permitted by law.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\f(CWvirsh(1)\fR, \f(CW\*(C`virt\-install(1)\*(C'\fR, \f(CW\*(C`virt\-manager(1)\*(C'\fR, the project website \f(CW\*(C`http://virt\-manager.org\*(C'\fR
diff --git a/man/en/virt-convert.1 b/man/en/virt-convert.1
deleted file mode 100644
index e92f35a..0000000
--- a/man/en/virt-convert.1
+++ /dev/null
@@ -1,253 +0,0 @@
-.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
-.\"
-.\" 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" ''
-'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 turned on, 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.
-.ie \nF \{\
-. de IX
-. tm Index:\\$1\t\\n%\t"\\$2"
-..
-. nr % 0
-. rr F
-.\}
-.el \{\
-. de IX
-..
-.\}
-.\"
-.\" 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 "VIRT-CONVERT 1"
-.TH VIRT-CONVERT 1 "2012-07-29" "" "Virtual Machine Install Tools"
-.\" 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"
-virt\-convert \- convert virtual machines between formats
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-\&\fBvirt-convert\fR [\s-1OPTION\s0]... \s-1INPUT\s0.VMX|INPUT\-DIR [\s-1OUTPUT\s0.XML|OUTPUT\-DIR]
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-\&\fBvirt-convert\fR is a command line tool for converting virtual machines
-from one format to another. Pass in either a \s-1VM\s0 definition file (such
-as VMWare vmx format) or a directory containing a \s-1VM\s0. By default, a new
-\&\s-1VM\s0 definition file, and converted disk images, will be placed in a new
-output directory.
-.PP
-If an output directory is specified, it will be created if necessary,
-and the output \s-1VM\s0 definition placed within, along with any disk images
-as needed.
-.PP
-If an output \s-1VM\s0 definition file is specified, it will be created
-alongside any disks in the same directory.
-.SH "OPTIONS"
-.IX Header "OPTIONS"
-Any of the options can be omitted, in which case \fBvirt-convert\fR will
-use defaults when required. An input \s-1VM\s0 definition or containing directory
-must be provided. By default, an output directory is generated based upon
-the name of the \s-1VM\s0. The default input format is VMWare vmx, and the
-default output format is a libvirt \*(L"image\*(R" \s-1XML\s0 definition
-(see \fIvirt\-image\fR\|(5)).
-.IP "\-h, \-\-help" 4
-.IX Item "-h, --help"
-Show the help message and exit
-.SS "Conversion Options"
-.IX Subsection "Conversion Options"
-.IP "\-i format" 2
-.IX Item "-i format"
-Input format. Currently, \f(CW\*(C`vmx\*(C'\fR, \f(CW\*(C`virt\-image\*(C'\fR, and \f(CW\*(C`ovf\*(C'\fR are supported.
-.IP "\-o format" 2
-.IX Item "-o format"
-Output format. Currently, \f(CW\*(C`vmx\*(C'\fR and \f(CW\*(C`virt\-image\*(C'\fR are supported.
-.IP "\-D format" 2
-.IX Item "-D format"
-Output disk format, or \f(CW\*(C`none\*(C'\fR if no conversion should be performed. See
-\&\fIqemu\-img\fR\|(1).
-.SS "Virtualization Type options"
-.IX Subsection "Virtualization Type options"
-Options to override the default virtualization type choices.
-.IP "\-v, \-\-hvm Create a fully virtualized guest image" 2
-.IX Item "-v, --hvm Create a fully virtualized guest image"
-Convert machine to a hvm/qemu based image (this is the default if paravirt
-is not specified)
-.IP "\-p, \-\-paravirt Create a paravirtualized guest image" 2
-.IX Item "-p, --paravirt Create a paravirtualized guest image"
-Convert machine to a paravirt xen based image
-.SS "General Options"
-.IX Subsection "General Options"
-General configuration parameters that apply to all types of guest installs.
-.IP "\-a \s-1ARCH\s0, \-\-arch=ARCH" 2
-.IX Item "-a ARCH, --arch=ARCH"
-Architecture of the virtual machine (i686, x86_64, ppc). Defaults to
-that of the host machine.
-.IP "\-\-os\-type=OS_TYPE" 2
-.IX Item "--os-type=OS_TYPE"
-Optimize the guest configuration for a type of operating system (ex. 'linux',
-\&'windows'). This will attempt to pick the most suitable \s-1ACPI\s0 & \s-1APIC\s0 settings,
-optimally supported mouse drivers, virtio, and generally accommodate other
-operating system quirks. See \fIvirt\-install\fR\|(1) for valid values.
-.IP "\-\-os\-variant=OS_VARIANT" 2
-.IX Item "--os-variant=OS_VARIANT"
-Further optimize the guest configuration for a specific operating system
-variant (ex. 'fedora8', 'winxp'). This parameter is optional, and does not
-require an \f(CW\*(C`\-\-os\-type\*(C'\fR to be specified. See \fIvirt\-install\fR\|(1) for valid
-values.
-.IP "\-\-noapic" 2
-.IX Item "--noapic"
-Override the \s-1OS\s0 type / variant to disables the \s-1APIC\s0 setting for fully
-virtualized guest.
-.IP "\-\-noacpi" 2
-.IX Item "--noacpi"
-Override the \s-1OS\s0 type / variant to disables the \s-1ACPI\s0 setting for fully
-virtualized guest.
-.SS "Miscellaneous Options"
-.IX Subsection "Miscellaneous Options"
-.IP "\-q, \-\-quiet" 2
-.IX Item "-q, --quiet"
-Avoid verbose output.
-.IP "\-d, \-\-debug" 2
-.IX Item "-d, --debug"
-Print debugging information
-.IP "\-\-dry\-run" 2
-.IX Item "--dry-run"
-Proceed through the conversion process, but don't convert disks or actually
-write any converted files.
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-Convert a paravirt guest from \f(CW\*(C`image.vmx\*(C'\fR:
-.PP
-.Vb 1
-\& # virt\-convert \-\-arch=i686 \-\-paravirt image.vmx
-.Ve
-.PP
-Convert a 64\-bit hvm guest:
-.PP
-.Vb 1
-\& # virt\-convert \-\-arch=x86_64 vmx\-appliance/ hvm\-appliance/
-.Ve
-.SH "AUTHOR"
-.IX Header "AUTHOR"
-Written by Joey Boggs, John Levon, and Cole Robinson
-.PP
-See the \s-1AUTHORS\s0 file in the source distribution for the complete list
-of credits.
-.SH "BUGS"
-.IX Header "BUGS"
-Please see http://virt\-manager.org/page/BugReporting
-.SH "COPYRIGHT"
-.IX Header "COPYRIGHT"
-Copyright (C) 2006\-2012 Red Hat, Inc, and various contributors.
-This is free software. You may redistribute copies of it under the terms
-of the \s-1GNU\s0 General Public License \f(CW\*(C`http://www.gnu.org/licenses/gpl.html\*(C'\fR.
-There is \s-1NO\s0 \s-1WARRANTY\s0, to the extent permitted by law.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fIvirt\-image\fR\|(5), the project website \f(CW\*(C`http://virt\-manager.org\*(C'\fR
diff --git a/man/en/virt-image.1 b/man/en/virt-image.1
deleted file mode 100644
index 0928278..0000000
--- a/man/en/virt-image.1
+++ /dev/null
@@ -1,307 +0,0 @@
-.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
-.\"
-.\" 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" ''
-'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 turned on, 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.
-.ie \nF \{\
-. de IX
-. tm Index:\\$1\t\\n%\t"\\$2"
-..
-. nr % 0
-. rr F
-.\}
-.el \{\
-. de IX
-..
-.\}
-.\"
-.\" 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 "VIRT-IMAGE 1"
-.TH VIRT-IMAGE 1 "2012-07-29" "" "Virtual Machine Install Tools"
-.\" 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"
-virt\-image \- create virtual machines from an image descriptor
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-\&\fBvirt-image\fR [\s-1OPTION\s0]... \s-1IMAGE\s0.XML
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-\&\fBvirt-image\fR is a command line tool for creating virtual machines from an
-\&\s-1XML\s0 image descriptor \f(CW\*(C`IMAGE.XML\*(C'\fR (\fIvirt\-image\fR\|(5)). Most attributes of
-the virtual machine are taken from the \s-1XML\s0 descriptor (e.g., where the
-files to back the virtual machine's disks are and how to map them into the
-guest), though certain information must be added on the command line, such
-as the name of the guest.
-.PP
-The \s-1XML\s0 descriptor defines most attributes of the guest, making it possible
-to bundle and distribute it together with the files backing the guest's
-disks.
-.SH "OPTIONS"
-.IX Header "OPTIONS"
-Most options can be omitted, in which case \fBvirt-image\fR will use defaults
-from the \s-1XML\s0 descriptor. When defaults are taken from the \s-1XML\s0 descriptor,
-they are indicated below as a path. \-\-name is the only required command
-line option.
-.IP "\-h, \-\-help" 4
-.IX Item "-h, --help"
-Show the help message and exit
-.IP "\-\-connect=URI" 4
-.IX Item "--connect=URI"
-Connect to a non-default hypervisor. See \fIvirt\-install\fR\|(1) for details
-.SS "General Options"
-.IX Subsection "General Options"
-General configuration parameters that apply to all types of guest installs.
-.IP "\-n \s-1NAME\s0, \-\-name=NAME" 2
-.IX Item "-n NAME, --name=NAME"
-Name of the guest instance
-.IP "\-r \s-1MEMORY\s0, \-\-ram=MEMORY" 2
-.IX Item "-r MEMORY, --ram=MEMORY"
-Memory to allocate for guest instance in megabytes. Defaults to
-\&\f(CW\*(C`/image/devices/memory\*(C'\fR in the \s-1XML\s0 descriptor.
-.IP "\-u \s-1UUID\s0, \-\-uuid=UUID" 2
-.IX Item "-u UUID, --uuid=UUID"
-\&\s-1UUID\s0 for the guest; if none is given a random \s-1UUID\s0 will be generated. If
-you specify \s-1UUID\s0, you should use a 32\-digit hexadecimal number.
-.IP "\-\-vcpus=VCPUS" 2
-.IX Item "--vcpus=VCPUS"
-Number of vcpus to configure for your guest. Defaults to
-\&\f(CW\*(C`/image/devices/vcpu\*(C'\fR in the \s-1XML\s0 descriptor. This option can also be
-used to set \s-1CPU\s0 topology, please see \fIvirt\-install\fR\|(1) for more info.
-.IP "\-\-cpuset" 2
-.IX Item "--cpuset"
-Set which physical cpus the guest can use. Please see \fIvirt\-install\fR\|(1) for
-more info.
-.IP "\-\-cpu" 2
-.IX Item "--cpu"
-Configure the \s-1CPU\s0 and \s-1CPU\s0 features exposed to the guest. Please see
-\&\fIvirt\-install\fR\|(1) for more info.
-.IP "\-\-check\-cpu" 2
-.IX Item "--check-cpu"
-Check that vcpus do not exceed physical CPUs and warn if they do.
-.IP "\-\-os\-type=OS_TYPE" 2
-.IX Item "--os-type=OS_TYPE"
-Optimize the guest configuration for a type of operating system (ex. 'linux',
-\&'windows'). This will attempt to pick the most suitable \s-1ACPI\s0 & \s-1APIC\s0 settings,
-optimally supported mouse drivers, virtio, and generally accommodate other
-operating system quirks. See \fIvirt\-install\fR\|(1) for valid values.
-.IP "\-\-os\-variant=OS_VARIANT" 2
-.IX Item "--os-variant=OS_VARIANT"
-Further optimize the guest configuration for a specific operating system
-variant (ex. 'fedora8', 'winxp'). This parameter is optional, and does not
-require an \f(CW\*(C`\-\-os\-type\*(C'\fR to be specified. See \fIvirt\-install\fR\|(1) for valid
-values.
-.SS "Full Virtualization specific options"
-.IX Subsection "Full Virtualization specific options"
-Parameters specific only to fully virtualized guest installs.
-.IP "\-\-noapic" 2
-.IX Item "--noapic"
-Force disable \s-1APIC\s0 for the guest.
-.IP "\-\-noacpi" 2
-.IX Item "--noacpi"
-Force disable \s-1ACPI\s0 for the guest.
-.SS "Networking Configuration"
-.IX Subsection "Networking Configuration"
-.IP "\-w \s-1NETWORK\s0, \-\-network=NETWORK" 2
-.IX Item "-w NETWORK, --network=NETWORK"
-Connect the guest to the host network. See \fIvirt\-install\fR\|(1) for details
-.IP "\-m \s-1MAC\s0, \-\-mac=MAC" 2
-.IX Item "-m MAC, --mac=MAC"
-This is deprecated in favor of \f(CW\*(C`\-\-network ...,mac=MAC,...\*(C'\fR
-.IP "\-b \s-1BRIDGE\s0, \-\-bridge=BRIDGE" 2
-.IX Item "-b BRIDGE, --bridge=BRIDGE"
-This is deprecated in favor of \f(CW\*(C`\-\-network bridge=BRIDGE\*(C'\fR
-.SS "Graphics Configuration"
-.IX Subsection "Graphics Configuration"
-If no graphics option is specified, \f(CW\*(C`virt\-image\*(C'\fR will default to
-\&'\-\-graphics vnc' if the \s-1DISPLAY\s0 environment variable is set, otherwise
-\&'\-\-graphics none' is used.
-.IP "\-\-graphics \s-1TYPE\s0,opt1=arg1,opt2=arg2,..." 2
-.IX Item "--graphics TYPE,opt1=arg1,opt2=arg2,..."
-Specifies the graphical display configuration. This does not configure any
-virtual hardware, just how the guest's graphical display can be accessed.
-See \fIvirt\-install\fR\|(1) for details usage info.
-.IP "\-\-vnc" 2
-.IX Item "--vnc"
-This option is deprecated in favor of \f(CW\*(C`\-\-graphics vnc,...\*(C'\fR
-.IP "\-\-vncport=VNCPORT" 2
-.IX Item "--vncport=VNCPORT"
-This option is deprecated in favor of \f(CW\*(C`\-\-graphics vnc,port=PORT,...\*(C'\fR
-.IP "\-\-vnclisten=VNCLISTEN" 2
-.IX Item "--vnclisten=VNCLISTEN"
-This option is deprecated in favor of \f(CW\*(C`\-\-graphics vnc,listen=LISTEN,...\*(C'\fR
-.IP "\-k \s-1KEYMAP\s0, \-\-keymap=KEYMAP" 2
-.IX Item "-k KEYMAP, --keymap=KEYMAP"
-This option is deprecated in favor of \f(CW\*(C`\-\-graphics vnc,keymap=KEYMAP,...\*(C'\fR
-.IP "\-\-sdl" 2
-.IX Item "--sdl"
-This option is deprecated in favor of \f(CW\*(C`\-\-graphics sdl,...\*(C'\fR
-.IP "\-\-nographics" 2
-.IX Item "--nographics"
-This option is deprecated in favor of \f(CW\*(C`\-\-graphics none\*(C'\fR
-.SS "Miscellaneous Options"
-.IX Subsection "Miscellaneous Options"
-.IP "\-p, \-\-print" 2
-.IX Item "-p, --print"
-Print the libvirt \s-1XML\s0, but do not start the guest.
-.IP "\-\-boot=BOOT" 2
-.IX Item "--boot=BOOT"
-The zero-based index of the boot record to use. The \s-1XML\s0 descriptor can
-contain multiple \f(CW\*(C`/image/domain/boot\*(C'\fR elements for use on different
-hypervisors. By default, the one that is most appropriate for the current
-hypervisor is selected.
-.IP "\-\-replace" 2
-.IX Item "--replace"
-Shutdown and remove any existing guest with the passed \f(CW\*(C`\-\-name\*(C'\fR before
-installing from the image.
-.IP "\-\-noreboot" 2
-.IX Item "--noreboot"
-Prevent the domain automatically booting after importing the image.
-.IP "\-\-skip\-checksum" 2
-.IX Item "--skip-checksum"
-Do not check disk images against checksums (if they are listed in the
-image xml).
-.IP "\-d, \-\-debug" 2
-.IX Item "-d, --debug"
-Print debugging information.
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-Create and start a guest called \f(CW\*(C`example\*(C'\fR with a \s-1VNC\s0 console from
-\&\f(CW\*(C`image.xml\*(C'\fR:
-.PP
-.Vb 1
-\& # virt\-image \-\-name example \-\-vnc image.xml
-.Ve
-.PP
-Print the libvirt \s-1XML\s0 for a guest called \f(CW\*(C`example\*(C'\fR without graphics, but
-do not create or start a virtual machine:
-.PP
-.Vb 1
-\& # virt\-image \-\-print \-\-name example \-\-nographics image.xml
-.Ve
-.SH "AUTHOR"
-.IX Header "AUTHOR"
-Written by David Lutterkort and Cole Robinson. See the \s-1AUTHORS\s0 file in
-the source distribution for the complete list of credits.
-.SH "BUGS"
-.IX Header "BUGS"
-Please see http://virt\-manager.org/page/BugReporting
-.SH "COPYRIGHT"
-.IX Header "COPYRIGHT"
-Copyright (C) 2006\-2012 Red Hat, Inc, and various contributors.
-This is free software. You may redistribute copies of it under the terms
-of the \s-1GNU\s0 General Public License \f(CW\*(C`http://www.gnu.org/licenses/gpl.html\*(C'\fR.
-There is \s-1NO\s0 \s-1WARRANTY\s0, to the extent permitted by law.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fIvirt\-image\fR\|(5), \fIvirt\-install\fR\|(1), the project website
-\&\f(CW\*(C`http://virt\-manager.org\*(C'\fR
diff --git a/man/en/virt-image.5 b/man/en/virt-image.5
deleted file mode 100644
index 7c8f67b..0000000
--- a/man/en/virt-image.5
+++ /dev/null
@@ -1,329 +0,0 @@
-.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
-.\"
-.\" 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" ''
-'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 turned on, 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.
-.ie \nF \{\
-. de IX
-. tm Index:\\$1\t\\n%\t"\\$2"
-..
-. nr % 0
-. rr F
-.\}
-.el \{\
-. de IX
-..
-.\}
-.\"
-.\" 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 "virt-image 5"
-.TH virt-image 5 "2012-07-29" "" "Virtual Machine Install Tools"
-.\" 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"
-virt\-image \- Format of the virtual image XML descriptor
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-\&\fIvirt\-image\fR\|(1) relies on an \s-1XML\s0 descriptor to create virtual machines from
-virtual machine images. In general, a virtual machine image consists of the
-\&\s-1XML\s0 descriptor (usually in a file \fIimage.xml\fR) and a number of files for
-the virtual machine's disks.
-.PP
-In the following explanation of the structure of the image descriptor,
-mandatory \s-1XML\s0 elements are marked as \fBelement\fR, whereas optional elements
-are marked as \fIelement\fR.
-.PP
-All file names in the image descriptor are relative to the location of the
-descriptor itself. Generally, disk files are either kept in the same
-directory as the image descriptor, or in a subdirectory.
-.SH "HOST MATCHING"
-.IX Header "HOST MATCHING"
-The image descriptor contains information on the requirements a guest has
-on the host platform through one or more the \fI/image/domain/boot\fR
-descriptors (see section \*(L"\s-1BOOT\s0\*(R"). The image can only be used if at least
-one of the boot descriptors is suitable for the host platform; a boot
-descriptor is suitable if:
-.IP "\(bu" 4
-The \s-1CPU\s0 architecture of the boot descriptor, given by the
-\&\fIboot/guest/arch\fR element, is supported by the host
-.IP "\(bu" 4
-The host supports a guest with the features requested in the
-\&\fIboot/guest/features\fR element, such as providing an \s-1APIC\s0, or having \s-1ACPI\s0
-turned off
-.PP
-If a suitable boot descriptor is found, the guest is created and booted
-according to the information about booting the \s-1OS\s0 from the \fIboot/os\fR
-element and with the disks specified in the \fIboot/drive\fR element. If more
-than one suitable boot descriptor is found, one of them is chosen based on
-a heuristic, generally preferring paravirtualized guests over full
-virtualized ones, though this is an implementation detail of the tool
-creating the virtual machine.
-.SH "STRUCTURE"
-.IX Header "STRUCTURE"
-The image descriptor consists of three sections, all contained in the
-toplevel \fBimage\fR element:
-.IP "General metadata about the image" 4
-.IX Item "General metadata about the image"
-A number of elements like \fIlabel\fR, \fBname\fR, and \fIdescription\fR that give
-some simple information about the image. The \fBname\fR must be a string
-suitable as a name for the virtual machine, the \fIlabel\fR is a short
-human-readable string suitable for display in graphical \s-1UI\s0's, and the
-\&\fIdescription\fR should be a longer, free-form description of the purpose of
-the image. The \fBname\fR is mandatory.
-.IP "Virtual machine attributes" 4
-.IX Item "Virtual machine attributes"
-The \fBdomain\fR element contains instructions on how to boot the image, and
-device attributes such as the number of virtual \s-1CPU\s0's and the size of the
-memory. (see section \*(L"\s-1DOMAIN\s0\*(R")
-.IP "Storage layout" 4
-.IX Item "Storage layout"
-The \fBstorage\fR element lists the files to back the virtual machine's disks
-and some information about their format and use. (see section \*(L"\s-1STORAGE\s0\*(R")
-.SH "DOMAIN"
-.IX Header "DOMAIN"
-The \fBdomain\fR element contains one or more \fBboot\fR descriptors (see section
-\&\*(L"\s-1BOOT\s0\*(R") and a \fBdevices\fR element. The \fBDevices\fR element lists the
-recommended number of virtual \s-1CPU\s0's in the \fBvcpu\fR element and the
-recommended amount of memory in kB in the \fBmemory\fR element. It also
-indicates whether the virtual machine should have a network interface
-through the \fIinterface\fR element and whether the virtual machine has a
-graphical interface through the \fIgraphics\fR element.
-.SS "\s-1BOOT\s0"
-.IX Subsection "BOOT"
-Each \fBboot\fR descriptor details how the virtual machine should be started
-on a certain hypervisor. The \fBtype\fR attribute of the \fBboot\fR element,
-which can either be \f(CW\*(C`xen\*(C'\fR or \f(CW\*(C`hvm\*(C'\fR, depending on whether the boot
-descriptor is for a paravirtualized Xen(tm) guest or a fully-virtualized
-guest.
-.PP
-The \fBboot\fR element contains three subelements:
-.IP "The platform requirements of the guest" 4
-.IX Item "The platform requirements of the guest"
-The platform requirements, contained in the \fBguest\fR element, consist of
-the \fBarch\fR element and the \fIfeatures\fR element. The \fBarch\fR element
-indicates the \s-1CPU\s0 architecture the guest expects, e.g. \f(CW\*(C`i686\*(C'\fR, \f(CW\*(C`x86_64\*(C'\fR,
-or \f(CW\*(C`ppc\*(C'\fR.
-.Sp
-The \fIfeatures\fR element indicates whether certain platform features should
-be on or off. Currently, the platform features are \fIpae\fR, \fIacpi\fR, and
-\&\fIapic\fR. They can be turned on or off by giving a \fIstate\fR attribute of
-either \f(CW\*(C`on\*(C'\fR or \f(CW\*(C`off\*(C'\fR. When a feature is mentioned in the \fIfeatures\fR
-element, it defaults to \f(CW\*(C`on\*(C'\fR.
-.IP "The details of booting the image's operating system" 4
-.IX Item "The details of booting the image's operating system"
-The \fBos\fR element for fully-virtualized \f(CW\*(C`hvm\*(C'\fR guests contains a \fBloader\fR
-element whose \fBdev\fR attribute indicates whether to boot off a hard disk
-(\f(CW\*(C`dev=\*(Aqhd\*(Aq\*(C'\fR) or off a CD-ROM (\f(CW\*(C`dev=\*(Aqcdrom\*(Aq\*(C'\fR)
-.Sp
-For paravirtualized guests, the \fBos\fR element either contains a
-\&\f(CW\*(C`<loader>pygrub</loader>\*(C'\fR element, indicating that the guest should be
-booted with \fIpygrub\fR, or \fBkernel\fR, \fIinitrd\fR and \fIcmdline\fR elements. The
-contents of the \fBkernel\fR and \fIinitrd\fR elements are the names of the
-kernel and initrd files, whereas the \fIcmdline\fR element contains the
-command line that should be passed to the kernel on boot.
-.IP "The mapping of disk files as devices into the guest" 4
-.IX Item "The mapping of disk files as devices into the guest"
-The mapping of disk files into the guest is performed by a list of \fBdrive\fR
-elements inside the \fBboot\fR element. Each \fBdrive\fR element references the
-name of a disk file from the \*(L"\s-1STORAGE\s0\*(R" section through its \fBdisk\fR
-attribute and can optionally specify as what device that disk file should
-appear in the guest through its \fItarget\fR attribute. If the \fItarget\fR is
-omitted, device names are assigned in the order in which the \fBdrive\fR
-elements appear, skipping already assigned devices.
-.SH "STORAGE"
-.IX Header "STORAGE"
-The \fBstorage\fR element lists the disk image files that are part of the
-virtual machine image in a list of one or more \fBdisk\fR elements. Each
-\&\fBdisk\fR element can contain the following attributes:
-.IP "\(bu" 4
-the \fBfile\fR attribute giving the name of the disk file
-.IP "\(bu" 4
-an optional \fIid\fR attribute. The name given with that attribute is used to
-reference the disk from the \fBdrive\fR element of a \fBboot\fR descriptor. If
-the \fIid\fR attribute is missing, it defaults to the \fBfile\fR attribute.
-.IP "\(bu" 4
-the \fBuse\fR attribute indicating whether the disk file is a \f(CW\*(C`system\*(C'\fR,
-\&\f(CW\*(C`user\*(C'\fR, or \f(CW\*(C`scratch\*(C'\fR disk. The \fBuse\fR attribute differentiates disk files
-so that an update based on replacing disk files can replace \f(CW\*(C`system\*(C'\fR
-disks, but leave \f(CW\*(C`user\*(C'\fR disks untouched.
-.Sp
-Generally, \f(CW\*(C`system\*(C'\fR disks contain application code, \f(CW\*(C`user\*(C'\fR disks contain
-the application's data, and \f(CW\*(C`scratch\*(C'\fR disks contain temporary state that
-can be erased between runs of the guest.
-.Sp
-The virtual machine image must contain files for all \f(CW\*(C`system\*(C'\fR disks, and
-may contain files for the \f(CW\*(C`user\*(C'\fR and \f(CW\*(C`scratch\*(C'\fR disks. If the latter are
-not part of the image, they are initialized as empty files when a guest is
-created, with the size given by the \fIsize\fR attribute.
-.IP "\(bu" 4
-the \fIsize\fR attribute giving the size of the disk in \s-1MB\s0.
-.IP "\(bu" 4
-the \fIformat\fR attribute giving the format of the disk file. Currently, this
-can be one of: \f(CW\*(C`raw\*(C'\fR \f(CW\*(C`iso\*(C'\fR, \f(CW\*(C`qcow\*(C'\fR, \f(CW\*(C`qcow2\*(C'\fR, or \f(CW\*(C`vmdk\*(C'\fR.
-.SH "EXAMPLE"
-.IX Header "EXAMPLE"
-The image descriptor below can be used to create a virtual machine running
-the System Rescue \s-1CD\s0 (\f(CW\*(C`http://www.sysresccd.org/\*(C'\fR) Besides the descriptor,
-you only need the \s-1ISO\s0 image from the System Rescue \s-1CD\s0 website.
-.PP
-.Vb 10
-\& <?xml version="1.0" encoding="UTF\-8"?>
-\& <image>
-\& <name>sysresccd</name>
-\& <domain>
-\& <boot type="hvm">
-\& <guest>
-\& <arch>i686</arch>
-\& </guest>
-\& <os>
-\& <loader dev="cdrom"/>
-\& </os>
-\& <drive disk="root.raw" target="hda"/>
-\& <drive disk="sysresc"/>
-\& </boot>
-\& <devices>
-\& <vcpu>1</vcpu>
-\& <memory>262144</memory>
-\& <interface/>
-\& <graphics/>
-\& </devices>
-\& </domain>
-\& <storage>
-\& <disk file="root.raw" use="scratch" size="100" format="raw"/>
-\& <disk id="sysresc" file="isos/systemrescuecd.iso"
-\& use="system" format="iso"/>
-\& </storage>
-\& </image>
-.Ve
-.PP
-To create a virtual machine, save the above \s-1XML\s0 in \fIimage.xml\fR and run:
-.PP
-.Vb 1
-\& # virt\-image \-\-vnc image.xml
-.Ve
-.SH "AUTHOR"
-.IX Header "AUTHOR"
-Written by David Lutterkort. See the \s-1AUTHORS\s0 file in the source distribution
-for the complete list of credits.
-.SH "BUGS"
-.IX Header "BUGS"
-Please see \f(CW\*(C`http://virt\-manager.org/page/BugReporting\*(C'\fR
-.SH "COPYRIGHT"
-.IX Header "COPYRIGHT"
-Copyright (C) 2006\-2012 Red Hat, Inc, and various contributors.
-This is free software. You may redistribute copies of it under the terms
-of the \s-1GNU\s0 General Public License \f(CW\*(C`http://www.gnu.org/licenses/gpl.html\*(C'\fR.
-There is \s-1NO\s0 \s-1WARRANTY\s0, to the extent permitted by law.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fIvirt\-image\fR\|(1), \fIvirt\-install\fR\|(1), the project website
-\&\f(CW\*(C`http://virt\-manager.org\*(C'\fR, the Relax-NG grammar for image \s-1XML\s0 \f(CW\*(C`image.rng\*(C'\fR
diff --git a/man/en/virt-install.1 b/man/en/virt-install.1
deleted file mode 100644
index ab3fa73..0000000
--- a/man/en/virt-install.1
+++ /dev/null
@@ -1,1359 +0,0 @@
-.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
-.\"
-.\" 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" ''
-'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 turned on, 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.
-.ie \nF \{\
-. de IX
-. tm Index:\\$1\t\\n%\t"\\$2"
-..
-. nr % 0
-. rr F
-.\}
-.el \{\
-. de IX
-..
-.\}
-.\"
-.\" 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 "VIRT-INSTALL 1"
-.TH VIRT-INSTALL 1 "2012-07-29" "" "Virtual Machine Install Tools"
-.\" 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"
-virt\-install \- provision new virtual machines
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-\&\fBvirt-install\fR [\s-1OPTION\s0]...
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-\&\fBvirt-install\fR is a command line tool for creating new \s-1KVM\s0, Xen, or Linux
-container guests using the \f(CW\*(C`libvirt\*(C'\fR hypervisor management library.
-See the \s-1EXAMPLES\s0 section at the end of this document to quickly get started.
-.PP
-\&\fBvirt-install\fR tool supports graphical installations using (for example)
-\&\s-1VNC\s0 or \s-1SPICE\s0, as well as text mode installs over serial console. The guest
-can be configured to use one or more virtual disks, network interfaces,
-audio devices, physical \s-1USB\s0 or \s-1PCI\s0 devices, among others.
-.PP
-The installation media can be held locally or remotely on \s-1NFS\s0, \s-1HTTP\s0, \s-1FTP\s0
-servers. In the latter case \f(CW\*(C`virt\-install\*(C'\fR will fetch the minimal files
-necessary to kick off the installation process, allowing the guest
-to fetch the rest of the \s-1OS\s0 distribution as needed. \s-1PXE\s0 booting, and importing
-an existing disk image (thus skipping the install phase) are also supported.
-.PP
-Given suitable command line arguments, \f(CW\*(C`virt\-install\*(C'\fR is capable of running
-completely unattended, with the guest 'kickstarting' itself too. This allows
-for easy automation of guest installs. An interactive mode is also available
-with the \-\-prompt option, but this will only ask for the minimum required
-options.
-.SH "OPTIONS"
-.IX Header "OPTIONS"
-Most options are not required. Minimum requirements are \-\-name, \-\-ram,
-guest storage (\-\-disk, \-\-filesystem or \-\-nodisks), and an install option.
-.IP "\-h, \-\-help" 2
-.IX Item "-h, --help"
-Show the help message and exit
-.IP "\-\-connect=URI" 2
-.IX Item "--connect=URI"
-Connect to a non-default hypervisor. If this isn't specified, libvirt
-will try and choose the most suitable default.
-.Sp
-Some valid options here are:
-.RS 2
-.IP "qemu:///system" 4
-.IX Item "qemu:///system"
-For creating \s-1KVM\s0 and \s-1QEMU\s0 guests to be run by the system libvirtd instance.
-This is the default mode that virt-manager uses, and what most \s-1KVM\s0 users
-want.
-.IP "qemu:///session" 4
-.IX Item "qemu:///session"
-For creating \s-1KVM\s0 and \s-1QEMU\s0 guests for libvirtd running as the regular user.
-.IP "xen:///" 4
-.IX Item "xen:///"
-For connecting to Xen.
-.IP "lxc:///" 4
-.IX Item "lxc:///"
-For creating linux containers
-.RE
-.RS 2
-.RE
-.SS "General Options"
-.IX Subsection "General Options"
-General configuration parameters that apply to all types of guest installs.
-.IP "\-n \s-1NAME\s0, \-\-name=NAME" 2
-.IX Item "-n NAME, --name=NAME"
-Name of the new guest virtual machine instance. This must be unique amongst
-all guests known to the hypervisor on the connection, including those not
-currently active. To re-define an existing guest, use the \f(CWvirsh(1)\fR tool
-to shut it down ('virsh shutdown') & delete ('virsh undefine') it prior to
-running \f(CW\*(C`virt\-install\*(C'\fR.
-.IP "\-r \s-1MEMORY\s0, \-\-ram=MEMORY" 2
-.IX Item "-r MEMORY, --ram=MEMORY"
-Memory to allocate for guest instance in megabytes. If the hypervisor does
-not have enough free memory, it is usual for it to automatically take memory
-away from the host operating system to satisfy this allocation.
-.IP "\-\-arch=ARCH" 2
-.IX Item "--arch=ARCH"
-Request a non-native \s-1CPU\s0 architecture for the guest virtual machine.
-If omitted, the host \s-1CPU\s0 architecture will be used in the guest.
-.IP "\-\-machine=MACHINE" 2
-.IX Item "--machine=MACHINE"
-The machine type to emulate. This will typically not need to be specified
-for Xen or \s-1KVM\s0, but is useful for choosing machine types of more exotic
-architectures.
-.IP "\-u \s-1UUID\s0, \-\-uuid=UUID" 2
-.IX Item "-u UUID, --uuid=UUID"
-\&\s-1UUID\s0 for the guest; if none is given a random \s-1UUID\s0 will be generated. If you
-specify \s-1UUID\s0, you should use a 32\-digit hexadecimal number. \s-1UUID\s0 are intended
-to be unique across the entire data center, and indeed world. Bear this in
-mind if manually specifying a \s-1UUID\s0
-.IP "\-\-vcpus=VCPUS[,maxvcpus=MAX][,sockets=#][,cores=#][,threads=#]" 2
-.IX Item "--vcpus=VCPUS[,maxvcpus=MAX][,sockets=#][,cores=#][,threads=#]"
-Number of virtual cpus to configure for the guest. If 'maxvcpus' is specified,
-the guest will be able to hotplug up to \s-1MAX\s0 vcpus while the guest is running,
-but will startup with \s-1VCPUS\s0.
-.Sp
-\&\s-1CPU\s0 topology can additionally be specified with sockets, cores, and threads.
-If values are omitted, the rest will be autofilled preferring sockets over
-cores over threads.
-.IP "\-\-cpuset=CPUSET" 2
-.IX Item "--cpuset=CPUSET"
-Set which physical cpus the guest can use. \f(CW\*(C`CPUSET\*(C'\fR is a comma separated list of numbers, which can also be specified in ranges or cpus to exclude. Example:
-.Sp
-.Vb 2
-\& 0,2,3,5 : Use processors 0,2,3 and 5
-\& 1\-5,^3,8 : Use processors 1,2,4,5 and 8
-.Ve
-.Sp
-If the value 'auto' is passed, virt-install attempts to automatically determine
-an optimal cpu pinning using \s-1NUMA\s0 data, if available.
-.IP "\-\-numatune=NODESET,[mode=MODE]" 2
-.IX Item "--numatune=NODESET,[mode=MODE]"
-Tune \s-1NUMA\s0 policy for the domain process. Example invocations
-.Sp
-.Vb 2
-\& \-\-numatune 1,2,3,4\-7
-\& \-\-numatune \e"1\-3,5\e",mode=preferred
-.Ve
-.Sp
-Specifies the numa nodes to allocate memory from. This has the same syntax
-as \f(CW\*(C`\-\-cpuset\*(C'\fR option. mode can be one of 'interleave', 'preferred', or
-\&'strict' (the default). See 'man 8 numactl' for information about each
-mode.
-.Sp
-The nodeset string must use escaped-quotes if specifying any other option.
-.IP "\-\-cpu MODEL[,+feature][,\-feature][,match=MATCH][,vendor=VENDOR]" 2
-.IX Item "--cpu MODEL[,+feature][,-feature][,match=MATCH][,vendor=VENDOR]"
-Configure the \s-1CPU\s0 model and \s-1CPU\s0 features exposed to the guest. The only
-required value is \s-1MODEL\s0, which is a valid \s-1CPU\s0 model as listed in libvirt's
-cpu_map.xml file.
-.Sp
-Specific \s-1CPU\s0 features can be specified in a number of ways: using one of
-libvirt's feature policy values force, require, optional, disable, or forbid,
-or with the shorthand '+feature' and '\-feature', which equal 'force=feature'
-and 'disable=feature' respectively
-.Sp
-Some examples:
-.RS 2
-.IP "\fB\-\-cpu core2duo,+x2apic,disable=vmx\fR" 2
-.IX Item "--cpu core2duo,+x2apic,disable=vmx"
-Expose the core2duo \s-1CPU\s0 model, force enable x2apic, but do not expose vmx
-.IP "\fB\-\-cpu host\fR" 2
-.IX Item "--cpu host"
-Expose the host CPUs configuration to the guest. This enables the guest to
-take advantage of many of the host CPUs features (better performance), but
-may cause issues if migrating the guest to a host without an identical \s-1CPU\s0.
-.RE
-.RS 2
-.RE
-.IP "\-\-description" 2
-.IX Item "--description"
-Human readable text description of the virtual machine. This will be stored
-in the guests \s-1XML\s0 configuration for access by other applications.
-.IP "\-\-security type=TYPE[,label=LABEL][,relabel=yes|no]" 2
-.IX Item "--security type=TYPE[,label=LABEL][,relabel=yes|no]"
-Configure domain security driver settings. Type can be either 'static' or
-\&'dynamic'. 'static' configuration requires a security \s-1LABEL\s0. Specifying
-\&\s-1LABEL\s0 without \s-1TYPE\s0 implies static configuration.
-.Sp
-To have libvirt automatically apply your static label, you must specify
-relabel=yes. Otherwise disk images must be manually labeled by the admin,
-including images that virt-install is asked to create.
-.SS "Installation Method options"
-.IX Subsection "Installation Method options"
-.IP "\-c \s-1CDROM\s0, \-\-cdrom=CDROM" 2
-.IX Item "-c CDROM, --cdrom=CDROM"
-File or device use as a virtual CD-ROM device for fully virtualized guests.
-It can be path to an \s-1ISO\s0 image, or to a \s-1CDROM\s0 device. It can also be a \s-1URL\s0
-from which to fetch/access a minimal boot \s-1ISO\s0 image. The URLs take the same
-format as described for the \f(CW\*(C`\-\-location\*(C'\fR argument. If a cdrom has been
-specified via the \f(CW\*(C`\-\-disk\*(C'\fR option, and neither \f(CW\*(C`\-\-cdrom\*(C'\fR nor any other
-install option is specified, the \f(CW\*(C`\-\-disk\*(C'\fR cdrom is used as the install media.
-.IP "\-l \s-1LOCATION\s0, \-\-location=LOCATION" 2
-.IX Item "-l LOCATION, --location=LOCATION"
-Distribution tree installation source. virt-install can recognize
-certain distribution trees and fetches a bootable kernel/initrd pair to
-launch the install.
-.Sp
-With libvirt 0.9.4 or later, network \s-1URL\s0 installs work for remote connections.
-virt-install will download kernel/initrd to the local machine, and then
-upload the media to the remote host. This option requires the \s-1URL\s0 to
-be accessible by both the local and remote host.
-.Sp
-The \f(CW\*(C`LOCATION\*(C'\fR can take one of the following forms:
-.RS 2
-.IP "\s-1DIRECTORY\s0" 4
-.IX Item "DIRECTORY"
-Path to a local directory containing an installable distribution image
-.IP "nfs:host:/path or nfs://host/path" 4
-.IX Item "nfs:host:/path or nfs://host/path"
-An \s-1NFS\s0 server location containing an installable distribution image
-.IP "http://host/path"; 4
-.IX Item "http://host/path";
-An \s-1HTTP\s0 server location containing an installable distribution image
-.IP "ftp://host/path"; 4
-.IX Item "ftp://host/path";
-An \s-1FTP\s0 server location containing an installable distribution image
-.RE
-.RS 2
-.Sp
-Some distro specific url samples:
-.IP "Fedora/Red Hat Based" 4
-.IX Item "Fedora/Red Hat Based"
-http://download.fedoraproject.org/pub/fedora/linux/releases/10/Fedora/i386/os/
-.IP "Debian/Ubuntu" 4
-.IX Item "Debian/Ubuntu"
-http://ftp.us.debian.org/debian/dists/stable/main/installer\-amd64/
-.IP "Suse" 4
-.IX Item "Suse"
-http://download.opensuse.org/distribution/11.0/repo/oss/
-.IP "Mandriva" 4
-.IX Item "Mandriva"
-ftp://ftp.uwsg.indiana.edu/linux/mandrake/official/2009.0/i586/
-.IP "Mageia" 4
-.IX Item "Mageia"
-ftp://distrib\-coffee.ipsl.jussieu.fr/pub/linux/Mageia/distrib/1
-.RE
-.RS 2
-.RE
-.IP "\-\-pxe" 2
-.IX Item "--pxe"
-Use the \s-1PXE\s0 boot protocol to load the initial ramdisk and kernel for starting
-the guest installation process.
-.IP "\-\-import" 2
-.IX Item "--import"
-Skip the \s-1OS\s0 installation process, and build a guest around an existing
-disk image. The device used for booting is the first device specified via
-\&\f(CW\*(C`\-\-disk\*(C'\fR or \f(CW\*(C`\-\-filesystem\*(C'\fR.
-.IP "\-\-init=INITPATH" 2
-.IX Item "--init=INITPATH"
-Path to a binary that the container guest will init. If a root \f(CW\*(C`\-\-filesystem\*(C'\fR
-is has been specified, virt-install will default to /sbin/init, otherwise
-will default to /bin/sh.
-.IP "\-\-livecd" 2
-.IX Item "--livecd"
-Specify that the installation media is a live \s-1CD\s0 and thus the guest
-needs to be configured to boot off the \s-1CDROM\s0 device permanently. It
-may be desirable to also use the \f(CW\*(C`\-\-nodisks\*(C'\fR flag in combination.
-.IP "\-x \s-1EXTRA\s0, \-\-extra\-args=EXTRA" 2
-.IX Item "-x EXTRA, --extra-args=EXTRA"
-Additional kernel command line arguments to pass to the installer when
-performing a guest install from \f(CW\*(C`\-\-location\*(C'\fR. One common usage is specifying
-an anaconda kickstart file for automated installs, such as
-\&\-\-extra\-args \*(L"ks=http://myserver/my.ks\*(R"
-.IP "\-\-initrd\-inject=PATH" 2
-.IX Item "--initrd-inject=PATH"
-Add \s-1PATH\s0 to the root of the initrd fetched with \f(CW\*(C`\-\-location\*(C'\fR. This can be
-used to run an automated install without requiring a network hosted kickstart
-file:
-.Sp
-\&\-\-initrd\-inject=/path/to/my.ks \-\-extra\-args \*(L"ks=file:/my.ks\*(R"
-.IP "\-\-os\-type=OS_TYPE" 2
-.IX Item "--os-type=OS_TYPE"
-Optimize the guest configuration for a type of operating system (ex. 'linux',
-\&'windows'). This will attempt to pick the most suitable \s-1ACPI\s0 & \s-1APIC\s0 settings,
-optimally supported mouse drivers, virtio, and generally accommodate other
-operating system quirks.
-.Sp
-By default, virt-install will attempt to auto detect this value from
-the install media (currently only supported for \s-1URL\s0 installs). Autodetection
-can be disabled with the special value 'none'
-.Sp
-See \f(CW\*(C`\-\-os\-variant\*(C'\fR for valid options.
-.IP "\-\-os\-variant=OS_VARIANT" 2
-.IX Item "--os-variant=OS_VARIANT"
-Further optimize the guest configuration for a specific operating system
-variant (ex. 'fedora8', 'winxp'). This parameter is optional, and does not
-require an \f(CW\*(C`\-\-os\-type\*(C'\fR to be specified.
-.Sp
-By default, virt-install will attempt to auto detect this value from
-the install media (currently only supported for \s-1URL\s0 installs). Autodetection
-can be disabled with the special value 'none'.
-.Sp
-If the special value 'list' is passed, virt-install will print the full
-list of variant values and exit. The printed format is not a stable
-interface, \s-1DO\s0 \s-1NOT\s0 \s-1PARSE\s0 \s-1IT\s0.
-.Sp
-If the special value 'none' is passed, no os variant is recorded and
-\&\s-1OS\s0 autodetection is disabled.
-.Sp
-Values for some recent \s-1OS\s0 options are:
-.RS 2
-.IP "win7 : Microsoft Windows 7" 2
-.IX Item "win7 : Microsoft Windows 7"
-.PD 0
-.IP "vista : Microsoft Windows Vista" 2
-.IX Item "vista : Microsoft Windows Vista"
-.IP "winxp64 : Microsoft Windows \s-1XP\s0 (x86_64)" 2
-.IX Item "winxp64 : Microsoft Windows XP (x86_64)"
-.IP "winxp : Microsoft Windows \s-1XP\s0" 2
-.IX Item "winxp : Microsoft Windows XP"
-.IP "win2k8 : Microsoft Windows Server 2008" 2
-.IX Item "win2k8 : Microsoft Windows Server 2008"
-.IP "win2k3 : Microsoft Windows Server 2003" 2
-.IX Item "win2k3 : Microsoft Windows Server 2003"
-.IP "freebsd8 : FreeBSD 8.x" 2
-.IX Item "freebsd8 : FreeBSD 8.x"
-.IP "generic : Generic" 2
-.IX Item "generic : Generic"
-.IP "debianwheezy : Debian Wheezy" 2
-.IX Item "debianwheezy : Debian Wheezy"
-.IP "debiansqueeze : Debian Squeeze" 2
-.IX Item "debiansqueeze : Debian Squeeze"
-.IP "debianlenny : Debian Lenny" 2
-.IX Item "debianlenny : Debian Lenny"
-.IP "fedora17 : Fedora 17" 2
-.IX Item "fedora17 : Fedora 17"
-.IP "fedora16 : Fedora 16" 2
-.IX Item "fedora16 : Fedora 16"
-.IP "fedora15 : Fedora 15" 2
-.IX Item "fedora15 : Fedora 15"
-.IP "mageia1 : Mageia 1 and later" 2
-.IX Item "mageia1 : Mageia 1 and later"
-.IP "mes5.1 : Mandriva Enterprise Server 5.1 and later" 2
-.IX Item "mes5.1 : Mandriva Enterprise Server 5.1 and later"
-.IP "rhel6 : Red Hat Enterprise Linux 6" 2
-.IX Item "rhel6 : Red Hat Enterprise Linux 6"
-.IP "rhel5.4 : Red Hat Enterprise Linux 5.4 or later" 2
-.IX Item "rhel5.4 : Red Hat Enterprise Linux 5.4 or later"
-.IP "rhel4 : Red Hat Enterprise Linux 4" 2
-.IX Item "rhel4 : Red Hat Enterprise Linux 4"
-.IP "sles11 : Suse Linux Enterprise Server 11" 2
-.IX Item "sles11 : Suse Linux Enterprise Server 11"
-.IP "sles10 : Suse Linux Enterprise Server" 2
-.IX Item "sles10 : Suse Linux Enterprise Server"
-.IP "opensuse12 : openSuse 12" 2
-.IX Item "opensuse12 : openSuse 12"
-.IP "opensuse11 : openSuse 11" 2
-.IX Item "opensuse11 : openSuse 11"
-.IP "ubuntuquantal : Ubuntu 12.10 (Quantal Quetzal)" 2
-.IX Item "ubuntuquantal : Ubuntu 12.10 (Quantal Quetzal)"
-.IP "ubuntuprecise : Ubuntu 12.04 \s-1LTS\s0 (Precise Pangolin)" 2
-.IX Item "ubuntuprecise : Ubuntu 12.04 LTS (Precise Pangolin)"
-.IP "ubuntuoneiric : Ubuntu 11.10 (Oneiric Ocelot)" 2
-.IX Item "ubuntuoneiric : Ubuntu 11.10 (Oneiric Ocelot)"
-.IP "ubuntunatty : Ubuntu 11.04 (Natty Narwhal)" 2
-.IX Item "ubuntunatty : Ubuntu 11.04 (Natty Narwhal)"
-.IP "ubuntulucid : Ubuntu 10.04 \s-1LTS\s0 (Lucid Lynx)" 2
-.IX Item "ubuntulucid : Ubuntu 10.04 LTS (Lucid Lynx)"
-.IP "ubuntuhardy : Ubuntu 8.04 \s-1LTS\s0 (Hardy Heron)" 2
-.IX Item "ubuntuhardy : Ubuntu 8.04 LTS (Hardy Heron)"
-.RE
-.RS 2
-.PD
-.Sp
-Use '\-\-os\-variant list' to see the full \s-1OS\s0 list
-.RE
-.IP "\-\-boot=BOOTOPTS" 2
-.IX Item "--boot=BOOTOPTS"
-Optionally specify the post-install \s-1VM\s0 boot configuration. This option allows
-specifying a boot device order, permanently booting off kernel/initrd with
-option kernel arguments, and enabling a \s-1BIOS\s0 boot menu (requires libvirt
-0.8.3 or later)
-.Sp
-\&\-\-boot can be specified in addition to other install options
-(such as \-\-location, \-\-cdrom, etc.) or can be specified on it's own. In
-the latter case, behavior is similar to the \-\-import install option: there
-is no 'install' phase, the guest is just created and launched as specified.
-.Sp
-Some examples:
-.RS 2
-.IP "\fB\-\-boot cdrom,fd,hd,network,menu=on\fR" 2
-.IX Item "--boot cdrom,fd,hd,network,menu=on"
-Set the boot device priority as first cdrom, first floppy, first harddisk,
-network \s-1PXE\s0 boot. Additionally enable \s-1BIOS\s0 boot menu prompt.
-.ie n .IP "\fB\-\-boot kernel=KERNEL,initrd=INITRD,kernel_args=""console=/dev/ttyS0""\fR" 2
-.el .IP "\fB\-\-boot kernel=KERNEL,initrd=INITRD,kernel_args=``console=/dev/ttyS0''\fR" 2
-.IX Item "--boot kernel=KERNEL,initrd=INITRD,kernel_args=console=/dev/ttyS0"
-Have guest permanently boot off a local kernel/initrd pair, with the
-specified kernel options.
-.IP "\fB\-\-boot loader=BIOSPATH\fR" 2
-.IX Item "--boot loader=BIOSPATH"
-Use \s-1BIOSPATH\s0 as the virtual machine \s-1BIOS\s0. Only valid for fully virtualized
-guests.
-.RE
-.RS 2
-.RE
-.SS "Storage Configuration"
-.IX Subsection "Storage Configuration"
-.IP "\-\-disk=DISKOPTS" 2
-.IX Item "--disk=DISKOPTS"
-Specifies media to use as storage for the guest, with various options. The
-general format of a disk string is
-.Sp
-.Vb 1
-\& \-\-disk opt1=val1,opt2=val2,...
-.Ve
-.Sp
-To specify media, the command can either be:
-.Sp
-.Vb 1
-\& \-\-disk /some/storage/path,opt1=val1
-.Ve
-.Sp
-or explicitly specify one of the following arguments:
-.RS 2
-.IP "\fBpath\fR" 4
-.IX Item "path"
-A path to some storage media to use, existing or not. Existing media can be
-a file or block device. If installing on a remote host, the existing media
-must be shared as a libvirt storage volume.
-.Sp
-Specifying a non-existent path implies attempting to create the new storage,
-and will require specifying a 'size' value. If the base directory of the path
-is a libvirt storage pool on the host, the new storage will be created as a
-libvirt storage volume. For remote hosts, the base directory is required to be
-a storage pool if using this method.
-.IP "\fBpool\fR" 4
-.IX Item "pool"
-An existing libvirt storage pool name to create new storage on. Requires
-specifying a 'size' value.
-.IP "\fBvol\fR" 4
-.IX Item "vol"
-An existing libvirt storage volume to use. This is specified as
-\&'poolname/volname'.
-.RE
-.RS 2
-.Sp
-Other available options:
-.IP "\fBdevice\fR" 4
-.IX Item "device"
-Disk device type. Value can be 'cdrom', 'disk', or 'floppy'. Default is
-\&'disk'. If a 'cdrom' is specified, and no install method is chosen, the
-cdrom is used as the install media.
-.IP "\fBbus\fR" 4
-.IX Item "bus"
-Disk bus type. Value can be 'ide', 'sata', 'scsi', 'usb', 'virtio' or 'xen'.
-The default is hypervisor dependent since not all hypervisors support all
-bus types.
-.IP "\fBperms\fR" 4
-.IX Item "perms"
-Disk permissions. Value can be 'rw' (Read/Write), 'ro' (Readonly),
-or 'sh' (Shared Read/Write). Default is 'rw'
-.IP "\fBsize\fR" 4
-.IX Item "size"
-size (in \s-1GB\s0) to use if creating new storage
-.IP "\fBsparse\fR" 4
-.IX Item "sparse"
-whether to skip fully allocating newly created storage. Value is 'true' or
-\&'false'. Default is 'true' (do not fully allocate).
-.Sp
-The initial time taken to fully-allocate the guest virtual disk (sparse=false)
-will be usually by balanced by faster install times inside the guest. Thus
-use of this option is recommended to ensure consistently high performance
-and to avoid I/O errors in the guest should the host filesystem fill up.
-.IP "\fBcache\fR" 4
-.IX Item "cache"
-The cache mode to be used. The host pagecache provides cache memory.
-The cache value can be 'none', 'writethrough', or 'writeback'.
-\&'writethrough' provides read caching. 'writeback' provides
-read and write caching.
-.IP "\fBformat\fR" 4
-.IX Item "format"
-Image format to be used if creating managed storage. For file volumes, this
-can be 'raw', 'qcow2', 'vmdk', etc. See format types in
-<http://libvirt.org/storage.html> for possible values. This is often
-mapped to the \fBdriver_type\fR value as well.
-.Sp
-With libvirt 0.8.3 and later, this option should be specified if reusing
-and existing disk image, since libvirt does not autodetect storage format
-as it is a potential security issue. For example, if reusing an existing
-qcow2 image, you will want to specify format=qcow2, otherwise the hypervisor
-may not be able to read your disk image.
-.IP "\fBdriver_name\fR" 4
-.IX Item "driver_name"
-Driver name the hypervisor should use when accessing the specified
-storage. Typically does not need to be set by the user.
-.IP "\fBdriver_type\fR" 4
-.IX Item "driver_type"
-Driver format/type the hypervisor should use when accessing the specified
-storage. Typically does not need to be set by the user.
-.IP "\fBio\fR" 4
-.IX Item "io"
-Disk \s-1IO\s0 backend. Can be either \*(L"threads\*(R" or \*(L"native\*(R".
-.IP "\fBerror_policy\fR" 4
-.IX Item "error_policy"
-How guest should react if a write error is encountered. Can be one of
-\&\*(L"stop\*(R", \*(L"ignore\*(R", or \*(L"enospace\*(R"
-.IP "\fBserial\fR" 4
-.IX Item "serial"
-Serial number of the emulated disk device. This is used in linux guests
-to set /dev/disk/by\-id symlinks. An example serial number might be:
-\&\s-1WD\-WMAP9A966149\s0
-.RE
-.RS 2
-.Sp
-See the examples section for some uses. This option deprecates \f(CW\*(C`\-\-file\*(C'\fR,
-\&\f(CW\*(C`\-\-file\-size\*(C'\fR, and \f(CW\*(C`\-\-nonsparse\*(C'\fR.
-.RE
-.IP "\-\-filesystem" 2
-.IX Item "--filesystem"
-Specifies a directory on the host to export to the guest. The most simple
-invocation is:
-.Sp
-.Vb 1
-\& \-\-filesystem /source/on/host,/target/point/in/guest
-.Ve
-.Sp
-Which will work for recent \s-1QEMU\s0 and linux guest \s-1OS\s0 or \s-1LXC\s0 containers. For
-\&\s-1QEMU\s0, the target point is just a mounting hint in sysfs, so will not be
-automatically mounted.
-.Sp
-The following explicit options can be specified:
-.RS 2
-.IP "\fBtype\fR" 4
-.IX Item "type"
-The type or the source directory. Valid values are 'mount' (the default) or
-\&'template' for OpenVZ templates.
-.IP "\fBmode\fR" 4
-.IX Item "mode"
-The access mode for the source directory from the guest \s-1OS\s0. Only used with
-\&\s-1QEMU\s0 and type=mount. Valid modes are 'passthrough' (the default), 'mapped',
-or 'squash'. See libvirt domain \s-1XML\s0 documentation for more info.
-.IP "\fBsource\fR" 4
-.IX Item "source"
-The directory on the host to share.
-.IP "\fBtarget\fR" 4
-.IX Item "target"
-The mount location to use in the guest.
-.RE
-.RS 2
-.RE
-.IP "\-\-nodisks" 2
-.IX Item "--nodisks"
-Request a virtual machine without any local disk storage, typically used for
-running 'Live \s-1CD\s0' images or installing to network storage (iSCSI or \s-1NFS\s0 root).
-.IP "\-f \s-1DISKFILE\s0, \-\-file=DISKFILE" 2
-.IX Item "-f DISKFILE, --file=DISKFILE"
-This option is deprecated in favor of \f(CW\*(C`\-\-disk path=DISKFILE\*(C'\fR.
-.IP "\-s \s-1DISKSIZE\s0, \-\-file\-size=DISKSIZE" 2
-.IX Item "-s DISKSIZE, --file-size=DISKSIZE"
-This option is deprecated in favor of \f(CW\*(C`\-\-disk ...,size=DISKSIZE,...\*(C'\fR
-.IP "\-\-nonsparse" 2
-.IX Item "--nonsparse"
-This option is deprecated in favor of \f(CW\*(C`\-\-disk ...,sparse=false,...\*(C'\fR
-.SS "Networking Configuration"
-.IX Subsection "Networking Configuration"
-.IP "\-w \s-1NETWORK\s0, \-\-network=NETWORK,opt1=val1,opt2=val2" 2
-.IX Item "-w NETWORK, --network=NETWORK,opt1=val1,opt2=val2"
-Connect the guest to the host network. The value for \f(CW\*(C`NETWORK\*(C'\fR can take
-one of 3 formats:
-.RS 2
-.IP "bridge=BRIDGE" 4
-.IX Item "bridge=BRIDGE"
-Connect to a bridge device in the host called \f(CW\*(C`BRIDGE\*(C'\fR. Use this option if
-the host has static networking config & the guest requires full outbound
-and inbound connectivity to/from the \s-1LAN\s0. Also use this if live migration
-will be used with this guest.
-.IP "network=NAME" 4
-.IX Item "network=NAME"
-Connect to a virtual network in the host called \f(CW\*(C`NAME\*(C'\fR. Virtual networks
-can be listed, created, deleted using the \f(CW\*(C`virsh\*(C'\fR command line tool. In
-an unmodified install of \f(CW\*(C`libvirt\*(C'\fR there is usually a virtual network
-with a name of \f(CW\*(C`default\*(C'\fR. Use a virtual network if the host has dynamic
-networking (eg NetworkManager), or using wireless. The guest will be
-NATed to the \s-1LAN\s0 by whichever connection is active.
-.IP "user" 4
-.IX Item "user"
-Connect to the \s-1LAN\s0 using \s-1SLIRP\s0. Only use this if running a \s-1QEMU\s0 guest as
-an unprivileged user. This provides a very limited form of \s-1NAT\s0.
-.RE
-.RS 2
-.Sp
-If this option is omitted a single \s-1NIC\s0 will be created in the guest. If
-there is a bridge device in the host with a physical interface enslaved,
-that will be used for connectivity. Failing that, the virtual network
-called \f(CW\*(C`default\*(C'\fR will be used. This option can be specified multiple
-times to setup more than one \s-1NIC\s0.
-.Sp
-Other available options are:
-.IP "\fBmodel\fR" 4
-.IX Item "model"
-Network device model as seen by the guest. Value can be any nic model supported
-by the hypervisor, e.g.: 'e1000', 'rtl8139', 'virtio', ...
-.IP "\fBmac\fR" 4
-.IX Item "mac"
-Fixed \s-1MAC\s0 address for the guest; If this parameter is omitted, or the value
-\&\f(CW\*(C`RANDOM\*(C'\fR is specified a suitable address will be randomly generated. For
-Xen virtual machines it is required that the first 3 pairs in the \s-1MAC\s0 address
-be the sequence '00:16:3e', while for \s-1QEMU\s0 or \s-1KVM\s0 virtual machines it must
-be '52:54:00'.
-.RE
-.RS 2
-.RE
-.IP "\-\-nonetworks" 2
-.IX Item "--nonetworks"
-Request a virtual machine without any network interfaces.
-.IP "\-b \s-1BRIDGE\s0, \-\-bridge=BRIDGE" 2
-.IX Item "-b BRIDGE, --bridge=BRIDGE"
-This parameter is deprecated in favour of
-\&\f(CW\*(C`\-\-network bridge=bridge_name\*(C'\fR.
-.IP "\-m \s-1MAC\s0, \-\-mac=MAC" 2
-.IX Item "-m MAC, --mac=MAC"
-This parameter is deprecated in favour of \f(CW\*(C`\-\-network NETWORK,mac=12:34...\*(C'\fR
-.SS "Graphics Configuration"
-.IX Subsection "Graphics Configuration"
-If no graphics option is specified, \f(CW\*(C`virt\-install\*(C'\fR will default to
-\&'\-\-graphics vnc' if the \s-1DISPLAY\s0 environment variable is set, otherwise
-\&'\-\-graphics none' is used.
-.IP "\-\-graphics \s-1TYPE\s0,opt1=arg1,opt2=arg2,..." 2
-.IX Item "--graphics TYPE,opt1=arg1,opt2=arg2,..."
-Specifies the graphical display configuration. This does not configure any
-virtual hardware, just how the guest's graphical display can be accessed.
-Typically the user does not need to specify this option, virt-install will
-try and choose a useful default, and launch a suitable connection.
-.Sp
-General format of a graphical string is
-.Sp
-.Vb 1
-\& \-\-graphics TYPE,opt1=arg1,opt2=arg2,...
-.Ve
-.Sp
-For example:
-.Sp
-.Vb 1
-\& \-\-graphics vnc,password=foobar
-.Ve
-.Sp
-The supported options are:
-.RS 2
-.IP "\fBtype\fR" 4
-.IX Item "type"
-The display type. This is one of:
-.Sp
-vnc
-.Sp
-Setup a virtual console in the guest and export it as a \s-1VNC\s0 server in
-the host. Unless the \f(CW\*(C`port\*(C'\fR parameter is also provided, the \s-1VNC\s0
-server will run on the first free port number at 5900 or above. The
-actual \s-1VNC\s0 display allocated can be obtained using the \f(CW\*(C`vncdisplay\*(C'\fR
-command to \f(CW\*(C`virsh\*(C'\fR (or \fIvirt\-viewer\fR\|(1) can be used which handles this
-detail for the use).
-.Sp
-sdl
-.Sp
-Setup a virtual console in the guest and display an \s-1SDL\s0 window in the
-host to render the output. If the \s-1SDL\s0 window is closed the guest may
-be unconditionally terminated.
-.Sp
-spice
-.Sp
-Export the guest's console using the Spice protocol. Spice allows advanced
-features like audio and \s-1USB\s0 device streaming, as well as improved graphical
-performance.
-.Sp
-Using spice graphic type will work as if those arguments were given:
-.Sp
-.Vb 1
-\& \-\-video qxl \-\-channel spicevmc
-.Ve
-.Sp
-none
-.Sp
-No graphical console will be allocated for the guest. Fully virtualized guests
-(Xen \s-1FV\s0 or QEmu/KVM) will need to have a text console configured on the first
-serial port in the guest (this can be done via the \-\-extra\-args option). Xen
-\&\s-1PV\s0 will set this up automatically. The command 'virsh console \s-1NAME\s0' can be
-used to connect to the serial device.
-.IP "\fBport\fR" 4
-.IX Item "port"
-Request a permanent, statically assigned port number for the guest
-console. This is used by 'vnc' and 'spice'
-.IP "\fBtlsport\fR" 4
-.IX Item "tlsport"
-Specify the spice tlsport.
-.IP "\fBlisten\fR" 4
-.IX Item "listen"
-Address to listen on for VNC/Spice connections. Default is typically 127.0.0.1
-(localhost only), but some hypervisors allow changing this globally (for
-example, the qemu driver default can be changed in /etc/libvirt/qemu.conf).
-Use 0.0.0.0 to allow access from other machines. This is use by 'vnc' and
-\&'spice'
-.IP "\fBkeymap\fR" 4
-.IX Item "keymap"
-Request that the virtual \s-1VNC\s0 console be configured to run with a specific
-keyboard layout. If the special value 'local' is specified, virt-install
-will attempt to configure to use the same keymap as the local system. A value
-of 'none' specifically defers to the hypervisor. Default behavior is
-hypervisor specific, but typically is the same as 'local'. This is used
-by 'vnc'
-.IP "\fBpassword\fR" 4
-.IX Item "password"
-Request a \s-1VNC\s0 password, required at connection time. Beware, this info may
-end up in virt-install log files, so don't use an important password. This
-is used by 'vnc' and 'spice'
-.IP "\fBpasswordvalidto\fR" 4
-.IX Item "passwordvalidto"
-Set an expiration date for password. After the date/time has passed,
-all new graphical connections are denied until a new password is set.
-This is used by 'vnc' and 'spice'
-.Sp
-The format for this value is \s-1YYYY\-MM\-DDTHH:MM:SS\s0, for example
-2011\-04\-01T14:30:15
-.RE
-.RS 2
-.RE
-.IP "\-\-vnc" 2
-.IX Item "--vnc"
-This option is deprecated in favor of \f(CW\*(C`\-\-graphics vnc,...\*(C'\fR
-.IP "\-\-vncport=VNCPORT" 2
-.IX Item "--vncport=VNCPORT"
-This option is deprecated in favor of \f(CW\*(C`\-\-graphics vnc,port=PORT,...\*(C'\fR
-.IP "\-\-vnclisten=VNCLISTEN" 2
-.IX Item "--vnclisten=VNCLISTEN"
-This option is deprecated in favor of \f(CW\*(C`\-\-graphics vnc,listen=LISTEN,...\*(C'\fR
-.IP "\-k \s-1KEYMAP\s0, \-\-keymap=KEYMAP" 2
-.IX Item "-k KEYMAP, --keymap=KEYMAP"
-This option is deprecated in favor of \f(CW\*(C`\-\-graphics vnc,keymap=KEYMAP,...\*(C'\fR
-.IP "\-\-sdl" 2
-.IX Item "--sdl"
-This option is deprecated in favor of \f(CW\*(C`\-\-graphics sdl,...\*(C'\fR
-.IP "\-\-nographics" 2
-.IX Item "--nographics"
-This option is deprecated in favor of \f(CW\*(C`\-\-graphics none\*(C'\fR
-.IP "\-\-noautoconsole" 2
-.IX Item "--noautoconsole"
-Don't automatically try to connect to the guest console. The default behaviour
-is to launch a \s-1VNC\s0 client to display the graphical console, or to run the
-\&\f(CW\*(C`virsh\*(C'\fR \f(CW\*(C`console\*(C'\fR command to display the text console. Use of this parameter
-will disable this behaviour.
-.SS "Virtualization Type options"
-.IX Subsection "Virtualization Type options"
-Options to override the default virtualization type choices.
-.IP "\-v, \-\-hvm" 2
-.IX Item "-v, --hvm"
-Request the use of full virtualization, if both para & full virtualization are
-available on the host. This parameter may not be available if connecting to a
-Xen hypervisor on a machine without hardware virtualization support. This
-parameter is implied if connecting to a \s-1QEMU\s0 based hypervisor.
-.IP "\-p, \-\-paravirt" 2
-.IX Item "-p, --paravirt"
-This guest should be a paravirtualized guest. If the host supports both
-para & full virtualization, and neither this parameter nor the \f(CW\*(C`\-\-hvm\*(C'\fR
-are specified, this will be assumed.
-.IP "\-\-container" 2
-.IX Item "--container"
-This guest should be a container type guest. This option is only required
-if the hypervisor supports other guest types as well (so for example this
-option is the default behavior for \s-1LXC\s0 and OpenVZ, but is provided for
-completeness).
-.IP "\-\-virt\-type" 2
-.IX Item "--virt-type"
-The hypervisor to install on. Example choices are kvm, qemu, xen, or kqemu.
-Available options are listed via 'virsh capabilities' in the <domain> tags.
-.IP "\-\-accelerate" 2
-.IX Item "--accelerate"
-Prefer \s-1KVM\s0 or \s-1KQEMU\s0 (in that order) if installing a \s-1QEMU\s0 guest. This behavior
-is now the default, and this option is deprecated. To install a plain \s-1QEMU\s0
-guest, use '\-\-virt\-type qemu'
-.IP "\-\-noapic" 2
-.IX Item "--noapic"
-Force disable \s-1APIC\s0 for the guest.
-.IP "\-\-noacpi" 2
-.IX Item "--noacpi"
-Force disable \s-1ACPI\s0 for the guest.
-.SS "Device Options"
-.IX Subsection "Device Options"
-.IP "\-\-controller=TYPE[,OPTS]" 2
-.IX Item "--controller=TYPE[,OPTS]"
-Attach a controller device to the guest. \s-1TYPE\s0 is one of:
-\&\fBide\fR, \fBfdc\fR, \fBscsi\fR, \fBsata\fR, \fBvirtio-serial\fR, or \fBusb\fR.
-.RS 2
-.IP "\fBmodel\fR" 4
-.IX Item "model"
-Controller model.
-.IP "\fBaddress\fR" 4
-.IX Item "address"
-Controller address, current \s-1PCI\s0 of form 'bus:domain:slot:function'.
-.IP "\fBindex\fR" 4
-.IX Item "index"
-A decimal integer describing in which order the bus controller is
-encountered, and to reference the controller bus.
-.IP "\fBmaster\fR" 4
-.IX Item "master"
-Applicable to \s-1USB\s0 companion controllers, to define the master bus startport.
-.RE
-.RS 2
-.Sp
-Example:
-.IP "\fB\-\-controller usb,model=ich9\-uhci2,address=0:0:4.7,index=0,master=2\fR" 4
-.IX Item "--controller usb,model=ich9-uhci2,address=0:0:4.7,index=0,master=2"
-Adds a \s-1ICH9\s0 \s-1USB\s0 companion controller on \s-1PCI\s0 address 0:0:4.7 with
-master bus 0 and first port 2.
-.RE
-.RS 2
-.RE
-.IP "\-\-host\-device=HOSTDEV" 2
-.IX Item "--host-device=HOSTDEV"
-Attach a physical host device to the guest. Some example values for \s-1HOSTDEV:\s0
-.RS 2
-.IP "\fB\-\-host\-device pci_0000_00_1b_0\fR" 2
-.IX Item "--host-device pci_0000_00_1b_0"
-A node device name via libvirt, as shown by 'virsh nodedev\-list'
-.IP "\fB\-\-host\-device 001.003\fR" 2
-.IX Item "--host-device 001.003"
-\&\s-1USB\s0 by bus, device (via lsusb).
-.IP "\fB\-\-host\-device 0x1234:0x5678\fR" 2
-.IX Item "--host-device 0x1234:0x5678"
-\&\s-1USB\s0 by vendor, product (via lsusb).
-.IP "\fB\-\-host\-device 1f.01.02\fR" 2
-.IX Item "--host-device 1f.01.02"
-\&\s-1PCI\s0 device (via lspci).
-.RE
-.RS 2
-.RE
-.IP "\-\-soundhw \s-1MODEL\s0" 2
-.IX Item "--soundhw MODEL"
-Attach a virtual audio device to the guest. \s-1MODEL\s0 specifies the emulated
-sound card model. Possible values are ich6, ac97, es1370, sb16, pcspk,
-or default. 'default' will try to pick the best model that the specified
-\&\s-1OS\s0 supports.
-.Sp
-This deprecates the old boolean \-\-sound option (which still works the same
-as a single '\-\-soundhw default')
-.IP "\-\-watchdog MODEL[,action=ACTION]" 2
-.IX Item "--watchdog MODEL[,action=ACTION]"
-Attach a virtual hardware watchdog device to the guest. This requires a
-daemon and device driver in the guest. The watchdog fires a signal when
-the virtual machine appears to hung. \s-1ACTION\s0 specifies what libvirt will do
-when the watchdog fires. Values are
-.RS 2
-.IP "\fBreset\fR" 4
-.IX Item "reset"
-Forcefully reset the guest (the default)
-.IP "\fBpoweroff\fR" 4
-.IX Item "poweroff"
-Forcefully power off the guest
-.IP "\fBpause\fR" 4
-.IX Item "pause"
-Pause the guest
-.IP "\fBnone\fR" 4
-.IX Item "none"
-Do nothing
-.IP "\fBshutdown\fR" 4
-.IX Item "shutdown"
-Gracefully shutdown the guest (not recommended, since a hung guest probably
-won't respond to a graceful shutdown)
-.RE
-.RS 2
-.Sp
-\&\s-1MODEL\s0 is the emulated device model: either i6300esb (the default) or ib700.
-Some examples:
-.Sp
-Use the recommended settings:
-.Sp
-\&\-\-watchdog default
-.Sp
-Use the i6300esb with the 'poweroff' action
-.Sp
-\&\-\-watchdog i6300esb,action=poweroff
-.RE
-.IP "\-\-parallel=CHAROPTS" 2
-.IX Item "--parallel=CHAROPTS"
-.PD 0
-.IP "\-\-serial=CHAROPTS" 2
-.IX Item "--serial=CHAROPTS"
-.PD
-Specifies a serial device to attach to the guest, with various options. The
-general format of a serial string is
-.Sp
-.Vb 1
-\& \-\-serial type,opt1=val1,opt2=val2,...
-.Ve
-.Sp
-\&\-\-serial and \-\-parallel devices share all the same options, unless otherwise
-noted. Some of the types of character device redirection are:
-.RS 2
-.IP "\fB\-\-serial pty\fR" 4
-.IX Item "--serial pty"
-Pseudo \s-1TTY\s0. The allocated pty will be listed in the running guests \s-1XML\s0
-description.
-.IP "\fB\-\-serial dev,path=HOSTPATH\fR" 4
-.IX Item "--serial dev,path=HOSTPATH"
-Host device. For serial devices, this could be /dev/ttyS0. For parallel
-devices, this could be /dev/parport0.
-.IP "\fB\-\-serial file,path=FILENAME\fR" 4
-.IX Item "--serial file,path=FILENAME"
-Write output to \s-1FILENAME\s0.
-.IP "\fB\-\-serial pipe,path=PIPEPATH\fR" 4
-.IX Item "--serial pipe,path=PIPEPATH"
-Named pipe (see \fIpipe\fR\|(7))
-.IP "\fB\-\-serial tcp,host=HOST:PORT,mode=MODE,protocol=PROTOCOL\fR" 4
-.IX Item "--serial tcp,host=HOST:PORT,mode=MODE,protocol=PROTOCOL"
-\&\s-1TCP\s0 net console. \s-1MODE\s0 is either 'bind' (wait for connections on \s-1HOST:PORT\s0)
-or 'connect' (send output to \s-1HOST:PORT\s0), default is 'bind'. \s-1HOST\s0 defaults
-to '127.0.0.1', but \s-1PORT\s0 is required. \s-1PROTOCOL\s0 can be either 'raw' or 'telnet'
-(default 'raw'). If 'telnet', the port acts like a telnet server or client.
-Some examples:
-.Sp
-Wait for connections on any address, port 4567:
-.Sp
-\&\-\-serial tcp,host=0.0.0.0:4567
-.Sp
-Connect to localhost, port 1234:
-.Sp
-\&\-\-serial tcp,host=:1234,mode=connect
-.Sp
-Wait for telnet connection on localhost, port 2222. The user could then
-connect interactively to this console via 'telnet localhost 2222':
-.Sp
-\&\-\-serial tcp,host=:2222,mode=bind,protocol=telnet
-.IP "\fB\-\-serial udp,host=CONNECT_HOST:PORT,bind_host=BIND_HOST:BIND_PORT\fR" 4
-.IX Item "--serial udp,host=CONNECT_HOST:PORT,bind_host=BIND_HOST:BIND_PORT"
-\&\s-1UDP\s0 net console. \s-1HOST:PORT\s0 is the destination to send output to (default
-\&\s-1HOST\s0 is '127.0.0.1', \s-1PORT\s0 is required). \s-1BIND_HOST:BIND_PORT\s0 is the optional
-local address to bind to (default \s-1BIND_HOST\s0 is 127.0.0.1, but is only set if
-\&\s-1BIND_PORT\s0 is specified). Some examples:
-.Sp
-Send output to default syslog port (may need to edit /etc/rsyslog.conf
-accordingly):
-.Sp
-\&\-\-serial udp,host=:514
-.Sp
-Send output to remote host 192.168.10.20, port 4444 (this output can be
-read on the remote host using 'nc \-u \-l 4444'):
-.Sp
-\&\-\-serial udp,host=192.168.10.20:4444
-.IP "\fB\-\-serial unix,path=UNIXPATH,mode=MODE\fR" 4
-.IX Item "--serial unix,path=UNIXPATH,mode=MODE"
-Unix socket, see \fIunix\fR\|(7). \s-1MODE\s0 has similar behavior and defaults as
-\&\-\-serial tcp,mode=MODE
-.RE
-.RS 2
-.RE
-.IP "\-\-channel" 2
-.IX Item "--channel"
-Specifies a communication channel device to connect the guest and host
-machine. This option uses the same options as \-\-serial and \-\-parallel
-for specifying the host/source end of the channel. Extra 'target' options
-are used to specify how the guest machine sees the channel.
-.Sp
-Some of the types of character device redirection are:
-.RS 2
-.IP "\fB\-\-channel \s-1SOURCE\s0,target_type=guestfwd,target_address=HOST:PORT\fR" 4
-.IX Item "--channel SOURCE,target_type=guestfwd,target_address=HOST:PORT"
-Communication channel using \s-1QEMU\s0 usermode networking stack. The guest can
-connect to the channel using the specified \s-1HOST:PORT\s0 combination.
-.IP "\fB\-\-channel \s-1SOURCE\s0,target_type=virtio[,name=NAME]\fR" 4
-.IX Item "--channel SOURCE,target_type=virtio[,name=NAME]"
-Communication channel using virtio serial (requires 2.6.34 or later host and
-guest). Each instance of a virtio \-\-channel line is exposed in the
-guest as /dev/vport0p1, /dev/vport0p2, etc. \s-1NAME\s0 is optional metadata, and
-can be any string, such as org.linux\-kvm.virtioport1.
-If specified, this will be exposed in the guest at
-/sys/class/virtio\-ports/vport0p1/NAME
-.IP "\fB\-\-channel spicevmc,target_type=virtio[,name=NAME]\fR" 4
-.IX Item "--channel spicevmc,target_type=virtio[,name=NAME]"
-Communication channel for \s-1QEMU\s0 spice agent, using virtio serial
-(requires 2.6.34 or later host and guest). \s-1NAME\s0 is optional metadata,
-and can be any string, such as the default com.redhat.spice.0 that
-specifies how the guest will see the channel.
-.RE
-.RS 2
-.RE
-.IP "\-\-console" 2
-.IX Item "--console"
-Connect a text console between the guest and host. Certain guest and
-hypervisor combinations can automatically set up a getty in the guest, so
-an out of the box text login can be provided (target_type=xen for xen
-paravirt guests, and possibly target_type=virtio in the future).
-.Sp
-Example:
-.RS 2
-.IP "\fB\-\-console pty,target_type=virtio\fR" 4
-.IX Item "--console pty,target_type=virtio"
-Connect a virtio console to the guest, redirected to a \s-1PTY\s0 on the host.
-For supported guests, this exposes /dev/hvc0 in the guest. See
-http://fedoraproject.org/wiki/Features/VirtioSerial for more info. virtio
-console requires libvirt 0.8.3 or later.
-.RE
-.RS 2
-.RE
-.IP "\-\-video=VIDEO" 2
-.IX Item "--video=VIDEO"
-Specify what video device model will be attached to the guest. Valid values
-for \s-1VIDEO\s0 are hypervisor specific, but some options for recent kvm are
-cirrus, vga, qxl, or vmvga (vmware).
-.IP "\-\-smartcard=MODE[,OPTS]" 2
-.IX Item "--smartcard=MODE[,OPTS]"
-Configure a virtual smartcard device.
-.Sp
-Mode is one of \fBhost\fR, \fBhost-certificates\fR, or \fBpassthrough\fR. Additional
-options are:
-.RS 2
-.IP "\fBtype\fR" 4
-.IX Item "type"
-Character device type to connect to on the host. This is only applicable
-for \fBpassthrough\fR mode.
-.RE
-.RS 2
-.Sp
-An example invocation:
-.IP "\fB\-\-smartcard passthrough,type=spicevmc\fR" 4
-.IX Item "--smartcard passthrough,type=spicevmc"
-Use the smartcard channel of a \s-1SPICE\s0 graphics device to pass smartcard info
-to the guest
-.RE
-.RS 2
-.Sp
-See \f(CW\*(C`http://libvirt.org/formatdomain.html#elementsSmartcard\*(C'\fR for complete
-details.
-.RE
-.IP "\-\-redirdev=BUS[,OPTS]" 2
-.IX Item "--redirdev=BUS[,OPTS]"
-Add a redirected device.
-.RS 2
-.IP "\fBtype\fR" 4
-.IX Item "type"
-The redirection type, currently supported is \fBtcp\fR or \fBspicevmc\fR.
-.IP "\fBserver\fR" 4
-.IX Item "server"
-The \s-1TCP\s0 server connection details, of the form 'server:port'.
-.RE
-.RS 2
-.Sp
-Examples of invocation:
-.IP "\fB\-\-redirdev usb,type=tcp,server=localhost:4000\fR" 4
-.IX Item "--redirdev usb,type=tcp,server=localhost:4000"
-Add a \s-1USB\s0 redirected device provided by the \s-1TCP\s0 server on 'localhost'
-port 4000.
-.IP "\fB\-\-redirdev usb,type=spicevmc\fR" 4
-.IX Item "--redirdev usb,type=spicevmc"
-Add a \s-1USB\s0 device redirected via a dedicated Spice channel.
-.RE
-.RS 2
-.RE
-.IP "\-\-memballoon \s-1MODEL\s0" 2
-.IX Item "--memballoon MODEL"
-Attach a virtual memory balloon device to the guest. If the memballoon device
-needs to be explicitly disabled, MODEL='none' is used.
-.Sp
-\&\s-1MODEL\s0 is the type of memballoon device provided. The value can be 'virtio',
-\&'xen' or 'none'.
-Some examples:
-.Sp
-Use the recommended settings:
-.Sp
-\&\-\-memballoon virtio
-.Sp
-Do not use memballoon device:
-.Sp
-\&\-\-memballoon none
-.SS "Miscellaneous Options"
-.IX Subsection "Miscellaneous Options"
-.IP "\-\-autostart" 2
-.IX Item "--autostart"
-Set the autostart flag for a domain. This causes the domain to be started
-on host boot up.
-.IP "\-\-print\-xml" 2
-.IX Item "--print-xml"
-If the requested guest has no install phase (\-\-import, \-\-boot), print the
-generated \s-1XML\s0 instead of defining the guest. By default this \s-1WILL\s0 do storage
-creation (can be disabled with \-\-dry\-run).
-.Sp
-If the guest has an install phase, you will need to use \-\-print\-step to
-specify exactly what \s-1XML\s0 output you want. This option implies \-\-quiet.
-.IP "\-\-print\-step" 2
-.IX Item "--print-step"
-Acts similarly to \-\-print\-xml, except requires specifying which install step
-to print \s-1XML\s0 for. Possible values are 1, 2, 3, or all. Stage 1 is typically
-booting from the install media, and stage 2 is typically the final guest
-config booting off hardisk. Stage 3 is only relevant for windows installs,
-which by default have a second install stage. This option implies \-\-quiet.
-.IP "\-\-noreboot" 2
-.IX Item "--noreboot"
-Prevent the domain from automatically rebooting after the install has
-completed.
-.IP "\-\-wait=WAIT" 2
-.IX Item "--wait=WAIT"
-Amount of time to wait (in minutes) for a \s-1VM\s0 to complete its install.
-Without this option, virt-install will wait for the console to close (not
-necessarily indicating the guest has shutdown), or in the case of
-\&\-\-noautoconsole, simply kick off the install and exit. Any negative
-value will make virt-install wait indefinitely, a value of 0 triggers the
-same results as noautoconsole. If the time limit is exceeded, virt-install
-simply exits, leaving the virtual machine in its current state.
-.IP "\-\-force" 2
-.IX Item "--force"
-Prevent interactive prompts. If the intended prompt was a yes/no prompt, always
-say yes. For any other prompts, the application will exit.
-.IP "\-\-dry\-run" 2
-.IX Item "--dry-run"
-Proceed through the guest creation process, but do \s-1NOT\s0 create storage devices,
-change host device configuration, or actually teach libvirt about the guest.
-virt-install may still fetch install media, since this is required to
-properly detect the \s-1OS\s0 to install.
-.IP "\-\-prompt" 2
-.IX Item "--prompt"
-Specifically enable prompting for required information. Default prompting
-is off (as of virtinst 0.400.0)
-.IP "\-\-check\-cpu" 2
-.IX Item "--check-cpu"
-Check that the number virtual cpus requested does not exceed physical CPUs and
-warn if they do.
-.IP "\-q, \-\-quiet" 2
-.IX Item "-q, --quiet"
-Only print fatal error messages.
-.IP "\-d, \-\-debug" 2
-.IX Item "-d, --debug"
-Print debugging information to the terminal when running the install process.
-The debugging information is also stored in \f(CW\*(C`$HOME/.virtinst/virt\-install.log\*(C'\fR
-even if this parameter is omitted.
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-Install a Fedora 13 \s-1KVM\s0 guest with virtio accelerated disk/network,
-creating a new 8GB storage file, installing from media in the hosts
-\&\s-1CDROM\s0 drive, auto launching a graphical \s-1VNC\s0 viewer
-.PP
-.Vb 9
-\& # virt\-install \e
-\& \-\-connect qemu:///system \e
-\& \-\-virt\-type kvm \e
-\& \-\-name demo \e
-\& \-\-ram 500 \e
-\& \-\-disk path=/var/lib/libvirt/images/demo.img,size=8 \e
-\& \-\-graphics vnc \e
-\& \-\-cdrom /dev/cdrom \e
-\& \-\-os\-variant fedora13
-.Ve
-.PP
-Install a Fedora 9 plain \s-1QEMU\s0 guest, using \s-1LVM\s0 partition, virtual networking,
-booting from \s-1PXE\s0, using \s-1VNC\s0 server/viewer
-.PP
-.Vb 9
-\& # virt\-install \e
-\& \-\-connect qemu:///system \e
-\& \-\-name demo \e
-\& \-\-ram 500 \e
-\& \-\-disk path=/dev/HostVG/DemoVM \e
-\& \-\-network network=default \e
-\& \-\-virt\-type qemu
-\& \-\-graphics vnc \e
-\& \-\-os\-variant fedora9
-.Ve
-.PP
-Install a guest with a real partition, with the default \s-1QEMU\s0 hypervisor for
-a different architecture using \s-1SDL\s0 graphics, using a remote kernel and initrd
-pair:
-.PP
-.Vb 9
-\& # virt\-install \e
-\& \-\-connect qemu:///system \e
-\& \-\-name demo \e
-\& \-\-ram 500 \e
-\& \-\-disk path=/dev/hdc \e
-\& \-\-network bridge=eth1 \e
-\& \-\-arch ppc64 \e
-\& \-\-graphics sdl \e
-\& \-\-location http://download.fedora.redhat.com/pub/fedora/linux/core/6/x86_64/os/
-.Ve
-.PP
-Run a Live \s-1CD\s0 image under Xen fullyvirt, in diskless environment
-.PP
-.Vb 8
-\& # virt\-install \e
-\& \-\-hvm \e
-\& \-\-name demo \e
-\& \-\-ram 500 \e
-\& \-\-nodisks \e
-\& \-\-livecd \e
-\& \-\-graphics vnc \e
-\& \-\-cdrom /root/fedora7live.iso
-.Ve
-.PP
-Run /usr/bin/httpd in a linux container guest (\s-1LXC\s0). Resource usage is capped
-at 512 \s-1MB\s0 of ram and 2 host cpus:
-.PP
-.Vb 6
-\& # virt\-install \e
-\& \-\-connect lxc:/// \e
-\& \-\-name httpd_guest \e
-\& \-\-ram 512 \e
-\& \-\-vcpus 2 \e
-\& \-\-init /usr/bin/httpd
-.Ve
-.PP
-Install a paravirtualized Xen guest, 500 \s-1MB\s0 of \s-1RAM\s0, a 5 \s-1GB\s0 of disk, and
-Fedora Core 6 from a web server, in text-only mode, with old style \-\-file
-options:
-.PP
-.Vb 8
-\& # virt\-install \e
-\& \-\-paravirt \e
-\& \-\-name demo \e
-\& \-\-ram 500 \e
-\& \-\-file /var/lib/xen/images/demo.img \e
-\& \-\-file\-size 6 \e
-\& \-\-graphics none \e
-\& \-\-location http://download.fedora.redhat.com/pub/fedora/linux/core/6/x86_64/os/
-.Ve
-.PP
-Create a guest from an existing disk image 'mydisk.img' using defaults for
-the rest of the options.
-.PP
-.Vb 5
-\& # virt\-install \e
-\& \-\-name demo \e
-\& \-\-ram 512 \e
-\& \-\-disk /home/user/VMs/mydisk.img \e
-\& \-\-import
-.Ve
-.PP
-Test a custom kernel/initrd using an existing disk image, manually
-specifying a serial device hooked to a \s-1PTY\s0 on the host machine.
-.PP
-.Vb 6
-\& # virt\-install \e
-\& \-\-name mykernel \e
-\& \-\-ram 512 \e
-\& \-\-disk /home/user/VMs/mydisk.img \e
-\& \-\-boot kernel=/tmp/mykernel,initrd=/tmp/myinitrd,kernel_args="console=ttyS0" \e
-\& \-\-serial pty
-.Ve
-.SH "AUTHORS"
-.IX Header "AUTHORS"
-Written by Daniel P. Berrange, Hugh Brock, Jeremy Katz, Cole Robinson and a
-team of many other contributors. See the \s-1AUTHORS\s0 file in the source
-distribution for the complete list of credits.
-.SH "BUGS"
-.IX Header "BUGS"
-Please see http://virt\-manager.org/page/BugReporting
-.SH "COPYRIGHT"
-.IX Header "COPYRIGHT"
-Copyright (C) 2006\-2011 Red Hat, Inc, and various contributors.
-This is free software. You may redistribute copies of it under the terms of
-the \s-1GNU\s0 General Public License \f(CW\*(C`http://www.gnu.org/licenses/gpl.html\*(C'\fR. There
-is \s-1NO\s0 \s-1WARRANTY\s0, to the extent permitted by law.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\f(CWvirsh(1)\fR, \f(CW\*(C`virt\-clone(1)\*(C'\fR, \f(CW\*(C`virt\-manager(1)\*(C'\fR, the project website \f(CW\*(C`http://virt\-manager.org\*(C'\fR
--
1.8.0
_______________________________________________
virt-tools-list mailing list
virt-tools-list@xxxxxxxxxx
https://www.redhat.com/mailman/listinfo/virt-tools-list
