1libnbd-release-notes-1.6(1) LIBNBD libnbd-release-notes-1.6(1)
2
3
4
6 libnbd-release-notes-1.6 - release notes for libnbd 1.6
7
9 These are the release notes for libnbd stable release 1.6. This
10 describes the major changes since 1.4.
11
12 libnbd 1.6.0 was released on 7 January 2021.
13
14 Security
15 There were no security issues found in this release.
16
17 If you find a security issue, please read SECURITY in the source
18 (online here: https://gitlab.com/nbdkit/libnbd/blob/master/SECURITY).
19 To find out about previous security issues in libnbd, see
20 libnbd-security(3).
21
22 New APIs
23 nbd_set_strict_mode(3)
24 nbd_get_strict_mode(3)
25 This API allows you to control how libnbd handles requests from the
26 program that it thinks would trigger undefined behaviour in the
27 server (such as sending unknown commands, zero-sized or out-of-
28 bounds requests, etc). Normally libnbd is very strict and will
29 prevent you from sending such requests, but you can use this API to
30 relax these restrictions, leaving it up to the server to handle or
31 reject them. Some servers may crash if you do this.
32
33 nbd_get_nr_meta_contexts(3)
34 nbd_get_meta_context(3)
35 nbd_clear_meta_contexts(3)
36 These APIs allow you to review or clear the requested metadata
37 contexts.
38
39 nbd_opt_list_meta_context(3)
40 nbd_aio_opt_list_meta_context(3)
41 Request that the server lists available metadata contexts. You can
42 only use this in opt mode.
43
44 Thanks: Eric Blake for all of the new APIs.
45
46 Enhancements to existing APIs
47 nbd_shutdown(3) new flag "LIBNBD_SHUTDOWN_ABANDON_PENDING" drops any
48 commands in flight which have not been sent to the server yet (Eric
49 Blake).
50
51 All APIs which have flag (bitmask) parameters now define a
52 "LIBNBD_*_MASK" constant allowing you to tell which bits represent
53 valid flags at compilation time (Eric Blake).
54
55 New features
56 The performance of the nbdcopy(1) tool has been greatly improved. Also
57 it supports numerous new features.
58
59 New nbdinfo(1) --map option showing the allocated and sparse extents of
60 an NBD server. This can also show other information such as dirty
61 bitmaps.
62
63 Tools
64 nbdfuse(1) can now mount the NBD export on top of any regular file, it
65 does not have to mount over a directory.
66
67 nbdsh(1) now produces a nice error message if the URI in the -u option
68 or the command in the -c option is wrong (Eric Blake).
69
70 New nbdsh(1) --opt-mode option which requests opt mode on the handle
71 before connecting.
72
73 nbdinfo(1) --list option now shows the supported metadata contexts of
74 the server (Eric Blake).
75
76 The output of nbdinfo(1) is now usually printed atomically, ie. it will
77 either print the complete output or an error message, but not partial
78 output followed by an error.
79
80 nbdinfo(1) can now decode "qemu:allocation-depth" metacontext (Eric
81 Blake).
82
83 Other improvements and bug fixes
84 Multiple improvements to handling of NBD protocol (Eric Blake).
85
86 Fix handling of booleans in Python bindings (Eric Blake).
87
88 Fix handling of flags parameters in OCaml bindings (Eric Blake).
89
90 Python style fixes (Eric Blake).
91
92 Fix multiple memory leaks (Eric Blake).
93
94 OCaml bindings now include ocamldoc-generated documentation, if
95 ocamldoc is installed at build time.
96
97 The "vector" library from nbdkit is now used by libnbd, simplifying
98 places where we used to use realloc(3).
99
101 libnbd(3).
102
104 Eric Blake
105
106 Richard W.M. Jones
107
109 Copyright (C) 2020-2021 Red Hat Inc.
110
112 This library is free software; you can redistribute it and/or modify it
113 under the terms of the GNU Lesser General Public License as published
114 by the Free Software Foundation; either version 2 of the License, or
115 (at your option) any later version.
116
117 This library is distributed in the hope that it will be useful, but
118 WITHOUT ANY WARRANTY; without even the implied warranty of
119 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
120 Lesser General Public License for more details.
121
122 You should have received a copy of the GNU Lesser General Public
123 License along with this library; if not, write to the Free Software
124 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
125 02110-1301 USA
126
127
128
129libnbd-1.14.2 2023-01-03 libnbd-release-notes-1.6(1)