Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
nbdkit-release-notes-1.44(1)	    NBDKIT	  nbdkit-release-notes-1.44(1)

NAME
       nbdkit-release-notes-1.44 - release notes for nbdkit 1.44

DESCRIPTION
       These are the release notes for nbdkit stable release 1.44.  This
       describes the major changes since 1.42.

       nbdkit 1.44.0 was released on 1 July 2025.

   Security
       Fix off-by-one for maximum block_status length (CVE-2025-47711),	and a
       32-bit overflow in extents handling (CVE-2025-47712) (reported by
       Nikolay Ivanets and Eric	Blake, and fixed by Eric Blake).

       Thread-local storage is now used	when printing certain protocol
       messages	in verbose mode, which avoids possible output corruption.
       Since these messages were generated based on untrusted client input,
       the existing code was examined to see if	this could have	been
       exploitable, but	it is not thought so.  Nevertheless the	fix was
       backported to stable version 1.42.2 and updating	is recommended.

       See nbdkit-security(1) for past security	issues.

   Plugins
       New nbdkit-nfs-plugin(1)	which allows access to disk images stored on
       NFS servers (thanks Ronnie Sahlberg).

       nbdkit-file-plugin(1) is	now much more careful about checking for
       errors from certain Linux system	calls that we previously thought were
       just advisory (thanks Eric Sandeen, Dave	Chinner).

       nbdkit-file-plugin(1) can now trim LVM thin block devices (thanks
       Germano Veit Michel, Eric Blake).

       nbdkit-curl-plugin(1) adds new "proxy-cafile" and "proxy-capath"
       parameters (Adi Aloni).

       nbdkit-vddk-plugin(1) adds a new	"export" parameter which allows	the
       client to choose	which file to serve via	the NBD	protocol export	name.
       This plugin has also been optimized so that querying extent information
       no longer slows down reads.  Debugging information has also be
       improved, and we	can now	track the time taken to	run asynchronous
       commands.

       nbdkit-info-plugin(1) adds a new	"mode=version" method.

       nbdkit-torrent-plugin(1)	now supports prefetching.  This	plugin now
       also generates additional information in	--dump-plugin output.

       nbdkit-data-plugin(1) allows @offset to use scaling suffixes, eg. @4M
       to move the offset to 4194304 (Eric Blake).

   Filters
       New nbdkit-openonce-filter(1) which can be used to open the underlying
       plugin once, sharing the	plugin across connections.

       nbdkit-cacheextents-filter has been deprecated, and is expected to be
       removed in nbdkit 1.46.

       nbdkit-cow-filter(1) now	understands that the NBD protocol export name
       causes multiple disk images to be exported, and correctly creates an
       overlay per export.  (See also "Documentation" below.)

       nbdkit-ext2-filter(1) now permits concurrent client connections (Eric
       Blake).

       nbdkit-fua-filter(1) adds a new "flush-on-close=true" flag which	can be
       used to force a flush to	persistent storage when	the connection closes
       even if the client does not request one.

       nbdkit-blocksize-policy-filter(1) will now round	unaligned extents from
       plugins.	 Also adjust "blocksize-error-policy=error" to allow access to
       the unaligned tail of the disk image, but at the	same time add new
       "blocksize-error-policy=strict-error" mode which	can be used to block
       that.  (Eric Blake).

   Language bindings
       Plugins written in Golang now issue a warning if	fork(2)	is called,
       since that will likely cause the	plugin to break.

       For the Rust plugin and Rust examples, clippy warnings are now only
       enabled if the "./configure --enable-gcc-warnings" build	option is
       used.

   Server
       New --log=/path option allowing error logging to	be sent	to a file.
       Also new	--log=default option which just	directs	logging	to the default
       output (the same	as if --log is not used	at all).

   API
       The filter API (which is	not part of our	API promise) changes the
       ".thread_model" call, allowing the current thread model to be changed
       conditionally based on what the plugin sets it to.

   Documentation
       Filters which are "export-safe"	that is, they correctly	handle the
       case where plugins serve	different content depending on the NBD
       protocol	export name  are now documented	in "EXPORT-SAFE	FILTERS" in
       nbdkit-protocol(1).

       A common	macro is used for all references in the	documentation to magic
       parameters.

   Tests
       The particularly	long-running "test-spinning-mkfs.sh" test has been
       modified	to finish more quickly.

       Previously running the whole test suite would leave many
       /tmp/nbdkitXXXXXX temporary directories behind.	These have been
       reduced although	not quite eliminated.

       New "define" function in	tests/functions.sh which provides a simpler
       way to add inline plugins and scripts to	tests, reducing	concerns
       around quoting.

       Several tests were modified to use the --run method to start the	test
       client.	This improves performance and reduces fragility	of the tests.

       Tests now use "set -u" (error if	an undefined variable is used) to
       reduce a	common cause of	errors.

   Build
       The "./configure" output	has been beautified, which also	helps to
       highlight problems when glancing	at the output.

       Fix build issues	with GCC 15.

       Allow User Statically Defined Tracing (USDT) probes to be added into
       the server.  Few	actual probes are added	so far,	but the	build system
       has been	modified to allow it.

       nbdkit-vddk-plugin(1) drops support for VDDK 6.5, so the	minimum
       required	version	is now VDDK  6.7.  Support for VDDK 9.0.0.0 has	been
       added.

       Builds on clang were complaining	about unused -pthread option.  This
       warning has been	fixed (Eric Blake).

   Internals
       In Python code, remove unnecessary "global" statements (thanks Nir
       Soffer).

       nbdkit-file-plugin(1) now produces more detailed	information in error
       messages, particularly about the	file being accessed and	the offset and
       size of the request that	failed.

       In debug	mode, when the server starts up	it prints a debug message
       summarising the flow of request processing through filters and the
       plugin, making this easier to understand.

SEE ALSO
       nbdkit(1).

AUTHORS
       Authors of nbdkit 1.44:

       Adi Aloni
       Daniel P. Berrang
       Eric Blake
       Richard W.M. Jones

COPYRIGHT
       Copyright Red Hat

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.

nbdkit-1.46.0			  2026-03-04	  nbdkit-release-notes-1.44(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=nbdkit-release-notes-1.44&sektion=1&manpath=FreeBSD+Ports+15.0.quarterly>

home | help