docs/tools/qemu-nbd.rst

8 **qemu-nbd** [*OPTION*]... *filename*
10 **qemu-nbd** -L [*OPTION*]...
30 driver options if :option:`--image-opts` is specified.
34 .. option:: --object type,id=ID,...
43 .. option:: -p, --port=PORT
48 .. option:: -o, --offset=OFFSET
52 .. option:: -b, --bind=IFACE
57 .. option:: -k, --socket=PATH
61 .. option:: --image-opts
65   not be used, instead the :option:`format=` option should be set.
67 .. option:: -f, --format=FMT
72 .. option:: -r, --read-only
76 .. option:: -A, --allocation-depth
82 .. option:: -B, --bitmap=NAME
88 .. option:: -s, --snapshot
94 .. option:: -l, --load-snapshot=SNAPSHOT_PARAM
100 .. option:: --cache=CACHE
105   the emulator's ``-drive cache=...`` option for more info.
107 .. option:: -n, --nocache
109   Equivalent to :option:`--cache=none`.
111 .. option:: --aio=AIO
116 .. option:: --discard=DISCARD
123 .. option:: --detect-zeroes=DETECT_ZEROES
131 .. option:: -c, --connect=DEV
135 .. option:: -d, --disconnect
139 .. option:: -e, --shared=NUM
144 .. option:: -t, --persistent
148 .. option:: -x, --export-name=NAME
152 .. option:: -D, --description=DESCRIPTION
157 .. option:: -L, --list
162   :option:`--export-name`, :option:`--offset`, ...).
164 .. option:: --tls-creds=ID
168   :option:`--object` option; or provide the credentials needed for
171 .. option:: --tls-hostname=hostname
178   to connect to the remote server, the :option:`--tls-hostname` option should
182   when acting as a NBD client with the :option:`--list` option.
184 .. option:: --fork
188 .. option:: --pid-file=PATH
192 .. option:: --tls-authz=ID
195   :option:`--object` option. This will be used to authorize connecting users
198 .. option:: -v, --verbose
200   Display extra debugging information. This option also keeps the original
202   other options like :option:`--fork` or :option:`-c`.
204 .. option:: -h, --help
208 .. option:: -V, --version
212 .. option:: -T, --trace [[enable=]PATTERN][,events=FILE][,file=FILE]
214   .. include:: ../qemu-option-trace.rst.inc