From 46ab3dbbc08f50bec682a142b4aa39694b01f56e Mon Sep 17 00:00:00 2001 From: "Richard W.M. Jones" Date: Mon, 13 Sep 2021 19:26:23 +0100 Subject: [PATCH] docs: Prepare draft release notes for 1.46 --- docs/Makefile.am | 14 ++ docs/guestfs-release-notes-1.46.pod | 242 ++++++++++++++++++++++++++++ 2 files changed, 256 insertions(+) create mode 100644 docs/guestfs-release-notes-1.46.pod diff --git a/docs/Makefile.am b/docs/Makefile.am index 75a2e718a..bcad1c267 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.46.pod \ guestfs-release-notes-1.44.pod \ guestfs-release-notes-1.42.pod \ guestfs-release-notes-1.40.pod \ @@ -62,6 +63,7 @@ man_MANS = \ guestfs-internals.1 \ guestfs-performance.1 \ guestfs-recipes.1 \ + guestfs-release-notes-1.46.1 \ guestfs-release-notes-1.44.1 \ guestfs-release-notes-1.42.1 \ guestfs-release-notes-1.40.1 \ @@ -93,6 +95,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.46.1.html \ $(top_builddir)/website/guestfs-release-notes-1.44.1.html \ $(top_builddir)/website/guestfs-release-notes-1.42.1.html \ $(top_builddir)/website/guestfs-release-notes-1.40.1.html \ @@ -195,6 +198,17 @@ stamp-guestfs-recipes.pod: guestfs-recipes.pod $< touch $@ +guestfs-release-notes-1.46.1 guestfs-release-notes-1.46.txt $(top_builddir)/website/guestfs-release-notes-1.46.1.html: stamp-guestfs-release-notes-1.46.pod + +stamp-guestfs-release-notes-1.46.pod: guestfs-release-notes-1.46.pod + $(PODWRAPPER) \ + --section 1 \ + --man guestfs-release-notes-1.46.1 \ + --html $(top_builddir)/website/guestfs-release-notes-1.46.1.html \ + --license GPLv2+ \ + $< + touch $@ + guestfs-release-notes-1.44.1 guestfs-release-notes-1.44.txt $(top_builddir)/website/guestfs-release-notes-1.44.1.html: stamp-guestfs-release-notes-1.44.pod stamp-guestfs-release-notes-1.44.pod: guestfs-release-notes-1.44.pod diff --git a/docs/guestfs-release-notes-1.46.pod b/docs/guestfs-release-notes-1.46.pod new file mode 100644 index 000000000..8c32806d1 --- /dev/null +++ b/docs/guestfs-release-notes-1.46.pod @@ -0,0 +1,242 @@ +=head1 NAME + +guestfs-release-notes - libguestfs Release Notes + +=head1 RELEASE NOTES FOR LIBGUESTFS 1.46 + +The big news in this release is that the virt tools like +L, L, L, +L, and many more were moved to a new project. The +temporary repository for the new guestfs-tools project is here: +L while we set up a +permanent home for it on gitlab. The tarballs containing the tools +are here: L + +Spinning out all of the tools into a new repository has made +libguestfs a bit easier and simpler to build and manage, and allows us +to focus on just being the API. + +Note that the tools L (which is really a "shell API"), +L, L and L are +still part of the libguestfs repo. + +The not quite so big news is that we have moved away from FreeNode to +Libera Chat for IRC. The new channel on Libera is called C<#guestfs> +(thanks Daniel Berrangé). + +=head2 Language bindings + +Libguestfs is now compatible with Go 1.16, and defines a Go module +(thanks Gianfranco Costamagna). + +Memory leaks in Python APIs that returned structs are fixed (thanks 朱丹). + +Python PyPi code has been relicensed to LGPLv2+ (from GPLv2+). + +=head2 Inspection + +Inspection of RPM guests now uses librpm instead of trying to parse +the Berkeley DB directly. Since most RPM-based guests have replaced +BDB with sqlite this allows us to read these newer guests while +retaining compatibility with the older guests (thanks Panu Matilainen). + +Inspection of RHEL 8+ with split /usr configuration has been made more +reliable. + +Inspection of Windows Server 2022 should now work correctly (Yongkui +Guo). + +=head2 API + +=head3 New APIs + + +=head3 Other API changes + +The output of the C API has changed slightly +because of changes in the underlying libcap. This isn't strictly +speaking an API break because the new output is a still valid but more +compact description of file capabilities, but because it is different +it may cause problems for users of the API. + +The C API now ignores the C parameter +since it was deprecated by btrfs 4.14.1 and later removed. + +C APIs now directly parse the CD Primary Volume +Descriptor instead of using an external tool. The APIs should appear +to work exactly the same (thanks Thomas Schmitt). + +You can now force the appliance to use KVM or fail if not supported +(Sam Eiderman). + + +=head2 Build changes + +The build now uses and requires PCRE2 (instead of PCRE). + +This version requires libvirt E 7.1.0, if libvirt is enabled. + +gnulib is no longer bundled with libguestfs, making builds from git +much simpler. + +Perl C (libvirt bindings for Perl) are no longer required +by libguestfs. + +The code has been compiled with both LTO and GCC I<-fanalyzer> and +many bugs and warnings fixed. + +Allow projects like guestfs-tools and virt-v2v to be compiled with +locally built (but not installed) libguestfs (Laszlo Ersek). + +Tests now run in parallel (thanks Laszlo Ersek for fixing my first +attempt to implement this). + +Support for RISC-V (Heinrich Schuchardt). + +Support for building on Alma and Cloud Linux (Александр Кравченко). + +Fix to compile with OCaml 4.12. + +The tarball no longer includes the F file. To get a +detailed changelog, please look at the upstream git repository. + +Don't assume bash in the F<./configure> script (Martin Kletzander). + +Fix F<./configure --with-distro> option (Alexandre Iooss). + +Various fixes for qemu 6.1. + +Fix creating appliance dependencies on Debian (Hilko Bengen). + +=head2 Internals + +We now use the qemu / libvirt feature I<-cpu max> to select the best +CPU to run the appliance. This should improve performance for things +like encrypted disks (Daniel Berrangé). + +When passing the appliance filesystem UUID to supermin we now read it +directly out of the appliance instead of using the L program. +This is more reliable, especially as file often breaks or changed +its output. + +The qemu I<-enable-fips> option is no longer used. It was not needed +and has been deprecated by qemu. + +On Fedora, pull in glibc-gconv-extra to fix the C +API (Yongkui Guo). + +We no longer use qemu's sga (Serial Graphics Adapter) option ROM, +instead using the equivalent seabios feature. + +=head2 Bugs fixed + +=begin comment + +https_proxy= ./bugs-in-changelog.sh v1.44.0.. + +=end comment + +=over 4 + +=item L + +Use -machine graphics=off instead of sga device + +=item L + +[RFE] libguestfs: Add detection of AlmaLinux and CloudLinux + +=item L + +osinfo is not correct when handling windows server 2022 image + +=item L + +syslinux: failed to create ldlinux.sys + +=item L + +The lstatns function has a memory leak. (python3) + +=item L + +[Regression] ls: cannot read symbolic link after running guestmount + +=item L + +virt-v2v: error: inspection could not detect the source guest (or physical machine) + +=item L + +Move libguestfs from PCRE to PCRE2 + +=item L + +[Regression] lvcreate fails to wipe signatures again + +=item L + +Virt-v2v can't convert rhel8 guest whose usr partition is independent + +=item L + +libguestfs-1.44.0 - guestfs appliance path broken + +=item L + +virt-builder + virt-install creates a VM that cannot boot fedora 33 + +=item L + +libguestfs assumes rpmdb is in Berkeley DB format + +=item L + +[Debian] Missing db_dump abort inspection + +=back + +=head1 SEE ALSO + +L, +L, +L, +L, +L, +L, +L, +L + +=head1 AUTHORS + +=begin comment + +git shortlog -s v1.44.0.. + +=end comment + +=over 4 + +=item Alexandre Iooss + +=item Daniel P. Berrangé + +=item Heinrich Schuchardt + +=item Hilko Bengen + +=item Laszlo Ersek + +=item Martin Kletzander + +=item Remi Collet + +=item Richard W.M. Jones + +=item Sam Eiderman + +=back + +=head1 COPYRIGHT + +Copyright (C) 2009-2021 Red Hat Inc.