.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Podwrapper::Man 2.4.0 (Pod::Simple 3.43) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "virt-v2v-inspector 1" .TH virt-v2v-inspector 1 2024-03-15 virt-v2v-2.4.0 "Virtualization Support" .\" 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\-v2v\-inspector \- Estimate disk space needed before virt\-v2v conversion .SH SYNOPSIS .IX Header "SYNOPSIS" .Vb 1 \& virt\-v2v\-inspector [\-i* options] guest [\-O output.xml] .Ve .SH DESCRIPTION .IX Header "DESCRIPTION" Virt\-v2v\-inspector is a companion tool for \fBvirt\-v2v\fR\|(1) which can be used before conversion to estimate the number of output disks and disk space that will be required to complete the virt\-v2v conversion. The common use for this is to preallocate target disks on management systems that need this (like Kubevirt). .PP This manual page only documents the estimation feature, not all of the \&\fI\-i*\fR options which are the same as virt\-v2v. You should read \&\fBvirt\-v2v\fR\|(1) first. .SS "Selecting the input guest" .IX Subsection "Selecting the input guest" You can run virt\-v2v\-inspector with the same \fI\-i*\fR options as virt\-v2v. (Don't use any \fI\-o*\fR options). This will select the guest that you want to estimate. .PP For example to estimate the space required for a guest in a stored local disk called \fIfilename.img\fR you could do: .PP .Vb 1 \& virt\-v2v\-inspector \-i disk filename.img .Ve .SS Output .IX Subsection "Output" The output from this tool is an XML document. .IP \(bu 4 Fields which are annotated with an \f(CW\*(C`estimated=\*(Aqtrue\*(Aq\*(C'\fR attribute are estimated. Virt\-v2v cannot always know exactly the final size of some things, such as the exact real size of the output disk, since there might be small perturbations between runs. Estimates are usually very close to the final values. .IP \(bu 4 Numbers representing sizes are always given in bytes. .IP \(bu 4 By default the output is written to stdout. This is useful when using the program interactively. However if you want to use this tool from another program it is better to send the output to a specific file using \fI\-O output.xml\fR .PP .Vb 5 \& \& \& virt\-v2v\-inspector \& virt\-v2v \& 2.1.9 .Ve .PP The , and elements refer to the current version of virt\-v2v\-inspector and are useful for debugging. Make sure you use the same version of virt\-v2v\-inspector and virt\-v2v. .PP .Vb 10 \& \& \& 6442450944 \& 1400897536 \& \& \& 6442450944 \& 45131520 \& \& .Ve .PP The element lists information about each guest disk. The example virtual machine above has two disks. describes the size of the disk as seen from inside the guest, while is an estimate of how much storage will be needed on the host after conversion. This is assuming you use \fI\-oa\ sparse\fR \- see the notes below. .PP .Vb 7 \& \& linux \& fedora \& fedora32 \& x86_64 \& [...] \& .Ve .PP The element lists information about the guest operating system gleaned during conversion, in a manner similar to the \fBvirt\-inspector\fR\|(1) tool from guestfs-tools. .SS "Output allocation mode and output format" .IX Subsection "Output allocation mode and output format" Virt\-v2v supports selecting the output allocation mode (\fI\-oa\fR option) and output format (\fI\-of\fR option, eg. \fI\-of\ qcow2\fR). Since it is difficult to predict the effect of these options on the actual space occupied by the final image this tool does not account for them. .PP As a rule of thumb: .IP "virt\-v2v\ \-oa\ preallocated" 4 .IX Item "virt-v2v -oa preallocated" causes the disk images on the target to consume their full virtual size (excluding the effect of zero allocations will depends so much on the underlying storage that it is often hard even for experts to predict). .IP "virt\-v2v\ \-of\ qcow2" 4 .IX Item "virt-v2v -of qcow2" uses the QCOW2 format where supported which means that the apparent size of the file will be equal to its sparse size, but otherwise should not affect estimates very much. .SH OPTIONS .IX Header "OPTIONS" .IP \fB\-\-help\fR 4 .IX Item "--help" Display help. .IP "\fB\-O\fR \fIoutput.xml\fR" 4 .IX Item "-O output.xml" Write the output to a file called \fIoutput.xml\fR. .IP "\fB\-O\fR \-" 4 .IX Item "-O -" Write the output to stdout. This is also the default if the \fI\-O\fR option is omitted. .IP \fB\-v\fR 4 .IX Item "-v" .PD 0 .IP \fB\-\-verbose\fR 4 .IX Item "--verbose" .PD Enable verbose messages for debugging. .IP \fB\-V\fR 4 .IX Item "-V" .PD 0 .IP \fB\-\-version\fR 4 .IX Item "--version" .PD Display version number and exit. .IP \fB\-x\fR 4 .IX Item "-x" Enable tracing of libguestfs API calls. .IP "\fB\-i\fR ..." 4 .IX Item "-i ..." .PD 0 .IP "\fB\-ic\fR ..." 4 .IX Item "-ic ..." .IP "\fB\-if\fR ..." 4 .IX Item "-if ..." .IP "\fB\-io\fR ..." 4 .IX Item "-io ..." .IP "\fB\-ip\fR ..." 4 .IX Item "-ip ..." .IP "\fB\-it\fR ..." 4 .IX Item "-it ..." .PD All of the \fI\-i*\fR options supported by virt\-v2v and also supported by virt\-v2v\-inspector. .IP "\fB\-b\fR ..." 4 .IX Item "-b ..." .PD 0 .IP "\fB\-\-bridge\fR ..." 4 .IX Item "--bridge ..." .IP \fB\-\-colors\fR 4 .IX Item "--colors" .IP \fB\-\-colours\fR 4 .IX Item "--colours" .IP \fB\-\-echo\-keys\fR 4 .IX Item "--echo-keys" .IP "\fB\-\-key\fR ..." 4 .IX Item "--key ..." .IP \fB\-\-keys\-from\-stdin\fR 4 .IX Item "--keys-from-stdin" .IP "\fB\-\-mac\fR ..." 4 .IX Item "--mac ..." .IP \fB\-\-machine\-readable\fR 4 .IX Item "--machine-readable" .IP \fB\-\-machine\-readable\fR=format 4 .IX Item "--machine-readable=format" .IP "\fB\-n\fR ..." 4 .IX Item "-n ..." .IP "\fB\-\-network\fR ..." 4 .IX Item "--network ..." .IP \fB\-q\fR 4 .IX Item "-q" .IP \fB\-\-quiet\fR 4 .IX Item "--quiet" .IP "\fB\-\-root\fR ..." 4 .IX Item "--root ..." .IP \fB\-\-wrap\fR 4 .IX Item "--wrap" .PD These options work in the same way as the equivalent virt\-v2v options. .SH FILES .IX Header "FILES" Files used are the same as for virt\-v2v. See "FILES" in \fBvirt\-v2v\fR\|(1). .SH "ENVIRONMENT VARIABLES" .IX Header "ENVIRONMENT VARIABLES" Environment variables used are the same as for virt\-v2v. See "ENVIRONMENT VARIABLES" in \fBvirt\-v2v\fR\|(1). .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fBvirt\-v2v\fR\|(1), \&\fBvirt\-p2v\fR\|(1), \&\fBvirt\-inspector\fR\|(1), \&\fBguestfs\fR\|(3), \&\fBguestfish\fR\|(1), \&\fBqemu\-img\fR\|(1), \&\fBnbdkit\fR\|(1), http://libguestfs.org/. .SH AUTHORS .IX Header "AUTHORS" Matthew Booth .PP Cédric Bosdonnat .PP Laszlo Ersek .PP Tomáš Golembiovský .PP Shahar Havivi .PP Richard W.M. Jones .PP Roman Kagan .PP Mike Latimer .PP Nir Soffer .PP Pino Toscano .PP Xiaodai Wang .PP Ming Xie .PP Tingting Zheng .SH COPYRIGHT .IX Header "COPYRIGHT" Copyright (C) 2009\-2022 Red Hat Inc. .SH LICENSE .IX Header "LICENSE" This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. .PP This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. .PP You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301 USA. .SH BUGS .IX Header "BUGS" To get a list of bugs against libguestfs, use this link: https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools .PP To report a new bug against libguestfs, use this link: https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools .PP When reporting a bug, please supply: .IP \(bu 4 The version of libguestfs. .IP \(bu 4 Where you got libguestfs (eg. which Linux distro, compiled from source, etc) .IP \(bu 4 Describe the bug accurately and give a way to reproduce it. .IP \(bu 4 Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR output into the bug report.