libnbd-release-notes-1.24(1)

πŸ“¦
version 1.24.4 Β· 9 versions
, in arch rolling

πŸ’… libnbd-release-notes-1.24 πŸ’…

okay so bestie, welcome to the LIBNBD release notes for libnbd 1.24 β€” this is the manual page libnbd-release-notes-1.24(1) and it's basically the group chat recap of everything that changed. grab a snack, we're going through it all πŸ“

✨ NAME ✨

libnbd-release-notes-1.24 β€” literally just the release notes for libnbd 1.24, no cap πŸ’–

✨ DESCRIPTION ✨

These are the release notes for libnbd stable release 1.24. This describes the major changes since 1.22.

libnbd 1.24.0 was released on 16 December 2025. πŸŽ€

πŸ”’ Security

Not me starting with the serious one, but we gotta. 😭

In nbd_connect_uri(3), and in several libnbd tools (for example, nbdinfo(1)), when using nbd+ssh:// URIs, the hostname field was not adequately sanitized. A consequence is that an attacker who can control this field in the URI could run commands from libnbd. This issue affected libnbd β‰₯ 1.22. For more information see: https://lists.libguestfs.org/archives/list/guestfs@lists.libguestfs.org/thread/YZMBF3SJRWTRVT5L3KWSNHITFTRMQNTT/

If you find a security issue, please read SECURITY in the source (online here: https://gitlab.com/nbdkit/libnbd/blob/master/SECURITY). To find out about previous security issues in libnbd, see libnbd-security(3).

🫢 fr fr, if you're on 1.22 or later, go read that link. safety is the main character here.

🌈 New APIs

  • New nbd_get_version_extra(3) returns the string passed to ./configure --with-extra="...". This is intended to be used by downstream packagers. (packagers stay winning πŸ‘‘)
  • New nbd_get_handle_size(3) which returns an estimate of the size of the handle in bytes. This is intended for use by garbage collected languages as a hint for when to free the handle. (gc languages, this one's for you 🧚)
  • New nbd_get_tls_priority(3) and nbd_set_tls_priority(3) which allow you to temporarily override the system TLS priority string. ✨
  • New nbd_set_uri_allow_tls_priority(3) API which lets you enable the new ?tls-priority=PRIORITY feature in NBD URIs (this is disabled by default). πŸ’…

🌸 Enhancements to existing APIs

In nbd_connect_uri(3) nbd+ssh:// URIs, extra nbd-port and tls-username query parameters allow you to separately control the NBD TLS and SSH user/port. The new compress=true query parameter lets you enable SSH compression. πŸ”₯

Also in nbd_connect_uri, the new tls-priority=PRIORITY parameter lets you override the TLS priority string (but this is not enabled by default, see previous section). πŸ‘€

πŸ¦‹ Protocol

Post-Quantum Cryptography (PQC) ciphers and certificates for TLS connections are now fully supported. As part of this change multiple client certificates can now be loaded by the library. (Thanks Dan Berrange). πŸ”

πŸ› οΈ Tools

  • New nbddiscard(1) and nbdzero(1) tools which can be used to trim/discard, or zero, part or all of an NBD disk (additional features by Eric Blake). iconic.
  • New nbdcopy(1) --blkhash feature. This can calculate the blkhash (similar to a checksum) of the image as it is being copied (Nir Soffer, Vera Wu). πŸŽ€
  • nbdcopy now obeys --destination-is-zero and --allocated options when running in synchronous mode (Nir Soffer).

πŸ’œ Language bindings

  • OCaml bindings now implement NBD.Buffer.is_zero βœ…
  • OCaml bindings now provide a better estimate of the size of the libnbd handle to the garbage collector, allowing it to β€” at least in theory β€” make better decisions on when to free the handle (thanks Kit-ty-kate). ("at least in theory" lmaooo 😭)
  • Python bindings implement indexing and slicing of nbd.Buffer 🐍
  • Improve the automatic conversion of POD documentation to Rust documentation. Previously garbled mark-up will now be converted properly.

πŸ§ͺ Tests

  • Enhanced tests of the nbdcopy --allocated and --destination-is-zero options.
  • When running libnbd tests on ZFS, several tests would fail. They are now skipped (thanks Arsen ArsenoviΔ‡, Eric Blake). we love a skipped test πŸ’€

πŸ› Other improvements and bug fixes

  • nbdcopy now gives a hard error if the Linux system call sync_file_range(2) fails. This can happen for certain device I/O errors (thanks Eric Sandeen, Dave Chinner).
  • On macOS and Linux, set Unix domain socket buffer sizes for improved performance (Nir Soffer). πŸš€
  • Fix several typos and spelling mistakes in the documentation (Eric Blake). the way typos were just living there... not anymore ✨

πŸ“– Documentation

New libnbd-python(3) page which provides an introduction to the Python API. This information was previously scattered in a few places. so now it's all in one place, we love organization πŸŽ€

πŸ—οΈ Build

  • ./configure --with-extra="..." can be used by downstream packagers to add extra information to the --version output of tools, such as the version of the downstream package.
  • Colourize and improve the ./configure output, if using a terminal. 🌈 (if you're not on a terminal, no colour for you, sorry bestie)

🧚 Internals

  • Copy new vector and string functions from nbdkit, including vector_uniq, vector_append_array, vector_insert_array, vector_remove_range, string_append_format.
  • Fix the memory allocation behaviour of the internal vector library, which should reduce memory usage in some situations (Eric Blake). lowkey a win 🫢

🌟 SEE ALSO 🌟

libnbd(3).

πŸ‘‘ AUTHORS πŸ‘‘

  • Christopher Byrne
  • Eric Blake
  • Nir Soffer
  • Richard W.M. Jones

Copyright Red Hat

πŸ“œ LICENSE πŸ“œ

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This library 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 Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA

okay that's the whole thing, bestie, you're all caught up πŸŽ€βœ¨ this was libnbd-1.24.4, dated 2026-10-13, and it's the libnbd-release-notes-1.24(1) page β€” mwah, go read some other manpages, ily πŸ’…πŸ’–

πŸ“¦ where this page comes from