root / qemu-nbd.texi @ ded9d2d5
History | View | Annotate | Download (2 kB)
1 |
@example |
---|---|
2 |
@c man begin SYNOPSIS |
3 |
usage: qemu-nbd [OPTION]... @var{filename} |
4 |
@c man end |
5 |
@end example |
6 |
|
7 |
@c man begin DESCRIPTION |
8 |
|
9 |
Export QEMU disk image using NBD protocol. |
10 |
|
11 |
@c man end |
12 |
|
13 |
@c man begin OPTIONS |
14 |
@table @option |
15 |
@item @var{filename} |
16 |
is a disk image filename |
17 |
@item -p, --port=@var{port} |
18 |
port to listen on (default @samp{1024}) |
19 |
@item -o, --offset=@var{offset} |
20 |
offset into the image |
21 |
@item -b, --bind=@var{iface} |
22 |
interface to bind to (default @samp{0.0.0.0}) |
23 |
@item -k, --socket=@var{path} |
24 |
Use a unix socket with path @var{path} |
25 |
@item -r, --read-only |
26 |
export read-only |
27 |
@item -P, --partition=@var{num} |
28 |
only expose partition @var{num} |
29 |
@item -s, --snapshot |
30 |
use snapshot file |
31 |
@item -n, --nocache |
32 |
@itemx --cache=@var{cache} |
33 |
set cache mode to be used with the file. See the documentation of |
34 |
the emulator's @code{-drive cache=...} option for allowed values. |
35 |
@item --aio=@var{aio} |
36 |
choose asynchronous I/O mode between @samp{threads} (the default) |
37 |
and @samp{native} (Linux only). |
38 |
@item --discard=@var{discard} |
39 |
toggles whether @dfn{discard} (also known as @dfn{trim} or @dfn{unmap}) |
40 |
requests are ignored or passed to the filesystem. The default is no |
41 |
(@samp{--discard=ignore}). |
42 |
@item -c, --connect=@var{dev} |
43 |
connect @var{filename} to NBD device @var{dev} |
44 |
@item -d, --disconnect |
45 |
disconnect the specified device |
46 |
@item -e, --shared=@var{num} |
47 |
device can be shared by @var{num} clients (default @samp{1}) |
48 |
@item -t, --persistent |
49 |
don't exit on the last connection |
50 |
@item -v, --verbose |
51 |
display extra debugging information |
52 |
@item -h, --help |
53 |
display this help and exit |
54 |
@item -V, --version |
55 |
output version information and exit |
56 |
@end table |
57 |
|
58 |
@c man end |
59 |
|
60 |
@ignore |
61 |
|
62 |
@setfilename qemu-nbd |
63 |
@settitle QEMU Disk Network Block Device Server |
64 |
|
65 |
@c man begin AUTHOR |
66 |
Copyright (C) 2006 Anthony Liguori <anthony@codemonkey.ws>. |
67 |
This is free software; see the source for copying conditions. There is NO |
68 |
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. |
69 |
@c man end |
70 |
|
71 |
@c man begin SEEALSO |
72 |
qemu-img(1) |
73 |
@c man end |
74 |
|
75 |
@end ignore |