GUESTFS-RELEASE-NOTES-1.56(1)

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

💖 guestfs-release-notes — libguestfs Release Notes 💖

okay bestie, welcome to the libguestfs release notes page — this is the guestfs-release-notes man page, living in section 1 of the manual under Virtualization Support. grab a lil snack, we're going through the whole thing 🍓

✨ NAME ✨

guestfs-release-notes — libguestfs Release Notes. yes, that's the whole name section, she's brief and she knows it 💅

🌸 RELEASE NOTES FOR LIBGUESTFS 1.56 🌸

okay so these are the release notes for the libguestfs stable release 1.56, and this page is describing all the major changes since 1.54. Libguestfs 1.56.0 was released on 11th June 2025. mark your calendars, bestie 🎀

🦋 Inspection 🦋

  • added support for Windows 2025 (thanks Ming Xie!) 👑
  • added support for TencentOS (Denise Cheng) ✨
  • inspecting Ubuntu 22+ guests that use a split /usr configuration now actually works properly, no cap (thanks Jaroslav Spanko, Daniel Berrange) 🔥
  • inspecting guests that have duplicated root mountpoints now works too, slay 💅
  • inspection of SUSE Linux guests using btrfs snapshots now ignores snapshots that mirror content in the root filesystem (thanks Ming Xie) 🫶
  • inspection of SUSE Linux >= 15 now returns the correct osinfo short name (eg. "sle15") (thanks Ming Xie) ⭐

💜 API 💜

  • new command_out and sh_out APIs, which let you capture output from guest commands that generate more output than the protocol limit allows. big output energy, we love to see it 😭
  • new btrfs_scrub_full API which runs a full Btrfs scrub, synchronously. it works more like fsck for other filesystems — iconic behaviour fr fr ✨
  • the fstrim API has been modified to work around several issues in upstream and RHEL 9 kernels related to XFS support (Eric Sandeen, Dave Chinner) 🔧
  • the existing e2fsck API has a new FORCENO option enabling use of the command line -n flag. new flag just dropped 💅

🎀 Language bindings 🎀

  • previously -L../lib/.libs got embedded in the distributed OCaml bindings. this has been fixed, we do not stan accidental embedded paths 🙈
  • GObject bindings have been deprecated and will be removed in libguestfs 1.58. giving them a heads up, bestie, this is your official notice 💀
fr fr: if you're building on GObject bindings, start planning the glow-up now — they're gone in 1.58.

🌈 Build changes 🌈

  • json-c is now required. this replaces Jansson, which was previously used for parsing JSON input files 📦
  • OCaml ≥ 4.08 is now required ⭐
  • OCaml oUnit is no longer used ✌️
  • we now assume that __attribute__((cleanup)) always works. this requires gcc or Clang 🛠️
  • fixed compatibility with file(1) ≥ 5.46 🔥
  • fixed compatibility with Fedora ≥ 42 which merges /usr/sbin into /usr/bin 🌀
  • fixed compatibility with latest Rust compiler (Jacob Reger) 🦀
  • lex(1), yacc(1) and libmagic (part of file(1)) have not been required by libguestfs for a long time, but were still checked by the ./configure script. this has been fixed — they are no longer build dependencies (thanks Mohamed Akram) 🎉
  • when using ./configure --disable-daemon we no longer require augeas and hivex (thanks Mohamed Akram) 💖
  • zfs-fuse support has been dropped. the project is unmaintained upstream (thanks Paul Bolle, Gwyn Ciesla, Timothée Ravier) 😭
  • fixed compatibility with GNU gettext 0.25 🌍

🧚 Internals 🧚

  • the tests were modified to use a set of common functions and remove use of the weird $TEST_FUNCTIONS macro, similar to how we do it in nbdkit 🧪
  • fixed dhcpcd failing on systemd-resolved stub (Thomas Wouters) 🩹
  • added support for dhcpcd and sfdisk on Debian (Daniel Gomez) ✨
  • print the kernel utsname in debug output 👀
  • the legacy pvs_full, vgs_full and lvs_full APIs were completely rewritten in OCaml 🔁
  • some deprecated autoconf macros are no longer used 🗑️
  • we no longer emit a false warning about BLKDISCARD when creating a block device 💅
  • some internal OCaml List and String functions that we used have been replaced by ones from the OCaml stdlib, reducing code maintenance 🫶
  • if qemu-img(1) commands fail during snapshot creation, make sure we capture and print stderr from the qemu command (Cole Robinson) 🐛

🔥 Bugs fixed 🔥

okay this section is a whole mood board of fixed bugs, one URL at a time:

👑 SEE ALSO 👑

go touch grass in these other pages, bestie, they all ate:

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

🫶 AUTHORS 🫶

give it up for the whole squad, they carried this release:

Cole Robinson
Daniel Gomez
Denise Cheng
Ettore Atalan
Jacob Reger
Krascovict Petrov
Léane GRASSER
Richard W.M. Jones
Ricky Tigg
Thomas Wouters
Yuri Chornoivan

Copyright (C) 2009-2025 Red Hat Inc. — periodt, that's the copyright line, we're keeping it exactly ✨

🌸 LICENSE 🌸

okay so the legal bit, but make it cute — the meaning is 100% the same, don't skip it:

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 all of these, bestie, don't leave us guessing:

  • 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 🧪
ngl the "complete, unedited output" bit is doing a lot of work — don't trim it, don't vibe-edit it, paste the whole thing fr fr 🙏

that's the whole page, you made it to the end, main character energy 🎀 this was libguestfs version 1.61.3, dated 2026-09-16, and the page itself is guestfs-rel...-notes-1.56(1) — see you in the next release notes, ily, bye 💅🦋

📦 where this page comes from