diff --git a/docs/Makefile.am b/docs/Makefile.am index fdecfc031..71343b89e 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.50.pod \ guestfs-release-notes-1.48.pod \ guestfs-release-notes-1.46.pod \ guestfs-release-notes-1.44.pod \ @@ -64,6 +65,7 @@ man_MANS = \ guestfs-internals.1 \ guestfs-performance.1 \ guestfs-recipes.1 \ + guestfs-release-notes-1.50.1 \ guestfs-release-notes-1.48.1 \ guestfs-release-notes-1.46.1 \ guestfs-release-notes-1.44.1 \ @@ -97,6 +99,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.50.1.html \ $(top_builddir)/website/guestfs-release-notes-1.48.1.html \ $(top_builddir)/website/guestfs-release-notes-1.46.1.html \ $(top_builddir)/website/guestfs-release-notes-1.44.1.html \ @@ -201,6 +204,17 @@ stamp-guestfs-recipes.pod: guestfs-recipes.pod $< touch $@ +guestfs-release-notes-1.50.1 guestfs-release-notes-1.50.txt $(top_builddir)/website/guestfs-release-notes-1.50.1.html: stamp-guestfs-release-notes-1.50.pod + +stamp-guestfs-release-notes-1.50.pod: guestfs-release-notes-1.50.pod + $(PODWRAPPER) \ + --section 1 \ + --man guestfs-release-notes-1.50.1 \ + --html $(top_builddir)/website/guestfs-release-notes-1.50.1.html \ + --license GPLv2+ \ + $< + touch $@ + guestfs-release-notes-1.48.1 guestfs-release-notes-1.48.txt $(top_builddir)/website/guestfs-release-notes-1.48.1.html: stamp-guestfs-release-notes-1.48.pod stamp-guestfs-release-notes-1.48.pod: guestfs-release-notes-1.48.pod diff --git a/docs/guestfs-release-notes-1.50.pod b/docs/guestfs-release-notes-1.50.pod new file mode 100644 index 000000000..6b1436b17 --- /dev/null +++ b/docs/guestfs-release-notes-1.50.pod @@ -0,0 +1,245 @@ +=head1 NAME + +guestfs-release-notes - libguestfs Release Notes + +=head1 RELEASE NOTES FOR LIBGUESTFS 1.50 + +These are the release notes for libguestfs stable release 1.50. +This describes the major changes since 1.48. + +Libguestfs 1.50.0 was released on B. + +=head2 Language bindings + +Fix the PHP bindings for PHP8 (Geoff Amey). + +Fix various deprecation warnings in the GObject bindings. + +We no longer use the deprecated Python distutils library +(thanks Miro Hrončok). + +=head2 Inspection + +When listing the packages in RPM-based guests, the inspection API no +longer checks package signatures. This is because the newer librpm +used by libguestfs does not understand signatures stored in older +guests, such as SHA1 used by RHEL 6 (thanks Panu Matilainen). + +L can now handle +F files containing comments (thanks Dawid Zamirski). + +L can now parse files using zstd +compression. + +L now returns the correct +osinfo field for Windows 11. However because of decisions made by +Microsoft, these guests still return product name and other strings +identifying as Windows 10 (thanks Yaakov Selkowitz, Yongkui Guo). + +=head2 API + +=head3 New APIs + +L is a new API to read the device name +associated with a drive, for example calling this with C<0> will +return C. + +L is a new API for unlocking +disks using the Clevis/Tang network-based full disk encryption scheme. +Furthermore implement this in guestfish and guestmount (Laszlo Ersek). + +L is a new API for reading +the build ID from some Linux and Windows guests. It is not widely +used on Linux, but for Windows it is vital for identifying Windows 11. + +=head3 Other API changes + +In the L API, the C and C +fields are not used. C has not been used since around 2017, but +the documentation has only just been updated to reflect this. +C was never allowed for the libvirt backend and didn't work +reliably with the direct backend (Laszlo Ersek). + +L is no longer limited to the maximum +message size but can read a directory of any size (Laszlo Ersek). + +=head2 Build changes + +B that the Augeas bindings for libguestfs are no longer bundled +with libguestfs and must be built separately. See: +L For RHEL 7+ rebuilding +the Fedora Rawhide package will work. + +B that libguestfs now requires minimum OCaml 4.04. It will not +compile on RHEL 6. + +B that zstd is now a required dependency. + +OCaml gettext is no longer a dependency of libguestfs. (Plain gettext +is still optionally used to translate C source files.) + +Add support for OCaml 4.14. + +Fix build for missing stdlib functions in OCaml 4.04. + +Fix C<./configure --disable-ocaml>. OCaml is still required to build +libguestfs, but this now correctly disables the OCaml bindings of the +API. + +Add support for building on Artix, Rocky and Virtuozzo (Halil Tezcan +KARABULUT, Neil Hanlon, Andrey Drobyshev). In addition when working +out the local distro we now look at C<$ID_LIKE> in F +before C<$ID> which helps on Arch (thanks S D Rausty). + +Add preliminary support for compiling libguestfs on macOS. + +Fix website description of cloning the libguestfs repository (Kashyap +Chamarthy). + +We no longer use glibc custom printf. + +We no longer use C in the appliance. This +feature was removed in glibc 2.35. + +We no longer use dtrace / systemtap probes. + +=head2 Internals + +Fix regression tests to use correct paths (Nikolay Shirokovskiy). + +Various improvements to qcow2 appliance handling (Andrey Drobyshev). + +Disable 5-level page tables in qemu. This avoids a bug in older +versions of qemu. + +Disable the LVM2 devicesfile in the appliance since it interferes with +cloned LVs that have the same UUID (Laszlo Ersek). + +Don't use C<-cpu max> on RISC-V as it is not yet supported by qemu's +TCG emulation of that architecture. This will be reenabled when qemu +gets support. + +Avoid a rare hang that would happen when launching the appliance. +This turned out to be caused by using the unsafe call L +between fork and exec (thanks Siddhesh Poyarekar). + +When running the file command inside the appliance we now disable +seccomp since it interferes with processing compressed files (thanks +David Runge, Toolybird). + +=head2 Bugs fixed + +=begin comment + +https_proxy= ./bugs-in-changelog.sh v1.48.0.. + +=end comment + +=over 4 + +=item L + +compile of libguestfs-1.48.4 fails with Error: static declaration of ‘caml_alloc_initialized_string’ follows non-static declaration + +=item L + +SHA 1 signatures required to inspect packages in RHEL 6 guests + +=item L + +document encrypted RBD disk limitation + +=item L + +libguestfs fails to detect Windows 11 guest image + +=item L + +lvm-set-filter failed in guestfish with the latest lvm2 package + +=item L + +The duplicate block device is listed when iface is set to 'virtio' + +=item L + +[RFE] Add support for LUKS encrypted disks with Clevis & Tang + +=item L + +Rewrite libguestfs use of setfiles so that it doesn't stop on ext4 immutable bits + +=item L + +No return values from a directory listing when there are simply too many files in that directory (NULL value return) + +=item L + +RFE: customize --selinux-relabel should be the default, with --no-selinux-relabel used to opt out + +=back + +=head1 SEE ALSO + +L, +L, +L, +L, +L, +L, +L, +L + +=head1 AUTHORS + +=begin comment + +git shortlog -s v1.48.0.. + +=end comment + +=over 4 + +=item Adolfo Jayme Barrientos + +=item Andrey Drobyshev + +=item Emilio Herrera + +=item Ettore Atalan + +=item Geoff Amey + +=item Hela Basa + +=item Jan Kuparinen + +=item Kashyap Chamarthy + +=item Laszlo Ersek + +=item Marcin Stanclik + +=item Michał Smyk + +=item Neil Hanlon + +=item Nikolay Shirokovskiy + +=item Pavel Borecki + +=item Piotr Drąg + +=item Richard W.M. Jones + +=item Ricky Tigg + +=item Temuri Doghonadze + +=item Yuri Chornoivan + +=back + +=head1 COPYRIGHT + +Copyright (C) 2009-2023 Red Hat Inc. diff --git a/docs/guestfs-release-notes.pod b/docs/guestfs-release-notes.pod index 732d311f9..ed7002043 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 a4479e65d..443717875 100644 --- a/po-docs/podfiles +++ b/po-docs/podfiles @@ -32,6 +32,7 @@ docs/guestfs-release-notes-1.42.pod docs/guestfs-release-notes-1.44.pod docs/guestfs-release-notes-1.46.pod docs/guestfs-release-notes-1.48.pod +docs/guestfs-release-notes-1.50.pod docs/guestfs-release-notes-1.6.pod docs/guestfs-release-notes-1.8.pod docs/guestfs-release-notes.pod