.\" Automatically generated by Podwrapper::Man 1.50.1 (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 "2023-02-21" "libguestfs-1.50.1" "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 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 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 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\-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 \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.