1guestfs-release-notes-1.30(1)Virtualization Supportguestfs-release-notes-1.30(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.28.0). For detailed changelogs, please see
11 the git repository, or the ChangeLog file distributed in the tarball.
12 New features
14 New tools
15 virt-dib(1) is a secure and safe alternative to the OpenStack
17 "diskimage-builder" tool. It is compatible with diskimage-builder
18 elements. (Pino Toscano)
19 virt-get-kernel(1) extracts the kernel and ramdisk from a disk image.
21 Previously this functionality was part of virt-builder(1), but the new
22 tool is more featureful. (Pino Toscano)
23 New features in existing tools
25 virt-v2v(1) -i ova mode can now read a wider range of OVA files, and
27 also unpacked files (directories).
28 virt-v2v now securely passes options to curl, so passwords, cookies and
30 so on cannot be seen by users with shell access on the same machine.
31 virt-v2v has a new --password-file option to allow you to securely pass
33 in a password, and to avoid an interactive prompt.
34 virt-v2v disables Windows autoreboot, making debugging conversion
36 failures on Windows easier.
37 virt-v2v now comes with an extensive external test suite. See
39 virt-v2v-test-harness(1).
40 virt-v2v allows virtio drivers to come from any location (Roman Kagan),
42 and drivers can be read directly from the virtio ISO.
43 virt-v2v supports conversion of Windows ≥ 8. Note this is
45 experimental, and possibly broken. Use with caution.
46 virt-v2v can now convert UEFI guests.
48 virt-p2v(1) adds a network configuration dialog.
50 virt-p2v now has "p2v.pre", "p2v.post" and "p2v.fail" triggers,
52 allowing arbitrary scripts for preparing the host for conversion and
53 tidying up post-conversion.
54 virt-p2v now uses the more advanced metacity window manager (instead of
56 matchbox).
57 virt-sysprep(1) will remove "/var/spool/mail/username" for non-root
59 accounts (Hu Tao).
60 virt-customize(1), virt-builder(1) and virt-sysprep have the following
62 new options:
63 --commands-from-file
65 allow long lists of commands to be read from a file instead of from
66 the command line (Pino Toscano)
67 --copy
69 copy files inside the guest (Maros Zatko)
70 --copy-in
72 copy host files recursively into the guest (Pino Toscano)
73 --move
75 move files inside the guest (Maros Zatko)
76 --ssh-inject
78 inject SSH keys into a guest (Pino Toscano)
79 --sm-attach
81 --sm-credentials
82 --sm-register
83 --sm-remove
84 --sm-unregister
85 register and unregister a guest from subscription-manager (Pino
86 Toscano)
87 --touch
89 touch a file in the guest (Pino Toscano)
90 --truncate
92 --truncate-recursive
93 truncate files (Maros Zatko)
94 Improvements to virt-customize firstboot support. In particular,
96 Windows firstboot should work as well as Linux (Roman Kagan).
97 virt-df(1) can now use PolicyKit, SASL and other authentication methods
99 when getting the list of domains from libvirt.
100 Improvements to guestfish bash completion (Pino Toscano).
102 Bash completion now completes short options as well as long options
104 (Pino Toscano).
105 guestfish(1) now displays a command synopsis if the number of
107 parameters given to a command is wrong (Hu Tao).
108 virt-builder now supports Red Hat Enterprise Linux versions back to
110 RHEL 3.
111 virt-builder supports SUSE guests using zypper (Cédric Bosdonnat).
113 Language bindings
115 The Java bindings now include validated Javadoc, and other improvements
117 (Pino Toscano).
118 Multiple fixes and improvements to the PHP bindings (Pino Toscano).
120 Inspection
122 Inspection can now get icons from RHEL 7 and CentOS 7.
124 /etc/favicon.png is now allowed to be a symbolic link.
126 For RPM-based guests, inspection now returns RPM Epoch fields.
128 Debian packages now have separate Epoch and Version fields (Nikos
130 Skalkotos).
131 OpenBSD detection added, FreeBSD and NetBSD added as separate
133 "distros", and other BSD inspection improvements and bug fixes (Nikos
134 Skalkotos).
135 CoreOS detection added (Nikos Skalkotos).
137 The package manager in Fedora ≥ 22 is "dnf".
139 ReactOS guests can be inspected (Maros Zatko).
141 Add support for UEFI guests.
143 Inspection now works when kernel modules are gzip or xz compressed
145 (Pino Toscano).
146 Inspection now recognizes ppc64 and ppc64le guests (Maros Zatko).
148 Inspection lists the installed applications on Archlinux guests (Nikos
150 Skalkotos).
151 Architectures and platforms
153 PPC64 (POWER7) and PPC64LE (POWER8) architectures are now much better
155 supported, and should work out of the box.
156 For aarch64, we use AAVMF (an open source UEFI implementation based on
158 OVMF) if available to run the appliance.
159 For armv7, we now use the -M virt machine type by default.
161 There is better support for compiling on non-Linux platforms (Pino
163 Toscano, Margaret Lewicka).
164 Libguestfs should now work on MIPS 32 bit little endian ("mipsel"). I
166 have not been able to try 64 bit or big endian.
167 Security
169 CVE-2014-8484
170 CVE-2014-8485
171 Libguestfs previously ran the strings(1) utility on untrusted
172 files. Strings could parse BFD headers in an unsafe way, leading
173 to possible arbitrary code execution. Libguestfs now runs strings
174 with a flag to ensure it does not try to parse BFD headers. This
175 could have led to exploitation of the libguestfs appliance, but
176 since libguestfs further constrains the appliance through
177 virtualization, SELinux and other techniques, it was unlikely to
178 have caused any privilege escalation on the host.
179 XPath injection in virt-v2v
181 One possible XPath injection vulnerability was fixed in virt-v2v.
182 This might have allowed a malicious guest which was being converted
183 by virt-v2v to construct an arbitrary XPath expression which would
184 have been evaluated on the host (by the libxml2 library linked to
185 the virt-v2v binary). It is not clear what the effects of this
186 might be.
187 For further information, see upstream commit
189 https://github.com/libguestfs/libguestfs/commit/6c6ce85f94c36803fe2db35a98db436bff0c14b0
190 Denial of service problems when using "qemu-img info"
192 When using the American Fuzzy Lop fuzzer ("afl-fuzz") on the
193 "qemu-img info" command, Richard W.M. Jones found that certain
194 files can cause the "qemu-img" program to use lots of memory and
195 time (for example 6GB of heap and 14 seconds of CPU time on a fast
196 Intel processor), and in some cases to crash. Since libguestfs may
197 run "qemu-img info" on disk images to find out what they contain,
198 this transitively could cause libguestfs to hang or consume lots of
199 memory.
200 Libguestfs was modified so that it uses resource limits to limit
202 the space and time used by "qemu-img info", to avoid this problem.
203 If a malicious user tries to pass one of these disk images to
204 libguestfs, "qemu-img" will crash and the crash is reported back to
205 libguestfs callers as an error message.
206 API
208 New APIs
209 "guestfs_add_libvirt_dom"
211 This exposes a previously private API that allows you to pass a
212 "virDomainPtr" object directly from libvirt to libguestfs.
213 "guestfs_blockdev_setra"
215 Adjust readahead parameter for devices. See "blockdev --setra"
216 command.
217 "guestfs_btrfs_balance"
219 "guestfs_btrfs_balance_cancel"
220 "guestfs_btrfs_balance_pause"
221 "guestfs_btrfs_balance_resume"
222 "guestfs_btrfs_balance_status"
223 Balance support for Btrfs filesystems (Hu Tao).
224 "guestfs_btrfs_filesystem_defragment"
226 Filesystem defragmentation support for Btrfs filesystems (Hu Tao).
227 "guestfs_btrfs_image"
229 Create an image of a Btrfs filesystem (Chen Hanxiao)
230 "guestfs_btrfs_qgroup_assign"
232 "guestfs_btrfs_qgroup_create"
233 "guestfs_btrfs_qgroup_destroy"
234 "guestfs_btrfs_qgroup_limit"
235 "guestfs_btrfs_qgroup_remove"
236 "guestfs_btrfs_qgroup_show"
237 "guestfs_btrfs_quota_enable"
238 "guestfs_btrfs_quota_rescan"
239 Quote support for Btrfs filesystems (Hu Tao).
240 "guestfs_btrfs_rescue_chunk_recover"
242 Scan and recover the chunk tree in Btrfs filesystems (Hu Tao).
243 "guestfs_btrfs_rescue_super_recover"
245 Restore superblocks in Btrfs filesystems (Hu Tao).
246 "guestfs_btrfs_replace"
248 Replace a device in a Btrfs filesystem (Cao Jin).
249 "guestfs_btrfs_scrub"
251 "guestfs_btrfs_scrub_cancel"
252 "guestfs_btrfs_scrub_resume"
253 "guestfs_btrfs_scrub_status"
254 Scrub a Btrfs filesystem (Hu Tao).
255 "guestfs_btrfs_subvolume_get_default"
257 Get the default subvolume of a Btrfs filesystem (Hu Tao).
258 "guestfs_btrfs_subvolume_show"
260 List detailed information about the subvolume of a Btrfs filesystem
261 (Hu Tao).
262 "guestfs_btrfstune_enable_extended_inode_refs"
264 "guestfs_btrfstune_enable_skinny_metadata_extent_refs"
265 "guestfs_btrfstune_seeding"
266 Various tuning parameters for Btrfs filesystems (Chen Hanxiao).
267 "guestfs_c_pointer"
269 Return the C pointer to the underlying "guestfs_h *". This allows
270 interworking of libguestfs bindings with bindings from other
271 libraries. For further information see
272 https://bugzilla.redhat.com/1075164
273 "guestfs_copy_in"
275 "guestfs_copy_out"
276 Flexible APIs for recursively copying directories of files between
277 the host and guest filesystem. Previously these were available
278 only as guestfish commands, but now any API users can call them
279 (Pino Toscano).
280 "guestfs_part_get_gpt_guid"
282 "guestfs_part_set_gpt_guid"
283 Get and set the GPT per-partition GUID.
284 "guestfs_part_get_mbr_part_type"
286 Get MBR partition type (Chen Hanxiao).
287 "guestfs_set_uuid_random"
289 Set the UUID of a filesystem to a randomly generated value;
290 supported filesystems currently are ext2/3/4, XFS, Btrfs, and swap
291 partitions. (Chen Hanxiao).
292 Other API changes
294 "guestfs_disk_create" can now use VMDK files as backing files.
296 "guestfs_btrfs_subvolume_snapshot" takes extra optional parameters (all
298 added by Hu Tao):
299 "ro"
301 for creating a read-only Btrfs snapshot
302 "qgroupid"
304 for adding the snapshot to a qgroup
305 "guestfs_btrfs_subvolume_create" can also take the optional "qgroupid"
307 parameter (Hu Tao).
308 "guestfs_set_uuid" can set UUID of swap partitions, Btrfs (Hu Tao, Chen
310 Hanxiao).
311 "guestfs_copy_device_to_file" and "guestfs_copy_file_to_file" have a
313 new optional "append" parameter, allowing you to append to the output
314 file instead of truncating it.
315 "guestfs_mkfs" has a new optional "label" parameter to set the initial
317 label of the new filesystem (Pino Toscano).
318 "guestfs_set_label" and "guestfs_set_uuid" now set "ENOTSUP" as errno
320 when there is no implemented support for the filesystem of the
321 specified mountable (Chen Hanxiao).
322 Environment variables now let you write "LIBGUESTFS_DEBUG=true",
324 "LIBGUESTFS_DEBUG=0" and so on.
325 All "guestfs_sfdisk*" APIs have been deprecated. Because sfdisk(8) was
327 rewritten, incompatibly, upstream, we don't recommend using these APIs
328 in future code. Use the "guestfs_part*" APIs as replacements.
329 APIs such as "guestfs_download" do not truncate /dev/stdout or
331 /dev/stderr when writing to them, meaning that if you redirect stdout
332 or stderr to a file, the file is no longer truncated.
333 Build changes
335 The daemon no longer uses its own separate copy of gnulib. Instead it
336 shares a single copy with the library.
337 OCaml .annot files are now created, so IDEs and editors like emacs and
339 vi can browse OCaml types in the source code.
340 Various fixes to allow different host/appliance architecture builds
342 (Pino Toscano).
343 Automake is now used directly to build all the OCaml programs, instead
345 of ad hoc Makefile rules. One side effect of this is to enable
346 warnings in all the C code used by OCaml programs.
347 "-fno-strict-overflow" is used throughout the build to avoid dubious
349 GCC optimizations.
350 Multiple cleanups to support GCC 5.
352 OCaml OUnit2 is needed to run some OCaml tests.
354 Creating a statically linked libguestfs.a should work again.
356 The src/api-support subdirectory and its scripts are no longer used.
358 Instead we store in the generator/actions.ml when the API was added to
359 libguestfs.
360 Internationalization
362 The translation service has changed from Transifex to Zanata.
363 Many more translations are available now, for both library and tools
365 messages and documentation.
366 Internals
368 In all OCaml tools, there are now common "error", "warning", "info"
369 functions, and common way to set and get the --quiet, -x (trace) and -v
370 (verbose) flags, and colour highlighting used consistently.
371 "COMPILE_REGEXP" macros are used to simplify PCRE constructors and
373 destructors.
374 In the generator, "Pointer" arguments have finally been implemented.
376 Internal identifiers no longer use double and triple underscores (eg.
378 "guestfs___program_name"). These identifiers are invalid for C99 and
379 C++ programs, although compilers would accept them.
380 The daemon no longer parses "guestfs_*" options from /proc/cmdline.
382 Instead it only takes ordinary command line options. The appliance
383 init script turns /proc/cmdline into daemon command line options.
384 The tests can now run the daemon as a "captive process", allowing it to
386 be run directly on the host. The main advantage of this is we can run
387 valgrind directly on the daemon during testing.
388 Bugs fixed
390 https://bugzilla.redhat.com/1239053
391 virt-v2v error reporting when grub.conf cannot be parsed by Augeas
392 https://bugzilla.redhat.com/1238053
394 v2v:Duplicate disk target set when convert guest with cdrom
395 attached
396 https://bugzilla.redhat.com/1237869
398 Virtio drivers are not installed for windows 2008 guests by
399 virt-v2v
400 https://bugzilla.redhat.com/1234351
402 virt-v2v Support for Fedora virtio-win drivers
403 https://bugzilla.redhat.com/1232192
405 Virt-v2v gives an error on a blank disk: part_get_parttype: unknown
406 signature, of the output: BYT;
407 https://bugzilla.redhat.com/1229385
409 virt-p2v in kernel command line mode should power off the machine
410 after conversion
411 https://bugzilla.redhat.com/1229340
413 virt-p2v no GUI mode appends \n to the final command line parameter
414 https://bugzilla.redhat.com/1229305
416 virt-sysprep at cleanup deletes /var/spool/at/.SEQ which results in
417 failing at
418 https://bugzilla.redhat.com/1226794
420 "Doing conversion……" still shows after cancel the conversion from
421 virt-p2v client
422 https://bugzilla.redhat.com/1215042
424 Memory leak in virNetSocketNewConnectUNIX
425 https://bugzilla.redhat.com/1213324
427 virt-v2v: warning: unknown guest operating system: windows windows
428 6.3 when converting win8,win8.1,win2012,win2012R2 to rhev
429 https://bugzilla.redhat.com/1213247
431 virt tools should print the same format of version string
432 https://bugzilla.redhat.com/1212808
434 RFE: virt-builder --touch
435 https://bugzilla.redhat.com/1212807
437 virt-builder --selinux-relabel flag fails on cross-architecture
438 builds
439 https://bugzilla.redhat.com/1212680
441 RFE: virt-inspector xpath query should output a neat format of the
442 query element
443 https://bugzilla.redhat.com/1212152
445 virt-builder firstboot-command fails: File name too long
446 https://bugzilla.redhat.com/1211996
448 virt-inspector gives incorrect arch (ppc64) for ppc64le guest
449 https://bugzilla.redhat.com/1203817
451 RFE: virt-customize --move and --copy
452 https://bugzilla.redhat.com/1201526
454 index-parser can't parse systemd mount files properly
455 https://bugzilla.redhat.com/1196101
457 virt-builder --upload option doesn't work to a FAT partition
458 https://bugzilla.redhat.com/1196100
460 virt-builder -x option on its own does not enable tracing
461 https://bugzilla.redhat.com/1195204
463 `virt-builder` should create $HOME/.cache directory if it already
464 doesn't exist
465 https://bugzilla.redhat.com/1193237
467 Virt-builder fingerprint is required even when no check desired
468 https://bugzilla.redhat.com/1189284
470 virt-resize should preserve GPT partition UUIDs, else EFI guests
471 become unbootable
472 https://bugzilla.redhat.com/1188866
474 Performance regression in virt-builder when uncompressing image
475 https://bugzilla.redhat.com/1186800
477 virt-v2v should support gzip format ova as input
478 https://bugzilla.redhat.com/1185561
480 virt-sparsify should ignore read-only LVs
481 https://bugzilla.redhat.com/1182463
483 "mknod-b", "mknod-c", and "mkfifo" do not strip non-permissions
484 bits from "mode"
485 https://bugzilla.redhat.com/1176493
487 virt-v2v ignores sound device when convert xen guest to local kvm
488 https://bugzilla.redhat.com/1175676
490 Typo error in 'help ping-daemon'
491 https://bugzilla.redhat.com/1175196
493 "parse-environment" and "parse-environment-list" fail to parse
494 "LIBGUESTFS_TRACE = 0"
495 https://bugzilla.redhat.com/1175035
497 "is-blockdev"/"is-blockdev-opts" fail to detect "/dev/sda"
498 https://bugzilla.redhat.com/1174280
500 RFE: Allow v2v conversion of Oracle Linux 5.8 VMware VM
501 https://bugzilla.redhat.com/1174200
503 New virt-v2v failure: CURL: Error opening file: NSS: client
504 certificate not found (nickname not specified): Invalid argument
505 https://bugzilla.redhat.com/1174123
507 Graphics password disappear after conversion of virt-v2v
508 https://bugzilla.redhat.com/1174073
510 The listen address for vnc is changed after conversion by virt-v2v
511 https://bugzilla.redhat.com/1171666
513 inspection thinks EFI partition is a separate operating system
514 https://bugzilla.redhat.com/1171130
516 virt-v2v conversion of RHEL 3 guest fails with: All of your
517 loopback devices are in use
518 https://bugzilla.redhat.com/1170685
520 Conversion of RHEL 4 guest fails: rpm -ql
521 1:kernel-utils-2.4-23.el4: virt-v2v: error: libguestfs error:
522 command_lines:
523 https://bugzilla.redhat.com/1170073
525 virt-v2v picks debug kernels over non-debug kernels when versions
526 are equal
527 https://bugzilla.redhat.com/1169045
529 virt-sparsify: libguestfs error: qemu-img info: 'virtual-size' is
530 not representable as a 64 bit integer
531 https://bugzilla.redhat.com/1169015
533 virt-resize --expand fails on ubuntu-14.04.img image (regression)
534 https://bugzilla.redhat.com/1168144
536 warning: fstrim: fstrim: /sysroot/: FITRIM ioctl failed: Operation
537 not supported (ignored) when convert win2003 guest from xen server
538 https://bugzilla.redhat.com/1167921
540 p2v: No Network Connection dialog
541 https://bugzilla.redhat.com/1167774
543 virt-p2v fails with error:"nbd.c:nbd_receive_negotiate():L501: read
544 failed"
545 https://bugzilla.redhat.com/1167623
547 Remove "If reporting bugs, run virt-v2v with debugging enabled .."
548 message when running virt-p2v
549 https://bugzilla.redhat.com/1167601
551 "Conversion was successful" pop out even virt-p2v fails
552 https://bugzilla.redhat.com/1167302
554 virt-v2v: warning: ova hard disk has no parent controller when
555 convert from a ova file
556 https://bugzilla.redhat.com/1166618
558 virt-resize should give out the detail warning info to let
559 customers know what's going wrong
560 https://bugzilla.redhat.com/1165975
562 File "/boot/grub2/device.map" showing is not right after converting
563 a rhel7 guest from esx server
564 https://bugzilla.redhat.com/1165785
566 mount-loop command fails: mount failed: Unknown error -1
567 https://bugzilla.redhat.com/1165569
569 Disable "cancel conversion" button after virt-p2v conversion
570 finished
571 https://bugzilla.redhat.com/1165564
573 Provide Reboot/Shutdown button after virt-p2v
574 https://bugzilla.redhat.com/1164853
576 Booting in qemu found no volume groups and failed checking the
577 filesystems
578 https://bugzilla.redhat.com/1164732
580 The description of 'help append' is not accurately, it add the
581 kernel options to libguestfs appliance not the guest kernel
582 https://bugzilla.redhat.com/1164697
584 typo errors in man pages
585 https://bugzilla.redhat.com/1164619
587 Inspect-get-icon failed on RHEL7 guest
588 https://bugzilla.redhat.com/1162966
590 xfs should also give a warning out to let customer know the
591 limitation
592 https://bugzilla.redhat.com/1161575
594 Failed to import guest with "rtl8139" nic to openstack server
595 after converted by v2v
596 https://bugzilla.redhat.com/1159651
598 virt-sysprep firstboot script is not deleted if it reboot a RHEL 7
599 guest
600 https://bugzilla.redhat.com/1159258
602 esx win2008 32 bit guest fail to load after conversion because the
603 firmware isn't ACPI compatible
604 https://bugzilla.redhat.com/1159016
606 libvirt backend does not set RBD password
607 https://bugzilla.redhat.com/1158526
609 Use password file instead of process interaction
610 https://bugzilla.redhat.com/1157679
612 virt-p2v-make-disk should add firmwares
613 https://bugzilla.redhat.com/1156449
615 libguestfs FTBFS on f21 ppc64le
616 https://bugzilla.redhat.com/1156301
618 virt-inspector support adding a remote disk, but in its man page -a
619 URI / --add URI is missing
620 https://bugzilla.redhat.com/1155121
622 Virt-v2v will fail when using relative path for -i ova
623 https://bugzilla.redhat.com/1153844
625 Redundancy whitespace at the end of directory name when use <TAB>
626 to complete the directory name in guestfish with a xfs filesystem
627 in guest
628 https://bugzilla.redhat.com/1153589
630 virt-v2v will hang when converting esx guest before disk copy phase
631 https://bugzilla.redhat.com/1152998
633 virt-v2v / qemu-img fails on ova image
634 https://bugzilla.redhat.com/1151910
636 virt-ls should remove '/' in the output when specify the directory
637 name as /etc/
638 https://bugzilla.redhat.com/1151900
640 Should also add a field for directory files when run virt-ls with
641 --csv option
642 https://bugzilla.redhat.com/1151033
644 virt-v2v conversions from VMware vCenter server run slowly
645 https://bugzilla.redhat.com/1146832
647 virt-v2v fail to convert guest with disk type volume
648 https://bugzilla.redhat.com/1146007
650 Input/output error during conversion of esx guest.
651 https://bugzilla.redhat.com/1135585
653 [RFE] virt-builder should support copying in a directory/list of
654 files
655 https://bugzilla.redhat.com/1089566
657 [abrt] livecd-tools: kickstart.py:276:apply:IOError: [Errno 2] No
658 such file or directory:
659 '/run/media/jones/2tp001data/createlive/temp/imgcreate-_dX8Us/install_root/etc/rpm/macros.imgcreate'
660 https://bugzilla.redhat.com/1079625
662 virt-sparsify fails if a btrfs filesystem contains readonly
663 snapshots
664 https://bugzilla.redhat.com/1075164
666 RFE: allow passing in a pre-opened libvirt connection from python
667 https://bugzilla.redhat.com/912499
669 Security context on image file gets reset
670 https://bugzilla.redhat.com/889082
672 [RFE] virt-v2v should check whether guest with same name exist on
673 target first then transfer the disk
674 https://bugzilla.redhat.com/855059
676 RFE: virt-p2v: display more information about network devices such
677 as topology, bonding, etc.
678 https://bugzilla.redhat.com/823758
680 p2v client should have largest number restrictions for CPU and
681 Memory settings
682 https://bugzilla.redhat.com/709327
684 hivex cannot read registry hives from ReactOS
685 https://bugzilla.redhat.com/709326
687 virt-inspector cannot detect ReactOS
688 https://bugzilla.redhat.com/119673
690 installation via NFS doesn't seem to work
691
693 guestfs-examples(1), guestfs-faq(1), guestfs-performance(1),
694 guestfs-recipes(1), guestfs-testing(1), guestfs(3), guestfish(1),
695 http://libguestfs.org/
696
698 Richard W.M. Jones
699
701 Copyright (C) 2009-2020 Red Hat Inc.
702
704 This program is free software; you can redistribute it and/or modify it
705 under the terms of the GNU General Public License as published by the
706 Free Software Foundation; either version 2 of the License, or (at your
707 option) any later version.
708 This program is distributed in the hope that it will be useful, but
710 WITHOUT ANY WARRANTY; without even the implied warranty of
711 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
712 General Public License for more details.
713 You should have received a copy of the GNU General Public License along
715 with this program; if not, write to the Free Software Foundation, Inc.,
716 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
717
719 To get a list of bugs against libguestfs, use this link:
720 https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
721 To report a new bug against libguestfs, use this link:
723 https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
724 When reporting a bug, please supply:
726 · The version of libguestfs.
728 · Where you got libguestfs (eg. which Linux distro, compiled from
730 source, etc)
731 · Describe the bug accurately and give a way to reproduce it.
733 · Run libguestfs-test-tool(1) and paste the complete, unedited output
735 into the bug report.
736libguestfs-1.42.0 2020-03-09 guestfs-release-notes-1.30(1)