description | The Network Block Device is a Linux-originated lightweight block access protocol that allows one to export a block device to a client. |
homepage URL | https://nbd.sourceforge.io/ |
repository URL | https://github.com/NetworkBlockDevice/nbd.git |
owner | eblake@redhat.com |
last change | Sun, 18 Aug 2024 17:10:12 +0000 (18 19:10 +0200) |
last refresh | Sat, 7 Sep 2024 23:39:18 +0000 (8 01:39 +0200) |
mirror URL | git://repo.or.cz/nbd.git |
https://repo.or.cz/nbd.git | |
ssh://git@repo.or.cz/nbd.git | |
bundle info | nbd.git downloadable bundles |
content tags |
Welcome to the NBD userland support files!
This package contains nbd-server and nbd-client.
To install the package, download the source and do the normal
configure
/make
/make install
dance. You'll need to install it on both the
client and the server.
For compiling from git, do a checkout, install the SGML tools (docbook2man), and then run './autogen.sh' while inside your checkout. Then, see above.
If you want to send a patch, please do not open a pull request; instead, send it to the mailinglist
If you think you found a security problem in NBD, please contact the mailinglist. Do not just file an issue for this (although you may do so too if you prefer).
For embargoed issues, please contact Wouter Verhelst <wouter@debian.org>
NBD is quite easy to use. First, on the client, you need to load the module and, if you're not using udev, to create the device nodes:
# modprobe nbd
# cd /dev
# ./MAKEDEV nbd0
(if you need more than one NBD device, repeat the above command for nbd1, nbd2, ...)
Next, write a configuration file for the server. An example looks like this:
# This is a comment
[generic]
# The [generic] section is required, even if nothing is specified
# there.
# When either of these options are specified, nbd-server drops
# privileges to the given user and group after opening ports, but
# _before_ opening files.
user = nbd
group = nbd
[export1]
exportname = /export/nbd/export1-file
authfile = /export/nbd/export1-authfile
timeout = 30
filesize = 10000000
readonly = false
multifile = false
copyonwrite = false
prerun = dd if=/dev/zero of=%s bs=1k count=500
postrun = rm -f %s
[otherexport]
exportname = /export/nbd/experiment
# The other options are all optional
The configuration file is parsed with GLib's GKeyFile, which parses key files as they are specified in the Freedesktop.org Desktop Entry Specification, as can be found at <http://freedesktop.org/Standards/desktop-entry-spec>. While this format was not intended to be used for configuration files, the glib API is flexible enough for it to be used as such.
Now start the server:
nbd-server -C /path/to/configfile
Note that the filename must be an absolute path; i.e., something like
/path/to/file
, not ../file
. See the nbd-server manpage for details
on any available options.
Finally, you'll be able to start the client:
nbd-client <hostname> -N <export name> <nbd device>
e.g.,
nbd-client 10.0.0.1 -N otherexport /dev/nbd0
will use the second export in the above example (the one that exports
/export/nbd/experiment
)
nbd-client
must be ran as root; the same is not true for nbd-server
(but do make sure that /var/run is writeable by the server that
nbd-server
runs as; otherwise, you won't get a PID file, though the
server will keep running).
There are packages (or similar) available for most current operating systems; see the "Packaging status" badge below for details.
For questions, please use the nbd@other.debian.org mailinglist.
Besides this project, the NBD protocol has been implemented by various other people. A (probably incomplete) list follows:
qemu-nbd
). They
maintain a status
document
of their NBD implementation.Additionally, these implementations once existed but are now no longer maintained:
6 months ago | nbd-3.26.1 | Tagging NBD 3.26.1 | tag | commitlog |
6 months ago | nbd-3.26 | Tagging NBD 3.26 | tag | commitlog |
16 months ago | nbd-3.25 | Tagging NBD 3.25 | tag | commitlog |
16 months ago | exthdr-v3 | commitlog | ||
2 years ago | nbd-debian-3.19-3 | Tagging NBD for Debian 1:3.19-3 | tag | commitlog |
2 years ago | nbd-debian-3.21-1 | Tagging NBD 1:3.21-1 for Debian | tag | commitlog |
2 years ago | nbd-debian-3.24-1 | Tagging NBD Debian 1:3.24-1 | tag | commitlog |
2 years ago | nbd-3.24 | Tagging NBD 3.24 | tag | commitlog |
2 years ago | exthdr-v1 | commitlog | ||
2 years ago | nbd-3.23 | Tagging NBD 3.23 | tag | commitlog |
2 years ago | nbd-debian-3.22-1 | NBD for Debian 3.22-1 | tag | commitlog |
2 years ago | nbd-3.22 | Tagging NBD 3.22 | tag | commitlog |
3 years ago | nbd-3.21 | Tagging NBD 3.21 | tag | commitlog |
4 years ago | nbd-debian-3.20-1 | Tagging NBD for Debian 1:3.20-1 | tag | commitlog |
4 years ago | nbd-3.20 | Tagging NBD 3.20 | tag | commitlog |
5 years ago | nbd-debian-3.19-2 | Tagging NBD 1:3.19-2 | tag | commitlog |
... |
12 days ago | debian | logtree |
2 weeks ago | master | logtree |
16 months ago | extension-ext-header | logtree |
17 months ago | structured | logtree |
5 years ago | extension-structured-request | logtree |
6 years ago | extension-blockstatus | logtree |
6 years ago | extension-structured-reply | logtree |
6 years ago | extension-resize | logtree |
7 years ago | 3.15 | logtree |
7 years ago | 3.7-fix-flags | logtree |
7 years ago | extension-write-zeroes | logtree |
8 years ago | debian-jessie | logtree |
9 years ago | debian-wheezy | logtree |
13 years ago | plugin | logtree |
nbd/ericb.git | Eric Blake's pending patches for NBD | eblake@redhat.com | 16 months ago | summarylogtree |