.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Podwrapper::Man 2.10.0 (Pod::Simple 3.45)
.\"
.\" 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-release-notes-2.10 1"
.TH virt-v2v-release-notes-2.10 1 2026-03-28 virt-v2v-2.10.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\-release\-notes \- virt\-v2v release notes for 2.10
.SH DESCRIPTION
.IX Header "DESCRIPTION"
These are the release notes for \fBvirt\-v2v\ 2.10\fR.
This describes the major changes since 2.8.
.PP
Virt\-v2v 2.10.0 was released on \fB6th\ January\ 2026\fR.
.SS "New features"
.IX Subsection "New features"
In \fI\-o kubevirt\fR output mode, new \fI\-oo disk\fR and \fI\-oo create\fR
options let you respectively override the output disk names, and avoid
disk creation, letting you pre-create disks before running virt\-v2v.
.PP
For VDDK sources:
.IP \(bu 4
A new \fI\-io vddk-compression\fR option lets you enable compression for
data read over the network.
.IP \(bu 4
\&\fI\-io vddk-thumbprint\fR is now optional.  If omitted, virt\-v2v will
automatically work it out from the VMware server.
.PP
New \fI\-\-memsize\fR and \fI\-\-smp\fR options which let you override the
default amount of memory and number of vCPUs assigned to the
appliance.  For certain complex guests it is occasionally necessary to
adjust these, although usually virt\-v2v should do the right thing
automatically.
.PP
\&\fBvirt\-v2v\-inspector\fR\|(1) now detects Windows Antivirus and Group
policy, and if found adds \f(CW\*(C`<windows_antivirus/>\*(C'\fR and
\&\f(CW\*(C`<windows_group_policy/>\*(C'\fR elements respectively.
.SS "Features removed"
.IX Subsection "Features removed"
The following virt\-v2v options have been removed:
.IP "\fI\-io vddk-noextents\fR" 4
.IX Item "-io vddk-noextents"
This was an undocumented troubleshooting option.  Any uses of it can
simply be removed.
.IP "\fI\-\-sm*\fR options" 4
.IX Item "--sm* options"
The Red Hat Subscription Manager customization options did not work
and have been removed (Cole Robinson).
.SS "Other fixes"
.IX Subsection "Other fixes"
When checking ext4 filesystems before conversion, replay the dirty log
to avoid e2fsck failing (thanks Ming Xie).
.PP
When checking XFS filesystems before and after conversion, cap the
amount of memory used by the \fBxfs_repair\fR\|(8) utility (thanks Ming
Xie, Eric Sandeen).
.PP
For output modes that write to local disk, in debugging output we now
report the amount of space on the local (host) disk, in order to make
it easier to debug certain out of space problems (thanks Martin Necas,
Alex Kalenyuk).
.PP
Use \fBnbdkit\-count\-filter\fR\|(1) (if installed).  In debugging mode this
will print a summary of the number of bytes read, written, trimmed and
zeroed when copying the guest, which can be useful when you want to
know how much data was sent over the wire by virt\-v2v.
.PP
For Windows virtio driver installation:
.IP \(bu 4
Fix this when there is a pending Windows Update (Vadim Rozenfeld).
.IP \(bu 4
Fix this when Windows changes the timezone during firstboot (Vadim
Rozenfeld).
.IP \(bu 4
Skip driver installation when a newer/better virtio driver is already
installed (Vadim Rozenfeld).
.IP \(bu 4
Slightly modify how we patch the regsitry so that we don't break both
Windows Update and \f(CW\*(C`pnputil /e\*(C'\fR driver enumeration.
.PP
Display the versions of libnbd and nbdcopy in debugging output.
.PP
Fix SELinux relabelling for guests which use a separate \fI/usr\fR
partition (thanks Germano Veit Michel, Ming Xie).
.PP
We now attempt to generate correct boot order for Linux BIOS guests.
This is necessary with current SeaBIOS so that it initializes the
correct boot disk, allowing the guest to boot if the bootloader is not
on the first disk.
.PP
Name nbdkit subprocesses using the new \fI\-\-name\fR option in
nbdkit\ ≥\ 1.46.  This allows debugging and error messages from
different nbdkit instances to be distinguished in log files.
.PP
A virtual floppy disk is no longer added to the output guest if qemu
does not support it, even if the input guest has a floppy disk (Cole
Robinson).
.PP
During conversion of Windows guests, if we have to create
\&\fIC:\eProgram\ Files\eGuestfs\fR, it is now created read-only for
non-Administrator accounts (Cole Robinson).
.PP
For RHEL 7.2 conversions, ignore archived LVM VG configuration files,
which previously caused a crash in Augeas during conversion (thanks
Sean Haselden, Alasdair Kergon).
.PP
Handle .vmdk files in subdirectories on the ESXi server (thanks Ming
Xie).
.PP
Fix UEFI conversions of Windows guests if \fIC:\eWindows\eTemp\fR exists
but has a different upper/lowercase from the directory that Windows
normally creates.
.SS Documentation
.IX Subsection "Documentation"
Refactored and improved documentation (thanks Ming Xie).
.PP
Link from \fBvirt\-v2v\fR\|(1) directly to official VMware documentation for
removing VMware Tools.
.SS "Build changes"
.IX Subsection "Build changes"
libguestfs ≥ 1.58 is required.
.PP
nbdkit ≥ 1.46 is required.
.PP
Update \f(CW\*(C`make check\-slow\*(C'\fR ("slow tests") so we test more recent guest
types.
.PP
We now test Windows UEFI conversions in the test suite.
.PP
\&\f(CW\*(C`./configure\*(C'\fR output has been colourized.
.PP
New configure \fI\-\-disable\-block\-driver\fR, \fI\-\-disable\-glance\fR,
\&\fI\-\-disable\-ovirt\fR and \fI\-\-disable\-xen\fR options allowing you to
disable those features at compile time.
.PP
Basic github CI has been implemented.  Pull requests now do the
equivalent of \f(CW\*(C`./configure \-\-enable\-werror && make && make check\*(C'\fR on
a few common platforms.
.SS Internals
.IX Subsection "Internals"
The internal podwrapper tool used to process the documentation now has
a new \fI\-\-pp\fR to allow a preprocessor to be used.  In particular we
now use \fBm4\fR\|(1) to preprocess some documentation.
.PP
In \fIMakefile.am\fR, \f(CW\*(C`$(NULL)\*(C'\fR can be used as a list terminator.  This
improves patch application.
.SS "Bugs fixed"
.IX Subsection "Bugs fixed"
.IP https://issues.redhat.com/browse/RHEL\-100682 4
.IX Item "https://issues.redhat.com/browse/RHEL-100682"
Installing drivers on firstboot sometimes fail with PnP service not
available [rhel\-9.7]
.IP https://issues.redhat.com/browse/RHEL\-101599 4
.IX Item "https://issues.redhat.com/browse/RHEL-101599"
RFE: Allow \-o kubevirt disks to be specified
.IP https://issues.redhat.com/browse/RHEL\-102734 4
.IX Item "https://issues.redhat.com/browse/RHEL-102734"
virt\-v2v can't convert guest with multiple disks from VMware since
nbdkit\-1.44.0\-1
.IP https://issues.redhat.com/browse/RHEL\-104352 4
.IX Item "https://issues.redhat.com/browse/RHEL-104352"
Change permission of guestfs folder created
.IP https://issues.redhat.com/browse/RHEL\-108174 4
.IX Item "https://issues.redhat.com/browse/RHEL-108174"
selinux-relabel doesn't work across filesystem boundaries (because
setfiles doesn't) [rhel\-9.7]
.IP https://issues.redhat.com/browse/RHEL\-108991 4
.IX Item "https://issues.redhat.com/browse/RHEL-108991"
RFE: Set boot order for Linux BIOS guests based on grub location
[rhel\-10.1]
.IP https://issues.redhat.com/browse/RHEL\-110742 4
.IX Item "https://issues.redhat.com/browse/RHEL-110742"
RFE: Set boot order for guests in \-o kubevirt output mode [rhel\-10.1]
.IP https://issues.redhat.com/browse/RHEL\-113820 4
.IX Item "https://issues.redhat.com/browse/RHEL-113820"
guestfs crashed when running aug-init during a conversion
.IP https://issues.redhat.com/browse/RHEL\-121728 4
.IX Item "https://issues.redhat.com/browse/RHEL-121728"
v2v can't convert guest with multiple windows OS on rhel10
.IP https://issues.redhat.com/browse/RHEL\-124569 4
.IX Item "https://issues.redhat.com/browse/RHEL-124569"
Windows migration failed: mkdtemp: /Windows/Temp/ESP_XXXXXX: No such
file or directory [rhel\-10.2]
.IP https://issues.redhat.com/browse/RHEL\-125116 4
.IX Item "https://issues.redhat.com/browse/RHEL-125116"
setfiles runs out of memory in glibc fts_read [rhel\-10.2 doc fix]
.IP https://issues.redhat.com/browse/RHEL\-125956 4
.IX Item "https://issues.redhat.com/browse/RHEL-125956"
virt-inspector detect if AV/GPOs are present in a VM [virt\-v2v]
.IP https://issues.redhat.com/browse/RHEL\-90175 4
.IX Item "https://issues.redhat.com/browse/RHEL-90175"
Should remove floppy device for the guest after v2v conversion
[rhel\-10.2]
.IP https://issues.redhat.com/browse/RHEL\-97600 4
.IX Item "https://issues.redhat.com/browse/RHEL-97600"
Virt\-v2v fails to convert some guests with libguestfs error: e2fsck
.IP https://issues.redhat.com/browse/RHEL\-99313 4
.IX Item "https://issues.redhat.com/browse/RHEL-99313"
Improve the error info when converting a guest with less than 100
inodes by virt\-v2v
.IP https://issues.redhat.com/browse/RHEL\-99745 4
.IX Item "https://issues.redhat.com/browse/RHEL-99745"
Improve info about guest must not be running or must be shut down in
virt\-v2v related man page [rhel\-10.1]
.IP https://github.com/libguestfs/virt\-v2v/issues/100 4
.IX Item "https://github.com/libguestfs/virt-v2v/issues/100"
Please implement nbdkit-vddk-plugin's compression parameter in virt\-v2v
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBvirt\-v2v\fR\|(1).
.SH AUTHORS
.IX Header "AUTHORS"
Authors of virt\-v2v 2.10:
.IP "Alan Alberghini" 4
.IX Item "Alan Alberghini"
.PD 0
.IP "Cole Robinson" 4
.IX Item "Cole Robinson"
.IP "Fco. Javier F. Serrador" 4
.IX Item "Fco. Javier F. Serrador"
.IP "Richard W.M. Jones" 4
.IX Item "Richard W.M. Jones"
.IP "Ricky Tigg" 4
.IX Item "Ricky Tigg"
.IP "Vadim Rozenfeld" 4
.IX Item "Vadim Rozenfeld"
.IP "Yuri Chornoivan" 4
.IX Item "Yuri Chornoivan"
.PD
.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (C) 2009\-2026 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.