1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
|
NBD is a protocol for accessing Block Devices (hard disks and
disk-like things) over a Network.
'nbdkit' is a toolkit for creating NBD servers.
The key features are:
* Multithreaded NBD server written in C with good performance.
* Well-documented, simple plugin API with a stable ABI guarantee.
Let's you export "unconventional" block devices easily.
* Liberal license (BSD) allows nbdkit to be linked to proprietary
libraries or included in proprietary code.
For documentation, see the docs/ directory.
For plugins and examples, see the plugins/ directory.
License
-------
This software is copyright (C) Red Hat Inc. and licensed under a BSD
license. See LICENSE for details.
Building from source
--------------------
By default nbdkit needs nothing except Linux and reasonably recent gcc.
To build the man pages, you will need to install:
- pod2man (included with perl)
There are some *optional* libraries you may want to install for the
plugins.
For the gzip plugin:
- zlib
For the xz plugin:
- liblzma
For the curl (HTTP/FTP) plugin:
- libcurl
For the libvirt plugin:
- libvirt
For the libguestfs plugin, and to run the test suite:
- libguestfs
- guestfish (from libguestfs)
For the VDDK plugin:
- VDDK (see plugins/vddk/README.VDDK)
For the Perl plugin:
- perl development libraries
- perl module ExtUtils::Embed
For the Python plugin:
- python development libraries
After installing any dependencies:
To build from tarball: To build from git:
---------------------- ------------------
autoreconf -i
./configure ./configure
make make
make check make check
Optionally run this as root to install everything:
make install
Tests
-----
You will need to install libguestfs to run the test suite.
The test suite ('make check') is fairly comprehensive. It runs the
newly built nbdkit + plugin as a captive process, and tests it using
libguestfs.
If there is a failure, look at the corresponding tests/*.log file for
debug information.
Packager information
--------------------
Tarballs are available from:
http://libguestfs.org/download/nbdkit
Developer information
---------------------
For development ideas, see the TODO file.
The upstream git repository is:
https://github.com/libguestfs/nbdkit
Please send patches to the libguestfs mailing list:
https://www.redhat.com/mailman/listinfo/libguestfs
For further information, see:
http://libguestfs.org/
|