diff options
Diffstat (limited to 'man/obsync.8')
-rw-r--r-- | man/obsync.8 | 238 |
1 files changed, 148 insertions, 90 deletions
diff --git a/man/obsync.8 b/man/obsync.8 index 8ede115d9fb..54ef6a58dad 100644 --- a/man/obsync.8 +++ b/man/obsync.8 @@ -1,122 +1,180 @@ -.TH OBSYNC 8 +.TH "OBSYNC" "8" "September 09, 2011" "dev" "Ceph" .SH NAME obsync \- The object synchronizer tool +. +.nr rst2man-indent-level 0 +. +.de1 rstReportMargin +\\$1 \\n[an-margin] +level \\n[rst2man-indent-level] +level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] +- +\\n[rst2man-indent0] +\\n[rst2man-indent1] +\\n[rst2man-indent2] +.. +.de1 INDENT +.\" .rstReportMargin pre: +. RS \\$1 +. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] +. nr rst2man-indent-level +1 +.\" .rstReportMargin post: +.. +.de UNINDENT +. RE +.\" indent \\n[an-margin] +.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] +.nr rst2man-indent-level -1 +.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] +.in \\n[rst2man-indent\\n[rst2man-indent-level]]u +.. +.\" Man page generated from reStructeredText. +. .SH SYNOPSIS -.B obsync [ \fIoptions\fP ] <\fIsource-url\fP> <\fIdestination-url\fP> - +.nf +\fBobsync\fP [ \fIoptions\fP ] \fIsource\-url\fP \fIdestination\-url\fP +.fi +.sp .SH DESCRIPTION -.B obsync -is an object syncrhonizer tool designed to transfer objects between -different object storage systems. Similar to rsync, you specify a source and a -deestination, and it will transfer objects between them until the destination -has all the objects in the source. Obsync will never modify the source-- only the -destination. - -By default, obsync does not delete anything. However, by specifying \fB--delete-after\fP -or \fB--delete-before\fP, you can ask it to delete objects from the destination that are -not in the source. - +.sp +\fBobsync\fP is an object syncrhonizer tool designed to transfer objects +between different object storage systems. Similar to rsync, you +specify a source and a destination, and it will transfer objects +between them until the destination has all the objects in the +source. Obsync will never modify the source \-\- only the destination. +.sp +By default, obsync does not delete anything. However, by specifying +\fB\-\-delete\-after\fP or \fB\-\-delete\-before\fP, you can ask it to delete +objects from the destination that are not in the source. .SH TARGET TYPES -Obsync supports \fIS3\fP via \fIlibboto\fP. -To use the s3 target, your URL should look like this: -s3://\fIhost-name\fP/\fIbucket-name\fP - -Obsync supports storing files locally via the \fIfile://\fP target. -To use the file target, your URL should look like this: -file://\fIdirectory-name\fP - -Alternately, give no prefix, like this: -\fI\./directory-name\fP - -Obsync supports storing files in a \fIRados Gateway\fP backend via the \fIlibrados\fP Python bindings. -To use the rgw target, your URL should look like this: -rgw:\fIceph-configuration-path\fP:\fIrgw-bucket-name\fP - +.sp +Obsync supports S3 via \fBlibboto\fP. To use the s3 target, your URL +should look like this: \fBs3://host\-name/bucket\-name\fP +.sp +Obsync supports storing files locally via the \fBfile://\fP target. To +use the file target, your URL should look like this: +\fBfile://directory\-name\fP +.sp +Alternately, give no prefix, like this: \fB./directory\-name\fP +.sp +Obsync supports storing files in a RADOS Gateway backend via the +\fBlibrados\fP Python bindings. To use the \fBrgw\(ga target, your URL +should look like this: \(ga\(gargw:ceph\-configuration\-path:rgw\-bucket\-name\fP .SH OPTIONS +.INDENT 0.0 .TP -\fB\-h\fP | \fB\-\-help\fP +.B \-h, \-\-help Display a help message - +.UNINDENT +.INDENT 0.0 .TP -\fB\-n\fP | \fB\-\-dry-run\fP +.B \-n, \-\-dry\-run Show what would be done, but do not modify the destination. - +.UNINDENT +.INDENT 0.0 .TP -\fB\-c\fP | \fB\-\-create-dest\fP +.B \-c, \-\-create\-dest Create the destination if it does not exist. - -.TP -\fB\-\-delete-before\fP -Before copying any files, delete objects in the destination that are not in the source. - -.TP -\fB\-L\fP | \fB\-\-follow-symlinks\fP -Follow symlinks when dealing with \fIfile://\fP targets. - -.TP -\fB\-\-no-preserve-acls\fP -Don't preserve ACLs when copying objects. - -.TP -\fB\-v\fP | \fB\-\-verbose\fP +.UNINDENT +.INDENT 0.0 +.TP +.B \-\-delete\-before +Before copying any files, delete objects in the destination that +are not in the source. +.UNINDENT +.INDENT 0.0 +.TP +.B \-L, \-\-follow\-symlinks +Follow symlinks when dealing with \fBfile://\fP targets. +.UNINDENT +.INDENT 0.0 +.TP +.B \-\-no\-preserve\-acls +Don\(aqt preserve ACLs when copying objects. +.UNINDENT +.INDENT 0.0 +.TP +.B \-v, \-\-verbose Be verbose. - +.UNINDENT +.INDENT 0.0 .TP -\fB\-V\fP | \fB\-\-more-verbose\fP +.B \-V, \-\-more\-verbose Be really, really verbose (developer mode) - -.TP -\fB\-x\fP \fBSRC\fP=\fBDST\fP | \fB\-\-xuser\fP \fBSRC\fP=\fBDST\fP -Set up a user translation. You can specify multiple user translations with -multiple \fB--xuser\fP arguments. - -.TP -\fB\-\-force\fP -Overwrite all destination objects, even if they appear to be the same as the -source objects. - +.UNINDENT +.INDENT 0.0 +.TP +.B \-x SRC=DST, \-\-xuser SRC=DST +Set up a user translation. You can specify multiple user +translations with multiple \fB\-\-xuser\fP arguments. +.UNINDENT +.INDENT 0.0 +.TP +.B \-\-force +Overwrite all destination objects, even if they appear to be the +same as the source objects. +.UNINDENT .SH ENVIRONMENT VARIABLES +.INDENT 0.0 .TP -\fBSRC_AKEY\fP +.B SRC_AKEY Access key for the source URL - +.UNINDENT +.INDENT 0.0 .TP -\fBSRC_SKEY\fP +.B SRC_SKEY Secret access key for the source URL - +.UNINDENT +.INDENT 0.0 .TP -\fBDST_AKEY\fP +.B DST_AKEY Access key for the destination URL - +.UNINDENT +.INDENT 0.0 .TP -\fBDST_SKEY\fP +.B DST_SKEY Secret access key for the destination URL - +.UNINDENT +.INDENT 0.0 .TP -\fBAKEY\fP +.B AKEY Access key for both source and dest - +.UNINDENT +.INDENT 0.0 .TP -\fBSKEY\fP +.B SKEY Secret access key for both source and dest - +.UNINDENT +.INDENT 0.0 .TP -\fBDST_CONSISTENCY\fP -Set to 'eventual' if the destination is eventually consistent. -If the destination is eventually consistent, we may have to retry certain operations -multiple times. - +.B DST_CONSISTENCY +Set to \(aqeventual\(aq if the destination is eventually consistent. If the destination +is eventually consistent, we may have to retry certain operations multiple times. +.UNINDENT .SH EXAMPLES -\fIAKEY=... SKEY=... obsync -c -d -v ./backup-directory s3://myhost1/mybucket1\fP - -Copy objects from backup-directory to mybucket1 on myhost1 - -\fISRC_AKEY=... SRC_SKEY=... DST_AKEY=... DST_SKEY=... -obsync -c -d -v s3://myhost1/mybucket1 s3://myhost1/mybucket2\fP - +.sp +.nf +.ft C +AKEY=... SKEY=... obsync \-c \-d \-v ./backup\-directory s3://myhost1/mybucket1 +.ft P +.fi +.sp +Copy objects from backup\-directory to mybucket1 on myhost1: +.sp +.nf +.ft C +SRC_AKEY=... SRC_SKEY=... DST_AKEY=... DST_SKEY=... obsync \-c \-d \-v s3://myhost1/mybucket1 s3://myhost1/mybucket2 +.ft P +.fi +.sp Copy objects from mybucket1 to mybucket2 - .SH AVAILABILITY -.B obsync -is part of the Ceph distributed file system. Please refer to the Ceph wiki at -http://ceph.newdream.net/wiki for more information. +.sp +\fBobsync\fP is part of the Ceph distributed file system. Please refer +to the Ceph wiki at \fI\%http://ceph.newdream.net/wiki\fP for more +information. +.SH COPYRIGHT +2011, New Dream Network +.\" Generated by docutils manpage writer. +.\" +. |