Manpages

NAME

libnbd-release-notes-1.14 - release notes for libnbd 1.14

DESCRIPTION

These are the release notes for libnbd stable release 1.14. This describes the major changes since 1.12.

libnbd 1.14.0 was released on 1 August 2022.

Security
No security issues were found in this release.

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

New APIs
No new APIs were added in this release.

Enhancements to existing APIs
Optimizations to nbd_pread_structured(3) (Eric Blake).

Many performance enhancements in the Python bindings: "nbd.pread" now avoids an extra memory allocation and copy. Buffers can now be passed to "nbd.Buffer.from_bytearray". New methods "nbd.Buffer.{to,from}_buffer" allow control over copying and sharing "nbd.Buffer". Any buffer-like object can be used in "nbd.aio_{pread,pwrite}". "len(nbd.Buffer(n))" now works. Improve error messages when the wrong types are passed to several APIs. Fix usage of "PyGILState". (Eric Blake)

Golang "AioBuffer" now calls panic on invalid usage (Nir Soffer).

In golang tests, use "GOTRACEBACK=crash" so we get full core dumps on failures.

kTLS should now work (transparently) when available in the kernel and GnuTLS. Use of kTLS will be indicated in debug output. (Daiki Ueno, František Krenželok)

Tools
New nbddump(1) tool which can efficiently hexdump the contents of an NBD server.

nbdcopy(1) now obeys the NBD server minimum/preferred block size when copying, which should make it more efficient and avoids issues with some qemu-nbd configurations where the minimum block size must be obeyed for correct operation.

Tests
New tests for "nbd+vsock://"; URI support.

Other improvements and bug fixes
Fixed rare TLS deadlock when reading from slow servers, and support for clean shutdown when connecting to qemu-nbd over TLS (thanks Michael Ablassmeier).

The library now uses the GnuTLS flag "GNUTLS_NO_SIGNAL" (if available) which ensures that TLS connections should not cause the main program to exit with "SIGPIPE" in certain cases of server failure. (Libnbd has long used "MSG_NOSIGNAL" on non-TLS connections which has a similar effect.)

Various enhancements to fuzzing were made, including support for AFL++ clang-LTO mode, ASAN, allowing seed test cases to be captured, and extended testing of APIs.

Tests were fixed so they should pass on RHEL 7 and FreeBSD.

Documentation
No changes in this release.

Build
"ARRAY_SIZE" macro added to simplify static array sizing (thanks Laszlo Ersek).

Various errors found by Coverity were fixed.

SEE ALSO

libnbd(3).

AUTHORS

Eric Blake
Nir Soffer
Richard W.M. Jones

COPYRIGHT

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