blob: db242ea2bce8cbedf40ad8e8b557168690b54e6b [file] [log] [blame]
Markus Pargmannef8d9e72015-04-02 10:11:33 +02001Network Block Device (TCP version)
2==================================
Wouter Verhelst5e4b2692013-02-27 17:05:27 -08003
Markus Pargmannef8d9e72015-04-02 10:11:33 +020041) Overview
5-----------
Linus Torvalds1da177e2005-04-16 15:20:36 -07006
Markus Pargmannef8d9e72015-04-02 10:11:33 +02007What is it: With this compiled in the kernel (or as a module), Linux
8can use a remote server as one of its block devices. So every time
9the client computer wants to read, e.g., /dev/nb0, it sends a
10request over TCP to the server, which will reply with the data read.
11This can be used for stations with low disk space (or even diskless)
12to borrow disk space from another computer.
13Unlike NFS, it is possible to put any filesystem on it, etc.
14
15For more information, or to download the nbd-client and nbd-server
16tools, go to http://nbd.sf.net/.
17
18The nbd kernel module need only be installed on the client
19system, as the nbd-server is completely in userspace. In fact,
20the nbd-server has been successfully ported to other operating
21systems, including Windows.
Markus Pargmann4e5b44c2015-04-02 10:11:34 +020022
23A) NBD parameters
24-----------------
25
26max_part
27 Number of partitions per device (default: 0).
28
29nbds_max
30 Number of block devices that should be initialized (default: 16).
31