nbdcopy - Man Page

copy to and from an NBD server


 nbdcopy [-p] -|FILE|DEVICE NBD-URI

 nbdcopy [-p] NBD-URI -|FILE|DEVICE

 nbdcopy --help

 nbdcopy --version


 nbdcopy nbd://example.com local.img

 nbdcopy nbd://example.com - | file -

 nbdcopy -p /dev/sdX nbd://example.com

 cat disk1 disk2 | nbdcopy - "nbd+unix:///?socket=/tmp/unixsock"


nbdcopy copies to and from an NBD server.  It can upload a local file to an NBD server, or download the contents of an NBD server to a local file, device or stdin/stdout.

The local file can be a file, a block device (eg. /dev/cdrom), or - which means stream in from stdin or stream out to stdout.  The NBD server is specified using an NBD URI (like nbd://localhost). The NBD server can be local or remote, and encryption can be used if libnbd was built with encryption support.

For more complex copying operations including converting between disk formats use qemu-img convert, see qemu-img(1).



Display brief command line help and exit.


Display a progress bar.


Display the package name and version and exit.

See Also

libnbd(3), nbdfuse(1), nbdinfo(1), nbdsh(1), qemu-img(1).


Richard W.M. Jones


This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA

Referenced By

libnbd(3), libnbd-release-notes-1.4(1), nbdfuse(1), nbdinfo(1), nbdkit-data-plugin(1), nbdkit-memory-plugin(1), nbdkit-release-notes-1.22(1), nbdkit-streaming-plugin(1), nbdsh(1).

2020-10-05 libnbd-1.5.4