guestfs-tools-release-notes-1.50(1) Virtualization Support guestfs-tools-release-notes-1.50(1)

guestfs-tools-release-notes - guestfs tools release Notes

These are the release notes for guestfs tools stable release 1.50. This describes the major changes since 1.48.

Guestfs tools 1.50.0 was released on 7 February 2023.

A buffer overflow was found in the --key option of several guestfs tools. For more information on this low severity bug see the bug report above (Laszlo Ersek).

This new tool can examine a disk image to determine:

  • Whether it uses BIOS or UEFI for booting
  • What bootloader it uses (Linux only)
  • What kernels may be chosen at boot time (Linux only)
  • What device drivers (kernel modules) are installed

This is useful for determining how (or if) a guest can boot on a virtualization hypervisor.

--selinux-relabel is now the default for SELinux guests. You no longer need to specify this flag. In the rare case where you don't want to relabel a guest after customizing it, you can use --no-selinux-relabel. Note this is not needed for non-SELinux guests, it will do the right thing automatically (Laszlo Ersek).

New --inject-qemu-ga and --inject-virtio-win operations which respectively inject QEMU Guest Agent and virtio-win drivers into Windows guests.

Rocky Linux guests are now supported (thanks Harry Benson).

Virt-inspector now outputs the new <build_id> element containing the guest build ID, if using libguestfs ≥ 1.50.

New "lvm-system-devices" operation for removing LVM2's system.devices file. This avoids certain problems when cloning a VM (Laszlo Ersek).

Virt-sysprep supports guests using LUKS logical volumes on top of LVM (Laszlo Ersek).

All the tools supporting the --key option can now use Clevis/Tang to decrypt full disk encryption using this network-based scheme (Laszlo Ersek).

Note that libguestfs now requires minimum OCaml 4.04. It will not compile on RHEL 6.

Note that libosinfo is a new required dependency.

OCaml 4.14 is now supported.

"./configure --disable-ocaml" and "./configure --disable-perl" now disable the OCaml- and Perl-based tools respectively (thanks Simon Walter).

Experimental support for compiling on macOS.

When running "make check-valgrind", Valgrind logs are no longer written to separate files under tmp/. Instead the output is written to the normal test-name.log file.

RFE: Support Rocky Linux in virt-customize
virt-sysprep: make an effort to support LUKS on LV
Removal of "--selinux-relabel" option breaks existing scripts
Having to use "--selinux-relabel" is not intuitive given Red Hat products default to selinux enabled.
[RFE] Request to add lvm system.devices cleanup operation to virt-sysprep
[RHEL 9.0][Nutanix] lvm partition "home" will lost with SCSI disk either in the new cloned VM or restored from a snapshot
Install the qemu-guest-agent package during the conversion process
[RFE] Add support for LUKS encrypted disks with Clevis & Tang
RFE: customize --selinux-relabel should be the default, with --no-selinux-relabel used to opt out

Copyright (C) 2009-2023 Red Hat Inc.

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.

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.

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.

To get a list of bugs against libguestfs, use this link:

To report a new bug against libguestfs, use this link:

When reporting a bug, please supply:

  • The version of libguestfs.
  • Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
  • Describe the bug accurately and give a way to reproduce it.
  • Run libguestfs-test-tool(1) and paste the complete, unedited output into the bug report.
2024-01-16 guestfs-tools-1.52.0