Scroll to navigation

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

 is a disk image filename
    
  port to listen on (default B<1024>)
    
  offset into the image
    
  interface to bind to (default B<0.0.0.0>)
    
  Use a unix socket with path I<path>
    
  export read-only
    
  only expose partition I<num>
    
  use snapshot file
    
  set cache mode to be used with the file.  See the documentation of
  the emulator's C<-drive cache=...> option for allowed values.
    
  choose asynchronous I/O mode between B<threads> (the default)
  and B<native> (Linux only).
    
  toggles whether I<discard> (also known as I<trim> or I<unmap>)
  requests are ignored or passed to the filesystem.  The default is no
  (B<--discard=ignore>).
    
  connect I<filename> to NBD device I<dev>
    
  disconnect the specified device
    
  device can be shared by I<num> clients (default B<1>)
    
  force block driver for format I<fmt> instead of auto-detecting
    
  don't exit on the last connection
    
  display extra debugging information
    
  display this help and exit
    
  output version information and exit
    

SEE ALSO

qemu-img(1)

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.

2022-05-19