.\" Automatically generated by Podwrapper::Man 1.44.0 (Pod::Simple 3.40)
.\"
.\" 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.42 1"
.TH guestfs-release-notes-1.42 1 "2021-01-05" "libguestfs-1.44.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 "НАЗВА"
.IX Header "НАЗВА"
guestfs-release-notes \- нотатки щодо випусків libguestfs
.SH "RELEASE NOTES FOR LIBGUESTFS 1.42"
.IX Header "RELEASE NOTES FOR LIBGUESTFS 1.42"
Please note that virt\-v2v, virt\-p2v and the boot analysis tools were moved
out of the libguestfs package / repository into separate projects.  See:
.IP "\(bu" 4
https://github.com/libguestfs/virt\-v2v
.IP "\(bu" 4
https://github.com/libguestfs/virt\-p2v
.IP "\(bu" 4
https://github.com/libguestfs/libguestfs\-analysis\-tools
.PP
Those projects are now on a separate release cycle.  Release notes are
published separately.
.SS "Нові можливості"
.IX Subsection "Нові можливості"
Add support for the Vala language (Corentin Noël).
.PP
Add support for the Rust language (Hiroyuki Katsura, sponsored by Google
Summer of Code).
.PP
Reproducible builds (Chris Lamb).
.PP
Advanced Format disks (which use 4K sectors) can now be processed by
libguestfs.  Use the new optional \f(CW\*(C`blocksize\*(C'\fR parameter to
\&\f(CW\*(C`guestfs_add_drive_opts\*(C'\fR, and the \fI\-\-blocksize\fR option added to several
tools (Nikolay Ivanets).
.PP
Windows CompactOS (\s-1NTFS\s0 file compression) is now supported.
.PP
\fIНові можливості у наявних інструментах\fR
.IX Subsection "Нові можливості у наявних інструментах"
.PP
Advanced machine readable output in various virt tools now supports \s-1JSON\s0
output, and writing logs to a numbered file descriptor (Pino Toscano).
.PP
virt-filesystems tool now more accurately reports filesystem total size, in
the case where for example the filesystem does not occupy the whole of its
containing device (Pino Toscano).
.PP
\fIПрив’язки до мов програмування\fR
.IX Subsection "Прив’язки до мов програмування"
.PP
Python ≥ 2.7 is required.
.PP
Python bindings are now more extensively tested (Hiroyuki Katsura).
.PP
Python bindings should now work with Python ≥ 3.8.
.PP
Multiple fixes to avoid crashes in the Python bindings (Sam Eiderman).
.PP
OCaml bindings are compiled with \f(CW\*(C`\-DCAML_NAME_SPACE\*(C'\fR to ensure no
non\-caml_\-namespaced symbols are used (Pino Toscano).
.PP
OCaml bindings should now work with OCaml 4.09 and 4.10.
.PP
Erlang has deprecated the old \f(CW\*(C`erl_interface\*(C'\fR library which we use for
Erlang bindings.  It will be removed in \s-1OTP 22,\s0 which will permanently break
Erlang support unless someone steps forward to update the Erlang bindings in
libguestfs.
.PP
Fix compatibility with newer cgo for Go bindings (Tomáš Golembiovský).
.PP
Go \s-1API\s0 error handling is now more idiomatic (Csaba Henk).
.PP
Update documentation about how to handle boolean parameters in Ruby bindings
(Csaba Henk).
.PP
\fIПеревірка\fR
.IX Subsection "Перевірка"
.PP
Libguestfs can now extract icons for Gentoo, newer \s-1SUSE\s0 and OpenMandriva
guests.  Improved extraction of \s-1RHEL\s0 icons.  (Pino Toscano).
.PP
Inspection returns the osinfo IDs of newer Windows versions, and rolling
Linux distros (Pino Toscano).
.PP
OpenMandriva is now detected (Bernhard Rosenkränzer).
.PP
Arch Linux detection improvements (Pino Toscano).
.PP
\fIАрхітектури і платформи\fR
.IX Subsection "Архітектури і платформи"
.PP
Libguestfs can now be compiled on OpenMandriva (Bernhard Rosenkränzer).
.PP
Ubuntu fix for enabling network support (Ioanna Alifieraki).
.PP
\fIІнше\fR
.IX Subsection "Інше"
.PP
Use of deprecated libguestfs APIs will now cause compiler deprecation
warnings by default, whereas previously you have to enable these warnings.
To turn off these warnings use \f(CW\*(C`\-DGUESTFS_NO_WARN_DEPRECATED=1\*(C'\fR.  A new
feature is that you can now disable deprecated APIs completely if you want,
using \f(CW\*(C`\-DGUESTFS_NO_DEPRECATED=1\*(C'\fR (Pino Toscano).
.PP
Fix hostname in virt-builder templates (Pino Toscano).
.PP
The single large release notes file is now split into multiple documents
organized by version.
.PP
The \f(CW\*(C`\-\-key\*(C'\fR option of several tools was broken, especially if you tried to
use the option to pass multiple keys.  This has been fixed and a regression
test added.
.PP
Augeas exceptions occurring in daemon (eg. during inspection) will now
produced detailed errors (Pino Toscano).
.SS "Безпека"
.IX Subsection "Безпека"
У цьому випуску вад захисту не виявлено.
.SS "\s-1API\s0"
.IX Subsection "API"
\fIНові програмні інтерфейси\fR
.IX Subsection "Нові програмні інтерфейси"
.PP
\&\f(CW\*(C`luks_uuid\*(C'\fR returns the \s-1UUID\s0 of a \s-1LUKS\s0 device (Pino Toscano).
.PP
\fIІнші зміни у програмному інтерфейсі\fR
.IX Subsection "Інші зміни у програмному інтерфейсі"
.PP
Cope with new output from the \f(CW\*(C`btrfs scrub\*(C'\fR command.  There is no visible
change at the \s-1API\s0 level.
.PP
New optional parameter \f(CW\*(C`blocksize\*(C'\fR added to \f(CW\*(C`guestfs_add_drive_opts\*(C'\fR to
support Advanced Format disks (Nikolay Ivanets).
.SS "Зміни у збиранні"
.IX Subsection "Зміни у збиранні"
Minimum version of Augeas required is 1.2.0 (Pino Toscano).
.PP
\&\f(CW\*(C`common/\*(C'\fR subdirectory is now a git submodule shared with the virt\-v2v
project.
.PP
Supermin ≥ 5.1.18 is required.
.PP
There were several bugs in libvirt 5.10.0 and 6.0 which affected
libguestfs.  It is highly advisable to use libvirt 6.1 where these bugs are
fixed (versions of libvirt < 5.10.0 are also fine).
.PP
Many gnulib modules which we were not using or which we used in only a few
places have been removed (Pino Toscano).
.PP
Multiple fixes for builddir != sourcedir builds (Pino Toscano).
.PP
A new \f(CW\*(C`bundled/\*(C'\fR subdirectory contains one bundled library that we
currently use, \f(CW\*(C`ocaml\-augeas\*(C'\fR (Pino Toscano).
.PP
Fix compatibility issues when being compiled with \s-1GCC 10.\s0
.SS "Внутрішня частина роботи програми"
.IX Subsection "Внутрішня частина роботи програми"
When linking OCaml programs, automake silent rules and the \f(CW\*(C`V=1\*(C'\fR flag are
both now obeyed (Pino Toscano).
.PP
The \f(CW\*(C`guestfs_device_index\*(C'\fR \s-1API\s0 was reimplemented in library code instead of
in the daemon.  There should be no observable effect of this change.
.PP
Since Linux 5.6 enumerates \f(CW\*(C`/dev/sdX\*(C'\fR devices in parallel, libguestfs was
changed to map \s-1API\s0 device names to appliance device names, and then do the
reverse mapping when returning names from the appliance.  Hopefully this
should have no observable effect, but can produce somewhat confusing
debugging messages since device names in the debug might not match device
names passed in to APIs.  Furthermore the \f(CW\*(C`root=UUID=...\*(C'\fR option is always
passed to the appliance (instead of naming the device containing the root
filesystem).
.PP
We expect to move from the Zanata service to the Weblate service for
translated strings.  For more information see
https://bugzilla.redhat.com/1787301
.SS "Виправлені вади"
.IX Subsection "Виправлені вади"
.IP "https://bugzilla.redhat.com/1773520" 4
.IX Item "https://bugzilla.redhat.com/1773520"
Segfault in python bindings for guestfs_int_py_event_callback_wrapper
.IP "https://bugzilla.redhat.com/1746699" 4
.IX Item "https://bugzilla.redhat.com/1746699"
Can't import guest from export domain to data domain on rhv4.3 due to error
\&\*(L"Invalid parameter: 'DiskType=1'\*(R"
.IP "https://bugzilla.redhat.com/1733168" 4
.IX Item "https://bugzilla.redhat.com/1733168"
virt\-v2v: Use scp \-T in \-i vmx \-it ssh mode
.IP "https://bugzilla.redhat.com/1723305" 4
.IX Item "https://bugzilla.redhat.com/1723305"
Delete info\*(L"export PATH=/path/to/nbdkit\-1.1.x:$PATH\*(R" in
virt\-v2v\-input\-vmware manual page
.IP "https://bugzilla.redhat.com/1705482" 4
.IX Item "https://bugzilla.redhat.com/1705482"
python 3.8 requires using \-embed variant of pkgconf file, causing libguestfs
to fail to build Python 3.8 bindings
.IP "https://bugzilla.redhat.com/1703463" 4
.IX Item "https://bugzilla.redhat.com/1703463"
libguestfs cannot inspect disks using WIndows 10 \s-1NTFS\s0 compression, error
\&\*(L"unsupported reparse point\*(R"
.IP "https://bugzilla.redhat.com/1694268" 4
.IX Item "https://bugzilla.redhat.com/1694268"
[\s-1PATCH\s0] Add OpenMandriva support
.IP "https://bugzilla.redhat.com/1691659" 4
.IX Item "https://bugzilla.redhat.com/1691659"
virt\-v2v should show a message when qemu-guest-agent is installed in guest
successfully during conversion
.IP "https://bugzilla.redhat.com/1690574" 4
.IX Item "https://bugzilla.redhat.com/1690574"
virt\-v2v fails to import a guest while cannot find `file_architecture` for a
file
.IP "https://bugzilla.redhat.com/1680361" 4
.IX Item "https://bugzilla.redhat.com/1680361"
[v2v][\s-1RHV\s0][Scale] v2v Migration to \s-1RHV\s0 failed on timed out waiting for
transfer to finalize
.IP "https://bugzilla.redhat.com/1661871" 4
.IX Item "https://bugzilla.redhat.com/1661871"
python bindings wrongly using str for APIs with RBufferOut/FBuffer on Python
3
.IP "https://bugzilla.redhat.com/1626503" 4
.IX Item "https://bugzilla.redhat.com/1626503"
Unable to maintain static \s-1IP\s0 address configuration post \s-1VM\s0 migration
.IP "https://bugzilla.redhat.com/1612653" 4
.IX Item "https://bugzilla.redhat.com/1612653"
Guest has no disk after rhv-upload converting if target data domain has
similar name with other data domain on rhv4.2
.IP "https://bugzilla.redhat.com/1605242" 4
.IX Item "https://bugzilla.redhat.com/1605242"
Update nbdkit info for vddk in v2v man page
.IP "https://bugzilla.redhat.com/1584678" 4
.IX Item "https://bugzilla.redhat.com/1584678"
On W2K12r2 rhev-apt does not run non-interactively, causing race when
starting rhev-apt service from the command line
.IP "https://bugzilla.redhat.com/1518539" 4
.IX Item "https://bugzilla.redhat.com/1518539"
Macvtap network will be lost during v2v conversion
.IP "https://bugzilla.redhat.com/1351000" 4
.IX Item "https://bugzilla.redhat.com/1351000"
virt-customize \-\-commands\-from\-file will fail if there is an extra blank in
the file
.SH "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
.IX Header "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
\&\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 "АВТОРИ"
.IX Header "АВТОРИ"
Ioanna Alifieraki
.PP
Sam Eiderman
.PP
Tomáš Golembiovský
.PP
Csaba Henk
.PP
Nikolay Ivanets
.PP
Richard W.M. Jones
.PP
Hiroyuki Katsura
.PP
Chris Lamb
.PP
Corentin Noël
.PP
Bernhard Rosenkränzer
.PP
Pino Toscano
.SH "АВТОРСЬКІ ПРАВА"
.IX Header "АВТОРСЬКІ ПРАВА"
Copyright (C) 2009\-2020 Red Hat Inc.
.SH "LICENSE"
.IX Header "LICENSE"
.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.