1guestfs-release-notes-1.34(1)Virtualization Supportguestfs-release-notes-1.34(1)
2
6 guestfs-release-notes - libguestfs Release Notes
7
9 These release notes only cover the differences from the previous
10 stable/dev branch split (1.32.0). For detailed changelogs, please see
11 the git repository, or the ChangeLog file distributed in the tarball.
12 New features
14 Multiple performance enhancements were made in libguestfs. The "hot
15 cache" time to launch to appliance should be under 1 second assuming
16 recent qemu and kernel are installed. There are also new utilities for
17 precisely benchmarking libguestfs (utils/boot-benchmark and
18 utils/boot-analysis in the source tree).
19 The virt-p2v tool for converting physical machines to virtual machines
21 was substantially improved. This includes: clearer, coloured output
22 during conversions, support for Gtk 3, more detailed information about
23 hardware, click to identify network interfaces, more debugging tools
24 included with the ISO, and many bug fixes.
25 f2fs (Flash Friendly File System) is now supported (Pino Toscano).
27 New tools
29 virt-p2v-make-kiwi(1) can be used to build the virt-p2v ISO based on
31 SLES and openSUSE, using the kiwi utility (Cédric Bosdonnat).
32 New features in existing tools
34 virt-resize will now preserve the GPT GUID. This was required for
36 Windows Server 2012 R2, where the bootloader would become confused if
37 the GUID changed (Maxim Perevedentsev).
38 virt-resize will use sparse copying for (old MBR-style) extended
40 partitions. This makes resizing of guests that use extended partitions
41 much faster (Maxim Perevedentsev).
42 virt-p2v kernel command line options can now be used to set defaults
44 for GUI configuration.
45 The virt-p2v debugging options have been completely removed,
47 simplifying the interface and documentation. Debugging information is
48 now captured fully automatically.
49 virt-p2v-make-disk lets you specify an --arch option, allowing you to
51 build a 32 bit virt-p2v, for compatibility with older systems.
52 virt-p2v-make-disk no longer requires that you specify an "os-version"
54 for the virt-p2v disk. If omitted it will try to choose a suitable
55 "os-version" depending on your host system.
56 virt-p2v-make-disk and virt-p2v-make-kickstart both gain a new
58 --install option that allows you to add arbitrary extra packages to the
59 virt-p2v ISO, for customization, additional debugging tools and so on.
60 virt-v2v will now uninstall Parallels Tools (or the equivalent
62 Virtuozzo Tools) from Linux guests. Also stop the Windows drivers from
63 loading at boot. (Roman Kagan and Pavel Butsykin)
64 virt-v2v --in-place mode has been enhanced to allow the caller to
66 choose whether or not to install certain virtio drivers in the guest
67 (Roman Kagan).
68 virt-v2v conversion of Windows guests was substantially rewritten and
70 simplified (Roman Kagan).
71 virt-v2v --in-place mode now supports installing virtio-scsi drivers in
73 guests (Roman Kagan).
74 virt-v2v can now convert SUSE guests and SUSE guests using UEFI (Cédric
76 Bosdonnat and Jim Fehlig).
77 virt-v2v can now convert guests to Glance that have multiple disks.
79 Previously it would fail on such guests.
80 The virt-v2v --no-trim and --vmtype options are now no-ops. They will
82 print a warning but are otherwise ignored. virt-v2v can now generate
83 the OVF vmtype correctly without user intervention.
84 virt-v2v has now been tested against SUSE Xen as a source hypervisor
86 (Cédric Bosdonnat).
87 virt-v2v adds support for SUSE VMDP drivers (Cédric Bosdonnat).
89 virt-v2v can convert OVA files containing subfolders, as produced by
91 SUSE Studio (Cédric Bosdonnat).
92 virt-v2v sets the OVF "<Origin>" element correctly. oVirt has been
94 extended to support more source hypervisors (Shahar Havivi).
95 virt-v2v now supports Windows Server 2016 (Tomáš Golembiovský).
97 The virt-builder --list option can now be used to show all templates or
99 a single template (Pino Toscano).
100 All OCaml-based tools now use getopt_long(3) for option parsing, and
102 --help output has been improved (Pino Toscano).
103 virt-builder and virt-customize --selinux-relabel option can now fully
105 relabel the guest filesystem at build time, without requiring a lengthy
106 autorelabel at first boot.
107 virt-customize --delete now accepts globs.
109 New virt-customize --uninstall option lets you uninstall packages.
111 virt-customize can now use "pvvxsvc" as an alternative to "rhsrvany"
113 for running firstboot scripts in Windows guests (Cédric Bosdonnat).
114 virt-customize now uses the strongest hashing scheme for passwords on
116 Arch and Void Linux (Pino Toscano).
117 virt-customize --install now works correctly on Arch (Pino Toscano).
119 virt-inspector has new options --no-applications and --no-icon to
121 prevent the list of applications and icon from being included in the
122 XML output (Pino Toscano).
123 New virt-sysprep --network option has been added, allowing you to
125 actually use the --install etc options which were present in virt-
126 sysprep before but did not usually work. Note that the network is
127 still disabled by default.
128 virt-sysprep "fs-uuids" operation no longer fails on btrfs guests
130 (Maxim Perevedentsev).
131 virt-dib can output Docker images (Pino Toscano).
133 virt-dib has a new --drive-format option to allow the user to specify
135 the format of the helper drive (Pino Toscano).
136 All OCaml virt tools now have a --colors/--colours option which enables
138 coloured output (using ANSI escape sequences) even if the output is not
139 a tty. The default is to check if the output is a tty and disable
140 coloured output if not. This allows coloured output to be consumed by
141 other tools.
142 Language bindings
144 PHP test coverage has been enhanced (Pino Toscano).
146 PHP 7 is now supported (Pino Toscano).
148 Python bindings are now compliant with PEP 8 (Pino Toscano).
150 A Python pip package is available in
152 http://libguestfs.org/download/python/
153 The Ruby bindings now print the full exception if one is thrown by the
155 event callback. Note this is still incorrect behaviour as event
156 callbacks should not throw exceptions, but it aids debugging.
157 All OCaml libraries and programs are now compiled with -safe-string, if
159 supported by the OCaml compiler.
160 Inspection
162 Alpine Linux using busybox can now be inspected. Also the APK package
164 manager is supported in virt-customize (Pino Toscano).
165 We now handle inspection of Mageia 4 (Pino Toscano).
167 Void Linux and the Void Linux xbps package manager are fully supported
169 (Pino Toscano).
170 Parsing of CoreOS version information has been enhanced (Pino Toscano).
172 It is now possible to get an icon from ALT Linux (Pino Toscano).
174 PLD Linux versions < 3 are now recognized (Pino Toscano).
176 Windows drive letters are now returned for guests using GPT partitions
178 (Dawid Zamirski).
179 We can now correctly inspect Unix guests that do not have an /etc/fstab
181 file (Pino Toscano).
182 Added another source for the Ubuntu icon which doesn't rely on GNOME
184 having been installed in the guest.
185 We can now get an icon for Windows 7 64 bit guests.
187 Libosinfo integration was rewritten to deal with the new database
189 format used by osinfo (Pino Toscano).
190 Documentation
192 New manual page guestfs-building(1) describes how to build libguestfs
194 from source.
195 The man pages, tools and tool --help output is now automatically
197 checked to ensure that all tool options are properly documented, that
198 warning sections are included where necessary, and that every page has
199 a description section.
200 The guestfs-testing(1) man page has been refreshed and based on a newer
202 libguestfs.
203 Architectures and platforms
205 virt-customize now works on POWER7 and POWER8 platforms, both big
207 endian and little endian (Xianghua Chen and Hu Zhang).
208 Security
210 See also guestfs-security(1).
211 CVE-2015-8869
213 https://bugzilla.redhat.com/CVE-2015-8869
215 This vulnerability in OCaml might affect virt tools written in the
217 OCaml programming language. It affects only 64 bit platforms. Because
218 this bug affects code generation it is difficult to predict which
219 precise software could be affected, and therefore our recommendation is
220 that you recompile libguestfs using a version of the OCaml compiler
221 where this bug has been fixed (or ask your Linux distro to do the
222 same).
223 virt-customize ownership of .ssh, .ssh/authorized_keys
225 https://bugzilla.redhat.com/1337561
227 Previously when virt-customize injected an SSH key into a guest, when
229 it created the ~/.ssh and ~/.ssh/authorized_keys directory and file (in
230 case they were missing) it created them with owner and group
231 "root.root". This has been fixed so the correct user is used. This is
232 not thought to have been exploitable.
233 Windows "%systemroot%"
235 The inspection code has been made more robust against guests which
237 might use very long "%systemroot%" (derived from the guest-controlled
238 Windows Registry). This is not thought to have been exploitable.
239 Virtio-rng is now available in the appliance
241 virtio-rng (the virtual Random Number Generator device) is now passed
243 to the appliance, which should improve the quality random numbers
244 generated for GUIDs and cryptographic key generation.
245 API
247 New APIs
248 "btrfs_filesystem_show"
250 List all devices where a btrfs filesystem is spanned (Pino
251 Toscano).
252 "download_blocks"
254 "download_inode"
255 "filesystem_walk"
256 Download filesystem data blocks from a given partition. Download
257 arbitrary files by inode number. Retrieve all files from a
258 filesystem including deleted files.
259 Note these require optional dependency The Sleuth Kit. (Matteo
261 Cafasso)
262 "get_sockdir"
264 Read the path where temporary sockets are stored (Pino Toscano).
265 "mountable_device"
267 "mountable_subvolume"
268 Split a Mountable into device name and subvolume (Cédric
269 Bosdonnat).
270 "ntfscat_i"
272 Download NTFS file by inode number (Matteo Cafasso).
273 "part_expand_gpt"
275 Allow in-place expanding of GPT partitions by moving the second
276 (backup) partition table to the end of the disk (Maxim
277 Perevedentsev).
278 "part_get_disk_guid"
280 "part_set_disk_guid"
281 "part_set_disk_guid_random"
282 Get and set the GPT disk GUID, or set it to a fresh random value
283 (Maxim Perevedentsev).
284 "selinux_relabel"
286 SELinux-relabel part or all of the guest filesystem.
287 Other API changes
289 "guestfs_set_selinux", "guestfs_get_selinux", "guestfs_setcon",
291 "guestfs_getcon" and "guestfs_llz" have been deprecated. Use the new
292 API "guestfs_selinux_relabel" to relabel filesystems. Use
293 "guestfs_lgetxattrs" to list the "security.selinux" extended attributes
294 of existing files.
295 "guestfs_vfs_minimum_size" can now be used on dirty filesystems (Maxim
297 Perevedentsev).
298 "guestfs_ll" now works on paths which contain absolute symlinks (Pino
300 Toscano).
301 "guestfs_glob_expand" now has an optional "directoryslash" boolean
303 parameter which controls whether trailing slashes are returned for
304 directory names (Pino Toscano).
305 "guestfs_lvs" will no longer return LVs which have the "activationskip"
307 flag set. The reason is that such LVs have no "/dev/VG/LV" device node
308 and so code which read the list of LVs and then probed the devices
309 themselves would immediately fail. You can use "guestfs_lvs_full" if
310 you want to read all LVs. (Pino Toscano).
311 "guestfs_list_disk_labels" now no longer fails if no disks with labels
313 were added. Instead it now returns an empty list (Pino Toscano).
314 "guestfs_is_lv" no longer fails if passed a btrfs subvolume, it returns
316 false instead (Maxim Perevedentsev).
317 Build changes
319 qemu ≥ 1.3.0 is required.
320 yajl (a JSON parsing library) is required to build libguestfs.
322 You can now build with GCC 6.
324 "make check-valgrind" now has substantially better coverage.
326 "make check-slow" now works again.
328 Use "make -C appliance clean-supermin-appliance" to clean the supermin
330 appliance (it will be rebuilt on next "make").
331 There are a variety of new rules for running virt-p2v from the source
333 directory: "make -C p2v run-virt-p2v-directly" | "run-virt-p2v-in-a-vm"
334 | "run-virt-p2v-non-gui-conversion". These are documented further in
335 guestfs-hacking(1).
336 virt-p2v may be built using either Gtk 2 or Gtk 3. To force a
338 particular version of Gtk to be used, "./configure --with-gtk=2|3"
339 The "./configure" options are now mostly documented in
341 guestfs-building(1).
342 Internals
344 In git, versions are now tagged with "v1.XX.YY" (previously they were
345 tagged with "1.XX.YY"). Using the "v-" prefix is more common in git
346 repositories.
347 When using the libvirt backend, we now wait for qemu to exit gracefully
349 instead of killing it after 15 seconds. This helps when writing to
350 slow devices (especially cheap USB keys).
351 Error messages from libvirt now include the "err->int1" field which
353 usually contains the "errno".
354 On ARM, all DTB (device tree) code has been removed. qemu creates the
356 right device tree on the fly, we do not need to specify one.
357 The C API tests now use larger test disks, allowing BTRFS to be tested
359 properly (Pino Toscano).
360 The tests should now work on a pure Python 3 host (Pino Toscano).
362 In C bindings, internal functions are now (mostly) consistently named
364 "guestfs_int_*" whereas previously there was no consistent scheme.
365 The old "safe_malloc" etc functions are now no longer exported by the
367 library, nor used in language bindings.
368 Setting TMPDIR to a path longer than ~ 100 characters will no longer
370 cause libguestfs to fail silently and randomly when creating Unix
371 domain sockets (Pino Toscano).
372 The "COMPILE_REGEXP" macro can now be used in the daemon.
374 When tracing, results containing structs are now printed in full (Pino
376 Toscano).
377 The Perl "Sys::Guestfs" module now no longer embeds an incrementing API
379 "version number". This module is now always at phony version "1.0".
380 To find the real version of libguestfs from Perl you must call
381 "$g->version".
382 All code is compiled with "-Wstack-usage=10000" and multiple changes
384 have been made to remove stack allocation of large strings and buffers.
385 The error(3) function is now used everywhere, replacing most previous
387 uses of perror(3) + exit(3), and fprintf(3) + exit.
388 In C code, "/**" comments are turned into documentation which is
390 automatically added to the guestfs-hacking(1) manual page.
391 A safe "getumask" function has been added. For recent Linux kernels
393 this uses the newly added "Umask" field in /proc/self/status. For
394 older Linux and other Unix, this uses a thread-safe technique involving
395 fork(2) (thanks: Josh Stone, Jiri Jaburek, Eric Blake).
396 Safe posix_fadvise(2) wrappers have been added, and more hints have
398 been added to the code which may make a minor difference to
399 performance.
400 A safe wrapper around waitpid(2) has been added which handles "INTR"
402 properly.
403 "podwrapper.pl" (used to generate the manual pages) now stops if any
405 POD error is found. A new script called "podcheck.pl" does cross-
406 checking of --help output, tool options and manual pages.
407 All version numbers in the library (eg. versions of qemu, versions of
409 libvirt, versions of guest operating systems) are unified in a single
410 file src/version.c (Pino Toscano).
411 On Windows guests, virt-customize will use the vendor-neutral path
413 "C:\Program Files\Guestfs\Firstboot" to store firstboot scripts.
414 Previously it used "C:\Program Files\Red Hat\Firstboot". This change
415 should be invisible to the scripts themselves. (Cédric Bosdonnat)
416 On Linux guests, the firstboot services generated by virt-builder
418 --firstboot etc have been renamed to "guestfs-firstboot" (Pino
419 Toscano).
420 There is now a common "debug" function used by all OCaml tools,
422 replacing previous code which did "if verbose () then printf ...".
423 virt-p2v copies files it needs over to the virt-v2v conversion server
425 using scp(1), instead of trying to send them via the shell session.
426 This should improve reliability and should be a completely transparent
427 to end users.
428 All code in mllib is now built into a single "mllib.cma" or
430 "mllib.cmxa" library. All code in customize is now built into a single
431 "customize.cma" or "customize.cmxa" library. This simplifies the build
432 of the OCaml tools.
433 lvmetad(8) is now used in the appliance when available (Pino Toscano).
435 "Silent rules" are used for OCaml, Java, Erlang and POD. Use "make
437 V=1" to see the full command lines again (Pino Toscano).
438 Bugs fixed
440 https://bugzilla.redhat.com/1364347
441 virt-sparsify --in-place failed with UEFI system
442 https://bugzilla.redhat.com/1362357
444 run_command runs exit handlers when execve fails (e.g. due to
445 missing executable)
446 https://bugzilla.redhat.com/1362354
448 virt-dib failed to create image using DIB_YUM_REPO_CONF
449 https://bugzilla.redhat.com/1359652
451 Fail to inspect Windows ISO file
452 https://bugzilla.redhat.com/1358142
454 Some info will show when convert guest to libvirt by virt-v2v with
455 parameter --quiet
456 https://bugzilla.redhat.com/1354335
458 overlay of disk images does not specify the format of the backing
459 file
460 https://bugzilla.redhat.com/1352761
462 Virt-manager can't show OS icons of win7/win8/ubuntu guest.
463 https://bugzilla.redhat.com/1350363
465 Improve error info "remote server timeout unexpectedly waiting for
466 password prompt" when connect to a bogus server at p2v client
467 https://bugzilla.redhat.com/1348900
469 virt-p2v should update error prompt when 'Test connection' with a
470 non-existing user in conversion server
471 https://bugzilla.redhat.com/1345813
473 virt-sysprep --install always failed to install the packages
474 specified
475 https://bugzilla.redhat.com/1345809
477 virt-customize --truncate-recursive should give an error message
478 when specifying a no-existing path
479 https://bugzilla.redhat.com/1343423
481 [RFE]Should give a better description about 'curl error 22' when
482 failed using ssh identity http url at p2v client
483 https://bugzilla.redhat.com/1343414
485 Failed SSH to conversion server by ssh identity http url at p2v
486 client
487 https://bugzilla.redhat.com/1343375
489 [RFE] uninstall packages inside the VM
490 https://bugzilla.redhat.com/1342447
492 Ifconfig command is not supported on p2v client
493 https://bugzilla.redhat.com/1342398
495 Convert a guest from RHEL by virt-v2v but its origin info shows
496 RHEV at rhevm
497 https://bugzilla.redhat.com/1342337
499 Should remind a warning about disk image has a partition when using
500 virt-p2v-make-disk
501 https://bugzilla.redhat.com/1341984
503 virt-get-kernel prompts an 'invalid value' error when using
504 --format auto
505 https://bugzilla.redhat.com/1341564
507 virt-p2v spinner should be hidden when it stops spinning
508 https://bugzilla.redhat.com/1340809
510 Testing connection timeout when input regular user of conversion
511 server with checked "use sudo......"button
512 https://bugzilla.redhat.com/1340464
514 [RFE] Suggestion give user a reminder for "Cancel conversion"
515 button
516 https://bugzilla.redhat.com/1340407
518 Multiple network ports will not be aligned at p2v client
519 https://bugzilla.redhat.com/1338083
521 Update UEFI whitelist for official fedora packages
522 https://bugzilla.redhat.com/1337561
524 virt-customize --ssh-inject not applying correct file permission
525 https://bugzilla.redhat.com/1335671
527 extra quotes around UUID confuses findfs in RHEL (but not in
528 Fedora)
529 https://bugzilla.redhat.com/1332025
531 Inspection does not parse /etc/redhat-release containing "Derived
532 from Red Hat Enterprise Linux 7.1 (Source)"
533 https://bugzilla.redhat.com/1327488
535 RFE: Allow p2v kernel options without p2v.server to set defaults
536 https://bugzilla.redhat.com/1325825
538 virt-v2v should prevent using multiple '-b' and '-n' option appears
539 on the command line
540 https://bugzilla.redhat.com/1321620
542 libguestfs: error: could not parse integer in version number: 7"
543 https://bugzilla.redhat.com/1321338
545 [1.33.16] Compilation Error: Unbound value List.sort_uniq in v2v.ml
546 line 988, characters 10-24:
547 https://bugzilla.redhat.com/1317843
549 `virt-builder --update` fails with: "dnf -y --best upgrade: command
550 exited with an error"
551 https://bugzilla.redhat.com/1316479
553 v2v cmd cannot exit and "block I/O error in device 'appliance': No
554 space left on device (28)" is printed when specified "-v -x"
555 https://bugzilla.redhat.com/1316041
557 virt-rescue fails, but missing error message
558 https://bugzilla.redhat.com/1314244
560 RFE: virt-p2v log window should process colour escapes and
561 backspaces
562 https://bugzilla.redhat.com/1312254
564 virt-v2v -o libvirt doesn't preserve or use correct <graphics
565 type="vnc|spice">
566 https://bugzilla.redhat.com/1309706
568 error: internal error: Invalid floppy device name: hdb
569 https://bugzilla.redhat.com/1309619
571 Wrong warning info "use standard VGA" shows when converting windows
572 > 7 by virt-v2v
573 https://bugzilla.redhat.com/1309580
575 OS name of win8.1 x64 guest shows incorrect in rhevm3.6 general
576 info
577 https://bugzilla.redhat.com/1308769
579 virt-v2v does not copy additional disks to Glance
580 https://bugzilla.redhat.com/1306666
582 Failure when disk contains an LV with activationskip=y
583 https://bugzilla.redhat.com/1296606
585 virt-v2v doesn't remove VirtualBox additions correctly because of
586 file quoting
587 https://bugzilla.redhat.com/1293527
589 There should be a reminder to avoid user to edit a guest image by
590 multiple tools at the same time in guestfish man page
591 https://bugzilla.redhat.com/1293276
593 guestfish can not ll a symbolic link dir or edit a file in it
594 https://bugzilla.redhat.com/1278878
596 guestfish should be able to handle LVM thin layouts
597 https://bugzilla.redhat.com/1264835
599 ppc64le: virt-customize --install fail to detect the guest arch
600 https://bugzilla.redhat.com/1264332
602 Test that trimming in virt-v2v doesn't regress
603 https://bugzilla.redhat.com/1232192
605 Virt-v2v gives an error on a blank disk: part_get_parttype: unknown
606 signature, of the output: BYT;
607 https://bugzilla.redhat.com/1229386
609 virt-p2v in non-GUI mode doesn't show any conversion progress or
610 status
611 https://bugzilla.redhat.com/1227599
613 P2V invalid password prints unexpected end of file waiting for
614 command prompt.
615 https://bugzilla.redhat.com/1224795
617 On Ubuntu, virt-builder --install and --update cannot use the
618 network
619 https://bugzilla.redhat.com/1213324
621 virt-v2v: warning: unknown guest operating system: windows windows
622 6.3 when converting win8,win8.1,win2012,win2012R2,win10 to rhev
623 https://bugzilla.redhat.com/1203898
625 Support inspecting docker images without /etc/fstab
626 https://bugzilla.redhat.com/1186935
628 libguestfs cannot inspect recent Fedora / RHEL >= 7 when /usr is a
629 separate partition
630 https://bugzilla.redhat.com/1167916
632 P2V: invalid conversion server prints unexpected end of file
633 waiting for password prompt.
634 https://bugzilla.redhat.com/1152825
636 virt-rescue --selinux can not work well, when enable selinux in the
637 command line the value of 'getenforce' is still Disabled in virt-
638 rescue appliance
639 https://bugzilla.redhat.com/1150298
641 ARM 32 bit on Ubuntu: warning: cast to pointer from integer of
642 different size [-Wint-to-pointer-cast]
643 https://bugzilla.redhat.com/1089100
645 NetworkManager avc unlink denied for resolv.conf after using
646 --selinux-relabel
647 https://bugzilla.redhat.com/983969
649 RFE: virt-sysprep should be SELinux-aware
650 https://bugzilla.redhat.com/855058
652 RFE: virt-p2v: display more information about storage devices
653 https://bugzilla.redhat.com/554829
655 SELinux handling could be done better.
656
658 guestfs-examples(1), guestfs-faq(1), guestfs-performance(1),
659 guestfs-recipes(1), guestfs-testing(1), guestfs(3), guestfish(1),
660 http://libguestfs.org/
661
663 Richard W.M. Jones
664
666 Copyright (C) 2009-2020 Red Hat Inc.
667
669 This program is free software; you can redistribute it and/or modify it
670 under the terms of the GNU General Public License as published by the
671 Free Software Foundation; either version 2 of the License, or (at your
672 option) any later version.
673 This program is distributed in the hope that it will be useful, but
675 WITHOUT ANY WARRANTY; without even the implied warranty of
676 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
677 General Public License for more details.
678 You should have received a copy of the GNU General Public License along
680 with this program; if not, write to the Free Software Foundation, Inc.,
681 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
682
684 To get a list of bugs against libguestfs, use this link:
685 https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
686 To report a new bug against libguestfs, use this link:
688 https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
689 When reporting a bug, please supply:
691 • The version of libguestfs.
693 • Where you got libguestfs (eg. which Linux distro, compiled from
695 source, etc)
696 • Describe the bug accurately and give a way to reproduce it.
698 • Run libguestfs-test-tool(1) and paste the complete, unedited output
700 into the bug report.
701libguestfs-1.48.3 2022-05-26 guestfs-release-notes-1.34(1)