Usage: /usr/bin/qemu-nbd [OPTIONS] FILE or: /usr/bin/qemu-nbd -L [OPTIONS] QEMU Disk Network Block Device Utility -h, --help display this help and exit -V, --version output version information and exit Connection properties: -p, --port=PORT port to listen on (default `10809') -b, --bind=IFACE interface to bind to (default `0.0.0.0') -k, --socket=PATH path to the unix socket (default '/var/lock/qemu-nbd-DEVICE') -e, --shared=NUM device can be shared by NUM clients (default '1') -t, --persistent don't exit on the last connection -v, --verbose display extra debugging information -x, --export-name=NAME expose export by name (default is empty string) -D, --description=TEXT export a human-readable description --handshake-limit=N limit client's handshake to N seconds (default 10) Exposing part of the image: -o, --offset=OFFSET offset into the image -A, --allocation-depth expose the allocation depth -B, --bitmap=NAME expose a persistent dirty bitmap General purpose options: -L, --list list exports available from another NBD server --object type,id=ID,... define an object such as 'secret' for providing passwords and/or encryption keys --tls-creds=ID use id of an earlier --object to provide TLS --tls-authz=ID use id of an earlier --object to provide authorization --tls-hostname=HOSTNAME override hostname used to check x509 certificate -T, --trace [[enable=]][,events=][,file=] specify tracing options --fork fork off the server process and exit the parent once the server is running --pid-file=PATH store the server's process ID in the given file --selinux-label=LABEL set SELinux process label on listening socket Kernel NBD client support: -c, --connect=DEV connect FILE to the local NBD device DEV -d, --disconnect disconnect the specified device Block device options: -f, --format=FORMAT set image format (raw, qcow2, ...) -r, --read-only export read-only -s, --snapshot use FILE as an external snapshot, create a temporary file with backing_file=FILE, redirect the write to the temporary one -l, --load-snapshot=SNAPSHOT_PARAM load an internal snapshot inside FILE and export it as an read-only device, SNAPSHOT_PARAM format is 'snapshot.id=[ID],snapshot.name=[NAME]', or '[ID_OR_NAME]' -n, --nocache disable host cache --cache=MODE set cache mode used to access the disk image, the valid options are: 'none', 'writeback' (default), 'writethrough', 'directsync' and 'unsafe' --aio=MODE set AIO mode (native, io_uring or threads) --discard=MODE set discard mode (ignore, unmap) --detect-zeroes=MODE set detect-zeroes mode (off, on, unmap) --image-opts treat FILE as a full set of image options See for how to report bugs. More information on the QEMU project at .