.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Podwrapper::Man 1.20.0 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "libnbd-release-notes-1.10 1"
.TH libnbd-release-notes-1.10 1 2024-05-31 libnbd-1.20.0 LIBNBD
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
libnbd\-release\-notes\-1.10 \- release notes for libnbd 1.10
.SH DESCRIPTION
.IX Header "DESCRIPTION"
These are the release notes for libnbd stable release 1.10.
This describes the major changes since 1.8.
.PP
libnbd 1.10.0 was released on \fB23 September 2021\fR.
.SS Security
.IX Subsection "Security"
There were no security bugs found in libnbd during this release cycle.
.PP
If you find a security issue, please read \fISECURITY\fR in the source
(online here:
https://gitlab.com/nbdkit/libnbd/blob/master/SECURITY).  To
find out about previous security issues in libnbd, see
\&\fBlibnbd\-security\fR\|(3).
.SS "New APIs"
.IX Subsection "New APIs"
No new APIs were added in 1.10.
.SS "Enhancements to existing APIs"
.IX Subsection "Enhancements to existing APIs"
\&\fBnbd_get_uri\fR\|(3) no longer returns service names
(eg. \f(CW"nbd://localhost:nbd"\fR).  Instead it always returns raw port
numbers for portability.
.PP
\&\fBnbd_connect_uri\fR\|(3) now supports \f(CW\*(C`tls\-certificates=\fR\f(CIDIR\fR\f(CW\*(C'\fR query
parameter, making it much easier to connect to servers using TLS with
X.509 certificates.  Also error messages from this API have been
improved in the case of some common URI user errors.
.PP
Python \f(CW\*(C`nbd.aio_connect\*(C'\fR implements support for \f(CW\*(C`AF_UNIX\*(C'\fR sockets.
.PP
Fix invalid use of \f(CW\*(C`unsafe.Pointer\*(C'\fR in Go bindings.
.SS Tools
.IX Subsection "Tools"
\&\fBnbdcopy\fR\|(1) now uses a default request size of 256K (instead of 32M).
This default performs better in most cases.
.PP
\&\fBnbdinfo\fR\|(1) has a new \fI\-\-map \-\-totals\fR mode which displays a
summary of the map.  Also new \fI\-\-can\fR and \fI\-\-is\fR options let you
test export properties (eg. \fI\-\-is read-only\fR).
.PP
\&\fBnbdinfo\fR\|(1) \fI\-\-map\fR option uses "data" instead of "allocated"
because of ambiguity about what "allocated" means (Eric Blake, Nir
Soffer).
.PP
\&\fBnbdinfo\fR\|(1) shows the export size in both bytes and human units
(like \f(CW"1K"\fR).  The machine-parsable JSON output has not changed.
.PP
\&\fBnbdfuse\fR\|(1) now supports efficient zeroing.  Note this requires
Linux kernel ≥ 5.14.
.PP
\&\fBnbdsh\fR\|(1) has new option \fI\-n\fR which avoids creating the implicit
handle \f(CW\*(C`h\*(C'\fR.  Also new option \fI\-v\fR which enables debugging.  Also the
initial help banner is now context sensitive giving more relevant
information depending on how nbdsh was invoked.
.SS Tests
.IX Subsection "Tests"
CI tests were greatly enhanced and many platform-specific fixes were
made.  To view the latest CI tests and results see:
https://gitlab.com/nbdkit/libnbd/\-/pipelines (Martin Kletzander).
.PP
Tests now use the new \f(CW\*(C`GLIBC_TUNABLES\*(C'\fR feature, replacing
\&\f(CW\*(C`MALLOC_CHECK_\*(C'\fR on glibc ≥ 2.34 (thanks Eric Blake,
Siddhesh Poyarekar).
.SS "Other improvements and bug fixes"
.IX Subsection "Other improvements and bug fixes"
The \fBnbdcopy\fR\|(1) progress bar should be displayed more accurately in
multithreaded mode.
.SS Documentation
.IX Subsection "Documentation"
\&\fBnbd_connect\fR\|(3) and \fBnbd_aio_connect\fR\|(3) documentation has been
revised and improved.
.PP
More consistent option styling is used throughout the documentation.
.PP
\&\fIpodwrapper.pl\fR has been unified (almost) with the copy in nbdkit.
.SS Build
.IX Subsection "Build"
\&\fIconfigure.ac\fR now uses spaces consistently, and has been modernized
to support the latest autotools (Eric Blake).
.PP
We now warn about large stack frames, and a few places which used
large stack frames have been fixed.
.PP
Continue fuzzing using AFL++.  Updated the fuzzing documentation.
.PP
Fix building from git with \fI\-\-disable\-ocaml\fR.  As long as only
\&\f(CW\*(C`ocamlc\*(C'\fR is installed, the generator should still be built and run
(Martin Kletzander).
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBlibnbd\fR\|(3).
.SH AUTHORS
.IX Header "AUTHORS"
.IP "Anson Lo" 4
.IX Item "Anson Lo"
.PD 0
.IP "Eric Blake" 4
.IX Item "Eric Blake"
.IP "Martin Kletzander" 4
.IX Item "Martin Kletzander"
.IP "Richard W.M. Jones" 4
.IX Item "Richard W.M. Jones"
.PD
.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright Red Hat
.SH LICENSE
.IX Header "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.
.PP
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.
.PP
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