1guestfs-release-notes(1)    Virtualization Support    guestfs-release-notes(1)
2
3
4

NAME

6       guestfs-release-notes - libguestfs Release Notes
7

RELEASE NOTES FOR LIBGUESTFS 1.40

9       These release notes only cover the differences from the previous
10       stable/dev branch split (1.38.0).  For detailed changelogs, please see
11       the git repository, or the ChangeLog file distributed in the tarball.
12
13   New features
14       New features in existing tools
15
16       Virt-inspector now displays the libosinfo short ID for guests (Pino
17       Toscano).
18
19       Guestfish -N will now generate 1G disks instead of 100M disks by
20       default.
21
22       Virt-resize supports f2fs filesystems (Pino Toscano).
23
24       libguestfs-test-tool now supports bash tab completion (Pino Toscano).
25
26       The --machine-readable option now supports sending output to files or
27       stdout/stderr.  This works uniformly across most OCaml-based virt
28       tools, specifically: virt-builder, virt-builder-repository, virt-dib,
29       virt-get-kernel, virt-resize, virt-sparsify, and virt-v2v (Pino
30       Toscano).
31
32       Virt-builder --uninstall option now works on SUSE (Sebastian Meyer).
33
34       Virt-builder now supports Windows.  We are not able to ship Windows
35       templates in the public respository for obvious licensing reasons, but
36       if you are an MSDN subscriber you may build your own.  See
37       https://rwmj.wordpress.com/2018/09/13/creating-windows-templates-for-virt-builder/
38
39       Many tools now support a --key option allowing you to pass in
40       decryption keys for filesystems stored in local files on the host
41       rather than having to feed them in over stdin (Pino Toscano).
42
43       virt-v2v and virt-p2v
44
45       New -o rhv-upload mode for directly uploading images to RHV, bypassing
46       the Export Storage Domain (Tomáš Golembiovský, Nir Soffer, Daniel Erez,
47       Pino Toscano).
48
49       New -o openstack mode for directly uploading images to OpenStack and
50       Cinder using OpenStack APIs.
51
52       Virt-v2v now has a general mechanism for input and output options: -io
53       and -oo.
54
55       Virt-v2v can now install the RHV tools or QEMU GA in guests (Tomáš
56       Golembiovský).
57
58       The huge manual has now been split into several smaller documents and
59       is more focused on helping users to accomplish specific v2v tasks.
60
61       Multiple improvements to the OVF metadata when converting to RHV (Tomáš
62       Golembiovský, Pino Toscano, Arik Hadas).
63
64       Virt-v2v can now convert Linux guests with split kernel packages,
65       especially Ubuntu 18.04 (Pino Toscano).
66
67       Virt-v2v old --password-file option has been replaced by -ip (the old
68       option remains for backwards compatibility).
69
70       Virt-v2v now preserves the VM Generation ID.
71
72       Virt-v2v has a new --mac option allowing specific NICs to be mapped
73       precisely to networks or bridges on the target.
74
75       New virt-v2v --print-estimate option to estimate the size of data that
76       virt-v2v will copy.
77
78       Virt-v2v is now usually able to remove open-vm-tools and VMware Tools
79       from the Linux guest during conversion (Pino Toscano).
80
81       Virt-v2v can now support UEFI conversions to RHV (Tomáš Golembiovský).
82
83       Virt-p2v now prefers you to shut down instead of rebooting the machine
84       after conversion has finished (Pino Toscano).
85
86       Virt-v2v now writes the libosinfo short ID to the libvirt metadata when
87       using -o local and -o libvirt output modes (Martin Kletzander).
88
89       Language bindings
90
91       OpenJDK 10+ is supported (Pino Toscano).
92
93       Java bindings fixed for Gentoo host (Martin Kletzander).
94
95       Inspection
96
97       Support Kali Linux (Pino Toscano).
98
99       When inspecting mountpoints, look for /etc/mdadm/mdadm.conf as well as
100       /etc/mdadm.conf (Nikolay Ivanets).
101
102       Improved support for OpenSUSE Tumbleweed (Pino Toscano).
103
104       Architectures and platforms
105
106       Miscellaneous macOS build fixes (Adam Robinson).
107
108       Other
109
110       Multiple documentation typos fixed (Yuri Chornoivan).
111
112   Security
113       See also guestfs-security(1).
114
115       CVE-2018-11806
116
117       Qemu's slirp (userspace networking) had several buffer overflows which
118       could be triggered from the guest or network side.
119
120   API
121       New APIs
122
123       "f2fs_expand"
124           Expand an f2fs filesystem (Pino Toscano).
125
126       "inspect_get_osinfo"
127           Get the libosinfo short ID for the inspected guest (Pino Toscano).
128
129       "lvm_scan"
130           This rescans all PVs, VGs and LVs, optionally activating them.
131
132       Other API changes
133
134       "part_get_mbr_part_type" was reimplemented in OCaml (Nikolay Ivanets).
135
136       "list_filesystems" now filters out MBR extended partitions (Nikolay
137       Ivanets).
138
139       "vgscan" has been deprecated.  Use the new "lvm_scan" API in
140       preference.
141
142   Build changes
143       The JSON library switched from yajl to Jansson ≥ 2.7 (Pino Toscano).
144
145       Support for The Sleuth Kit 4.5 (Pino Toscano).
146
147       Multiple improvements in the "./configure" script (Lin Ma).
148
149       More out-of-tree build fixes (Hilko Bengen).
150
151       Some work on reproducible builds (Bernhard M. Wiedemann).
152
153   Internals
154       lvmetad is now used unconditionally, and is started much earlier in the
155       appliance boot process.  This fixes support for certain PV types.
156
157       On Debian, dash is installed inside the appliance and in virt-rescue
158       (Pino Toscano).
159
160       The amount of RAM assigned to the appliance has been increased from
161       500M to 768M (on x86_64, other architectures have different limits).
162       This enables use of up to 255 disks when using recent Linux kernels.
163
164       Virt-v2v now models the source machine type (eg. i440FX, Q35 or virt).
165
166       Virt-p2v now generates configuration code automatically, also code for
167       parsing the kernel command line.
168
169       Use "LT_INIT" instead of "AC_PROG_LIBTOOL".
170
171       The OCaml "JSON" code for parsing and serializing has been unified into
172       a single abstract data type.
173
174       Most OCaml tools are now built using the PIC runtime.  This has a
175       performance penalty on i686, but is relatively free on other
176       architectures and has security benefits.
177
178       The direct backend now queries the qemu binary for availability of KVM,
179       instead of using a heuristic based on /dev/kvm (Andrea Bolognani).
180
181       Our "clever" libxml2 writer macros are now used consistently across all
182       parts of the code base.
183
184       Qemu dropped -nodefconfig without telling us.  The equivalent
185       -no-user-config option is now used instead.  Qemu also moved the
186       "serial" option from -drive to -device, again without any notice, and
187       this is also fixed.
188
189   Bugs fixed
190       https://bugzilla.redhat.com/1664310
191           [RHEL 7.6 LP] openstack output leaks passwords
192
193       https://bugzilla.redhat.com/1661038
194           virt-inspector fails with "error: int_of_string" on a Linux image
195           when /etc/fstab contains a partionless device
196
197       https://bugzilla.redhat.com/1651432
198           v2v - support for -insecure option to support OSP SSL connection
199           for VM migrations
200
201       https://bugzilla.redhat.com/1642044
202           [RFE] virt-p2v UI should give the option to shutdown after
203           conversion is finished
204
205       https://bugzilla.redhat.com/1634248
206           virt-v2v cannot convert opensuse15 guest
207
208       https://bugzilla.redhat.com/1624902
209           Fix rhev-apt command that virt-v2v runs in Windows guests on first
210           boot
211
212       https://bugzilla.redhat.com/1624878
213           Update v2v docs to describe support for SHA 2 certs required for
214           converting Windows 7 and 2008 R2 guests
215
216       https://bugzilla.redhat.com/1615885
217           Minor log issue of virt-v2v
218
219       https://bugzilla.redhat.com/1614276
220           VixDiskLib: VixDiskLib_Read: Read 4096 sectors at 57516160 failed.
221           Error 2 (Memory allocation failed. Out of memory.) (DiskLib error
222           802: NBD_ERR_INSUFFICIENT_RESOURCES) at 5240.
223
224       https://bugzilla.redhat.com/1612785
225           "warning: <target dev='sr0'> was ignored because the device name
226           could not be recognized" should be hidden since convert cdrom is
227           supported by virt-v2v
228
229       https://bugzilla.redhat.com/1611690
230           part_to_dev "/dev/sdp1" returns "/dev/sd" instead of "/dev/sdp"
231
232       https://bugzilla.redhat.com/1608131
233           inspection fails when swap partition in /etc/fstab has incorrect
234           UUID compared to actual swap partition
235
236       https://bugzilla.redhat.com/1605071
237           On machines where /dev/kvm exists but KVM doesn't work, libguestfs
238           will not fall back to TCG
239
240       https://bugzilla.redhat.com/1602353
241           virt-inspector can't inspect LUKS-encrypted RHEL7 guest image
242
243       https://bugzilla.redhat.com/1601943
244           Improve error "No module named ovirtsdk4" in v2v rhv-upload
245           conversion
246
247       https://bugzilla.redhat.com/1598715
248           Adding QXL device in OVF causes Cirrus Logic device to be added to
249           guest
250
251       https://bugzilla.redhat.com/1598350
252           RFE: virt-v2v should preserve <genid>
253
254       https://bugzilla.redhat.com/1596851
255           Transfer fails if local host is in maintenance mode
256
257       https://bugzilla.redhat.com/1596810
258           Transfer fails if local host belongs to another DC
259
260       https://bugzilla.redhat.com/1592468
261           v2v to RHV transfer fails with: error: [empty name]: cannot read
262           '//*/disksection' with value: null
263
264       https://bugzilla.redhat.com/1592061
265           virt-v2v convert rhel5.3 failure when executing rpm -ql
266           kernel-2.6.18-128.el5 command
267
268       https://bugzilla.redhat.com/1591789
269           p2v: error: XML error: CPU vendor specified without CPU model
270
271       https://bugzilla.redhat.com/1590220
272           Hide rhv-upload option in virt-p2v client
273
274       https://bugzilla.redhat.com/1588451
275           Don't use relative socket paths for NBD
276
277       https://bugzilla.redhat.com/1588088
278           RFE: Support for -o rhv-upload via Unix domain socket
279
280       https://bugzilla.redhat.com/1586198
281           ovirt-imageio-daemon times out during migration
282
283       https://bugzilla.redhat.com/1580309
284           virt-v2v rhel7.6 build can't convert guest to null with qemu-kvm
285           rhel7.5.z build
286
287       https://bugzilla.redhat.com/1580292
288           Virt-v2v rhel7.6 build can't convert guest with qemu-kvm rhel7.5.z
289           build
290
291       https://bugzilla.redhat.com/1579047
292           virt-builder: ubuntu-18.04 template has stray HTTP proxy configured
293           for apt
294
295       https://bugzilla.redhat.com/1575640
296           virt-builder: error: host cpu (x86_64) and guest arch (unknown) are
297           not compatible
298
299       https://bugzilla.redhat.com/1570407
300           virt-v2v -i ova gives checksum error when missing files are
301           mentioned in .mf
302
303       https://bugzilla.redhat.com/1567763
304           guestfsd: error: /Windows/Drivers/VirtIO: Read-only file system
305
306       https://bugzilla.redhat.com/1564983
307           The mount-vfs failed to mount the logical volume
308
309       https://bugzilla.redhat.com/1561828
310           RHV tools not properly installed in migrated Windows VM's causing
311           boot failure
312
313       https://bugzilla.redhat.com/1559027
314           virt-v2v does not honor --network with -o rhv-upload
315
316       https://bugzilla.redhat.com/1557273
317           [RFE] Upload images directly to oVirt (virt-v2v -o rhv-upload)
318
319       https://bugzilla.redhat.com/1544842
320           [RFE] Add libosinfo short-id to virt-inspector output
321
322       https://bugzilla.redhat.com/1544674
323           virt-inspector --help differs from manpage
324
325       https://bugzilla.redhat.com/1544227
326           RFE: recognize the Kali Linux distribution
327
328       https://bugzilla.redhat.com/1532224
329           Resume=/dev/sdaX can't be updated to resume=/dev/vdaX in rhel7
330           guest's grub file after v2v conversion
331
332       https://bugzilla.redhat.com/1530967
333           Change categories of "Guest Operating system management by VIX API"
334           in v2v man page
335
336       https://bugzilla.redhat.com/1527334
337           Various -it vddk -io vddk* options should be documented, removed or
338           fixed
339
340       https://bugzilla.redhat.com/1148012
341           Reverted: RFE: Allow qemu-bridge-helper to be used to implement
342           guestfs_set_network
343

RELEASE NOTES FOR LIBGUESTFS 1.38

345       These release notes only cover the differences from the previous
346       stable/dev branch split (1.36.0).  For detailed changelogs, please see
347       the git repository, or the ChangeLog file distributed in the tarball.
348
349   New features
350       New tools
351
352       Virt-builder-repository is a new tool allowing end users to create and
353       update virt-builder repositories (Cédric Bosdonnat).
354
355       Virt-rescue (while not a new tool) has been substantially rewritten,
356       implementing job control, -m and -i options, escape keys, etc.
357
358       New features in existing tools
359
360       Virt-builder planner has been improved so that faster and more
361       efficient build plans are chosen for complex cases, especially when
362       either the tmpdir or output is on networked storage.
363
364       New virt-builder Fedora templates (starting with Fedora 26) will have
365       plain partition layout and use GPT for partitions.
366
367       Virt-customize "firstboot" scripts in guests using systemd are now
368       installed under the "multi-user.target" instead of "default.target" so
369       they will only run when the system is booted normally.
370
371       Virt-customize now sets a random /etc/machine-id for Linux guests, if
372       one is not already set.
373
374       Virt-df now works correctly on filesystems with block sizes smaller
375       than 1K (Nikolay Ivanets).
376
377       Virt-dib has further compatibility enhancements with diskimage-builder
378       (Pino Toscano).
379
380       Virt-sysprep removes "DHCP_HOSTNAME" from ifcfg-* files.
381
382       Virt-sysprep now works on Oracle Linux (Jamie Iles).
383
384       Virt-resize now correctly copies GPT partition attributes from the
385       source to the destination (Cédric Bosdonnat).
386
387       Bash tab completion implemented or enhanced for: virt-win-reg,
388       virt-v2v-copy-to-local.
389
390       virt-v2v and virt-p2v
391
392       Virt-v2v can now read VMware VMX files directly, either from local
393       disk, NFS storage, or over SSH from an ESXi hypervisor.
394
395       Virt-v2v can now use VDDK as an input source.
396
397       Both virt-v2v and virt-p2v are now able to pass through the source CPU
398       vendor, model and topology.  However unfortunately not all source and
399       target hypervisors are able to provide or consume this data at present
400       (Tomáš Golembiovský).
401
402       Virt-v2v now supports encrypted guests (Pino Toscano).
403
404       Virt-v2v can now handle VMware snapshots.  Note that the snapshots are
405       collapsed — it does not convert the chain of snapshots into a chain of
406       snapshots.
407
408       Virt-v2v now installs Windows 10 / Windows Server 2016 virtio block
409       drivers correctly (Pavel Butsykin, Kun Wei).
410
411       Virt-v2v now installs virtio-rng, balloon and pvpanic drivers, and
412       correctly sets this in the target hypervisor metadata for hypervisors
413       which support that (Tomáš Golembiovský).
414
415       Virt-v2v now installs both legacy and modern virtio keys in the Windows
416       registry (Ladi Prosek).
417
418       Virt-p2v can now preserve (in some cases) the offset of the Real Time
419       Clock from UTC.
420
421       Virt-p2v now combines several scp commands to the conversion server
422       into a single command, improving conversion times.
423
424       Virt-v2v now detects the special Linux Xen PV-only kernels correctly
425       (Laszlo Ersek).
426
427       Virt-v2v -o glance now generates the right properties for UEFI guests
428       (Pino Toscano).
429
430       Virt-v2v -o null now avoids spooling the guest to a temporary file,
431       instead it writes to the qemu "null block device".  This makes it
432       faster and use almost no disk space.
433
434       Virt-v2v -o rhv now supports Windows 2016 Server guest type.
435
436       Virt-v2v -i libvirtxml can now open network disks over http or https.
437
438       Virt-v2v will now give a warning about host passthrough devices (Pino
439       Toscano).
440
441       The virt-v2v --machine-readable output has been enhanced so it includes
442       "vcenter-https", "xen-ssh" and "in-place" facts (Pino Toscano).
443
444       Language bindings
445
446       Fix multiple memory leaks and other data corruption problems in the
447       Java bindings (Pino Toscano).
448
449       Perl %guestfs_introspection has been dropped.
450
451       Inspection
452
453       Inspection support was rewritten in OCaml and included inside the
454       daemon.  This makes inspection considerably faster, more robust and
455       more easily extensible in future.
456
457       Better icon support for ALT Linux guests (Pino Toscano).
458
459       Better support for NeoKylin (Qingzheng Zhang).
460
461       Can handle OSes like Void Linux which do not include "VERSION_ID" in
462       /etc/os-release (Pino Toscano).
463
464       Add support for Microsoft MS-DOS (Daniel Berrangé).
465
466       Architectures and platforms
467
468       Multiple fixes for S/390 architecture.  Libguestfs and all the tools
469       should now compile and run on this architecture.
470
471       Other
472
473       The libguestfs API is now thread-safe (although not parallel).  You can
474       call APIs on the same handle from multiple threads without needing to
475       take a lock.
476
477   Security
478       There were multiple vulnerabilities in the icoutils "wrestool" program
479       which is run by libguestfs to create icons for Windows guests.  Using
480       the latest "wrestool" is recommended.
481
482   API
483       New APIs
484
485       "hivex_value_string"
486           This replaces the deprecated "hivex_value_utf8" API, but does the
487           same thing.
488
489       "part_get_gpt_attributes"
490       "part_set_gpt_attributes"
491           Read and write GPT partition attribute flags (Cédric Bosdonnat).
492
493       "part_resize"
494           Enlarge or shrink an existing partition (Nikos Skalkotos).
495
496       "yara_destroy"
497       "yara_load"
498       "yara_scan"
499           Support for the Yara malware scanning engine (Matteo Cafasso).
500
501       Other API changes
502
503       APIs implemented in the daemon can now be written in either C or OCaml.
504       Several APIs were rewritten in OCaml, although we are not planning to
505       rewrite all of them.
506
507       You will now get a clear error message if you try to add too many disks
508       to the appliance, instead of getting a peculiar failure from qemu.
509
510       Certain APIs accidentally allowed you to use "/dev/urandom" as an input
511       "device", eg. "g.copy_device_to_device("/dev/urandom", "/dev/sda")".
512       The code has been modified to forbid this usage.
513
514       All APIs for inspecting installer CDs have been deprecated.  Use
515       libosinfo for this task.
516
517   Build changes
518       A working OCaml compiler ≥ 4.01 is now required for building
519       libguestfs.  The "./configure --disable-ocaml" option remains but is
520       only used to disable the OCaml language bindings.
521
522       Add "RELEASES" file which lists release dates for each version of
523       libguestfs.  You must update this file when making a new release.
524
525       Documentation generated by "gtk-doc" has been removed.  "./configure
526       --enable-gtk-doc" now does nothing.
527
528       Libtirpc is now used for XDR functions and rpcgen.  Note that glibc has
529       deprecated and in most Linux distros dropped these, so for most people
530       this will be an extra dependency (Martin Kletzander).
531
532       Libxcrypt is now used for crypt(3).  This is required if using glibc ≥
533       2.27.
534
535       "ocaml-hivex" is now required.
536
537       Libvirt ≥ 1.2.20 is now required.
538
539       There is now a "make check-root" target for tests which need to be run
540       as root (analogous to "make check-slow").
541
542       "./configure"-time check for "__attribute__((cleanup))" now works in
543       the cross-compilation case (Yann E. Morin).
544
545       The "AUTHORS" and "p2v/about-authors.c" files are now generated from a
546       single place.
547
548       Either GnuPG v1 or v2 can be used.
549
550       "./configure --with-guestfs-path" may be used to set the default
551       "LIBGUESTFS_PATH".  In addition the way that the path is searched has
552       changed slightly so that all types of appliances are searched in each
553       path element separately (Pavel Butsykin).
554
555       "GUESTFSD_EXT_CMD" which was used to mark external commands in the
556       daemon has been removed.  It was originally used by SUSE builds, but
557       they have not been using it for a while.
558
559       The output from "./configure" is now visually grouped under headings
560       related to what it is doing, making it much easier to scan (Pino
561       Toscano).
562
563       OCaml dependencies are now generated from a single script instead of
564       multiple not-quite-the-same Makefile fragments.
565
566       "./configure --with-distro=ID" can be used to override automatic Linux
567       distro detection at build time (Pino Toscano).
568
569       qemu ≥ 2.10 is supported (but not required).  This adds mandatory
570       locking to disks and libguestfs turns this off in certain circumstances
571       when it is known to be safe (Lars Seipel, Peter Krempa, Daniel
572       Berrangé, Pino Toscano, Fam Zheng, Yongkui Guo, Václav Kadlčík).
573
574   Internals
575       Most common code has been moved to the common/ subdirectory, with OCaml
576       common code being in common/ml* directories (eg.  common/visit and
577       common/mlvisit contain the visitor library in C and OCaml
578       respectively).  The mllib directory has been deleted and replaced by
579       common/mltools.
580
581       There is now a lightweight OCaml binding for PCRE, see common/mlpcre.
582       Use of OCaml "Str" library has been mostly replaced with PCRE.
583
584       Add more calls to "udev_settle" to improve stability of partition code
585       (Dawid Zamirski).
586
587       Run "udev_settle" with --exit-if-exists option, which improves the
588       speed of this command (Pavel Butsykin).
589
590       Detect new locations of major(3), minor(3), makedev(3).
591
592       Actions can now be deprecated with no suggested replacement, for APIs
593       such as "guestfs_wait_ready" that should simply be removed from client
594       code.
595
596       Use gnulib "set_nonblocking_flag" wrapper instead of calling fcntl(2)
597       with "O_NONBLOCK" (Eric Blake).  Similarly "set_cloexec_flag".
598
599       Fix memory leak in XFS version of "guestfs_vfs_minimum_size" (Pino
600       Toscano).
601
602       Valgrind checks now run on the virt-p2v binary.
603
604       Unicode single quotes ("‘’") and now used in place of '' or `'
605       throughout the code and documentation.  Similarly for "’s" instead of
606       "'s".
607
608       The "is_zero" function has been reimplemented for greater speed (Eric
609       Blake).
610
611       In the direct backend, virtio-blk support has been removed.  Virtio-
612       scsi is now the only supported way to add disks.
613
614       Generator string parameter and return types have been rationalised so
615       there are only two types ("String", "StringList") with many subtypes
616       eg. "FileIn" becomes "String (FileIn, ...)".
617
618       The appliance disk image can now be in formats other than raw (Pavel
619       Butsykin).
620
621       Multiple improvements to how we automatically build Debian templates
622       for virt-builder (Pino Toscano).  Enable serial console for these
623       templates (Florian Klink).
624
625       In the daemon, instead of making a private copy of lvm.conf and
626       modifying it (eg for filters), start with an empty file since LVM
627       understands that to mean "all defaults" (Alasdair Kergon, Zdenek
628       Kabelac).
629
630       The "direct" backend can now run QMP queries against the QEMU binary,
631       enhancing the kinds of information we can detect.  In addition the code
632       to query QEMU has been made more robust for handling multiple parallel
633       queries of different versions of QEMU.
634
635       OCaml Augeas bindings are bundled under common/mlaugeas.  The long term
636       plan is to remove this and use system ocaml-augeas when it is more
637       widely available in distros (Pino Toscano).
638
639       All OCaml modules ("*.ml" files) are now required to have an interface
640       file ("*.mli").  If they don't export anything then the interface will
641       be empty except for comments.
642
643       Certain OCaml features in OCaml ≥ 4.01 are used throughout the code,
644       including replacing ‘{ field = field }’ with ‘{ field }’.
645
646       Virt-builder "make-template" utility now uses the "virt-install
647       --transient" option so that we should never need to clean up left over
648       domains after a crash.  It also saves kickstarts and virt-install
649       commands, which are committed to git for future reference.
650
651       /dev/shm is now created in the appliance (Nicolas Hicher).
652
653       In verbose mode on Fedora guests, virt-customize will now use "dnf
654       --verbose" enabling better debugging output.
655
656       Virt-v2v input and output classes now contain a "#precheck" method
657       which is used to perform environmental checks before conversion starts.
658
659       Virt-p2v enables miniexpect debugging.  It is written to stderr (of
660       virt-p2v).
661
662       Virt-v2v free space checks are more liberal especially for smaller
663       guests (Pino Toscano).
664
665   Bugs fixed
666       https://bugzilla.redhat.com/1540535
667           Example URI of "Convert from ESXi hypervisor over SSH to local
668           libvirt" is incorrect in v2v man page
669
670       https://bugzilla.redhat.com/1539395
671           virt-customize segfaults after upgrading to 1.37.35-3
672
673       https://bugzilla.redhat.com/1536765
674           Libguestfs Perl bindings can leak a small amount of memory on error
675
676       https://bugzilla.redhat.com/1536763
677           libguestfs Lua bindings use strerror(), which isn’t thread safe
678
679       https://bugzilla.redhat.com/1536603
680           man page makes no mention of using '--' when trying to change exit
681           on error behavior
682
683       https://bugzilla.redhat.com/1525241
684           virt-df displays zeros for filesystems with block size =512
685
686       https://bugzilla.redhat.com/1519204
687           v2v should improve the result when convert a rhel7.4 guest with no
688           available kernels found in the bootloader
689
690       https://bugzilla.redhat.com/1518517
691           virt-v2v fails with "unsupported configuration: shared access for
692           disk 'sdb' requires use of supported storage format"
693
694       https://bugzilla.redhat.com/1516094
695           Mere presence of QEMU file locking options breaks NBD (Block
696           protocol 'nbd' doesn't support the option 'locking')
697
698       https://bugzilla.redhat.com/1514756
699           ./configure --disable-ocaml breaks building common/mlpcre which
700           breaks building daemon
701
702       https://bugzilla.redhat.com/1513884
703           [RFE]Should update some vddk info in v2v man page
704
705       https://bugzilla.redhat.com/1508874
706           virt-v2v: warning: ova disk has an unknown VMware controller type
707           (20)
708
709       https://bugzilla.redhat.com/1506572
710           virt-v2v '-i ova' is not parsing the MAC address from the source
711           OVF
712
713       https://bugzilla.redhat.com/1506511
714           virt-builder fails to parse repo file if it has blank space after
715           the repository identifier
716
717       https://bugzilla.redhat.com/1503958
718           Failed to convert the rhel5 guest with kmod-xenpv installed from
719           xen server by virt-v2v
720
721       https://bugzilla.redhat.com/1503497
722           qemu-kvm fails to open qcow2 files in read-only mode with qemu-kvm
723           1.5.3
724
725       https://bugzilla.redhat.com/1500673
726           Error info shows wrong sometimes when ssh to conversion server
727           using non-root user with sudo on p2v client
728
729       https://bugzilla.redhat.com/1500537
730           /dev/shm does not exist in the appliance environment
731
732       https://bugzilla.redhat.com/1497475
733           guestfish cannot list commands from interactive mode
734
735       https://bugzilla.redhat.com/1493048
736           Unbound constructor Hivex.OPEN_UNSAFE
737
738       https://bugzilla.redhat.com/1484957
739           bump debian images to use single-partition layout
740
741       https://bugzilla.redhat.com/1482737
742           virt-resize failed to expand swap partition for RHEL5.11 guest
743           image with "parsing UUID failed"
744
745       https://bugzilla.redhat.com/1477623
746           Running file API on a special chardev may hang forever
747
748       https://bugzilla.redhat.com/1476081
749           inspect-os  report error: could not parse integer in version
750           number: V7Update2
751
752       https://bugzilla.redhat.com/1472719
753           [RFE]Add warning in process of v2v converting guest which has pci
754           passthrough device
755
756       https://bugzilla.redhat.com/1472208
757           virt-v2v fails on opensuse 13.2 guest with error: statns:
758           statns_stub: path must start with a / character
759
760       https://bugzilla.redhat.com/1469655
761           firstboot scripts are not correctly installed in Fedora 26
762
763       https://bugzilla.redhat.com/1466563
764           Libguestfs should pass copyonread flag through to the libvirt XML
765
766       https://bugzilla.redhat.com/1465665
767           1.36.x build failure: gtkdocize fails using newer autotools due to
768           missing GTK_DOC_CHECK in configure.ac
769
770       https://bugzilla.redhat.com/1460338
771           guestfs_shutdown hangs if main process sets signal handlers
772
773       https://bugzilla.redhat.com/1459979
774           guestfs_add_domain_argv fails with readonly option when vdi/vhd
775           disk is attached to libvirt domain
776
777       https://bugzilla.redhat.com/1451665
778           RFE: Virt-v2v can't convert the guest which has encrypted partition
779
780       https://bugzilla.redhat.com/1450325
781           document URI format for -a parameters of tools
782
783       https://bugzilla.redhat.com/1448739
784           RFE: Support multicore decompression for OVA files using pigz and
785           pxz
786
787       https://bugzilla.redhat.com/1447202
788           Win 2016 guest is described as Win 10 after imported to RHEVM
789
790       https://bugzilla.redhat.com/1441197
791           RFE: ability to convert VMware virtual machines via vmx
792
793       https://bugzilla.redhat.com/1438939
794           Please drop or update GnuPG (1.4.x) dependency
795
796       https://bugzilla.redhat.com/1438794
797           [RFE] Install Windows virtio-rng drivers on VMs imported
798
799       https://bugzilla.redhat.com/1433937
800           virt-inspector can't get icon info from altlinux-centaurus
801
802       https://bugzilla.redhat.com/1433577
803           policycoreutils setfiles >= 2.6 does .. nothing
804
805       https://bugzilla.redhat.com/1431579
806           Windows 8 UEFI from VMware to KVM fails to boot after conversion
807
808       https://bugzilla.redhat.com/1430680
809           There is error info about "No such file or directory" when convert
810           a guest from ova file by v2v
811
812       https://bugzilla.redhat.com/1430184
813           virt-dib should generate sha256 checksum instead of sha512
814
815       https://bugzilla.redhat.com/1429506
816           RFE: OVMF should be detected on conversion server to prevent failed
817           conversion
818
819       https://bugzilla.redhat.com/1429491
820           Should rename network name of rhv in virt-v2v man page
821
822       https://bugzilla.redhat.com/1427529
823           virt-sysprep should remove DHCP_HOSTNAME
824
825       https://bugzilla.redhat.com/1417306
826           QEMU image file locking (libguestfs)
827
828       https://bugzilla.redhat.com/1409024
829           [Debian] Missing db_dump abort inspection
830
831       https://bugzilla.redhat.com/1406906
832           Segmentation fault when reading corrupted path with Python 3
833           bindings
834
835       https://bugzilla.redhat.com/1379289
836           RFE: virt-p2v should support mnemonic operations
837
838       https://bugzilla.redhat.com/1378022
839           There is virt-v2v warning about <listen type='none'> during
840           converting a guest which has listen type='none' in XML
841
842       https://bugzilla.redhat.com/1376547
843           qemu-system-s390x: -device
844           isa-serial,chardev=charserial0,id=serial0: 'isa-serial' is not a
845           valid device model name
846
847       https://bugzilla.redhat.com/1374232
848           selinux relabel fails on RHEL 6.2 guests with "libguestfs error:
849           selinux_relabel: : Success"
850
851       https://bugzilla.redhat.com/1367738
852           Missing bash completion scripts for: virt-diff guestunmount virt-
853           copy-in virt-copy-out virt-customize virt-get-kernel
854           virt-p2v-make-disk virt-p2v-make-kickstart virt-tar-in virt-tar-out
855           virt-v2v-copy-to-local virt-win-reg
856
857       https://bugzilla.redhat.com/1362649
858           RFE: virt-sysprep does not utilize libguestfs encryption support
859
860       https://bugzilla.redhat.com/1172425
861           [RFE]virt-v2v failed to convert VMware ESX VM with snapshot
862
863       https://bugzilla.redhat.com/1171654
864           Modify a file in virt-rescue with vi on some linux terminal such as
865           yakuake, can lead to abnormal display in virt-rescue shell
866
867       https://bugzilla.redhat.com/1167623
868           Remove "If reporting bugs, run virt-v2v with debugging enabled .."
869           message when running virt-p2v
870
871       https://bugzilla.redhat.com/1152819
872           Can not end a running command in virt-rescue by press ^C or other
873           keys, the only way is to exit virt-rescue
874

RELEASE NOTES FOR LIBGUESTFS 1.36

876       These release notes only cover the differences from the previous
877       stable/dev branch split (1.34.0).  For detailed changelogs, please see
878       the git repository, or the ChangeLog file distributed in the tarball.
879
880   New features
881       New tools
882
883       Virt-tail is a new tool for following (tailing) log files within a
884       guest, similar to the regular "tail -f" command.
885
886       New features in existing tools
887
888       Virt-customize, virt-get-kernel, virt-sparsify and virt-sysprep can now
889       handle encrypted guests (Pino Toscano).
890
891       Virt-builder and virt-customize now support --append-line, which is
892       useful for adding lines to the end of configuration files.
893
894       Virt-resize can now shrink and expand swap partitions (Pino Toscano).
895
896       Virt-resize can now output to non-local disks (Pino Toscano).
897
898       Virt-sysprep has a new operation called "backup-files" for removing
899       editor backups, and "passwd-backups" for removing /etc/passwd- and
900       similar.
901
902       Virt-dib can now create checksums using the new --checksum option (Pino
903       Toscano).
904
905       Virt-dib can now create tgz files.  In addition, extended attributes
906       and SELinux labels are preserved in the output tar file (Pino Toscano).
907
908       Virt-dib can now create squashfs files (Pino Toscano).
909
910       Bash tab-completion is now available in every command line tool that is
911       shipped.
912
913       virt-v2v and virt-p2v
914
915       Conversions of Debian (6+) and Ubuntu (10.04+) guests are now supported
916       (Tomáš Golembiovský, Pino Toscano).
917
918       Conversions from SUSE Xen hypervisor have now been tested (Cédric
919       Bosdonnat).
920
921       Windows conversions may now install a program "pnp_wait.exe" which
922       prevents conflicts between the Windows Plug-and-Play Manager and our
923       own scripts that install virtio device drivers.  Enabling this requires
924       the "pnp_wait.exe" program to be built separately (Roman Kagan).
925
926       OVA files exported from AWS can now be converted (Shahar Havivi).
927
928       When converting OVA files, in some circumstances virt-v2v can now read
929       disk images directly from the OVA input file instead of needing to
930       unpack the OVA file to a temporary directory.  This can save large
931       amounts of disk space, and is quicker (Tomáš Golembiovský).
932
933       Virt-p2v can now be built on RHEL 5 (2007-era) Linux and RHEL 6, which
934       means that 32 bit and hardware with ancient fakeraid disks can be
935       virtualized.  Binaries of virt-p2v based on these old versions of RHEL
936       can be found at http://oirase.annexia.org/virt-p2v/
937
938       Virt-p2v can now use nbdkit (an NBD server) as an alternative to qemu-
939       nbd.  In addition, virt-p2v can use "socket activation" which is a more
940       robust method for opening the NBD listening socket.  Socket activation
941       works with qemu-nbd or nbdkit, but requires the most up to date
942       versions.
943
944       To prevent timeouts during P2V conversions, virt-p2v inhibits power
945       saving on the physical machine, and also sends ping packets over the
946       ssh control and data connections.
947
948       Virt-v2v no longer removes the "Processor" and "Intelppm" nodes from
949       the Windows Registry.
950
951       Xen and vCenter conversions can now be done using the libvirt backend,
952       provided libvirt ≥ 2.1.0 is used.
953
954       /dev/srX (SCSI CD-ROM) devices are ignored (Tomáš Golembiovský).
955
956       When converting SUSE Linux guests, use /etc/modprobe.conf.local if it
957       exists.
958
959       Removing VMware tools from Linux guests should now work reliably (Pino
960       Toscano).
961
962       When converting OVA files, virt-v2v now checks the disk image hash
963       contained in the manifest file, whereas previously it was ignored
964       because of a mistake in the code.  In addition, SHA256 hashes are now
965       supported (Tomáš Golembiovský).
966
967       When converting OVA files that contain compressed disk images, we now
968       trust the "ovf:compression" attribute from the metadata instead of
969       using content sniffing on the disk image (Tomáš Golembiovský).
970
971       A new flag --vdsm-compat has been added to -o vdsm mode, allowing more
972       efficient qcow2 images to be generated.
973
974       Since the RHEV product [commercially supported version of oVirt] has
975       now been renamed to RHV, "RHEV" was changed to "RHV" throughout the
976       tooling.  In particular, -o rhev becomes -o rhv, although the old name
977       can be used for backwards compatibility.
978
979       The "RHEV-APT" utility is only installed when the output hypervisor is
980       oVirt or RHV.
981
982       A problem with virt-v2v running out of memory when doing an SELinux
983       relabel of the guest filesystem should now be resolved.
984
985       Language bindings
986
987       Setting "EXTRA_JAVAC_FLAGS" before ./configure allows you to add
988       arbitrary flags to "javac" when compiling the Java bindings.
989
990       Use of any libguestfs API which returned a single struct, from Perl or
991       Java bindings, would have leaked memory.  This has now been fixed (Pino
992       Toscano).
993
994       Inspection
995
996       Inspection of Windows guests with mildly corrupted Windows Registry
997       hives should now work instead of failing with an error.  This feature
998       requires hivex ≥ 1.3.14 (Dawid Zamirski).
999
1000       For Debian guests, we can now read the URL, source name, summary and
1001       full description of installed packages.  For RPM-based guests we can
1002       read the URL, summary and description (Pino Toscano).
1003
1004       Inspection of guest operating systems that use a separate /usr
1005       partition should now work more reliably (Pino Toscano).
1006
1007       When parsing guest /etc/fstab, paths are reduced to a canonical form
1008       (eg. "///usr//local//" → "/usr/local").
1009
1010       Inspection of btrfs subvolumes now works where the /etc/fstab options
1011       field contains commas.
1012
1013       /dev/cdN devices in guest /etc/fstab are ignored (Pino Toscano).
1014
1015       Architectures and platforms
1016
1017       Stable releases are now tested on aarch64, ppc64 and ppc64le
1018       architectures.
1019
1020       The RISC-V architecture is now handled as a guest, and libguestfs will
1021       now at least compile on RISC-V (but probably not work as there is no
1022       usable qemu at the time of writing).
1023
1024       Detection of S/390 and S/390x binaries and guests is now supported.
1025
1026       Other
1027
1028       ExFAT filesystems are now supported (Miles Wolbe).
1029
1030   Security
1031       See also guestfs-security(1).
1032
1033       There were no CVEs reported in this development cycle.  However some
1034       security-related hardening was carried out as described below.
1035
1036       Temporary filenames are now always generated using randomness from
1037       /dev/urandom (previously the C function random(3) was used in one
1038       case).
1039
1040       The $TERM environment variable is now validated before passing it
1041       through to the appliance kernel command line.
1042
1043   API
1044       New APIs
1045
1046       "guestfs_aug_transform"
1047           Exposes the Augeas "aug_transform" API (Pino Toscano).
1048
1049       "guestfs_find_inode"
1050           Find files by inode number (Matteo Cafasso).
1051
1052       "guestfs_inspect_get_windows_software_hive"
1053       "guestfs_inspect_get_windows_system_hive"
1054           Return the path to the Windows "HKLM\SYSTEM" and "HKLM\SOFTWARE"
1055           hives computed during inspection.
1056
1057       "guestfs_mksquashfs"
1058           Create a squashfs filesystem from a path (Pino Toscano).
1059
1060       Other API changes
1061
1062       "guestfs_add_domain"
1063           This call now handles libvirt file-based volumes correctly, where
1064           previously these would have been ignored.  Also handled are disks
1065           which require libvirt authentication secrets to open (Pino
1066           Toscano).
1067
1068       "guestfs_canonical_device_name"
1069           This call will no longer incorrectly modify Linux software RAID
1070           device names (like /dev/mdX).
1071
1072       "guestfs_file_architecture"
1073           Previously the "file_architecture" API could return either of the
1074           strings "i386" or "i486" for 32 bit x86 binaries.  It now only
1075           returns "i386" (as documented).
1076
1077           This API can now return the following new values: "riscv32",
1078           "riscv64", "riscv128", "s390", "s390x".
1079
1080       "guestfs_hivex_open"
1081           This now has an optional "GUESTFS_HIVEX_OPEN_UNSAFE" flag which
1082           allows certain corrupted Windows Registry hives to be opened.  This
1083           feature requires hivex ≥ 1.3.14 (Dawid Zamirski).
1084
1085       "guestfs_list_partitions"
1086           This call now returns Linux software RAID partitions.
1087
1088       "guestfs_part_to_dev"
1089           This call now correctly handles partition names which include
1090           "p<N>" (Pino Toscano).
1091
1092       "guestfs_set_label"
1093           This call can now change the labels of swap partitions (Pino
1094           Toscano).
1095
1096   Build changes
1097       libmagic, the library part of the "file" command, is now required at
1098       build time (previously optional).
1099
1100       GCC 7 is now supported.
1101
1102       "Silent rules" are now used for OCaml programs, Java bindings.  To show
1103       the full command line executed, add "V=1" on the make command line
1104       (Pino Toscano).
1105
1106       Slow testing ("make check-slow") now covers: firstboot scripts in Linux
1107       guests; v2v conversion of a selection of real Linux guests; the virt-
1108       customize --hostname and --timezone settings; the --root-password
1109       parameter; that the serial console works in virt-builder guests.
1110
1111       Large generated C source files, eg. the list of commands found in
1112       fish/cmds.c (and many more), have been split into smaller files to
1113       speed parallel compilation.
1114
1115       "make maintainer-check-extra-dist" now checks that all generated files
1116       are included in the tarball.
1117
1118       The tests no longer assume that "." is in Perl's @INC, as it is going
1119       to be removed soon (Pino Toscano).
1120
1121       Debian hosts using UsrMerge are now supported (Pino Toscano).
1122
1123       Header files and C structs can now have internal documentation using
1124       the special "/** ... */" comments.
1125
1126       "@VAR@" subtitutions in "./run" are now fully quoted.  This is
1127       necessary so that (eg) "./configure PYTHON=/some/path" works robustly
1128       if "/some/path" contains characters that need to be quoted (Hilko
1129       Bengen).
1130
1131       gperf ≥ 3.1 is now supported.
1132
1133       Kraxel's old edk2 builds can no longer be used for UEFI support.  UEFI
1134       code is now fully free software, so use the versions bundled with your
1135       Linux distro instead.
1136
1137       Virt-p2v can now be compiled on RHEL 5 (2007-era) Linux with Gtk 2.10.
1138
1139   Internals
1140       The generator and mllib "Common_utils" modules are now shared from the
1141       same source file.
1142
1143       A considerable amount of common code has been moved into the common
1144       directory in the source and is now compiled only once.  The mini-
1145       libraries located under here are: common/edit, common/errnostring,
1146       common/miniexpect, common/options, common/parallel, common/progress,
1147       common/protocol, common/utils, common/visit, common/windows.
1148
1149       The directory containing the main library code has moved from src
1150       lib.
1151
1152       All tests written in shell script now use a common file of utility
1153       functions (tests/test-functions.sh).  There are several new utility
1154       functions, mainly for skipping tests.  Also these test scripts can now
1155       use autoconf-like path variables like $abs_top_srcdir.
1156
1157       UEFI paths are now stored in the generator (generator/uefi.ml).
1158
1159       The way the generator handles actions and procedure numbers was changed
1160       quite substantially.  See generator/actions_*.ml and
1161       generator/proc_nr.ml.
1162
1163       The gnulib "getprogname" module is now used everywhere when
1164       needing/printing the program name (Pino Toscano).
1165
1166       perl/Guestfs.c is not translatable (Nikos Skalkotos).
1167
1168       Virt-builder templates moved from builder/website to builder/templates
1169       and there is now a single unified program which can build any template.
1170
1171       All Windows registry utilities used by virt-customize and virt-v2v have
1172       been moved to a common module called "Registry" under mllib.
1173
1174       All POSIX bindings have been moved to a new module called "Unix_utils"
1175       under mllib.
1176
1177       Inspection, virt-customize and virt-v2v no longer recompute the Windows
1178       "%systemroot%", "CurrentControlSet" or paths to the "HKLM\SYSTEM" and
1179       "HKLM\SOFTWARE" hives in multiple places.  Instead these are all
1180       computed once (during inspection) and passed to the other tools through
1181       various "guestfs_inspect_get_windows_*" APIs.
1182
1183       "/dev/pts" is now available inside the appliance, so any tools we run
1184       which require a pty will now work (Pino Toscano).
1185
1186       Most OCaml warnings have been fixed.
1187
1188       There is now a single common function for creating temporary files
1189       ("guestfs_int_make_temp_path") (Matteo Cafasso).
1190
1191       The $TERM environment variable is now validated before passing it
1192       through to the appliance kernel command line.
1193
1194       Useless USB and memballoon devices are no longer created in the
1195       appliance (Laine Stump).
1196
1197       On aarch64 we now use virtio-pci for the appliance.  This is somewhat
1198       faster than virtio-mmio.
1199
1200       Use of srandom(3) and random(3) has been minimized.  In particular,
1201       temporary filenames are no longer created based on randomness returned
1202       by random(3), but /dev/urandom is used instead.
1203
1204   Bugs fixed
1205       https://bugzilla.redhat.com/1425306
1206           typo error in virt-tail man page
1207
1208       https://bugzilla.redhat.com/1418283
1209           virt-v2v: appliance runs out of memory running setfiles command
1210
1211       https://bugzilla.redhat.com/1417549
1212           /usr/bin/x86_64-linux-gnu-ld.bfd.real:
1213           ../common/progress/.libs/libprogress.a(libprogress_la-progress.o):
1214           undefined reference to symbol 'UP@@NCURSES_TINFO_5.0.19991023'
1215
1216       https://bugzilla.redhat.com/1417444
1217           *** No rule to make target '../perl/lib/Sys/Guestfs.c', needed by
1218           'libguestfs.pot'
1219
1220       https://bugzilla.redhat.com/1416941
1221           compile of 1.34.3 fails with gperf 3.1
1222
1223       https://bugzilla.redhat.com/1414682
1224           guestfs_canonical_device_name incorrectly returns /dev/sd0 for MD
1225           devices (/dev/md0)
1226
1227       https://bugzilla.redhat.com/1414510
1228           guestfs_list_filesystems does not recognize ddf partitions
1229
1230       https://bugzilla.redhat.com/1409023
1231           [Debian] ldmtool not installed in the appliance
1232
1233       https://bugzilla.redhat.com/1404287
1234           qemu-kvm cannot boot RHEL 7 kernel with TCG, hangs at "Probing EDD
1235           (edd=off to disable)..."
1236
1237       https://bugzilla.redhat.com/1404182
1238           RFE: virt-resize should support a URL as the outdisk
1239
1240       https://bugzilla.redhat.com/1401474
1241           Importing VMs from VMware is failing with error "Inspection field
1242           'i_arch' was 'unknown'"
1243
1244       https://bugzilla.redhat.com/1401320
1245           RFE: Increate virt-sysprep coverage a bit
1246
1247       https://bugzilla.redhat.com/1400205
1248           Add --vdsm-compat=1.1 flag for VDSM
1249
1250       https://bugzilla.redhat.com/1398070
1251           typo error in man page
1252
1253       https://bugzilla.redhat.com/1392798
1254           secrets from libvirt domains are not read
1255
1256       https://bugzilla.redhat.com/1390876
1257           "--machine-readable" info should be updated in virt-v2v manual page
1258
1259       https://bugzilla.redhat.com/1379289
1260           RFE: virt-p2v should support mnemonic operations
1261
1262       https://bugzilla.redhat.com/1378022
1263           There is virt-v2v warning about <listen type='none'> during
1264           converting a guest which has listen type='none' in XML
1265
1266       https://bugzilla.redhat.com/1377081
1267           virt-p2v manual should update the new dialog information
1268
1269       https://bugzilla.redhat.com/1375157
1270           virt-v2v: -i ova: Permission denied when using libvirt and running
1271           as root
1272
1273       https://bugzilla.redhat.com/1374651
1274           Can't install qxl driver for display device in win7 guest after
1275           converting to glance by virt-v2v
1276
1277       https://bugzilla.redhat.com/1374405
1278           There is HTTP 404 error info when convert guest to glance by
1279           virt-v2v
1280
1281       https://bugzilla.redhat.com/1374232
1282           selinux relabel fails on RHEL 6.2 guests with "libguestfs error:
1283           selinux_relabel: : Success"
1284
1285       https://bugzilla.redhat.com/1372668
1286           Process status is not normal in windows guest after converted from
1287           kvm to rhev by virt-v2v
1288
1289       https://bugzilla.redhat.com/1372269
1290           Builder does not set hostname properly for Debian 8 (Jessie)
1291
1292       https://bugzilla.redhat.com/1371843
1293           Improve OVA import compatibility
1294
1295       https://bugzilla.redhat.com/1370424
1296           virt-manager coredump when vm with gluster image exists
1297
1298       https://bugzilla.redhat.com/1367839
1299           Cannot import VMs from Xen and VMware when using RHEL7.3 host.
1300
1301       https://bugzilla.redhat.com/1367738
1302           Missing bash completion scripts for: virt-diff guestunmount virt-
1303           copy-in virt-copy-out virt-customize virt-get-kernel
1304           virt-p2v-make-disk virt-p2v-make-kickstart virt-tar-in virt-tar-out
1305           virt-v2v-copy-to-local virt-win-reg
1306
1307       https://bugzilla.redhat.com/1367615
1308           OVMF file which is built for rhel7.3  can't be used for virt-v2v
1309           uefi conversion
1310
1311       https://bugzilla.redhat.com/1366456
1312           Converting rhel7 host installed on RAID:warning: fstrim: fstrim:
1313           /sysroot/: the discard operation is not supported
1314
1315       https://bugzilla.redhat.com/1366049
1316           RFE: libvirt backend: support handling disks stored as volume name
1317           in a pool
1318
1319       https://bugzilla.redhat.com/1365005
1320           Guest name is incorrect if convert guest from disk image by
1321           virt-v2v
1322
1323       https://bugzilla.redhat.com/1362649
1324           RFE: virt-sysprep does not utilize libguestfs encryption support
1325
1326       https://bugzilla.redhat.com/1354507
1327           virt-v2v conversions from vCenter do not consistently obey the
1328           proxy environment variables
1329
1330       https://bugzilla.redhat.com/1168144
1331           warning: fstrim: fstrim: /sysroot/: FITRIM ioctl failed: Operation
1332           not supported (ignored) when convert win2003 guest from xen server
1333
1334       https://bugzilla.redhat.com/1161019
1335           RFE: Only install RHEV-APT if virt-v2v -o rhev/-o vdsm option is
1336           used
1337
1338       https://bugzilla.redhat.com/1152369
1339           virt-v2v failed to convert RHEL 6.7 UEFI guest: no
1340           grub1/grub-legacy or grub2 configuration file was found
1341
1342       https://bugzilla.redhat.com/1141631
1343           [RFE] virt-v2v should support convert a guest to a dir-pool with
1344           using pool's uuid
1345
1346       https://bugzilla.redhat.com/1134878
1347           libvirt reports json "backing file" is missing
1348
1349       https://bugzilla.redhat.com/1019388
1350           firstboot scripts (virt-builder, virt-sysprep) don't work for
1351           Debian 6 & 7 guests
1352
1353       https://bugzilla.redhat.com/737600
1354           virt-v2v windows xp - machine dies BSOD - processr,sys - workaround
1355           provided
1356

RELEASE NOTES FOR LIBGUESTFS 1.34

1358       These release notes only cover the differences from the previous
1359       stable/dev branch split (1.32.0).  For detailed changelogs, please see
1360       the git repository, or the ChangeLog file distributed in the tarball.
1361
1362   New features
1363       Multiple performance enhancements were made in libguestfs.  The "hot
1364       cache" time to launch to appliance should be under 1 second assuming
1365       recent qemu and kernel are installed.  There are also new utilities for
1366       precisely benchmarking libguestfs (utils/boot-benchmark and
1367       utils/boot-analysis in the source tree).
1368
1369       The virt-p2v tool for converting physical machines to virtual machines
1370       was substantially improved.  This includes: clearer, coloured output
1371       during conversions, support for Gtk 3, more detailed information about
1372       hardware, click to identify network interfaces, more debugging tools
1373       included with the ISO, and many bug fixes.
1374
1375       f2fs (Flash Friendly File System) is now supported (Pino Toscano).
1376
1377       New tools
1378
1379       virt-p2v-make-kiwi(1) can be used to build the virt-p2v ISO based on
1380       SLES and openSUSE, using the kiwi utility (Cédric Bosdonnat).
1381
1382       New features in existing tools
1383
1384       virt-resize will now preserve the GPT GUID.  This was required for
1385       Windows Server 2012 R2, where the bootloader would become confused if
1386       the GUID changed (Maxim Perevedentsev).
1387
1388       virt-resize will use sparse copying for (old MBR-style) extended
1389       partitions.  This makes resizing of guests that use extended partitions
1390       much faster (Maxim Perevedentsev).
1391
1392       virt-p2v kernel command line options can now be used to set defaults
1393       for GUI configuration.
1394
1395       The virt-p2v debugging options have been completely removed,
1396       simplifying the interface and documentation.  Debugging information is
1397       now captured fully automatically.
1398
1399       virt-p2v-make-disk lets you specify an --arch option, allowing you to
1400       build a 32 bit virt-p2v, for compatibility with older systems.
1401
1402       virt-p2v-make-disk no longer requires that you specify an "os-version"
1403       for the virt-p2v disk.  If omitted it will try to choose a suitable
1404       "os-version" depending on your host system.
1405
1406       virt-p2v-make-disk and virt-p2v-make-kickstart both gain a new
1407       --install option that allows you to add arbitrary extra packages to the
1408       virt-p2v ISO, for customization, additional debugging tools and so on.
1409
1410       virt-v2v will now uninstall Parallels Tools (or the equivalent
1411       Virtuozzo Tools) from Linux guests.  Also stop the Windows drivers from
1412       loading at boot.  (Roman Kagan and Pavel Butsykin)
1413
1414       virt-v2v --in-place mode has been enhanced to allow the caller to
1415       choose whether or not to install certain virtio drivers in the guest
1416       (Roman Kagan).
1417
1418       virt-v2v conversion of Windows guests was substantially rewritten and
1419       simplified (Roman Kagan).
1420
1421       virt-v2v --in-place mode now supports installing virtio-scsi drivers in
1422       guests (Roman Kagan).
1423
1424       virt-v2v can now convert SUSE guests and SUSE guests using UEFI (Cédric
1425       Bosdonnat and Jim Fehlig).
1426
1427       virt-v2v can now convert guests to Glance that have multiple disks.
1428       Previously it would fail on such guests.
1429
1430       The virt-v2v --no-trim and --vmtype options are now no-ops.  They will
1431       print a warning but are otherwise ignored.  virt-v2v can now generate
1432       the OVF vmtype correctly without user intervention.
1433
1434       virt-v2v has now been tested against SUSE Xen as a source hypervisor
1435       (Cédric Bosdonnat).
1436
1437       virt-v2v adds support for SUSE VMDP drivers (Cédric Bosdonnat).
1438
1439       virt-v2v can convert OVA files containing subfolders, as produced by
1440       SUSE Studio (Cédric Bosdonnat).
1441
1442       virt-v2v sets the OVF "<Origin>" element correctly.  oVirt has been
1443       extended to support more source hypervisors (Shahar Havivi).
1444
1445       virt-v2v now supports Windows Server 2016 (Tomáš Golembiovský).
1446
1447       The virt-builder --list option can now be used to show all templates or
1448       a single template (Pino Toscano).
1449
1450       All OCaml-based tools now use getopt_long(3) for option parsing, and
1451       --help output has been improved (Pino Toscano).
1452
1453       virt-builder and virt-customize --selinux-relabel option can now fully
1454       relabel the guest filesystem at build time, without requiring a lengthy
1455       autorelabel at first boot.
1456
1457       virt-customize --delete now accepts globs.
1458
1459       New virt-customize --uninstall option lets you uninstall packages.
1460
1461       virt-customize can now use "pvvxsvc" as an alternative to "rhsrvany"
1462       for running firstboot scripts in Windows guests (Cédric Bosdonnat).
1463
1464       virt-customize now uses the strongest hashing scheme for passwords on
1465       Arch and Void Linux (Pino Toscano).
1466
1467       virt-customize --install now works correctly on Arch (Pino Toscano).
1468
1469       virt-inspector has new options --no-applications and --no-icon to
1470       prevent the list of applications and icon from being included in the
1471       XML output (Pino Toscano).
1472
1473       New virt-sysprep --network option has been added, allowing you to
1474       actually use the --install etc options which were present in virt-
1475       sysprep before but did not usually work.  Note that the network is
1476       still disabled by default.
1477
1478       virt-sysprep "fs-uuids" operation no longer fails on btrfs guests
1479       (Maxim Perevedentsev).
1480
1481       virt-dib can output Docker images (Pino Toscano).
1482
1483       virt-dib has a new --drive-format option to allow the user to specify
1484       the format of the helper drive (Pino Toscano).
1485
1486       All OCaml virt tools now have a --colors/--colours option which enables
1487       coloured output (using ANSI escape sequences) even if the output is not
1488       a tty.  The default is to check if the output is a tty and disable
1489       coloured output if not.  This allows coloured output to be consumed by
1490       other tools.
1491
1492       Language bindings
1493
1494       PHP test coverage has been enhanced (Pino Toscano).
1495
1496       PHP 7 is now supported (Pino Toscano).
1497
1498       Python bindings are now compliant with PEP 8 (Pino Toscano).
1499
1500       A Python pip package is available in
1501       http://libguestfs.org/download/python/
1502
1503       The Ruby bindings now print the full exception if one is thrown by the
1504       event callback.  Note this is still incorrect behaviour as event
1505       callbacks should not throw exceptions, but it aids debugging.
1506
1507       All OCaml libraries and programs are now compiled with -safe-string, if
1508       supported by the OCaml compiler.
1509
1510       Inspection
1511
1512       Alpine Linux using busybox can now be inspected.  Also the APK package
1513       manager is supported in virt-customize (Pino Toscano).
1514
1515       We now handle inspection of Mageia 4 (Pino Toscano).
1516
1517       Void Linux and the Void Linux xbps package manager are fully supported
1518       (Pino Toscano).
1519
1520       Parsing of CoreOS version information has been enhanced (Pino Toscano).
1521
1522       It is now possible to get an icon from ALT Linux (Pino Toscano).
1523
1524       PLD Linux versions < 3 are now recognized (Pino Toscano).
1525
1526       Windows drive letters are now returned for guests using GPT partitions
1527       (Dawid Zamirski).
1528
1529       We can now correctly inspect Unix guests that do not have an /etc/fstab
1530       file (Pino Toscano).
1531
1532       Added another source for the Ubuntu icon which doesn't rely on GNOME
1533       having been installed in the guest.
1534
1535       We can now get an icon for Windows 7 64 bit guests.
1536
1537       Libosinfo integration was rewritten to deal with the new database
1538       format used by osinfo (Pino Toscano).
1539
1540       Documentation
1541
1542       New manual page guestfs-building(1) describes how to build libguestfs
1543       from source.
1544
1545       The man pages, tools and tool --help output is now automatically
1546       checked to ensure that all tool options are properly documented, that
1547       warning sections are included where necessary, and that every page has
1548       a description section.
1549
1550       The guestfs-testing(1) man page has been refreshed and based on a newer
1551       libguestfs.
1552
1553       Architectures and platforms
1554
1555       virt-customize now works on POWER7 and POWER8 platforms, both big
1556       endian and little endian (Xianghua Chen and Hu Zhang).
1557
1558   Security
1559       See also guestfs-security(1).
1560
1561       CVE-2015-8869
1562
1563       https://bugzilla.redhat.com/CVE-2015-8869
1564
1565       This vulnerability in OCaml might affect virt tools written in the
1566       OCaml programming language.  It affects only 64 bit platforms.  Because
1567       this bug affects code generation it is difficult to predict which
1568       precise software could be affected, and therefore our recommendation is
1569       that you recompile libguestfs using a version of the OCaml compiler
1570       where this bug has been fixed (or ask your Linux distro to do the
1571       same).
1572
1573       virt-customize ownership of .ssh, .ssh/authorized_keys
1574
1575       https://bugzilla.redhat.com/1337561
1576
1577       Previously when virt-customize injected an SSH key into a guest, when
1578       it created the ~/.ssh and ~/.ssh/authorized_keys directory and file (in
1579       case they were missing) it created them with owner and group
1580       "root.root".  This has been fixed so the correct user is used.  This is
1581       not thought to have been exploitable.
1582
1583       Windows "%systemroot%"
1584
1585       The inspection code has been made more robust against guests which
1586       might use very long "%systemroot%" (derived from the guest-controlled
1587       Windows Registry).  This is not thought to have been exploitable.
1588
1589       Virtio-rng is now available in the appliance
1590
1591       virtio-rng (the virtual Random Number Generator device) is now passed
1592       to the appliance, which should improve the quality random numbers
1593       generated for GUIDs and cryptographic key generation.
1594
1595   API
1596       New APIs
1597
1598       "btrfs_filesystem_show"
1599           List all devices where a btrfs filesystem is spanned (Pino
1600           Toscano).
1601
1602       "download_blocks"
1603       "download_inode"
1604       "filesystem_walk"
1605           Download filesystem data blocks from a given partition.  Download
1606           arbitrary files by inode number.  Retrieve all files from a
1607           filesystem including deleted files.
1608
1609           Note these require optional dependency The Sleuth Kit.  (Matteo
1610           Cafasso)
1611
1612       "get_sockdir"
1613           Read the path where temporary sockets are stored (Pino Toscano).
1614
1615       "mountable_device"
1616       "mountable_subvolume"
1617           Split a Mountable into device name and subvolume (Cédric
1618           Bosdonnat).
1619
1620       "ntfscat_i"
1621           Download NTFS file by inode number (Matteo Cafasso).
1622
1623       "part_expand_gpt"
1624           Allow in-place expanding of GPT partitions by moving the second
1625           (backup) partition table to the end of the disk (Maxim
1626           Perevedentsev).
1627
1628       "part_get_disk_guid"
1629       "part_set_disk_guid"
1630       "part_set_disk_guid_random"
1631           Get and set the GPT disk GUID, or set it to a fresh random value
1632           (Maxim Perevedentsev).
1633
1634       "selinux_relabel"
1635           SELinux-relabel part or all of the guest filesystem.
1636
1637       Other API changes
1638
1639       "guestfs_set_selinux", "guestfs_get_selinux", "guestfs_setcon",
1640       "guestfs_getcon" and "guestfs_llz" have been deprecated.  Use the new
1641       API "guestfs_selinux_relabel" to relabel filesystems.  Use
1642       "guestfs_lgetxattrs" to list the "security.selinux" extended attributes
1643       of existing files.
1644
1645       "guestfs_vfs_minimum_size" can now be used on dirty filesystems (Maxim
1646       Perevedentsev).
1647
1648       "guestfs_ll" now works on paths which contain absolute symlinks (Pino
1649       Toscano).
1650
1651       "guestfs_glob_expand" now has an optional "directoryslash" boolean
1652       parameter which controls whether trailing slashes are returned for
1653       directory names (Pino Toscano).
1654
1655       "guestfs_lvs" will no longer return LVs which have the "activationskip"
1656       flag set.  The reason is that such LVs have no "/dev/VG/LV" device node
1657       and so code which read the list of LVs and then probed the devices
1658       themselves would immediately fail.  You can use "guestfs_lvs_full" if
1659       you want to read all LVs.  (Pino Toscano).
1660
1661       "guestfs_list_disk_labels" now no longer fails if no disks with labels
1662       were added.  Instead it now returns an empty list (Pino Toscano).
1663
1664       "guestfs_is_lv" no longer fails if passed a btrfs subvolume, it returns
1665       false instead (Maxim Perevedentsev).
1666
1667   Build changes
1668       qemu ≥ 1.3.0 is required.
1669
1670       yajl (a JSON parsing library) is required to build libguestfs.
1671
1672       You can now build with GCC 6.
1673
1674       "make check-valgrind" now has substantially better coverage.
1675
1676       "make check-slow" now works again.
1677
1678       Use "make -C appliance clean-supermin-appliance" to clean the supermin
1679       appliance (it will be rebuilt on next "make").
1680
1681       There are a variety of new rules for running virt-p2v from the source
1682       directory: "make -C p2v run-virt-p2v-directly" | "run-virt-p2v-in-a-vm"
1683       | "run-virt-p2v-non-gui-conversion".  These are documented further in
1684       guestfs-hacking(1).
1685
1686       virt-p2v may be built using either Gtk 2 or Gtk 3.  To force a
1687       particular version of Gtk to be used, "./configure --with-gtk=2|3"
1688
1689       The "./configure" options are now mostly documented in
1690       guestfs-building(1).
1691
1692   Internals
1693       In git, versions are now tagged with "v1.XX.YY" (previously they were
1694       tagged with "1.XX.YY").  Using the "v-" prefix is more common in git
1695       repositories.
1696
1697       When using the libvirt backend, we now wait for qemu to exit gracefully
1698       instead of killing it after 15 seconds.  This helps when writing to
1699       slow devices (especially cheap USB keys).
1700
1701       Error messages from libvirt now include the "err->int1" field which
1702       usually contains the "errno".
1703
1704       On ARM, all DTB (device tree) code has been removed.  qemu creates the
1705       right device tree on the fly, we do not need to specify one.
1706
1707       The C API tests now use larger test disks, allowing BTRFS to be tested
1708       properly (Pino Toscano).
1709
1710       The tests should now work on a pure Python 3 host (Pino Toscano).
1711
1712       In C bindings, internal functions are now (mostly) consistently named
1713       "guestfs_int_*" whereas previously there was no consistent scheme.
1714
1715       The old "safe_malloc" etc functions are now no longer exported by the
1716       library, nor used in language bindings.
1717
1718       Setting TMPDIR to a path longer than ~ 100 characters will no longer
1719       cause libguestfs to fail silently and randomly when creating Unix
1720       domain sockets (Pino Toscano).
1721
1722       The "COMPILE_REGEXP" macro can now be used in the daemon.
1723
1724       When tracing, results containing structs are now printed in full (Pino
1725       Toscano).
1726
1727       The Perl "Sys::Guestfs" module now no longer embeds an incrementing API
1728       "version number".  This module is now always at phony version "1.0".
1729       To find the real version of libguestfs from Perl you must call
1730       "$g->version".
1731
1732       All code is compiled with "-Wstack-usage=10000" and multiple changes
1733       have been made to remove stack allocation of large strings and buffers.
1734
1735       The error(3) function is now used everywhere, replacing most previous
1736       uses of perror(3) + exit(3), and fprintf(3) + exit.
1737
1738       In C code, "/**" comments are turned into documentation which is
1739       automatically added to the guestfs-hacking(1) manual page.
1740
1741       A safe "getumask" function has been added.  For recent Linux kernels
1742       this uses the newly added "Umask" field in /proc/self/status.  For
1743       older Linux and other Unix, this uses a thread-safe technique involving
1744       fork(2) (thanks: Josh Stone, Jiri Jaburek, Eric Blake).
1745
1746       Safe posix_fadvise(2) wrappers have been added, and more hints have
1747       been added to the code which may make a minor difference to
1748       performance.
1749
1750       A safe wrapper around waitpid(2) has been added which handles "INTR"
1751       properly.
1752
1753       "podwrapper.pl" (used to generate the manual pages) now stops if any
1754       POD error is found.  A new script called "podcheck.pl" does cross-
1755       checking of --help output, tool options and manual pages.
1756
1757       All version numbers in the library (eg. versions of qemu, versions of
1758       libvirt, versions of guest operating systems) are unified in a single
1759       file src/version.c (Pino Toscano).
1760
1761       On Windows guests, virt-customize will use the vendor-neutral path
1762       "C:\Program Files\Guestfs\Firstboot" to store firstboot scripts.
1763       Previously it used "C:\Program Files\Red Hat\Firstboot".  This change
1764       should be invisible to the scripts themselves.  (Cédric Bosdonnat)
1765
1766       On Linux guests, the firstboot services generated by virt-builder
1767       --firstboot etc have been renamed to "guestfs-firstboot" (Pino
1768       Toscano).
1769
1770       There is now a common "debug" function used by all OCaml tools,
1771       replacing previous code which did "if verbose () then printf ...".
1772
1773       virt-p2v copies files it needs over to the virt-v2v conversion server
1774       using scp(1), instead of trying to send them via the shell session.
1775       This should improve reliability and should be a completely transparent
1776       to end users.
1777
1778       All code in mllib is now built into a single "mllib.cma" or
1779       "mllib.cmxa" library.  All code in customize is now built into a single
1780       "customize.cma" or "customize.cmxa" library.  This simplifies the build
1781       of the OCaml tools.
1782
1783       lvmetad(8) is now used in the appliance when available (Pino Toscano).
1784
1785       "Silent rules" are used for OCaml, Java, Erlang and POD.  Use "make
1786       V=1" to see the full command lines again (Pino Toscano).
1787
1788   Bugs fixed
1789       https://bugzilla.redhat.com/1364347
1790           virt-sparsify --in-place failed with UEFI system
1791
1792       https://bugzilla.redhat.com/1362357
1793           run_command runs exit handlers when execve fails (e.g. due to
1794           missing executable)
1795
1796       https://bugzilla.redhat.com/1362354
1797           virt-dib failed to create image using DIB_YUM_REPO_CONF
1798
1799       https://bugzilla.redhat.com/1359652
1800           Fail to inspect Windows ISO file
1801
1802       https://bugzilla.redhat.com/1358142
1803           Some info will show when convert guest to libvirt by virt-v2v with
1804           parameter --quiet
1805
1806       https://bugzilla.redhat.com/1354335
1807           overlay of disk images does not specify the format of the backing
1808           file
1809
1810       https://bugzilla.redhat.com/1352761
1811           Virt-manager can't show OS icons of win7/win8/ubuntu guest.
1812
1813       https://bugzilla.redhat.com/1350363
1814           Improve error info "remote server timeout unexpectedly waiting for
1815           password prompt" when connect to a bogus server at p2v client
1816
1817       https://bugzilla.redhat.com/1348900
1818           virt-p2v should update error prompt when 'Test connection' with a
1819           non-existing user in conversion server
1820
1821       https://bugzilla.redhat.com/1345813
1822           virt-sysprep --install always failed to install the packages
1823           specified
1824
1825       https://bugzilla.redhat.com/1345809
1826           virt-customize --truncate-recursive should give an error message
1827           when specifying a no-existing path
1828
1829       https://bugzilla.redhat.com/1343423
1830           [RFE]Should give a better description about 'curl error 22' when
1831           failed using ssh identity http url at p2v client
1832
1833       https://bugzilla.redhat.com/1343414
1834           Failed SSH to conversion server by ssh identity http url at p2v
1835           client
1836
1837       https://bugzilla.redhat.com/1343375
1838           [RFE] uninstall packages inside the VM
1839
1840       https://bugzilla.redhat.com/1342447
1841           Ifconfig command is not supported on p2v client
1842
1843       https://bugzilla.redhat.com/1342398
1844           Convert a guest from RHEL by virt-v2v but its origin info shows
1845           RHEV at rhevm
1846
1847       https://bugzilla.redhat.com/1342337
1848           Should remind a warning about disk image has a partition when using
1849           virt-p2v-make-disk
1850
1851       https://bugzilla.redhat.com/1341984
1852           virt-get-kernel prompts an 'invalid value' error when using
1853           --format auto
1854
1855       https://bugzilla.redhat.com/1341564
1856           virt-p2v spinner should be hidden when it stops spinning
1857
1858       https://bugzilla.redhat.com/1340809
1859           Testing connection timeout when input regular user of conversion
1860           server with checked "use sudo......"button
1861
1862       https://bugzilla.redhat.com/1340464
1863           [RFE] Suggestion give user a reminder for "Cancel conversion"
1864           button
1865
1866       https://bugzilla.redhat.com/1340407
1867           Multiple network ports will not be aligned at p2v client
1868
1869       https://bugzilla.redhat.com/1338083
1870           Update UEFI whitelist for official fedora packages
1871
1872       https://bugzilla.redhat.com/1337561
1873           virt-customize --ssh-inject not applying correct file permission
1874
1875       https://bugzilla.redhat.com/1335671
1876           extra quotes around UUID confuses findfs in RHEL (but not in
1877           Fedora)
1878
1879       https://bugzilla.redhat.com/1332025
1880           Inspection does not parse /etc/redhat-release containing "Derived
1881           from Red Hat Enterprise Linux 7.1 (Source)"
1882
1883       https://bugzilla.redhat.com/1327488
1884           RFE: Allow p2v kernel options without p2v.server to set defaults
1885
1886       https://bugzilla.redhat.com/1325825
1887           virt-v2v should prevent using multiple '-b' and '-n' option appears
1888           on the command line
1889
1890       https://bugzilla.redhat.com/1321620
1891           libguestfs: error: could not parse integer in version number: 7"
1892
1893       https://bugzilla.redhat.com/1321338
1894           [1.33.16] Compilation Error: Unbound value List.sort_uniq in v2v.ml
1895           line 988, characters 10-24:
1896
1897       https://bugzilla.redhat.com/1317843
1898           `virt-builder --update` fails with: "dnf -y --best upgrade: command
1899           exited with an error"
1900
1901       https://bugzilla.redhat.com/1316479
1902           v2v cmd cannot exit and "block I/O error in device 'appliance': No
1903           space left on device (28)" is printed when specified "-v -x"
1904
1905       https://bugzilla.redhat.com/1316041
1906           virt-rescue fails, but missing error message
1907
1908       https://bugzilla.redhat.com/1314244
1909           RFE: virt-p2v log window should process colour escapes and
1910           backspaces
1911
1912       https://bugzilla.redhat.com/1312254
1913           virt-v2v -o libvirt doesn't preserve or use correct <graphics
1914           type="vnc|spice">
1915
1916       https://bugzilla.redhat.com/1309706
1917           error: internal error: Invalid floppy device name: hdb
1918
1919       https://bugzilla.redhat.com/1309619
1920           Wrong warning info "use standard VGA" shows when converting windows
1921           > 7 by virt-v2v
1922
1923       https://bugzilla.redhat.com/1309580
1924           OS name of win8.1 x64 guest shows incorrect in rhevm3.6 general
1925           info
1926
1927       https://bugzilla.redhat.com/1308769
1928           virt-v2v does not copy additional disks to Glance
1929
1930       https://bugzilla.redhat.com/1306666
1931           Failure when disk contains an LV with activationskip=y
1932
1933       https://bugzilla.redhat.com/1296606
1934           virt-v2v doesn't remove VirtualBox additions correctly because of
1935           file quoting
1936
1937       https://bugzilla.redhat.com/1293527
1938           There should be a reminder to avoid user to edit a guest image by
1939           multiple tools at the same time in guestfish man page
1940
1941       https://bugzilla.redhat.com/1293276
1942           guestfish can not ll a symbolic link dir or edit a file in it
1943
1944       https://bugzilla.redhat.com/1278878
1945           guestfish should be able to handle LVM thin layouts
1946
1947       https://bugzilla.redhat.com/1264835
1948           ppc64le: virt-customize --install fail to detect the guest arch
1949
1950       https://bugzilla.redhat.com/1264332
1951           Test that trimming in virt-v2v doesn't regress
1952
1953       https://bugzilla.redhat.com/1232192
1954           Virt-v2v gives an error on a blank disk: part_get_parttype: unknown
1955           signature, of the output: BYT;
1956
1957       https://bugzilla.redhat.com/1229386
1958           virt-p2v in non-GUI mode doesn't show any conversion progress or
1959           status
1960
1961       https://bugzilla.redhat.com/1227599
1962           P2V invalid password prints unexpected end of file waiting for
1963           command prompt.
1964
1965       https://bugzilla.redhat.com/1224795
1966           On Ubuntu, virt-builder --install and --update cannot use the
1967           network
1968
1969       https://bugzilla.redhat.com/1213324
1970           virt-v2v: warning: unknown guest operating system: windows windows
1971           6.3 when converting win8,win8.1,win2012,win2012R2,win10 to rhev
1972
1973       https://bugzilla.redhat.com/1203898
1974           Support inspecting docker images without /etc/fstab
1975
1976       https://bugzilla.redhat.com/1186935
1977           libguestfs cannot inspect recent Fedora / RHEL >= 7 when /usr is a
1978           separate partition
1979
1980       https://bugzilla.redhat.com/1167916
1981           P2V: invalid conversion server prints unexpected end of file
1982           waiting for password prompt.
1983
1984       https://bugzilla.redhat.com/1152825
1985           virt-rescue --selinux can not work well, when enable selinux in the
1986           command line the value of 'getenforce' is still Disabled in virt-
1987           rescue appliance
1988
1989       https://bugzilla.redhat.com/1150298
1990           ARM 32 bit on Ubuntu: warning: cast to pointer from integer of
1991           different size [-Wint-to-pointer-cast]
1992
1993       https://bugzilla.redhat.com/1089100
1994           NetworkManager avc unlink denied for resolv.conf after using
1995           --selinux-relabel
1996
1997       https://bugzilla.redhat.com/983969
1998           RFE: virt-sysprep should be SELinux-aware
1999
2000       https://bugzilla.redhat.com/855058
2001           RFE: virt-p2v: display more information about storage devices
2002
2003       https://bugzilla.redhat.com/554829
2004           SELinux handling could be done better.
2005

RELEASE NOTES FOR LIBGUESTFS 1.32

2007       These release notes only cover the differences from the previous
2008       stable/dev branch split (1.30.0).  For detailed changelogs, please see
2009       the git repository, or the ChangeLog file distributed in the tarball.
2010
2011   New features
2012       New tools
2013
2014       The new virt-v2v-copy-to-local(1) tool is an ancillary tool for
2015       virt-v2v(1) allowing you to convert source guests that virt-v2v is
2016       unable to access directly.
2017
2018       New features in existing tools
2019
2020       Virt-customize knows how to write a random seed to CirrOS (Pino
2021       Toscano).
2022
2023       On Fedora, virt-customize runs dnf(8) with the --best flag, ensuring it
2024       always updates to the latest available packages.
2025
2026       Virt-builder now provides 32 bit Fedora templates.
2027
2028       Virt-builder and virt-customize --install option now works on 32 bit
2029       Fedora guests.  Previously it would try to install 64 bit packages (Jan
2030       Sedlák).
2031
2032       Virt-builder can now fetch cloud images using Simple Streams v1.0
2033       metadata (Pino Toscano).
2034
2035       Virt-builder can now fetch openSUSE cloud images out of the box (Cédric
2036       Bosdonnat).
2037
2038       Virt-customize will now use stronger (SHA-512) encrypted passwords by
2039       default on openSUSE ≥ 11 (Pino Toscano).
2040
2041       Virt-builder will now correctly handle output filenames containing
2042       colon characters (":"), and will create temporary files in the
2043       libguestfs cache directory instead of defaulting to /tmp (Pino
2044       Toscano).
2045
2046       Virt-resize has a new --unknown-filesystems option to control what to
2047       do when asked to resize a filesystem that libguestfs doesn't know how
2048       to resize.
2049
2050       Virt-v2v now has an --in-place flag/mode, allowing in-place conversion
2051       of guests (Roman Kagan).
2052
2053       Virt-v2v has a --compressed option for creating compressed qcow2 output
2054       files.
2055
2056       Virt-v2v can now correctly get the VMware datacenter path (dcPath) from
2057       libvirt, instead of having to calculate it using an algorithm that
2058       occasionally got the wrong answer (Matthias Bolte, Tingting Zheng).
2059
2060       Virt-v2v now processes RAM sizes correctly for 64 bit guests when
2061       running on a 32 bit host.
2062
2063       Language bindings
2064
2065       In Perl and Python programs, the "get_program_name" API now returns the
2066       true program name, instead of the incorrect string "perl" or "python".
2067
2068       The Python bindings can now be compiled against a different version of
2069       libguestfs, allowing the pip module to be built against any version of
2070       libguestfs (instead of requiring the pip module and libguestfs to have
2071       exactly the same version).
2072
2073       The quality of the Ruby rdoc (documentation) has been improved (Pino
2074       Toscano).
2075
2076       Perl scripts no longer hard-code the location of perl in the shebang
2077       line, but use env(1) to locate it instead (Pino Toscano).
2078
2079       In OCaml programs, the guestfs handle was incorrectly made into a
2080       global root, meaning it could never be garbage collected.  If you
2081       didn't call the "close" function explicitly, the handle would not be
2082       closed until the whole program exited.  This has now been fixed so
2083       handles will be garbage collected in the usual way.  This changes the
2084       API of the OCaml function "Guestfs.event_callback".  Note that non-C
2085       language bindings are not covered by the libguestfs API/ABI guarantee,
2086       although we try hard not to change them, but in this case it was
2087       essential in order to fix this very serious bug.
2088
2089       Inspection
2090
2091       Alpine Linux and the APK package manager, ALT Linux, Frugalware, and
2092       PLD Linux are now recognized (Pino Toscano).
2093
2094       If it exists, /etc/os-release will be preferred for inspecting Linux
2095       guests (Pino Toscano).
2096
2097       The correct kernel version is returned for Windows guests ≥ 10.
2098
2099       Documentation
2100
2101       The large guestfs(3) man page has been split into several separate man
2102       pages: guestfs-hacking(1) guestfs-internals(1) guestfs-security(1).  In
2103       the source tree, a new docs directory contains this documentation.
2104
2105       Architectures and platforms
2106
2107       Libguestfs now supports ARM 64 bit platforms with vGICv3.
2108
2109   Security
2110       See also guestfs-security(1).
2111
2112       "CVE-2015-5745"
2113           https://bugzilla.redhat.com/1251157
2114
2115           This is not a vulnerability in libguestfs, but because we always
2116           give a virtio-serial port to each guest (since that is how guest-
2117           host communication happens), an escalation from the appliance to
2118           the host qemu process is possible.  This could affect you if:
2119
2120           ·   your libguestfs program runs untrusted programs out of the
2121               guest (using "guestfs_sh" etc), or
2122
2123           ·   another exploit was found in (for example) kernel filesystem
2124               code that allowed a malformed filesystem to take over the
2125               appliance.
2126
2127           If you use sVirt to confine qemu, that would thwart some attacks.
2128
2129       Virt-customize permissions on .ssh, .ssh/authorized_keys
2130           https://bugzilla.redhat.com/1260778.
2131
2132           Previously when asked to inject an SSH key into a guest, virt-
2133           customize (hence virt-builder too) would create the .ssh directory
2134           and .ssh/authorized_keys file with too broad permissions, allowing
2135           other users to read.  They are now created as 0700 and 0600
2136           respectively, which is the same as the ssh-copy-id(1) utility.
2137
2138   API
2139       New APIs
2140
2141       "guestfs_get_identifier"
2142       "guestfs_set_identifier"
2143           Get/set a per-handle identifier.  The main effect of this is to
2144           change trace output from:
2145
2146            libguestfs: trace: foo
2147
2148           to:
2149
2150            libguestfs: trace: ID: foo
2151
2152           making it easier to follow traces in multi-threaded programs, or
2153           where a program uses multiple handles (especially virt-v2v).
2154
2155       "guestfs_vfs_minimum_size"
2156           Return the minimum size of a filesystem (when shrunk).  This
2157           supports ext2/3/4, XFS and btrfs, and can support other filesystem
2158           types in future (Maxim Perevedentsev).
2159
2160       Other API changes
2161
2162       "guestfs_disk_create": add "preallocation" = "off"/"metadata"/"full".
2163           For raw, this allows "off" as a synonym for "sparse" (making it
2164           consistent with qcow2).  For qcow2, this allows "sparse" as a
2165           synonym for "off".
2166
2167           It also adds "full", which corresponds to fully allocated, but uses
2168           posix_fallocate(3) for efficiency.
2169
2170       "guestfs_tar_in": new "xattrs", "selinux", "acl" parameters.
2171       "guestfs_tar_out": new "xattrs", "selinux", "acl" parameters.
2172           These extra parameters control whether extended attributes, SELinux
2173           contexts and/or POSIX ACLs are restored from / saved to tarballs.
2174
2175       "guestfs_add_drive"
2176           The existing "username" and "secret" parameters can be used to
2177           supply authentication for iSCSI (Pino Toscano).
2178
2179   Build changes
2180       The "./configure --enable-valgrind-daemon" option has been removed.
2181
2182       You can no longer build libguestfs on RHEL 5-era (c.2007) machines.
2183       See the "oldlinux" branch if you need (limited) RHEL 5 support.
2184
2185       Virt-p2v can now be built on RHEL 6-era (c.2010) Linux distros.
2186
2187       OCaml ≥ 3.11 (released in 2008) is now required to build from git.
2188
2189       Building the Perl bindings now requires "Module::Build" (instead of
2190       "ExtUtils::MakeMaker").
2191
2192       Builds should be faster (especially when incrementally rebuilding),
2193       because work was done to reduce build times.
2194
2195       Both OCaml and the OCaml findlib module are required if you need to run
2196       the generator at build time.  Previously the build would have failed if
2197       findlib was not installed.
2198
2199       "make check" tests now run in parallel (within each test directory).
2200
2201       "make install" no longer installs OCaml bindtests.* files incorrectly.
2202
2203       "make install" can now be run twice.  Previously it would fail on the
2204       second run.
2205
2206       "make clean" should now remove nearly every file that "make" creates.
2207
2208       A new "make installcheck" rule has been added, allowing the installed
2209       copy of libguestfs to be tested.
2210
2211   Internals
2212       Some effort was put into minimizing the size of the appliance, which
2213       reduces temporary disk space and time needed by libguestfs handles.
2214
2215       The appliance now passes the NIC name to dhcpd, fixing hangs when
2216       running the appliance on some distros (Cédric Bosdonnat).
2217
2218       OCaml "Guestfs.Errno" is now generated (Pino Toscano).
2219
2220       In OCaml tools, common code now handles --debug-gc, --verbose and other
2221       common options (Roman Kagan, Pino Toscano).
2222
2223       The virt-v2v test harness allows us to boot the test guests at fixed
2224       dates in the past, ensuring that Windows reactivation doesn't kick in.
2225
2226       There is a new internal API for reading/writing a subprocess via a pipe
2227       from library code.
2228
2229       Used "deheader" program to remove unused "#include" directives.
2230
2231       In OCaml tools, the "Char" and "String" modules now implicitly
2232       reference the "Common_utils.Char" and "Common_utils.String" modules
2233       (instead of the ones from stdlib).  The "Common_utils" modules contain
2234       a number of extra char/string utility functions, and also hide some
2235       unsafe functions in stdlib.
2236
2237       Many more virt-v2v tests will now be run even if you don't have
2238       rhsrvany and virtio-win installed (Roman Kagan).
2239
2240       The huge configure.ac file has been split into several smaller files
2241       called m4/guestfs_*.m4.
2242
2243       The old tests/data and tests/guests directories have been moved to
2244       test-data/.  This new top level directory carries all test data which
2245       is common, large and/or shared between multiple tests.
2246
2247       There is a new top level website/ directory containing the public
2248       http://libguestfs.org website (or most of it).
2249
2250       The fuzz testing of inspection (tests/fuzz) has been removed.
2251
2252       Virt-p2v now saves the source physical machine dmesg output into the
2253       conversion server debug directory, making it simpler to debug cases of
2254       missing drivers, firmware etc.
2255
2256   Bugs fixed
2257       https://bugzilla.redhat.com/1294956
2258           set-label returns wrong error message when set the ext3/ext4
2259           filesystem label
2260
2261       https://bugzilla.redhat.com/1288733
2262           Add a Fedora 23 32-bit base image for virt-builder
2263
2264       https://bugzilla.redhat.com/1288201
2265           virt-builder writes temporary files to /tmp
2266
2267       https://bugzilla.redhat.com/1285847
2268           virt-resize does not copy logical partitions
2269
2270       https://bugzilla.redhat.com/1281578
2271           virt-inspector returns version 6.3 for win10 images (should return
2272           10.0)
2273
2274       https://bugzilla.redhat.com/1281577
2275           virt-inspector --xpath segfault on attribute get
2276
2277       https://bugzilla.redhat.com/1280029
2278           libguestfs can run commands with stdin not open (or worse still,
2279           connected to arbitrary guest-chosen random devices)
2280
2281       https://bugzilla.redhat.com/1279273
2282           About compression option for qcow2
2283
2284       https://bugzilla.redhat.com/1278878
2285           guestfish should be able to handle LVM thin layouts
2286
2287       https://bugzilla.redhat.com/1278382
2288           DNF python programming error when run from virt-builder
2289
2290       https://bugzilla.redhat.com/1278371
2291           inspection returns arch="unknown" for Windows guest if file command
2292           is not installed
2293
2294       https://bugzilla.redhat.com/1277274
2295           Document permissions needed for non-admin users to use virt-v2v
2296
2297       https://bugzilla.redhat.com/1277122
2298           RFE: virt-sparsify: make '--in-place' sparsification safe to abort
2299           (gracefully or ungracefully)
2300
2301       https://bugzilla.redhat.com/1277074
2302           Virt-p2v client shouldn't present the vdsm option because it's not
2303           usable
2304
2305       https://bugzilla.redhat.com/1276540
2306           virt-v2v fails to convert Windows raw image: error "device name is
2307           not a partition"
2308
2309       https://bugzilla.redhat.com/1275806
2310           virt-builder: error: [file] is not a regular file in the guest
2311
2312       https://bugzilla.redhat.com/1270011
2313           Simplestreams test fails: virt-builder: error: the value for the
2314           key 'size' is not an integer
2315
2316       https://bugzilla.redhat.com/1267032
2317           guestfish copy-in command behaves oddly/unexpectedly with wildcards
2318
2319       https://bugzilla.redhat.com/1262983
2320           python: Cannot compile pip module if installed libguestfs != pip
2321           guestfs version
2322
2323       https://bugzilla.redhat.com/1262127
2324           Better diagnostic message when virbr0 doesn't exist
2325
2326       https://bugzilla.redhat.com/1261436
2327           No warning shows when convert a win7 guest with AVG AntiVirus
2328           installed
2329
2330       https://bugzilla.redhat.com/1260778
2331           virt-builder --ssh-inject doesn't set proper permissions on created
2332           files
2333
2334       https://bugzilla.redhat.com/1260689
2335           RFE: V2V to check and warn user to disable group policy and anti
2336           virus on Windows guests
2337
2338       https://bugzilla.redhat.com/1260590
2339           Wrong graphics protocal and video type set for guest after convert
2340           to rhev 3.6 by virt-v2v
2341
2342       https://bugzilla.redhat.com/1258342
2343           extra slashes in vcenter URL confuses virt-v2v
2344
2345       https://bugzilla.redhat.com/1257895
2346           [RHEV][V2V] virt-v2v ignores NIC if interface source/@network or
2347           source/@bridge is an empty string
2348
2349       https://bugzilla.redhat.com/1256405
2350           virt-builder created Fedora 22 32bit disk image cannot be updated
2351
2352       https://bugzilla.redhat.com/1256222
2353           virt-p2v no GUI mode:error opening control connection to
2354           $ip:22:unexpected …rompt
2355
2356       https://bugzilla.redhat.com/1251909
2357           Option -oa preallocated -of qcow2 of virt-v2v didn't work
2358           efficiently
2359
2360       https://bugzilla.redhat.com/1250715
2361           v2v: spaces need to be escaped as %20 in paths
2362
2363       https://bugzilla.redhat.com/1248678
2364           Close all incoming ports on virt-p2v ISO
2365
2366       https://bugzilla.redhat.com/1246882
2367           man virt-customize shows synopsis twice
2368
2369       https://bugzilla.redhat.com/1242853
2370           mount-loop failed to setup loop device: No such file or directory
2371
2372       https://bugzilla.redhat.com/1237136
2373           BUG: unable to handle kernel NULL pointer dereference at <addr> in
2374           function __blkg_lookup
2375
2376       https://bugzilla.redhat.com/1230412
2377           virt-v2v should ignore bogus kernel entries in grub config
2378
2379       https://bugzilla.redhat.com/1229119
2380           Unrelated info in fstab makes virt-v2v fail with unclear error info
2381
2382       https://bugzilla.redhat.com/1227609
2383           virt-p2v: Using "Back" button causes output list to be repopulated
2384           multiple times
2385
2386       https://bugzilla.redhat.com/1225789
2387           Wrong video driver is installed for rhel5.11 guest after conversion
2388           to libvirt
2389
2390       https://bugzilla.redhat.com/1204131
2391           RFE: virt-builder creates qcow v3 images, add build option for qcow
2392           v2
2393
2394       https://bugzilla.redhat.com/1176801
2395           File /etc/sysconfig/kernel isn't updated when convert XenPV guest
2396           with regular kernel installed
2397
2398       https://bugzilla.redhat.com/1174551
2399           "lstatnslist" and "lstatlist" don't give an error if the API is
2400           used wrongly
2401
2402       https://bugzilla.redhat.com/1168223
2403           koji spin-livecd cannot build a working live CD
2404
2405       https://bugzilla.redhat.com/1165785
2406           mount-loop command fails: mount failed: Unknown error -1
2407
2408       https://bugzilla.redhat.com/1164708
2409           set-label can only set <=127 bytes for btrfs and <=126 bytes for
2410           ntfs filesystem which not meet the help message. Also for ntfs it
2411           should give a warning message when the length >128 bytes
2412
2413       https://bugzilla.redhat.com/1020216
2414           libvirt fails to shut down domain: could not destroy libvirt
2415           domain: Requested operation is not valid: domain is not running
2416
2417       https://bugzilla.redhat.com/1011907
2418           mount-loop failed to setup loop device: No such file or directory
2419

RELEASE NOTES FOR LIBGUESTFS 1.30

2421       These release notes only cover the differences from the previous
2422       stable/dev branch split (1.28.0).  For detailed changelogs, please see
2423       the git repository, or the ChangeLog file distributed in the tarball.
2424
2425   New features
2426       New tools
2427
2428       virt-dib(1) is a secure and safe alternative to the OpenStack
2429       "diskimage-builder" tool.  It is compatible with diskimage-builder
2430       elements.  (Pino Toscano)
2431
2432       virt-get-kernel(1) extracts the kernel and ramdisk from a disk image.
2433       Previously this functionality was part of virt-builder(1), but the new
2434       tool is more featureful.  (Pino Toscano)
2435
2436       New features in existing tools
2437
2438       virt-v2v(1) -i ova mode can now read a wider range of OVA files, and
2439       also unpacked files (directories).
2440
2441       virt-v2v now securely passes options to curl, so passwords, cookies and
2442       so on cannot be seen by users with shell access on the same machine.
2443
2444       virt-v2v has a new --password-file option to allow you to securely pass
2445       in a password, and to avoid an interactive prompt.
2446
2447       virt-v2v disables Windows autoreboot, making debugging conversion
2448       failures on Windows easier.
2449
2450       virt-v2v now comes with an extensive external test suite.  See
2451       virt-v2v-test-harness(1).
2452
2453       virt-v2v allows virtio drivers to come from any location (Roman Kagan),
2454       and drivers can be read directly from the virtio ISO.
2455
2456       virt-v2v supports conversion of Windows ≥ 8.  Note this is
2457       experimental, and possibly broken.  Use with caution.
2458
2459       virt-v2v can now convert UEFI guests.
2460
2461       virt-p2v(1) adds a network configuration dialog.
2462
2463       virt-p2v now has "p2v.pre", "p2v.post" and "p2v.fail" triggers,
2464       allowing arbitrary scripts for preparing the host for conversion and
2465       tidying up post-conversion.
2466
2467       virt-p2v now uses the more advanced metacity window manager (instead of
2468       matchbox).
2469
2470       virt-sysprep(1) will remove "/var/spool/mail/username" for non-root
2471       accounts (Hu Tao).
2472
2473       virt-customize(1), virt-builder(1) and virt-sysprep have the following
2474       new options:
2475
2476       --commands-from-file
2477           allow long lists of commands to be read from a file instead of from
2478           the command line (Pino Toscano)
2479
2480       --copy
2481           copy files inside the guest (Maros Zatko)
2482
2483       --copy-in
2484           copy host files recursively into the guest (Pino Toscano)
2485
2486       --move
2487           move files inside the guest (Maros Zatko)
2488
2489       --ssh-inject
2490           inject SSH keys into a guest (Pino Toscano)
2491
2492       --sm-attach
2493       --sm-credentials
2494       --sm-register
2495       --sm-remove
2496       --sm-unregister
2497           register and unregister a guest from subscription-manager (Pino
2498           Toscano)
2499
2500       --touch
2501           touch a file in the guest (Pino Toscano)
2502
2503       --truncate
2504       --truncate-recursive
2505           truncate files (Maros Zatko)
2506
2507       Improvements to virt-customize firstboot support.  In particular,
2508       Windows firstboot should work as well as Linux (Roman Kagan).
2509
2510       virt-df(1) can now use PolicyKit, SASL and other authentication methods
2511       when getting the list of domains from libvirt.
2512
2513       Improvements to guestfish bash completion (Pino Toscano).
2514
2515       Bash completion now completes short options as well as long options
2516       (Pino Toscano).
2517
2518       guestfish(1) now displays a command synopsis if the number of
2519       parameters given to a command is wrong (Hu Tao).
2520
2521       virt-builder now supports Red Hat Enterprise Linux versions back to
2522       RHEL 3.
2523
2524       virt-builder supports SUSE guests using zypper (Cédric Bosdonnat).
2525
2526       Language bindings
2527
2528       The Java bindings now include validated Javadoc, and other improvements
2529       (Pino Toscano).
2530
2531       Multiple fixes and improvements to the PHP bindings (Pino Toscano).
2532
2533       Inspection
2534
2535       Inspection can now get icons from RHEL 7 and CentOS 7.
2536
2537       /etc/favicon.png is now allowed to be a symbolic link.
2538
2539       For RPM-based guests, inspection now returns RPM Epoch fields.
2540
2541       Debian packages now have separate Epoch and Version fields (Nikos
2542       Skalkotos).
2543
2544       OpenBSD detection added, FreeBSD and NetBSD added as separate
2545       "distros", and other BSD inspection improvements and bug fixes (Nikos
2546       Skalkotos).
2547
2548       CoreOS detection added (Nikos Skalkotos).
2549
2550       The package manager in Fedora ≥ 22 is "dnf".
2551
2552       ReactOS guests can be inspected (Maros Zatko).
2553
2554       Add support for UEFI guests.
2555
2556       Inspection now works when kernel modules are gzip or xz compressed
2557       (Pino Toscano).
2558
2559       Inspection now recognizes ppc64 and ppc64le guests (Maros Zatko).
2560
2561       Inspection lists the installed applications on Archlinux guests (Nikos
2562       Skalkotos).
2563
2564       Architectures and platforms
2565
2566       PPC64 (POWER7) and PPC64LE (POWER8) architectures are now much better
2567       supported, and should work out of the box.
2568
2569       For aarch64, we use AAVMF (an open source UEFI implementation based on
2570       OVMF) if available to run the appliance.
2571
2572       For armv7, we now use the -M virt machine type by default.
2573
2574       There is better support for compiling on non-Linux platforms (Pino
2575       Toscano, Margaret Lewicka).
2576
2577       Libguestfs should now work on MIPS 32 bit little endian ("mipsel").  I
2578       have not been able to try 64 bit or big endian.
2579
2580   Security
2581       CVE-2014-8484
2582       CVE-2014-8485
2583           Libguestfs previously ran the strings(1) utility on untrusted
2584           files.  Strings could parse BFD headers in an unsafe way, leading
2585           to possible arbitrary code execution.  Libguestfs now runs strings
2586           with a flag to ensure it does not try to parse BFD headers.  This
2587           could have led to exploitation of the libguestfs appliance, but
2588           since libguestfs further constrains the appliance through
2589           virtualization, SELinux and other techniques, it was unlikely to
2590           have caused any privilege escalation on the host.
2591
2592       XPath injection in virt-v2v
2593           One possible XPath injection vulnerability was fixed in virt-v2v.
2594           This might have allowed a malicious guest which was being converted
2595           by virt-v2v to construct an arbitrary XPath expression which would
2596           have been evaluated on the host (by the libxml2 library linked to
2597           the virt-v2v binary).  It is not clear what the effects of this
2598           might be.
2599
2600           For further information, see upstream commit
2601           https://github.com/libguestfs/libguestfs/commit/6c6ce85f94c36803fe2db35a98db436bff0c14b0
2602
2603       Denial of service problems when using "qemu-img info"
2604           When using the American Fuzzy Lop fuzzer ("afl-fuzz") on the
2605           "qemu-img info" command, Richard W.M. Jones found that certain
2606           files can cause the "qemu-img" program to use lots of memory and
2607           time (for example 6GB of heap and 14 seconds of CPU time on a fast
2608           Intel processor), and in some cases to crash.  Since libguestfs may
2609           run "qemu-img info" on disk images to find out what they contain,
2610           this transitively could cause libguestfs to hang or consume lots of
2611           memory.
2612
2613           Libguestfs was modified so that it uses resource limits to limit
2614           the space and time used by "qemu-img info", to avoid this problem.
2615           If a malicious user tries to pass one of these disk images to
2616           libguestfs, "qemu-img" will crash and the crash is reported back to
2617           libguestfs callers as an error message.
2618
2619   API
2620       New APIs
2621
2622       "guestfs_add_libvirt_dom"
2623           This exposes a previously private API that allows you to pass a
2624           "virDomainPtr" object directly from libvirt to libguestfs.
2625
2626       "guestfs_blockdev_setra"
2627           Adjust readahead parameter for devices.  See "blockdev --setra"
2628           command.
2629
2630       "guestfs_btrfs_balance"
2631       "guestfs_btrfs_balance_cancel"
2632       "guestfs_btrfs_balance_pause"
2633       "guestfs_btrfs_balance_resume"
2634       "guestfs_btrfs_balance_status"
2635           Balance support for Btrfs filesystems (Hu Tao).
2636
2637       "guestfs_btrfs_filesystem_defragment"
2638           Filesystem defragmentation support for Btrfs filesystems (Hu Tao).
2639
2640       "guestfs_btrfs_image"
2641           Create an image of a Btrfs filesystem (Chen Hanxiao)
2642
2643       "guestfs_btrfs_qgroup_assign"
2644       "guestfs_btrfs_qgroup_create"
2645       "guestfs_btrfs_qgroup_destroy"
2646       "guestfs_btrfs_qgroup_limit"
2647       "guestfs_btrfs_qgroup_remove"
2648       "guestfs_btrfs_qgroup_show"
2649       "guestfs_btrfs_quota_enable"
2650       "guestfs_btrfs_quota_rescan"
2651           Quote support for Btrfs filesystems (Hu Tao).
2652
2653       "guestfs_btrfs_rescue_chunk_recover"
2654           Scan and recover the chunk tree in Btrfs filesystems (Hu Tao).
2655
2656       "guestfs_btrfs_rescue_super_recover"
2657           Restore superblocks in Btrfs filesystems (Hu Tao).
2658
2659       "guestfs_btrfs_replace"
2660           Replace a device in a Btrfs filesystem (Cao Jin).
2661
2662       "guestfs_btrfs_scrub"
2663       "guestfs_btrfs_scrub_cancel"
2664       "guestfs_btrfs_scrub_resume"
2665       "guestfs_btrfs_scrub_status"
2666           Scrub a Btrfs filesystem (Hu Tao).
2667
2668       "guestfs_btrfs_subvolume_get_default"
2669           Get the default subvolume of a Btrfs filesystem (Hu Tao).
2670
2671       "guestfs_btrfs_subvolume_show"
2672           List detailed information about the subvolume of a Btrfs filesystem
2673           (Hu Tao).
2674
2675       "guestfs_btrfstune_enable_extended_inode_refs"
2676       "guestfs_btrfstune_enable_skinny_metadata_extent_refs"
2677       "guestfs_btrfstune_seeding"
2678           Various tuning parameters for Btrfs filesystems (Chen Hanxiao).
2679
2680       "guestfs_c_pointer"
2681           Return the C pointer to the underlying "guestfs_h *".  This allows
2682           interworking of libguestfs bindings with bindings from other
2683           libraries.  For further information see
2684           https://bugzilla.redhat.com/1075164
2685
2686       "guestfs_copy_in"
2687       "guestfs_copy_out"
2688           Flexible APIs for recursively copying directories of files between
2689           the host and guest filesystem.  Previously these were available
2690           only as guestfish commands, but now any API users can call them
2691           (Pino Toscano).
2692
2693       "guestfs_part_get_gpt_guid"
2694       "guestfs_part_set_gpt_guid"
2695           Get and set the GPT per-partition GUID.
2696
2697       "guestfs_part_get_mbr_part_type"
2698           Get MBR partition type (Chen Hanxiao).
2699
2700       "guestfs_set_uuid_random"
2701           Set the UUID of a filesystem to a randomly generated value;
2702           supported filesystems currently are ext2/3/4, XFS, Btrfs, and swap
2703           partitions.  (Chen Hanxiao).
2704
2705       Other API changes
2706
2707       "guestfs_disk_create" can now use VMDK files as backing files.
2708
2709       "guestfs_btrfs_subvolume_snapshot" takes extra optional parameters (all
2710       added by Hu Tao):
2711
2712       "ro"
2713           for creating a read-only Btrfs snapshot
2714
2715       "qgroupid"
2716           for adding the snapshot to a qgroup
2717
2718       "guestfs_btrfs_subvolume_create" can also take the optional "qgroupid"
2719       parameter (Hu Tao).
2720
2721       "guestfs_set_uuid" can set UUID of swap partitions, Btrfs (Hu Tao, Chen
2722       Hanxiao).
2723
2724       "guestfs_copy_device_to_file" and "guestfs_copy_file_to_file" have a
2725       new optional "append" parameter, allowing you to append to the output
2726       file instead of truncating it.
2727
2728       "guestfs_mkfs" has a new optional "label" parameter to set the initial
2729       label of the new filesystem (Pino Toscano).
2730
2731       "guestfs_set_label" and "guestfs_set_uuid" now set "ENOTSUP" as errno
2732       when there is no implemented support for the filesystem of the
2733       specified mountable (Chen Hanxiao).
2734
2735       Environment variables now let you write "LIBGUESTFS_DEBUG=true",
2736       "LIBGUESTFS_DEBUG=0" and so on.
2737
2738       All "guestfs_sfdisk*" APIs have been deprecated.  Because sfdisk(8) was
2739       rewritten, incompatibly, upstream, we don't recommend using these APIs
2740       in future code.  Use the "guestfs_part*" APIs as replacements.
2741
2742       APIs such as "guestfs_download" do not truncate /dev/stdout or
2743       /dev/stderr when writing to them, meaning that if you redirect stdout
2744       or stderr to a file, the file is no longer truncated.
2745
2746   Build changes
2747       The daemon no longer uses its own separate copy of gnulib.  Instead it
2748       shares a single copy with the library.
2749
2750       OCaml .annot files are now created, so IDEs and editors like emacs and
2751       vi can browse OCaml types in the source code.
2752
2753       Various fixes to allow different host/appliance architecture builds
2754       (Pino Toscano).
2755
2756       Automake is now used directly to build all the OCaml programs, instead
2757       of ad hoc Makefile rules.  One side effect of this is to enable
2758       warnings in all the C code used by OCaml programs.
2759
2760       "-fno-strict-overflow" is used throughout the build to avoid dubious
2761       GCC optimizations.
2762
2763       Multiple cleanups to support GCC 5.
2764
2765       OCaml OUnit2 is needed to run some OCaml tests.
2766
2767       Creating a statically linked libguestfs.a should work again.
2768
2769       The src/api-support subdirectory and its scripts are no longer used.
2770       Instead we store in the generator/actions.ml when the API was added to
2771       libguestfs.
2772
2773   Internationalization
2774       The translation service has changed from Transifex to Zanata.
2775
2776       Many more translations are available now, for both library and tools
2777       messages and documentation.
2778
2779   Internals
2780       In all OCaml tools, there are now common "error", "warning", "info"
2781       functions, and common way to set and get the --quiet, -x (trace) and -v
2782       (verbose) flags, and colour highlighting used consistently.
2783
2784       "COMPILE_REGEXP" macros are used to simplify PCRE constructors and
2785       destructors.
2786
2787       In the generator, "Pointer" arguments have finally been implemented.
2788
2789       Internal identifiers no longer use double and triple underscores (eg.
2790       "guestfs___program_name").  These identifiers are invalid for C99 and
2791       C++ programs, although compilers would accept them.
2792
2793       The daemon no longer parses "guestfs_*" options from /proc/cmdline.
2794       Instead it only takes ordinary command line options.  The appliance
2795       init script turns /proc/cmdline into daemon command line options.
2796
2797       The tests can now run the daemon as a "captive process", allowing it to
2798       be run directly on the host.  The main advantage of this is we can run
2799       valgrind directly on the daemon during testing.
2800
2801   Bugs fixed
2802       https://bugzilla.redhat.com/1239053
2803           virt-v2v error reporting when grub.conf cannot be parsed by Augeas
2804
2805       https://bugzilla.redhat.com/1238053
2806           v2v:Duplicate disk target set when convert guest with cdrom
2807           attached
2808
2809       https://bugzilla.redhat.com/1237869
2810           Virtio drivers are not installed for windows 2008 guests by
2811           virt-v2v
2812
2813       https://bugzilla.redhat.com/1234351
2814           virt-v2v Support for Fedora virtio-win drivers
2815
2816       https://bugzilla.redhat.com/1232192
2817           Virt-v2v gives an error on a blank disk: part_get_parttype: unknown
2818           signature, of the output: BYT;
2819
2820       https://bugzilla.redhat.com/1229385
2821           virt-p2v in kernel command line mode should power off the machine
2822           after conversion
2823
2824       https://bugzilla.redhat.com/1229340
2825           virt-p2v no GUI mode appends \n to the final command line parameter
2826
2827       https://bugzilla.redhat.com/1229305
2828           virt-sysprep at cleanup deletes /var/spool/at/.SEQ which results in
2829           failing at
2830
2831       https://bugzilla.redhat.com/1226794
2832           "Doing conversion……" still shows after cancel the conversion from
2833           virt-p2v client
2834
2835       https://bugzilla.redhat.com/1215042
2836           Memory leak in virNetSocketNewConnectUNIX
2837
2838       https://bugzilla.redhat.com/1213324
2839           virt-v2v: warning: unknown guest operating system: windows windows
2840           6.3 when converting win8,win8.1,win2012,win2012R2 to rhev
2841
2842       https://bugzilla.redhat.com/1213247
2843           virt tools should print the same format of version string
2844
2845       https://bugzilla.redhat.com/1212808
2846           RFE: virt-builder --touch
2847
2848       https://bugzilla.redhat.com/1212807
2849           virt-builder --selinux-relabel flag fails on cross-architecture
2850           builds
2851
2852       https://bugzilla.redhat.com/1212680
2853           RFE: virt-inspector xpath query should output a neat format of the
2854           query element
2855
2856       https://bugzilla.redhat.com/1212152
2857           virt-builder firstboot-command fails: File name too long
2858
2859       https://bugzilla.redhat.com/1211996
2860           virt-inspector gives incorrect arch (ppc64) for ppc64le guest
2861
2862       https://bugzilla.redhat.com/1203817
2863           RFE: virt-customize --move and --copy
2864
2865       https://bugzilla.redhat.com/1201526
2866           index-parser can't parse systemd mount files properly
2867
2868       https://bugzilla.redhat.com/1196101
2869           virt-builder --upload option doesn't work to a FAT partition
2870
2871       https://bugzilla.redhat.com/1196100
2872           virt-builder -x option on its own does not enable tracing
2873
2874       https://bugzilla.redhat.com/1195204
2875           `virt-builder` should create $HOME/.cache directory if it already
2876           doesn't exist
2877
2878       https://bugzilla.redhat.com/1193237
2879           Virt-builder fingerprint is required even when no check desired
2880
2881       https://bugzilla.redhat.com/1189284
2882           virt-resize should preserve GPT partition UUIDs, else EFI guests
2883           become unbootable
2884
2885       https://bugzilla.redhat.com/1188866
2886           Performance regression in virt-builder when uncompressing image
2887
2888       https://bugzilla.redhat.com/1186800
2889           virt-v2v should support gzip format ova as input
2890
2891       https://bugzilla.redhat.com/1185561
2892           virt-sparsify should ignore read-only LVs
2893
2894       https://bugzilla.redhat.com/1182463
2895           "mknod-b", "mknod-c", and "mkfifo" do not strip non-permissions
2896           bits from "mode"
2897
2898       https://bugzilla.redhat.com/1176493
2899           virt-v2v ignores sound device when convert xen guest to local kvm
2900
2901       https://bugzilla.redhat.com/1175676
2902           Typo error in 'help ping-daemon'
2903
2904       https://bugzilla.redhat.com/1175196
2905           "parse-environment" and "parse-environment-list" fail to parse
2906           "LIBGUESTFS_TRACE = 0"
2907
2908       https://bugzilla.redhat.com/1175035
2909           "is-blockdev"/"is-blockdev-opts" fail to detect "/dev/sda"
2910
2911       https://bugzilla.redhat.com/1174280
2912           RFE: Allow v2v conversion of Oracle Linux 5.8 VMware VM
2913
2914       https://bugzilla.redhat.com/1174200
2915           New virt-v2v failure: CURL: Error opening file: NSS: client
2916           certificate not found (nickname not specified): Invalid argument
2917
2918       https://bugzilla.redhat.com/1174123
2919           Graphics password disappear after conversion of virt-v2v
2920
2921       https://bugzilla.redhat.com/1174073
2922           The listen address for vnc is changed after conversion by virt-v2v
2923
2924       https://bugzilla.redhat.com/1171666
2925           inspection thinks EFI partition is a separate operating system
2926
2927       https://bugzilla.redhat.com/1171130
2928           virt-v2v conversion of RHEL 3 guest fails with: All of your
2929           loopback devices are in use
2930
2931       https://bugzilla.redhat.com/1170685
2932           Conversion of RHEL 4 guest fails: rpm -ql
2933           1:kernel-utils-2.4-23.el4: virt-v2v: error: libguestfs error:
2934           command_lines:
2935
2936       https://bugzilla.redhat.com/1170073
2937           virt-v2v picks debug kernels over non-debug kernels when versions
2938           are equal
2939
2940       https://bugzilla.redhat.com/1169045
2941           virt-sparsify: libguestfs error: qemu-img info: 'virtual-size' is
2942           not representable as a 64 bit integer
2943
2944       https://bugzilla.redhat.com/1169015
2945           virt-resize --expand fails on ubuntu-14.04.img image (regression)
2946
2947       https://bugzilla.redhat.com/1168144
2948           warning: fstrim: fstrim: /sysroot/: FITRIM ioctl failed: Operation
2949           not supported (ignored) when convert win2003 guest from xen server
2950
2951       https://bugzilla.redhat.com/1167921
2952           p2v: No Network Connection dialog
2953
2954       https://bugzilla.redhat.com/1167774
2955           virt-p2v fails with error:"nbd.c:nbd_receive_negotiate():L501: read
2956           failed"
2957
2958       https://bugzilla.redhat.com/1167623
2959           Remove "If reporting bugs, run virt-v2v with debugging enabled .."
2960           message when running virt-p2v
2961
2962       https://bugzilla.redhat.com/1167601
2963           "Conversion was successful" pop out even virt-p2v fails
2964
2965       https://bugzilla.redhat.com/1167302
2966           virt-v2v: warning: ova hard disk has no parent controller when
2967           convert from a ova file
2968
2969       https://bugzilla.redhat.com/1166618
2970           virt-resize should give out the detail warning info to let
2971           customers know what's going wrong
2972
2973       https://bugzilla.redhat.com/1165975
2974           File "/boot/grub2/device.map" showing is not right after converting
2975           a rhel7 guest from esx server
2976
2977       https://bugzilla.redhat.com/1165785
2978           mount-loop command fails: mount failed: Unknown error -1
2979
2980       https://bugzilla.redhat.com/1165569
2981           Disable "cancel conversion" button after virt-p2v conversion
2982           finished
2983
2984       https://bugzilla.redhat.com/1165564
2985           Provide Reboot/Shutdown button after virt-p2v
2986
2987       https://bugzilla.redhat.com/1164853
2988           Booting in qemu found no volume groups and failed checking the
2989           filesystems
2990
2991       https://bugzilla.redhat.com/1164732
2992           The description of 'help append' is not accurately, it add the
2993           kernel options to libguestfs appliance not the guest kernel
2994
2995       https://bugzilla.redhat.com/1164697
2996           typo errors in man pages
2997
2998       https://bugzilla.redhat.com/1164619
2999           Inspect-get-icon failed on RHEL7 guest
3000
3001       https://bugzilla.redhat.com/1162966
3002           xfs should also give a warning out to let customer know the
3003           limitation
3004
3005       https://bugzilla.redhat.com/1161575
3006           Failed to import guest with "rtl8139" nic  to openstack server
3007           after converted by v2v
3008
3009       https://bugzilla.redhat.com/1159651
3010           virt-sysprep firstboot script is not deleted if it reboot a RHEL 7
3011           guest
3012
3013       https://bugzilla.redhat.com/1159258
3014           esx win2008 32 bit guest fail to load after conversion because the
3015           firmware isn't ACPI compatible
3016
3017       https://bugzilla.redhat.com/1159016
3018           libvirt backend does not set RBD password
3019
3020       https://bugzilla.redhat.com/1158526
3021           Use password file instead of process interaction
3022
3023       https://bugzilla.redhat.com/1157679
3024           virt-p2v-make-disk should add firmwares
3025
3026       https://bugzilla.redhat.com/1156449
3027           libguestfs FTBFS on f21 ppc64le
3028
3029       https://bugzilla.redhat.com/1156301
3030           virt-inspector support adding a remote disk, but in its man page -a
3031           URI / --add URI is missing
3032
3033       https://bugzilla.redhat.com/1155121
3034           Virt-v2v will fail when using relative path for -i ova
3035
3036       https://bugzilla.redhat.com/1153844
3037           Redundancy whitespace at the end of directory name when use <TAB>
3038           to complete the directory name in guestfish with a xfs filesystem
3039           in guest
3040
3041       https://bugzilla.redhat.com/1153589
3042           virt-v2v will hang when converting esx guest before disk copy phase
3043
3044       https://bugzilla.redhat.com/1152998
3045           virt-v2v / qemu-img fails on ova image
3046
3047       https://bugzilla.redhat.com/1151910
3048           virt-ls should remove '/' in the output when specify the directory
3049           name as /etc/
3050
3051       https://bugzilla.redhat.com/1151900
3052           Should also add a field for directory files when run virt-ls with
3053           --csv option
3054
3055       https://bugzilla.redhat.com/1151033
3056           virt-v2v conversions from VMware vCenter server run slowly
3057
3058       https://bugzilla.redhat.com/1146832
3059           virt-v2v fail to convert guest with disk type volume
3060
3061       https://bugzilla.redhat.com/1146007
3062           Input/output error during conversion of esx guest.
3063
3064       https://bugzilla.redhat.com/1135585
3065           [RFE] virt-builder should support copying in a directory/list of
3066           files
3067
3068       https://bugzilla.redhat.com/1089566
3069           [abrt] livecd-tools: kickstart.py:276:apply:IOError: [Errno 2] No
3070           such file or directory:
3071           '/run/media/jones/2tp001data/createlive/temp/imgcreate-_dX8Us/install_root/etc/rpm/macros.imgcreate'
3072
3073       https://bugzilla.redhat.com/1079625
3074           virt-sparsify fails if a btrfs filesystem contains readonly
3075           snapshots
3076
3077       https://bugzilla.redhat.com/1075164
3078           RFE: allow passing in a pre-opened libvirt connection from python
3079
3080       https://bugzilla.redhat.com/912499
3081           Security context on image file gets reset
3082
3083       https://bugzilla.redhat.com/889082
3084           [RFE] virt-v2v should check whether guest with same name exist on
3085           target first then transfer the disk
3086
3087       https://bugzilla.redhat.com/855059
3088           RFE: virt-p2v: display more information about network devices such
3089           as topology, bonding, etc.
3090
3091       https://bugzilla.redhat.com/823758
3092           p2v client should have largest number restrictions for CPU and
3093           Memory settings
3094
3095       https://bugzilla.redhat.com/709327
3096           hivex cannot read registry hives from ReactOS
3097
3098       https://bugzilla.redhat.com/709326
3099           virt-inspector cannot detect ReactOS
3100
3101       https://bugzilla.redhat.com/119673
3102           installation via NFS doesn't seem to work
3103

RELEASE NOTES FOR LIBGUESTFS 1.28

3105       These release notes only cover the differences from the previous
3106       stable/dev branch split (1.26.0).  For detailed changelogs, please see
3107       the git repository, or the ChangeLog file distributed in the tarball.
3108
3109   New features
3110       Tools
3111
3112       virt-v2v(1) and virt-p2v(1) are tools for converting from foreign
3113       hypervisors (such as VMware or Xen) or physical machines, to KVM.
3114       These tools were previously a separate project.  The code for both
3115       tools has been integrated into the libguestfs tree.  As part of the
3116       refactoring, virt-p2v has been rewritten (from Ruby, now C), and
3117       virt-v2v now uses several modern features of qemu which make it run
3118       many times faster than before.  virt-v2v(1) can import from: VMware
3119       vCenter, VMware OVA files, local disk files, libvirt, RHEL 5 Xen.  It
3120       can output to: oVirt or Red Hat Enterprise Virtualization (RHEV-M),
3121       OpenStack Glance, libvirt, qemu, local disk files.
3122
3123       virt-log(1) is a new tool for listing log files from guests.  It
3124       supports a variety of guests including Linux traditional, Linux using
3125       journal, and Windows event log.
3126
3127       virt-builder(1) has a new "--machine-readable" option to make it
3128       simpler to consume virt-builder from other programs.
3129
3130       New virt-builder(1) and virt-customize(1) --chmod option.
3131
3132       virt-sysprep(1) will now remove: systemd journals, anaconda logs,
3133       lightdm logs, debian-installer files, apt logs, exim logs, ConsoleKit
3134       logs, firewalld logs, grubby logs, proftpd logs, libvirt/libxml logs,
3135       and several other log files.  The virt-sysprep "user-account" operation
3136       is now able to remove or keep particular user accounts.  (Pino
3137       Toscano).
3138
3139       New guestmount(1) --fd option, allowing you to run guestmount captive
3140       under another process.
3141
3142       virt-sparsify(1) has a new --tmp option allowing you to precisely
3143       control where temporary files are stored.
3144
3145       virt-sparsify(1) can now write to a block device.
3146
3147       virt-customize(1) and virt-sysprep(1) now support adding firstboot
3148       scripts to Windows guests.
3149
3150       virt-cat(1), virt-edit(1), virt-ls(1) now support the -m option,
3151       allowing you to override automatic inspection of guests and instead
3152       specify where to mount partitions (Pino Toscano).
3153
3154       The virt tools now have coloured output: green for OK, red for errors,
3155       blue for warnings.
3156
3157       Language bindings
3158
3159       You can build a Python distribution using "make -C python sdist"
3160
3161       Ruby bindings have switched from "Test::Unit" to "MiniTest".
3162
3163       The Java bindings are now compatible with OpenJDK 8 (Pino Toscano).
3164
3165       Inspection
3166
3167       Oracle Linux is returned as "oraclelinux" (Nikos Skalkotos).
3168
3169       Linux guests which do not have /etc/fstab can now be handled (Pino
3170       Toscano).
3171
3172       Minix is returned as "minix" (Pino Toscano).
3173
3174       Architectures
3175
3176       Aarch64 (64 bit ARM) support has been added.
3177
3178       Inspection and the "guestfs_file_architecture" call can now recognize
3179       arm (32 bit) and aarch64 guests.
3180
3181   Security
3182       CVE-2014-0191 Network usage and entity resolution in XML parsing
3183           Libguestfs previously used unsafe libxml2 APIs for parsing libvirt
3184           XML.  These APIs defaulted to allowing network connections to be
3185           made when certain XML documents were presented.  Using a malformed
3186           XML document it was also possible to exhaust all CPU, memory or
3187           file descriptors on the machine.
3188
3189           Since the libvirt XML comes from a trusted source (the libvirt
3190           daemon) it is not thought that this could have been exploitable.
3191
3192           This was fixed in libguestfs ≥ 1.27.9 and the fix was backported to
3193           stable versions ≥ 1.26.2, ≥ 1.24.9, ≥ 1.22.10 and ≥ 1.20.13.
3194           (Thanks: Dan Berrange, Pino Toscano).
3195
3196       Shellshock (bash CVE-2014-6271)
3197           This bash bug indirectly affects libguestfs.  For more information
3198           see:
3199           https://www.redhat.com/archives/libguestfs/2014-September/msg00252.html
3200
3201   API
3202       New APIs
3203
3204       "guestfs_clear_backend_setting"
3205       "guestfs_get_backend_setting"
3206       "guestfs_set_backend_setting"
3207           Use these APIs to set individual backend settings.
3208
3209       "guestfs_cpio_out"
3210           Convert a directory within the disk image to cpio format.
3211
3212       "guestfs_journal_get_realtime_usec"
3213           Fetch precise journal times, see sd_journal_get_realtime_usec(3).
3214
3215       "guestfs_lstatns"
3216       "guestfs_lstatnslist"
3217       "guestfs_statns"
3218           Enhanced versions of "guestfs_lstat", "guestfs_lstatlist",
3219           "guestfs_stat" which return nanosecond timestamps.
3220
3221   Build changes
3222       Libguestfs can now be built with qemu 2.x.
3223
3224       Add support for packaging the appliance on Mageia (Joseph Wang, Thierry
3225       Vignaud).
3226
3227       Augeas is now a required dependency.
3228
3229       Flex and bison are now required dependencies.
3230
3231   Internals
3232       User-Mode Linux (UML) is no longer a supported backend (although still
3233       available).  It will be supported again once someone steps in and fixes
3234       various regressions and brokenness in the UML (Linux) kernel.
3235
3236       You can now connect gdb to qemu by specifying
3237       "LIBGUESTFS_BACKEND_SETTINGS=gdb"
3238
3239       Serial BIOS (sgabios) is now used by the libvirt backend (on x86 only)
3240       so that we see early BIOS messages.
3241
3242       For the OCaml virt tools, exceptions are now handled and printed by a
3243       common function.
3244
3245       A GCC warning about large stack frames is now enabled by default.
3246       Several places that used large arrays and structures on the stack have
3247       been fixed.
3248
3249       There is now a test for booting the appliance repeatedly.  Useful for
3250       finding kernel leaks.  See: tests/qemu/qemu-boot.c
3251
3252       There is a test for testing the speed of various qemu features such as
3253       virtio-serial uploads and block device writes.  See:
3254       tests/qemu/qemu-speed-test.c
3255
3256       GCC warnings are now enabled for OCaml-C bindings in the OCaml virt
3257       tools.
3258
3259       The code for editing files used by virt-edit(1), guestfish(1) "edit"
3260       command, virt-customize(1) --edit option and more is now shared between
3261       all these utilities (thanks Pino Toscano).
3262
3263       The FUSE tests were rewritten in C to ensure finer control over how
3264       system calls are tested.
3265
3266       The update-bugs.sh script has been fixed so it should no longer create
3267       an empty "BUGS" file if the Bugzilla server is unavailable.
3268
3269       The virt-resize(1) tests now use a stochastic method to ensure much
3270       deeper and broader testing.
3271
3272       When the network is enabled, the appliance now uses DHCP to acquire an
3273       IP address.
3274
3275       If libvirt is being used then the appliance will connect to "virbr0"
3276       (can be overridden by setting
3277       "LIBGUESTFS_BACKEND_SETTINGS=network_bridge=<some_bridge>").  This
3278       enables full-featured network connections, with working ICMP, ping and
3279       so on.
3280
3281   Bugs fixed
3282       https://bugzilla.redhat.com/1153515
3283           empty (but set) LIBGUESTFS_BACKEND prints libguestfs: error:
3284           invalid backend:
3285
3286       https://bugzilla.redhat.com/1151766
3287           libguestfs-bash-completion package contains file
3288           /usr/share/bash-completion/completions/virt-log, but no _virt_log()
3289           function in that file
3290
3291       https://bugzilla.redhat.com/1151738
3292           typo error in man page of virt-edit
3293
3294       https://bugzilla.redhat.com/1151033
3295           virt-v2v conversions from VMware vCenter server run slowly
3296
3297       https://bugzilla.redhat.com/1150880
3298           virt-v2v: warning: display <graphics type='sdl'> was ignored when
3299           converting rhel5 guest with sdl graphics
3300
3301       https://bugzilla.redhat.com/1150867
3302           'copy-file-to-file /src /dest' create file /dest even if command
3303           'copy-file-to-file /src /dest' failed
3304
3305       https://bugzilla.redhat.com/1150815
3306           Can not find "RECURSIVE LONG LISTING" in 'man virt-diff'
3307
3308       https://bugzilla.redhat.com/1150701
3309           virt-v2v does not fstrim data disks and non-mounted filesystems
3310
3311       https://bugzilla.redhat.com/1150475
3312           Exporting 2+ disk guest to RHEV, only one disk shows after import
3313
3314       https://bugzilla.redhat.com/1148355
3315           virt-filesystems: incorrect LVM vg name when listing Fedora 21
3316           Alpha Atomic image filesystems
3317
3318       https://bugzilla.redhat.com/1148072
3319           Option missing --no-selinux-relabel
3320
3321       https://bugzilla.redhat.com/1148012
3322           RFE: Allow qemu-bridge-helper to be used to implement
3323           guestfs_set_network
3324
3325       https://bugzilla.redhat.com/1146815
3326           virt-v2v prints warning: /files/etc/fstab/8/spec references unknown
3327           device "cdrom"
3328
3329       https://bugzilla.redhat.com/1146275
3330           regression setting root password with virt-builder/virt-customize
3331
3332       https://bugzilla.redhat.com/1146017
3333           virt-v2v -v -x during windows guest conversion will hang at hivex:
3334           hivex_open: used block id ……
3335
3336       https://bugzilla.redhat.com/1145995
3337           Improve the error info when converting windows guest with unclean
3338           file system
3339
3340       https://bugzilla.redhat.com/1145916
3341           virt-v2v fails to convert win7 guest
3342
3343       https://bugzilla.redhat.com/1144891
3344           RFE: stat calls do not return nanosecond timestamps
3345
3346       https://bugzilla.redhat.com/1144766
3347           futimens() is a no-op via guestmount
3348
3349       https://bugzilla.redhat.com/1144201
3350           guestfish can not restore terminal's output colour when exit
3351           guestfish, if the terminal's background colour is black then it
3352           will make a inconvenient
3353
3354       https://bugzilla.redhat.com/1143949
3355           virt-customize option '--password-crypto' do not work
3356
3357       https://bugzilla.redhat.com/1143887
3358           Warning shows when converting guests to rhev:chown: changing
3359           ownership of ‘/tmp/v2v.u48xag/*.ovf’: Invalid argument
3360
3361       https://bugzilla.redhat.com/1143883
3362           warning shows when converting rhel7 guest:virt-v2v:could not update
3363           grub2 console: aug_get: no matching node (ignored)
3364
3365       https://bugzilla.redhat.com/1143866
3366           virt-v2v fails with error: cannot open Packages index using db5
3367
3368       https://bugzilla.redhat.com/1142416
3369           part-get-name give 'libguestfs: error: part_get_name: parted does
3370           not support the machine output (-m)' error message when run
3371           'part-get-name /dev/sda 1'
3372
3373       https://bugzilla.redhat.com/1142186
3374           virt-sysprep option '--mount-options' don't work well
3375
3376       https://bugzilla.redhat.com/1142158
3377           Illegal command 'part-get-name /dev/sda1 1' cause libguestfs
3378           appliance crashed
3379
3380       https://bugzilla.redhat.com/1142004
3381           virt-v2v prints warning:WARNING:/files/boot/grub/device.map
3382           references unknown device "xvda"
3383
3384       https://bugzilla.redhat.com/1141723
3385           virt-v2v: error: disk sda has no defined format shows when
3386           converting xen hvm guest
3387
3388       https://bugzilla.redhat.com/1141680
3389           [RFE] virt-v2 should support convert a domain with using domain's
3390           UUID instead of domain name
3391
3392       https://bugzilla.redhat.com/1141631
3393           [RFE] virt-v2 should support convert a guest to a dir-pool with
3394           using pool's uuid
3395
3396       https://bugzilla.redhat.com/1141157
3397           virt-sysprep option '--user-accounts' don't work well
3398
3399       https://bugzilla.redhat.com/1141145
3400           virt-v2v fails to convert xen pv guests.
3401
3402       https://bugzilla.redhat.com/1141113
3403           virt-v2v fails to convert esx guests
3404
3405       https://bugzilla.redhat.com/1140946
3406           qemu-img shows error message for backing file twice
3407
3408       https://bugzilla.redhat.com/1140894
3409           No error messages output if append '--format qcow2' after '-a
3410           guest.img', guest.img is a raw format image file
3411
3412       https://bugzilla.redhat.com/1140547
3413           virt-builder option '--format' don't work well
3414
3415       https://bugzilla.redhat.com/1140156
3416           RFE: Export to RHEV data domain
3417
3418       https://bugzilla.redhat.com/1140050
3419           No error shows when multiple conflicting options used with virt-v2v
3420
3421       https://bugzilla.redhat.com/1139973
3422           Improve the error info when converting xen guest with no
3423           passwordless SSH access configured
3424
3425       https://bugzilla.redhat.com/1139543
3426           Improve the error info when converting guest with no space left
3427
3428       https://bugzilla.redhat.com/1138586
3429           No error shows when converting running guest with virt-v2v
3430
3431       https://bugzilla.redhat.com/1138184
3432           virt-v2v will fail when converting guests with initramfs-*kdump.img
3433           under /boot
3434
3435       https://bugzilla.redhat.com/1138182
3436           xen guest will be kernel panic after converted by virt-v2v
3437
3438       https://bugzilla.redhat.com/1130189
3439           Annoying message about permissions of /dev/kvm
3440
3441       https://bugzilla.redhat.com/1123007
3442           libguestfs 'direct' backend should close file descriptors before
3443           exec-ing qemu to avoid leaking !O_CLOEXEC fds
3444
3445       https://bugzilla.redhat.com/1122557
3446           virt-sparsify overwrites block devices if used as output files
3447
3448       https://bugzilla.redhat.com/1113156
3449           Empty fstab breaks libguestfs inspection
3450
3451       https://bugzilla.redhat.com/1111662
3452           Guestfs.Error("vgchange_uuid_all:   Volume group has active logical
3453           volumes")
3454
3455       https://bugzilla.redhat.com/1109174
3456           virt-win-reg manual page is corrupted
3457
3458       https://bugzilla.redhat.com/1106548
3459           root gets an error accessing to a non-root dir on a snapshot
3460           guestmount VMDK img
3461
3462       https://bugzilla.redhat.com/1103877
3463           These APIs also need to add to `guestfish -h` command list
3464
3465       https://bugzilla.redhat.com/1102448
3466           mageia package list is incorrect
3467
3468       https://bugzilla.redhat.com/1102447
3469           libguestfs 1.27.13 does not build due to libxml library order
3470
3471       https://bugzilla.redhat.com/1100498
3472           RFE: non-polling mechanism to detect guestmount --no-fork readiness
3473
3474       https://bugzilla.redhat.com/1099490
3475           scrub-file can't handle link file
3476
3477       https://bugzilla.redhat.com/1099284
3478           typo errors in man pages
3479
3480       https://bugzilla.redhat.com/1098718
3481           RFE: virt-builder aliases
3482
3483       https://bugzilla.redhat.com/1096465
3484           virt-builder "proxy=off" setting doesn't turn off the proxy for
3485           downloads
3486
3487       https://bugzilla.redhat.com/1094746
3488           virt-sparsify man failes to mention what happens to snapshots
3489           within a qcow2 image (they are discarded)
3490
3491       https://bugzilla.redhat.com/1092753
3492           virt-builder: If several repos contain the same os-version images,
3493           then they are duplicated in -l output
3494
3495       https://bugzilla.redhat.com/1091803
3496           tar-in-opts execute failed that cause libguestfs appliance crashed
3497
3498       https://bugzilla.redhat.com/1088424
3499           virt-resize: libguestfs error: part_set_name: parted: /dev/sdb:
3500           Error during translation: Invalid or incomplete multibyte or wide
3501           character
3502
3503       https://bugzilla.redhat.com/1088262
3504           virt-builder cannot write to a block device
3505
3506       https://bugzilla.redhat.com/1085029
3507           Ruby tests fail with latest Ruby
3508
3509       https://bugzilla.redhat.com/1079210
3510           virt-sparsify --in-place cannot sparsify as much as it should
3511
3512       https://bugzilla.redhat.com/1079182
3513           virt-df cannot report used disk space of windows guest when updated
3514           to 6.5
3515
3516       https://bugzilla.redhat.com/1077817
3517           virt-builder error: "syntax error at line 3: syntax error"
3518
3519       https://bugzilla.redhat.com/1056290
3520           virt-sparsify overwrites block devices if used as output files
3521
3522       https://bugzilla.redhat.com/812970
3523           virt-rescue cannot set ≥<rescue> prompt, on Ubuntu 12.04
3524

RELEASE NOTES FOR LIBGUESTFS 1.26

3526       These release notes only cover the differences from the previous
3527       stable/dev branch split (1.24.0).  For detailed changelogs, please see
3528       the git repository, or the ChangeLog file distributed in the tarball.
3529
3530   New features
3531       Tools
3532
3533       virt-customize(1) is a new tool for customizing virtual machine disk
3534       images.  It lets you install packages, edit configuration files, run
3535       scripts, set passwords and so on.  virt-builder(1) and virt-sysprep(1)
3536       use virt-customize, and command line options across all these tools are
3537       now identical.
3538
3539       virt-diff(1) is a new tool for showing the differences between the
3540       filesystems of two virtual machines.  It is mainly useful when showing
3541       what files have been changed between snapshots.
3542
3543       virt-builder(1) has been greatly enhanced.  There are many more ways to
3544       customize the virtual machine.  It can pull templates from multiple
3545       repositories.  A parallelized internal xzcat implementation speeds up
3546       template decompression.  Virt-builder uses an optimizing planner to
3547       choose the fastest way to build the VM.  It is now easier to use virt-
3548       builder from other programs.  Internationalization support has been
3549       added to metadata.  More efficient SELinux relabelling of files.  Can
3550       build guests for multiple architectures.  Error messages have been
3551       improved.  (Pino Toscano)
3552
3553       virt-sparsify(1) has a new --in-place option.  This sparsifies an image
3554       in place (without copying it) and is also much faster.  (Lots of help
3555       provided by Paolo Bonzini)
3556
3557       virt-sysprep(1) can delete and scrub files under user control.  You can
3558       lock user accounts or set random passwords on accounts.  Can remove
3559       more log files.  Can unsubscribe a guest from Red Hat Subscription
3560       Manager.  New flexible way to enable and disable operations.  (Wanlong
3561       Gao, Pino Toscano)
3562
3563       virt-win-reg(1) allows you to use URIs to specify remote disk images.
3564
3565       virt-format(1) can now pass the extra space that it recovers back to
3566       the host.
3567
3568       guestfish(1) has additional environment variables to give fine control
3569       over the "><fs>" prompt.  Guestfish reads its (rarely used)
3570       configuration file in a different order now so that local settings
3571       override global settings.  (Pino Toscano)
3572
3573       virt-make-fs(1) was rewritten in C, but is unchanged in terms of
3574       functionality and command line usage.
3575
3576       Language bindings
3577
3578       The OCaml bindings have a new "Guestfs.Errno" module, used to check the
3579       error number returned by "Guestfs.last_errno".
3580
3581       PHP tests now work.  (Pino Toscano)
3582
3583       Inspection
3584
3585       Inspection can recognize Debian live images.
3586
3587       Architectures
3588
3589       ARMv7 (32 bit) now supports KVM acceleration.
3590
3591       Aarch64 (ARM 64 bit) is supported, but the appliance part does not work
3592       yet.
3593
3594       PPC64 support has been fixed and enhanced.
3595
3596   Security
3597       Denial of service when inspecting disk images with corrupt btrfs
3598       volumes
3599           It was possible to crash libguestfs (and programs that use
3600           libguestfs as a library) by presenting a disk image containing a
3601           corrupt btrfs volume.
3602
3603           This was caused by a NULL pointer dereference causing a denial of
3604           service, and is not thought to be exploitable any further.
3605
3606           See commit d70ceb4cbea165c960710576efac5a5716055486 for the fix.
3607           This fix is included in libguestfs stable branches ≥ 1.26.0,
3608           ≥ 1.24.6 and ≥ 1.22.8, and also in RHEL ≥ 7.0.  Earlier versions of
3609           libguestfs are not vulnerable.
3610
3611       Better generation of random root passwords and random seeds
3612           When generating random root passwords and random seeds, two bugs
3613           were fixed which are possibly security related.  Firstly we no
3614           longer read excessive bytes from /dev/urandom (most of which were
3615           just thrown away).  Secondly we changed the code to avoid modulo
3616           bias.  These issues were not thought to be exploitable.  (Both
3617           changes suggested by Edwin Török)
3618
3619   API
3620       GUID parameters are now validated when they are passed to API calls,
3621       whereas previously you could have passed any string.  (Pino Toscano)
3622
3623       New APIs
3624
3625       "guestfs_add_drive_opts": new "discard" parameter
3626           The new "discard" parameter allows fine-grained control over
3627           discard/trim support for a particular disk.  This allows the host
3628           file to become more sparse (or thin-provisioned) when you delete
3629           files or issue the "guestfs_fstrim" API call.
3630
3631       "guestfs_add_domain": new parameters: "cachemode", "discard"
3632           These parameters are passed through when adding the domain's disks.
3633
3634       "guestfs_blkdiscard"
3635           Discard all blocks on a guestfs device.  Combined with the
3636           "discard" parameter above, this makes the host file sparse.
3637
3638       "guestfs_blkdiscardzeroes"
3639           Test if discarded blocks read back as zeroes.
3640
3641       "guestfs_compare_*"
3642       "guestfs_copy_*"
3643           For each struct returned through the API, libguestfs now generates
3644           "guestfs_compare_*" and "guestfs_copy_*" functions to allow you to
3645           compare and copy structs.
3646
3647       "guestfs_copy_attributes"
3648           Copy attributes (like permissions, xattrs, ownership) from one file
3649           to another.  (Pino Toscano)
3650
3651       "guestfs_disk_create"
3652           A flexible API for creating empty disk images from scratch.  This
3653           avoids the need to call out to external programs like qemu-img(1).
3654
3655       "guestfs_get_backend_settings"
3656       "guestfs_set_backend_settings"
3657           Per-backend settings (can also be set via the environment variable
3658           "LIBGUESTFS_BACKEND_SETTINGS").  The main use for this is forcing
3659           TCG mode in the qemu-based backends, for example:
3660
3661            export LIBGUESTFS_BACKEND=direct
3662            export LIBGUESTFS_BACKEND_SETTINGS=force_tcg
3663
3664       "guestfs_part_get_name"
3665           Get the label or name of a partition (for GPT disk images).
3666
3667   Build changes
3668       The following extra packages are required to build libguestfs 1.26:
3669
3670       supermin ≥ 5
3671           Supermin version 5 is required to build this version of libguestfs.
3672
3673       flex, bison
3674           Virt-builder now uses a real parser to parse its metadata file, so
3675           these tools are required.
3676
3677       xz  This is now a required build dependency, where previously it was
3678           (in theory) optional.
3679
3680   Internals
3681       PO message extraction rewritten to be more robust.  (Pino Toscano)
3682
3683       "podwrapper" gives an error if the --insert or --verbatim argument
3684       pattern is not found.
3685
3686       Libguestfs now passes the qemu -enable-fips option to enable FIPS, if
3687       qemu supports it.
3688
3689       "./configure --without-qemu" can be used if you don't want to specify a
3690       default hypervisor.
3691
3692       Copy-on-write [COW] overlays, used for example for read-only drives,
3693       are now created through an internal backend API
3694       (".create_cow_overlay").
3695
3696       Libvirt backend uses some funky C macros to generate XML.  These are
3697       simpler and safer.
3698
3699       The ChangeLog file format has changed.  It is now just the same as "git
3700       log", instead of using a custom format.
3701
3702       Appliance start-up has changed:
3703
3704       ·   The libguestfs appliance now initializes LVM the same way as it is
3705           done on physical machines.
3706
3707       ·   The libguestfs appliance does not write an empty string to
3708           /proc/sys/kernel/hotplug when starting up.
3709
3710           Note that you must configure your kernel to have
3711           "CONFIG_UEVENT_HELPER_PATH=""" otherwise you will get strange LVM
3712           errors (this applies as much to any Linux machine, not just
3713           libguestfs).  (Peter Rajnoha)
3714
3715       Libguestfs can now be built on arches that have ocamlc(1) but not
3716       ocamlopt(1).  (Hilko Bengen, Olaf Hering)
3717
3718       You cannot use "./configure --disable-daemon --enable-appliance".  It
3719       made no sense anyway.  Now it is expressly forbidden by the configure
3720       script.
3721
3722       The packagelist file uses "m4" for macro expansion instead of "cpp".
3723
3724   Bugs fixed
3725       https://bugzilla.redhat.com/1073906
3726           java bindings inspect_list_applications2 throws
3727           java.lang.ArrayIndexOutOfBoundsException:
3728
3729       https://bugzilla.redhat.com/1063374
3730           [RFE] enable subscription manager clean or unregister operation to
3731           sysprep
3732
3733       https://bugzilla.redhat.com/1060404
3734           virt-resize does not preserve GPT partition names
3735
3736       https://bugzilla.redhat.com/1057504
3737           mount-local should give a clearer error if root is not mounted
3738
3739       https://bugzilla.redhat.com/1056290
3740           virt-sparsify overwrites block devices if used as output files
3741
3742       https://bugzilla.redhat.com/1055452
3743           libguestfs: error: invalid backend: appliance
3744
3745       https://bugzilla.redhat.com/1054761
3746           guestfs_pvs prints "unknown device" if a physical volume is missing
3747
3748       https://bugzilla.redhat.com/1053847
3749           Recommended default clock/timer settings
3750
3751       https://bugzilla.redhat.com/1046509
3752           ruby-libguestfs throws "expecting 0 or 1 arguments" on
3753           Guestfs::Guestfs.new
3754
3755       https://bugzilla.redhat.com/1045450
3756           Cannot inspect cirros 0.3.1 disk image fully
3757
3758       https://bugzilla.redhat.com/1045033
3759           LIBVIRT_DEFAULT_URI=qemu:///system breaks libguestfs
3760
3761       https://bugzilla.redhat.com/1044585
3762           virt-builder network (eg. --install) doesn't work if resolv.conf
3763           sets nameserver 127.0.0.1
3764
3765       https://bugzilla.redhat.com/1044014
3766           When SSSD is installed, libvirt configuration requires
3767           authentication, but not clear to user
3768
3769       https://bugzilla.redhat.com/1039995
3770           virt-make-fs fails making fat/vfat whole disk: Device partition
3771           expected, not making filesystem on entire device '/dev/sda' (use -I
3772           to override)
3773
3774       https://bugzilla.redhat.com/1039540
3775           virt-sysprep to delete more logfiles
3776
3777       https://bugzilla.redhat.com/1033207
3778           RFE: libguestfs inspection does not recognize Free4NAS live CD
3779
3780       https://bugzilla.redhat.com/1028660
3781           RFE: virt-sysprep/virt-builder should have an option to lock a user
3782           account
3783
3784       https://bugzilla.redhat.com/1026688
3785           libguestfs fails examining libvirt guest with ceph drives: rbd:
3786           image name must begin with a '/'
3787
3788       https://bugzilla.redhat.com/1022431
3789           virt-builder fails if $HOME/.cache doesn't exist
3790
3791       https://bugzilla.redhat.com/1022184
3792           libguestfs: do not use versioned jar file
3793
3794       https://bugzilla.redhat.com/1020806
3795           All libguestfs LVM operations fail on Debian/Ubuntu
3796
3797       https://bugzilla.redhat.com/1008417
3798           Need update helpout of part-set-gpt-type
3799
3800       https://bugzilla.redhat.com/953907
3801           virt-sysprep does not correctly set the hostname on Debian/Ubuntu
3802
3803       https://bugzilla.redhat.com/923355
3804           guestfish prints literal "\n" in error messages
3805
3806       https://bugzilla.redhat.com/660687
3807           guestmount: "touch" command fails: touch: setting times of
3808           `timestamp': Invalid argument
3809
3810       https://bugzilla.redhat.com/593511
3811           [RFE] function to get partition name
3812
3813       https://bugzilla.redhat.com/563450
3814           list-devices returns devices of different types out of order
3815

RELEASE NOTES FOR LIBGUESTFS 1.24

3817       These release notes only cover the differences from the previous
3818       stable/dev branch split (1.22.0).  For detailed changelogs, please see
3819       the git repository, or the ChangeLog file distributed in the tarball.
3820
3821   New features
3822       User-Mode Linux (UML) can be used as an alternative backend (ie.
3823       instead of KVM).  This improves performance especially when using
3824       libguestfs inside a VM (eg. in the cloud).  UML is supported as a
3825       first-class backend.  See "USER-MODE LINUX BACKEND" in guestfs(3) for
3826       how to use this.
3827
3828       ARM (32 bit) and PPC64 are now fully supported.
3829
3830       Tools
3831
3832       virt-builder(1) is a new tool for building virtual machine images.  It
3833       lets you rapidly and securely create guests and customize them.
3834
3835       New virt-sysprep(1) operations: Remove files in /tmp and /var/tmp.
3836       Remove RPM database files.  Change root and user passwords.  More log
3837       files are removed.  New operations which are not enabled by default:
3838       Create random UUIDs for filesystems.  Reset firewall rules.  (Wanlong
3839       Gao)
3840
3841       virt-resize(1) and virt-sysprep can now use URIs to specify a remote
3842       disk.
3843
3844       Use "guestfish -N filename=type" to create a named disk image (instead
3845       of the default test1.img etc).
3846
3847       virt-sparsify(1) now tests if there is enough disk space to complete
3848       the operation, instead of possibly running out of space half way
3849       through.
3850
3851       virt-format(1) and virt-make-fs(1): new --label option for setting
3852       filesystem label.
3853
3854       virt-resize --no-sparse flag can be used to resize on to partitions and
3855       other targets that are not zeroed.
3856
3857       Language bindings
3858
3859       New bindings for the Go programming language.
3860
3861       API
3862
3863       Support for the systemd journal.
3864
3865       "guestfs_add_drive_opts" can now control the qemu caching mode through
3866       a new "cachemode" parameter.  You can select improved performance for
3867       temporary drives, or safety.
3868
3869       "guestfs_set_label" now works for XFS and btrfs.
3870
3871       New GUESTFS_EVENT_WARNING event for warning messages.
3872
3873       Inspection
3874
3875       Better inspection of SUSE guests (Olaf Hering).
3876
3877       Better support for non-standard Windows %systemroot% (Matthew Booth).
3878
3879       Enhanced error reporting for Augeas errors.
3880
3881   Security
3882       CVE-2013-2124
3883           https://bugzilla.redhat.com/show_bug.cgi?id=968306
3884
3885           A denial of service was possible when inspecting certain guests.
3886           The fix has been backported to 1.20 and 1.22 branches.
3887
3888       CVE-2013-4419
3889           https://www.redhat.com/archives/libguestfs/2013-October/msg00031.html
3890
3891           Fix insecure temporary directory handling for remote guestfish.
3892           The fix has been backported to 1.20 and 1.22 branches.
3893
3894   New APIs
3895        add-drive-scratch: Add a temporary scratch drive
3896        aug-label
3897        aug-setm
3898        journal-open: Systemd journal support
3899        journal-close
3900        journal-next
3901        journal-skip
3902        journal-get
3903        journal-get-data-threshold
3904        journal-set-data-threshold
3905        remount: Allow rw flag to be adjusted on mounted filesystems
3906        set-uuid: Set UUID of filesystem
3907
3908       "is-file", "is-dir", "is-blockdev", "is-chardev", "is-fifo",
3909       "is-socket" APIs now have an extra "followsymlinks" flag.
3910
3911       "add-drive" has a new "cachemode" parameter.
3912
3913   Build changes
3914       The following packages are required to build libguestfs 1.24:
3915
3916       Augeas ≥ 1.0.0
3917
3918       The following optional packages may be added to enhance functionality
3919       but are not required:
3920
3921       sd-journal
3922           To read journal files from guests which use that.
3923
3924       url_mkcow
3925           For UML backend.
3926
3927       curl
3928       gpg
3929       xz  For virt-builder.
3930
3931       golang ≥ 1.1.1
3932           For Go language bindings.
3933
3934   Internals
3935       New "make check-*" rules replace "make extra-tests".  See "make help"
3936       and guestfs(3) for details.
3937
3938       Perl code can now be valgrinded.
3939
3940       Inspection code is now fuzz-tested.
3941
3942       "make" no longer recurses into the generator directory in every other
3943       directory.  This reduces the overhead of builds considerably.
3944
3945       Additional tests for Augeas, hivex.
3946
3947       Add a launch timeout of 20 minutes waiting for the appliance to start
3948       up.
3949
3950       Add a timeout (4 hours) to all tests so we can catch the case where
3951       qemu or other components hang.
3952
3953       Use kvmclock and "-cpu host".  This improves clock stability and
3954       overall performance.
3955
3956       "./configure --enable-packet-dump" mode is fixed.
3957
3958       "./configure --enable-valgrind-daemon" mode has been rewritten.  It is
3959       now feasible for developers to keep this flag enabled at all times.
3960
3961       Backends have been refactored to be modular (although they are not
3962       actually loadable modules).
3963
3964       When enabled, the network now uses resolver configuration (ie.
3965       /etc/resolv.conf) from the host.
3966
3967   Bugs fixed
3968       https://bugzilla.redhat.com/1019889
3969           libguestfs-tools.conf should have a man page
3970
3971       https://bugzilla.redhat.com/1018149
3972           valgrind errors in btrfs_subvolume_list
3973
3974       https://bugzilla.redhat.com/1002032
3975           mke2fs can't return the correct filesystem type when blockscount is
3976           less than 2048 for ext3
3977
3978       https://bugzilla.redhat.com/1001876
3979           Update "rsync-out" helpout for using wildcard
3980
3981       https://bugzilla.redhat.com/1001875
3982           Argument 'excludes' of tar-out does not work
3983
3984       https://bugzilla.redhat.com/1000428
3985           virt-format uses wrong partition type for vfat filesystems
3986
3987       https://bugzilla.redhat.com/1000121
3988           'sh' command before mount causes daemon to segfault
3989
3990       https://bugzilla.redhat.com/998513
3991           guestfish does not work when you mix --remote and --add options
3992
3993       https://bugzilla.redhat.com/998482
3994           guestfish remote prints "libguestfs: error: waitpid (qemu): No
3995           child processes"
3996
3997       https://bugzilla.redhat.com/995711
3998           list-filesystems command fails if there are no block devices
3999
4000       https://bugzilla.redhat.com/994517
4001           cache=none/O_DIRECT workaround doesn't work for images with backing
4002           files
4003
4004       https://bugzilla.redhat.com/989356
4005           cap-get-file will return error if the file has not be set
4006           capabilities
4007
4008       https://bugzilla.redhat.com/986877
4009           RFE: Implement set-uuid command
4010
4011       https://bugzilla.redhat.com/986875
4012           RFE: Implement set-label for xfs
4013
4014       https://bugzilla.redhat.com/985269
4015           Can't set acl value for a specified user with 'acl-set-file'
4016
4017       https://bugzilla.redhat.com/983218
4018           libguestfs double free when kernel link fails during launch
4019
4020       https://bugzilla.redhat.com/981715
4021           Make xfs filesystem failed with specified blocksize, gives "unknown
4022           option -b" error
4023
4024       https://bugzilla.redhat.com/981683
4025           "hivex-commit" should fail with a relative path
4026
4027       https://bugzilla.redhat.com/981663
4028           disk-format "qemu-img info: JSON parse error" when target file does
4029           not exist
4030
4031       https://bugzilla.redhat.com/978302
4032           mke2fs-J should give a meaningful error when specified type is
4033           anything except 'ext{2,3,4}'
4034
4035       https://bugzilla.redhat.com/975797
4036           Specifying virtio interface ('iface' parameter) breaks the direct
4037           backend - libguestfs hangs
4038
4039       https://bugzilla.redhat.com/975753
4040           "virt-resize --expand" and "virt-resize --resize" outputs error
4041           message for Win2008 32bit OS
4042
4043       https://bugzilla.redhat.com/975412
4044           inspection: Augeas expressions are broken with augeas >= 0.10
4045
4046       https://bugzilla.redhat.com/974904
4047           virt-resize --expand fails on Ubuntu Cloud Image
4048
4049       https://bugzilla.redhat.com/974489
4050           Regression: Fedora inspection broken by change from guestfs_exists
4051           to guestfs_is_file
4052
4053       https://bugzilla.redhat.com/972775
4054           txz-out command produces a bzip2-compressed file (should be xz-
4055           compressed)
4056
4057       https://bugzilla.redhat.com/969845
4058           upload to a directory occasionally hangs instead of failing
4059
4060       https://bugzilla.redhat.com/968875
4061           virt-sysprep should support URL-type arguments
4062
4063       https://bugzilla.redhat.com/624334
4064           blockdev-setbsz succeeds, but does not affect blockdev-getbsz
4065

RELEASE NOTES FOR LIBGUESTFS 1.22

4067       These release notes only cover the differences from the previous
4068       stable/dev branch split (1.20.0).  For detailed changelogs, please see
4069       the git repository, or the ChangeLog file distributed in the tarball.
4070
4071   New features
4072       API
4073
4074       Remote access to disks:
4075
4076       ·   Network Block Device (nbd)
4077
4078       ·   Secure Shell (ssh)
4079
4080       ·   HTTP and HTTPS
4081
4082       ·   FTP and FTPS
4083
4084       ·   iSCSI
4085
4086       ·   Gluster
4087
4088       ·   Ceph/rbd (Mike Kelly)
4089
4090       ·   Sheepdog
4091
4092       ·   TFTP
4093
4094       The SYSLINUX and EXTLINUX bootloaders can now be installed in disk
4095       images using the API.
4096
4097       Inspection can now handle filesystems such as btrfs where subvolumes
4098       are separately mountable (Matthew Booth).
4099
4100       "Attach methods" are now known as "backends".  Compatibility with
4101       existing code is preserved.
4102
4103       Filenames can contain ':', as long as newer QEMU is being used.
4104
4105       Tools
4106
4107       Virt-alignment-scan and virt-df scan multiple guests in parallel.
4108
4109       Guestmount now passes errno accurately back to userspace in almost all
4110       cases.
4111
4112       Guestfish and other tools can now use a URI-like syntax to access
4113       remote disks, eg:
4114
4115        guestfish -a ssh://example.com/path/to/disk.img
4116
4117       Guestfish and guestmount now allow you to specify the filesystem type
4118       when mounting, which is more secure (Dave Vasilevsky).
4119
4120       Guestfish is now the "guest filesystem shell".
4121
4122       Guestfish allows only 1 "true" "t" "yes" "y" "on" 0 "false" "f" "no"
4123       "n" "off" for boolean values (case insensitive), and gives an error for
4124       all other strings.
4125
4126       New tool "guestunmount" for unmounting FUSE filesystems safely.
4127
4128       "guestmount --no-fork" flag prevents guestmount from daemonizing.
4129
4130       Virt-resize now uses sparse copies by default, saving considerable
4131       space for guests which are mostly empty.
4132
4133       Bash tab completion has been rewritten and can now handle most tools,
4134       and correctly tab-complete "--long" options.  In addition, bash
4135       completion scripts are loaded on demand.
4136
4137       Language bindings
4138
4139       The Java API now supports events.
4140
4141       The Python object now inherits from the "object" base class.
4142
4143       Python methods which previously returned lists of tuples can now be
4144       made to return a Python dict.  For backwards compatibility, you have to
4145       enable this by using the constructor option
4146       "guestfs.GuestFS (python_return_dict=True)".
4147
4148       The PHP bindings are now tested properly, and have had multiple fixes.
4149
4150       The long-deprecated Perl "Sys::Guestfs::Lib" library has been removed.
4151       https://www.redhat.com/archives/libguestfs/2013-April/msg00001.html
4152
4153       Examples
4154
4155       New example program showing how to enable debugging and capture log
4156       messages.
4157
4158       Other
4159
4160       Distributors can add arbitrary extra packages to the appliance by
4161       doing:
4162
4163        ./configure --with-extra-packages="list of package names"
4164
4165       Distributors can use:
4166
4167        ./configure --with-supermin-extra-options="..."
4168
4169       to add arbitrary extra options to supermin.
4170
4171   Security
4172       No security issues were found in this release.
4173
4174   New APIs
4175        cp-r
4176        extlinux
4177        feature-available
4178        get-program
4179        is-whole-device
4180        part-get-gpt-type
4181        part-set-gpt-type
4182        rename
4183        set-program
4184        syslinux
4185
4186       C only:
4187
4188        guestfs_event_to_string
4189
4190   Internals
4191       The febootstrap tool has now been renamed to "supermin".  Libguestfs
4192       can use either, but now prefers "supermin".
4193       http://people.redhat.com/~rjones/supermin/
4194
4195       libxml2 is required to build libguestfs.
4196
4197       The hivexregedit program (from hivex) is required to build from git.
4198
4199       Internal functions can no longer be used unless the caller defines
4200       "-DGUESTFS_PRIVATE=1".
4201
4202       Enable C compiler warnings in Python, Ruby bindings.
4203
4204       Fail early and clearly if libvirt does not support qemu/KVM (eg. if
4205       default libvirt connection is to Xen).
4206
4207       "make print-subdirs" rule, useful for selectively running tests.
4208
4209       Multiple fixes to allow separated (sourcedir != builddir) builds.
4210
4211       Multiple fixes to Haskell bindings.
4212
4213       "ln" and "ln-f" APIs now capture "errno" correctly.
4214
4215       Language binding tests use (mostly) a standard numbering scheme and aim
4216       to test the same range of features in each language.  Also the number
4217       of launches required has been reduced so these tests should run much
4218       more quickly.
4219
4220       Library code internally uses GCC "__attribute__((cleanup))" (if
4221       available) to simplify memory allocation.
4222
4223       Internal header files have been reorganized.  See the comments in
4224       src/guestfs-internal*.h
4225
4226       Internal code shared between the library and certain tools is now
4227       located in a static "libutils" library.
4228
4229       Almost all subdirectories can now use parallel builds, although note
4230       that the top-level directories still build in series.
4231
4232       Use of "PATH_MAX" and "NAME_MAX" has been eliminated from the code.
4233
4234       The Java API now requires JVM ≥ 1.6.
4235
4236       Force use of "serial-tests" with automake ≥ 1.12.
4237
4238       Use of sockets in the library protocol layer is abstracted, allowing
4239       other non-POSIX layers to be added in future (see src/conn-socket.c).
4240
4241       "qemu-img info --output json" is used if available, for more secure
4242       parsing of the output of this command.
4243
4244       Distros can now use "make INSTALLDIRS=vendor install" to place Ruby
4245       bindings in vendordir.  This eliminates a non-upstream patch carried by
4246       both Fedora and Debian.
4247
4248       Valgrind log files are now written to tmp/valgrind-DATE-PID.log
4249
4250       "make clean" cleans the local "tmp/" directory.
4251
4252       The C API tests have been rewritten using a more flexible generator
4253       language that allows arbitrary C code to be executing during tests.
4254
4255   Bugs fixed
4256       https://bugzilla.redhat.com/961812
4257           Segfault in inspect-fs.c in mountable code
4258
4259       https://bugzilla.redhat.com/957772
4260           tar-out and base64-out quoting error
4261
4262       https://bugzilla.redhat.com/957380
4263           libguestfs: error: btrfsvol:/dev/sda2/root: root device not found:
4264           only call this function with a root device previously returned by
4265           guestfs_inspect_os
4266
4267       https://bugzilla.redhat.com/948324
4268           inspection fails if libosinfo is not installed
4269
4270       https://bugzilla.redhat.com/928995
4271           file on zero-sized file now produces "empty " instead of "empty"
4272
4273       https://bugzilla.redhat.com/921292
4274           qemu: could not open disk image /tmp/.../snapshot1: Permission
4275           denied
4276
4277       https://bugzilla.redhat.com/921040
4278           "error: external command failed, see earlier error messages"
4279           message needs to change
4280
4281       https://bugzilla.redhat.com/920225
4282           libguestfs should use --output json (if supported) to safely parse
4283           the output of qemu-img command
4284
4285       https://bugzilla.redhat.com/916780
4286           feature request: guestmount --with-cleanup-pipefd
4287
4288       https://bugzilla.redhat.com/914934
4289           oom-killer kills guestfsd when tar-in a lot of data
4290
4291       https://bugzilla.redhat.com/914931
4292           FileIn commands cause segfault if appliance dies during the file
4293           copy in
4294
4295       https://bugzilla.redhat.com/913145
4296           Misc leaks in virNetClientProgramCall in libvirt 1.0.2
4297
4298       https://bugzilla.redhat.com/912499
4299           Security context on image file gets reset
4300
4301       https://bugzilla.redhat.com/909836
4302           libguestfs-test-tool --qemu segfaults
4303
4304       https://bugzilla.redhat.com/909624
4305           Unexpected non-tail recursion in recv_from_daemon results in stack
4306           overflow in very long-running API calls that send progress messages
4307
4308       https://bugzilla.redhat.com/908322
4309           virt-tar fails on non-existent directory names "error in chunked
4310           encoding at /home/rjones/d/libguestfs/tools/virt-tar line 272."
4311
4312       https://bugzilla.redhat.com/908321
4313           virt-cat fails on directory names "/dev/stdout: error in chunked
4314           encoding"
4315
4316       https://bugzilla.redhat.com/907554
4317           btrfs causes subsequent ntfs-3g filesystem to fail
4318
4319       https://bugzilla.redhat.com/905341
4320           "No such file or directory" when execute "hivex-commit"
4321
4322       https://bugzilla.redhat.com/903620
4323           btrfs_subvolume_list broken due to change in subvolume list output
4324
4325       https://bugzilla.redhat.com/895910
4326           guestmount: rename() incorrectly follows symbolic links
4327
4328       https://bugzilla.redhat.com/895905
4329           guestmount: link() incorrectly returns ENOENT, when it should be
4330           EXDEV
4331
4332       https://bugzilla.redhat.com/895904
4333           checksums-out fail to compute the checksums of all regular files in
4334           directory
4335
4336       https://bugzilla.redhat.com/894545
4337           libguestfs FTBFS on Fedora 19 because of new ruby
4338
4339       https://bugzilla.redhat.com/890027
4340           virt-sysprep: Setting hostname, domain name and pretty name on
4341           Fedora 18 correctly
4342
4343       https://bugzilla.redhat.com/887971
4344           pvcreate fails if partition contains a swap signature
4345
4346       https://bugzilla.redhat.com/887520
4347           zero_free_space: open: /sysroot//ujqqq135.rd3: Cannot allocate
4348           memory
4349
4350       https://bugzilla.redhat.com/886915
4351           libguestfs with libvirt attach-method fails with odd error if
4352           default hypervisor is Xen
4353
4354       https://bugzilla.redhat.com/847549
4355           Adding a zero-length virtio-scsi disk causes: qemu-kvm:
4356           hw/scsi-bus.c:1568: scsi_req_complete: Assertion `req->status ==
4357           -1' failed.
4358
4359       https://bugzilla.redhat.com/811649
4360           libguestfs cannot open disk images which are symlinks to files that
4361           contain ':' (colon) character
4362
4363       https://bugzilla.redhat.com/664558
4364           RFE: Allow to set log callback in Ruby bindings
4365

RELEASE NOTES FOR LIBGUESTFS 1.20

4367       These release notes only cover the differences from the previous
4368       stable/dev branch split (1.18.0).  For detailed changelogs, please see
4369       the git repository, or the ChangeLog file distributed in the tarball.
4370
4371   New features
4372       libvirt and sVirt (SELinux confinement)
4373
4374       You can optionally use libvirt to launch and manage the backend
4375       appliance by:
4376
4377       ·   setting "LIBGUESTFS_ATTACH_METHOD=libvirt[:URI]"
4378
4379       ·   using "./configure --with-default-attach-method=libvirt[:URI]"
4380
4381       ·   or calling the API method "guestfs_set_attach_method"
4382
4383       SVirt (SELinux confinement) is used to secure the libguestfs appliance,
4384       if the libvirt backend is selected.
4385
4386       virtio-scsi, larger number of drives, hotplugging
4387
4388       Virtio-scsi is now used by default, if it is available.  This greatly
4389       increases the number of drives that can be added to a single libguestfs
4390       handle (up to 255).
4391
4392       You can now hotplug drives (add and remove drives after launch).
4393
4394       Libguestfs can now handle > 25 disks, in all APIs, tools and tests.
4395
4396       You can label drives when adding them, then refer to them by label
4397       (/dev/disk/guestfs/LABEL) instead of having to use device names
4398       (/dev/sda).
4399
4400       new library features
4401
4402       POSIX Access Control Lists (ACLs) and Linux filesystem capabilities can
4403       now be read and written through the API.
4404
4405       Windows Dynamic Disks are now supported.  The metadata can only be read
4406       (volumes cannot be modified or created).  However the data/filesystems
4407       in the volumes themselves can be mounted, read and written (Matthew
4408       Booth).
4409
4410       Hivex (Windows Registry editing) is now directly supported through the
4411       API, making reading or editing the Windows Registry much more
4412       efficient.
4413
4414       Several libguestfs APIs were reimplemented so they no longer have any
4415       limits on output.  The reimplemented APIs are: "guestfs_cat",
4416       "guestfs_find", "guestfs_read_file", "guestfs_read_lines",
4417       "guestfs_write", "guestfs_write_append", "guestfs_lstatlist",
4418       "guestfs_lxattrlist", "guestfs_readlinklist", "guestfs_ls".
4419
4420       virt tools
4421
4422       "guestfish touch 'win:c:\new_file'" now works as expected.
4423
4424       "guestfish" has a new --network option, which enables the user network
4425       in libguestfs.
4426
4427       You can set "GUESTFISH_PS1" to use fancy prompts in "guestfish".
4428
4429       "rsync", "ssh", "less" and "lrzip" commands are now available in virt-
4430       rescue.  In addition, "rsync" can be used through the API for doing
4431       incremental copies.
4432
4433       "virt-sparsify" uses qcow2 v3 for increased efficiency.
4434
4435       "virt-sysprep" enhancements:
4436
4437       ·   generate new UUIDs for PVs and VGs
4438
4439       ·   remove the local machine ID (Wanlong Gao)
4440
4441       ·   remove ABRT data (Wanlong Gao)
4442
4443       ·   remove puppet keys and log files (Wanlong Gao)
4444
4445       ·   remove process accounting files (Wanlong Gao)
4446
4447       ·   new --firstboot parameter allowing firstboot scripts for
4448           customizing guests
4449
4450       ·   remove HOSTNAME field from "ifcfg-eth*" files (Wanlong Gao)
4451
4452       ·   miscellaneous improvements for SuSE (Olaf Hering)
4453
4454       ·   remove man pages cache (Wanlong Gao)
4455
4456       ·   remove crash data generated by kexec-tools (Wanlong Gao)
4457
4458       "virt-make-fs" can now create virtual floppy disks (VFDs).
4459
4460       "guestmount" has a --pid-file option, which can be used to avoid a race
4461       condition between unmounting the filesystem and using the underlying
4462       disk image.
4463
4464       language bindings
4465
4466       Full-featured Lua bindings have been added in this release (thanks to
4467       Jerome Vuarand for many suggestions).
4468
4469       In Ruby, optional arguments hash is optional.
4470
4471       In Python, optional arguments now don't use special "sentinel" values,
4472       so any integer can be passed as an optional argument.
4473
4474       Erlang bindings now come with examples and tests.
4475
4476       Erlang bindings now handle 64 bit integer parameters correctly.
4477
4478       The automated 'bindtests' now test for 64 bit cleanliness in parameter
4479       passing.  Several bugs in the bindings were found and fixed as a
4480       result.
4481
4482       Better handling of blocking and non-blocking functions should make
4483       libguestfs calls more efficient.
4484
4485       inspection
4486
4487       Windows guests with unlimited-sized Registries are now supported.  By
4488       adding the hivex API to the libguestfs API, it is much more efficient
4489       and easier to inspect and modify the Windows Registry in guests.
4490
4491       Better support for SuSE guests (Olaf Hering).
4492
4493       Return the architecture of installed applications (John Eckersberg).
4494
4495       Windows 8 is now supported.
4496
4497       Fedora 18 is now supported.
4498
4499       Inspection of ISOs/CDs/DVDs can now use the libosinfo database.
4500
4501       ports
4502
4503       Libguestfs without the appliance can be compiled on Mac OS X (Masami
4504       HIRATA).
4505
4506       RHEL 5 is now explicitly supported through the 'oldlinux' branch in
4507       upstream git.
4508
4509       PowerPC 64 bit is now supported.  Also libguestfs has been examined for
4510       endianness bugs and these have been fixed.
4511
4512       daemon
4513
4514       A man page for the daemon (guestfsd(8)) is included.
4515
4516   Security
4517       guestfish history file
4518
4519       The $HOME/.guestfish history file is now created with 0600 permissions
4520       (instead of 0644 before) so it is no longer world readable.
4521
4522       CVE-2012-2690
4523
4524       Old versions of both "virt-edit" and the "guestfish" "edit" command
4525       created a new file containing the changes but did not set the
4526       permissions, etc of the new file to match the old one.  The result of
4527       this was that if you edited a security sensitive file such as
4528       /etc/shadow then it would be left world-readable after the edit.
4529
4530       This issue was assigned CVE-2012-2690, and is fixed in libguestfs ≥
4531       1.16.
4532
4533       For further information, see
4534       https://bugzilla.redhat.com/show_bug.cgi?id=788642
4535
4536   New APIs
4537        acl-delete-def-file
4538        acl-get-file
4539        acl-set-file
4540        canonical-device-name
4541        cap-get-file
4542        cap-set-file
4543        create-flags
4544        device-index
4545        disk-has-backing-file
4546        disk-format
4547        disk-virtual-size
4548        filesystem-available
4549        fill-dir
4550        fstrim
4551        get-cachedir
4552        get-libvirt-requested-credentials
4553        get-libvirt-requested-credential-prompt
4554        get-libvirt-requested-credential-challenge
4555        get-libvirt-requested-credential-defresult
4556        get-tmpdir
4557        hivex-close
4558        hivex-commit
4559        hivex-node-add-child
4560        hivex-node-children
4561        hivex-node-delete-child
4562        hivex-node-get-child
4563        hivex-node-get-value
4564        hivex-node-name
4565        hivex-node-parent
4566        hivex-node-set-value
4567        hivex-node-values
4568        hivex-open
4569        hivex-root
4570        hivex-value-key
4571        hivex-value-type
4572        hivex-value-utf8
4573        hivex-value-value
4574        inspect-list-applications2 (John Eckersberg)
4575        list-ldm-volumes
4576        list-ldm-partitions
4577        ldmtool-create-all
4578        ldmtool-diskgroup-disks
4579        ldmtool-diskgroup-name
4580        ldmtool-diskgroup-volumes
4581        ldmtool-remove-all
4582        ldmtool-scan
4583        ldmtool-scan-devices
4584        ldmtool-volume-hint
4585        ldmtool-volume-partitions
4586        ldmtool-volume-type
4587        ls0
4588        max-disks
4589        mke2fs (Wanlong Gao)
4590        mklost-and-found
4591        mkswap [added label and uuid optional arguments]
4592        mktemp (Wanlong Gao)
4593        nr-devices
4594        parse-environment
4595        parse-environment-list
4596        rm-f
4597        rsync
4598        rsync-in
4599        rsync-out
4600        set-cachedir
4601        set-libvirt-supported-credentials
4602        set-libvirt-requested-credential
4603        set-tmpdir
4604        shutdown [backported to 1.16 and 1.18]
4605        tar-in [added compress flag]
4606        tar-out [added compress, numericowner, excludes flags]
4607        umount [added force and lazy optional arguments]
4608        utsname
4609        xfs-admin (Wanlong Gao)
4610        xfs-growfs (Wanlong Gao)
4611        xfs-info (Wanlong Gao)
4612        xfs-repair (Wanlong Gao)
4613
4614       In the C API only:
4615
4616        guestfs_push_error_handler
4617        guestfs_pop_error_handler
4618
4619   Internals
4620       qemu ≥ 1.1 is required (≥ 1.2 preferred).
4621
4622       febootstrap ≥ 3.20 is required.
4623
4624       libvirt is optional, but if you want to use the new libvirt backend for
4625       launching the appliance then libvirt ≥ 0.10.2 would be required.
4626
4627       Coverity has been run over the complete codebase, and many issues fixed
4628       (thanks Ondrej Vasik, Kamil Dudka).
4629
4630       Functions which previously had no optargs can now be converted to ones
4631       with optargs, making extending the API much more flexible.  Source and
4632       binary backwards compatibility is preserved for users of the API.
4633
4634       The way that libguestfs APIs and structures are represented in the
4635       generator has changed to use an OCaml struct instead of a tuple.  This
4636       makes generator descriptions more flexible and easier to understand.
4637       For details see commits 39d1a7db and eb185eef.
4638
4639       Separation of the library code into more files:
4640
4641       ·   Launch backends are now located in separate files eg.
4642           src/launch-appliance.c, "src/launch-libvirt.c".
4643
4644       ·   Generated action code is now split over several src/action*.c
4645           files, for faster compilation.
4646
4647       ·   The huge src/guestfs.c file is now split into smaller logical
4648           units.
4649
4650       POD (documentation) is now generated using a rewritten Perl program
4651       instead of pod2* + shell scripts.
4652
4653       Man pages now contain stable dates (Hilko Bengen).
4654
4655       Skipped tests now exit with code 77, so they appear as "SKIP:" in "make
4656       check" output.
4657
4658       The parallel mount-local test has been rewritten in C (RHBZ#838081).
4659
4660       Ruby 1.8.5 is now supported (though Ruby ≥ 1.9 is preferred).
4661
4662       Perl bindings can be disabled via "./configure --disable-perl" (Wulf C.
4663       Krueger).  Note that Perl is still required in order to build
4664       libguestfs.
4665
4666       Java bindings are now enabled/disabled using "./configure --with-java"
4667       or "./configure --without-java" (Wulf C. Krueger).
4668
4669       New configure options "./configure --enable-code-profiling" and
4670       "./configure --enable-code-coverage".
4671
4672       Multiple fixes to use of 64 bit integers in language bindings.
4673
4674       The appliance backend now uses sgabios instead of vgabios (Dan
4675       Berrange).
4676
4677       The "./run" script now sets enough environment variables that you can
4678       run OCaml, Python, Ruby, Java, GJS, Erlang, Lua programs.
4679
4680       "./run --test" flag for running tests with minimal output.  It also
4681       prints the time taken to run each test.
4682
4683       The "./run" script now builds up paths cumulatively, meaning that you
4684       can use "./run" twice, or use the libguestfs and libvirt "./run"
4685       scripts together.
4686
4687       You can extract a list of external commands required by the daemon,
4688       making building the appliance on certain distros easier (Olaf Hering).
4689
4690       The "virt-rescue" command is now tested during "make check".
4691
4692       The generator now removes unused generated files.  This helps when
4693       going back and forth with git rebase, git bisect, etc.
4694
4695       Tests now run in a separate toplevel "tmp/" directory in the source.
4696       This allows the directory to be labelled for SELinux (sVirt), and also
4697       makes it easier to clean up.
4698
4699       "make syntax-check" now works to a greater extent, and many problems in
4700       the main code that were found by syntax-check have been fixed (thanks
4701       Jim Meyering).
4702
4703       Emacs mode (-*- foo -*-) has been added to generated files.
4704
4705       Progress bar output is now sent to /dev/tty so it doesn't end up in the
4706       regular output of the program.  virt-resize and virt-sparsify now
4707       suppress progress bars if stdout is not a tty.
4708
4709       There is now a "./configure --without-libvirt" option.  This is useful
4710       for testing that the code still compiles without libvirt.
4711
4712       There is now an internal mini-library for running commands.  This
4713       allows us to redirect errors from external commands into events.
4714
4715       Code for handling temporary directories and the appliance cache was
4716       completely overhauled.
4717
4718       Code for temporarily ignoring/disabling errors now looks like this:
4719
4720        guestfs_push_error_handler (g, NULL, NULL);
4721        guestfs_mkdir (g, "/foo"); /* We don't care if this fails. */
4722        guestfs_pop_error_handler (g);
4723
4724       The "tests/extra" directory has gone.  The "extra tests" are now split
4725       into separately runnable targets, such as "make check-valgrind".  Use
4726       "make help" to get a summary of the targets.
4727
4728       The "lpj" option is passed to the appliance kernel when using TCG.
4729       This should improve clock stability (thanks Marcelo Tosatti, Olaf
4730       Hering).
4731
4732   Bugs fixed
4733       https://bugzilla.redhat.com/882417
4734           libguestfs tools fail with odd error messages if TMPDIR is not an
4735           absolute path
4736
4737       https://bugzilla.redhat.com/882299
4738           Windows 8 guest disks can't be mounted: "The NTFS partition is in
4739           an unsafe state. Please resume and shutdown Windows fully (no
4740           hibernation or fast restarting), or mount the volume read-only with
4741           the 'ro' mount option."
4742
4743       https://bugzilla.redhat.com/881953
4744           libguestfs: migration to /etc/hostname, /etc/vconsole.conf,
4745           /etc/locale.conf
4746
4747       https://bugzilla.redhat.com/880801
4748           virt-df with two -a options displays incorrect disk image name
4749
4750       https://bugzilla.redhat.com/879416
4751           libguestfs-test-tool pauses when you use --help option
4752
4753       https://bugzilla.redhat.com/876579
4754           mke2fs API does not apply block device naming translation to
4755           journaldevice optarg
4756
4757       https://bugzilla.redhat.com/860235
4758           SELinux policy ought to allow qemu to write to
4759           unconfined_u:object_r:user_tmp_t:s0
4760
4761       https://bugzilla.redhat.com/859949
4762           RFE: inspect-list-applications does not return the architecture of
4763           RPM packages
4764
4765       https://bugzilla.redhat.com/859885
4766           inspect-list-applications does not list all installed RPM packages
4767           with same name and different versions
4768
4769       https://bugzilla.redhat.com/859876
4770           guestfish printed paths are not canonicalized
4771
4772       https://bugzilla.redhat.com/859875
4773           Progress bar output should go to tty(?) stderr(?)
4774
4775       https://bugzilla.redhat.com/858696
4776           virt-sysprep reports Guestfs.Error("read_lines: fopen:
4777           /etc/sysconfig/network: No such file or directory") on some Fedora
4778           guests
4779
4780       https://bugzilla.redhat.com/858128
4781           libguestfs fail to list devices added by add-drive-ro-with-if twice
4782
4783       https://bugzilla.redhat.com/858126
4784           virt-inspector fail to work with some windows guests
4785
4786       https://bugzilla.redhat.com/853762
4787           virt-sparsify should use a more robust method to detect the input
4788           format
4789
4790       https://bugzilla.redhat.com/853393
4791           libvirt doesn't label console, serial sockets
4792
4793       https://bugzilla.redhat.com/853159
4794           virt-rescue in Fedora 18 is completely broken
4795
4796       https://bugzilla.redhat.com/852394
4797           libguestfs inspection limits registries to 100 MiB
4798
4799       https://bugzilla.redhat.com/852194
4800           virt-sparsify --compress fails if output is raw format
4801
4802       https://bugzilla.redhat.com/847881
4803           RFE: allow extra arguments (like --exclude) to tar-out
4804
4805       https://bugzilla.redhat.com/847880
4806           tar-out should allow (or force) --numeric-owner
4807
4808       https://bugzilla.redhat.com/845522
4809           guestfish "copy-out / localdir" command fails with "No such file or
4810           directory"
4811
4812       https://bugzilla.redhat.com/845488
4813           Long filenames on NTFS cause tar-out, copy-out etc to fail with
4814           error "Cannot open: File name too long"
4815
4816       https://bugzilla.redhat.com/842307
4817           RFE: Need help designing and implementing selinux policy for
4818           libguestfs/sVirt
4819
4820       https://bugzilla.redhat.com/840572
4821           virt-make-fs / tar-in should support vfat properly
4822
4823       https://bugzilla.redhat.com/840115
4824           guestfish touch problem - case_sensitive_path API expects the file
4825           to exist
4826
4827       https://bugzilla.redhat.com/836710
4828           Data loss when writing to qcow2-format disk files
4829
4830       https://bugzilla.redhat.com/834712
4831           lvresize, lvresize-free fail unnecessarily if you don't change the
4832           size of the LV: "New size (nn extents) matches existing size (nn
4833           extents)"
4834
4835       https://bugzilla.redhat.com/824716
4836           compress-device-out didn't support bzip2
4837
4838       https://bugzilla.redhat.com/824043
4839           guestfish unrecognized mount option gives confusing error message
4840
4841       https://bugzilla.redhat.com/823887
4842           Filenames containing Chinese characters can't be created on vfat
4843           filesystems
4844
4845       https://bugzilla.redhat.com/823885
4846           virt-make-fs cannot create vfat filesystem containing filesystems
4847           with Chinese characters
4848
4849       https://bugzilla.redhat.com/823883
4850           virt-make-fs -t fat fails with an obscure error message
4851
4852       https://bugzilla.redhat.com/823821
4853           Inspection fails when /etc/HOSTNAME is empty
4854
4855       https://bugzilla.redhat.com/801117
4856           libguestfs cannot get icon for Windows 8
4857
4858       https://bugzilla.redhat.com/798979
4859           Ubuntu install CDs from oneiric onwards are not recognized: "multi-
4860           boot operating systems are not supported"
4861
4862       https://bugzilla.redhat.com/782167
4863           libguestfs doesn't recognize Windows Dynamic disks in some
4864           configurations, eg. spanned
4865
4866       https://bugzilla.redhat.com/713678
4867           Not all febootstrap messages are redirected to log callbacks
4868
4869       https://bugzilla.redhat.com/627675
4870           libguestfs inspector code cannot handle /dev/disk/by-id/* paths
4871
4872       https://bugzilla.redhat.com/602997
4873           part-get-bootable gives wrong result with an unordered part layout
4874

RELEASE NOTES FOR LIBGUESTFS 1.18

4876       These release notes only cover the differences from the previous
4877       stable/dev branch split (1.16.0).  For detailed changelogs, please see
4878       the git repository, or the ChangeLog file distributed in the tarball.
4879
4880   New features
4881       virt tools
4882
4883          - virt-sysprep has been rewritten and expanded (thanks Wanlong Gao)
4884            http://libguestfs.org/virt-sysprep.1.html
4885
4886          - virt-sparsify --zero is a new option that zeroes the named
4887            partition or filesystem
4888
4889          - virt-sparsify can now safely sparsify Linux swap partitions
4890
4891          - virt-sparsify fixed so it cleans up after ^C
4892            http://libguestfs.org/virt-sparsify.1.html
4893
4894          - a new tool 'libguestfs-make-fixed-appliance' is provided to build
4895            fixed appliances that can be copied to other machines that don't
4896            have febootstrap support
4897            http://libguestfs.org/libguestfs-make-fixed-appliance.1.html
4898
4899          - virt-filesystems now displays the parents (containers) of MD
4900            devices and volume groups
4901
4902          - virt-alignment-scan, run with no args, displays alignment information
4903            for all libvirt domains
4904
4905          - virt-df and virt-alignment-scan will display information from all
4906            guests even when a disk is inaccessible
4907
4908          - virt-rescue new --scratch option to make scratch disks
4909            https://rwmj.wordpress.com/2012/04/26/virt-rescue-scratch/#content
4910
4911          - virt-make-fs can now be used to create btrfs
4912
4913          - virt-edit preserves permissions, UID, GID and SELinux context
4914            when editing files
4915
4916          - guestfish passes the close event over stdout and remote correctly
4917
4918          - guestfish new '--pipe-error' option lets you detect errors in pipe
4919            commands
4920
4921          - guestfish globs now expand device names
4922
4923          - comma and colon characters in filenames now handled correctly by
4924            all virt tools
4925
4926       inspection
4927
4928          - added support for Fedora 17+
4929
4930          - added support for FreeDOS
4931
4932          - added support for Buildroot and Cirros
4933
4934          - inspection is now compatible with Windows guests that have been
4935            sysprepped (thanks Grant Williamson).
4936
4937       API
4938
4939          - broad support for btrfs added, including adding multiple devices,
4940            fsck, snapshots (thanks Wanlong Gao)
4941
4942          - the new 'mount-local' API brings FUSE support directly into the
4943            core libguestfs API
4944            https://rwmj.wordpress.com/2012/05/14/tip-using-mount-local-api-from-c/#content
4945
4946          - new man page: guestfs-performance(1), which contains performance
4947            tuning tips
4948            http://libguestfs.org/guestfs-performance.1.html
4949
4950          - new man page: guestfs-faq(1), Frequently Asked Questions
4951            http://libguestfs.org/guestfs-faq.1.html
4952
4953          - ENOTSUP (from guestfs_last_errno) is now returned for APIs that
4954            are not supported
4955
4956       examples
4957
4958          - 'copy_over' example showing how to copy between two handles
4959
4960          - 'display_icon' program displays the icon associated with a guest
4961
4962          - 'mount_local.c' example shows how to use the mount-local API
4963
4964   Security
4965         (no security problems were found or fixed in this release)
4966
4967   New APIs
4968         btrfs-device-add: Add devices to a btrfs filesystem.
4969         btrfs-device-delete: Remove devices from a btrfs filesystem.
4970         btrfs-filesystem-sync: Sync a btrfs filesystem.
4971         btrfs-filesystem-balance: Balance a btrfs filesystem.
4972         btrfs-fsck: Check btrfs filesystem.
4973         btrfs-set-seeding: Enable or disable seeding.
4974         btrfs-subvolume-create: Create a btrfs snapshot.
4975         btrfs-subvolume-delete: Delete a btrfs snapshot.
4976         btrfs-subvolume-list: List btrfs snapshots and subvolumes.
4977         btrfs-subvolume-set-default: Set default btrfs subvolume.
4978         btrfs-subvolume-snapshot: Create a writable btrfs snapshot.
4979         get-e2attrs: List ext2 file attributes of a file.
4980         get-e2generation: Get ext2 file generation of a file.
4981         isoinfo, isoinfo-device: Get information from the header of ISO files.
4982         llz: List files with SELinux information.
4983         lvcreate-free: Create an LVM logical volume in % remaining free space.
4984         md-stat: Return underlying devices from an MD device.
4985         mkfs-brtfs: Make btrfs filesystem, with all tunables.
4986         mount-local, mount-local-run, umount-local: FUSE support in the API.
4987         ntfsclone-in, ntfsclone-out: Save, restore NTFS from backup.
4988         ntfsfix: Fix common errors and force Windows to check NTFS.
4989         set-e2attrs: Set or clear ext2 file attributes of a file.
4990         set-e2generation: Set ext2 file generation of a file.
4991         set-label: Unified interface for setting filesystem label.
4992         vgmeta: Get volume group metadata.
4993         wipefs: Wipe filesystem signatures from a device.
4994         zero-free-space: Zero free space in a filesystem.
4995
4996   Internals
4997        - The debian/ subdirectory has been removed.  We recommend you use
4998          the official Debian packages made by Hilko Bengen.
4999          http://people.debian.org/~bengen/libguestfs/
5000          http://packages.debian.org/search?keywords=libguestfs
5001
5002        - O_CLOEXEC / SOCK_CLOEXEC is now used for almost all file
5003          descriptors that the library opens.
5004
5005        - posix_fadvise is called when sequentially reading or writing large
5006          files.
5007
5008        - close all file descriptors and remove all signal handlers in the
5009          recovery process
5010
5011        - multiple gcc warnings and Coverity bugs have been fixed;  many
5012          strict-overflow bugs have also been fixed
5013
5014        - use ./configure --enable-valgrind-daemon to use valgrind on the
5015          daemon;  many errors have been fixed
5016
5017        - use ./configure --with-qemu-options to pass extra options to qemu
5018
5019        - the daemon now has a growable strings buffer type (DECLARE_STRINGSBUF)
5020
5021        - the <guestfs.h> header file works with C++ and we have a regression
5022          test for this
5023
5024        - multiple APIs which should only be called in the CONFIG state now
5025          give an error if they are not
5026
5027        - .gitignore fixed to use absolute paths
5028
5029        - gobject bindings have been expanded, including mapping libguestfs
5030          events to gobject signals (thanks Matt Booth)
5031
5032        - gobject documentation is generated properly (thanks Matt Booth)
5033
5034        - gobject header files now live in a subdirectory
5035
5036        - CompareWithString test in the generator now works
5037
5038        - FUInt32, FUInt64 struct field types now use the correct XDR type
5039
5040        - OCaml tests are now run on bytecode and native code.
5041
5042        - java -Xlint:all is used, and all warnings have been fixed
5043
5044        - bmptopng, wrestool (etc) missing or failure no longer prints
5045          warning messages
5046
5047        - ruby: Use RbConfig instead of Config.
5048
5049        - PYTHONPATH is set by the ./run script.
5050
5051        - appliance building is now thread-safe.
5052
5053        - appliance now uses 'ip' instead of 'ifconfig' and 'netstat'
5054          commands
5055
5056        - several fixes to make parallel builds work properly
5057
5058        - guestfish --listen now cleans up properly
5059
5060        - the BUSY state has been removed
5061
5062        - gettextize has been removed, replaced by a simple Makefile.am
5063
5064        - gettext support now covers virt-resize, virt-sparsify and virt-sysprep
5065
5066        - better support for the arm architecture
5067
5068   Bugs fixed
5069        - 822490 virt-ls error: "libguestfs: error: checksum: path: parameter cannot be NULL"
5070        - 816839 data overflow error when debug progress -1
5071        - 816098 virt-make-fs fails to make a btrfs filesystem because it doesn't allocate enough space
5072        - 811872 inspection fails on ubuntu 10.04 guest with encrypted swap
5073        - 811650 guestfs_last_error not set when qemu fails early during launch
5074        - 811649 libguestfs cannot open disk images which are symlinks to files that contain ':' (colon) character
5075        - 811117 [RFE][virt-sysprep] net-hwaddr not removed from "ifcfg-*" files on rhel
5076        - 811112 [RFE][virt-sysprep] hostname can not be changed on rhel system
5077        - 809361 inspection doesn't recognize Fedora 18 (grub2 + GPT)
5078        - 807905 mkfs blocksize option breaks when creating btrfs
5079        - 805070 virt-filesystems should show 'parents' of LV and RAID devices
5080        - 804464 libguestfs cannot be built when LINGUAS is different then ja or uk
5081        - 803664 libguestfs inspection fails on Windows XP: libguestfs: error: hivex: could not locate HKLM\SYSTEM\MountedDevices
5082        - 803533 guestfish: write error
5083        - 802389 event handlers for 'close' event doesn't work in remote mode
5084        - 802109 libguestfs uses putc on stderr, results in many individual 1 byte writes of debug messages
5085        - 801640 [RFE] the error reported by resize2fs-M need to be more clear
5086        - 801298 Possible null dereference and resource leaks
5087        - 801273 Document for set-pgroup need to be updated
5088        - 798196 virt-resize confuses format and output_format variables; using --output-format sets the input format
5089        - 797986 virt-resize on Windows XP in sysprep state causes "UNMOUNTABLE_BOOT_VOLUME" BSOD
5090        - 796520 [RFE] Prevent user from running some appliance configure commands after appliance boot up
5091        - 790721 multiprovider build error: RuntimeError: link: /tmp/.guestfs-0/kernel /tmp/.guestfs-0/kernel.10139: File exists
5092        - 789960 guestfsd crash when try to mount non-exist disk
5093        - 789504 virt-df (other tools?) should not give up if a guest disk is missing
5094        - 788641 virt-edit doesn't preserve file permissions
5095        - 786215 libguestfs inspection does not recognize FreeDOS operating system
5096        - 786188 libguestfs inspection does not recognize FreeDOS install CD
5097        - 785668 aug-defnode: daemon crash
5098        - 784647 Libguestfs uses deprecated net-tools
5099        - 769304 virt-resize on RHEL 6 kernel fails to re-read the partition table
5100        - 755729 Error message for resize2fs-M needs tweaking
5101        - 701814 virt-win-reg fails on a libvirt guest that has no defined disk format: "format parameter is empty or contains disallowed characters"
5102        - 679737 libguestfs: improve error message when zerofree is not available in the appliance
5103        - 635971 glob mkfs ext2 /dev/vd[b-t]1 does not expand
5104

RELEASE NOTES FOR LIBGUESTFS 1.16

5106       These release notes only cover the differences from the previous
5107       stable/dev branch split (1.14.0).  For detailed changelogs, please see
5108       the git repository, or the ChangeLog file distributed in the tarball.
5109
5110   New features
5111       libguestfs
5112
5113          - allow XFS filesystems to be created over an existing filesystem
5114            (Wanlong Gao)
5115
5116          - the (unspecified) default alignment for part-disk has been
5117            changed to 64K for better support of high-end network-attached
5118            storage
5119
5120          - new guestfs-testing(1) man page
5121
5122          - list-filesystems returns MD devices containing filesystems
5123            (Matthew Booth)
5124
5125          - support for GCC >= 4.7 (Jim Meyering)
5126
5127          - check user does not add the same drive twice (Wanlong Gao).
5128
5129       language bindings
5130
5131          - Experimental GObject bindings, with support for GObject
5132            Introspection.  You can now use libguestfs from Javascript.
5133            Please note these are not stable and final in this release.
5134            (Matthew Booth).
5135
5136          - support for Ruby >= 1.9
5137
5138          - Ruby bindings can be disabled individually (Hilko Bengen)
5139
5140          - support for Python 2.6, 3.x (Richard Jones, Hilko Bengen)
5141
5142          - support for PHP >= 5.4
5143
5144          - new %guestfs_introspection hash is available in Perl bindings so
5145            you can query which optional arguments are available
5146
5147       inspection
5148
5149          - guests with MD devices can be inspected (Matthew Booth)
5150
5151          - support for GNU/Hurd guests
5152
5153       guestfish
5154
5155          - libguestfs events (such as progress bar events and log messages) can
5156            be trapped and processed by user-defined shell scripts.
5157
5158          - MD devices are tab-completed (Matthew Booth)
5159
5160       virt tools
5161
5162          - New tool virt-format for erasing and making blank disks
5163
5164          - virt-sparsify new --compress and -o options to allow for compressed
5165            and different format output
5166
5167          - virt-sparsify can now detect and sparsify .vdi files
5168
5169          - virt-sysprep no longer requires xmlstarlet; a new virt-inspector --xpath
5170            option has been added to replace this functionality
5171
5172          - virt-rescue has a new --suggest option which suggests mount commands
5173            for the guest
5174
5175          - virt-resize no longer requires OCaml pcre library
5176
5177       libguestfs live
5178
5179          - daemon will no longer try to edit your live /etc/lvm configuration
5180
5181          - fix a potential security problem with predictable /tmp names (Steve Kemp)
5182
5183   Security
5184         CVE-2011-4127, RHBZ#757071
5185         Mitigate possible privilege escalation via SG_IO ioctl
5186         For more information, see: https://github.com/libguestfs/libguestfs/commit/9a5f784d511a8f00a8386f316eab41fe660430db
5187
5188   New APIs
5189         blkid: print all attributes of a device known to blkid (Wanlong Gao)
5190         e2fsck: access to more features of e2fsck (Wanlong Gao)
5191         list-md-devices: list of Linux MD devices (Matthew Booth)
5192         md-create: create an MD device
5193         md-detail: returns metadata for an MD device (Matthew Booth)
5194         md-stop: stop an MD device (Wanlong Gao)
5195         tune2fs: allow ext2/3/4 filesystems to be tuned
5196
5197   Internals
5198         Git hosting has moved to http://github.com/libguestfs
5199
5200         The various test directories have been rearranged logically, and now
5201         all appear under 'tests/'.
5202
5203         There is a 'make extra-tests' rule which runs ordinary tests and
5204         additional tests, using valgrind to check for memory problems.
5205
5206         Multiple memory leaks and other problems found by valgrind and fixed.
5207
5208         Support for optional arguments in the generator has been rewritten
5209         to provide more features and safety (Matthew Booth).
5210
5211         With gcc -fvisibility=hidden is used for internal symbols, avoiding
5212         call indirection via the PLT.
5213
5214         RHashtable functions can be tested in the generator.
5215
5216         ADD_ARG macro in daemon allows arg lists to be constructed without
5217         risk of stack smashing.
5218
5219         Fix generation of OCaml functions that have more than 10 arguments.
5220
5221         psmisc has been added to the appliance, allowing use of 'fuser',
5222         'killall' and 'pstree' for debugging.
5223
5224         bindtests now cover RBufferOut and optional arguments (Matthew Booth).
5225
5226   Bugs fixed
5227        - 769680 temporary directories created during appliance builds are not cleaned up on error
5228        - 761460 guestfs_utimens hangs on named pipes
5229        - 761451 guestfs_utimens cannot set times on a directory
5230        - 760775 "guestfish: multi-boot operating systems are not supported by the -i option" should be more explanatory
5231        - 760669 guestfish copy-in and <! (inline execution) don't mix well: pclose: No child processes
5232        - 760000 libguestfs fails to compile with Ruby >= 1.9
5233        - 755729 Error message for resize2fs-M needs tweaking
5234        - 750889 Python code incompatible with Python v3.
5235        - 596761 Ctrl-\ causes guestfish to abort
5236

RELEASE NOTES FOR LIBGUESTFS 1.14

5238       These release notes only cover the differences from the previous
5239       stable/dev branch split (1.12.0).  For detailed changelogs, please see
5240       the git repository, or the ChangeLog file distributed in the tarball.
5241
5242   New features
5243         Erlang bindings.
5244
5245         virt-alignment-scan is a new tool to check the alignment of
5246         partitions within virtual machines or disk images.
5247
5248         virt-sparsify is a new tool to make virtual machine disk images
5249         sparse.
5250
5251         virt-sysprep is a new tool to make cloning guests from a template
5252         simpler.
5253
5254       guestfish
5255
5256          - New commands setenv, unsetenv, to set environment variables.
5257
5258          - The input file and line number is printed in error messages.
5259
5260          - guestfish progress bars are now a "mini-library" used by other
5261            tools too.
5262
5263       guestmount
5264
5265          - the --live option (for access to live VMs) now works.
5266
5267       virt-cat
5268
5269          - virt-cat can now handle Windows paths and drive letters (RHBZ#693359).
5270
5271       virt-filesystems
5272
5273          - the MBR partition type byte is displayed in --long output.
5274
5275       virt-make-fs
5276
5277          - virt-make-fs now sets the MBR partition type byte correctly,
5278            improving compatibility with Windows (RHBZ#746295).
5279
5280       virt-resize
5281
5282          - virt-resize can now work with guests using extended and logical
5283            partitions, in particular Ubuntu guests.
5284
5285          - virt-resize can now align the first partition of Windows guests,
5286            improving performance.  The new virt-resize --align-first option
5287            controls this behaviour.
5288
5289          - The virt-resize --machine-readable flag makes it possible to use
5290            virt-resize from other programs.
5291
5292          - Partitions are now aligned to 128 sectors (usually 64K) by
5293            default.  This improves efficiency on high-end storage.  The new
5294            virt-resize --alignment option allows the alignment to be
5295            adjusted.
5296
5297       virt-win-reg
5298
5299          - The syntax for deleting registry keys and values is documented
5300            in the man page (RHBZ#737944).
5301
5302       library
5303
5304          - non-printing characters are escaped correctly in debug output.
5305
5306          - GUESTFS_EVENT_ENTER is a new event type generated whenever a
5307            libguestfs function is called.
5308
5309          - the library contains systemtap/DTrace probes.
5310
5311          - the library can now be compiled without hivex (RHBZ#723474).
5312
5313       inspection
5314
5315          - Improve detection of Windows disks.
5316
5317          - Adds support for:
5318                ttylinux - a minimal Linux
5319                Mageia (thanks Michael Scherer)
5320                OpenSUSE and zypper (thanks Michael Scherer, Vincent Untz)
5321                Ubuntu logos (thanks Michael Scherer)
5322                NetBSD and pkgsrc (thanks Michael Scherer)
5323
5324          - Handle some guest types that use /dev/root in /etc/fstab.
5325
5326          - Fix handling of guests with > 26 disks (thanks Matthew Booth)
5327
5328          - Add support for guests with HP Smart Array disks (thanks Matthew Booth)
5329
5330       febootstrap
5331
5332          - FEBOOTSTRAP_KERNEL, FEBOOTSTRAP_MODULES environment variables can
5333            be set in order to choose which kernel to use for the appliance.
5334
5335       misc
5336
5337          - ArchLinux support now working with Linux 3.0 (thanks Erik Nolte)
5338
5339          - libvirt disks marked <readonly/> are now added readonly when
5340            using the virt-tools '-d' option.
5341
5342   Security
5343         (no security problems were found or fixed in this release)
5344
5345   New APIs
5346         compress-out, compress-device-out, copy-device-to-device,
5347         copy-device-to-file, copy-file-to-device, copy-file-to-file,
5348         get-smp, part-to-partnum, set-smp.
5349
5350         The mount API no longer implicitly adds -o sync,noatime options.
5351
5352         add-domain has a new 'readonlydisk' optional parameter to control
5353         how <readonly/> disks are handled.
5354
5355   Internals
5356        - Coverity was run on the source and more bugs were identified and
5357          fixed.
5358
5359        - PCRE library is now required to build libguestfs.
5360
5361        - APIC is now the default for the appliance.  You can also enable
5362          SMP support in the appliance.
5363
5364        - OCaml bindings now correctly acquire GC lock during callbacks.
5365
5366        - Out of tree builds should now work correctly (thanks Hilko Bengen).
5367
5368        - ./configure --with-extra="..." can be used by packagers to set
5369          the extra version string.
5370
5371        - zero, zero-device APIs: if the blocks already contain zeroes,
5372          don't write zeroes, so that we don't unnecessarily make the
5373          underlying storage non-sparse.
5374
5375        - is-zero, is-zero-device APIs: optimize these so zero detection is
5376          faster.
5377
5378   Bugs fixed
5379        - 748266 libguestfs should detect versions of qemu which require -machine pc option
5380        - 747290 libguestfs ignores <readonly/> in libvirt XML
5381        - 747287 Misleading error message when permission denied opening a disk image
5382        - 746295 virt-make-fs doesn't set partition ID
5383        - 744795 guestmount --live is not usable
5384        - 737944 virt-win-reg hyphen (delete key) syntax may be wrong, and is not documented
5385        - 733297 ruby event handlers fail with "exception in callback: wrong argument type Proc (expected Data)"
5386        - 731744 libguestfs should escape special/non-printing characters in debug output
5387        - 729887 appliance crashes running aug_init with flags=4
5388        - 729075 libguestfs confuses Hp_recovery partition with Windows root filesystem
5389        - 727178 error: luks_open: cryptsetup: error while loading shared libraries: libfipscheck.so.1: cannot open shared object file: No such file or directory
5390        - 726739 libguestfs: error: aug_get: no matching node, trying to find hostname
5391        - 723474 If hivex and/or pcre not installed, libguestfs fails to compile
5392        - 693359 virt-cat and virt-edit don't handle case sensitive NTFS paths properly
5393        - 678231 virt-inspector reports unknown filesystem UUID
5394        - 671082 libguestfs does not work with kernel-rt
5395        - 666578 libguestfs: unknown filesystem label SWAP-sda2
5396        - 642821 virt-resize falls over on a disk image with a logical swap partition
5397

RELEASE NOTES FOR LIBGUESTFS 1.12

5399       These release notes only cover the differences from the previous
5400       stable/dev branch split (1.10.0).  For detailed changelogs, please see
5401       the git repository, or the ChangeLog file distributed in the tarball.
5402
5403   New features
5404       guestfish
5405
5406          - guestfish strings can use escapes,
5407            eg. ><fs> write /foo "line 1\nline 2\n"
5408
5409          - guestfish write-append command can be used to append to files.
5410
5411          - Long-running file uploads and downloads can be cancelled through the
5412            API or by hitting ^C in guestfish.
5413
5414          - New guestfish "display" command for displaying graphical files
5415            inside guests.
5416
5417          - In guestfish, tab completion now works on /dev/mapper devices.
5418
5419       virt-inspector
5420
5421          - Inspection API can get an icon or logo for certain guests.
5422
5423          - virt-inspector includes the logo and hostname for certain guests.
5424
5425          - virt-inspector can now get the version and release numbers for RPM
5426            packages.
5427
5428          - CentOS and Scientific Linux are now treated as separate distros by
5429            the inspection API.
5430
5431       virt-resize
5432
5433          - virt-resize can now handle btrfs.
5434
5435          - New virt-resize --ntfsresize-force option allows Windows VMs to be
5436            resized multiple times.
5437
5438       other virt tools
5439
5440          - guestfish, guestmount, virt-cat, virt-df, virt-edit, virt-filesystems,
5441            virt-inspector, virt-ls and virt-rescue now allow you to use
5442            "-d UUID" option to specify a guest by UUID.  This makes them more
5443            robust to use from other programs.
5444
5445          - virt-ls -lR option allows complex file iteration and guest analysis.
5446
5447          - virt-win-reg supports HKEY_USERS\<SID> and HKEY_USERS\<username>.
5448
5449          - virt-win-reg new option --unsafe-printable-strings allows printable
5450            strings to be displayed in the output (unsafely: read the documentation
5451            before using).
5452
5453          - virt-edit has been rewritten in C.
5454
5455       API and language bindings
5456
5457          - Java is now completely supported.
5458            See http://libguestfs.org/guestfs-java.3.html
5459
5460          - JRuby is supported via the Java bindings.
5461
5462          - guestfs_close now appears in trace messages.
5463
5464          - Python binding adds explicit g.close() method.
5465
5466          - Python programs can now use the new event API.
5467
5468          - Python GIL is released during libguestfs calls, allowing multithreaded
5469            Python programs to work properly.
5470
5471          - 9pfs (Plan 9 filesystems exported from the host) are now supported.
5472
5473          - Add -DGUESTFS_WARN_DEPRECATED=1 to warn about use of deprecated API
5474            functions in C programs.
5475
5476          - New manual page guestfs-recipes(1) with recipes.
5477
5478          - mkfs-opts can now set inode size and sector size on created filesystems
5479            (thanks Nikita Menkovich).
5480
5481          - guestfs_last_errno is now accessible from OCaml (as g#last_errno ()).
5482
5483   Security
5484        - optargs_bitmask is checked even for calls that have no optional
5485          arguments.  This closes a possible exploit in the daemon from
5486          untrusted callers.
5487
5488   New APIs
5489         btrfs-filesystem-resize, get-pgroup, inspect-get-icon, is-zero,
5490         is-zero-device, list-9p, list-dm-devices, mount-9p, ntfsresize-opts,
5491         set-pgroup, write-append
5492
5493   Internals
5494        - Coverity (a static analysis tool) was run across the codebase and
5495          many fixes were made.
5496
5497        - Generator can handle functions that return RBufferOut and have
5498          optional arguments.
5499
5500        - Compatible with Perl 5.14.
5501
5502        - Compatible with gcc 4.6.
5503
5504        - Perform safety checks on QEMU.
5505
5506        - C API tests can now fully test calls that have optional arguments.
5507
5508        - Use ./configure --enable-install-daemon to install /usr/sbin/guestfsd.
5509
5510        - po-docs directory now covers all man pages.
5511
5512        - stderr from qemu process is now captured by the event subsystem.
5513
5514   Bugs fixed
5515        - 602997 part-get-bootable gives wrong result with an unordered part layout
5516        - 661280 virt-rescue: panic when shutting down: "/sbin/reboot: No such file or directory"
5517        - 700369 qemu-system-x86_64 says 'KVM not supported for this target'
5518        - 705200 guestmount attempt results in access denied
5519        - 714981 'list-filesystems' does not know about virtio 9p filesystems or detect existing mounts
5520        - 717786 libguestfs python bindings should have an explicit close call
5521        - 721275 virt-resize in F16 should support btrfs
5522

Release notes for libguestfs 1.10.0

5524       These release notes only cover the differences from the previous
5525       stable/dev branch split (1.8.0).  For detailed changelogs, please see
5526       the git repository, or the ChangeLog file distributed in the tarball.
5527
5528   New features
5529        - libguestfs and tools can be used against live virtual machines.
5530          See the 'guestfish --live' and 'guestmount --live' options, and (for
5531          the low-level interface) the new APIs set-attach-method and
5532          get-attach-method.
5533
5534        - New virt tools:
5535          virt-copy-in, virt-copy-out, virt-tar-in, virt-tar-out.
5536
5537        - libguestfs can get the drive letter mappings for Windows guests.
5538
5539        - virt-inspector displays drive letter mappings for Windows guests.
5540
5541        - Drive letters can now be used in virt-edit and guestfish programs
5542          when operating on Windows guests.
5543
5544        - virt-resize now works on 32 bit hosts.
5545
5546        - You can now inspect the install disks and live CDs of many different
5547          operating systems.
5548
5549        - guestfish <! cmd which executes a shell cmd and inlines the result.
5550
5551        - guestfish, guestmount, virt-rescue now all support --ro and --rw
5552          options, and the default for this can be chosen via a configuration
5553          file (/etc/libguestfs-tools.conf).
5554
5555        - New event API allows more than one callback to be registered for
5556          each event, makes it possible to call the API from other languages,
5557          and allows nearly all log, debug and trace messages to be rerouted
5558          from stderr.
5559
5560        - Greater FHS compliance for temporary files, including using /var/tmp
5561          for large cached files that should survive reboot (instead of /tmp).
5562
5563        - guestfish, guestmount -m option allows mount options to be passed
5564          through to the underlying filesystem.
5565
5566        - mkfs-opts allows filesystem features to be specified.
5567
5568        - More intelligent handling of mountpoints, allowing mkmountpoint, mount
5569          and umount-all commands to work together properly.
5570
5571        - Trace messages are prefixed with a distinct string, allowing them to
5572          be easily 'grepped' out from debug output.
5573
5574        - guestfs_launch (guestfish 'run' command) now produces progress
5575          messages (a guestfish progress bar) if it takes longer than 5
5576          seconds to run.
5577
5578        - Several long-running commands where we are unable to estimate time
5579          to completion generate "pulse mode" progress events.  Progress bar
5580          in guestfish has been updated to display these.
5581
5582        - Publish new example code in: C, Perl, Python, OCaml, Ruby.
5583
5584        - New virt-dhcp-address example program.
5585
5586        - The Java and Ruby bindings have been improved greatly.
5587
5588        - Perl includes a way to get the errno of the last error.
5589
5590        - Python bindings now compatible with rpyc (thanks Erez Shinan).
5591
5592        - Transifex is now being used to manage translations.
5593          http://www.transifex.net/projects/p/libguestfs/
5594
5595        - Inspection now supports Red Hat Desktop, Slackware distributions.
5596
5597        - Inspection no longer fails for Windows guests that have two or
5598          more disks.
5599
5600        - Inspection can now tell the difference between Windows 2008 Server
5601          and Windows 7.
5602
5603        - Inspection can detect 32 bit applications installed in 64 bit
5604          Windows, running on the WOW64 emulator.
5605
5606        - A series of protocol fixes has fixed the old bug RHBZ#576879
5607          which used to cause errors during the upload command to lose
5608          protocol synchronization.
5609
5610        - New logo!
5611
5612   Security
5613         [none]
5614
5615   New APIs
5616         first-private, get-attach-method, inspect-get-drive-mappings,
5617         inspect-get-product-variant,
5618         inspect-get-windows-current-control-set, next-private, resize2fs-M,
5619         set-attach-method.
5620
5621   Internals
5622        - The 'HACKING' file is obsolete.  The contents have been moved into
5623          a section of the guestfs(3) manual page.
5624
5625        - libguestfs-test-tool simplified.  It no longer needs the static
5626          binary or tries to construct an ISO.
5627
5628        - rpcgen-generated files are compiled with -fno-strict-aliasing
5629          which should be safer (thanks Matt Booth).
5630
5631        - virt-resize was rewritten in OCaml.
5632
5633        - guestfish and other tools tested with valgrind; some memory leaks
5634          were fixed.
5635
5636   Bugs fixed
5637        - 502533 Updated Polish translation of libguestfs
5638        - 576879 libguestfs protocol loses synchronization if you 'upload' before mounting disks
5639        - 599503 document that mkmountpoint and umount-all cannot be mixed
5640        - 617440 guestfish: fails to tilde expand '~' when the $HOME env is unset
5641        - 664558 RFE: Allow to set log callback in Ruby bindings
5642        - 665358 Punjabi Translation Completed (pa_IN)
5643        - 666577 libguestfs: unknown filesystem /dev/fd0
5644        - 667610 Multiple bugs, memory leaks in libguestfs ruby bindings
5645        - 668112 virt-filesystems command fails on guest with corrupt filesystem label
5646        - 668574 guestfish -i is trying to mount all mounts from /etc/fstab and fails with an error when device doesn't exists
5647        - 673479 Add a grep-friendly string to LIBGUESTFS_TRACE output
5648        - 674130 Inspection code fails for Windows guest with two disks
5649        - 682756 libguestfs trace segfaults when list-filesystems returns error
5650        - 682979 libguestfs incorrectly detects Red Hat desktop as 'redhat-based' instead of 'redhat'
5651        - 690819 mkfs fails creating a filesystem on a disk device when using a disk with 'ide' interface
5652        - 691389 Extended attributes don't work over guestmount (FUSE)
5653        - 691724 virt-inspector reports unknown filesystem /dev/vda1
5654        - 692545 inspect-list-applications fails to detect 32 bit apps installed under WOW64 emulator on 64 bit Windows
5655        - 693324 sfdisk's python interface only accepts lists of type 'list' for the lines parameter
5656

Release notes for libguestfs 1.8

5658       These release notes only cover the differences from the previous
5659       stable/dev branch split (1.6.0).  For detailed changelogs, please see
5660       the git repository, or the ChangeLog file distributed in the tarball.
5661
5662   New features
5663        - Support and packages for Debian and Ubuntu.
5664
5665        - Daily builds from git repository on Debian and Ubuntu to reduce risk
5666          of regressions.
5667
5668        - Port to ArchLinux 'pacman' (thanks Thomas S Hatch).
5669
5670        - The following tools have been rewritten in C (originally in Perl):
5671
5672            . virt-cat
5673            . virt-df
5674            . virt-inspector
5675            . virt-ls
5676            . virt-rescue
5677
5678        - Some C tools support encrypted guests automatically.  This is
5679          supported in: guestfish, guestmount, virt-cat, virt-inspector,
5680          virt-ls.
5681
5682        - New tool virt-filesystems (in C) which is a replacement for
5683          virt-list-filesystems and virt-list-partitions, and has a superset
5684          of the functionality of those tools.
5685
5686        - guestfish, guestmount and the C tools use unified command line option
5687          parsing, so they support many common options such as '-a disk.img',
5688          '-d libvirt-domain', '-x', '-v'.  The old command line option
5689          parsing is preserved for compatibility in scripts etc.
5690
5691        - guestfish no longer has any dependencies on Perl
5692
5693        - New man pages containing programming examples: guestfs-examples(3) (C/C++),
5694          guestfs-ocaml(3), guestfs-python(3), guestfs-ruby(3).
5695
5696        - Trace mode prints return values from API functions.
5697
5698        - virt-inspector can list applications installed in Windows guests, along
5699          with a great deal of information about those applications.
5700
5701        - Add support for inspecting: Linux Mint, Mandriva, FreeBSD.
5702
5703        - guestfish --rw option (with no effect currently) to make potentially
5704          dangerous write access explicit.
5705
5706        - guestfish --listen --csh for compatibility with csh, tcsh (thanks
5707          Eric Blake).
5708
5709        - The first upstream version that introduced each API function is now
5710          documented in guestfs(3).
5711
5712        - guestfs_last_errno allows you to retrieve the errno from the
5713          daemon, correctly translated to the local operating system.
5714
5715        - Functions can now have optional parameters.
5716
5717        - Progress bars and progress notifications can now happen for upload
5718          commands.
5719
5720        - Appliance builder more careful about not leaving temporary files
5721          around in /tmp.
5722
5723        - getfattr/setfattr commands added to virt-rescue.
5724
5725        - ROADMAP file covers roadmap and goals for future releases.
5726
5727   Security
5728        - New SECURITY section in guestfs(3) API documentation.
5729
5730        - virt-inspector no longer runs any guest commands.
5731
5732        - Inspection code is more careful about avoiding very large files
5733          from guests which might previously have caused a denial of service.
5734
5735        - FUSE calls into guestmount are now traced when using guestmount -x.
5736
5737   New APIs
5738        - add-domain
5739        - add-drive-opts
5740        - getxattr
5741        - inspect-get-hostname
5742        - inspect-get-package-format
5743        - inspect-get-package-management
5744        - inspect-get-roots
5745        - inspect-list-applications
5746        - lgetxattr
5747        - mkfs-opts
5748
5749   Internals
5750        - C programs now only link precisely with the libraries that they use.
5751
5752        - PCRE, libmagic, hivex and libvirt libraries are now completely
5753          optional for building.
5754
5755        - Multiple memory leaks and file descriptor leaks fixed.
5756
5757        - Add a POD wrapper to unify generation of man pages and HTML files
5758          across all programs.
5759
5760        - Source includes phony images of Fedora, Debian, Ubuntu and
5761          Windows guests.
5762
5763        - Ruby bindings have 'make install' rule.
5764
5765        - <guestfs.h> is now a single file.
5766
5767        - <guestfs.h> does not require XDR headers.
5768
5769        - ocaml xml-light library is no longer required to build (thanks
5770          Maxim Koltsov).
5771
5772        - ./configure --disable-[...] for each language binding (thanks
5773          Maxim Koltsov).
5774
5775        - Old ocaml-viewer program removed (use guestfs-browser instead).
5776
5777        - New C API test type 'InitScratchFS' makes the tests run a little
5778          more quickly.
5779
5780        - Excluded packages in the appliance are now listed in a separate
5781          file appliance/excludelist.in, and can be customized per-distro.
5782
5783   Bugs fixed
5784        - 663407 readlink and readlinklist returns /sysroot/ in some paths
5785        - 661280 virt-rescue: panic when shutting down: "/sbin/reboot: No such file or directory"
5786        - 657499 checksum: wrong check sum type causes umount to fail
5787        - 655554 Whole disk paths are not made canonical by virt-inspector
5788        - 654638 openssl updated to 1.0.0b libguestfs depends on exact file names
5789        - 652796 ruby bindings not installed by 'make install', hence omitted from the binary distribution
5790

RELEASE NOTES FOR LIBGUESTFS 1.6

5792       These release notes only cover the differences from the previous
5793       stable/dev branch split (1.4.0).  For detailed changelogs, please see
5794       the git repository, or the ChangeLog file distributed in the tarball.
5795
5796   New features
5797        - Use a new method for creating and caching the appliance.  This
5798          greatly improves the performance of libguestfs, often by a factor
5799          of x 4 to x 5.
5800
5801        - Support for guest inspection (like virt-inspector) via the ordinary
5802          API and all language bindings.  'guestfish -i' option is as a side-
5803          effect much quicker.
5804
5805        - virt-inspector and core inspection API can now detect guests running:
5806          Fedora, Debian, Ubuntu, Windows, Red Hat Enterprise Linux, CentOS,
5807          Scientific Linux, Gentoo, Pardus, Arch Linux, MeeGo.
5808
5809        - Support for LUKS whole-disk encryption in guests.
5810
5811        - PHP bindings.
5812
5813        - Progress messages (and progress bars in guestfish and virt-resize)
5814          for certain long-running operations.
5815
5816        - virt-df is now much more efficient.  Use '--one-per-guest' to restore
5817          the old per-guest isolation behaviour.
5818
5819        - guestfish 'copy-in' and 'copy-out' commands for copying files and
5820          directories recursively in and out of the guest.
5821
5822        - guestfish 'hexedit' command for doing binary edits to devices and
5823          files.
5824
5825        - Change guestfish -i syntax to allow commands to be specified on the
5826          command line (retaining backwards compatibility).
5827
5828        - guestfish '-d <domain>' for adding disks from libvirt domains.
5829
5830        - guestfish '-N' option supports several new prepared disk image types:
5831                lvfs : disk with LV formatted with filesystem
5832                  lv : disk with LV
5833            bootroot : boot+root
5834          bootrootlv : boot and root on LV
5835
5836        - guestfish 'more' and 'edit' commands now work with arbitrary files.
5837
5838        - guestfish '--echo-keys' option allows you to echo keys/passphrases
5839          while typing them.
5840
5841        - guestmount now supports -a / -d / -i options, like guestfish.
5842
5843        - Use virtio-serial for communications with the appliance.  This
5844          also has a major performance benefit.
5845
5846        - virt-edit '-b' option to create a backup of edited files.
5847
5848        - virt-edit '-e' option for non-interactive edits to files.
5849
5850        - Ability to capture core dumps from the appliance (thanks Matthew Booth).
5851
5852        - virt-rescue now shuts down cleanly (thanks Matthew Booth).
5853
5854        - virt-rescue now has a --network option to enable network access.
5855
5856        - virt-resize can now handle guests which use GPT partition table format.
5857
5858        - virt-resize has better support for shrinking guests.
5859
5860        - virt-resize supports qcow2-format guests.
5861
5862        - $TMPDIR can be used to override almost all temporary directory usage.
5863
5864        - OCaml users can use an alternate OO-style of coding, eg. g#launch ()
5865
5866        - The API supports calls which take optional parameters, eg.
5867            $g->add_drive_opts ("disk", readonly => 1);
5868
5869        - Trace output now escapes and shortens large strings (thanks
5870          Matthew Booth).
5871
5872        - Autosync is now on by default, resulting in more reliable behaviour
5873          when the handle is closed.
5874
5875        - virt-df --uuid option allows you to follow a domain across migration
5876          and renaming.
5877
5878        - Translations of manual pages.
5879
5880   Security
5881        - CVE-2010-3851 libguestfs: missing disk format specifier when adding a disk
5882          https://www.redhat.com/archives/libguestfs/2010-October/msg00036.html
5883          This is comprehensively fixed in this release, and the fix will be
5884          backported to the other stable branches after more testing.
5885
5886        - virt-inspector no longer relies on untrusted guest code to list
5887          applications in some guests.
5888
5889   New APIs
5890         download-offset, file-architecture, findfs-label, findfs-uuid,
5891         inspect-os, inspect-get-arch, inspect-get-distro,
5892         inspect-get-filesystems, inspect-get-major-version,
5893         inspect-get-minor-version, inspect-get-mountpoints,
5894         inspect-get-product-name, inspect-get-type, is-blockdev, is-chardev,
5895         is-fifo, is-lv, is-socket, is-symlink, list-filesystems, luks-add-key,
5896         luks-close, luks-format, luks-format-cipher, luks-kill-slot,
5897         luks-open, luks-open-ro, lvm-clear-filter, lvm-canonical-lv-name,
5898         lvm-set-filter, part-to-dev, pread-device, pwrite-device,
5899         upload-offset
5900
5901   Internals
5902        - Use size_t for loop iterators.
5903        - Refactor the library code into separate files.
5904        - Refactor the generator code into separate files.
5905        - Generate guestfish commands.
5906        - guestfish & guestmount options processing is unified.
5907        - Protocol changes:
5908            error message size increased to 64K
5909            send errno to library
5910        - Add 'make bindist' to make a binary distribution.
5911        - Cleaner behaviour under valgrind.
5912        - More testing of the guestfish command line options and libvirt
5913          integration.
5914        - The Perl inspection code is no longer used by any of the tools.
5915
5916   Bugs fixed
5917        - 646822 libguestfs trace mode should not print long binary strings
5918        - 646821 virt-df should have --uuid option
5919        - 646432 /dev/mapper paths should not be returned from guestfs_mountpoints
5920        - 643624 libguestfs tools documentation should describe how to quote guest domain names from shell
5921        - 642934 No way to specify disk format when adding a disk to libguestfs
5922        - 642933 guestfs_list_filesystems should be used in all possible places
5923        - 642932 guestmount options should match guestfish options
5924        - 642930 virt-inspector (Sys::Guestfs::Lib) should use C inspection APIs
5925        - 642929 C inspection code should ignore /dev/fd* in /etc/fstab
5926        - 642826 virt-resize converts any other image format to raw without notifying user, instructions do not account for this
5927        - 640961 Document that grub-install might be needed for old Linux guests after virt-resize
5928        - 639986 virt-df --csv does not properly quote " in libvirt domain names
5929        - 639405 Interrupted cached appliance creation leaves libguestfs unusable
5930        - 638901 Appliance filename should not contain repository name
5931        - 638899 /dev/mapper paths should not be returned from C inspection APIs
5932        - 636918 Updates to Spanish translation
5933        - 636061 [abrt] guestfish-1.2.11-1.fc12: malloc_consolidate: Process /usr/bin/guestfish was killed by signal 11 (SIGSEGV)
5934        - 635969 glob echo mkfs ext2 /dev/vd[b-t]1 prints garbage
5935        - 634246 guestfs_part_get_parttype returns "loop" when run against a partition, LV or filesystem
5936        - 633766 virt-resize --shrink fails
5937        - 633357 Updates to Spanish translation
5938        - 633096 virt-resize calculates block device size incorrectly, doesn't work with qcow2 target
5939        - 629593 Dutch translation added
5940        - 627556 Updates to Spanish translations of libguestfs
5941        - 626843 Updates to Spanish translations
5942        - 619793 [RFE] Need a way to determine if a particular block device is a logical volume
5943        - 618556 virt-rescue return none zero value when exit
5944        - 617200 mount operation failed and hung on some images which running in read-only mode
5945        - 610880 libguestfs should set broader read perms on tmpdir, so works in some situations when executed with umask 077
5946        - 599503 document that mkmountpoint and umount-all cannot be mixed
5947        - 571714 Running virt-df on disk image relabels it, so qemu can no longer write to it.
5948        - 502533 Updated Polish translation of libguestfs
5949

RELEASE NOTES FOR LIBGUESTFS 1.4

5951       These release notes only cover the differences from the previous
5952       stable/dev branch split (1.2.0).  For detailed changelogs, please see
5953       the git repository, or the ChangeLog file distributed in the tarball.
5954
5955   New features
5956        - guestfish lets you choose a prepared disk image, eg:
5957            guestfish -N fs:ext4
5958
5959        - Add write support to guestmount (FUSE) module.
5960
5961        - virt-resize can now resize the content of partitions and logical
5962          volumes in the guest, and we have better support for shrinking guests.
5963
5964        - Bash tab-completion script for guestfish.
5965
5966        - Add ZFS support to virt-rescue.
5967
5968        - New tool 'virt-make-fs' for creating filesystems with content.
5969
5970        - Allow suffixes on any guestfish number parameter, eg. "1M".
5971
5972        - guestfish 'man' command opens the manual page.
5973
5974        - guestfish supports a "heredoc" syntax for uploading files:
5975            upload -<<_end_ /foo
5976            content
5977            _end_
5978
5979        - Some guestfish commands now print their output in octal or hex
5980          where appropriate (RHBZ#583242).
5981
5982        - Allow dash prefix on guestfish command line.  This ignores any
5983          error from the second command:                   (RHBZ#578407)
5984            guestfish -- cmd1 : -cmd2 : cmd3
5985
5986        - guestfish -h / help command now returns an error for non-existent
5987          commands (RHBZ#597145).
5988
5989        - New 'supported' command in guestfish to list optional groups of
5990          commands which are supported by the daemon / configuration.
5991
5992        - virt-inspector and guestfish -i now work for filenames which
5993          contain spaces (RHBZ#507810).
5994
5995        - Change the protocol to use link-local addresses, to avoid
5996          conflicting with any address that the host might be using
5997          (RHBZ#588763).
5998
5999        - libguestfs now sets the correct time and timezone on filesystem
6000          modifications.
6001
6002        - Sort the domains into alphabetical order in virt-df.
6003
6004        - Make mkfs-b command work for FAT and NTFS by mapping the blocksize
6005          parameter to the cluster size (RHBZ#599464).
6006
6007        - Add version numbers to Perl modules (RHBZ#521674).
6008
6009        - Localization now works for all the libguestfs tools (RHBZ#559963).
6010
6011        - Tools now support filesystem-on-image VMs (RHBZ#590167).
6012
6013        - virt-list-partitions has a '-t' option to show the total size of disks.
6014
6015        - Include extra Augeas lenses in the supermin appliance (Matthew Booth).
6016
6017        - Add error and close callbacks.
6018
6019        - Add explicit close method in the Perl API.
6020
6021        - Multiple fixes for RHEL 5 compatibility.
6022
6023        - Multiple fixes for Debian/Ubuntu compatibility.
6024
6025        - Multiple revisions to improve the documentation.
6026
6027   Security
6028        - Fix a potential DoS in virt-inspector and virt-v2v if a specially
6029          crafted disk image contained a char device in place of one of the
6030          configuration files that we read under /etc (RHBZ#582484).
6031
6032   New APIs
6033        - aug-clear - clear Augeas path
6034        - available-all-groups - return a list of all optional groups
6035        - base64-in - upload base64-encoded data to file
6036        - base64-out - download file and encode as base64
6037        - checksum-device - compute checksums on the contents of a device
6038        - checksums-out - compute checksums of multiple files in a directory
6039        - debug-upload - upload a file to the appliance
6040        - fallocate64 - preallocate a file in the guest filesystem
6041        - fill-pattern - fill a file with a repeating pattern of bytes
6042        - get-umask - get the current umask
6043        - lvresize-free - expand an LV to fill free space
6044        - ntfsresize - resize an NTFS filesystem
6045        - ntfsresize-size - resize an NTFS filesystem (with size)
6046        - part-del - delete a partition
6047        - part-get-bootable - get the bootable flag of a partition
6048        - part-get-mbr-id - get the MBR type byte of a partition
6049        - part-set-mbr-id - set the MBR type byte of a partition
6050        - pvresize-size - resize a physical volume (with size)
6051        - pwrite - write to part of a file
6052        - resize2fs-size - resize an ext2/3/4 filesystem (with size)
6053        - txz-in - unpack compressed tarball to directory (RHBZ#580556)
6054        - txz-out - pack directory into compressed tarball (RHBZ#580556)
6055        - vfs-label - get the filesystem label
6056        - vfs-uuid - get the filesystem UUID
6057        - vgscan - rescan for LVM physical volumes, volume groups and logical volumes
6058        - write - create a new file
6059        - zero-device - write zeroes to an entire device
6060
6061   Internals
6062        - Extend the generator to support testing optional features.
6063        - Stricter checks on input parameters to many calls (RHBZ#501893 RHBZ#501894)
6064        - Extend the protocol to support sending arbitrary 8 bit data buffers.
6065        - Ship 'BUGS' file with releases.  This is a summary of the bugs in
6066          the Red Hat Bugzilla database.
6067        - Ship 'RELEASE-NOTES' file with releases, containing release notes.
6068        - Unify supermin appliance building into one place, in febootstrap 2.7.
6069        - Fix the protocol code to handle the case where both ends send cancel
6070          messages at the same time.
6071
6072   Bugs fixed
6073        - 612178 guestfish: using -m option in conjunction with --listen option causes appliance to die
6074        - 610880 libguestfs should set broader read perms on tmpdir, so works in some situations when executed with umask 077
6075        - 604691 OCaml bindings are not thread safe
6076        - 603870 Updates to Spanish translation
6077        - 602592 [RFE] expose guestfs_close in perl bindings
6078        - 600977 virt-df -h --csv "Argument .. isn't numeric in printf"
6079        - 599464 mkfs-b does not support vfat/ntfs
6080        - 598807 add_cdrom does not work in RHEL 6
6081        - 598309 part-list and several other cmd failed on libguestfs on RHEL5
6082        - 597145 guestfish 'help' command should indicate error in exit status with an unknown command
6083        - 597135 guestfish write-file cmd does not check "size" parameter
6084        - 597118 A warning should be given in the help of mke2journal-L for the length of label
6085        - 597112 get-e2uuid should use blkid instead of "tune2fs -l" to get filesystem UUID
6086        - 596776 virt-inspector doesn't discover modprobe aliases on RHEL 3 guests
6087        - 596763 Updates to Spanish translation
6088        - 593292 Updates to Spanish translation
6089        - 592883 can not edit files on  images mounted with guestmount cmd
6090        - 592360 Updates to Spanish translation
6091        - 591250 virt-tar prints "tar_in: tar subcommand failed on directory" if the archive is compressed or not in the right format
6092        - 591155 virt-tar prints "tar_in: tar subcommand failed on directory" if a disk image is not writable
6093        - 591142 virt-inspector should give an error for unrecognized disk images
6094        - 590167 virt-inspector and other virt tools should be able to handle filesystem-on-image VMs
6095        - 589039 guestfish read-file cmd will cause daemon hang when read large files
6096        - 588851 guestfs_launch() returns -1, but guestfs_last_error() == NULL
6097        - 588763 libguestfs should use non-public or link-local addresses for appliance network
6098        - 588733 Updates to Spanish translation
6099        - 588651 guestfish 'strings-e' cmd does not give proper error message or hint
6100        - 587484 lvresize can't reduce size of a volumn
6101        - 585961 Updates to Spanish translation
6102        - 585223 ntfsresize should support shrinking filesystems
6103        - 585222 pvresize should support shrinking PVs
6104        - 585221 resize2fs should support shrinking filesystems
6105        - 584038 Updates to Spanish translation
6106        - 583554 [FEAT] mknod-mode command is needed to set mode explicitly
6107        - 583242 [RFE] guestfish should print outputs in a suitable base (eg. octal for modes)
6108        - 582993 guestfish eats words when tab completing case (in)sensitive paths
6109        - 582953 Misleading help information about lvcreate command
6110        - 582948 mknod command doesn't make block, character or FIFO devices
6111        - 582929 mknod doesn't check for invalid mode
6112        - 582901 guestfish chmod/umask commands do not check invalid mode value
6113        - 582899 guestfish:sparse is missed from command autocomplete list
6114        - 582891 [Feature Request] behavior and return value of guestfish umask cmd should be changed
6115        - 582548 [mknod] umask shouldn't take effect when mode is set explicitly
6116        - 582484 some guestfish sub commands can not handle special files properly
6117        - 582252 Updates to Spanish translation
6118        - 581501 Updates to Spanish translation
6119        - 580650 virt-inspector warns "No grub default specified at /usr/lib/perl5/Sys/Guestfs/Lib.pm at [...]"
6120        - 580556 request for libguestfs to support .txz tarballs
6121        - 580246 tar-in command hangs if uploading more than available space
6122        - 580016 aug-ls in guestfish does not take augeas variable as argument
6123        - 579664 guestfish doesn't report error when there is not enough space for image allocation
6124        - 579608 multiple commands in guestfish can not work for symbol links
6125        - 579155 libguestfs hangs if qemu doesn't start (in null vmchannel mode)
6126        - 578407 the prefix '-' in sub-command isn't handled by guestfish in remote control mode
6127        - 576879 libguestfs protocol loses synchronization if you 'upload' before mounting disks
6128        - 559963 libguestfs Perl programs do set locale, but still localization doesn't work
6129        - 521674 Perl modules are unversioned, but should carry version numbers
6130        - 516096 Race condition in test_swapon_label_0: /sbin/blockdev: BLKRRPART: Device or resource busy
6131        - 507810 guestfish -i / virt-inspector cannot handle spaces in filenames
6132        - 502533 Updated Polish translation of libguestfs
6133        - 501894 Some String parameters should be OptString
6134        - 501893 String parameters should be checked for != NULL
6135        - 501889 write-file does not support strings containing ASCII NUL
6136        - 484986 grub-install fails on virtio disk
6137

RELEASE NOTES FOR HISTORICAL VERSIONS OF LIBGUESTFS

6139       Before 2010 libguestfs did not have official release notes or a
6140       formalized version numbering system.  However these are links to
6141       historically significant versions.
6142
6143       2009-11-10 (1.0.78)
6144           https://www.redhat.com/archives/libguestfs/2009-November/msg00095.html
6145
6146       2009-09-13 (1.0.67)
6147           https://www.redhat.com/archives/libguestfs/2009-August/msg00281.html
6148
6149       2009-07-23 (1.0.64)
6150           https://www.redhat.com/archives/libguestfs/2009-July/msg00059.html
6151
6152       2009-07-14 (1.0.59)
6153           https://www.redhat.com/archives/libguestfs/2009-July/msg00023.html
6154
6155       2009-04-01 (the initial announcement)
6156           http://rwmj.wordpress.com/2009/04/01/libguestfs-access-and-modify-virtual-machine-disk-images/
6157

SEE ALSO

6159       guestfs-examples(1), guestfs-faq(1), guestfs-performance(1),
6160       guestfs-recipes(1), guestfs-testing(1), guestfs(3), guestfish(1),
6161       http://libguestfs.org/
6162

AUTHOR

6164       Richard W.M. Jones
6165
6167       Copyright (C) 2009-2019 Red Hat Inc.
6168

LICENSE

6170       This program is free software; you can redistribute it and/or modify it
6171       under the terms of the GNU General Public License as published by the
6172       Free Software Foundation; either version 2 of the License, or (at your
6173       option) any later version.
6174
6175       This program is distributed in the hope that it will be useful, but
6176       WITHOUT ANY WARRANTY; without even the implied warranty of
6177       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
6178       General Public License for more details.
6179
6180       You should have received a copy of the GNU General Public License along
6181       with this program; if not, write to the Free Software Foundation, Inc.,
6182       51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
6183

BUGS

6185       To get a list of bugs against libguestfs, use this link:
6186       https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
6187
6188       To report a new bug against libguestfs, use this link:
6189       https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
6190
6191       When reporting a bug, please supply:
6192
6193       ·   The version of libguestfs.
6194
6195       ·   Where you got libguestfs (eg. which Linux distro, compiled from
6196           source, etc)
6197
6198       ·   Describe the bug accurately and give a way to reproduce it.
6199
6200       ·   Run libguestfs-test-tool(1) and paste the complete, unedited output
6201           into the bug report.
6202
6203
6204
6205libguestfs-1.40.1                 2019-01-17          guestfs-release-notes(1)
Impressum