nbdkit-release-notes-1.14(1)

NAME
nbdkit-release-notes-1.14 - release notes for nbdkit 1.14

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

nbdkit 1.14.0 was released on 28th August 2019.

  New features
Server performance improvements: Nagle’s algorithm is disabled; instead "MSG_MORE" is used to control when outgoing packets are sent. Ramdisk plugins now support more efficient zeroing. (Eric Blake).

Plugins can now select their thread model at run time. Thread model selection is not finalized until after the config stage (Eric Blake).

The server supports "NBD_CMD_CACHE" for prefetching. Plugins and filters have been updated to implement this where it makes sense (Eric Blake).

Low level pthread lock failures now call abort(3). This should never happen in real situations (Eric Blake).

The server will not advertize multi-conn support if the internal thread model is serialized, avoiding a possible deadlock in some clients (Eric Blake).

New server option --no-sr can be used to disable structured replies (Eric Blake).

The server will now refuse to start if stdin/stdout/stderr are closed, to avoid potential issues with file descriptor handling in plugins (Eric Blake).

$uri can be used to specify an NBD URI in --run parameters (Eric Blake).

New nbdkit-stats-filter(1) displays elapsed statistics about NBD operations, such as the number of bytes read and written.

New nbdkit-nocache-filter(1) which disables cache requests, used to determine how effective they are (Eric Blake).

New nbdkit-noparallel-filter(1) which can be used to override the plugin’s own choice of thread model. Used to determine how the thread model affects performance, or to serialize plugins if required (Eric Blake).

New nbdkit-cacheextents-filter(1) to cache extents requests, especially useful with VDDK which has a slow implementation of extents (Martin Kletzander).

In nbdkit-full-plugin(1), nbdkit-memory-plugin(1), nbdkit-null-plugin(1), nbdkit-pattern-plugin(1) and nbdkit-random-plugin(1), the "size=" prefix can be omitted, ie: "nbdkit memory 1G" (instead of "size=1G").

nbdkit-nbd-plugin(1) has multiple enhancements (all added by Eric Blake):

•   It may be built using libnbd instead of constructing raw NBD packets.

•   "NBD_OPT_GO" is supported.

•   Add structured reads.

•   Implement "NBD_CMD_BLOCK_STATUS".

•   Supports TCP sockets.

•   Forwards "NBD_CMD_CACHE".

•   Retry connections.

•   Shared connections.

•   Magic "uri" parameter.

•   TLS support.

nbdkit-vddk-plugin(1) now reports hole extents correctly when using the "single-link" flag (Martin Kletzander).

nbdkit-cache-filter(1) and nbdkit-cow-filter(1) now avoid copying data through a bounce buffer when it is already sufficiently aligned (Eric Blake).

Filters (such as nbdkit-delay-filter(1) and nbdkit-rate-filter(1)) which sleep no longer cause long delays when the server is shut down (Eric Blake).

Multiple fixes to nbdkit-rust-plugin(1) (Martin Kletzander).

Multiple enhancements and clean ups to the test suite which should make tests better and more reliable.

OCaml plugins can now use "parse_size", "parse_bool", "read_password" calls, and there is also a new example plugin.

On platforms which lack atomic "O_CLOEXEC" support the most serialized thread model is always selected to avoid leaking file descriptors (Eric Blake).

SEE ALSO
nbdkit(1), https://www.redhat.com/archives/libguestfs/2019-August/msg00375.html.

AUTHORS
Eric Blake

Richard W.M. Jones

COPYRIGHT
Copyright (C) 2019 Red Hat Inc.

LICENSE
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

•   Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

•   Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

•   Neither the name of Red Hat nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY RED HAT AND CONTRIBUTORS ''AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL RED HAT OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.