]>
Commit | Line | Data |
---|---|---|
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 -f, --format=@var{fmt} | |
49 | force block driver for format @var{fmt} instead of auto-detecting | |
50 | @item -t, --persistent | |
51 | don't exit on the last connection | |
52 | @item -v, --verbose | |
53 | display extra debugging information | |
54 | @item -h, --help | |
55 | display this help and exit | |
56 | @item -V, --version | |
57 | output version information and exit | |
58 | @end table | |
59 | ||
60 | @c man end | |
61 | ||
62 | @ignore | |
63 | ||
64 | @setfilename qemu-nbd | |
65 | @settitle QEMU Disk Network Block Device Server | |
66 | ||
67 | @c man begin AUTHOR | |
68 | Copyright (C) 2006 Anthony Liguori <[email protected]>. | |
69 | This is free software; see the source for copying conditions. There is NO | |
70 | warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. | |
71 | @c man end | |
72 | ||
73 | @c man begin SEEALSO | |
74 | qemu-img(1) | |
75 | @c man end | |
76 | ||
77 | @end ignore |