.\" 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.12 1"
.TH guestfs-release-notes-1.12 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.12"
.IX Header "RELEASE NOTES FOR LIBGUESTFS 1.12"
These release notes only cover the differences from the previous
stable/dev branch split (1.10.0).  For detailed changelogs, please see
the git repository, or the ChangeLog file distributed in the tarball.
.SS "New features"
.IX Subsection "New features"
\fIguestfish\fR
.IX Subsection "guestfish"
.PP
.Vb 2
\&   \- guestfish strings can use escapes,
\&     eg. ><fs> write /foo "line 1\enline 2\en"
\&
\&   \- guestfish write\-append command can be used to append to files.
\&
\&   \- Long\-running file uploads and downloads can be cancelled through the
\&     API or by hitting ^C in guestfish.
\&
\&   \- New guestfish "display" command for displaying graphical files
\&     inside guests.
\&
\&   \- In guestfish, tab completion now works on /dev/mapper devices.
.Ve
.PP
\fIvirt-inspector\fR
.IX Subsection "virt-inspector"
.PP
.Vb 1
\&   \- Inspection API can get an icon or logo for certain guests.
\&
\&   \- virt\-inspector includes the logo and hostname for certain guests.
\&
\&   \- virt\-inspector can now get the version and release numbers for RPM
\&     packages.
\&
\&   \- CentOS and Scientific Linux are now treated as separate distros by
\&     the inspection API.
.Ve
.PP
\fIvirt-resize\fR
.IX Subsection "virt-resize"
.PP
.Vb 1
\&   \- virt\-resize can now handle btrfs.
\&
\&   \- New virt\-resize \-\-ntfsresize\-force option allows Windows VMs to be
\&     resized multiple times.
.Ve
.PP
\fIother virt tools\fR
.IX Subsection "other virt tools"
.PP
.Vb 4
\&   \- guestfish, guestmount, virt\-cat, virt\-df, virt\-edit, virt\-filesystems,
\&     virt\-inspector, virt\-ls and virt\-rescue now allow you to use
\&     "\-d UUID" option to specify a guest by UUID.  This makes them more
\&     robust to use from other programs.
\&
\&   \- virt\-ls \-lR option allows complex file iteration and guest analysis.
\&
\&   \- virt\-win\-reg supports HKEY_USERS\e<SID> and HKEY_USERS\e<username>.
\&
\&   \- virt\-win\-reg new option \-\-unsafe\-printable\-strings allows printable
\&     strings to be displayed in the output (unsafely: read the documentation
\&     before using).
\&
\&   \- virt\-edit has been rewritten in C.
.Ve
.PP
\fI\s-1API\s0 and language bindings\fR
.IX Subsection "API and language bindings"
.PP
.Vb 2
\&   \- Java is now completely supported.
\&     See http://libguestfs.org/guestfs\-java.3.html
\&
\&   \- JRuby is supported via the Java bindings.
\&
\&   \- guestfs_close now appears in trace messages.
\&
\&   \- Python binding adds explicit g.close() method.
\&
\&   \- Python programs can now use the new event API.
\&
\&   \- Python GIL is released during libguestfs calls, allowing multithreaded
\&     Python programs to work properly.
\&
\&   \- 9pfs (Plan 9 filesystems exported from the host) are now supported.
\&
\&   \- Add \-DGUESTFS_WARN_DEPRECATED=1 to warn about use of deprecated API
\&     functions in C programs.
\&
\&   \- New manual page guestfs\-recipes(1) with recipes.
\&
\&   \- mkfs\-opts can now set inode size and sector size on created filesystems
\&     (thanks Nikita Menkovich).
\&
\&   \- guestfs_last_errno is now accessible from OCaml (as g#last_errno ()).
.Ve
.SS "Security"
.IX Subsection "Security"
.Vb 3
\& \- optargs_bitmask is checked even for calls that have no optional
\&   arguments.  This closes a possible exploit in the daemon from
\&   untrusted callers.
.Ve
.SS "New APIs"
.IX Subsection "New APIs"
.Vb 3
\&  btrfs\-filesystem\-resize, get\-pgroup, inspect\-get\-icon, is\-zero,
\&  is\-zero\-device, list\-9p, list\-dm\-devices, mount\-9p, ntfsresize\-opts,
\&  set\-pgroup, write\-append
.Ve
.SS "Internals"
.IX Subsection "Internals"
.Vb 2
\& \- Coverity (a static analysis tool) was run across the codebase and
\&   many fixes were made.
\&
\& \- Generator can handle functions that return RBufferOut and have
\&   optional arguments.
\&
\& \- Compatible with Perl 5.14.
\&
\& \- Compatible with gcc 4.6.
\&
\& \- Perform safety checks on QEMU.
\&
\& \- C API tests can now fully test calls that have optional arguments.
\&
\& \- Use ./configure \-\-enable\-install\-daemon to install /usr/sbin/guestfsd.
\&
\& \- po\-docs directory now covers all man pages.
\&
\& \- stderr from qemu process is now captured by the event subsystem.
.Ve
.SS "Bugs fixed"
.IX Subsection "Bugs fixed"
.Vb 7
\& \- 602997 part\-get\-bootable gives wrong result with an unordered part layout
\& \- 661280 virt\-rescue: panic when shutting down: "/sbin/reboot: No such file or directory"
\& \- 700369 qemu\-system\-x86_64 says \*(AqKVM not supported for this target\*(Aq
\& \- 705200 guestmount attempt results in access denied
\& \- 714981 \*(Aqlist\-filesystems\*(Aq does not know about virtio 9p filesystems or detect existing mounts
\& \- 717786 libguestfs python bindings should have an explicit close call
\& \- 721275 virt\-resize in F16 should support btrfs
.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.
