Archipelago » qemu

@example

@c man begin SYNOPSIS

usage: qemu-nbd [OPTION]...  @var{filename}

@c man end

@end example

@c man begin DESCRIPTION

Export QEMU disk image using NBD protocol.

@c man end

@c man begin OPTIONS

@table @option

@item @var{filename}

 is a disk image filename

@item -p, --port=@var{port}

  port to listen on (default @samp{1024})

@item -o, --offset=@var{offset}

  offset into the image

@item -b, --bind=@var{iface}

  interface to bind to (default @samp{0.0.0.0})

@item -k, --socket=@var{path}

  Use a unix socket with path @var{path}

@item -r, --read-only

  export read-only

@item -P, --partition=@var{num}

  only expose partition @var{num}

@item -s, --snapshot

  use @var{filename} as an external snapshot, create a temporary

  file with backing_file=@var{filename}, redirect the write to

  the temporary one

@item -l, --load-snapshot=@var{snapshot_param}

  load an internal snapshot inside @var{filename} and export it

  as an read-only device, @var{snapshot_param} format is

  'snapshot.id=[ID],snapshot.name=[NAME]' or '[ID_OR_NAME]'

@item -n, --nocache

@itemx --cache=@var{cache}

  set cache mode to be used with the file.  See the documentation of

  the emulator's @code{-drive cache=...} option for allowed values.

@item --aio=@var{aio}

  choose asynchronous I/O mode between @samp{threads} (the default)

  and @samp{native} (Linux only).

@item --discard=@var{discard}

  toggles whether @dfn{discard} (also known as @dfn{trim} or @dfn{unmap})

  requests are ignored or passed to the filesystem.  The default is no

  (@samp{--discard=ignore}).

@item -c, --connect=@var{dev}

  connect @var{filename} to NBD device @var{dev}

@item -d, --disconnect

  disconnect the specified device

@item -e, --shared=@var{num}

  device can be shared by @var{num} clients (default @samp{1})

@item -f, --format=@var{fmt}

  force block driver for format @var{fmt} instead of auto-detecting

@item -t, --persistent

  don't exit on the last connection

@item -v, --verbose

  display extra debugging information

@item -h, --help

  display this help and exit

@item -V, --version

  output version information and exit

@end table

@c man end

@ignore

@setfilename qemu-nbd

@settitle QEMU Disk Network Block Device Server

@c man begin AUTHOR

Copyright (C) 2006 Anthony Liguori <anthony@codemonkey.ws>.

This is free software; see the source for copying conditions.  There is NO

warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

@c man end

@c man begin SEEALSO

qemu-img(1)

@c man end

@end ignore