diff options
| author |  Joey Hess <joey@kitenet.net> | 2011-04-27 20:06:07 -0400 |
|---|---|---|
| committer | Joey Hess <joey@kitenet.net> | 2011-04-27 20:23:09 -0400 |
| commit | e68f128a9bf46c8f4ebe51fcb3b6f63955cadd2e (patch) | |
| tree | 2102052ed8289efa0e44b4f9269c423753d70983 /doc/special_remotes | |
| parent | 4381ac062fa7cec01476e84a7bd8e154efb8aacd (diff) | |
rsync special remote
Fully tested and working, including resuming and encryption. (Though not
resuming when sending *with* encryption; gpg doesn't produce identical
output each time.)
Uses same layout as the directory special remote and the .git/annex/objects/
directory.
Diffstat (limited to 'doc/special_remotes')
| -rw-r--r-- | doc/special_remotes/directory.mdwn | 2 | ||||
| -rw-r--r-- | doc/special_remotes/rsync.mdwn | 23 |
2 files changed, 24 insertions, 1 deletions
diff --git a/doc/special_remotes/directory.mdwn b/doc/special_remotes/directory.mdwn index 8006c44fc..9e4bfa33b 100644 --- a/doc/special_remotes/directory.mdwn +++ b/doc/special_remotes/directory.mdwn @@ -7,4 +7,4 @@ the drive's mountpoint as a directory remote. Setup example: - # git annex initremote usbdrive directory=/media/usbdrive/ encryption=none + # git annex initremote usbdrive type=directory directory=/media/usbdrive/ encryption=none diff --git a/doc/special_remotes/rsync.mdwn b/doc/special_remotes/rsync.mdwn new file mode 100644 index 000000000..593644291 --- /dev/null +++ b/doc/special_remotes/rsync.mdwn @@ -0,0 +1,23 @@ +This special remote type rsyncs file contents to somewhere else. + +Setup example: + + # git annex initremote myrsync type=rsync rsyncurl=rsync://rsync.example.com/myrsync encryption=joey@kitenet.net + +## configuration + +These parameters can be passed to `git annex initremote` to configure rsync: + +* `encryption` - Required. Either "none" to disable encryption of content + stored in rsync, + or a value that can be looked up (using gpg -k) to find a gpg encryption + key that will be given access to the remote. Note that additional gpg + keys can be given access to a remote by rerunning initremote with + the new key id. See [[encryption]]. + +* `rsyncurl` - Required. This is the url or `hostname:/directory` to + pass to rsync to tell it where to store content. + +The `annex-rsync-options` git configuration setting can be used to pass +parameters to rsync. Note that it is **not safe** to put "--delete" +in `annex-rsync-options` when using rsync special remotes. |