nbdcopy

Section: LIBNBD (1)
Updated: 2020-09-26
Page Index
 

NAME

nbdcopy - copy to and from an NBD server  

SYNOPSIS

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

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

 nbdcopy --help

 nbdcopy --version

 

EXAMPLES

 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"

 

DESCRIPTION

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).  

OPTIONS

--help
Display brief command line help and exit.
-p
--progress
Display a progress bar.
-V
--version
Display the package name and version and exit.
 

SEE ALSO

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

AUTHORS

Richard W.M. Jones  

COPYRIGHT

Copyright (C) 2020 Red Hat Inc.  

LICENSE

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


 

Index

NAME
SYNOPSIS
EXAMPLES
DESCRIPTION
OPTIONS
SEE ALSO
AUTHORS
COPYRIGHT
LICENSE