GUESTFS-RELEASE-NOTES-1.10(1)

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

🦋 guestfs-release-notes — libguestfs Release Notes 👑

okay so this is the guestfs-rel...-notes-1.10(1) page, bestie — it's the Virtualization Support corner of the manual and it's literally just the glow-up diary for libguestfs. grab a strawberry drink 🍓 and let's go.

✨ NAME ✨

guestfs-release-notes — libguestfs Release Notes 💖

🌸 RELEASE NOTES FOR LIBGUESTFS 1.10 🌸

okay so real talk: these notes only cover what changed since the previous stable/dev branch split (1.8.0). that's it, that's the scope. if you're the kind of person who wants the detailed changelogs (and honestly, icon behavior), go look at the git repository, or the ChangeLog file that ships inside the tarball. iykyk 🫶

🎀 New features 🎀

  • libguestfs and its tools can now be used against live virtual machines. the way that works: peep the guestfish --live and guestmount --live options, and (for the low-level interface girlies) the brand new APIs set-attach-method and get-attach-method. slay.
  • new virt tools just dropped: virt-copy-in, virt-copy-out, virt-tar-in, virt-tar-out. periodt.
  • libguestfs can now get the drive letter mappings for Windows guests. 👑
  • virt-inspector displays drive letter mappings for Windows guests too. iconic.
  • drive letters can now be used in virt-edit and guestfish programs when you're operating on Windows guests. no cap.
  • virt-resize now works on 32 bit hosts. we love accessibility. 💅
  • you can now inspect the install disks and live CDs of many different operating systems — yes, many. 🌈
  • guestfish <! cmd — this bad boy executes a shell cmd and inlines the result. literally so handy.
  • guestfish, guestmount, virt-rescue now all support --ro and --rw options, and you can pick the default for this via a configuration file at /etc/libguestfs-tools.conf. main character energy from a config file, honestly.
  • new event API allows more than one callback to be registered for each event, makes it possible to call the API from other languages, and lets nearly all log, debug and trace messages be rerouted away from stderr. big.
  • greater FHS compliance for temporary files, including using /var/tmp for large cached files that should survive a reboot — instead of /tmp. 🧚
  • guestfish and guestmount -m option now allows mount options to be passed through to the underlying filesystem. obsessed.
  • mkfs-opts allows filesystem features to be specified. cute AND functional.
  • more intelligent handling of mountpoints, allowing mkmountpoint, mount and umount-all commands to work together properly. they finally get along 😭
  • trace messages are prefixed with a distinct string, allowing them to be easily 'grepped' out from debug output. grep girlies rise up 🔥
  • guestfs_launch (that's the guestfish run command, bestie) now produces progress messages (a guestfish progress bar) if it takes longer than 5 seconds to run. bless.
  • several long-running commands where we are unable to estimate time to completion generate "pulse mode" progress events. the progress bar in guestfish has been updated to display these. ✨
  • new example code published in: C, Perl, Python, OCaml, Ruby. all the languages, all the vibes.
  • new virt-dhcp-address example program. 💜
  • the Java and Ruby bindings have been improved greatly. like, greatly greatly.
  • Perl includes a way to get the errno of the last error. yass.
  • Python bindings now compatible with rpyc (thanks Erez Shinan). 🫶
  • Transifex is now being used to manage translations: http://www.transifex.net/projects/p/libguestfs/ 🌍
  • inspection now supports Red Hat Desktop and Slackware distributions.
  • inspection no longer fails for Windows guests that have two or more disks. the two-disk Windows girlies are finally seen 💀
  • inspection can now tell the difference between Windows 2008 Server and Windows 7. it's giving detective.
  • inspection can detect 32 bit applications installed in 64 bit Windows, running on the WOW64 emulator. 🔍
  • a series of protocol fixes has fixed the old bug RHBZ#576879 which used to cause errors during the upload command to lose protocol synchronization. we stan a fixed bug.
  • new logo! 🎨 (this is the important one, obviously)

🔒 Security 🔒

[none]

...yeah. that's the whole section. nothing to see here, moving on 💀

⭐ New APIs ⭐

  • first-private
  • get-attach-method
  • inspect-get-drive-mappings
  • inspect-get-product-variant
  • inspect-get-windows-current-control-set
  • next-private
  • resize2fs-M
  • set-attach-method

🧚 Internals 🧚

  • the 'HACKING' file is obsolete. its contents have been moved into a section of the guestfs(3) manual page. rip to a legend, but the info's still there 🕊️
  • libguestfs-test-tool simplified. it no longer needs the static binary or tries to construct an ISO. less chaos, love that.
  • rpcgen-generated files are compiled with -fno-strict-aliasing which should be safer (thanks Matt Booth). 💖
  • virt-resize was rewritten in OCaml. a glow-up in a whole other language.
  • guestfish and other tools tested with valgrind; some memory leaks were fixed. no more leaking, we fixed the leak 💅

💀 Bugs fixed 💀

  • 502533 Updated Polish translation of libguestfs
  • 576879 libguestfs protocol loses synchronization if you 'upload' before mounting disks
  • 599503 document that mkmountpoint and umount-all cannot be mixed
  • 617440 guestfish: fails to tilde expand '~' when the $HOME env is unset
  • 664558 RFE: Allow to set log callback in Ruby bindings
  • 665358 Punjabi Translation Completed (pa_IN)
  • 666577 libguestfs: unknown filesystem /dev/fd0
  • 667610 Multiple bugs, memory leaks in libguestfs ruby bindings
  • 668112 virt-filesystems command fails on guest with corrupt filesystem label
  • 668574 guestfish -i is trying to mount all mounts from /etc/fstab and fails with an error when device doesn't exists
  • 673479 Add a grep-friendly string to LIBGUESTFS_TRACE output
  • 674130 Inspection code fails for Windows guest with two disks
  • 682756 libguestfs trace segfaults when list-filesystems returns error
  • 682979 libguestfs incorrectly detects Red Hat desktop as 'redhat-based' instead of 'redhat'
  • 690819 mkfs fails creating a filesystem on a disk device when using a disk with 'ide' interface
  • 691389 Extended attributes don't work over guestmount (FUSE)
  • 691724 virt-inspector reports unknown filesystem /dev/vda1
  • 692545 inspect-list-applications fails to detect 32 bit apps installed under WOW64 emulator on 64 bit Windows
  • 693324 sfdisk's python interface only accepts lists of type 'list' for the lines parameter

👀 SEE ALSO 👀

run don't walk, bestie:

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 — the icon, the legend, the main character of this whole operation 👑

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.

⚠️ okay bestie, the fine print is real: this comes with NO WARRANTY, not even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. so don't come for us if it acts up, fr fr. read the GNU General Public License for the deets.

🐛 BUGS 🐛

when you're reporting a bug, please, please, please supply all of this 🥺:

  1. the version of libguestfs.
  2. where you got libguestfs (eg. which Linux distro, compiled from source, etc).
  3. describe the bug accurately and give a way to reproduce it.
  4. run libguestfs-test-tool(1) and paste the complete, unedited output into the bug report. like, don't trim it, don't beautify it, paste the whole thing 🙈
and that's the whole page! 💅

kisses, this was libguestfs-1.61.3, dated 2026-09-16, and it's still wearing the guestfs-rel...-notes-1.10(1) name tag 🎀🦋 bye bestie, go fix some bugs 💖

📦 where this page comes from