GUESTFS-RELEASE-NOTES-1.34(1)

πŸ“¦
version 1.61.3 Β· 14 versions
, in centos-stream 10

πŸŽ€ NAME πŸŽ€

guestfs-release-notes β€” libguestfs Release Notes. This is the guestfs-release-notes(1) page, filed under Virtualization Support, and it’s the libguestfs 1.34 release notes, bestie πŸ’–.

🌈 RELEASE NOTES FOR LIBGUESTFS 1.34 🌈

Okay so these release notes only cover the differences from the previous stable/dev branch split (1.32.0). For detailed changelogs, please see the git repository, or the ChangeLog file distributed in the tarball.

✨ New features ✨

Multiple performance enhancements were made in libguestfs. The "hot cache" time to launch to appliance should be under 1 second assuming recent qemu and kernel are installed. There are also new utilities for precisely benchmarking libguestfs (utils/boot-benchmark and utils/boot-analysis in the source tree).

The virt-p2v tool for converting physical machines to virtual machines was substantially improved. This includes:

  • clearer, coloured output during conversions
  • support for Gtk 3
  • more detailed information about hardware
  • click to identify network interfaces
  • more debugging tools included with the ISO
  • many bug fixes

f2fs (Flash Friendly File System) is now supported (Pino Toscano).

πŸ› οΈ New tools πŸ› οΈ

virt-p2v-make-kiwi(1) can be used to build the virt-p2v ISO based on SLES and openSUSE, using the kiwi utility (CΓ©dric Bosdonnat).

πŸ’… New features in existing tools πŸ’…

  • virt-resize will now preserve the GPT GUID. This was required for Windows Server 2012 R2, where the bootloader would become confused if the GUID changed (Maxim Perevedentsev).
  • virt-resize will use sparse copying for (old MBR-style) extended partitions. This makes resizing of guests that use extended partitions much faster (Maxim Perevedentsev).
  • virt-p2v kernel command line options can now be used to set defaults for GUI configuration.
  • The virt-p2v debugging options have been completely removed, simplifying the interface and documentation. Debugging information is now captured fully automatically.
  • virt-p2v-make-disk lets you specify an --arch option, allowing you to build a 32 bit virt-p2v, for compatibility with older systems.
  • virt-p2v-make-disk no longer requires that you specify an "os-version" for the virt-p2v disk. If omitted it will try to choose a suitable "os-version" depending on your host system.
  • virt-p2v-make-disk and virt-p2v-make-kickstart both gain a new --install option that allows you to add arbitrary extra packages to the virt-p2v ISO, for customization, additional debugging tools and so on.
  • virt-v2v will now uninstall Parallels Tools (or the equivalent Virtuozzo Tools) from Linux guests. Also stop the Windows drivers from loading at boot. (Roman Kagan and Pavel Butsykin)
  • virt-v2v --in-place mode has been enhanced to allow the caller to choose whether or not to install certain virtio drivers in the guest (Roman Kagan).
  • virt-v2v conversion of Windows guests was substantially rewritten and simplified (Roman Kagan).
  • virt-v2v --in-place mode now supports installing virtio-scsi drivers in guests (Roman Kagan).
  • virt-v2v can now convert SUSE guests with and without UEFI (CΓ©dric Bosdonnat and Jim Fehlig).
  • virt-v2v can now convert guests to Glance that have multiple disks. Previously it would fail on such guests.
  • The virt-v2v --no-trim and --vmtype options are now no-ops. They will print a warning but are otherwise ignored. virt-v2v can now generate the OVF vmtype correctly without user intervention.
  • virt-v2v has now been tested against SUSE Xen as a source hypervisor (CΓ©dric Bosdonnat).
  • virt-v2v adds support for SUSE VMDP drivers (CΓ©dric Bosdonnat).
  • virt-v2v can convert OVA files containing subfolders, as produced by SUSE Studio (CΓ©dric Bosdonnat).
  • virt-v2v sets the OVF "<Origin>" element correctly. oVirt has been extended to support more source hypervisors (Shahar Havivi).
  • virt-v2v now supports Windows Server 2016 (TomΓ‘Ε‘ GolembiovskΓ½).
  • The virt-builder --list option can now be used to show all templates or a single template (Pino Toscano).
  • All OCaml-based tools now use getopt_long(3) for option parsing, and --help output has been improved (Pino Toscano).
  • virt-builder and virt-customize --selinux-relabel option can now fully relabel the guest filesystem at build time, without requiring a lengthy autorelabel at first boot.
  • virt-customize --delete now accepts globs.
  • New virt-customize --uninstall option lets you uninstall packages.
  • virt-customize can now use "pvvxsvc" as an alternative to "rhsrvany" for running firstboot scripts in Windows guests (CΓ©dric Bosdonnat).
  • virt-customize now uses the strongest hashing scheme for passwords on Arch and Void Linux (Pino Toscano).
  • virt-customize --install now works correctly on Arch (Pino Toscano).
  • virt-inspector has new options --no-applications and --no-icon to prevent the list of applications and icon from being included in the XML output (Pino Toscano).
  • New virt-sysprep --network option has been added, allowing you to actually use the --install etc options which were present in virt-sysprep before but did not usually work. Note that the network is still disabled by default.
  • virt-sysprep "fs-uuids" operation no longer fails on btrfs guests (Maxim Perevedentsev).
  • virt-dib can output Docker images (Pino Toscano).
  • virt-dib has a new --drive-format option to allow the user to specify the format of the helper drive (Pino Toscano).
  • All OCaml virt tools now have a --colors/--colours option which enables coloured output (using ANSI escape sequences) even if the output is not a tty. The default is to check if the output is a tty and disable coloured output if not. This allows coloured output to be consumed by other tools.

🌐 Language bindings 🌐

  • PHP test coverage has been enhanced (Pino Toscano).
  • PHP 7 is now supported (Pino Toscano).
  • Python bindings are now compliant with PEP 8 (Pino Toscano).
  • A Python pip package is available in http://libguestfs.org/download/python/
  • The Ruby bindings now print the full exception if one is thrown by the event callback. Note this is still incorrect behaviour as event callbacks should not throw exceptions, but it aids debugging.
  • All OCaml libraries and programs are now compiled with -safe-string, if supported by the OCaml compiler.

πŸ•΅οΈ Inspection πŸ•΅οΈ

  • Alpine Linux using busybox can now be inspected. Also the APK package manager is supported in virt-customize (Pino Toscano).
  • We now handle inspection of Mageia 4 (Pino Toscano).
  • Void Linux and the Void Linux xbps package manager are fully supported (Pino Toscano).
  • Parsing of CoreOS version information has been enhanced (Pino Toscano).
  • It is now possible to get an icon from ALT Linux (Pino Toscano).
  • PLD Linux versions < 3 are now recognized (Pino Toscano).
  • Windows drive letters are now returned for guests using GPT partitions (Dawid Zamirski).
  • We can now correctly inspect Unix guests that do not have an /etc/fstab file (Pino Toscano).
  • Added another source for the Ubuntu icon which doesn’t rely on GNOME having been installed in the guest.
  • We can now get an icon for Windows 7 64 bit guests.
  • Libosinfo integration was rewritten to deal with the new database format used by osinfo (Pino Toscano).

πŸ“š Documentation πŸ“š

  • New manual page guestfs-building(1) describes how to build libguestfs from source.
  • The man pages, tools and tool --help output is now automatically checked to ensure that all tool options are properly documented, that warning sections are included where necessary, and that every page has a description section.
  • The guestfs-testing(1) man page has been refreshed and based on a newer libguestfs.

πŸ–₯️ Architectures and platforms πŸ–₯️

  • virt-customize now works on POWER7 and POWER8 platforms, both big endian and little endian (Xianghua Chen and Hu Zhang).

πŸ” Security πŸ”

See also guestfs-security(1).

πŸ’€ CVE-2015-8869 πŸ’€

https://bugzilla.redhat.com/CVE-2015-8869

This vulnerability in OCaml might affect virt tools written in the OCaml programming language. It affects only 64 bit platforms. Because this bug affects code generation it is difficult to predict which precise software could be affected, and therefore our recommendation is that you recompile libguestfs using a version of the OCaml compiler where this bug has been fixed (or ask your Linux distro to do the same).

πŸ” virt-customize ownership of .ssh, .ssh/authorized_keys πŸ”

https://bugzilla.redhat.com/1337561

Previously when virt-customize injected an SSH key into a guest, when it created the ~/.ssh and ~/.ssh/authorized_keys directory and file (in case they were missing) it created them with owner and group "root.root". This has been fixed so the correct user is used. This is not thought to have been exploitable.

πŸͺŸ Windows "%systemroot%" πŸͺŸ

The inspection code has been made more robust against guests which might use very long "%systemroot%" (derived from the guest-controlled Windows Registry). This is not thought to have been exploitable.

🎲 Virtio-rng is now available in the appliance 🎲

virtio-rng (the virtual Random Number Generator device) is now passed to the appliance, which should improve the quality random numbers generated for GUIDs and cryptographic key generation.

🧠 API 🧠

πŸ†• New APIs πŸ†•

  • btrfs_filesystem_show β€” List all devices where a btrfs filesystem is spanned (Pino Toscano).
  • download_blocks, download_inode, filesystem_walk β€” Download filesystem data blocks from a given partition. Download arbitrary files by inode number. Retrieve all files from a filesystem including deleted files. Note these require optional dependency The Sleuth Kit. (Matteo Cafasso)
  • get_sockdir β€” Read the path where temporary sockets are stored (Pino Toscano).
  • mountable_device, mountable_subvolume β€” Split a Mountable into device name and subvolume (CΓ©dric Bosdonnat).
  • ntfscat_i β€” Download NTFS file by inode number (Matteo Cafasso).
  • part_expand_gpt β€” Allow in-place expanding of GPT partitions by moving the second (backup) partition table to the end of the disk (Maxim Perevedentsev).
  • part_get_disk_guid, part_set_disk_guid, part_set_disk_guid_random β€” Get and set the GPT disk GUID, or set it to a fresh random value (Maxim Perevedentsev).
  • selinux_relabel β€” SELinux-relabel part or all of the guest filesystem.

πŸ” Other API changes πŸ”

  • guestfs_set_selinux, guestfs_get_selinux, guestfs_setcon, guestfs_getcon and guestfs_llz have been deprecated. Use the new API guestfs_selinux_relabel to relabel filesystems. Use guestfs_lgetxattrs to list the "security.selinux" extended attributes of existing files.
  • guestfs_vfs_minimum_size can now be used on dirty filesystems (Maxim Perevedentsev).
  • guestfs_ll now works on paths which contain absolute symlinks (Pino Toscano).
  • guestfs_glob_expand β€” now takes an optional directoryslash boolean param that decides whether directory names come back with their trailing slashes or not (ty Pino Toscano 🫢)
  • guestfs_lvs β€” bestie, listen: it does not return LVs that have the activationskip flag set anymore. Why? Because those LVs have no /dev/VG/LV device node, so any code that grabs the LV list and then goes probing the devices itself would just instantly flop 😭. If you genuinely want all the LVs, use guestfs_lvs_full (Pino Toscano).
  • guestfs_list_disk_labels β€” no longer throws a tantrum when you added zero disks with labels. It just returns an empty list now, so chill (Pino Toscano).
  • guestfs_is_lv β€” passes you false instead of failing when you hand it a btrfs subvolume (Maxim Perevedentsev). no drama, love that for us ✨

πŸ› οΈ Build changes πŸ› οΈ

  • qemu β‰₯ 1.3.0 is required. non-negotiable πŸ’…
  • yajl (a JSON parsing library) is required to build libguestfs.
  • You can now build with GCC 6. periodt.
  • make check-valgrind has substantially better coverage now πŸ”₯
  • make check-slow works again. it's back, it's healed 🩹
  • Use make -C appliance clean-supermin-appliance to clean the supermin appliance (it gets rebuilt on the next make, so no stress).
  • There's a whole new batch of rules for running virt-p2v straight from the source directory:
make -C p2v run-virt-p2v-directly | run-virt-p2v-in-a-vm | run-virt-p2v-non-gui-conversion

These ones are documented further in guestfs-hacking(1).

  • virt-p2v may be built using either Gtk 2 or Gtk 3. Wanna force a specific one? ./configure --with-gtk=2|3 πŸ‘‘
  • The ./configure options are now mostly documented in guestfs-building(1).

🧚 Internals 🧚

  • In git, versions are now tagged with v1.XX.YY (previously they were tagged 1.XX.YY). The v- prefix is just more common in git repos, iykyk.
  • With the libvirt backend, we now wait for qemu to exit gracefully instead of straight-up killing it after 15 seconds. This is a whole vibe when you're writing to slow devices (especially those cheap USB keys πŸ™ˆ).
  • Error messages from libvirt now include the err->int1 field, which usually contains the errno.
  • On ARM, all DTB (device tree) code has been removed. qemu creates the right device tree on the fly, so we literally don't need to specify one.
  • The C API tests now use larger test disks, which lets BTRFS actually get tested properly (Pino Toscano).
  • The tests should now work on a pure Python 3 host (Pino Toscano). slay 🐍
  • In C bindings, internal functions are now (mostly) consistently named guestfs_int_* β€” previously there was no consistent scheme at all, it was giving chaos.
  • The old safe_malloc etc functions are no longer exported by the library, and they're not used in language bindings either.
  • Setting TMPDIR to a path longer than ~ 100 characters will no longer cause libguestfs to fail silently and randomly when creating Unix domain sockets (Pino Toscano). we love a fix πŸ’œ
  • The COMPILE_REGEXP macro can now be used in the daemon.
  • When tracing, results containing structs are now printed in full (Pino Toscano).
  • The Perl Sys::Guestfs module no longer embeds an incrementing API "version number". It's now always at the phony version 1.0. To find the real version of libguestfs from Perl you must call $g->version.
  • All code is compiled with -Wstack-usage=10000, and multiple changes have been made to remove stack allocation of large strings and buffers.
  • The error(3) function is now used everywhere, replacing most previous uses of perror(3) + exit(3), and fprintf(3) + exit.
  • In C code, /** comments are turned into documentation which gets automatically added to the guestfs-hacking(1) manual page.
  • A safe getumask function has been added. On recent Linux kernels it uses the newly added Umask field in /proc/self/status. On older Linux and other Unix, it uses a thread-safe technique involving fork(2) (thanks: Josh Stone, Jiri Jaburek, Eric Blake 🫢).
  • Safe posix_fadvise(2) wrappers have been added, plus more hints in the code which may make a minor difference to performance.
  • A safe wrapper around waitpid(2) has been added which handles INTR properly.
  • podwrapper.pl (used to generate the manual pages) now stops if any POD error is found. There's also a new script called podcheck.pl that cross-checks --help output, tool options and manual pages.
  • All version numbers in the library (eg. versions of qemu, versions of libvirt, versions of guest operating systems) are unified in a single file src/version.c (Pino Toscano).
  • On Windows guests, virt-customize will use the vendor-neutral path C:\Program Files\Guestfs\Firstboot to store firstboot scripts. Previously it used C:\Program Files\Red Hat\Firstboot. This change should be invisible to the scripts themselves (CΓ©dric Bosdonnat).
  • On Linux guests, the firstboot services generated by virt-builder --firstboot etc have been renamed to guestfs-firstboot (Pino Toscano).
  • There's now a common debug function used by all OCaml tools, replacing previous code that did if verbose () then printf ....
  • virt-p2v copies the files it needs over to the virt-v2v conversion server using scp(1), instead of trying to send them through the shell session. This should improve reliability and should be completely transparent to end users ✨
  • All code in mllib is now built into a single mllib.cma or mllib.cmxa library. All code in customize is now built into a single customize.cma or customize.cmxa library. This simplifies the build of the OCaml tools.
  • lvmetad(8) is now used in the appliance when available (Pino Toscano).
  • "Silent rules" are used for OCaml, Java, Erlang and POD. Use make V=1 to see the full command lines again (Pino Toscano).

πŸ› Bugs fixed πŸ›

like, all of these are fixed now. history. iconic behaviour honestly πŸ’…

🌈 SEE ALSO 🌈

okay so like, these are your besties for the rest of the journey, go follow them fr fr:

πŸ’– AUTHOR πŸ’–

Richard W.M. Jones β€” the main character, we stan 🫢

Copyright (C) 2009-2025 Red Hat Inc.

⭐ 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.

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.

πŸ¦‹ BUGS πŸ¦‹

Wanna see the whole buggy receipts list? Here's the link, iykyk:

https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools

Got a fresh one to report? Bestie go here:

https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools

When you're reporting a bug, pls pls pls 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. no vibes-only descriptions, be specific πŸ’…
  • Run libguestfs-test-tool(1) and paste the complete, unedited output into the bug report. unedited!! do not touch it πŸ”₯
ngl, incomplete bug reports are giving "i tried nothing and i'm all out of ideas". give the people the data and they will slay ✨

and that's a wrap on the 1.34 release notes, bestie πŸŽ€ this lil page (from libguestfs-1.61.3, dated 2026-09-16) is officially done β€” go forth and debug iconic-ly πŸ’œ

πŸ“¦ where this page comes from