.\" Automatically generated by Podwrapper::Man 1.48.6 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "guestfs-release-notes-1.14 1"
.TH guestfs-release-notes-1.14 1 "2022-11-28" "libguestfs-1.48.6" "Virtualization Support"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
guestfs\-release\-notes \- libguestfs Release Notes
.SH "RELEASE NOTES FOR LIBGUESTFS 1.14"
.IX Header "RELEASE NOTES FOR LIBGUESTFS 1.14"
These release notes only cover the differences from the previous
stable/dev branch split (1.12.0).  For detailed changelogs, please see
the git repository, or the ChangeLog file distributed in the tarball.
.SS "New features"
.IX Subsection "New features"
.Vb 1
\&  Erlang bindings.
\&
\&  virt\-alignment\-scan is a new tool to check the alignment of
\&  partitions within virtual machines or disk images.
\&
\&  virt\-sparsify is a new tool to make virtual machine disk images
\&  sparse.
\&
\&  virt\-sysprep is a new tool to make cloning guests from a template
\&  simpler.
.Ve
.PP
\fIguestfish\fR
.IX Subsection "guestfish"
.PP
.Vb 1
\&   \- New commands setenv, unsetenv, to set environment variables.
\&
\&   \- The input file and line number is printed in error messages.
\&
\&   \- guestfish progress bars are now a "mini\-library" used by other
\&     tools too.
.Ve
.PP
\fIguestmount\fR
.IX Subsection "guestmount"
.PP
.Vb 1
\&   \- the \-\-live option (for access to live VMs) now works.
.Ve
.PP
\fIvirt-cat\fR
.IX Subsection "virt-cat"
.PP
.Vb 1
\&   \- virt\-cat can now handle Windows paths and drive letters (RHBZ#693359).
.Ve
.PP
\fIvirt-filesystems\fR
.IX Subsection "virt-filesystems"
.PP
.Vb 1
\&   \- the MBR partition type byte is displayed in \-\-long output.
.Ve
.PP
\fIvirt-make-fs\fR
.IX Subsection "virt-make-fs"
.PP
.Vb 2
\&   \- virt\-make\-fs now sets the MBR partition type byte correctly,
\&     improving compatibility with Windows (RHBZ#746295).
.Ve
.PP
\fIvirt-resize\fR
.IX Subsection "virt-resize"
.PP
.Vb 2
\&   \- virt\-resize can now work with guests using extended and logical
\&     partitions, in particular Ubuntu guests.
\&
\&   \- virt\-resize can now align the first partition of Windows guests,
\&     improving performance.  The new virt\-resize \-\-align\-first option
\&     controls this behaviour.
\&
\&   \- The virt\-resize \-\-machine\-readable flag makes it possible to use
\&     virt\-resize from other programs.
\&
\&   \- Partitions are now aligned to 128 sectors (usually 64K) by
\&     default.  This improves efficiency on high\-end storage.  The new
\&     virt\-resize \-\-alignment option allows the alignment to be
\&     adjusted.
.Ve
.PP
\fIvirt-win-reg\fR
.IX Subsection "virt-win-reg"
.PP
.Vb 2
\&   \- The syntax for deleting registry keys and values is documented
\&     in the man page (RHBZ#737944).
.Ve
.PP
\fIlibrary\fR
.IX Subsection "library"
.PP
.Vb 1
\&   \- non\-printing characters are escaped correctly in debug output.
\&
\&   \- GUESTFS_EVENT_ENTER is a new event type generated whenever a
\&     libguestfs function is called.
\&
\&   \- the library contains systemtap/DTrace probes.
\&
\&   \- the library can now be compiled without hivex (RHBZ#723474).
.Ve
.PP
\fIinspection\fR
.IX Subsection "inspection"
.PP
.Vb 1
\&   \- Improve detection of Windows disks.
\&
\&   \- Adds support for:
\&         ttylinux \- a minimal Linux
\&         Mageia (thanks Michael Scherer)
\&         OpenSUSE and zypper (thanks Michael Scherer, Vincent Untz)
\&         Ubuntu logos (thanks Michael Scherer)
\&         NetBSD and pkgsrc (thanks Michael Scherer)
\&
\&   \- Handle some guest types that use /dev/root in /etc/fstab.
\&
\&   \- Fix handling of guests with > 26 disks (thanks Matthew Booth)
\&
\&   \- Add support for guests with HP Smart Array disks (thanks Matthew Booth)
.Ve
.PP
\fIfebootstrap\fR
.IX Subsection "febootstrap"
.PP
.Vb 2
\&   \- FEBOOTSTRAP_KERNEL, FEBOOTSTRAP_MODULES environment variables can
\&     be set in order to choose which kernel to use for the appliance.
.Ve
.PP
\fImisc\fR
.IX Subsection "misc"
.PP
.Vb 1
\&   \- ArchLinux support now working with Linux 3.0 (thanks Erik Nolte)
\&
\&   \- libvirt disks marked <readonly/> are now added readonly when
\&     using the virt\-tools \*(Aq\-d\*(Aq option.
.Ve
.SS "Security"
.IX Subsection "Security"
.Vb 1
\&  (no security problems were found or fixed in this release)
.Ve
.SS "New APIs"
.IX Subsection "New APIs"
.Vb 3
\&  compress\-out, compress\-device\-out, copy\-device\-to\-device,
\&  copy\-device\-to\-file, copy\-file\-to\-device, copy\-file\-to\-file,
\&  get\-smp, part\-to\-partnum, set\-smp.
\&
\&  The mount API no longer implicitly adds \-o sync,noatime options.
\&
\&  add\-domain has a new \*(Aqreadonlydisk\*(Aq optional parameter to control
\&  how <readonly/> disks are handled.
.Ve
.SS "Internals"
.IX Subsection "Internals"
.Vb 2
\& \- Coverity was run on the source and more bugs were identified and
\&   fixed.
\&
\& \- PCRE library is now required to build libguestfs.
\&
\& \- APIC is now the default for the appliance.  You can also enable
\&   SMP support in the appliance.
\&
\& \- OCaml bindings now correctly acquire GC lock during callbacks.
\&
\& \- Out of tree builds should now work correctly (thanks Hilko Bengen).
\&
\& \- ./configure \-\-with\-extra="..." can be used by packagers to set
\&   the extra version string.
\&
\& \- zero, zero\-device APIs: if the blocks already contain zeroes,
\&   don\*(Aqt write zeroes, so that we don\*(Aqt unnecessarily make the
\&   underlying storage non\-sparse.
\&
\& \- is\-zero, is\-zero\-device APIs: optimize these so zero detection is
\&   faster.
.Ve
.SS "Bugs fixed"
.IX Subsection "Bugs fixed"
.Vb 10
\& \- 748266 libguestfs should detect versions of qemu which require \-machine pc option
\& \- 747290 libguestfs ignores <readonly/> in libvirt XML
\& \- 747287 Misleading error message when permission denied opening a disk image
\& \- 746295 virt\-make\-fs doesn\*(Aqt set partition ID
\& \- 744795 guestmount \-\-live is not usable
\& \- 737944 virt\-win\-reg hyphen (delete key) syntax may be wrong, and is not documented
\& \- 733297 ruby event handlers fail with "exception in callback: wrong argument type Proc (expected Data)"
\& \- 731744 libguestfs should escape special/non\-printing characters in debug output
\& \- 729887 appliance crashes running aug_init with flags=4
\& \- 729075 libguestfs confuses Hp_recovery partition with Windows root filesystem
\& \- 727178 error: luks_open: cryptsetup: error while loading shared libraries: libfipscheck.so.1: cannot open shared object file: No such file or directory
\& \- 726739 libguestfs: error: aug_get: no matching node, trying to find hostname
\& \- 723474 If hivex and/or pcre not installed, libguestfs fails to compile
\& \- 693359 virt\-cat and virt\-edit don\*(Aqt handle case sensitive NTFS paths properly
\& \- 678231 virt\-inspector reports unknown filesystem UUID
\& \- 671082 libguestfs does not work with kernel\-rt
\& \- 666578 libguestfs: unknown filesystem label SWAP\-sda2
\& \- 642821 virt\-resize falls over on a disk image with a logical swap partition
.Ve
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBguestfs\-examples\fR\|(1),
\&\fBguestfs\-faq\fR\|(1),
\&\fBguestfs\-performance\fR\|(1),
\&\fBguestfs\-recipes\fR\|(1),
\&\fBguestfs\-testing\fR\|(1),
\&\fBguestfs\fR\|(3),
\&\fBguestfish\fR\|(1),
http://libguestfs.org/
.SH "AUTHOR"
.IX Header "AUTHOR"
Richard W.M. Jones
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
Copyright (C) 2009\-2020 Red Hat Inc.
.SH "LICENSE"
.IX Header "LICENSE"
This program is free software; you can redistribute it and/or modify it
under the terms of the \s-1GNU\s0 General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version.
.PP
This program is distributed in the hope that it will be useful, but
\&\s-1WITHOUT ANY WARRANTY\s0; without even the implied warranty of
\&\s-1MERCHANTABILITY\s0 or \s-1FITNESS FOR A PARTICULAR PURPOSE.\s0  See the \s-1GNU\s0
General Public License for more details.
.PP
You should have received a copy of the \s-1GNU\s0 General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, \s-1MA 02110\-1301 USA.\s0
.SH "BUGS"
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
.PP
To report a new bug against libguestfs, use this link:
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
.IP "\(bu" 4
The version of libguestfs.
.IP "\(bu" 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
.IP "\(bu" 4
Describe the bug accurately and give a way to reproduce it.
.IP "\(bu" 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
