1QEMU-NBD(8)                                                        QEMU-NBD(8)
2
3
4

NAME

6       qemu-nbd - QEMU Disk Network Block Device Server
7

SYNOPSIS

9       usage: qemu-nbd [OPTION]...  filename
10

DESCRIPTION

12       Export QEMU disk image using NBD protocol.
13

OPTIONS

15       filename
16            is a disk image filename
17
18       -p, --port=port
19             port to listen on (default B<1024>)
20
21       -o, --offset=offset
22             offset into the image
23
24       -b, --bind=iface
25             interface to bind to (default B<0.0.0.0>)
26
27       -k, --socket=path
28             Use a unix socket with path I<path>
29
30       -r, --read-only
31             export read-only
32
33       -P, --partition=num
34             only expose partition I<num>
35
36       -s, --snapshot
37             use snapshot file
38
39       -n, --nocache
40       --cache=cache
41             set cache mode to be used with the file.  See the documentation of
42             the emulator's C<-drive cache=...> option for allowed values.
43
44       --aio=aio
45             choose asynchronous I/O mode between B<threads> (the default)
46             and B<native> (Linux only).
47
48       --discard=discard
49             toggles whether I<discard> (also known as I<trim> or I<unmap>)
50             requests are ignored or passed to the filesystem.  The default is no
51             (B<--discard=ignore>).
52
53       -c, --connect=dev
54             connect I<filename> to NBD device I<dev>
55
56       -d, --disconnect
57             disconnect the specified device
58
59       -e, --shared=num
60             device can be shared by I<num> clients (default B<1>)
61
62       -f, --format=fmt
63             force block driver for format I<fmt> instead of auto-detecting
64
65       -t, --persistent
66             don't exit on the last connection
67
68       -v, --verbose
69             display extra debugging information
70
71       -h, --help
72             display this help and exit
73
74       -V, --version
75             output version information and exit
76

SEE ALSO

78       qemu-img(1)
79

AUTHOR

81       Copyright (C) 2006 Anthony Liguori <anthony@codemonkey.ws>.  This is
82       free software; see the source for copying conditions.  There is NO
83       warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
84       PURPOSE.
85
86
87
88                                  2019-05-14                       QEMU-NBD(8)