From 96a887a9bf97f6d5270d2404ce0d915c504fdcc2 Mon Sep 17 00:00:00 2001 From: "Richard W.M. Jones" Date: Thu, 10 Mar 2022 10:14:06 +0000 Subject: [PATCH] docs: Update release notes for 1.48 Updates: commit 2f4fb09de32ef1d4dd110ef68293f874f5db3da3 --- docs/guestfs-release-notes-1.48.pod | 39 +++++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) diff --git a/docs/guestfs-release-notes-1.48.pod b/docs/guestfs-release-notes-1.48.pod index 1afab0983..e4f25548a 100644 --- a/docs/guestfs-release-notes-1.48.pod +++ b/docs/guestfs-release-notes-1.48.pod @@ -4,6 +4,40 @@ guestfs-release-notes - libguestfs Release Notes =head1 RELEASE NOTES FOR LIBGUESTFS 1.48 +=head2 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 C backend has been removed. The +L and L I<--live> option now prints an +error. + +The User-mode Linux (C) 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 C and C 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. + +C no longer supports hotplugging (adding a drive +after launch), and C 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. + =head2 Language bindings Fix allocation and deallocation of string lists in golang bindings @@ -35,6 +69,11 @@ No new APIs were added in libguestfs 1.48. =head3 Other API changes +C and C are deprecated and now +return errors. + +C has been deprecated and now returns an error. + In C the C parameter is deprecated because it is no longer supported in recent versions of XFS.