qemu-nbd Man page

QEMU-NBD(8) QEMU-NBD(8)

NAME

qemu-nbd – QEMU Disk Network Block Device Server

SYNOPSIS

usage: qemu-nbd [OPTION]… filename

DESCRIPTION

Export QEMU disk image using NBD protocol.

OPTIONS

filename
is a disk image filename

-p, –port=port
port to listen on (default B<10809>)

-o, –offset=offset
offset into the image

-b, –bind=iface
interface to bind to (default B<0.0.0.0>)

-k, –socket=path
Use a unix socket with path I

-f, –format=format
Set image format as I

-r, –read-only
export read-only

-P, –partition=num
only expose partition I

-s, –snapshot
use I as an external snapshot, create a temporary
file with backing_file=I, redirect the write to
the temporary one

-l, –load-snapshot=snapshot_param
load an internal snapshot inside I and export it
as an read-only device, I format is
‘snapshot.id=[ID],snapshot.name=[NAME]’ or ‘[ID_OR_NAME]’

-n, –nocache
–cache=cache
set cache mode to be used with the file. See the documentation of
the emulator’s C<-drive cache=...> option for allowed values.

–aio=aio
choose asynchronous I/O mode between B (the default)
and B (Linux only).

–discard=discard
toggles whether I (also known as I or I)
requests are ignored or passed to the filesystem. The default is no
(B<--discard=ignore>).

-c, –connect=dev
connect I to NBD device I

-d, –disconnect
disconnect the specified device

-e, –shared=num
device can be shared by I clients (default B<1>)

-f, –format=fmt
force block driver for format I instead of auto-detecting

-t, –persistent
don’t exit on the last connection

-v, –verbose
display extra debugging information

-h, –help
display this help and exit

-V, –version
output version information and exit

SEE ALSO

qemu-img

AUTHOR

Copyright (C) 2006 Anthony Liguori . This is
free software; see the source for copying conditions. There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE.

2016-11-08 QEMU-NBD(8)