.\" 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.16 1"
.TH guestfs-release-notes-1.16 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.16"
.IX Header "RELEASE NOTES FOR LIBGUESTFS 1.16"
These release notes only cover the differences from the previous
stable/dev branch split (1.14.0).  For detailed changelogs, please see
the git repository, or the ChangeLog file distributed in the tarball.
.SS "New features"
.IX Subsection "New features"
\fIlibguestfs\fR
.IX Subsection "libguestfs"
.PP
.Vb 2
\&   \- allow XFS filesystems to be created over an existing filesystem
\&     (Wanlong Gao)
\&
\&   \- the (unspecified) default alignment for part\-disk has been
\&     changed to 64K for better support of high\-end network\-attached
\&     storage
\&
\&   \- new guestfs\-testing(1) man page
\&
\&   \- list\-filesystems returns MD devices containing filesystems
\&     (Matthew Booth)
\&
\&   \- support for GCC >= 4.7 (Jim Meyering)
\&
\&   \- check user does not add the same drive twice (Wanlong Gao).
.Ve
.PP
\fIlanguage bindings\fR
.IX Subsection "language bindings"
.PP
.Vb 4
\&   \- Experimental GObject bindings, with support for GObject
\&     Introspection.  You can now use libguestfs from Javascript.
\&     Please note these are not stable and final in this release.
\&     (Matthew Booth).
\&
\&   \- support for Ruby >= 1.9
\&
\&   \- Ruby bindings can be disabled individually (Hilko Bengen)
\&
\&   \- support for Python 2.6, 3.x (Richard Jones, Hilko Bengen)
\&
\&   \- support for PHP >= 5.4
\&
\&   \- new %guestfs_introspection hash is available in Perl bindings so
\&     you can query which optional arguments are available
.Ve
.PP
\fIinspection\fR
.IX Subsection "inspection"
.PP
.Vb 1
\&   \- guests with MD devices can be inspected (Matthew Booth)
\&
\&   \- support for GNU/Hurd guests
.Ve
.PP
\fIguestfish\fR
.IX Subsection "guestfish"
.PP
.Vb 2
\&   \- libguestfs events (such as progress bar events and log messages) can
\&     be trapped and processed by user\-defined shell scripts.
\&
\&   \- MD devices are tab\-completed (Matthew Booth)
.Ve
.PP
\fIvirt tools\fR
.IX Subsection "virt tools"
.PP
.Vb 1
\&   \- New tool virt\-format for erasing and making blank disks
\&
\&   \- virt\-sparsify new \-\-compress and \-o options to allow for compressed
\&     and different format output
\&
\&   \- virt\-sparsify can now detect and sparsify .vdi files
\&
\&   \- virt\-sysprep no longer requires xmlstarlet; a new virt\-inspector \-\-xpath
\&     option has been added to replace this functionality
\&
\&   \- virt\-rescue has a new \-\-suggest option which suggests mount commands
\&     for the guest
\&
\&   \- virt\-resize no longer requires OCaml pcre library
.Ve
.PP
\fIlibguestfs live\fR
.IX Subsection "libguestfs live"
.PP
.Vb 1
\&   \- daemon will no longer try to edit your live /etc/lvm configuration
\&
\&   \- fix a potential security problem with predictable /tmp names (Steve Kemp)
.Ve
.SS "Security"
.IX Subsection "Security"
.Vb 3
\&  CVE\-2011\-4127, RHBZ#757071
\&  Mitigate possible privilege escalation via SG_IO ioctl
\&  For more information, see: https://github.com/libguestfs/libguestfs/commit/9a5f784d511a8f00a8386f316eab41fe660430db
.Ve
.SS "New APIs"
.IX Subsection "New APIs"
.Vb 7
\&  blkid: print all attributes of a device known to blkid (Wanlong Gao)
\&  e2fsck: access to more features of e2fsck (Wanlong Gao)
\&  list\-md\-devices: list of Linux MD devices (Matthew Booth)
\&  md\-create: create an MD device
\&  md\-detail: returns metadata for an MD device (Matthew Booth)
\&  md\-stop: stop an MD device (Wanlong Gao)
\&  tune2fs: allow ext2/3/4 filesystems to be tuned
.Ve
.SS "Internals"
.IX Subsection "Internals"
.Vb 1
\&  Git hosting has moved to http://github.com/libguestfs
\&
\&  The various test directories have been rearranged logically, and now
\&  all appear under \*(Aqtests/\*(Aq.
\&
\&  There is a \*(Aqmake extra\-tests\*(Aq rule which runs ordinary tests and
\&  additional tests, using valgrind to check for memory problems.
\&
\&  Multiple memory leaks and other problems found by valgrind and fixed.
\&
\&  Support for optional arguments in the generator has been rewritten
\&  to provide more features and safety (Matthew Booth).
\&
\&  With gcc \-fvisibility=hidden is used for internal symbols, avoiding
\&  call indirection via the PLT.
\&
\&  RHashtable functions can be tested in the generator.
\&
\&  ADD_ARG macro in daemon allows arg lists to be constructed without
\&  risk of stack smashing.
\&
\&  Fix generation of OCaml functions that have more than 10 arguments.
\&
\&  psmisc has been added to the appliance, allowing use of \*(Aqfuser\*(Aq,
\&  \*(Aqkillall\*(Aq and \*(Aqpstree\*(Aq for debugging.
\&
\&  bindtests now cover RBufferOut and optional arguments (Matthew Booth).
.Ve
.SS "Bugs fixed"
.IX Subsection "Bugs fixed"
.Vb 9
\& \- 769680 temporary directories created during appliance builds are not cleaned up on error
\& \- 761460 guestfs_utimens hangs on named pipes
\& \- 761451 guestfs_utimens cannot set times on a directory
\& \- 760775 "guestfish: multi\-boot operating systems are not supported by the \-i option" should be more explanatory
\& \- 760669 guestfish copy\-in and <! (inline execution) don\*(Aqt mix well: pclose: No child processes
\& \- 760000 libguestfs fails to compile with Ruby >= 1.9
\& \- 755729 Error message for resize2fs\-M needs tweaking
\& \- 750889 Python code incompatible with Python v3.
\& \- 596761 Ctrl\-\e causes guestfish to abort
.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.
