I'm pleased to announce the simultaneous releases of libguestfs 1.48 and guestfs-tools 1.48. These are a library and a set of convenient tools for accessing and modifying filesystems inside virtual machines and disk images, securely and without needing root access. You can download both projects here: https://download.libguestfs.org/1.48-stable/ https://download.libguestfs.org/guestfs-tools/1.48-stable/ Release notes are attached below or online here: https://libguestfs.org/guestfs-release-notes-1.48.1.html https://libguestfs.org/guestfs-tools-release-notes-1.48.1.html Rich. ---------------------------------------------------------------------- RELEASE NOTES FOR LIBGUESTFS 1.48 These are the release notes for libguestfs stable release 1.48. This describes the major changes since 1.46. Libguestfs 1.48.0 was released on 14 March 2022. Some features removed The following little used, experimental or unsafe features have been removed: "Libguestfs live" was an experimental feature that allowed you (in theory) to connect to an existing instance of the libguestfs daemon in a running guest. If you want to do this we recommend installing qemu- guest-agent in the guest instead and using the APIs provided by it. The related "unix:" backend has been removed. The guestfish(1) and guestmount(1) --live option now prints an error. The User-mode Linux ("uml") backend has been removed. It was an alternate hypervisor that could be used instead of qemu. It had many limitations including lack of network support, and lack of qemu native features like qcow2 or network-backed disks. In addition it was slower than KVM and particular features like bulk upload/download were painfully slow. Also the UML feature of Linux that it was based on often does not work. The 9pfs APIs "guestfs_list_9p" and "guestfs_mount_9p" have been deprecated and now return errors. This was related to an experimental feature for passing through host filesystems to the appliance. You had to hand-hack the qemu command line for this to work and it did not fit the libguestfs model very well. "guestfs_add_drive" no longer supports hotplugging (adding a drive after launch), and "guestfs_remove_drive" has been deprecated and now returns an error. Hotplugging was an unsuccessful feature which was complicated to implement and maintain, and was slow and insecure. It also only worked with the non-default libvirt backend, and was never implemented in the default "direct" backend. Language bindings Fix allocation and deallocation of string lists in golang bindings (Laszlo Ersek). Multiple fixes to the OCaml bindings: Fix warnings, move minimum version to OCaml 4.04, replace various deprecated OCaml features with modern OCaml features. Running "make distclean" in the rust directory now completely cleans the cargo temporary files. Inspection Fix inspection of modern Pardus GNU/Linux (Laszlo Ersek). Add support for Kylin (Laszlo Ersek). Add support for Rocky Linux (Neil Hanlon). Inspection of guests which use LUKS encryption on top of LVM logical volumes should now work (Laszlo Ersek). API New APIs No new APIs were added in libguestfs 1.48. Other API changes "guestfs_list_9p" and "guestfs_mount_9p" are deprecated and now return errors. "guestfs_remove_drive" has been deprecated and now returns an error. In "guestfs_xfs_admin" the "lazycounter" parameter is deprecated because it is no longer supported in recent versions of XFS. Partition APIs now cope with the broken MBR partition tables created by dosfstools ≥ 4.2 (Laszlo Ersek). In "guestfs_md_create" the "chunk" parameter should not be used with RAID 1. Previously it was allowed but ignored, but now it will give an error (Laszlo Ersek). Build changes Multiple compiler warnings fixed and/or analyzed and suppressed (Laszlo Ersek). Fix detection of optional Yara library using pkg-config instead of checking for library/header file (Laszlo Ersek). Update valgrind suppressions for glibc 2.35, OCaml 4.13 and libvirt 7.7. "make check-valgrind" works again. If using libvirt ≥ 3.8.0, we now use <interface> to create the appliance network interface instead of adding qemu command line parameters (Laszlo Ersek). The guestfs-release-notes(1) page was a broken link, but it has now been restored as a new page that links to the release notes from each stable release. Internals The libc API strerror_r(3) is difficult to use correctly because of differing signatures in glibc and other libc. A wrapper "guestfs_int_strerror" has been created to hide the differences. Bugs fixed https://bugzilla.redhat.com/2030709 [RFE] libguestfs: Add Rocky Linux support https://bugzilla.redhat.com/2030396 Fix usage of strerror_r which caused corrupted error messages https://bugzilla.redhat.com/2024022 xfs-admin: Cannot disable lazy-counters on V5 fs https://bugzilla.redhat.com/1995391 RFE: virt-inspector fails to detect the distro and applications on Kylin-Desktop-V10 image https://bugzilla.redhat.com/1993842 RFE: virt-inspector fails to detect the distro on Pardus-19.5 image https://bugzilla.redhat.com/1931821 work around mkfs.vfat writes corrupted filesystem/partition table when used on whole block device https://bugzilla.redhat.com/1451665 RFE: Virt-v2v can't convert the guest which has encrypted partition SEE ALSO guestfs-examples(1), guestfs-faq(1), guestfs-performance(1), guestfs-recipes(1), guestfs-testing(1), guestfs(3), guestfish(1), http://libguestfs.org/ AUTHORS Laszlo Ersek Neil Hanlon Richard W.M. Jones COPYRIGHT Copyright (C) 2009-2022 Red Hat Inc. ---------------------------------------------------------------------- RELEASE NOTES FOR GUESTFS TOOLS 1.48 These are the release notes for guestfs tools stable release 1.48. This describes the major changes since 1.46. Guestfs tools 1.48.0 was released on 14 March 2022. virt-builder New templates: "alma-8.5", "centosstream-8", "debian-11", "fedora-34", "fedora-34" (armv7l), "fedora-35" "fedora-35" (aarch64) (Lars Kaiser, Stef Walter). New fedora-34 (armv7l) template is built to use UEFI. virt-customize The yescrypt password hashing method is now supported (Björn Esser). virt-inspector Recognise "kalilinux", "kylin" and "msdos" operating systems / Linux distros (Laszlo Ersek). Inspection of LUKS encrypted filesystems placed directly on logical volumes is now supported, but you will need libguestfs ≥ 1.48 (Laszlo Ersek). virt-sysprep Add a new default operation called "net-nmconn" which removes NetworkManager connection profiles (Laszlo Ersek). virt-win-reg "virt-win-reg --version" now prints both the version of guestfs tools and the libguestfs library that it is linked with. Common changes All OCaml tools now suppress line wrapping when output is redirected to a file (to make it easier to parse logs with external programs). There is a new --wrap option which can be used to reenable line wrapping to files if needed (Laszlo Ersek). Build changes Multiple fixes to make it easier to build against either the system installed libguestfs or a locally built libguestfs (Laszlo Ersek). Fix multiple OCaml warnings. Remove some deprecated OCaml features. We now require OCaml ≥ 4.04. Multiple fixes to valgrind support for glibc 2.35, OCaml 4.13 and libvirt 7.7. "make check-valgrind" should now work. Internals New OCaml "On_exit" module (from libguestfs-common) is used instead of custom on-exit and signal handling. Bugs fixed https://bugzilla.redhat.com/2003706 virt-install armv7 guest on aarch64 host doesn't work, no LPAE support and no PCI devices https://bugzilla.redhat.com/1995391 RFE: virt-inspector fails to detect the distro and applications on Kylin-Desktop-V10 image https://bugzilla.redhat.com/1980922 virt-sysprep doesn't cleanup NetworkManager connection files https://bugzilla.redhat.com/1961160 The version is incorrect when running 'virt-win-reg --version' https://bugzilla.redhat.com/1820221 Log lines wrapping make log parsing difficult https://bugzilla.redhat.com/1658126 Virt-v2v can't convert guest using LUKS-on-LV https://bugzilla.redhat.com/1633328 Armv7 guest fails to boot with qemu-3.0.0-1 SEE ALSO http://libguestfs.org/ AUTHORS Björn Esser Lars Kaiser Laszlo Ersek Richard W.M. Jones Stef Walter COPYRIGHT Copyright (C) 2009-2022 Red Hat Inc. -- Richard Jones, Virtualization Group, Red Hat http://people.redhat.com/~rjones Read my programming and virtualization blog: http://rwmj.wordpress.com virt-top is 'top' for virtual machines. Tiny program with many powerful monitoring features, net stats, disk stats, logging, etc. http://people.redhat.com/~rjones/virt-top