.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Podwrapper::Man 1.54.0 (Pod::Simple 3.45)
.\"
.\" 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.20 1"
.TH guestfs-release-notes-1.20 1 2024-10-08 libguestfs-1.54.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.20"
.IX Header "RELEASE NOTES FOR LIBGUESTFS 1.20"
These release notes only cover the differences from the previous
stable/dev branch split (1.18.0).  For detailed changelogs, please see
the git repository, or the ChangeLog file distributed in the tarball.
.SS "New features"
.IX Subsection "New features"
\fIlibvirt and sVirt (SELinux confinement)\fR
.IX Subsection "libvirt and sVirt (SELinux confinement)"
.PP
You can \fIoptionally\fR use libvirt to launch and manage the backend
appliance by:
.IP \(bu 4
setting \f(CW\*(C`LIBGUESTFS_ATTACH_METHOD=libvirt[:URI]\*(C'\fR
.IP \(bu 4
using \f(CW\*(C`./configure \-\-with\-default\-attach\-method=libvirt[:URI]\*(C'\fR
.IP \(bu 4
or calling the API method \f(CW\*(C`guestfs_set_attach_method\*(C'\fR
.PP
SVirt (SELinux confinement) is used to secure the libguestfs
appliance, if the libvirt backend is selected.
.PP
\fIvirtio-scsi, larger number of drives, hotplugging\fR
.IX Subsection "virtio-scsi, larger number of drives, hotplugging"
.PP
Virtio-scsi is now used by default, if it is available.  This greatly
increases the number of drives that can be added to a single
libguestfs handle (up to 255).
.PP
You can now hotplug drives (add and remove drives after launch).
.PP
Libguestfs can now handle > 25 disks, in all APIs, tools and tests.
.PP
You can label drives when adding them, then refer to them by label
(\fI/dev/disk/guestfs/LABEL\fR) instead of having to use device names
(\fI/dev/sda\fR).
.PP
\fInew library features\fR
.IX Subsection "new library features"
.PP
POSIX Access Control Lists (ACLs) and Linux filesystem capabilities
can now be read and written through the API.
.PP
Windows Dynamic Disks are now supported.  The metadata can only be
read (volumes cannot be modified or created).  However the
data/filesystems in the volumes themselves can be mounted, read and
written (Matthew Booth).
.PP
Hivex (Windows Registry editing) is now directly supported through the
API, making reading or editing the Windows Registry much more
efficient.
.PP
Several libguestfs APIs were reimplemented so they no longer have any
limits on output.  The reimplemented APIs are: \f(CW\*(C`guestfs_cat\*(C'\fR,
\&\f(CW\*(C`guestfs_find\*(C'\fR, \f(CW\*(C`guestfs_read_file\*(C'\fR, \f(CW\*(C`guestfs_read_lines\*(C'\fR,
\&\f(CW\*(C`guestfs_write\*(C'\fR, \f(CW\*(C`guestfs_write_append\*(C'\fR, \f(CW\*(C`guestfs_lstatlist\*(C'\fR,
\&\f(CW\*(C`guestfs_lxattrlist\*(C'\fR, \f(CW\*(C`guestfs_readlinklist\*(C'\fR, \f(CW\*(C`guestfs_ls\*(C'\fR.
.PP
\fIvirt tools\fR
.IX Subsection "virt tools"
.PP
\&\f(CW\*(C`guestfish touch \*(Aqwin:c:\enew_file\*(Aq\*(C'\fR now works as expected.
.PP
\&\f(CW\*(C`guestfish\*(C'\fR has a new \fI\-\-network\fR option, which enables the user
network in libguestfs.
.PP
You can set \f(CW\*(C`GUESTFISH_PS1\*(C'\fR to use fancy prompts in \f(CW\*(C`guestfish\*(C'\fR.
.PP
\&\f(CW\*(C`rsync\*(C'\fR, \f(CW\*(C`ssh\*(C'\fR, \f(CW\*(C`less\*(C'\fR and \f(CW\*(C`lrzip\*(C'\fR commands are now available in
virt-rescue.  In addition, \f(CW\*(C`rsync\*(C'\fR can be used through the API for
doing incremental copies.
.PP
\&\f(CW\*(C`virt\-sparsify\*(C'\fR uses qcow2 v3 for increased efficiency.
.PP
\&\f(CW\*(C`virt\-sysprep\*(C'\fR enhancements:
.IP \(bu 4
generate new UUIDs for PVs and VGs
.IP \(bu 4
remove the local machine ID (Wanlong Gao)
.IP \(bu 4
remove ABRT data (Wanlong Gao)
.IP \(bu 4
remove puppet keys and log files (Wanlong Gao)
.IP \(bu 4
remove process accounting files (Wanlong Gao)
.IP \(bu 4
new \fI\-\-firstboot\fR parameter allowing firstboot scripts
for customizing guests
.IP \(bu 4
remove HOSTNAME field from \f(CW\*(C`ifcfg\-eth*\*(C'\fR files (Wanlong Gao)
.IP \(bu 4
miscellaneous improvements for SuSE (Olaf Hering)
.IP \(bu 4
remove man pages cache (Wanlong Gao)
.IP \(bu 4
remove crash data generated by kexec-tools (Wanlong Gao)
.PP
\&\f(CW\*(C`virt\-make\-fs\*(C'\fR can now create virtual floppy disks (VFDs).
.PP
\&\f(CW\*(C`guestmount\*(C'\fR has a \fI\-\-pid\-file\fR option, which can be used to avoid a
race condition between unmounting the filesystem and using the
underlying disk image.
.PP
\fIlanguage bindings\fR
.IX Subsection "language bindings"
.PP
Full-featured Lua bindings have been added in this release
(thanks to Jerome Vuarand for many suggestions).
.PP
In Ruby, optional arguments hash is optional.
.PP
In Python, optional arguments now don't use special "sentinel"
values, so any integer can be passed as an optional argument.
.PP
Erlang bindings now come with examples and tests.
.PP
Erlang bindings now handle 64 bit integer parameters correctly.
.PP
The automated 'bindtests' now test for 64 bit cleanliness in parameter
passing.  Several bugs in the bindings were found and fixed as a
result.
.PP
Better handling of blocking and non-blocking functions should make
libguestfs calls more efficient.
.PP
\fIinspection\fR
.IX Subsection "inspection"
.PP
Windows guests with unlimited-sized Registries are now supported.
By adding the hivex API to the libguestfs API, it is much more
efficient and easier to inspect and modify the Windows Registry
in guests.
.PP
Better support for SuSE guests (Olaf Hering).
.PP
Return the architecture of installed applications (John Eckersberg).
.PP
Windows 8 is now supported.
.PP
Fedora 18 is now supported.
.PP
Inspection of ISOs/CDs/DVDs can now use the libosinfo database.
.PP
\fIports\fR
.IX Subsection "ports"
.PP
Libguestfs without the appliance can be compiled on Mac OS X
(Masami HIRATA).
.PP
RHEL 5 is now explicitly supported through the 'oldlinux' branch
in upstream git.
.PP
PowerPC 64 bit is now supported.  Also libguestfs has been
examined for endianness bugs and these have been fixed.
.PP
\fIdaemon\fR
.IX Subsection "daemon"
.PP
A man page for the daemon (\fBguestfsd\fR\|(8)) is included.
.SS Security
.IX Subsection "Security"
\fIguestfish history file\fR
.IX Subsection "guestfish history file"
.PP
The \fR\f(CI$HOME\fR\fI/.guestfish\fR history file is now created with 0600
permissions (instead of 0644 before) so it is no longer world
readable.
.PP
\fICVE\-2012\-2690\fR
.IX Subsection "CVE-2012-2690"
.PP
Old versions of both \f(CW\*(C`virt\-edit\*(C'\fR and the \f(CW\*(C`guestfish\*(C'\fR \f(CW\*(C`edit\*(C'\fR command
created a new file containing the changes but did not set the
permissions, etc of the new file to match the old one.  The result
of this was that if you edited a security sensitive file such as
\&\fI/etc/shadow\fR then it would be left world-readable after the edit.
.PP
This issue was assigned CVE\-2012\-2690, and is fixed in libguestfs ≥ 1.16.
.PP
For further information, see
https://bugzilla.redhat.com/show_bug.cgi?id=788642
.SS "New APIs"
.IX Subsection "New APIs"
.Vb 10
\& acl\-delete\-def\-file
\& acl\-get\-file
\& acl\-set\-file
\& canonical\-device\-name
\& cap\-get\-file
\& cap\-set\-file
\& create\-flags
\& device\-index
\& disk\-has\-backing\-file
\& disk\-format
\& disk\-virtual\-size
\& filesystem\-available
\& fill\-dir
\& fstrim
\& get\-cachedir
\& get\-libvirt\-requested\-credentials
\& get\-libvirt\-requested\-credential\-prompt
\& get\-libvirt\-requested\-credential\-challenge
\& get\-libvirt\-requested\-credential\-defresult
\& get\-tmpdir
\& hivex\-close
\& hivex\-commit
\& hivex\-node\-add\-child
\& hivex\-node\-children
\& hivex\-node\-delete\-child
\& hivex\-node\-get\-child
\& hivex\-node\-get\-value
\& hivex\-node\-name
\& hivex\-node\-parent
\& hivex\-node\-set\-value
\& hivex\-node\-values
\& hivex\-open
\& hivex\-root
\& hivex\-value\-key
\& hivex\-value\-type
\& hivex\-value\-utf8
\& hivex\-value\-value
\& inspect\-list\-applications2 (John Eckersberg)
\& list\-ldm\-volumes
\& list\-ldm\-partitions
\& ldmtool\-create\-all
\& ldmtool\-diskgroup\-disks
\& ldmtool\-diskgroup\-name
\& ldmtool\-diskgroup\-volumes
\& ldmtool\-remove\-all
\& ldmtool\-scan
\& ldmtool\-scan\-devices
\& ldmtool\-volume\-hint
\& ldmtool\-volume\-partitions
\& ldmtool\-volume\-type
\& ls0
\& max\-disks
\& mke2fs (Wanlong Gao)
\& mklost\-and\-found
\& mkswap [added label and uuid optional arguments]
\& mktemp (Wanlong Gao)
\& nr\-devices
\& parse\-environment
\& parse\-environment\-list
\& rm\-f
\& rsync
\& rsync\-in
\& rsync\-out
\& set\-cachedir
\& set\-libvirt\-supported\-credentials
\& set\-libvirt\-requested\-credential
\& set\-tmpdir
\& shutdown [backported to 1.16 and 1.18]
\& tar\-in [added compress flag]
\& tar\-out [added compress, numericowner, excludes flags]
\& umount [added force and lazy optional arguments]
\& utsname
\& xfs\-admin (Wanlong Gao)
\& xfs\-growfs (Wanlong Gao)
\& xfs\-info (Wanlong Gao)
\& xfs\-repair (Wanlong Gao)
.Ve
.PP
In the C API only:
.PP
.Vb 2
\& guestfs_push_error_handler
\& guestfs_pop_error_handler
.Ve
.SS Internals
.IX Subsection "Internals"
qemu ≥ 1.1 is required (≥ 1.2 preferred).
.PP
febootstrap ≥ 3.20 is required.
.PP
libvirt is optional, but if you want to use the new libvirt
backend for launching the appliance then libvirt ≥ 0.10.2 would
be required.
.PP
Coverity has been run over the complete codebase, and many
issues fixed (thanks Ondrej Vasik, Kamil Dudka).
.PP
Functions which previously had no optargs can now be converted to ones
with optargs, making extending the API much more flexible.  Source and
binary backwards compatibility is preserved for users of the API.
.PP
The way that libguestfs APIs and structures are represented in the
generator has changed to use an OCaml struct instead of a tuple.  This
makes generator descriptions more flexible and easier to understand.
For details see commits 39d1a7db and eb185eef.
.PP
Separation of the library code into more files:
.IP \(bu 4
Launch backends are now located in separate files
eg. \fIsrc/launch\-appliance.c\fR, \f(CW\*(C`src/launch\-libvirt.c\*(C'\fR.
.IP \(bu 4
Generated action code is now split over several \fIsrc/action*.c\fR
files, for faster compilation.
.IP \(bu 4
The huge \fIsrc/guestfs.c\fR file is now split into smaller logical
units.
.PP
POD (documentation) is now generated using a rewritten Perl
program instead of pod2* + shell scripts.
.PP
Man pages now contain stable dates (Hilko Bengen).
.PP
Skipped tests now exit with code 77, so they appear as
\&\f(CW\*(C`SKIP:\*(C'\fR in \f(CW\*(C`make check\*(C'\fR output.
.PP
The parallel mount-local test has been rewritten in C (RHBZ#838081).
.PP
Ruby 1.8.5 is now supported (though Ruby ≥ 1.9 is preferred).
.PP
Perl bindings can be disabled via \f(CW\*(C`./configure \-\-disable\-perl\*(C'\fR
(Wulf C. Krueger).  Note that Perl is still required in order to build
libguestfs.
.PP
Java bindings are now enabled/disabled using \f(CW\*(C`./configure \-\-with\-java\*(C'\fR
or \f(CW\*(C`./configure \-\-without\-java\*(C'\fR (Wulf C. Krueger).
.PP
New configure options \f(CW\*(C`./configure \-\-enable\-code\-profiling\*(C'\fR and
\&\f(CW\*(C`./configure \-\-enable\-code\-coverage\*(C'\fR.
.PP
Multiple fixes to use of 64 bit integers in language bindings.
.PP
The appliance backend now uses sgabios instead of vgabios
(Dan Berrange).
.PP
The \f(CW\*(C`./run\*(C'\fR script now sets enough environment variables that you
can run OCaml, Python, Ruby, Java, GJS, Erlang, Lua programs.
.PP
\&\f(CW\*(C`./run \-\-test\*(C'\fR flag for running tests with minimal output.  It also
prints the time taken to run each test.
.PP
The \f(CW\*(C`./run\*(C'\fR script now builds up paths cumulatively, meaning that you
can use \f(CW\*(C`./run\*(C'\fR twice, or use the libguestfs and libvirt \f(CW\*(C`./run\*(C'\fR
scripts together.
.PP
You can extract a list of external commands required by the
daemon, making building the appliance on certain distros easier
(Olaf Hering).
.PP
The \f(CW\*(C`virt\-rescue\*(C'\fR command is now tested during \f(CW\*(C`make check\*(C'\fR.
.PP
The generator now removes unused generated files.  This helps
when going back and forth with git rebase, git bisect, etc.
.PP
Tests now run in a separate toplevel \f(CW\*(C`tmp/\*(C'\fR directory in the source.
This allows the directory to be labelled for SELinux (sVirt), and also
makes it easier to clean up.
.PP
\&\f(CW\*(C`make syntax\-check\*(C'\fR now works to a greater extent, and many problems
in the main code that were found by syntax-check have been fixed
(thanks Jim Meyering).
.PP
Emacs mode (\-*\- foo \-*\-) has been added to generated files.
.PP
Progress bar output is now sent to \fI/dev/tty\fR so it doesn't end up in
the regular output of the program.  virt-resize and virt-sparsify now
suppress progress bars if stdout is not a tty.
.PP
There is now a \f(CW\*(C`./configure \-\-without\-libvirt\*(C'\fR option.  This is
useful for testing that the code still compiles without libvirt.
.PP
There is now an internal mini-library for running commands.  This
allows us to redirect errors from external commands into events.
.PP
Code for handling temporary directories and the appliance cache was
completely overhauled.
.PP
Code for temporarily ignoring/disabling errors now looks like this:
.PP
.Vb 3
\& guestfs_push_error_handler (g, NULL, NULL);
\& guestfs_mkdir (g, "/foo"); /* We don\*(Aqt care if this fails. */
\& guestfs_pop_error_handler (g);
.Ve
.PP
The \f(CW\*(C`tests/extra\*(C'\fR directory has gone.  The "extra tests" are now
split into separately runnable targets, such as \f(CW\*(C`make check\-valgrind\*(C'\fR.
Use \f(CW\*(C`make help\*(C'\fR to get a summary of the targets.
.PP
The \f(CW\*(C`lpj\*(C'\fR option is passed to the appliance kernel when using TCG.
This should improve clock stability (thanks Marcelo Tosatti,
Olaf Hering).
.SS "Bugs fixed"
.IX Subsection "Bugs fixed"
.IP https://bugzilla.redhat.com/882417 4
.IX Item "https://bugzilla.redhat.com/882417"
libguestfs tools fail with odd error messages if TMPDIR is not an absolute path
.IP https://bugzilla.redhat.com/882299 4
.IX Item "https://bugzilla.redhat.com/882299"
Windows 8 guest disks can't be mounted: "The NTFS partition is in an unsafe state. Please resume and shutdown Windows fully (no hibernation or fast restarting), or mount the volume read-only with the 'ro' mount option."
.IP https://bugzilla.redhat.com/881953 4
.IX Item "https://bugzilla.redhat.com/881953"
libguestfs: migration to /etc/hostname, /etc/vconsole.conf, /etc/locale.conf
.IP https://bugzilla.redhat.com/880801 4
.IX Item "https://bugzilla.redhat.com/880801"
virt-df with two \-a options displays incorrect disk image name
.IP https://bugzilla.redhat.com/879416 4
.IX Item "https://bugzilla.redhat.com/879416"
libguestfs-test-tool pauses when you use \-\-help option
.IP https://bugzilla.redhat.com/876579 4
.IX Item "https://bugzilla.redhat.com/876579"
mke2fs API does not apply block device naming translation to journaldevice optarg
.IP https://bugzilla.redhat.com/860235 4
.IX Item "https://bugzilla.redhat.com/860235"
SELinux policy ought to allow qemu to write to unconfined_u:object_r:user_tmp_t:s0
.IP https://bugzilla.redhat.com/859949 4
.IX Item "https://bugzilla.redhat.com/859949"
RFE: inspect-list-applications does not return the architecture of RPM packages
.IP https://bugzilla.redhat.com/859885 4
.IX Item "https://bugzilla.redhat.com/859885"
inspect-list-applications does not list all installed RPM packages with same name and different versions
.IP https://bugzilla.redhat.com/859876 4
.IX Item "https://bugzilla.redhat.com/859876"
guestfish printed paths are not canonicalized
.IP https://bugzilla.redhat.com/859875 4
.IX Item "https://bugzilla.redhat.com/859875"
Progress bar output should go to tty(?) stderr(?)
.IP https://bugzilla.redhat.com/858696 4
.IX Item "https://bugzilla.redhat.com/858696"
virt-sysprep reports Guestfs.Error("read_lines: fopen: /etc/sysconfig/network: No such file or directory") on some Fedora guests
.IP https://bugzilla.redhat.com/858128 4
.IX Item "https://bugzilla.redhat.com/858128"
libguestfs fail to list devices added by add-drive-ro-with-if twice
.IP https://bugzilla.redhat.com/858126 4
.IX Item "https://bugzilla.redhat.com/858126"
virt-inspector fail to work with some windows guests
.IP https://bugzilla.redhat.com/853762 4
.IX Item "https://bugzilla.redhat.com/853762"
virt-sparsify should use a more robust method to detect the input format
.IP https://bugzilla.redhat.com/853393 4
.IX Item "https://bugzilla.redhat.com/853393"
libvirt doesn't label console, serial sockets
.IP https://bugzilla.redhat.com/853159 4
.IX Item "https://bugzilla.redhat.com/853159"
virt-rescue in Fedora 18 is completely broken
.IP https://bugzilla.redhat.com/852394 4
.IX Item "https://bugzilla.redhat.com/852394"
libguestfs inspection limits registries to 100 MiB
.IP https://bugzilla.redhat.com/852194 4
.IX Item "https://bugzilla.redhat.com/852194"
virt-sparsify \-\-compress fails if output is raw format
.IP https://bugzilla.redhat.com/847881 4
.IX Item "https://bugzilla.redhat.com/847881"
RFE: allow extra arguments (like \-\-exclude) to tar-out
.IP https://bugzilla.redhat.com/847880 4
.IX Item "https://bugzilla.redhat.com/847880"
tar-out should allow (or force) \-\-numeric\-owner
.IP https://bugzilla.redhat.com/845522 4
.IX Item "https://bugzilla.redhat.com/845522"
guestfish "copy-out / localdir" command fails with "No such file or directory"
.IP https://bugzilla.redhat.com/845488 4
.IX Item "https://bugzilla.redhat.com/845488"
Long filenames on NTFS cause tar-out, copy-out etc to fail with error "Cannot open: File name too long"
.IP https://bugzilla.redhat.com/842307 4
.IX Item "https://bugzilla.redhat.com/842307"
RFE: Need help designing and implementing selinux policy for libguestfs/sVirt
.IP https://bugzilla.redhat.com/840572 4
.IX Item "https://bugzilla.redhat.com/840572"
virt-make-fs / tar-in should support vfat properly
.IP https://bugzilla.redhat.com/840115 4
.IX Item "https://bugzilla.redhat.com/840115"
guestfish touch problem \- case_sensitive_path API expects the file to exist
.IP https://bugzilla.redhat.com/836710 4
.IX Item "https://bugzilla.redhat.com/836710"
Data loss when writing to qcow2\-format disk files
.IP https://bugzilla.redhat.com/834712 4
.IX Item "https://bugzilla.redhat.com/834712"
lvresize, lvresize-free fail unnecessarily if you don't change the size of the LV: "New size (nn extents) matches existing size (nn extents)"
.IP https://bugzilla.redhat.com/824716 4
.IX Item "https://bugzilla.redhat.com/824716"
compress-device-out didn't support bzip2
.IP https://bugzilla.redhat.com/824043 4
.IX Item "https://bugzilla.redhat.com/824043"
guestfish unrecognized mount option gives confusing error message
.IP https://bugzilla.redhat.com/823887 4
.IX Item "https://bugzilla.redhat.com/823887"
Filenames containing Chinese characters can't be created on vfat filesystems
.IP https://bugzilla.redhat.com/823885 4
.IX Item "https://bugzilla.redhat.com/823885"
virt-make-fs cannot create vfat filesystem containing filesystems with Chinese characters
.IP https://bugzilla.redhat.com/823883 4
.IX Item "https://bugzilla.redhat.com/823883"
virt-make-fs \-t fat fails with an obscure error message
.IP https://bugzilla.redhat.com/823821 4
.IX Item "https://bugzilla.redhat.com/823821"
Inspection fails when /etc/HOSTNAME is empty
.IP https://bugzilla.redhat.com/801117 4
.IX Item "https://bugzilla.redhat.com/801117"
libguestfs cannot get icon for Windows 8
.IP https://bugzilla.redhat.com/798979 4
.IX Item "https://bugzilla.redhat.com/798979"
Ubuntu install CDs from oneiric onwards are not recognized: "multi-boot operating systems are not supported"
.IP https://bugzilla.redhat.com/782167 4
.IX Item "https://bugzilla.redhat.com/782167"
libguestfs doesn't recognize Windows Dynamic disks in some configurations, eg. spanned
.IP https://bugzilla.redhat.com/713678 4
.IX Item "https://bugzilla.redhat.com/713678"
Not all febootstrap messages are redirected to log callbacks
.IP https://bugzilla.redhat.com/627675 4
.IX Item "https://bugzilla.redhat.com/627675"
libguestfs inspector code cannot handle /dev/disk/by\-id/* paths
.IP https://bugzilla.redhat.com/602997 4
.IX Item "https://bugzilla.redhat.com/602997"
part-get-bootable gives wrong result with an unordered part layout
.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.