.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Podwrapper::Man 1.52.0 (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
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    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.10 1"
.TH guestfs-release-notes-1.10 1 2024-01-05 libguestfs-1.52.0 "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.10"
.IX Header "RELEASE NOTES FOR LIBGUESTFS 1.10"
These release notes only cover the differences from the previous
stable/dev branch split (1.8.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 4
\& \- libguestfs and tools can be used against live virtual machines.
\&   See the \*(Aqguestfish \-\-live\*(Aq and \*(Aqguestmount \-\-live\*(Aq options, and (for
\&   the low\-level interface) the new APIs set\-attach\-method and
\&   get\-attach\-method.
\&
\& \- New virt tools:
\&   virt\-copy\-in, virt\-copy\-out, virt\-tar\-in, virt\-tar\-out.
\&
\& \- libguestfs can get the drive letter mappings for Windows guests.
\&
\& \- virt\-inspector displays drive letter mappings for Windows guests.
\&
\& \- Drive letters can now be used in virt\-edit and guestfish programs
\&   when operating on Windows guests.
\&
\& \- virt\-resize now works on 32 bit hosts.
\&
\& \- You can now inspect the install disks and live CDs of many different
\&   operating systems.
\&
\& \- guestfish <! cmd which executes a shell cmd and inlines the result.
\&
\& \- guestfish, guestmount, virt\-rescue now all support \-\-ro and \-\-rw
\&   options, and the default for this can be chosen via a configuration
\&   file (/etc/libguestfs\-tools.conf).
\&
\& \- New event API allows more than one callback to be registered for
\&   each event, makes it possible to call the API from other languages,
\&   and allows nearly all log, debug and trace messages to be rerouted
\&   from stderr.
\&
\& \- Greater FHS compliance for temporary files, including using /var/tmp
\&   for large cached files that should survive reboot (instead of /tmp).
\&
\& \- guestfish, guestmount \-m option allows mount options to be passed
\&   through to the underlying filesystem.
\&
\& \- mkfs\-opts allows filesystem features to be specified.
\&
\& \- More intelligent handling of mountpoints, allowing mkmountpoint, mount
\&   and umount\-all commands to work together properly.
\&
\& \- Trace messages are prefixed with a distinct string, allowing them to
\&   be easily \*(Aqgrepped\*(Aq out from debug output.
\&
\& \- guestfs_launch (guestfish \*(Aqrun\*(Aq command) now produces progress
\&   messages (a guestfish progress bar) if it takes longer than 5
\&   seconds to run.
\&
\& \- Several long\-running commands where we are unable to estimate time
\&   to completion generate "pulse mode" progress events.  Progress bar
\&   in guestfish has been updated to display these.
\&
\& \- Publish new example code in: C, Perl, Python, OCaml, Ruby.
\&
\& \- New virt\-dhcp\-address example program.
\&
\& \- The Java and Ruby bindings have been improved greatly.
\&
\& \- Perl includes a way to get the errno of the last error.
\&
\& \- Python bindings now compatible with rpyc (thanks Erez Shinan).
\&
\& \- Transifex is now being used to manage translations.
\&   http://www.transifex.net/projects/p/libguestfs/
\&
\& \- Inspection now supports Red Hat Desktop, Slackware distributions.
\&
\& \- Inspection no longer fails for Windows guests that have two or
\&   more disks.
\&
\& \- Inspection can now tell the difference between Windows 2008 Server
\&   and Windows 7.
\&
\& \- Inspection can detect 32 bit applications installed in 64 bit
\&   Windows, running on the WOW64 emulator.
\&
\& \- A series of protocol fixes has fixed the old bug RHBZ#576879
\&   which used to cause errors during the upload command to lose
\&   protocol synchronization.
\&
\& \- New logo!
.Ve
.SS Security
.IX Subsection "Security"
.Vb 1
\&  [none]
.Ve
.SS "New APIs"
.IX Subsection "New APIs"
.Vb 4
\&  first\-private, get\-attach\-method, inspect\-get\-drive\-mappings,
\&  inspect\-get\-product\-variant,
\&  inspect\-get\-windows\-current\-control\-set, next\-private, resize2fs\-M,
\&  set\-attach\-method.
.Ve
.SS Internals
.IX Subsection "Internals"
.Vb 2
\& \- The \*(AqHACKING\*(Aq file is obsolete.  The contents have been moved into
\&   a section of the guestfs(3) manual page.
\&
\& \- libguestfs\-test\-tool simplified.  It no longer needs the static
\&   binary or tries to construct an ISO.
\&
\& \- rpcgen\-generated files are compiled with \-fno\-strict\-aliasing
\&   which should be safer (thanks Matt Booth).
\&
\& \- virt\-resize was rewritten in OCaml.
\&
\& \- guestfish and other tools tested with valgrind; some memory leaks
\&   were fixed.
.Ve
.SS "Bugs fixed"
.IX Subsection "Bugs fixed"
.Vb 10
\& \- 502533 Updated Polish translation of libguestfs
\& \- 576879 libguestfs protocol loses synchronization if you \*(Aqupload\*(Aq before mounting disks
\& \- 599503 document that mkmountpoint and umount\-all cannot be mixed
\& \- 617440 guestfish: fails to tilde expand \*(Aq~\*(Aq when the $HOME env is unset
\& \- 664558 RFE: Allow to set log callback in Ruby bindings
\& \- 665358 Punjabi Translation Completed (pa_IN)
\& \- 666577 libguestfs: unknown filesystem /dev/fd0
\& \- 667610 Multiple bugs, memory leaks in libguestfs ruby bindings
\& \- 668112 virt\-filesystems command fails on guest with corrupt filesystem label
\& \- 668574 guestfish \-i is trying to mount all mounts from /etc/fstab and fails with an error when device doesn\*(Aqt exists
\& \- 673479 Add a grep\-friendly string to LIBGUESTFS_TRACE output
\& \- 674130 Inspection code fails for Windows guest with two disks
\& \- 682756 libguestfs trace segfaults when list\-filesystems returns error
\& \- 682979 libguestfs incorrectly detects Red Hat desktop as \*(Aqredhat\-based\*(Aq instead of \*(Aqredhat\*(Aq
\& \- 690819 mkfs fails creating a filesystem on a disk device when using a disk with \*(Aqide\*(Aq interface
\& \- 691389 Extended attributes don\*(Aqt work over guestmount (FUSE)
\& \- 691724 virt\-inspector reports unknown filesystem /dev/vda1
\& \- 692545 inspect\-list\-applications fails to detect 32 bit apps installed under WOW64 emulator on 64 bit Windows
\& \- 693324 sfdisk\*(Aqs python interface only accepts lists of type \*(Aqlist\*(Aq for the lines parameter
.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\-2023 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 GNU 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
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
General Public License for more details.
.PP
You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301 USA.
.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.