1guestfs-release-notes-1.8(1)Virtualization Supportguestfs-release-notes-1.8(1)
2
6 guestfs-release-notes - libguestfs Release Notes
7
9 These release notes only cover the differences from the previous
10 stable/dev branch split (1.6.0). For detailed changelogs, please see
11 the git repository, or the ChangeLog file distributed in the tarball.
12 New features
14 - Support and packages for Debian and Ubuntu.
15 - Daily builds from git repository on Debian and Ubuntu to reduce risk
17 of regressions.
18 - Port to ArchLinux 'pacman' (thanks Thomas S Hatch).
20 - The following tools have been rewritten in C (originally in Perl):
22 . virt-cat
24 . virt-df
25 . virt-inspector
26 . virt-ls
27 . virt-rescue
28 - Some C tools support encrypted guests automatically. This is
30 supported in: guestfish, guestmount, virt-cat, virt-inspector,
31 virt-ls.
32 - New tool virt-filesystems (in C) which is a replacement for
34 virt-list-filesystems and virt-list-partitions, and has a superset
35 of the functionality of those tools.
36 - guestfish, guestmount and the C tools use unified command line option
38 parsing, so they support many common options such as '-a disk.img',
39 '-d libvirt-domain', '-x', '-v'. The old command line option
40 parsing is preserved for compatibility in scripts etc.
41 - guestfish no longer has any dependencies on Perl
43 - New man pages containing programming examples: guestfs-examples(3) (C/C++),
45 guestfs-ocaml(3), guestfs-python(3), guestfs-ruby(3).
46 - Trace mode prints return values from API functions.
48 - virt-inspector can list applications installed in Windows guests, along
50 with a great deal of information about those applications.
51 - Add support for inspecting: Linux Mint, Mandriva, FreeBSD.
53 - guestfish --rw option (with no effect currently) to make potentially
55 dangerous write access explicit.
56 - guestfish --listen --csh for compatibility with csh, tcsh (thanks
58 Eric Blake).
59 - The first upstream version that introduced each API function is now
61 documented in guestfs(3).
62 - guestfs_last_errno allows you to retrieve the errno from the
64 daemon, correctly translated to the local operating system.
65 - Functions can now have optional parameters.
67 - Progress bars and progress notifications can now happen for upload
69 commands.
70 - Appliance builder more careful about not leaving temporary files
72 around in /tmp.
73 - getfattr/setfattr commands added to virt-rescue.
75 - ROADMAP file covers roadmap and goals for future releases.
77 Security
79 - New SECURITY section in guestfs(3) API documentation.
80 - virt-inspector no longer runs any guest commands.
82 - Inspection code is more careful about avoiding very large files
84 from guests which might previously have caused a denial of service.
85 - FUSE calls into guestmount are now traced when using guestmount -x.
87 New APIs
89 - add-domain
90 - add-drive-opts
91 - getxattr
92 - inspect-get-hostname
93 - inspect-get-package-format
94 - inspect-get-package-management
95 - inspect-get-roots
96 - inspect-list-applications
97 - lgetxattr
98 - mkfs-opts
99 Internals
101 - C programs now only link precisely with the libraries that they use.
102 - PCRE, libmagic, hivex and libvirt libraries are now completely
104 optional for building.
105 - Multiple memory leaks and file descriptor leaks fixed.
107 - Add a POD wrapper to unify generation of man pages and HTML files
109 across all programs.
110 - Source includes phony images of Fedora, Debian, Ubuntu and
112 Windows guests.
113 - Ruby bindings have 'make install' rule.
115 - <guestfs.h> is now a single file.
117 - <guestfs.h> does not require XDR headers.
119 - ocaml xml-light library is no longer required to build (thanks
121 Maxim Koltsov).
122 - ./configure --disable-[...] for each language binding (thanks
124 Maxim Koltsov).
125 - Old ocaml-viewer program removed (use guestfs-browser instead).
127 - New C API test type 'InitScratchFS' makes the tests run a little
129 more quickly.
130 - Excluded packages in the appliance are now listed in a separate
132 file appliance/excludelist.in, and can be customized per-distro.
133 Bugs fixed
135 - 663407 readlink and readlinklist returns /sysroot/ in some paths
136 - 661280 virt-rescue: panic when shutting down: "/sbin/reboot: No such file or directory"
137 - 657499 checksum: wrong check sum type causes umount to fail
138 - 655554 Whole disk paths are not made canonical by virt-inspector
139 - 654638 openssl updated to 1.0.0b libguestfs depends on exact file names
140 - 652796 ruby bindings not installed by 'make install', hence omitted from the binary distribution
141
143 guestfs-examples(1), guestfs-faq(1), guestfs-performance(1),
144 guestfs-recipes(1), guestfs-testing(1), guestfs(3), guestfish(1),
145 http://libguestfs.org/
146
148 Richard W.M. Jones
149
151 Copyright (C) 2009-2020 Red Hat Inc.
152
154 This program is free software; you can redistribute it and/or modify it
155 under the terms of the GNU General Public License as published by the
156 Free Software Foundation; either version 2 of the License, or (at your
157 option) any later version.
158 This program is distributed in the hope that it will be useful, but
160 WITHOUT ANY WARRANTY; without even the implied warranty of
161 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
162 General Public License for more details.
163 You should have received a copy of the GNU General Public License along
165 with this program; if not, write to the Free Software Foundation, Inc.,
166 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
167
169 To get a list of bugs against libguestfs, use this link:
170 https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
171 To report a new bug against libguestfs, use this link:
173 https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
174 When reporting a bug, please supply:
176 • The version of libguestfs.
178 • Where you got libguestfs (eg. which Linux distro, compiled from
180 source, etc)
181 • Describe the bug accurately and give a way to reproduce it.
183 • Run libguestfs-test-tool(1) and paste the complete, unedited output
185 into the bug report.
186libguestfs-1.48.3 2022-05-26 guestfs-release-notes-1.8(1)