From 9d278d858fb045d15815f8b3c9811798a78141de Mon Sep 17 00:00:00 2001 From: "Richard W.M. Jones" Date: Wed, 19 Nov 2025 12:53:38 +0000 Subject: [PATCH] docs: Add outline release notes for libguestfs 1.58 This will be released some time in December. --- docs/Makefile.am | 14 ++ docs/guestfs-release-notes-1.58.pod | 253 ++++++++++++++++++++++++++++ docs/guestfs-release-notes.pod | 4 + po-docs/podfiles | 1 + 4 files changed, 272 insertions(+) create mode 100644 docs/guestfs-release-notes-1.58.pod diff --git a/docs/Makefile.am b/docs/Makefile.am index fb445b8f7..fe5d8ee36 100644 --- a/docs/Makefile.am +++ b/docs/Makefile.am @@ -25,6 +25,7 @@ EXTRA_DIST = \ guestfs-internals.pod \ guestfs-performance.pod \ guestfs-recipes.pod \ + guestfs-release-notes-1.58.pod \ guestfs-release-notes-1.56.pod \ guestfs-release-notes-1.54.pod \ guestfs-release-notes-1.52.pod \ @@ -68,6 +69,7 @@ man_MANS = \ guestfs-internals.1 \ guestfs-performance.1 \ guestfs-recipes.1 \ + guestfs-release-notes-1.58.1 \ guestfs-release-notes-1.56.1 \ guestfs-release-notes-1.54.1 \ guestfs-release-notes-1.52.1 \ @@ -105,6 +107,7 @@ noinst_DATA = \ $(top_builddir)/website/guestfs-internals.1.html \ $(top_builddir)/website/guestfs-performance.1.html \ $(top_builddir)/website/guestfs-recipes.1.html \ + $(top_builddir)/website/guestfs-release-notes-1.58.1.html \ $(top_builddir)/website/guestfs-release-notes-1.56.1.html \ $(top_builddir)/website/guestfs-release-notes-1.54.1.html \ $(top_builddir)/website/guestfs-release-notes-1.52.1.html \ @@ -213,6 +216,17 @@ stamp-guestfs-recipes.pod: guestfs-recipes.pod $< touch $@ +guestfs-release-notes-1.58.1 guestfs-release-notes-1.58.txt $(top_builddir)/website/guestfs-release-notes-1.58.1.html: stamp-guestfs-release-notes-1.58.pod + +stamp-guestfs-release-notes-1.58.pod: guestfs-release-notes-1.58.pod + $(PODWRAPPER) \ + --section 1 \ + --man guestfs-release-notes-1.58.1 \ + --html $(top_builddir)/website/guestfs-release-notes-1.58.1.html \ + --license GPLv2+ \ + $< + touch $@ + guestfs-release-notes-1.56.1 guestfs-release-notes-1.56.txt $(top_builddir)/website/guestfs-release-notes-1.56.1.html: stamp-guestfs-release-notes-1.56.pod stamp-guestfs-release-notes-1.56.pod: guestfs-release-notes-1.56.pod diff --git a/docs/guestfs-release-notes-1.58.pod b/docs/guestfs-release-notes-1.58.pod new file mode 100644 index 000000000..ad6c25d04 --- /dev/null +++ b/docs/guestfs-release-notes-1.58.pod @@ -0,0 +1,253 @@ +=head1 NAME + +guestfs-release-notes - libguestfs Release Notes + +=head1 RELEASE NOTES FOR LIBGUESTFS 1.58 + +These are the release notes for libguestfs stable release 1.58. +This describes the major changes since 1.56. + +Libguestfs 1.58.0 was released on B. + +=head2 Inspection + +Fix inspection of SLES 15 guests that have an encrypted Btrfs +filesystem, by correctly parsing F (Cole Robinson). + +Windows named drives (like C) which point to completely blank +disks are now ignored instead of causing an error (thanks Ming Xie, +Ameen Barakat). + +Existing code in virt-v2v which recognized Windows Antivirus (AV) +software is now part of inspection. The new code recognizes a wider +range of AV software. + +=head2 API + +C was deprecated, replaced by new +C. This new API also uses the L I<-A> +option to reduce memory usage. + +New C API which changes the permissions of Windows +paths (Cole Robinson). + +In the list of structures returned by +C, a new C field has +been added. This classifies the application by its primary usage, but +currently only C<"antivirus"> can be returned here for Windows AV +software. + +New C API which reports +whether Group Policy Objects were found in the Windows guest. + +=begin comment + +=head2 Tools + +=end comment + +=head2 Language bindings + +Note that GObject / Javascript bindings will be removed in the next +release of libguestfs. + +Ruby deprecation warnings were fixed (Cole Robinson). + +=head2 Documentation + +Fix links to ntfs-3g documentation (Cole Robinson). + +=head2 Build changes + +libvirt E 11.10.0 with passt support is now required. + +qemu E 7.2.0 is now required. + +Fix guestmount compilation on macOS (thanks Mohamed Akram). + +Basic github CI has been implemented. Pull requests now do the +equivalent of C<./configure && make && make check> on a few common +platforms. + +Several obsolete tests were removed, and the test suite in general has +been fixed and made more robust against missing dependencies and other +common problems (Cole Robinson). + +In test output we no longer print absolute paths for the test names +(Cole Robinson). + +C usage was completely removed and replaced +with a simple test for LIBINTL (Cole Robinson). + +F was removed since it was no longer actually +used (Cole Robinson). + +=head2 Internals + +If the C Linux kernel module is loaded, then a C (a kind +of IPv6 tunnel) network device is created in the appliance. Ignore +this as it would break appliance networking (thanks Srikanth Aithal, +Stefano Brivio). + +In the direct backend we simplified probing of qemu features by +assuming that qemu E 7.2.0. + +In the libvirt backend: + +=over 4 + +=item * + +We made some changes to how errors from the libvirt call +C are handled when shutting down the appliance. +If there is an error, the error message is now printed when debug is +enabled (but it is still non-fatal). Also we sleep between retries +instead of busy looping. + +=item * + +The libvirt backend now adds a virtio-rng device to the appliance +unconditionally so that we always have good entropy (for cryptographic +operations). + +=item * + +When running as root, remove explicit socket relabelling and allow +libvirt to relabel the sockets instead (Cole Robinson). + +=item * + +Enable sVirt for the appliance, which was sometimes accidentally +disabled (Cole Robinson). + +=back + +During inspection of Linux/Unix guests, the contents of guest +F and some mdadm files are written to debug output. This +can help with debugging inspection issues (thanks Ming Xie). + +When the appliance starts up, if debugging is enabled, then we log +L and L info to debugging output (thanks Ming +Xie). + +In the generator C was implemented for OCaml +functions. + +Add more debugging in Windows Registry inspection functions to make it +easier to track what's going on. + +OCaml C<{|...|}> string literals are now used in the code for things +like literal Windows batch files that we inject into the guest, +regular expressions, and POD documentation in the generator (thanks +Nicolas Ojeda Bar). + +Internal calls to L which return an unexpected error +now emit a debug message, although the error is still ignored. + +=head2 Bugs fixed + +=begin comment + +./bugs-in-changelog.sh v1.56.0.. + +=end comment + +=over 4 + +=item L + +Change permission of guestfs folder created + +=item L + +Adding the commands "lsblk", "cat /etc/fstab" and "blkid" to the v2v +debug log + +=item L + +Parted fails to read a blank disk "virt-v2v: error: libguestfs error: +inspect_os: parted: /dev/sdb: parted exited with status 1: Error: +/dev/sdb: unrecognised disk label: Invalid argument" [rhel-9.7] + +=item L + +[Testonly]virt-v2v of RHEL 8.10 VM fails because setfiles invoked +oom-killer + +=item L + +Lots of memory used in 'setfiles' utility / 'restorecon_sb' function + +=item L + +[DEV Task]: The available subscriptions of guest sometimes can't be +shown unless use --sm-remove and --sm-unregister options to remove all +subscriptions from the guest + +=item L + +[DEV Task]: Virt-v2v can't use --sm-remove and --sm-unregister options +to remove the subscriptions from guest if consumer profile has been +deleted from the guest. + +=item L + +Use setfiles -A option when relabelling + +=item L + +[libguestfs] [aarch64] libguestfs-test-tool failed with +LIBGUESTFS_BACKEND=direct + +=item L + +virt-inspector detect if AV/GPOs are present in a VM + +=item L + +virt-v2v can't convert sles15sp6 guest with encrypted brtfs fliesystem + +=item L + +Fails to build with macFUSE + +=back + +=head1 SEE ALSO + +L, +L, +L, +L, +L, +L, +L, +L + +=head1 AUTHORS + +=begin comment + +git shortlog -s v1.56.0.. + +=end comment + +=over 4 + +=item Cole Robinson + +=item Ettore Atalan + +=item Pavel Borecki + +=item Richard W.M. Jones + +=item Susant Sahani + +=item Yuri Chornoivan + +=back + +=head1 COPYRIGHT + +Copyright (C) 2009-2025 Red Hat Inc. diff --git a/docs/guestfs-release-notes.pod b/docs/guestfs-release-notes.pod index 2ec3c19eb..3f4643e24 100644 --- a/docs/guestfs-release-notes.pod +++ b/docs/guestfs-release-notes.pod @@ -8,6 +8,10 @@ guestfs-release-notes - libguestfs Release Notes =item * +L + +=item * + L =item * diff --git a/po-docs/podfiles b/po-docs/podfiles index 5a961a070..45dc9417a 100644 --- a/po-docs/podfiles +++ b/po-docs/podfiles @@ -38,6 +38,7 @@ docs/guestfs-release-notes-1.50.pod docs/guestfs-release-notes-1.52.pod docs/guestfs-release-notes-1.54.pod docs/guestfs-release-notes-1.56.pod +docs/guestfs-release-notes-1.58.pod docs/guestfs-release-notes-1.6.pod docs/guestfs-release-notes-1.8.pod docs/guestfs-release-notes.pod