From: Sage Weil Date: Fri, 29 Mar 2013 04:47:12 +0000 (-0700) Subject: rbd: update man page for import-diff and export-diff X-Git-Tag: v0.62~118^2~20 X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=64a202a7ad3aa2a8c3850838f375645226ed4ca8;p=ceph.git rbd: update man page for import-diff and export-diff Signed-off-by: Sage Weil --- diff --git a/doc/man/8/rbd.rst b/doc/man/8/rbd.rst index b7d48ca60cf2..72b2db6304e4 100644 --- a/doc/man/8/rbd.rst +++ b/doc/man/8/rbd.rst @@ -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.