GUESTFS-RELEASE-NOTES-1.12(1)

📦
version 1.61.3 · 14 versions
, in centos-stream 10

🌸 NAME 🌸

guestfs-release-notes — the libguestfs Release Notes, aka the receipts 💅

Heads up bestie, this is the guestfs-release-notes-1.12(1) page from the Virtualization Support manual 💖

✨ RELEASE NOTES FOR LIBGUESTFS 1.12 ✨

Okay so these notes only cover the differences from the previous stable/dev branch split, which was 1.10.0. That's it, that's the scope 🫶 If you want the detailed changelogs, go look at the git repository, or the ChangeLog file that ships in the tarball. iykyk 📚

🦋 New features 🦋

🐟 guestfish

  • guestfish strings can use escapes now, like literally:
><fs> write /foo "line 1\nline 2\n"
  • the write-append command in guestfish lets you append to files — no cap 🔥
  • long-running file uploads and downloads can be cancelled, either through the API or by hitting ^C in guestfish 😌
  • there's a new guestfish "display" command for displaying graphical files inside guests 🖼️
  • in guestfish, tab completion now works on /dev/mapper devices ✨

🔍 virt-inspector

  • the inspection API can get an icon or logo for certain guests 🎀
  • virt-inspector includes the logo and hostname for certain guests
  • virt-inspector can now get the version and release numbers for RPM packages 📦
  • CentOS and Scientific Linux are now treated as separate distros by the inspection API — they said "we are not the same person" 💀

📐 virt-resize

  • virt-resize can now handle btrfs 🌳
  • new virt-resize --ntfsresize-force option lets Windows VMs be resized multiple times, iconic

🛠️ other virt tools

  • guestfish, guestmount, virt-cat, virt-df, virt-edit, virt-filesystems, virt-inspector, virt-ls and virt-rescue now let you use the "-d UUID" option to specify a guest by UUID. This makes them more robust to use from other programs, fr fr 🫶
  • virt-ls -lR option allows complex file iteration and guest analysis 🔎
  • virt-win-reg supports HKEY_USERS\<SID> and HKEY_USERS\<username> 👑
  • virt-win-reg new option --unsafe-printable-strings allows printable strings to be displayed in the output. and yes bestie it is unsafe: read the documentation before using it 😭
  • virt-edit has been rewritten in C. glow up ✨

🧬 API and language bindings

  • Java is now completely supported. See http://libguestfs.org/guestfs-java.3.html ☕
  • JRuby is supported via the Java bindings 💎
  • guestfs_close now appears in trace messages 👀
  • the Python binding adds an explicit g.close() method 🐍
  • Python programs can now use the new event API
  • the Python GIL is released during libguestfs calls, which lets multithreaded Python programs work properly — highkey a big deal 🧵
  • 9pfs (Plan 9 filesystems exported from the host) are now supported 🌐
  • add -DGUESTFS_WARN_DEPRECATED=1 to warn about use of deprecated API functions in C programs ⚠️
  • new manual page guestfs-recipes(1) with recipes 🍓
  • mkfs-opts can now set inode size and sector size on created filesystems (thanks Nikita Menkovich) 💜
  • guestfs_last_errno is now accessible from OCaml (as g#last_errno ()) 🐫

🔒 Security 🔒

  • optargs_bitmask is checked even for calls that have no optional arguments. This closes a possible exploit in the daemon from untrusted callers 🛡️
bestie this one is serious — it's a security fix, not a vibe. don't skip it 💅

🌟 New APIs 🌟

 btrfs-filesystem-resize, get-pgroup, inspect-get-icon, is-zero,
 is-zero-device, list-9p, list-dm-devices, mount-9p, ntfsresize-opts,
 set-pgroup, write-append

🔧 Internals 🔧

  • Coverity (a static analysis tool) was run across the codebase and many fixes were made 🧹
  • the Generator can handle functions that return RBufferOut and have optional arguments
  • compatible with Perl 5.14 🐪
  • compatible with gcc 4.6
  • perform safety checks on QEMU 🛡️
  • C API tests can now fully test calls that have optional arguments
  • use ./configure --enable-install-daemon to install /usr/sbin/guestfsd
  • the po-docs directory now covers all man pages
  • stderr from the qemu process is now captured by the event subsystem 📥

🩹 Bugs fixed 🩹

  • 602997 part-get-bootable gives wrong result with an unordered part layout
  • 661280 virt-rescue: panic when shutting down: "/sbin/reboot: No such file or directory"
  • 700369 qemu-system-x86_64 says 'KVM not supported for this target'
  • 705200 guestmount attempt results in access denied
  • 714981 'list-filesystems' does not know about virtio 9p filesystems or detect existing mounts
  • 717786 libguestfs python bindings should have an explicit close call
  • 721275 virt-resize in F16 should support btrfs

👀 SEE ALSO 👀

guestfs-examples(1), guestfs-faq(1), guestfs-performance(1), guestfs-recipes(1), guestfs-testing(1), guestfs(3), guestfish(1), http://libguestfs.org/

💖 AUTHOR 💖

Richard W.M. Jones 👑

Copyright (C) 2009-2025 Red Hat Inc.

📜 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.

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.

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.

🐛 BUGS 🐛

To get a list of bugs against libguestfs, use this link: https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools

To report a new bug against libguestfs, use this link: https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools

When reporting a bug, please supply:

  • The version of libguestfs.
  • Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
  • Describe the bug accurately and give a way to reproduce it.
  • Run libguestfs-test-tool(1) and paste the complete, unedited output into the bug report.
bestie the "complete, unedited" part is not a suggestion 😭 paste the whole thing, no trimming 💅

okay that's the whole page, mwah 💋 this was libguestfs-1.61.3, dated 2026-09-16, and it's the guestfs-release-notes-1.12(1) page — go forth and resize some VMs responsibly 🧚✨

📦 where this page comes from