mirrors/git-annex
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages 1 Wiki Activity Actions

response; update man page

Browse source
This commit is contained in:
Joey Hess 2017-05-09 14:02:48 -04:00
parent 05b1dee353
commit dccd7ba6d4
No known key found for this signature in database
GPG key ID: DB12DB0FF05F8F38
2 changed files with 28 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
doc/git-annex.mdwn
View file

@ -1217,6 +1217,10 @@ Here are all the supported configuration settings.
to or from this remote. For example, to force IPv6, and limit to or from this remote. For example, to force IPv6, and limit
the bandwidth to 100Kbyte/s, set it to `-6 --bwlimit 100` the bandwidth to 100Kbyte/s, set it to `-6 --bwlimit 100`
Note that git-annex-shell has a whitelist of allowed rsync options,
and others will not be be passed to the remote rsync. So using some
options may break the communication between the local and remote rsyncs.
* `remote.<name>.annex-rsync-upload-options` * `remote.<name>.annex-rsync-upload-options`
Options to use when using rsync to upload a file to a remote. Options to use when using rsync to upload a file to a remote.

24
doc/sync/comment_23_e5e7ec9fbafe5e0429161b977e483752._comment Normal file
View file

@ -0,0 +1,24 @@
[[!comment format=mdwn
username="joey"
subject="""comment 23"""
date="2017-05-09T17:52:11Z"
content="""
@mario, great question! (Not the best place for such a question, start a
thread on the forum next time..)
git-annex does use rsync when transferring files between ssh remotes.
Rsync normally goes over ssh, and it might be better to enable compression
at the ssh level. For example, I have "Compression yes" in `~/.ssh/config`
I think that the reason your annex-rsync-upload-options setting broke
it is that rsync needs --compress to be passed on to the other
rsync process (in the remote repository), and that is run via
git-annex-shell, which has a whitelist of options it will pass to rsync.
Passing arbitrary options to rsync could allow unwanted behavior
when git-annex-shell is being used as a security barrier. And --compress is
one of the options that both the rsync sender and receiver have to agree
on for the rsync protocol to work.
I have added a note to the man page about this limitation of what
the rsync-options settings can be used to do.
"""]]