rbd: update manpage for import/export

Signed-off-by: Dan Mick <dan.mick@inktank.com>

diff --git a/doc/man/8/rbd.rst b/doc/man/8/rbd.rst
index b11613ad74b8db8f8955d7ff062e813735f2c200..e6a02b0588f75b896e87045c5b8988aa58f7c63f 100644 (file)
--- a/doc/man/8/rbd.rst
+++ b/doc/man/8/rbd.rst
@@ -150,10 +150,13 @@ Commands
   snapshots, this fails and nothing is deleted.
 
 :command:`export` [*image-name*] [*dest-path*]
-  Exports image to dest path.
+  Exports image to dest path (use - for stdout).
 
 :command:`import` [*path*] [*dest-image*]
-  Creates a new image and imports its data from path.
+  Creates a new image and imports its data from path (use - for
+  stdin).  The import operation will try to create sparse rbd images 
+  if possible.  For import from stdin, the sparsification unit is
+  the data block size of the destination image (1 << order).
 
 :command:`cp` [*src-image*] [*dest-image*]
   Copies the content of a src-image into the newly created dest-image.

diff --git a/man/rbd.8 b/man/rbd.8
index 446db793e7c4e9c7cc6edd655c3ad5c081d651ab..6004244e0ba4c80f1d94412ecd1a94a07885c59e 100644 (file)
--- a/man/rbd.8
+++ b/man/rbd.8
@@ -1,4 +1,4 @@
-.TH "RBD" "8" "October 22, 2012" "dev" "Ceph"
+.TH "RBD" "8" "December 05, 2012" "dev" "Ceph"
 .SH NAME
 rbd \- manage rados block device (RBD) images
 .
@@ -179,10 +179,13 @@ Deletes an rbd image (including all data blocks). If the image has
 snapshots, this fails and nothing is deleted.
 .TP
 .B \fBexport\fP [\fIimage\-name\fP] [\fIdest\-path\fP]
-Exports image to dest path.
+Exports image to dest path (use \- for stdout).
 .TP
 .B \fBimport\fP [\fIpath\fP] [\fIdest\-image\fP]
-Creates a new image and imports its data from path.
+Creates a new image and imports its data from path (use \- for
+stdin).  The import operation will try to create sparse rbd images
+if possible.  For import from stdin, the sparsification unit is
+the data block size of the destination image (1 << order).
 .TP
 .B \fBcp\fP [\fIsrc\-image\fP] [\fIdest\-image\fP]
 Copies the content of a src\-image into the newly created dest\-image.
@@ -440,6 +443,6 @@ the Ceph documentation at \fI\%http://ceph.com/docs\fP for more information.
 \fBceph\fP(8),
 \fBrados\fP(8)
 .SH COPYRIGHT
-2012, Inktank Storage, Inc.
+2010-2012, Inktank Storage, Inc. and contributors. Licensed under Creative Commons BY-SA
 .\" Generated by docutils manpage writer.
 .