1guestfs-release-notes(1) Virtualization Support guestfs-release-notes(1)
2
6 guestfs-release-notes - libguestfs Release Notes
7
9 These release notes only cover the differences from the previous
10 stable/dev branch split (1.38.0). For detailed changelogs, please see
11 the git repository, or the ChangeLog file distributed in the tarball.
12 New features
14 New features in existing tools
15 Virt-inspector now displays the libosinfo short ID for guests (Pino
17 Toscano).
18 Guestfish -N will now generate 1G disks instead of 100M disks by
20 default.
21 Virt-resize supports f2fs filesystems (Pino Toscano).
23 libguestfs-test-tool now supports bash tab completion (Pino Toscano).
25 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 Virt-builder --uninstall option now works on SUSE (Sebastian Meyer).
33 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 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 virt-v2v and virt-p2v
44 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 New -o openstack mode for directly uploading images to OpenStack and
50 Cinder using OpenStack APIs.
51 Virt-v2v now has a general mechanism for input and output options: -io
53 and -oo.
54 Virt-v2v can now install the RHV tools or QEMU GA in guests (Tomáš
56 Golembiovský).
57 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 Multiple improvements to the OVF metadata when converting to RHV (Tomáš
62 Golembiovský, Pino Toscano, Arik Hadas).
63 Virt-v2v can now convert Linux guests with split kernel packages,
65 especially Ubuntu 18.04 (Pino Toscano).
66 Virt-v2v old --password-file option has been replaced by -ip (the old
68 option remains for backwards compatibility).
69 Virt-v2v now preserves the VM Generation ID.
71 Virt-v2v has a new --mac option allowing specific NICs to be mapped
73 precisely to networks or bridges on the target.
74 New virt-v2v --print-estimate option to estimate the size of data that
76 virt-v2v will copy.
77 Virt-v2v is now usually able to remove open-vm-tools and VMware Tools
79 from the Linux guest during conversion (Pino Toscano).
80 Virt-v2v can now support UEFI conversions to RHV (Tomáš Golembiovský).
82 Virt-p2v now prefers you to shut down instead of rebooting the machine
84 after conversion has finished (Pino Toscano).
85 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 Language bindings
90 OpenJDK 10+ is supported (Pino Toscano).
92 Java bindings fixed for Gentoo host (Martin Kletzander).
94 Inspection
96 Support Kali Linux (Pino Toscano).
98 When inspecting mountpoints, look for /etc/mdadm/mdadm.conf as well as
100 /etc/mdadm.conf (Nikolay Ivanets).
101 Improved support for OpenSUSE Tumbleweed (Pino Toscano).
103 Architectures and platforms
105 Miscellaneous macOS build fixes (Adam Robinson).
107 Other
109 Multiple documentation typos fixed (Yuri Chornoivan).
111 Security
113 See also guestfs-security(1).
114 CVE-2018-11806
116 Qemu's slirp (userspace networking) had several buffer overflows which
118 could be triggered from the guest or network side.
119 API
121 New APIs
122 "f2fs_expand"
124 Expand an f2fs filesystem (Pino Toscano).
125 "inspect_get_osinfo"
127 Get the libosinfo short ID for the inspected guest (Pino Toscano).
128 "lvm_scan"
130 This rescans all PVs, VGs and LVs, optionally activating them.
131 Other API changes
133 "part_get_mbr_part_type" was reimplemented in OCaml (Nikolay Ivanets).
135 "list_filesystems" now filters out MBR extended partitions (Nikolay
137 Ivanets).
138 "vgscan" has been deprecated. Use the new "lvm_scan" API in
140 preference.
141 Build changes
143 The JSON library switched from yajl to Jansson ≥ 2.7 (Pino Toscano).
144 Support for The Sleuth Kit 4.5 (Pino Toscano).
146 Multiple improvements in the "./configure" script (Lin Ma).
148 More out-of-tree build fixes (Hilko Bengen).
150 Some work on reproducible builds (Bernhard M. Wiedemann).
152 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 On Debian, dash is installed inside the appliance and in virt-rescue
158 (Pino Toscano).
159 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 Virt-v2v now models the source machine type (eg. i440FX, Q35 or virt).
165 Virt-p2v now generates configuration code automatically, also code for
167 parsing the kernel command line.
168 Use "LT_INIT" instead of "AC_PROG_LIBTOOL".
170 The OCaml "JSON" code for parsing and serializing has been unified into
172 a single abstract data type.
173 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 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 Our "clever" libxml2 writer macros are now used consistently across all
182 parts of the code base.
183 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 Bugs fixed
190 https://bugzilla.redhat.com/1664310
191 [RHEL 7.6 LP] openstack output leaks passwords
192 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 https://bugzilla.redhat.com/1651432
198 v2v - support for -insecure option to support OSP SSL connection
199 for VM migrations
200 https://bugzilla.redhat.com/1642044
202 [RFE] virt-p2v UI should give the option to shutdown after
203 conversion is finished
204 https://bugzilla.redhat.com/1634248
206 virt-v2v cannot convert opensuse15 guest
207 https://bugzilla.redhat.com/1624902
209 Fix rhev-apt command that virt-v2v runs in Windows guests on first
210 boot
211 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 https://bugzilla.redhat.com/1615885
217 Minor log issue of virt-v2v
218 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 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 https://bugzilla.redhat.com/1611690
230 part_to_dev "/dev/sdp1" returns "/dev/sd" instead of "/dev/sdp"
231 https://bugzilla.redhat.com/1608131
233 inspection fails when swap partition in /etc/fstab has incorrect
234 UUID compared to actual swap partition
235 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 https://bugzilla.redhat.com/1602353
241 virt-inspector can't inspect LUKS-encrypted RHEL7 guest image
242 https://bugzilla.redhat.com/1601943
244 Improve error "No module named ovirtsdk4" in v2v rhv-upload
245 conversion
246 https://bugzilla.redhat.com/1598715
248 Adding QXL device in OVF causes Cirrus Logic device to be added to
249 guest
250 https://bugzilla.redhat.com/1598350
252 RFE: virt-v2v should preserve <genid>
253 https://bugzilla.redhat.com/1596851
255 Transfer fails if local host is in maintenance mode
256 https://bugzilla.redhat.com/1596810
258 Transfer fails if local host belongs to another DC
259 https://bugzilla.redhat.com/1592468
261 v2v to RHV transfer fails with: error: [empty name]: cannot read
262 '//*/disksection' with value: null
263 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 https://bugzilla.redhat.com/1591789
269 p2v: error: XML error: CPU vendor specified without CPU model
270 https://bugzilla.redhat.com/1590220
272 Hide rhv-upload option in virt-p2v client
273 https://bugzilla.redhat.com/1588451
275 Don't use relative socket paths for NBD
276 https://bugzilla.redhat.com/1588088
278 RFE: Support for -o rhv-upload via Unix domain socket
279 https://bugzilla.redhat.com/1586198
281 ovirt-imageio-daemon times out during migration
282 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 https://bugzilla.redhat.com/1580292
288 Virt-v2v rhel7.6 build can't convert guest with qemu-kvm rhel7.5.z
289 build
290 https://bugzilla.redhat.com/1579047
292 virt-builder: ubuntu-18.04 template has stray HTTP proxy configured
293 for apt
294 https://bugzilla.redhat.com/1575640
296 virt-builder: error: host cpu (x86_64) and guest arch (unknown) are
297 not compatible
298 https://bugzilla.redhat.com/1570407
300 virt-v2v -i ova gives checksum error when missing files are
301 mentioned in .mf
302 https://bugzilla.redhat.com/1567763
304 guestfsd: error: /Windows/Drivers/VirtIO: Read-only file system
305 https://bugzilla.redhat.com/1564983
307 The mount-vfs failed to mount the logical volume
308 https://bugzilla.redhat.com/1561828
310 RHV tools not properly installed in migrated Windows VM's causing
311 boot failure
312 https://bugzilla.redhat.com/1559027
314 virt-v2v does not honor --network with -o rhv-upload
315 https://bugzilla.redhat.com/1557273
317 [RFE] Upload images directly to oVirt (virt-v2v -o rhv-upload)
318 https://bugzilla.redhat.com/1544842
320 [RFE] Add libosinfo short-id to virt-inspector output
321 https://bugzilla.redhat.com/1544674
323 virt-inspector --help differs from manpage
324 https://bugzilla.redhat.com/1544227
326 RFE: recognize the Kali Linux distribution
327 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 https://bugzilla.redhat.com/1530967
333 Change categories of "Guest Operating system management by VIX API"
334 in v2v man page
335 https://bugzilla.redhat.com/1527334
337 Various -it vddk -io vddk* options should be documented, removed or
338 fixed
339 https://bugzilla.redhat.com/1148012
341 Reverted: RFE: Allow qemu-bridge-helper to be used to implement
342 guestfs_set_network
343
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 New features
350 New tools
351 Virt-builder-repository is a new tool allowing end users to create and
353 update virt-builder repositories (Cédric Bosdonnat).
354 Virt-rescue (while not a new tool) has been substantially rewritten,
356 implementing job control, -m and -i options, escape keys, etc.
357 New features in existing tools
359 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 New virt-builder Fedora templates (starting with Fedora 26) will have
365 plain partition layout and use GPT for partitions.
366 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 Virt-customize now sets a random /etc/machine-id for Linux guests, if
372 one is not already set.
373 Virt-df now works correctly on filesystems with block sizes smaller
375 than 1K (Nikolay Ivanets).
376 Virt-dib has further compatibility enhancements with diskimage-builder
378 (Pino Toscano).
379 Virt-sysprep removes "DHCP_HOSTNAME" from ifcfg-* files.
381 Virt-sysprep now works on Oracle Linux (Jamie Iles).
383 Virt-resize now correctly copies GPT partition attributes from the
385 source to the destination (Cédric Bosdonnat).
386 Bash tab completion implemented or enhanced for: virt-win-reg,
388 virt-v2v-copy-to-local.
389 virt-v2v and virt-p2v
391 Virt-v2v can now read VMware VMX files directly, either from local
393 disk, NFS storage, or over SSH from an ESXi hypervisor.
394 Virt-v2v can now use VDDK as an input source.
396 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 Virt-v2v now supports encrypted guests (Pino Toscano).
403 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 Virt-v2v now installs Windows 10 / Windows Server 2016 virtio block
409 drivers correctly (Pavel Butsykin, Kun Wei).
410 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 Virt-v2v now installs both legacy and modern virtio keys in the Windows
416 registry (Ladi Prosek).
417 Virt-p2v can now preserve (in some cases) the offset of the Real Time
419 Clock from UTC.
420 Virt-p2v now combines several scp commands to the conversion server
422 into a single command, improving conversion times.
423 Virt-v2v now detects the special Linux Xen PV-only kernels correctly
425 (Laszlo Ersek).
426 Virt-v2v -o glance now generates the right properties for UEFI guests
428 (Pino Toscano).
429 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 Virt-v2v -o rhv now supports Windows 2016 Server guest type.
435 Virt-v2v -i libvirtxml can now open network disks over http or https.
437 Virt-v2v will now give a warning about host passthrough devices (Pino
439 Toscano).
440 The virt-v2v --machine-readable output has been enhanced so it includes
442 "vcenter-https", "xen-ssh" and "in-place" facts (Pino Toscano).
443 Language bindings
445 Fix multiple memory leaks and other data corruption problems in the
447 Java bindings (Pino Toscano).
448 Perl %guestfs_introspection has been dropped.
450 Inspection
452 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 Better icon support for ALT Linux guests (Pino Toscano).
458 Better support for NeoKylin (Qingzheng Zhang).
460 Can handle OSes like Void Linux which do not include "VERSION_ID" in
462 /etc/os-release (Pino Toscano).
463 Add support for Microsoft MS-DOS (Daniel Berrangé).
465 Architectures and platforms
467 Multiple fixes for S/390 architecture. Libguestfs and all the tools
469 should now compile and run on this architecture.
470 Other
472 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 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 API
483 New APIs
484 "hivex_value_string"
486 This replaces the deprecated "hivex_value_utf8" API, but does the
487 same thing.
488 "part_get_gpt_attributes"
490 "part_set_gpt_attributes"
491 Read and write GPT partition attribute flags (Cédric Bosdonnat).
492 "part_resize"
494 Enlarge or shrink an existing partition (Nikos Skalkotos).
495 "yara_destroy"
497 "yara_load"
498 "yara_scan"
499 Support for the Yara malware scanning engine (Matteo Cafasso).
500 Other API changes
502 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 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 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 All APIs for inspecting installer CDs have been deprecated. Use
515 libosinfo for this task.
516 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 Add "RELEASES" file which lists release dates for each version of
523 libguestfs. You must update this file when making a new release.
524 Documentation generated by "gtk-doc" has been removed. "./configure
526 --enable-gtk-doc" now does nothing.
527 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 Libxcrypt is now used for crypt(3). This is required if using glibc ≥
533 2.27.
534 "ocaml-hivex" is now required.
536 Libvirt ≥ 1.2.20 is now required.
538 There is now a "make check-root" target for tests which need to be run
540 as root (analogous to "make check-slow").
541 "./configure"-time check for "__attribute__((cleanup))" now works in
543 the cross-compilation case (Yann E. Morin).
544 The "AUTHORS" and "p2v/about-authors.c" files are now generated from a
546 single place.
547 Either GnuPG v1 or v2 can be used.
549 "./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 "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 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 OCaml dependencies are now generated from a single script instead of
564 multiple not-quite-the-same Makefile fragments.
565 "./configure --with-distro=ID" can be used to override automatic Linux
567 distro detection at build time (Pino Toscano).
568 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 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 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 Add more calls to "udev_settle" to improve stability of partition code
585 (Dawid Zamirski).
586 Run "udev_settle" with --exit-if-exists option, which improves the
588 speed of this command (Pavel Butsykin).
589 Detect new locations of major(3), minor(3), makedev(3).
591 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 Use gnulib "set_nonblocking_flag" wrapper instead of calling fcntl(2)
597 with "O_NONBLOCK" (Eric Blake). Similarly "set_cloexec_flag".
598 Fix memory leak in XFS version of "guestfs_vfs_minimum_size" (Pino
600 Toscano).
601 Valgrind checks now run on the virt-p2v binary.
603 Unicode single quotes ("‘’") and now used in place of '' or `'
605 throughout the code and documentation. Similarly for "’s" instead of
606 "'s".
607 The "is_zero" function has been reimplemented for greater speed (Eric
609 Blake).
610 In the direct backend, virtio-blk support has been removed. Virtio-
612 scsi is now the only supported way to add disks.
613 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 The appliance disk image can now be in formats other than raw (Pavel
619 Butsykin).
620 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 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 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 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 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 Certain OCaml features in OCaml ≥ 4.01 are used throughout the code,
644 including replacing ‘{ field = field }’ with ‘{ field }’.
645 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 /dev/shm is now created in the appliance (Nicolas Hicher).
652 In verbose mode on Fedora guests, virt-customize will now use "dnf
654 --verbose" enabling better debugging output.
655 Virt-v2v input and output classes now contain a "#precheck" method
657 which is used to perform environmental checks before conversion starts.
658 Virt-p2v enables miniexpect debugging. It is written to stderr (of
660 virt-p2v).
661 Virt-v2v free space checks are more liberal especially for smaller
663 guests (Pino Toscano).
664 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 https://bugzilla.redhat.com/1539395
671 virt-customize segfaults after upgrading to 1.37.35-3
672 https://bugzilla.redhat.com/1536765
674 Libguestfs Perl bindings can leak a small amount of memory on error
675 https://bugzilla.redhat.com/1536763
677 libguestfs Lua bindings use strerror(), which isn’t thread safe
678 https://bugzilla.redhat.com/1536603
680 man page makes no mention of using '--' when trying to change exit
681 on error behavior
682 https://bugzilla.redhat.com/1525241
684 virt-df displays zeros for filesystems with block size =512
685 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 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 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 https://bugzilla.redhat.com/1514756
699 ./configure --disable-ocaml breaks building common/mlpcre which
700 breaks building daemon
701 https://bugzilla.redhat.com/1513884
703 [RFE]Should update some vddk info in v2v man page
704 https://bugzilla.redhat.com/1508874
706 virt-v2v: warning: ova disk has an unknown VMware controller type
707 (20)
708 https://bugzilla.redhat.com/1506572
710 virt-v2v '-i ova' is not parsing the MAC address from the source
711 OVF
712 https://bugzilla.redhat.com/1506511
714 virt-builder fails to parse repo file if it has blank space after
715 the repository identifier
716 https://bugzilla.redhat.com/1503958
718 Failed to convert the rhel5 guest with kmod-xenpv installed from
719 xen server by virt-v2v
720 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 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 https://bugzilla.redhat.com/1500537
730 /dev/shm does not exist in the appliance environment
731 https://bugzilla.redhat.com/1497475
733 guestfish cannot list commands from interactive mode
734 https://bugzilla.redhat.com/1493048
736 Unbound constructor Hivex.OPEN_UNSAFE
737 https://bugzilla.redhat.com/1484957
739 bump debian images to use single-partition layout
740 https://bugzilla.redhat.com/1482737
742 virt-resize failed to expand swap partition for RHEL5.11 guest
743 image with "parsing UUID failed"
744 https://bugzilla.redhat.com/1477623
746 Running file API on a special chardev may hang forever
747 https://bugzilla.redhat.com/1476081
749 inspect-os report error: could not parse integer in version
750 number: V7Update2
751 https://bugzilla.redhat.com/1472719
753 [RFE]Add warning in process of v2v converting guest which has pci
754 passthrough device
755 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 https://bugzilla.redhat.com/1469655
761 firstboot scripts are not correctly installed in Fedora 26
762 https://bugzilla.redhat.com/1466563
764 Libguestfs should pass copyonread flag through to the libvirt XML
765 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 https://bugzilla.redhat.com/1460338
771 guestfs_shutdown hangs if main process sets signal handlers
772 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 https://bugzilla.redhat.com/1451665
778 RFE: Virt-v2v can't convert the guest which has encrypted partition
779 https://bugzilla.redhat.com/1450325
781 document URI format for -a parameters of tools
782 https://bugzilla.redhat.com/1448739
784 RFE: Support multicore decompression for OVA files using pigz and
785 pxz
786 https://bugzilla.redhat.com/1447202
788 Win 2016 guest is described as Win 10 after imported to RHEVM
789 https://bugzilla.redhat.com/1441197
791 RFE: ability to convert VMware virtual machines via vmx
792 https://bugzilla.redhat.com/1438939
794 Please drop or update GnuPG (1.4.x) dependency
795 https://bugzilla.redhat.com/1438794
797 [RFE] Install Windows virtio-rng drivers on VMs imported
798 https://bugzilla.redhat.com/1433937
800 virt-inspector can't get icon info from altlinux-centaurus
801 https://bugzilla.redhat.com/1433577
803 policycoreutils setfiles >= 2.6 does .. nothing
804 https://bugzilla.redhat.com/1431579
806 Windows 8 UEFI from VMware to KVM fails to boot after conversion
807 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 https://bugzilla.redhat.com/1430184
813 virt-dib should generate sha256 checksum instead of sha512
814 https://bugzilla.redhat.com/1429506
816 RFE: OVMF should be detected on conversion server to prevent failed
817 conversion
818 https://bugzilla.redhat.com/1429491
820 Should rename network name of rhv in virt-v2v man page
821 https://bugzilla.redhat.com/1427529
823 virt-sysprep should remove DHCP_HOSTNAME
824 https://bugzilla.redhat.com/1417306
826 QEMU image file locking (libguestfs)
827 https://bugzilla.redhat.com/1409024
829 [Debian] Missing db_dump abort inspection
830 https://bugzilla.redhat.com/1406906
832 Segmentation fault when reading corrupted path with Python 3
833 bindings
834 https://bugzilla.redhat.com/1379289
836 RFE: virt-p2v should support mnemonic operations
837 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 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 https://bugzilla.redhat.com/1374232
848 selinux relabel fails on RHEL 6.2 guests with "libguestfs error:
849 selinux_relabel: : Success"
850 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 https://bugzilla.redhat.com/1362649
858 RFE: virt-sysprep does not utilize libguestfs encryption support
859 https://bugzilla.redhat.com/1172425
861 [RFE]virt-v2v failed to convert VMware ESX VM with snapshot
862 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 https://bugzilla.redhat.com/1167623
868 Remove "If reporting bugs, run virt-v2v with debugging enabled .."
869 message when running virt-p2v
870 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
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 New features
881 New tools
882 Virt-tail is a new tool for following (tailing) log files within a
884 guest, similar to the regular "tail -f" command.
885 New features in existing tools
887 Virt-customize, virt-get-kernel, virt-sparsify and virt-sysprep can now
889 handle encrypted guests (Pino Toscano).
890 Virt-builder and virt-customize now support --append-line, which is
892 useful for adding lines to the end of configuration files.
893 Virt-resize can now shrink and expand swap partitions (Pino Toscano).
895 Virt-resize can now output to non-local disks (Pino Toscano).
897 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 Virt-dib can now create checksums using the new --checksum option (Pino
903 Toscano).
904 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 Virt-dib can now create squashfs files (Pino Toscano).
909 Bash tab-completion is now available in every command line tool that is
911 shipped.
912 virt-v2v and virt-p2v
914 Conversions of Debian (6+) and Ubuntu (10.04+) guests are now supported
916 (Tomáš Golembiovský, Pino Toscano).
917 Conversions from SUSE Xen hypervisor have now been tested (Cédric
919 Bosdonnat).
920 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 OVA files exported from AWS can now be converted (Shahar Havivi).
927 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 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 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 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 Virt-v2v no longer removes the "Processor" and "Intelppm" nodes from
949 the Windows Registry.
950 Xen and vCenter conversions can now be done using the libvirt backend,
952 provided libvirt ≥ 2.1.0 is used.
953 /dev/srX (SCSI CD-ROM) devices are ignored (Tomáš Golembiovský).
955 When converting SUSE Linux guests, use /etc/modprobe.conf.local if it
957 exists.
958 Removing VMware tools from Linux guests should now work reliably (Pino
960 Toscano).
961 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 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 A new flag --vdsm-compat has been added to -o vdsm mode, allowing more
972 efficient qcow2 images to be generated.
973 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 The "RHEV-APT" utility is only installed when the output hypervisor is
980 oVirt or RHV.
981 A problem with virt-v2v running out of memory when doing an SELinux
983 relabel of the guest filesystem should now be resolved.
984 Language bindings
986 Setting "EXTRA_JAVAC_FLAGS" before ./configure allows you to add
988 arbitrary flags to "javac" when compiling the Java bindings.
989 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 Inspection
995 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 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 Inspection of guest operating systems that use a separate /usr
1005 partition should now work more reliably (Pino Toscano).
1006 When parsing guest /etc/fstab, paths are reduced to a canonical form
1008 (eg. "///usr//local//" → "/usr/local").
1009 Inspection of btrfs subvolumes now works where the /etc/fstab options
1011 field contains commas.
1012 /dev/cdN devices in guest /etc/fstab are ignored (Pino Toscano).
1014 Architectures and platforms
1016 Stable releases are now tested on aarch64, ppc64 and ppc64le
1018 architectures.
1019 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 Detection of S/390 and S/390x binaries and guests is now supported.
1025 Other
1027 ExFAT filesystems are now supported (Miles Wolbe).
1029 Security
1031 See also guestfs-security(1).
1032 There were no CVEs reported in this development cycle. However some
1034 security-related hardening was carried out as described below.
1035 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 The $TERM environment variable is now validated before passing it
1041 through to the appliance kernel command line.
1042 API
1044 New APIs
1045 "guestfs_aug_transform"
1047 Exposes the Augeas "aug_transform" API (Pino Toscano).
1048 "guestfs_find_inode"
1050 Find files by inode number (Matteo Cafasso).
1051 "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 "guestfs_mksquashfs"
1058 Create a squashfs filesystem from a path (Pino Toscano).
1059 Other API changes
1061 "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 "guestfs_canonical_device_name"
1069 This call will no longer incorrectly modify Linux software RAID
1070 device names (like /dev/mdX).
1071 "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 This API can now return the following new values: "riscv32",
1078 "riscv64", "riscv128", "s390", "s390x".
1079 "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 "guestfs_list_partitions"
1086 This call now returns Linux software RAID partitions.
1087 "guestfs_part_to_dev"
1089 This call now correctly handles partition names which include
1090 "p<N>" (Pino Toscano).
1091 "guestfs_set_label"
1093 This call can now change the labels of swap partitions (Pino
1094 Toscano).
1095 Build changes
1097 libmagic, the library part of the "file" command, is now required at
1098 build time (previously optional).
1099 GCC 7 is now supported.
1101 "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 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 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 "make maintainer-check-extra-dist" now checks that all generated files
1116 are included in the tarball.
1117 The tests no longer assume that "." is in Perl's @INC, as it is going
1119 to be removed soon (Pino Toscano).
1120 Debian hosts using UsrMerge are now supported (Pino Toscano).
1122 Header files and C structs can now have internal documentation using
1124 the special "/** ... */" comments.
1125 "@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 gperf ≥ 3.1 is now supported.
1132 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 Virt-p2v can now be compiled on RHEL 5 (2007-era) Linux with Gtk 2.10.
1138 Internals
1140 The generator and mllib "Common_utils" modules are now shared from the
1141 same source file.
1142 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 The directory containing the main library code has moved from src →
1150 lib.
1151 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 UEFI paths are now stored in the generator (generator/uefi.ml).
1158 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 The gnulib "getprogname" module is now used everywhere when
1164 needing/printing the program name (Pino Toscano).
1165 perl/Guestfs.c is not translatable (Nikos Skalkotos).
1167 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 All Windows registry utilities used by virt-customize and virt-v2v have
1172 been moved to a common module called "Registry" under mllib.
1173 All POSIX bindings have been moved to a new module called "Unix_utils"
1175 under mllib.
1176 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 "/dev/pts" is now available inside the appliance, so any tools we run
1184 which require a pty will now work (Pino Toscano).
1185 Most OCaml warnings have been fixed.
1187 There is now a single common function for creating temporary files
1189 ("guestfs_int_make_temp_path") (Matteo Cafasso).
1190 The $TERM environment variable is now validated before passing it
1192 through to the appliance kernel command line.
1193 Useless USB and memballoon devices are no longer created in the
1195 appliance (Laine Stump).
1196 On aarch64 we now use virtio-pci for the appliance. This is somewhat
1198 faster than virtio-mmio.
1199 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 Bugs fixed
1205 https://bugzilla.redhat.com/1425306
1206 typo error in virt-tail man page
1207 https://bugzilla.redhat.com/1418283
1209 virt-v2v: appliance runs out of memory running setfiles command
1210 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 https://bugzilla.redhat.com/1417444
1217 *** No rule to make target '../perl/lib/Sys/Guestfs.c', needed by
1218 'libguestfs.pot'
1219 https://bugzilla.redhat.com/1416941
1221 compile of 1.34.3 fails with gperf 3.1
1222 https://bugzilla.redhat.com/1414682
1224 guestfs_canonical_device_name incorrectly returns /dev/sd0 for MD
1225 devices (/dev/md0)
1226 https://bugzilla.redhat.com/1414510
1228 guestfs_list_filesystems does not recognize ddf partitions
1229 https://bugzilla.redhat.com/1409023
1231 [Debian] ldmtool not installed in the appliance
1232 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 https://bugzilla.redhat.com/1404182
1238 RFE: virt-resize should support a URL as the outdisk
1239 https://bugzilla.redhat.com/1401474
1241 Importing VMs from VMware is failing with error "Inspection field
1242 'i_arch' was 'unknown'"
1243 https://bugzilla.redhat.com/1401320
1245 RFE: Increate virt-sysprep coverage a bit
1246 https://bugzilla.redhat.com/1400205
1248 Add --vdsm-compat=1.1 flag for VDSM
1249 https://bugzilla.redhat.com/1398070
1251 typo error in man page
1252 https://bugzilla.redhat.com/1392798
1254 secrets from libvirt domains are not read
1255 https://bugzilla.redhat.com/1390876
1257 "--machine-readable" info should be updated in virt-v2v manual page
1258 https://bugzilla.redhat.com/1379289
1260 RFE: virt-p2v should support mnemonic operations
1261 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 https://bugzilla.redhat.com/1377081
1267 virt-p2v manual should update the new dialog information
1268 https://bugzilla.redhat.com/1375157
1270 virt-v2v: -i ova: Permission denied when using libvirt and running
1271 as root
1272 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 https://bugzilla.redhat.com/1374405
1278 There is HTTP 404 error info when convert guest to glance by
1279 virt-v2v
1280 https://bugzilla.redhat.com/1374232
1282 selinux relabel fails on RHEL 6.2 guests with "libguestfs error:
1283 selinux_relabel: : Success"
1284 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 https://bugzilla.redhat.com/1372269
1290 Builder does not set hostname properly for Debian 8 (Jessie)
1291 https://bugzilla.redhat.com/1371843
1293 Improve OVA import compatibility
1294 https://bugzilla.redhat.com/1370424
1296 virt-manager coredump when vm with gluster image exists
1297 https://bugzilla.redhat.com/1367839
1299 Cannot import VMs from Xen and VMware when using RHEL7.3 host.
1300 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 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 https://bugzilla.redhat.com/1366456
1312 Converting rhel7 host installed on RAID:warning: fstrim: fstrim:
1313 /sysroot/: the discard operation is not supported
1314 https://bugzilla.redhat.com/1366049
1316 RFE: libvirt backend: support handling disks stored as volume name
1317 in a pool
1318 https://bugzilla.redhat.com/1365005
1320 Guest name is incorrect if convert guest from disk image by
1321 virt-v2v
1322 https://bugzilla.redhat.com/1362649
1324 RFE: virt-sysprep does not utilize libguestfs encryption support
1325 https://bugzilla.redhat.com/1354507
1327 virt-v2v conversions from vCenter do not consistently obey the
1328 proxy environment variables
1329 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 https://bugzilla.redhat.com/1161019
1335 RFE: Only install RHEV-APT if virt-v2v -o rhev/-o vdsm option is
1336 used
1337 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 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 https://bugzilla.redhat.com/1134878
1347 libvirt reports json "backing file" is missing
1348 https://bugzilla.redhat.com/1019388
1350 firstboot scripts (virt-builder, virt-sysprep) don't work for
1351 Debian 6 & 7 guests
1352 https://bugzilla.redhat.com/737600
1354 virt-v2v windows xp - machine dies BSOD - processr,sys - workaround
1355 provided
1356
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 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 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 f2fs (Flash Friendly File System) is now supported (Pino Toscano).
1376 New tools
1378 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 New features in existing tools
1383 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 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 virt-p2v kernel command line options can now be used to set defaults
1393 for GUI configuration.
1394 The virt-p2v debugging options have been completely removed,
1396 simplifying the interface and documentation. Debugging information is
1397 now captured fully automatically.
1398 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 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 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 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 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 virt-v2v conversion of Windows guests was substantially rewritten and
1419 simplified (Roman Kagan).
1420 virt-v2v --in-place mode now supports installing virtio-scsi drivers in
1422 guests (Roman Kagan).
1423 virt-v2v can now convert SUSE guests and SUSE guests using UEFI (Cédric
1425 Bosdonnat and Jim Fehlig).
1426 virt-v2v can now convert guests to Glance that have multiple disks.
1428 Previously it would fail on such guests.
1429 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 virt-v2v has now been tested against SUSE Xen as a source hypervisor
1435 (Cédric Bosdonnat).
1436 virt-v2v adds support for SUSE VMDP drivers (Cédric Bosdonnat).
1438 virt-v2v can convert OVA files containing subfolders, as produced by
1440 SUSE Studio (Cédric Bosdonnat).
1441 virt-v2v sets the OVF "<Origin>" element correctly. oVirt has been
1443 extended to support more source hypervisors (Shahar Havivi).
1444 virt-v2v now supports Windows Server 2016 (Tomáš Golembiovský).
1446 The virt-builder --list option can now be used to show all templates or
1448 a single template (Pino Toscano).
1449 All OCaml-based tools now use getopt_long(3) for option parsing, and
1451 --help output has been improved (Pino Toscano).
1452 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 virt-customize --delete now accepts globs.
1458 New virt-customize --uninstall option lets you uninstall packages.
1460 virt-customize can now use "pvvxsvc" as an alternative to "rhsrvany"
1462 for running firstboot scripts in Windows guests (Cédric Bosdonnat).
1463 virt-customize now uses the strongest hashing scheme for passwords on
1465 Arch and Void Linux (Pino Toscano).
1466 virt-customize --install now works correctly on Arch (Pino Toscano).
1468 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 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 virt-sysprep "fs-uuids" operation no longer fails on btrfs guests
1479 (Maxim Perevedentsev).
1480 virt-dib can output Docker images (Pino Toscano).
1482 virt-dib has a new --drive-format option to allow the user to specify
1484 the format of the helper drive (Pino Toscano).
1485 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 Language bindings
1493 PHP test coverage has been enhanced (Pino Toscano).
1495 PHP 7 is now supported (Pino Toscano).
1497 Python bindings are now compliant with PEP 8 (Pino Toscano).
1499 A Python pip package is available in
1501 http://libguestfs.org/download/python/
1502 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 All OCaml libraries and programs are now compiled with -safe-string, if
1508 supported by the OCaml compiler.
1509 Inspection
1511 Alpine Linux using busybox can now be inspected. Also the APK package
1513 manager is supported in virt-customize (Pino Toscano).
1514 We now handle inspection of Mageia 4 (Pino Toscano).
1516 Void Linux and the Void Linux xbps package manager are fully supported
1518 (Pino Toscano).
1519 Parsing of CoreOS version information has been enhanced (Pino Toscano).
1521 It is now possible to get an icon from ALT Linux (Pino Toscano).
1523 PLD Linux versions < 3 are now recognized (Pino Toscano).
1525 Windows drive letters are now returned for guests using GPT partitions
1527 (Dawid Zamirski).
1528 We can now correctly inspect Unix guests that do not have an /etc/fstab
1530 file (Pino Toscano).
1531 Added another source for the Ubuntu icon which doesn't rely on GNOME
1533 having been installed in the guest.
1534 We can now get an icon for Windows 7 64 bit guests.
1536 Libosinfo integration was rewritten to deal with the new database
1538 format used by osinfo (Pino Toscano).
1539 Documentation
1541 New manual page guestfs-building(1) describes how to build libguestfs
1543 from source.
1544 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 The guestfs-testing(1) man page has been refreshed and based on a newer
1551 libguestfs.
1552 Architectures and platforms
1554 virt-customize now works on POWER7 and POWER8 platforms, both big
1556 endian and little endian (Xianghua Chen and Hu Zhang).
1557 Security
1559 See also guestfs-security(1).
1560 CVE-2015-8869
1562 https://bugzilla.redhat.com/CVE-2015-8869
1564 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 virt-customize ownership of .ssh, .ssh/authorized_keys
1574 https://bugzilla.redhat.com/1337561
1576 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 Windows "%systemroot%"
1584 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 Virtio-rng is now available in the appliance
1590 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 API
1596 New APIs
1597 "btrfs_filesystem_show"
1599 List all devices where a btrfs filesystem is spanned (Pino
1600 Toscano).
1601 "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 Note these require optional dependency The Sleuth Kit. (Matteo
1610 Cafasso)
1611 "get_sockdir"
1613 Read the path where temporary sockets are stored (Pino Toscano).
1614 "mountable_device"
1616 "mountable_subvolume"
1617 Split a Mountable into device name and subvolume (Cédric
1618 Bosdonnat).
1619 "ntfscat_i"
1621 Download NTFS file by inode number (Matteo Cafasso).
1622 "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 "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 "selinux_relabel"
1635 SELinux-relabel part or all of the guest filesystem.
1636 Other API changes
1638 "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 "guestfs_vfs_minimum_size" can now be used on dirty filesystems (Maxim
1646 Perevedentsev).
1647 "guestfs_ll" now works on paths which contain absolute symlinks (Pino
1649 Toscano).
1650 "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 "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 "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 "guestfs_is_lv" no longer fails if passed a btrfs subvolume, it returns
1665 false instead (Maxim Perevedentsev).
1666 Build changes
1668 qemu ≥ 1.3.0 is required.
1669 yajl (a JSON parsing library) is required to build libguestfs.
1671 You can now build with GCC 6.
1673 "make check-valgrind" now has substantially better coverage.
1675 "make check-slow" now works again.
1677 Use "make -C appliance clean-supermin-appliance" to clean the supermin
1679 appliance (it will be rebuilt on next "make").
1680 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 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 The "./configure" options are now mostly documented in
1690 guestfs-building(1).
1691 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 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 Error messages from libvirt now include the "err->int1" field which
1702 usually contains the "errno".
1703 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 The C API tests now use larger test disks, allowing BTRFS to be tested
1708 properly (Pino Toscano).
1709 The tests should now work on a pure Python 3 host (Pino Toscano).
1711 In C bindings, internal functions are now (mostly) consistently named
1713 "guestfs_int_*" whereas previously there was no consistent scheme.
1714 The old "safe_malloc" etc functions are now no longer exported by the
1716 library, nor used in language bindings.
1717 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 The "COMPILE_REGEXP" macro can now be used in the daemon.
1723 When tracing, results containing structs are now printed in full (Pino
1725 Toscano).
1726 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 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 The error(3) function is now used everywhere, replacing most previous
1736 uses of perror(3) + exit(3), and fprintf(3) + exit.
1737 In C code, "/**" comments are turned into documentation which is
1739 automatically added to the guestfs-hacking(1) manual page.
1740 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 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 A safe wrapper around waitpid(2) has been added which handles "INTR"
1751 properly.
1752 "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 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 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 On Linux guests, the firstboot services generated by virt-builder
1767 --firstboot etc have been renamed to "guestfs-firstboot" (Pino
1768 Toscano).
1769 There is now a common "debug" function used by all OCaml tools,
1771 replacing previous code which did "if verbose () then printf ...".
1772 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 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 lvmetad(8) is now used in the appliance when available (Pino Toscano).
1784 "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 Bugs fixed
1789 https://bugzilla.redhat.com/1364347
1790 virt-sparsify --in-place failed with UEFI system
1791 https://bugzilla.redhat.com/1362357
1793 run_command runs exit handlers when execve fails (e.g. due to
1794 missing executable)
1795 https://bugzilla.redhat.com/1362354
1797 virt-dib failed to create image using DIB_YUM_REPO_CONF
1798 https://bugzilla.redhat.com/1359652
1800 Fail to inspect Windows ISO file
1801 https://bugzilla.redhat.com/1358142
1803 Some info will show when convert guest to libvirt by virt-v2v with
1804 parameter --quiet
1805 https://bugzilla.redhat.com/1354335
1807 overlay of disk images does not specify the format of the backing
1808 file
1809 https://bugzilla.redhat.com/1352761
1811 Virt-manager can't show OS icons of win7/win8/ubuntu guest.
1812 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 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 https://bugzilla.redhat.com/1345813
1822 virt-sysprep --install always failed to install the packages
1823 specified
1824 https://bugzilla.redhat.com/1345809
1826 virt-customize --truncate-recursive should give an error message
1827 when specifying a no-existing path
1828 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 https://bugzilla.redhat.com/1343414
1834 Failed SSH to conversion server by ssh identity http url at p2v
1835 client
1836 https://bugzilla.redhat.com/1343375
1838 [RFE] uninstall packages inside the VM
1839 https://bugzilla.redhat.com/1342447
1841 Ifconfig command is not supported on p2v client
1842 https://bugzilla.redhat.com/1342398
1844 Convert a guest from RHEL by virt-v2v but its origin info shows
1845 RHEV at rhevm
1846 https://bugzilla.redhat.com/1342337
1848 Should remind a warning about disk image has a partition when using
1849 virt-p2v-make-disk
1850 https://bugzilla.redhat.com/1341984
1852 virt-get-kernel prompts an 'invalid value' error when using
1853 --format auto
1854 https://bugzilla.redhat.com/1341564
1856 virt-p2v spinner should be hidden when it stops spinning
1857 https://bugzilla.redhat.com/1340809
1859 Testing connection timeout when input regular user of conversion
1860 server with checked "use sudo......"button
1861 https://bugzilla.redhat.com/1340464
1863 [RFE] Suggestion give user a reminder for "Cancel conversion"
1864 button
1865 https://bugzilla.redhat.com/1340407
1867 Multiple network ports will not be aligned at p2v client
1868 https://bugzilla.redhat.com/1338083
1870 Update UEFI whitelist for official fedora packages
1871 https://bugzilla.redhat.com/1337561
1873 virt-customize --ssh-inject not applying correct file permission
1874 https://bugzilla.redhat.com/1335671
1876 extra quotes around UUID confuses findfs in RHEL (but not in
1877 Fedora)
1878 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 https://bugzilla.redhat.com/1327488
1884 RFE: Allow p2v kernel options without p2v.server to set defaults
1885 https://bugzilla.redhat.com/1325825
1887 virt-v2v should prevent using multiple '-b' and '-n' option appears
1888 on the command line
1889 https://bugzilla.redhat.com/1321620
1891 libguestfs: error: could not parse integer in version number: 7"
1892 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 https://bugzilla.redhat.com/1317843
1898 `virt-builder --update` fails with: "dnf -y --best upgrade: command
1899 exited with an error"
1900 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 https://bugzilla.redhat.com/1316041
1906 virt-rescue fails, but missing error message
1907 https://bugzilla.redhat.com/1314244
1909 RFE: virt-p2v log window should process colour escapes and
1910 backspaces
1911 https://bugzilla.redhat.com/1312254
1913 virt-v2v -o libvirt doesn't preserve or use correct <graphics
1914 type="vnc|spice">
1915 https://bugzilla.redhat.com/1309706
1917 error: internal error: Invalid floppy device name: hdb
1918 https://bugzilla.redhat.com/1309619
1920 Wrong warning info "use standard VGA" shows when converting windows
1921 > 7 by virt-v2v
1922 https://bugzilla.redhat.com/1309580
1924 OS name of win8.1 x64 guest shows incorrect in rhevm3.6 general
1925 info
1926 https://bugzilla.redhat.com/1308769
1928 virt-v2v does not copy additional disks to Glance
1929 https://bugzilla.redhat.com/1306666
1931 Failure when disk contains an LV with activationskip=y
1932 https://bugzilla.redhat.com/1296606
1934 virt-v2v doesn't remove VirtualBox additions correctly because of
1935 file quoting
1936 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 https://bugzilla.redhat.com/1293276
1942 guestfish can not ll a symbolic link dir or edit a file in it
1943 https://bugzilla.redhat.com/1278878
1945 guestfish should be able to handle LVM thin layouts
1946 https://bugzilla.redhat.com/1264835
1948 ppc64le: virt-customize --install fail to detect the guest arch
1949 https://bugzilla.redhat.com/1264332
1951 Test that trimming in virt-v2v doesn't regress
1952 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 https://bugzilla.redhat.com/1229386
1958 virt-p2v in non-GUI mode doesn't show any conversion progress or
1959 status
1960 https://bugzilla.redhat.com/1227599
1962 P2V invalid password prints unexpected end of file waiting for
1963 command prompt.
1964 https://bugzilla.redhat.com/1224795
1966 On Ubuntu, virt-builder --install and --update cannot use the
1967 network
1968 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 https://bugzilla.redhat.com/1203898
1974 Support inspecting docker images without /etc/fstab
1975 https://bugzilla.redhat.com/1186935
1977 libguestfs cannot inspect recent Fedora / RHEL >= 7 when /usr is a
1978 separate partition
1979 https://bugzilla.redhat.com/1167916
1981 P2V: invalid conversion server prints unexpected end of file
1982 waiting for password prompt.
1983 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 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 https://bugzilla.redhat.com/1089100
1994 NetworkManager avc unlink denied for resolv.conf after using
1995 --selinux-relabel
1996 https://bugzilla.redhat.com/983969
1998 RFE: virt-sysprep should be SELinux-aware
1999 https://bugzilla.redhat.com/855058
2001 RFE: virt-p2v: display more information about storage devices
2002 https://bugzilla.redhat.com/554829
2004 SELinux handling could be done better.
2005
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 New features
2012 New tools
2013 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 New features in existing tools
2019 Virt-customize knows how to write a random seed to CirrOS (Pino
2021 Toscano).
2022 On Fedora, virt-customize runs dnf(8) with the --best flag, ensuring it
2024 always updates to the latest available packages.
2025 Virt-builder now provides 32 bit Fedora templates.
2027 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 Virt-builder can now fetch cloud images using Simple Streams v1.0
2033 metadata (Pino Toscano).
2034 Virt-builder can now fetch openSUSE cloud images out of the box (Cédric
2036 Bosdonnat).
2037 Virt-customize will now use stronger (SHA-512) encrypted passwords by
2039 default on openSUSE ≥ 11 (Pino Toscano).
2040 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 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 Virt-v2v now has an --in-place flag/mode, allowing in-place conversion
2051 of guests (Roman Kagan).
2052 Virt-v2v has a --compressed option for creating compressed qcow2 output
2054 files.
2055 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 Virt-v2v now processes RAM sizes correctly for 64 bit guests when
2061 running on a 32 bit host.
2062 Language bindings
2064 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 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 The quality of the Ruby rdoc (documentation) has been improved (Pino
2074 Toscano).
2075 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 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 Inspection
2090 Alpine Linux and the APK package manager, ALT Linux, Frugalware, and
2092 PLD Linux are now recognized (Pino Toscano).
2093 If it exists, /etc/os-release will be preferred for inspecting Linux
2095 guests (Pino Toscano).
2096 The correct kernel version is returned for Windows guests ≥ 10.
2098 Documentation
2100 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 Architectures and platforms
2106 Libguestfs now supports ARM 64 bit platforms with vGICv3.
2108 Security
2110 See also guestfs-security(1).
2111 "CVE-2015-5745"
2113 https://bugzilla.redhat.com/1251157
2114 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 · your libguestfs program runs untrusted programs out of the
2121 guest (using "guestfs_sh" etc), or
2122 · another exploit was found in (for example) kernel filesystem
2124 code that allowed a malformed filesystem to take over the
2125 appliance.
2126 If you use sVirt to confine qemu, that would thwart some attacks.
2128 Virt-customize permissions on .ssh, .ssh/authorized_keys
2130 https://bugzilla.redhat.com/1260778.
2131 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 API
2139 New APIs
2140 "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 libguestfs: trace: foo
2147 to:
2149 libguestfs: trace: ID: foo
2151 making it easier to follow traces in multi-threaded programs, or
2153 where a program uses multiple handles (especially virt-v2v).
2154 "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 Other API changes
2161 "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 It also adds "full", which corresponds to fully allocated, but uses
2168 posix_fallocate(3) for efficiency.
2169 "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 "guestfs_add_drive"
2176 The existing "username" and "secret" parameters can be used to
2177 supply authentication for iSCSI (Pino Toscano).
2178 Build changes
2180 The "./configure --enable-valgrind-daemon" option has been removed.
2181 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 Virt-p2v can now be built on RHEL 6-era (c.2010) Linux distros.
2186 OCaml ≥ 3.11 (released in 2008) is now required to build from git.
2188 Building the Perl bindings now requires "Module::Build" (instead of
2190 "ExtUtils::MakeMaker").
2191 Builds should be faster (especially when incrementally rebuilding),
2193 because work was done to reduce build times.
2194 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 "make check" tests now run in parallel (within each test directory).
2200 "make install" no longer installs OCaml bindtests.* files incorrectly.
2202 "make install" can now be run twice. Previously it would fail on the
2204 second run.
2205 "make clean" should now remove nearly every file that "make" creates.
2207 A new "make installcheck" rule has been added, allowing the installed
2209 copy of libguestfs to be tested.
2210 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 The appliance now passes the NIC name to dhcpd, fixing hangs when
2216 running the appliance on some distros (Cédric Bosdonnat).
2217 OCaml "Guestfs.Errno" is now generated (Pino Toscano).
2219 In OCaml tools, common code now handles --debug-gc, --verbose and other
2221 common options (Roman Kagan, Pino Toscano).
2222 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 There is a new internal API for reading/writing a subprocess via a pipe
2227 from library code.
2228 Used "deheader" program to remove unused "#include" directives.
2230 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 Many more virt-v2v tests will now be run even if you don't have
2238 rhsrvany and virtio-win installed (Roman Kagan).
2239 The huge configure.ac file has been split into several smaller files
2241 called m4/guestfs_*.m4.
2242 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 There is a new top level website/ directory containing the public
2248 http://libguestfs.org website (or most of it).
2249 The fuzz testing of inspection (tests/fuzz) has been removed.
2251 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 Bugs fixed
2257 https://bugzilla.redhat.com/1294956
2258 set-label returns wrong error message when set the ext3/ext4
2259 filesystem label
2260 https://bugzilla.redhat.com/1288733
2262 Add a Fedora 23 32-bit base image for virt-builder
2263 https://bugzilla.redhat.com/1288201
2265 virt-builder writes temporary files to /tmp
2266 https://bugzilla.redhat.com/1285847
2268 virt-resize does not copy logical partitions
2269 https://bugzilla.redhat.com/1281578
2271 virt-inspector returns version 6.3 for win10 images (should return
2272 10.0)
2273 https://bugzilla.redhat.com/1281577
2275 virt-inspector --xpath segfault on attribute get
2276 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 https://bugzilla.redhat.com/1279273
2282 About compression option for qcow2
2283 https://bugzilla.redhat.com/1278878
2285 guestfish should be able to handle LVM thin layouts
2286 https://bugzilla.redhat.com/1278382
2288 DNF python programming error when run from virt-builder
2289 https://bugzilla.redhat.com/1278371
2291 inspection returns arch="unknown" for Windows guest if file command
2292 is not installed
2293 https://bugzilla.redhat.com/1277274
2295 Document permissions needed for non-admin users to use virt-v2v
2296 https://bugzilla.redhat.com/1277122
2298 RFE: virt-sparsify: make '--in-place' sparsification safe to abort
2299 (gracefully or ungracefully)
2300 https://bugzilla.redhat.com/1277074
2302 Virt-p2v client shouldn't present the vdsm option because it's not
2303 usable
2304 https://bugzilla.redhat.com/1276540
2306 virt-v2v fails to convert Windows raw image: error "device name is
2307 not a partition"
2308 https://bugzilla.redhat.com/1275806
2310 virt-builder: error: [file] is not a regular file in the guest
2311 https://bugzilla.redhat.com/1270011
2313 Simplestreams test fails: virt-builder: error: the value for the
2314 key 'size' is not an integer
2315 https://bugzilla.redhat.com/1267032
2317 guestfish copy-in command behaves oddly/unexpectedly with wildcards
2318 https://bugzilla.redhat.com/1262983
2320 python: Cannot compile pip module if installed libguestfs != pip
2321 guestfs version
2322 https://bugzilla.redhat.com/1262127
2324 Better diagnostic message when virbr0 doesn't exist
2325 https://bugzilla.redhat.com/1261436
2327 No warning shows when convert a win7 guest with AVG AntiVirus
2328 installed
2329 https://bugzilla.redhat.com/1260778
2331 virt-builder --ssh-inject doesn't set proper permissions on created
2332 files
2333 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 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 https://bugzilla.redhat.com/1258342
2343 extra slashes in vcenter URL confuses virt-v2v
2344 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 https://bugzilla.redhat.com/1256405
2350 virt-builder created Fedora 22 32bit disk image cannot be updated
2351 https://bugzilla.redhat.com/1256222
2353 virt-p2v no GUI mode:error opening control connection to
2354 $ip:22:unexpected …rompt
2355 https://bugzilla.redhat.com/1251909
2357 Option -oa preallocated -of qcow2 of virt-v2v didn't work
2358 efficiently
2359 https://bugzilla.redhat.com/1250715
2361 v2v: spaces need to be escaped as %20 in paths
2362 https://bugzilla.redhat.com/1248678
2364 Close all incoming ports on virt-p2v ISO
2365 https://bugzilla.redhat.com/1246882
2367 man virt-customize shows synopsis twice
2368 https://bugzilla.redhat.com/1242853
2370 mount-loop failed to setup loop device: No such file or directory
2371 https://bugzilla.redhat.com/1237136
2373 BUG: unable to handle kernel NULL pointer dereference at <addr> in
2374 function __blkg_lookup
2375 https://bugzilla.redhat.com/1230412
2377 virt-v2v should ignore bogus kernel entries in grub config
2378 https://bugzilla.redhat.com/1229119
2380 Unrelated info in fstab makes virt-v2v fail with unclear error info
2381 https://bugzilla.redhat.com/1227609
2383 virt-p2v: Using "Back" button causes output list to be repopulated
2384 multiple times
2385 https://bugzilla.redhat.com/1225789
2387 Wrong video driver is installed for rhel5.11 guest after conversion
2388 to libvirt
2389 https://bugzilla.redhat.com/1204131
2391 RFE: virt-builder creates qcow v3 images, add build option for qcow
2392 v2
2393 https://bugzilla.redhat.com/1176801
2395 File /etc/sysconfig/kernel isn't updated when convert XenPV guest
2396 with regular kernel installed
2397 https://bugzilla.redhat.com/1174551
2399 "lstatnslist" and "lstatlist" don't give an error if the API is
2400 used wrongly
2401 https://bugzilla.redhat.com/1168223
2403 koji spin-livecd cannot build a working live CD
2404 https://bugzilla.redhat.com/1165785
2406 mount-loop command fails: mount failed: Unknown error -1
2407 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 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 https://bugzilla.redhat.com/1011907
2418 mount-loop failed to setup loop device: No such file or directory
2419
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 New features
2426 New tools
2427 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 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 New features in existing tools
2437 virt-v2v(1) -i ova mode can now read a wider range of OVA files, and
2439 also unpacked files (directories).
2440 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 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 virt-v2v disables Windows autoreboot, making debugging conversion
2448 failures on Windows easier.
2449 virt-v2v now comes with an extensive external test suite. See
2451 virt-v2v-test-harness(1).
2452 virt-v2v allows virtio drivers to come from any location (Roman Kagan),
2454 and drivers can be read directly from the virtio ISO.
2455 virt-v2v supports conversion of Windows ≥ 8. Note this is
2457 experimental, and possibly broken. Use with caution.
2458 virt-v2v can now convert UEFI guests.
2460 virt-p2v(1) adds a network configuration dialog.
2462 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 virt-p2v now uses the more advanced metacity window manager (instead of
2468 matchbox).
2469 virt-sysprep(1) will remove "/var/spool/mail/username" for non-root
2471 accounts (Hu Tao).
2472 virt-customize(1), virt-builder(1) and virt-sysprep have the following
2474 new options:
2475 --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 --copy
2481 copy files inside the guest (Maros Zatko)
2482 --copy-in
2484 copy host files recursively into the guest (Pino Toscano)
2485 --move
2487 move files inside the guest (Maros Zatko)
2488 --ssh-inject
2490 inject SSH keys into a guest (Pino Toscano)
2491 --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 --touch
2501 touch a file in the guest (Pino Toscano)
2502 --truncate
2504 --truncate-recursive
2505 truncate files (Maros Zatko)
2506 Improvements to virt-customize firstboot support. In particular,
2508 Windows firstboot should work as well as Linux (Roman Kagan).
2509 virt-df(1) can now use PolicyKit, SASL and other authentication methods
2511 when getting the list of domains from libvirt.
2512 Improvements to guestfish bash completion (Pino Toscano).
2514 Bash completion now completes short options as well as long options
2516 (Pino Toscano).
2517 guestfish(1) now displays a command synopsis if the number of
2519 parameters given to a command is wrong (Hu Tao).
2520 virt-builder now supports Red Hat Enterprise Linux versions back to
2522 RHEL 3.
2523 virt-builder supports SUSE guests using zypper (Cédric Bosdonnat).
2525 Language bindings
2527 The Java bindings now include validated Javadoc, and other improvements
2529 (Pino Toscano).
2530 Multiple fixes and improvements to the PHP bindings (Pino Toscano).
2532 Inspection
2534 Inspection can now get icons from RHEL 7 and CentOS 7.
2536 /etc/favicon.png is now allowed to be a symbolic link.
2538 For RPM-based guests, inspection now returns RPM Epoch fields.
2540 Debian packages now have separate Epoch and Version fields (Nikos
2542 Skalkotos).
2543 OpenBSD detection added, FreeBSD and NetBSD added as separate
2545 "distros", and other BSD inspection improvements and bug fixes (Nikos
2546 Skalkotos).
2547 CoreOS detection added (Nikos Skalkotos).
2549 The package manager in Fedora ≥ 22 is "dnf".
2551 ReactOS guests can be inspected (Maros Zatko).
2553 Add support for UEFI guests.
2555 Inspection now works when kernel modules are gzip or xz compressed
2557 (Pino Toscano).
2558 Inspection now recognizes ppc64 and ppc64le guests (Maros Zatko).
2560 Inspection lists the installed applications on Archlinux guests (Nikos
2562 Skalkotos).
2563 Architectures and platforms
2565 PPC64 (POWER7) and PPC64LE (POWER8) architectures are now much better
2567 supported, and should work out of the box.
2568 For aarch64, we use AAVMF (an open source UEFI implementation based on
2570 OVMF) if available to run the appliance.
2571 For armv7, we now use the -M virt machine type by default.
2573 There is better support for compiling on non-Linux platforms (Pino
2575 Toscano, Margaret Lewicka).
2576 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 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 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 For further information, see upstream commit
2601 https://github.com/libguestfs/libguestfs/commit/6c6ce85f94c36803fe2db35a98db436bff0c14b0
2602 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 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 API
2620 New APIs
2621 "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 "guestfs_blockdev_setra"
2627 Adjust readahead parameter for devices. See "blockdev --setra"
2628 command.
2629 "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 "guestfs_btrfs_filesystem_defragment"
2638 Filesystem defragmentation support for Btrfs filesystems (Hu Tao).
2639 "guestfs_btrfs_image"
2641 Create an image of a Btrfs filesystem (Chen Hanxiao)
2642 "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 "guestfs_btrfs_rescue_chunk_recover"
2654 Scan and recover the chunk tree in Btrfs filesystems (Hu Tao).
2655 "guestfs_btrfs_rescue_super_recover"
2657 Restore superblocks in Btrfs filesystems (Hu Tao).
2658 "guestfs_btrfs_replace"
2660 Replace a device in a Btrfs filesystem (Cao Jin).
2661 "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 "guestfs_btrfs_subvolume_get_default"
2669 Get the default subvolume of a Btrfs filesystem (Hu Tao).
2670 "guestfs_btrfs_subvolume_show"
2672 List detailed information about the subvolume of a Btrfs filesystem
2673 (Hu Tao).
2674 "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 "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 "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 "guestfs_part_get_gpt_guid"
2694 "guestfs_part_set_gpt_guid"
2695 Get and set the GPT per-partition GUID.
2696 "guestfs_part_get_mbr_part_type"
2698 Get MBR partition type (Chen Hanxiao).
2699 "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 Other API changes
2706 "guestfs_disk_create" can now use VMDK files as backing files.
2708 "guestfs_btrfs_subvolume_snapshot" takes extra optional parameters (all
2710 added by Hu Tao):
2711 "ro"
2713 for creating a read-only Btrfs snapshot
2714 "qgroupid"
2716 for adding the snapshot to a qgroup
2717 "guestfs_btrfs_subvolume_create" can also take the optional "qgroupid"
2719 parameter (Hu Tao).
2720 "guestfs_set_uuid" can set UUID of swap partitions, Btrfs (Hu Tao, Chen
2722 Hanxiao).
2723 "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 "guestfs_mkfs" has a new optional "label" parameter to set the initial
2729 label of the new filesystem (Pino Toscano).
2730 "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 Environment variables now let you write "LIBGUESTFS_DEBUG=true",
2736 "LIBGUESTFS_DEBUG=0" and so on.
2737 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 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 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 OCaml .annot files are now created, so IDEs and editors like emacs and
2751 vi can browse OCaml types in the source code.
2752 Various fixes to allow different host/appliance architecture builds
2754 (Pino Toscano).
2755 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 "-fno-strict-overflow" is used throughout the build to avoid dubious
2761 GCC optimizations.
2762 Multiple cleanups to support GCC 5.
2764 OCaml OUnit2 is needed to run some OCaml tests.
2766 Creating a statically linked libguestfs.a should work again.
2768 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 Internationalization
2774 The translation service has changed from Transifex to Zanata.
2775 Many more translations are available now, for both library and tools
2777 messages and documentation.
2778 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 "COMPILE_REGEXP" macros are used to simplify PCRE constructors and
2785 destructors.
2786 In the generator, "Pointer" arguments have finally been implemented.
2788 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 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 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 Bugs fixed
2802 https://bugzilla.redhat.com/1239053
2803 virt-v2v error reporting when grub.conf cannot be parsed by Augeas
2804 https://bugzilla.redhat.com/1238053
2806 v2v:Duplicate disk target set when convert guest with cdrom
2807 attached
2808 https://bugzilla.redhat.com/1237869
2810 Virtio drivers are not installed for windows 2008 guests by
2811 virt-v2v
2812 https://bugzilla.redhat.com/1234351
2814 virt-v2v Support for Fedora virtio-win drivers
2815 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 https://bugzilla.redhat.com/1229385
2821 virt-p2v in kernel command line mode should power off the machine
2822 after conversion
2823 https://bugzilla.redhat.com/1229340
2825 virt-p2v no GUI mode appends \n to the final command line parameter
2826 https://bugzilla.redhat.com/1229305
2828 virt-sysprep at cleanup deletes /var/spool/at/.SEQ which results in
2829 failing at
2830 https://bugzilla.redhat.com/1226794
2832 "Doing conversion……" still shows after cancel the conversion from
2833 virt-p2v client
2834 https://bugzilla.redhat.com/1215042
2836 Memory leak in virNetSocketNewConnectUNIX
2837 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 https://bugzilla.redhat.com/1213247
2843 virt tools should print the same format of version string
2844 https://bugzilla.redhat.com/1212808
2846 RFE: virt-builder --touch
2847 https://bugzilla.redhat.com/1212807
2849 virt-builder --selinux-relabel flag fails on cross-architecture
2850 builds
2851 https://bugzilla.redhat.com/1212680
2853 RFE: virt-inspector xpath query should output a neat format of the
2854 query element
2855 https://bugzilla.redhat.com/1212152
2857 virt-builder firstboot-command fails: File name too long
2858 https://bugzilla.redhat.com/1211996
2860 virt-inspector gives incorrect arch (ppc64) for ppc64le guest
2861 https://bugzilla.redhat.com/1203817
2863 RFE: virt-customize --move and --copy
2864 https://bugzilla.redhat.com/1201526
2866 index-parser can't parse systemd mount files properly
2867 https://bugzilla.redhat.com/1196101
2869 virt-builder --upload option doesn't work to a FAT partition
2870 https://bugzilla.redhat.com/1196100
2872 virt-builder -x option on its own does not enable tracing
2873 https://bugzilla.redhat.com/1195204
2875 `virt-builder` should create $HOME/.cache directory if it already
2876 doesn't exist
2877 https://bugzilla.redhat.com/1193237
2879 Virt-builder fingerprint is required even when no check desired
2880 https://bugzilla.redhat.com/1189284
2882 virt-resize should preserve GPT partition UUIDs, else EFI guests
2883 become unbootable
2884 https://bugzilla.redhat.com/1188866
2886 Performance regression in virt-builder when uncompressing image
2887 https://bugzilla.redhat.com/1186800
2889 virt-v2v should support gzip format ova as input
2890 https://bugzilla.redhat.com/1185561
2892 virt-sparsify should ignore read-only LVs
2893 https://bugzilla.redhat.com/1182463
2895 "mknod-b", "mknod-c", and "mkfifo" do not strip non-permissions
2896 bits from "mode"
2897 https://bugzilla.redhat.com/1176493
2899 virt-v2v ignores sound device when convert xen guest to local kvm
2900 https://bugzilla.redhat.com/1175676
2902 Typo error in 'help ping-daemon'
2903 https://bugzilla.redhat.com/1175196
2905 "parse-environment" and "parse-environment-list" fail to parse
2906 "LIBGUESTFS_TRACE = 0"
2907 https://bugzilla.redhat.com/1175035
2909 "is-blockdev"/"is-blockdev-opts" fail to detect "/dev/sda"
2910 https://bugzilla.redhat.com/1174280
2912 RFE: Allow v2v conversion of Oracle Linux 5.8 VMware VM
2913 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 https://bugzilla.redhat.com/1174123
2919 Graphics password disappear after conversion of virt-v2v
2920 https://bugzilla.redhat.com/1174073
2922 The listen address for vnc is changed after conversion by virt-v2v
2923 https://bugzilla.redhat.com/1171666
2925 inspection thinks EFI partition is a separate operating system
2926 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 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 https://bugzilla.redhat.com/1170073
2937 virt-v2v picks debug kernels over non-debug kernels when versions
2938 are equal
2939 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 https://bugzilla.redhat.com/1169015
2945 virt-resize --expand fails on ubuntu-14.04.img image (regression)
2946 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 https://bugzilla.redhat.com/1167921
2952 p2v: No Network Connection dialog
2953 https://bugzilla.redhat.com/1167774
2955 virt-p2v fails with error:"nbd.c:nbd_receive_negotiate():L501: read
2956 failed"
2957 https://bugzilla.redhat.com/1167623
2959 Remove "If reporting bugs, run virt-v2v with debugging enabled .."
2960 message when running virt-p2v
2961 https://bugzilla.redhat.com/1167601
2963 "Conversion was successful" pop out even virt-p2v fails
2964 https://bugzilla.redhat.com/1167302
2966 virt-v2v: warning: ova hard disk has no parent controller when
2967 convert from a ova file
2968 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 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 https://bugzilla.redhat.com/1165785
2978 mount-loop command fails: mount failed: Unknown error -1
2979 https://bugzilla.redhat.com/1165569
2981 Disable "cancel conversion" button after virt-p2v conversion
2982 finished
2983 https://bugzilla.redhat.com/1165564
2985 Provide Reboot/Shutdown button after virt-p2v
2986 https://bugzilla.redhat.com/1164853
2988 Booting in qemu found no volume groups and failed checking the
2989 filesystems
2990 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 https://bugzilla.redhat.com/1164697
2996 typo errors in man pages
2997 https://bugzilla.redhat.com/1164619
2999 Inspect-get-icon failed on RHEL7 guest
3000 https://bugzilla.redhat.com/1162966
3002 xfs should also give a warning out to let customer know the
3003 limitation
3004 https://bugzilla.redhat.com/1161575
3006 Failed to import guest with "rtl8139" nic to openstack server
3007 after converted by v2v
3008 https://bugzilla.redhat.com/1159651
3010 virt-sysprep firstboot script is not deleted if it reboot a RHEL 7
3011 guest
3012 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 https://bugzilla.redhat.com/1159016
3018 libvirt backend does not set RBD password
3019 https://bugzilla.redhat.com/1158526
3021 Use password file instead of process interaction
3022 https://bugzilla.redhat.com/1157679
3024 virt-p2v-make-disk should add firmwares
3025 https://bugzilla.redhat.com/1156449
3027 libguestfs FTBFS on f21 ppc64le
3028 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 https://bugzilla.redhat.com/1155121
3034 Virt-v2v will fail when using relative path for -i ova
3035 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 https://bugzilla.redhat.com/1153589
3042 virt-v2v will hang when converting esx guest before disk copy phase
3043 https://bugzilla.redhat.com/1152998
3045 virt-v2v / qemu-img fails on ova image
3046 https://bugzilla.redhat.com/1151910
3048 virt-ls should remove '/' in the output when specify the directory
3049 name as /etc/
3050 https://bugzilla.redhat.com/1151900
3052 Should also add a field for directory files when run virt-ls with
3053 --csv option
3054 https://bugzilla.redhat.com/1151033
3056 virt-v2v conversions from VMware vCenter server run slowly
3057 https://bugzilla.redhat.com/1146832
3059 virt-v2v fail to convert guest with disk type volume
3060 https://bugzilla.redhat.com/1146007
3062 Input/output error during conversion of esx guest.
3063 https://bugzilla.redhat.com/1135585
3065 [RFE] virt-builder should support copying in a directory/list of
3066 files
3067 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 https://bugzilla.redhat.com/1079625
3074 virt-sparsify fails if a btrfs filesystem contains readonly
3075 snapshots
3076 https://bugzilla.redhat.com/1075164
3078 RFE: allow passing in a pre-opened libvirt connection from python
3079 https://bugzilla.redhat.com/912499
3081 Security context on image file gets reset
3082 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 https://bugzilla.redhat.com/855059
3088 RFE: virt-p2v: display more information about network devices such
3089 as topology, bonding, etc.
3090 https://bugzilla.redhat.com/823758
3092 p2v client should have largest number restrictions for CPU and
3093 Memory settings
3094 https://bugzilla.redhat.com/709327
3096 hivex cannot read registry hives from ReactOS
3097 https://bugzilla.redhat.com/709326
3099 virt-inspector cannot detect ReactOS
3100 https://bugzilla.redhat.com/119673
3102 installation via NFS doesn't seem to work
3103
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 New features
3110 Tools
3111 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 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 virt-builder(1) has a new "--machine-readable" option to make it
3128 simpler to consume virt-builder from other programs.
3129 New virt-builder(1) and virt-customize(1) --chmod option.
3131 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 New guestmount(1) --fd option, allowing you to run guestmount captive
3140 under another process.
3141 virt-sparsify(1) has a new --tmp option allowing you to precisely
3143 control where temporary files are stored.
3144 virt-sparsify(1) can now write to a block device.
3146 virt-customize(1) and virt-sysprep(1) now support adding firstboot
3148 scripts to Windows guests.
3149 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 The virt tools now have coloured output: green for OK, red for errors,
3155 blue for warnings.
3156 Language bindings
3158 You can build a Python distribution using "make -C python sdist"
3160 Ruby bindings have switched from "Test::Unit" to "MiniTest".
3162 The Java bindings are now compatible with OpenJDK 8 (Pino Toscano).
3164 Inspection
3166 Oracle Linux is returned as "oraclelinux" (Nikos Skalkotos).
3168 Linux guests which do not have /etc/fstab can now be handled (Pino
3170 Toscano).
3171 Minix is returned as "minix" (Pino Toscano).
3173 Architectures
3175 Aarch64 (64 bit ARM) support has been added.
3177 Inspection and the "guestfs_file_architecture" call can now recognize
3179 arm (32 bit) and aarch64 guests.
3180 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 Since the libvirt XML comes from a trusted source (the libvirt
3190 daemon) it is not thought that this could have been exploitable.
3191 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 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 API
3202 New APIs
3203 "guestfs_clear_backend_setting"
3205 "guestfs_get_backend_setting"
3206 "guestfs_set_backend_setting"
3207 Use these APIs to set individual backend settings.
3208 "guestfs_cpio_out"
3210 Convert a directory within the disk image to cpio format.
3211 "guestfs_journal_get_realtime_usec"
3213 Fetch precise journal times, see sd_journal_get_realtime_usec(3).
3214 "guestfs_lstatns"
3216 "guestfs_lstatnslist"
3217 "guestfs_statns"
3218 Enhanced versions of "guestfs_lstat", "guestfs_lstatlist",
3219 "guestfs_stat" which return nanosecond timestamps.
3220 Build changes
3222 Libguestfs can now be built with qemu 2.x.
3223 Add support for packaging the appliance on Mageia (Joseph Wang, Thierry
3225 Vignaud).
3226 Augeas is now a required dependency.
3228 Flex and bison are now required dependencies.
3230 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 You can now connect gdb to qemu by specifying
3237 "LIBGUESTFS_BACKEND_SETTINGS=gdb"
3238 Serial BIOS (sgabios) is now used by the libvirt backend (on x86 only)
3240 so that we see early BIOS messages.
3241 For the OCaml virt tools, exceptions are now handled and printed by a
3243 common function.
3244 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 There is now a test for booting the appliance repeatedly. Useful for
3250 finding kernel leaks. See: tests/qemu/qemu-boot.c
3251 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 GCC warnings are now enabled for OCaml-C bindings in the OCaml virt
3257 tools.
3258 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 The FUSE tests were rewritten in C to ensure finer control over how
3264 system calls are tested.
3265 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 The virt-resize(1) tests now use a stochastic method to ensure much
3270 deeper and broader testing.
3271 When the network is enabled, the appliance now uses DHCP to acquire an
3273 IP address.
3274 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 Bugs fixed
3282 https://bugzilla.redhat.com/1153515
3283 empty (but set) LIBGUESTFS_BACKEND prints libguestfs: error:
3284 invalid backend:
3285 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 https://bugzilla.redhat.com/1151738
3292 typo error in man page of virt-edit
3293 https://bugzilla.redhat.com/1151033
3295 virt-v2v conversions from VMware vCenter server run slowly
3296 https://bugzilla.redhat.com/1150880
3298 virt-v2v: warning: display <graphics type='sdl'> was ignored when
3299 converting rhel5 guest with sdl graphics
3300 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 https://bugzilla.redhat.com/1150815
3306 Can not find "RECURSIVE LONG LISTING" in 'man virt-diff'
3307 https://bugzilla.redhat.com/1150701
3309 virt-v2v does not fstrim data disks and non-mounted filesystems
3310 https://bugzilla.redhat.com/1150475
3312 Exporting 2+ disk guest to RHEV, only one disk shows after import
3313 https://bugzilla.redhat.com/1148355
3315 virt-filesystems: incorrect LVM vg name when listing Fedora 21
3316 Alpha Atomic image filesystems
3317 https://bugzilla.redhat.com/1148072
3319 Option missing --no-selinux-relabel
3320 https://bugzilla.redhat.com/1148012
3322 RFE: Allow qemu-bridge-helper to be used to implement
3323 guestfs_set_network
3324 https://bugzilla.redhat.com/1146815
3326 virt-v2v prints warning: /files/etc/fstab/8/spec references unknown
3327 device "cdrom"
3328 https://bugzilla.redhat.com/1146275
3330 regression setting root password with virt-builder/virt-customize
3331 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 https://bugzilla.redhat.com/1145995
3337 Improve the error info when converting windows guest with unclean
3338 file system
3339 https://bugzilla.redhat.com/1145916
3341 virt-v2v fails to convert win7 guest
3342 https://bugzilla.redhat.com/1144891
3344 RFE: stat calls do not return nanosecond timestamps
3345 https://bugzilla.redhat.com/1144766
3347 futimens() is a no-op via guestmount
3348 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 https://bugzilla.redhat.com/1143949
3355 virt-customize option '--password-crypto' do not work
3356 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 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 https://bugzilla.redhat.com/1143866
3366 virt-v2v fails with error: cannot open Packages index using db5
3367 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 https://bugzilla.redhat.com/1142186
3374 virt-sysprep option '--mount-options' don't work well
3375 https://bugzilla.redhat.com/1142158
3377 Illegal command 'part-get-name /dev/sda1 1' cause libguestfs
3378 appliance crashed
3379 https://bugzilla.redhat.com/1142004
3381 virt-v2v prints warning:WARNING:/files/boot/grub/device.map
3382 references unknown device "xvda"
3383 https://bugzilla.redhat.com/1141723
3385 virt-v2v: error: disk sda has no defined format shows when
3386 converting xen hvm guest
3387 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 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 https://bugzilla.redhat.com/1141157
3397 virt-sysprep option '--user-accounts' don't work well
3398 https://bugzilla.redhat.com/1141145
3400 virt-v2v fails to convert xen pv guests.
3401 https://bugzilla.redhat.com/1141113
3403 virt-v2v fails to convert esx guests
3404 https://bugzilla.redhat.com/1140946
3406 qemu-img shows error message for backing file twice
3407 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 https://bugzilla.redhat.com/1140547
3413 virt-builder option '--format' don't work well
3414 https://bugzilla.redhat.com/1140156
3416 RFE: Export to RHEV data domain
3417 https://bugzilla.redhat.com/1140050
3419 No error shows when multiple conflicting options used with virt-v2v
3420 https://bugzilla.redhat.com/1139973
3422 Improve the error info when converting xen guest with no
3423 passwordless SSH access configured
3424 https://bugzilla.redhat.com/1139543
3426 Improve the error info when converting guest with no space left
3427 https://bugzilla.redhat.com/1138586
3429 No error shows when converting running guest with virt-v2v
3430 https://bugzilla.redhat.com/1138184
3432 virt-v2v will fail when converting guests with initramfs-*kdump.img
3433 under /boot
3434 https://bugzilla.redhat.com/1138182
3436 xen guest will be kernel panic after converted by virt-v2v
3437 https://bugzilla.redhat.com/1130189
3439 Annoying message about permissions of /dev/kvm
3440 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 https://bugzilla.redhat.com/1122557
3446 virt-sparsify overwrites block devices if used as output files
3447 https://bugzilla.redhat.com/1113156
3449 Empty fstab breaks libguestfs inspection
3450 https://bugzilla.redhat.com/1111662
3452 Guestfs.Error("vgchange_uuid_all: Volume group has active logical
3453 volumes")
3454 https://bugzilla.redhat.com/1109174
3456 virt-win-reg manual page is corrupted
3457 https://bugzilla.redhat.com/1106548
3459 root gets an error accessing to a non-root dir on a snapshot
3460 guestmount VMDK img
3461 https://bugzilla.redhat.com/1103877
3463 These APIs also need to add to `guestfish -h` command list
3464 https://bugzilla.redhat.com/1102448
3466 mageia package list is incorrect
3467 https://bugzilla.redhat.com/1102447
3469 libguestfs 1.27.13 does not build due to libxml library order
3470 https://bugzilla.redhat.com/1100498
3472 RFE: non-polling mechanism to detect guestmount --no-fork readiness
3473 https://bugzilla.redhat.com/1099490
3475 scrub-file can't handle link file
3476 https://bugzilla.redhat.com/1099284
3478 typo errors in man pages
3479 https://bugzilla.redhat.com/1098718
3481 RFE: virt-builder aliases
3482 https://bugzilla.redhat.com/1096465
3484 virt-builder "proxy=off" setting doesn't turn off the proxy for
3485 downloads
3486 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 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 https://bugzilla.redhat.com/1091803
3496 tar-in-opts execute failed that cause libguestfs appliance crashed
3497 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 https://bugzilla.redhat.com/1088262
3504 virt-builder cannot write to a block device
3505 https://bugzilla.redhat.com/1085029
3507 Ruby tests fail with latest Ruby
3508 https://bugzilla.redhat.com/1079210
3510 virt-sparsify --in-place cannot sparsify as much as it should
3511 https://bugzilla.redhat.com/1079182
3513 virt-df cannot report used disk space of windows guest when updated
3514 to 6.5
3515 https://bugzilla.redhat.com/1077817
3517 virt-builder error: "syntax error at line 3: syntax error"
3518 https://bugzilla.redhat.com/1056290
3520 virt-sparsify overwrites block devices if used as output files
3521 https://bugzilla.redhat.com/812970
3523 virt-rescue cannot set ≥<rescue> prompt, on Ubuntu 12.04
3524
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 New features
3531 Tools
3532 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 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 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 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 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 virt-win-reg(1) allows you to use URIs to specify remote disk images.
3564 virt-format(1) can now pass the extra space that it recovers back to
3566 the host.
3567 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 virt-make-fs(1) was rewritten in C, but is unchanged in terms of
3574 functionality and command line usage.
3575 Language bindings
3577 The OCaml bindings have a new "Guestfs.Errno" module, used to check the
3579 error number returned by "Guestfs.last_errno".
3580 PHP tests now work. (Pino Toscano)
3582 Inspection
3584 Inspection can recognize Debian live images.
3586 Architectures
3588 ARMv7 (32 bit) now supports KVM acceleration.
3590 Aarch64 (ARM 64 bit) is supported, but the appliance part does not work
3592 yet.
3593 PPC64 support has been fixed and enhanced.
3595 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 This was caused by a NULL pointer dereference causing a denial of
3604 service, and is not thought to be exploitable any further.
3605 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 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 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 New APIs
3624 "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 "guestfs_add_domain": new parameters: "cachemode", "discard"
3632 These parameters are passed through when adding the domain's disks.
3633 "guestfs_blkdiscard"
3635 Discard all blocks on a guestfs device. Combined with the
3636 "discard" parameter above, this makes the host file sparse.
3637 "guestfs_blkdiscardzeroes"
3639 Test if discarded blocks read back as zeroes.
3640 "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 "guestfs_copy_attributes"
3648 Copy attributes (like permissions, xattrs, ownership) from one file
3649 to another. (Pino Toscano)
3650 "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 "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 export LIBGUESTFS_BACKEND=direct
3662 export LIBGUESTFS_BACKEND_SETTINGS=force_tcg
3663 "guestfs_part_get_name"
3665 Get the label or name of a partition (for GPT disk images).
3666 Build changes
3668 The following extra packages are required to build libguestfs 1.26:
3669 supermin ≥ 5
3671 Supermin version 5 is required to build this version of libguestfs.
3672 flex, bison
3674 Virt-builder now uses a real parser to parse its metadata file, so
3675 these tools are required.
3676 xz This is now a required build dependency, where previously it was
3678 (in theory) optional.
3679 Internals
3681 PO message extraction rewritten to be more robust. (Pino Toscano)
3682 "podwrapper" gives an error if the --insert or --verbatim argument
3684 pattern is not found.
3685 Libguestfs now passes the qemu -enable-fips option to enable FIPS, if
3687 qemu supports it.
3688 "./configure --without-qemu" can be used if you don't want to specify a
3690 default hypervisor.
3691 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 Libvirt backend uses some funky C macros to generate XML. These are
3697 simpler and safer.
3698 The ChangeLog file format has changed. It is now just the same as "git
3700 log", instead of using a custom format.
3701 Appliance start-up has changed:
3703 · The libguestfs appliance now initializes LVM the same way as it is
3705 done on physical machines.
3706 · The libguestfs appliance does not write an empty string to
3708 /proc/sys/kernel/hotplug when starting up.
3709 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 Libguestfs can now be built on arches that have ocamlc(1) but not
3716 ocamlopt(1). (Hilko Bengen, Olaf Hering)
3717 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 The packagelist file uses "m4" for macro expansion instead of "cpp".
3723 Bugs fixed
3725 https://bugzilla.redhat.com/1073906
3726 java bindings inspect_list_applications2 throws
3727 java.lang.ArrayIndexOutOfBoundsException:
3728 https://bugzilla.redhat.com/1063374
3730 [RFE] enable subscription manager clean or unregister operation to
3731 sysprep
3732 https://bugzilla.redhat.com/1060404
3734 virt-resize does not preserve GPT partition names
3735 https://bugzilla.redhat.com/1057504
3737 mount-local should give a clearer error if root is not mounted
3738 https://bugzilla.redhat.com/1056290
3740 virt-sparsify overwrites block devices if used as output files
3741 https://bugzilla.redhat.com/1055452
3743 libguestfs: error: invalid backend: appliance
3744 https://bugzilla.redhat.com/1054761
3746 guestfs_pvs prints "unknown device" if a physical volume is missing
3747 https://bugzilla.redhat.com/1053847
3749 Recommended default clock/timer settings
3750 https://bugzilla.redhat.com/1046509
3752 ruby-libguestfs throws "expecting 0 or 1 arguments" on
3753 Guestfs::Guestfs.new
3754 https://bugzilla.redhat.com/1045450
3756 Cannot inspect cirros 0.3.1 disk image fully
3757 https://bugzilla.redhat.com/1045033
3759 LIBVIRT_DEFAULT_URI=qemu:///system breaks libguestfs
3760 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 https://bugzilla.redhat.com/1044014
3766 When SSSD is installed, libvirt configuration requires
3767 authentication, but not clear to user
3768 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 https://bugzilla.redhat.com/1039540
3775 virt-sysprep to delete more logfiles
3776 https://bugzilla.redhat.com/1033207
3778 RFE: libguestfs inspection does not recognize Free4NAS live CD
3779 https://bugzilla.redhat.com/1028660
3781 RFE: virt-sysprep/virt-builder should have an option to lock a user
3782 account
3783 https://bugzilla.redhat.com/1026688
3785 libguestfs fails examining libvirt guest with ceph drives: rbd:
3786 image name must begin with a '/'
3787 https://bugzilla.redhat.com/1022431
3789 virt-builder fails if $HOME/.cache doesn't exist
3790 https://bugzilla.redhat.com/1022184
3792 libguestfs: do not use versioned jar file
3793 https://bugzilla.redhat.com/1020806
3795 All libguestfs LVM operations fail on Debian/Ubuntu
3796 https://bugzilla.redhat.com/1008417
3798 Need update helpout of part-set-gpt-type
3799 https://bugzilla.redhat.com/953907
3801 virt-sysprep does not correctly set the hostname on Debian/Ubuntu
3802 https://bugzilla.redhat.com/923355
3804 guestfish prints literal "\n" in error messages
3805 https://bugzilla.redhat.com/660687
3807 guestmount: "touch" command fails: touch: setting times of
3808 `timestamp': Invalid argument
3809 https://bugzilla.redhat.com/593511
3811 [RFE] function to get partition name
3812 https://bugzilla.redhat.com/563450
3814 list-devices returns devices of different types out of order
3815
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 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 ARM (32 bit) and PPC64 are now fully supported.
3829 Tools
3831 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 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 virt-resize(1) and virt-sysprep can now use URIs to specify a remote
3842 disk.
3843 Use "guestfish -N filename=type" to create a named disk image (instead
3845 of the default test1.img etc).
3846 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 virt-format(1) and virt-make-fs(1): new --label option for setting
3852 filesystem label.
3853 virt-resize --no-sparse flag can be used to resize on to partitions and
3855 other targets that are not zeroed.
3856 Language bindings
3858 New bindings for the Go programming language.
3860 API
3862 Support for the systemd journal.
3864 "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 "guestfs_set_label" now works for XFS and btrfs.
3870 New GUESTFS_EVENT_WARNING event for warning messages.
3872 Inspection
3874 Better inspection of SUSE guests (Olaf Hering).
3876 Better support for non-standard Windows %systemroot% (Matthew Booth).
3878 Enhanced error reporting for Augeas errors.
3880 Security
3882 CVE-2013-2124
3883 https://bugzilla.redhat.com/show_bug.cgi?id=968306
3884 A denial of service was possible when inspecting certain guests.
3886 The fix has been backported to 1.20 and 1.22 branches.
3887 CVE-2013-4419
3889 https://www.redhat.com/archives/libguestfs/2013-October/msg00031.html
3890 Fix insecure temporary directory handling for remote guestfish.
3892 The fix has been backported to 1.20 and 1.22 branches.
3893 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 "is-file", "is-dir", "is-blockdev", "is-chardev", "is-fifo",
3909 "is-socket" APIs now have an extra "followsymlinks" flag.
3910 "add-drive" has a new "cachemode" parameter.
3912 Build changes
3914 The following packages are required to build libguestfs 1.24:
3915 Augeas ≥ 1.0.0
3917 The following optional packages may be added to enhance functionality
3919 but are not required:
3920 sd-journal
3922 To read journal files from guests which use that.
3923 url_mkcow
3925 For UML backend.
3926 curl
3928 gpg
3929 xz For virt-builder.
3930 golang ≥ 1.1.1
3932 For Go language bindings.
3933 Internals
3935 New "make check-*" rules replace "make extra-tests". See "make help"
3936 and guestfs(3) for details.
3937 Perl code can now be valgrinded.
3939 Inspection code is now fuzz-tested.
3941 "make" no longer recurses into the generator directory in every other
3943 directory. This reduces the overhead of builds considerably.
3944 Additional tests for Augeas, hivex.
3946 Add a launch timeout of 20 minutes waiting for the appliance to start
3948 up.
3949 Add a timeout (4 hours) to all tests so we can catch the case where
3951 qemu or other components hang.
3952 Use kvmclock and "-cpu host". This improves clock stability and
3954 overall performance.
3955 "./configure --enable-packet-dump" mode is fixed.
3957 "./configure --enable-valgrind-daemon" mode has been rewritten. It is
3959 now feasible for developers to keep this flag enabled at all times.
3960 Backends have been refactored to be modular (although they are not
3962 actually loadable modules).
3963 When enabled, the network now uses resolver configuration (ie.
3965 /etc/resolv.conf) from the host.
3966 Bugs fixed
3968 https://bugzilla.redhat.com/1019889
3969 libguestfs-tools.conf should have a man page
3970 https://bugzilla.redhat.com/1018149
3972 valgrind errors in btrfs_subvolume_list
3973 https://bugzilla.redhat.com/1002032
3975 mke2fs can't return the correct filesystem type when blockscount is
3976 less than 2048 for ext3
3977 https://bugzilla.redhat.com/1001876
3979 Update "rsync-out" helpout for using wildcard
3980 https://bugzilla.redhat.com/1001875
3982 Argument 'excludes' of tar-out does not work
3983 https://bugzilla.redhat.com/1000428
3985 virt-format uses wrong partition type for vfat filesystems
3986 https://bugzilla.redhat.com/1000121
3988 'sh' command before mount causes daemon to segfault
3989 https://bugzilla.redhat.com/998513
3991 guestfish does not work when you mix --remote and --add options
3992 https://bugzilla.redhat.com/998482
3994 guestfish remote prints "libguestfs: error: waitpid (qemu): No
3995 child processes"
3996 https://bugzilla.redhat.com/995711
3998 list-filesystems command fails if there are no block devices
3999 https://bugzilla.redhat.com/994517
4001 cache=none/O_DIRECT workaround doesn't work for images with backing
4002 files
4003 https://bugzilla.redhat.com/989356
4005 cap-get-file will return error if the file has not be set
4006 capabilities
4007 https://bugzilla.redhat.com/986877
4009 RFE: Implement set-uuid command
4010 https://bugzilla.redhat.com/986875
4012 RFE: Implement set-label for xfs
4013 https://bugzilla.redhat.com/985269
4015 Can't set acl value for a specified user with 'acl-set-file'
4016 https://bugzilla.redhat.com/983218
4018 libguestfs double free when kernel link fails during launch
4019 https://bugzilla.redhat.com/981715
4021 Make xfs filesystem failed with specified blocksize, gives "unknown
4022 option -b" error
4023 https://bugzilla.redhat.com/981683
4025 "hivex-commit" should fail with a relative path
4026 https://bugzilla.redhat.com/981663
4028 disk-format "qemu-img info: JSON parse error" when target file does
4029 not exist
4030 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 https://bugzilla.redhat.com/975797
4036 Specifying virtio interface ('iface' parameter) breaks the direct
4037 backend - libguestfs hangs
4038 https://bugzilla.redhat.com/975753
4040 "virt-resize --expand" and "virt-resize --resize" outputs error
4041 message for Win2008 32bit OS
4042 https://bugzilla.redhat.com/975412
4044 inspection: Augeas expressions are broken with augeas >= 0.10
4045 https://bugzilla.redhat.com/974904
4047 virt-resize --expand fails on Ubuntu Cloud Image
4048 https://bugzilla.redhat.com/974489
4050 Regression: Fedora inspection broken by change from guestfs_exists
4051 to guestfs_is_file
4052 https://bugzilla.redhat.com/972775
4054 txz-out command produces a bzip2-compressed file (should be xz-
4055 compressed)
4056 https://bugzilla.redhat.com/969845
4058 upload to a directory occasionally hangs instead of failing
4059 https://bugzilla.redhat.com/968875
4061 virt-sysprep should support URL-type arguments
4062 https://bugzilla.redhat.com/624334
4064 blockdev-setbsz succeeds, but does not affect blockdev-getbsz
4065
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 New features
4072 API
4073 Remote access to disks:
4075 · Network Block Device (nbd)
4077 · Secure Shell (ssh)
4079 · HTTP and HTTPS
4081 · FTP and FTPS
4083 · iSCSI
4085 · Gluster
4087 · Ceph/rbd (Mike Kelly)
4089 · Sheepdog
4091 · TFTP
4093 The SYSLINUX and EXTLINUX bootloaders can now be installed in disk
4095 images using the API.
4096 Inspection can now handle filesystems such as btrfs where subvolumes
4098 are separately mountable (Matthew Booth).
4099 "Attach methods" are now known as "backends". Compatibility with
4101 existing code is preserved.
4102 Filenames can contain ':', as long as newer QEMU is being used.
4104 Tools
4106 Virt-alignment-scan and virt-df scan multiple guests in parallel.
4108 Guestmount now passes errno accurately back to userspace in almost all
4110 cases.
4111 Guestfish and other tools can now use a URI-like syntax to access
4113 remote disks, eg:
4114 guestfish -a ssh://example.com/path/to/disk.img
4116 Guestfish and guestmount now allow you to specify the filesystem type
4118 when mounting, which is more secure (Dave Vasilevsky).
4119 Guestfish is now the "guest filesystem shell".
4121 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 New tool "guestunmount" for unmounting FUSE filesystems safely.
4127 "guestmount --no-fork" flag prevents guestmount from daemonizing.
4129 Virt-resize now uses sparse copies by default, saving considerable
4131 space for guests which are mostly empty.
4132 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 Language bindings
4138 The Java API now supports events.
4140 The Python object now inherits from the "object" base class.
4142 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 The PHP bindings are now tested properly, and have had multiple fixes.
4149 The long-deprecated Perl "Sys::Guestfs::Lib" library has been removed.
4151 https://www.redhat.com/archives/libguestfs/2013-April/msg00001.html
4152 Examples
4154 New example program showing how to enable debugging and capture log
4156 messages.
4157 Other
4159 Distributors can add arbitrary extra packages to the appliance by
4161 doing:
4162 ./configure --with-extra-packages="list of package names"
4164 Distributors can use:
4166 ./configure --with-supermin-extra-options="..."
4168 to add arbitrary extra options to supermin.
4170 Security
4172 No security issues were found in this release.
4173 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 C only:
4187 guestfs_event_to_string
4189 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 libxml2 is required to build libguestfs.
4196 The hivexregedit program (from hivex) is required to build from git.
4198 Internal functions can no longer be used unless the caller defines
4200 "-DGUESTFS_PRIVATE=1".
4201 Enable C compiler warnings in Python, Ruby bindings.
4203 Fail early and clearly if libvirt does not support qemu/KVM (eg. if
4205 default libvirt connection is to Xen).
4206 "make print-subdirs" rule, useful for selectively running tests.
4208 Multiple fixes to allow separated (sourcedir != builddir) builds.
4210 Multiple fixes to Haskell bindings.
4212 "ln" and "ln-f" APIs now capture "errno" correctly.
4214 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 Library code internally uses GCC "__attribute__((cleanup))" (if
4221 available) to simplify memory allocation.
4222 Internal header files have been reorganized. See the comments in
4224 src/guestfs-internal*.h
4225 Internal code shared between the library and certain tools is now
4227 located in a static "libutils" library.
4228 Almost all subdirectories can now use parallel builds, although note
4230 that the top-level directories still build in series.
4231 Use of "PATH_MAX" and "NAME_MAX" has been eliminated from the code.
4233 The Java API now requires JVM ≥ 1.6.
4235 Force use of "serial-tests" with automake ≥ 1.12.
4237 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 "qemu-img info --output json" is used if available, for more secure
4242 parsing of the output of this command.
4243 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 Valgrind log files are now written to tmp/valgrind-DATE-PID.log
4249 "make clean" cleans the local "tmp/" directory.
4251 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 Bugs fixed
4256 https://bugzilla.redhat.com/961812
4257 Segfault in inspect-fs.c in mountable code
4258 https://bugzilla.redhat.com/957772
4260 tar-out and base64-out quoting error
4261 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 https://bugzilla.redhat.com/948324
4268 inspection fails if libosinfo is not installed
4269 https://bugzilla.redhat.com/928995
4271 file on zero-sized file now produces "empty " instead of "empty"
4272 https://bugzilla.redhat.com/921292
4274 qemu: could not open disk image /tmp/.../snapshot1: Permission
4275 denied
4276 https://bugzilla.redhat.com/921040
4278 "error: external command failed, see earlier error messages"
4279 message needs to change
4280 https://bugzilla.redhat.com/920225
4282 libguestfs should use --output json (if supported) to safely parse
4283 the output of qemu-img command
4284 https://bugzilla.redhat.com/916780
4286 feature request: guestmount --with-cleanup-pipefd
4287 https://bugzilla.redhat.com/914934
4289 oom-killer kills guestfsd when tar-in a lot of data
4290 https://bugzilla.redhat.com/914931
4292 FileIn commands cause segfault if appliance dies during the file
4293 copy in
4294 https://bugzilla.redhat.com/913145
4296 Misc leaks in virNetClientProgramCall in libvirt 1.0.2
4297 https://bugzilla.redhat.com/912499
4299 Security context on image file gets reset
4300 https://bugzilla.redhat.com/909836
4302 libguestfs-test-tool --qemu segfaults
4303 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 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 https://bugzilla.redhat.com/908321
4313 virt-cat fails on directory names "/dev/stdout: error in chunked
4314 encoding"
4315 https://bugzilla.redhat.com/907554
4317 btrfs causes subsequent ntfs-3g filesystem to fail
4318 https://bugzilla.redhat.com/905341
4320 "No such file or directory" when execute "hivex-commit"
4321 https://bugzilla.redhat.com/903620
4323 btrfs_subvolume_list broken due to change in subvolume list output
4324 https://bugzilla.redhat.com/895910
4326 guestmount: rename() incorrectly follows symbolic links
4327 https://bugzilla.redhat.com/895905
4329 guestmount: link() incorrectly returns ENOENT, when it should be
4330 EXDEV
4331 https://bugzilla.redhat.com/895904
4333 checksums-out fail to compute the checksums of all regular files in
4334 directory
4335 https://bugzilla.redhat.com/894545
4337 libguestfs FTBFS on Fedora 19 because of new ruby
4338 https://bugzilla.redhat.com/890027
4340 virt-sysprep: Setting hostname, domain name and pretty name on
4341 Fedora 18 correctly
4342 https://bugzilla.redhat.com/887971
4344 pvcreate fails if partition contains a swap signature
4345 https://bugzilla.redhat.com/887520
4347 zero_free_space: open: /sysroot//ujqqq135.rd3: Cannot allocate
4348 memory
4349 https://bugzilla.redhat.com/886915
4351 libguestfs with libvirt attach-method fails with odd error if
4352 default hypervisor is Xen
4353 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 https://bugzilla.redhat.com/811649
4360 libguestfs cannot open disk images which are symlinks to files that
4361 contain ':' (colon) character
4362 https://bugzilla.redhat.com/664558
4364 RFE: Allow to set log callback in Ruby bindings
4365
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 New features
4372 libvirt and sVirt (SELinux confinement)
4373 You can optionally use libvirt to launch and manage the backend
4375 appliance by:
4376 · setting "LIBGUESTFS_ATTACH_METHOD=libvirt[:URI]"
4378 · using "./configure --with-default-attach-method=libvirt[:URI]"
4380 · or calling the API method "guestfs_set_attach_method"
4382 SVirt (SELinux confinement) is used to secure the libguestfs appliance,
4384 if the libvirt backend is selected.
4385 virtio-scsi, larger number of drives, hotplugging
4387 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 You can now hotplug drives (add and remove drives after launch).
4393 Libguestfs can now handle > 25 disks, in all APIs, tools and tests.
4395 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 new library features
4401 POSIX Access Control Lists (ACLs) and Linux filesystem capabilities can
4403 now be read and written through the API.
4404 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 Hivex (Windows Registry editing) is now directly supported through the
4411 API, making reading or editing the Windows Registry much more
4412 efficient.
4413 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 virt tools
4421 "guestfish touch 'win:c:\new_file'" now works as expected.
4423 "guestfish" has a new --network option, which enables the user network
4425 in libguestfs.
4426 You can set "GUESTFISH_PS1" to use fancy prompts in "guestfish".
4428 "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 "virt-sparsify" uses qcow2 v3 for increased efficiency.
4434 "virt-sysprep" enhancements:
4436 · generate new UUIDs for PVs and VGs
4438 · remove the local machine ID (Wanlong Gao)
4440 · remove ABRT data (Wanlong Gao)
4442 · remove puppet keys and log files (Wanlong Gao)
4444 · remove process accounting files (Wanlong Gao)
4446 · new --firstboot parameter allowing firstboot scripts for
4448 customizing guests
4449 · remove HOSTNAME field from "ifcfg-eth*" files (Wanlong Gao)
4451 · miscellaneous improvements for SuSE (Olaf Hering)
4453 · remove man pages cache (Wanlong Gao)
4455 · remove crash data generated by kexec-tools (Wanlong Gao)
4457 "virt-make-fs" can now create virtual floppy disks (VFDs).
4459 "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 language bindings
4465 Full-featured Lua bindings have been added in this release (thanks to
4467 Jerome Vuarand for many suggestions).
4468 In Ruby, optional arguments hash is optional.
4470 In Python, optional arguments now don't use special "sentinel" values,
4472 so any integer can be passed as an optional argument.
4473 Erlang bindings now come with examples and tests.
4475 Erlang bindings now handle 64 bit integer parameters correctly.
4477 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 Better handling of blocking and non-blocking functions should make
4483 libguestfs calls more efficient.
4484 inspection
4486 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 Better support for SuSE guests (Olaf Hering).
4492 Return the architecture of installed applications (John Eckersberg).
4494 Windows 8 is now supported.
4496 Fedora 18 is now supported.
4498 Inspection of ISOs/CDs/DVDs can now use the libosinfo database.
4500 ports
4502 Libguestfs without the appliance can be compiled on Mac OS X (Masami
4504 HIRATA).
4505 RHEL 5 is now explicitly supported through the 'oldlinux' branch in
4507 upstream git.
4508 PowerPC 64 bit is now supported. Also libguestfs has been examined for
4510 endianness bugs and these have been fixed.
4511 daemon
4513 A man page for the daemon (guestfsd(8)) is included.
4515 Security
4517 guestfish history file
4518 The $HOME/.guestfish history file is now created with 0600 permissions
4520 (instead of 0644 before) so it is no longer world readable.
4521 CVE-2012-2690
4523 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 This issue was assigned CVE-2012-2690, and is fixed in libguestfs ≥
4531 1.16.
4532 For further information, see
4534 https://bugzilla.redhat.com/show_bug.cgi?id=788642
4535 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 In the C API only:
4615 guestfs_push_error_handler
4617 guestfs_pop_error_handler
4618 Internals
4620 qemu ≥ 1.1 is required (≥ 1.2 preferred).
4621 febootstrap ≥ 3.20 is required.
4623 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 Coverity has been run over the complete codebase, and many issues fixed
4628 (thanks Ondrej Vasik, Kamil Dudka).
4629 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 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 Separation of the library code into more files:
4640 · Launch backends are now located in separate files eg.
4642 src/launch-appliance.c, "src/launch-libvirt.c".
4643 · Generated action code is now split over several src/action*.c
4645 files, for faster compilation.
4646 · The huge src/guestfs.c file is now split into smaller logical
4648 units.
4649 POD (documentation) is now generated using a rewritten Perl program
4651 instead of pod2* + shell scripts.
4652 Man pages now contain stable dates (Hilko Bengen).
4654 Skipped tests now exit with code 77, so they appear as "SKIP:" in "make
4656 check" output.
4657 The parallel mount-local test has been rewritten in C (RHBZ#838081).
4659 Ruby 1.8.5 is now supported (though Ruby ≥ 1.9 is preferred).
4661 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 Java bindings are now enabled/disabled using "./configure --with-java"
4667 or "./configure --without-java" (Wulf C. Krueger).
4668 New configure options "./configure --enable-code-profiling" and
4670 "./configure --enable-code-coverage".
4671 Multiple fixes to use of 64 bit integers in language bindings.
4673 The appliance backend now uses sgabios instead of vgabios (Dan
4675 Berrange).
4676 The "./run" script now sets enough environment variables that you can
4678 run OCaml, Python, Ruby, Java, GJS, Erlang, Lua programs.
4679 "./run --test" flag for running tests with minimal output. It also
4681 prints the time taken to run each test.
4682 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 You can extract a list of external commands required by the daemon,
4688 making building the appliance on certain distros easier (Olaf Hering).
4689 The "virt-rescue" command is now tested during "make check".
4691 The generator now removes unused generated files. This helps when
4693 going back and forth with git rebase, git bisect, etc.
4694 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 "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 Emacs mode (-*- foo -*-) has been added to generated files.
4704 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 There is now a "./configure --without-libvirt" option. This is useful
4710 for testing that the code still compiles without libvirt.
4711 There is now an internal mini-library for running commands. This
4713 allows us to redirect errors from external commands into events.
4714 Code for handling temporary directories and the appliance cache was
4716 completely overhauled.
4717 Code for temporarily ignoring/disabling errors now looks like this:
4719 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 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 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 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 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 https://bugzilla.redhat.com/881953
4744 libguestfs: migration to /etc/hostname, /etc/vconsole.conf,
4745 /etc/locale.conf
4746 https://bugzilla.redhat.com/880801
4748 virt-df with two -a options displays incorrect disk image name
4749 https://bugzilla.redhat.com/879416
4751 libguestfs-test-tool pauses when you use --help option
4752 https://bugzilla.redhat.com/876579
4754 mke2fs API does not apply block device naming translation to
4755 journaldevice optarg
4756 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 https://bugzilla.redhat.com/859949
4762 RFE: inspect-list-applications does not return the architecture of
4763 RPM packages
4764 https://bugzilla.redhat.com/859885
4766 inspect-list-applications does not list all installed RPM packages
4767 with same name and different versions
4768 https://bugzilla.redhat.com/859876
4770 guestfish printed paths are not canonicalized
4771 https://bugzilla.redhat.com/859875
4773 Progress bar output should go to tty(?) stderr(?)
4774 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 https://bugzilla.redhat.com/858128
4781 libguestfs fail to list devices added by add-drive-ro-with-if twice
4782 https://bugzilla.redhat.com/858126
4784 virt-inspector fail to work with some windows guests
4785 https://bugzilla.redhat.com/853762
4787 virt-sparsify should use a more robust method to detect the input
4788 format
4789 https://bugzilla.redhat.com/853393
4791 libvirt doesn't label console, serial sockets
4792 https://bugzilla.redhat.com/853159
4794 virt-rescue in Fedora 18 is completely broken
4795 https://bugzilla.redhat.com/852394
4797 libguestfs inspection limits registries to 100 MiB
4798 https://bugzilla.redhat.com/852194
4800 virt-sparsify --compress fails if output is raw format
4801 https://bugzilla.redhat.com/847881
4803 RFE: allow extra arguments (like --exclude) to tar-out
4804 https://bugzilla.redhat.com/847880
4806 tar-out should allow (or force) --numeric-owner
4807 https://bugzilla.redhat.com/845522
4809 guestfish "copy-out / localdir" command fails with "No such file or
4810 directory"
4811 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 https://bugzilla.redhat.com/842307
4817 RFE: Need help designing and implementing selinux policy for
4818 libguestfs/sVirt
4819 https://bugzilla.redhat.com/840572
4821 virt-make-fs / tar-in should support vfat properly
4822 https://bugzilla.redhat.com/840115
4824 guestfish touch problem - case_sensitive_path API expects the file
4825 to exist
4826 https://bugzilla.redhat.com/836710
4828 Data loss when writing to qcow2-format disk files
4829 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 https://bugzilla.redhat.com/824716
4836 compress-device-out didn't support bzip2
4837 https://bugzilla.redhat.com/824043
4839 guestfish unrecognized mount option gives confusing error message
4840 https://bugzilla.redhat.com/823887
4842 Filenames containing Chinese characters can't be created on vfat
4843 filesystems
4844 https://bugzilla.redhat.com/823885
4846 virt-make-fs cannot create vfat filesystem containing filesystems
4847 with Chinese characters
4848 https://bugzilla.redhat.com/823883
4850 virt-make-fs -t fat fails with an obscure error message
4851 https://bugzilla.redhat.com/823821
4853 Inspection fails when /etc/HOSTNAME is empty
4854 https://bugzilla.redhat.com/801117
4856 libguestfs cannot get icon for Windows 8
4857 https://bugzilla.redhat.com/798979
4859 Ubuntu install CDs from oneiric onwards are not recognized: "multi-
4860 boot operating systems are not supported"
4861 https://bugzilla.redhat.com/782167
4863 libguestfs doesn't recognize Windows Dynamic disks in some
4864 configurations, eg. spanned
4865 https://bugzilla.redhat.com/713678
4867 Not all febootstrap messages are redirected to log callbacks
4868 https://bugzilla.redhat.com/627675
4870 libguestfs inspector code cannot handle /dev/disk/by-id/* paths
4871 https://bugzilla.redhat.com/602997
4873 part-get-bootable gives wrong result with an unordered part layout
4874
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 New features
4881 virt tools
4882 - virt-sysprep has been rewritten and expanded (thanks Wanlong Gao)
4884 http://libguestfs.org/virt-sysprep.1.html
4885 - virt-sparsify --zero is a new option that zeroes the named
4887 partition or filesystem
4888 - virt-sparsify can now safely sparsify Linux swap partitions
4890 - virt-sparsify fixed so it cleans up after ^C
4892 http://libguestfs.org/virt-sparsify.1.html
4893 - 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 - virt-filesystems now displays the parents (containers) of MD
4900 devices and volume groups
4901 - virt-alignment-scan, run with no args, displays alignment information
4903 for all libvirt domains
4904 - virt-df and virt-alignment-scan will display information from all
4906 guests even when a disk is inaccessible
4907 - virt-rescue new --scratch option to make scratch disks
4909 https://rwmj.wordpress.com/2012/04/26/virt-rescue-scratch/#content
4910 - virt-make-fs can now be used to create btrfs
4912 - virt-edit preserves permissions, UID, GID and SELinux context
4914 when editing files
4915 - guestfish passes the close event over stdout and remote correctly
4917 - guestfish new '--pipe-error' option lets you detect errors in pipe
4919 commands
4920 - guestfish globs now expand device names
4922 - comma and colon characters in filenames now handled correctly by
4924 all virt tools
4925 inspection
4927 - added support for Fedora 17+
4929 - added support for FreeDOS
4931 - added support for Buildroot and Cirros
4933 - inspection is now compatible with Windows guests that have been
4935 sysprepped (thanks Grant Williamson).
4936 API
4938 - broad support for btrfs added, including adding multiple devices,
4940 fsck, snapshots (thanks Wanlong Gao)
4941 - 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 - new man page: guestfs-performance(1), which contains performance
4947 tuning tips
4948 http://libguestfs.org/guestfs-performance.1.html
4949 - new man page: guestfs-faq(1), Frequently Asked Questions
4951 http://libguestfs.org/guestfs-faq.1.html
4952 - ENOTSUP (from guestfs_last_errno) is now returned for APIs that
4954 are not supported
4955 examples
4957 - 'copy_over' example showing how to copy between two handles
4959 - 'display_icon' program displays the icon associated with a guest
4961 - 'mount_local.c' example shows how to use the mount-local API
4963 Security
4965 (no security problems were found or fixed in this release)
4966 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 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 - O_CLOEXEC / SOCK_CLOEXEC is now used for almost all file
5003 descriptors that the library opens.
5004 - posix_fadvise is called when sequentially reading or writing large
5006 files.
5007 - close all file descriptors and remove all signal handlers in the
5009 recovery process
5010 - multiple gcc warnings and Coverity bugs have been fixed; many
5012 strict-overflow bugs have also been fixed
5013 - use ./configure --enable-valgrind-daemon to use valgrind on the
5015 daemon; many errors have been fixed
5016 - use ./configure --with-qemu-options to pass extra options to qemu
5018 - the daemon now has a growable strings buffer type (DECLARE_STRINGSBUF)
5020 - the <guestfs.h> header file works with C++ and we have a regression
5022 test for this
5023 - multiple APIs which should only be called in the CONFIG state now
5025 give an error if they are not
5026 - .gitignore fixed to use absolute paths
5028 - gobject bindings have been expanded, including mapping libguestfs
5030 events to gobject signals (thanks Matt Booth)
5031 - gobject documentation is generated properly (thanks Matt Booth)
5033 - gobject header files now live in a subdirectory
5035 - CompareWithString test in the generator now works
5037 - FUInt32, FUInt64 struct field types now use the correct XDR type
5039 - OCaml tests are now run on bytecode and native code.
5041 - java -Xlint:all is used, and all warnings have been fixed
5043 - bmptopng, wrestool (etc) missing or failure no longer prints
5045 warning messages
5046 - ruby: Use RbConfig instead of Config.
5048 - PYTHONPATH is set by the ./run script.
5050 - appliance building is now thread-safe.
5052 - appliance now uses 'ip' instead of 'ifconfig' and 'netstat'
5054 commands
5055 - several fixes to make parallel builds work properly
5057 - guestfish --listen now cleans up properly
5059 - the BUSY state has been removed
5061 - gettextize has been removed, replaced by a simple Makefile.am
5063 - gettext support now covers virt-resize, virt-sparsify and virt-sysprep
5065 - better support for the arm architecture
5067 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
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 New features
5111 libguestfs
5112 - allow XFS filesystems to be created over an existing filesystem
5114 (Wanlong Gao)
5115 - the (unspecified) default alignment for part-disk has been
5117 changed to 64K for better support of high-end network-attached
5118 storage
5119 - new guestfs-testing(1) man page
5121 - list-filesystems returns MD devices containing filesystems
5123 (Matthew Booth)
5124 - support for GCC >= 4.7 (Jim Meyering)
5126 - check user does not add the same drive twice (Wanlong Gao).
5128 language bindings
5130 - 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 - support for Ruby >= 1.9
5137 - Ruby bindings can be disabled individually (Hilko Bengen)
5139 - support for Python 2.6, 3.x (Richard Jones, Hilko Bengen)
5141 - support for PHP >= 5.4
5143 - new %guestfs_introspection hash is available in Perl bindings so
5145 you can query which optional arguments are available
5146 inspection
5148 - guests with MD devices can be inspected (Matthew Booth)
5150 - support for GNU/Hurd guests
5152 guestfish
5154 - libguestfs events (such as progress bar events and log messages) can
5156 be trapped and processed by user-defined shell scripts.
5157 - MD devices are tab-completed (Matthew Booth)
5159 virt tools
5161 - New tool virt-format for erasing and making blank disks
5163 - virt-sparsify new --compress and -o options to allow for compressed
5165 and different format output
5166 - virt-sparsify can now detect and sparsify .vdi files
5168 - virt-sysprep no longer requires xmlstarlet; a new virt-inspector --xpath
5170 option has been added to replace this functionality
5171 - virt-rescue has a new --suggest option which suggests mount commands
5173 for the guest
5174 - virt-resize no longer requires OCaml pcre library
5176 libguestfs live
5178 - daemon will no longer try to edit your live /etc/lvm configuration
5180 - fix a potential security problem with predictable /tmp names (Steve Kemp)
5182 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 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 Internals
5198 Git hosting has moved to http://github.com/libguestfs
5199 The various test directories have been rearranged logically, and now
5201 all appear under 'tests/'.
5202 There is a 'make extra-tests' rule which runs ordinary tests and
5204 additional tests, using valgrind to check for memory problems.
5205 Multiple memory leaks and other problems found by valgrind and fixed.
5207 Support for optional arguments in the generator has been rewritten
5209 to provide more features and safety (Matthew Booth).
5210 With gcc -fvisibility=hidden is used for internal symbols, avoiding
5212 call indirection via the PLT.
5213 RHashtable functions can be tested in the generator.
5215 ADD_ARG macro in daemon allows arg lists to be constructed without
5217 risk of stack smashing.
5218 Fix generation of OCaml functions that have more than 10 arguments.
5220 psmisc has been added to the appliance, allowing use of 'fuser',
5222 'killall' and 'pstree' for debugging.
5223 bindtests now cover RBufferOut and optional arguments (Matthew Booth).
5225 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
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 New features
5243 Erlang bindings.
5244 virt-alignment-scan is a new tool to check the alignment of
5246 partitions within virtual machines or disk images.
5247 virt-sparsify is a new tool to make virtual machine disk images
5249 sparse.
5250 virt-sysprep is a new tool to make cloning guests from a template
5252 simpler.
5253 guestfish
5255 - New commands setenv, unsetenv, to set environment variables.
5257 - The input file and line number is printed in error messages.
5259 - guestfish progress bars are now a "mini-library" used by other
5261 tools too.
5262 guestmount
5264 - the --live option (for access to live VMs) now works.
5266 virt-cat
5268 - virt-cat can now handle Windows paths and drive letters (RHBZ#693359).
5270 virt-filesystems
5272 - the MBR partition type byte is displayed in --long output.
5274 virt-make-fs
5276 - virt-make-fs now sets the MBR partition type byte correctly,
5278 improving compatibility with Windows (RHBZ#746295).
5279 virt-resize
5281 - virt-resize can now work with guests using extended and logical
5283 partitions, in particular Ubuntu guests.
5284 - 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 - The virt-resize --machine-readable flag makes it possible to use
5290 virt-resize from other programs.
5291 - 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 virt-win-reg
5298 - The syntax for deleting registry keys and values is documented
5300 in the man page (RHBZ#737944).
5301 library
5303 - non-printing characters are escaped correctly in debug output.
5305 - GUESTFS_EVENT_ENTER is a new event type generated whenever a
5307 libguestfs function is called.
5308 - the library contains systemtap/DTrace probes.
5310 - the library can now be compiled without hivex (RHBZ#723474).
5312 inspection
5314 - Improve detection of Windows disks.
5316 - 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 - Handle some guest types that use /dev/root in /etc/fstab.
5325 - Fix handling of guests with > 26 disks (thanks Matthew Booth)
5327 - Add support for guests with HP Smart Array disks (thanks Matthew Booth)
5329 febootstrap
5331 - FEBOOTSTRAP_KERNEL, FEBOOTSTRAP_MODULES environment variables can
5333 be set in order to choose which kernel to use for the appliance.
5334 misc
5336 - ArchLinux support now working with Linux 3.0 (thanks Erik Nolte)
5338 - libvirt disks marked <readonly/> are now added readonly when
5340 using the virt-tools '-d' option.
5341 Security
5343 (no security problems were found or fixed in this release)
5344 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 The mount API no longer implicitly adds -o sync,noatime options.
5351 add-domain has a new 'readonlydisk' optional parameter to control
5353 how <readonly/> disks are handled.
5354 Internals
5356 - Coverity was run on the source and more bugs were identified and
5357 fixed.
5358 - PCRE library is now required to build libguestfs.
5360 - APIC is now the default for the appliance. You can also enable
5362 SMP support in the appliance.
5363 - OCaml bindings now correctly acquire GC lock during callbacks.
5365 - Out of tree builds should now work correctly (thanks Hilko Bengen).
5367 - ./configure --with-extra="..." can be used by packagers to set
5369 the extra version string.
5370 - 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 - is-zero, is-zero-device APIs: optimize these so zero detection is
5376 faster.
5377 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
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 New features
5404 guestfish
5405 - guestfish strings can use escapes,
5407 eg. ><fs> write /foo "line 1\nline 2\n"
5408 - guestfish write-append command can be used to append to files.
5410 - Long-running file uploads and downloads can be cancelled through the
5412 API or by hitting ^C in guestfish.
5413 - New guestfish "display" command for displaying graphical files
5415 inside guests.
5416 - In guestfish, tab completion now works on /dev/mapper devices.
5418 virt-inspector
5420 - Inspection API can get an icon or logo for certain guests.
5422 - virt-inspector includes the logo and hostname for certain guests.
5424 - virt-inspector can now get the version and release numbers for RPM
5426 packages.
5427 - CentOS and Scientific Linux are now treated as separate distros by
5429 the inspection API.
5430 virt-resize
5432 - virt-resize can now handle btrfs.
5434 - New virt-resize --ntfsresize-force option allows Windows VMs to be
5436 resized multiple times.
5437 other virt tools
5439 - 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 - virt-ls -lR option allows complex file iteration and guest analysis.
5446 - virt-win-reg supports HKEY_USERS\<SID> and HKEY_USERS\<username>.
5448 - 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 - virt-edit has been rewritten in C.
5454 API and language bindings
5456 - Java is now completely supported.
5458 See http://libguestfs.org/guestfs-java.3.html
5459 - JRuby is supported via the Java bindings.
5461 - guestfs_close now appears in trace messages.
5463 - Python binding adds explicit g.close() method.
5465 - Python programs can now use the new event API.
5467 - Python GIL is released during libguestfs calls, allowing multithreaded
5469 Python programs to work properly.
5470 - 9pfs (Plan 9 filesystems exported from the host) are now supported.
5472 - Add -DGUESTFS_WARN_DEPRECATED=1 to warn about use of deprecated API
5474 functions in C programs.
5475 - New manual page guestfs-recipes(1) with recipes.
5477 - mkfs-opts can now set inode size and sector size on created filesystems
5479 (thanks Nikita Menkovich).
5480 - guestfs_last_errno is now accessible from OCaml (as g#last_errno ()).
5482 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 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 Internals
5494 - Coverity (a static analysis tool) was run across the codebase and
5495 many fixes were made.
5496 - Generator can handle functions that return RBufferOut and have
5498 optional arguments.
5499 - Compatible with Perl 5.14.
5501 - Compatible with gcc 4.6.
5503 - Perform safety checks on QEMU.
5505 - C API tests can now fully test calls that have optional arguments.
5507 - Use ./configure --enable-install-daemon to install /usr/sbin/guestfsd.
5509 - po-docs directory now covers all man pages.
5511 - stderr from qemu process is now captured by the event subsystem.
5513 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
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 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 - New virt tools:
5535 virt-copy-in, virt-copy-out, virt-tar-in, virt-tar-out.
5536 - libguestfs can get the drive letter mappings for Windows guests.
5538 - virt-inspector displays drive letter mappings for Windows guests.
5540 - Drive letters can now be used in virt-edit and guestfish programs
5542 when operating on Windows guests.
5543 - virt-resize now works on 32 bit hosts.
5545 - You can now inspect the install disks and live CDs of many different
5547 operating systems.
5548 - guestfish <! cmd which executes a shell cmd and inlines the result.
5550 - 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 - 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 - Greater FHS compliance for temporary files, including using /var/tmp
5561 for large cached files that should survive reboot (instead of /tmp).
5562 - guestfish, guestmount -m option allows mount options to be passed
5564 through to the underlying filesystem.
5565 - mkfs-opts allows filesystem features to be specified.
5567 - More intelligent handling of mountpoints, allowing mkmountpoint, mount
5569 and umount-all commands to work together properly.
5570 - Trace messages are prefixed with a distinct string, allowing them to
5572 be easily 'grepped' out from debug output.
5573 - 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 - 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 - Publish new example code in: C, Perl, Python, OCaml, Ruby.
5583 - New virt-dhcp-address example program.
5585 - The Java and Ruby bindings have been improved greatly.
5587 - Perl includes a way to get the errno of the last error.
5589 - Python bindings now compatible with rpyc (thanks Erez Shinan).
5591 - Transifex is now being used to manage translations.
5593 http://www.transifex.net/projects/p/libguestfs/
5594 - Inspection now supports Red Hat Desktop, Slackware distributions.
5596 - Inspection no longer fails for Windows guests that have two or
5598 more disks.
5599 - Inspection can now tell the difference between Windows 2008 Server
5601 and Windows 7.
5602 - Inspection can detect 32 bit applications installed in 64 bit
5604 Windows, running on the WOW64 emulator.
5605 - 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 - New logo!
5611 Security
5613 [none]
5614 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 Internals
5622 - The 'HACKING' file is obsolete. The contents have been moved into
5623 a section of the guestfs(3) manual page.
5624 - libguestfs-test-tool simplified. It no longer needs the static
5626 binary or tries to construct an ISO.
5627 - rpcgen-generated files are compiled with -fno-strict-aliasing
5629 which should be safer (thanks Matt Booth).
5630 - virt-resize was rewritten in OCaml.
5632 - guestfish and other tools tested with valgrind; some memory leaks
5634 were fixed.
5635 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
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 New features
5663 - Support and packages for Debian and Ubuntu.
5664 - Daily builds from git repository on Debian and Ubuntu to reduce risk
5666 of regressions.
5667 - Port to ArchLinux 'pacman' (thanks Thomas S Hatch).
5669 - The following tools have been rewritten in C (originally in Perl):
5671 . virt-cat
5673 . virt-df
5674 . virt-inspector
5675 . virt-ls
5676 . virt-rescue
5677 - Some C tools support encrypted guests automatically. This is
5679 supported in: guestfish, guestmount, virt-cat, virt-inspector,
5680 virt-ls.
5681 - 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 - 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 - guestfish no longer has any dependencies on Perl
5692 - New man pages containing programming examples: guestfs-examples(3) (C/C++),
5694 guestfs-ocaml(3), guestfs-python(3), guestfs-ruby(3).
5695 - Trace mode prints return values from API functions.
5697 - virt-inspector can list applications installed in Windows guests, along
5699 with a great deal of information about those applications.
5700 - Add support for inspecting: Linux Mint, Mandriva, FreeBSD.
5702 - guestfish --rw option (with no effect currently) to make potentially
5704 dangerous write access explicit.
5705 - guestfish --listen --csh for compatibility with csh, tcsh (thanks
5707 Eric Blake).
5708 - The first upstream version that introduced each API function is now
5710 documented in guestfs(3).
5711 - guestfs_last_errno allows you to retrieve the errno from the
5713 daemon, correctly translated to the local operating system.
5714 - Functions can now have optional parameters.
5716 - Progress bars and progress notifications can now happen for upload
5718 commands.
5719 - Appliance builder more careful about not leaving temporary files
5721 around in /tmp.
5722 - getfattr/setfattr commands added to virt-rescue.
5724 - ROADMAP file covers roadmap and goals for future releases.
5726 Security
5728 - New SECURITY section in guestfs(3) API documentation.
5729 - virt-inspector no longer runs any guest commands.
5731 - Inspection code is more careful about avoiding very large files
5733 from guests which might previously have caused a denial of service.
5734 - FUSE calls into guestmount are now traced when using guestmount -x.
5736 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 Internals
5750 - C programs now only link precisely with the libraries that they use.
5751 - PCRE, libmagic, hivex and libvirt libraries are now completely
5753 optional for building.
5754 - Multiple memory leaks and file descriptor leaks fixed.
5756 - Add a POD wrapper to unify generation of man pages and HTML files
5758 across all programs.
5759 - Source includes phony images of Fedora, Debian, Ubuntu and
5761 Windows guests.
5762 - Ruby bindings have 'make install' rule.
5764 - <guestfs.h> is now a single file.
5766 - <guestfs.h> does not require XDR headers.
5768 - ocaml xml-light library is no longer required to build (thanks
5770 Maxim Koltsov).
5771 - ./configure --disable-[...] for each language binding (thanks
5773 Maxim Koltsov).
5774 - Old ocaml-viewer program removed (use guestfs-browser instead).
5776 - New C API test type 'InitScratchFS' makes the tests run a little
5778 more quickly.
5779 - Excluded packages in the appliance are now listed in a separate
5781 file appliance/excludelist.in, and can be customized per-distro.
5782 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
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 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 - 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 - 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 - Support for LUKS whole-disk encryption in guests.
5810 - PHP bindings.
5812 - Progress messages (and progress bars in guestfish and virt-resize)
5814 for certain long-running operations.
5815 - virt-df is now much more efficient. Use '--one-per-guest' to restore
5817 the old per-guest isolation behaviour.
5818 - guestfish 'copy-in' and 'copy-out' commands for copying files and
5820 directories recursively in and out of the guest.
5821 - guestfish 'hexedit' command for doing binary edits to devices and
5823 files.
5824 - Change guestfish -i syntax to allow commands to be specified on the
5826 command line (retaining backwards compatibility).
5827 - guestfish '-d <domain>' for adding disks from libvirt domains.
5829 - 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 - guestfish 'more' and 'edit' commands now work with arbitrary files.
5837 - guestfish '--echo-keys' option allows you to echo keys/passphrases
5839 while typing them.
5840 - guestmount now supports -a / -d / -i options, like guestfish.
5842 - Use virtio-serial for communications with the appliance. This
5844 also has a major performance benefit.
5845 - virt-edit '-b' option to create a backup of edited files.
5847 - virt-edit '-e' option for non-interactive edits to files.
5849 - Ability to capture core dumps from the appliance (thanks Matthew Booth).
5851 - virt-rescue now shuts down cleanly (thanks Matthew Booth).
5853 - virt-rescue now has a --network option to enable network access.
5855 - virt-resize can now handle guests which use GPT partition table format.
5857 - virt-resize has better support for shrinking guests.
5859 - virt-resize supports qcow2-format guests.
5861 - $TMPDIR can be used to override almost all temporary directory usage.
5863 - OCaml users can use an alternate OO-style of coding, eg. g#launch ()
5865 - The API supports calls which take optional parameters, eg.
5867 $g->add_drive_opts ("disk", readonly => 1);
5868 - Trace output now escapes and shortens large strings (thanks
5870 Matthew Booth).
5871 - Autosync is now on by default, resulting in more reliable behaviour
5873 when the handle is closed.
5874 - virt-df --uuid option allows you to follow a domain across migration
5876 and renaming.
5877 - Translations of manual pages.
5879 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 - virt-inspector no longer relies on untrusted guest code to list
5887 applications in some guests.
5888 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 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 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
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 New features
5956 - guestfish lets you choose a prepared disk image, eg:
5957 guestfish -N fs:ext4
5958 - Add write support to guestmount (FUSE) module.
5960 - 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 - Bash tab-completion script for guestfish.
5965 - Add ZFS support to virt-rescue.
5967 - New tool 'virt-make-fs' for creating filesystems with content.
5969 - Allow suffixes on any guestfish number parameter, eg. "1M".
5971 - guestfish 'man' command opens the manual page.
5973 - guestfish supports a "heredoc" syntax for uploading files:
5975 upload -<<_end_ /foo
5976 content
5977 _end_
5978 - Some guestfish commands now print their output in octal or hex
5980 where appropriate (RHBZ#583242).
5981 - Allow dash prefix on guestfish command line. This ignores any
5983 error from the second command: (RHBZ#578407)
5984 guestfish -- cmd1 : -cmd2 : cmd3
5985 - guestfish -h / help command now returns an error for non-existent
5987 commands (RHBZ#597145).
5988 - New 'supported' command in guestfish to list optional groups of
5990 commands which are supported by the daemon / configuration.
5991 - virt-inspector and guestfish -i now work for filenames which
5993 contain spaces (RHBZ#507810).
5994 - 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 - libguestfs now sets the correct time and timezone on filesystem
6000 modifications.
6001 - Sort the domains into alphabetical order in virt-df.
6003 - Make mkfs-b command work for FAT and NTFS by mapping the blocksize
6005 parameter to the cluster size (RHBZ#599464).
6006 - Add version numbers to Perl modules (RHBZ#521674).
6008 - Localization now works for all the libguestfs tools (RHBZ#559963).
6010 - Tools now support filesystem-on-image VMs (RHBZ#590167).
6012 - virt-list-partitions has a '-t' option to show the total size of disks.
6014 - Include extra Augeas lenses in the supermin appliance (Matthew Booth).
6016 - Add error and close callbacks.
6018 - Add explicit close method in the Perl API.
6020 - Multiple fixes for RHEL 5 compatibility.
6022 - Multiple fixes for Debian/Ubuntu compatibility.
6024 - Multiple revisions to improve the documentation.
6026 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 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 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 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
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 2009-11-10 (1.0.78)
6144 https://www.redhat.com/archives/libguestfs/2009-November/msg00095.html
6145 2009-09-13 (1.0.67)
6147 https://www.redhat.com/archives/libguestfs/2009-August/msg00281.html
6148 2009-07-23 (1.0.64)
6150 https://www.redhat.com/archives/libguestfs/2009-July/msg00059.html
6151 2009-07-14 (1.0.59)
6153 https://www.redhat.com/archives/libguestfs/2009-July/msg00023.html
6154 2009-04-01 (the initial announcement)
6156 http://rwmj.wordpress.com/2009/04/01/libguestfs-access-and-modify-virtual-machine-disk-images/
6157
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
6164 Richard W.M. Jones
6165
6167 Copyright (C) 2009-2019 Red Hat Inc.
6168
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 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 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
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 To report a new bug against libguestfs, use this link:
6189 https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
6190 When reporting a bug, please supply:
6192 · The version of libguestfs.
6194 · Where you got libguestfs (eg. which Linux distro, compiled from
6196 source, etc)
6197 · Describe the bug accurately and give a way to reproduce it.
6199 · Run libguestfs-test-tool(1) and paste the complete, unedited output
6201 into the bug report.
6202libguestfs-1.40.1 2019-01-17 guestfs-release-notes(1)