]> git-server-git.apps.pok.os.sepia.ceph.com Git - ceph.git/commitdiff
rbd: update man page for import-diff and export-diff
authorSage Weil <sage@inktank.com>
Fri, 29 Mar 2013 04:47:12 +0000 (21:47 -0700)
committerJosh Durgin <josh.durgin@inktank.com>
Mon, 1 Apr 2013 06:32:41 +0000 (23:32 -0700)
Signed-off-by: Sage Weil <sage@inktank.com>
doc/man/8/rbd.rst

index b7d48ca60cf2f41f201caa2b21cc173a8ef496c2..72b2db6304e4a58fef25e257852235ff158fe5ae 100644 (file)
@@ -166,6 +166,20 @@ Commands
   if possible.  For import from stdin, the sparsification unit is
   the data block size of the destination image (1 << order).
 
+:command:`export-diff` [*image-name*] [*dest-path*] [--from-snap *snapname*]
+  Exports an incremental diff for an image to dest path (use - for stdout).  If
+  an initial snapshot is specified, only changes since that snapshot are included; otherwise,
+  any regions of the image that contain data are included.  The end snapshot is specified
+  using the standard --snap option or @snap syntax (see below).  The image diff format includes
+  metadata about image size changes, and the start and end snapshots.  It efficiently represents
+  discarded or 'zero' regions of the image.
+
+:command:`import-diff` [*src-path*] [*image-name*]
+  Imports an incremental diff of an image and applies it to the current image.  If the diff
+  was generated relative to a start snapshot, we verify that snapshot already exists before
+  continuing.  If there was an end snapshot we verify it does not already exist before
+  applying the changes, and create the snapshot when we are done.
+
 :command:`cp` [*src-image*] [*dest-image*]
   Copies the content of a src-image into the newly created dest-image.
   dest-image will have the same size, order, and format as src-image.