git-annex/doc
Joey Hess 08814327ff
use P2P protocol for checkpresent, retrieve, and store
Note that, due to not using rsync to transfer files to ssh remotes
any longer, permissions and other file metadata of annexed files
will no longer be preserved when copying them to ssh remotes.
Other remotes never supported preserving that information, so
this is not considered a regression. Added NEWS item about this.

Another significant side effect of this is that, even when rsync is run to
retrieve a file, its progress display will no longer be shown, and
instead the native git-annex progress display will appear. It would be
possible to use the rsync process display when rsync is used (old
git-annex-shell and also retrieval from a local repository), but it
would have complicated the code unncessarily, and been inconsistent
behavior.

(I'd been thinking for a while about eliminating the rsync progress
display, since it's got some annoying verbosities, including display of
the key and the "(xfr#1, to-chk=0/1)" bit and was already somewhat
inconsistent.)

retrieveKeyFileCheap still uses rsync, since that ensures that it gets
the actual file content from the remote. Using the P2P protocol would
use the local content, as long as the local and remote size are the
same.

This commit was sponsored by John Pellman on Patreon.
2018-03-09 13:25:16 -04:00
..
Android
android
assistant
automatic_conflict_resolution
backends
bare_repositories
benchmarking close bug; copy benchmarking info to new page 2017-10-31 13:13:40 -04:00
bugs Better ssh connection warmup when using -J for concurrency. 2018-03-07 17:30:14 -04:00
coding_style
contribute
copies
design wording 2018-03-07 16:22:39 -04:00
devblog devblog 2018-03-08 17:04:52 -04:00
direct_mode
download
ekg
encryption initremote, enableremote: Support gpg subkeys suffixed with an exclamation mark, which forces gpg to use a specific subkey. 2017-05-24 14:08:02 -04:00
footer
forum 2018-03-07 23:34:12 +00:00
future_proofing
git-annex-adjust answer 2017-11-07 16:22:25 -04:00
git-annex-config response 2018-03-06 13:40:00 -04:00
git-annex-copy
git-annex-direct
git-annex-drop
git-annex-enableremote
git-annex-importfeed
git-annex-move Added a comment: Move from A to B 2017-07-26 19:08:07 +00:00
git-annex-preferred-content
git-annex-reinject
git-annex-unannex
git-annex-undo
git-annex-unused
how_it_works
install Added a comment: It is better to provide osx dmgs 2018-03-05 11:48:12 +00:00
internals response 2018-02-22 12:59:44 -04:00
license
links
metadata
news add news item for git-annex 6.20180227 2018-02-27 12:05:54 -04:00
not
polls
preferred_content
required_content
scalability
special_remotes Support exporttree=yes for rsync special remotes. 2018-02-28 13:36:20 -04:00
stickers
sync
templates
testimonials
thanks update 2018-03-06 17:33:11 -04:00
tips Added a comment: Youtube-dl options per file? 2018-03-08 18:47:57 +00:00
todo use P2P protocol for checkpresent, retrieve, and store 2018-03-09 13:25:16 -04:00
trust
tuning response 2017-08-28 13:41:19 -04:00
upgrades
use_case
users
videos
walkthrough response 2018-03-02 15:10:51 -04:00
Android.mdwn
assistant.mdwn
automatic_conflict_resolution.mdwn expand docs 2017-06-01 11:56:56 -04:00
backends.mdwn
bare_repositories.mdwn
benchmarking.mdwn close bug; copy benchmarking info to new page 2017-10-31 13:13:40 -04:00
bugs.mdwn limit rss/atom feeds to 10 pages to avoid enormous files 2017-09-29 12:42:09 -04:00
builds.mdwn windows autobuilder no longer firewalled 2017-10-16 15:07:51 -04:00
chunking.mdwn
coding_style.mdwn
comments.mdwn
contact.mdwn
contribute.mdwn
copies.mdwn
design.mdwn
devblog.mdwn
direct_mode.mdwn
distributed_version_control.mdwn
download.mdwn
ekg.mdwn
encryption.mdwn
favicon.ico
forum.mdwn limit rss/atom feeds to 10 pages to avoid enormous files 2017-09-29 12:42:09 -04:00
future_proofing.mdwn Fixed typo: "repisitory" 2017-11-02 20:39:05 +00:00
git-annex-add.mdwn better doc for --json-error-messages 2018-02-19 15:33:59 -04:00
git-annex-addunused.mdwn
git-annex-addurl.mdwn better doc for --json-error-messages 2018-02-19 15:33:59 -04:00
git-annex-adjust.mdwn more consistent backticks with other man pages 2017-05-24 14:09:14 -04:00
git-annex-assistant.mdwn
git-annex-calckey.mdwn
git-annex-checkpresentkey.mdwn
git-annex-config.mdwn annex.merge-annex-branches 2018-02-22 14:25:32 -04:00
git-annex-contentlocation.mdwn
git-annex-copy.mdwn better doc for --json-error-messages 2018-02-19 15:33:59 -04:00
git-annex-dead.mdwn
git-annex-describe.mdwn
git-annex-diffdriver.mdwn improve 2018-02-06 13:45:14 -04:00
git-annex-direct.mdwn
git-annex-drop.mdwn better doc for --json-error-messages 2018-02-19 15:33:59 -04:00
git-annex-dropkey.mdwn better doc for --json-error-messages 2018-02-19 15:33:59 -04:00
git-annex-dropunused.mdwn
git-annex-edit.mdwn
git-annex-enable-tor.mdwn
git-annex-enableremote.mdwn
git-annex-examinekey.mdwn better doc for --json-error-messages 2018-02-19 15:33:59 -04:00
git-annex-expire.mdwn
git-annex-export.mdwn Support exporttree=yes for rsync special remotes. 2018-02-28 13:36:20 -04:00
git-annex-find.mdwn better doc for --json-error-messages 2018-02-19 15:33:59 -04:00
git-annex-findref.mdwn
git-annex-fix.mdwn
git-annex-forget.mdwn
git-annex-fromkey.mdwn
git-annex-fsck.mdwn better doc for --json-error-messages 2018-02-19 15:33:59 -04:00
git-annex-fuzztest.mdwn
git-annex-get.mdwn better doc for --json-error-messages 2018-02-19 15:33:59 -04:00
git-annex-group.mdwn The second argument of "git annex group" is optional, fix the man page 2017-05-31 12:09:15 +02:00
git-annex-groupwanted.mdwn
git-annex-import.mdwn better doc for --json-error-messages 2018-02-19 15:33:59 -04:00
git-annex-importfeed.mdwn convert importfeed to youtube-dl 2017-11-29 17:30:02 -04:00
git-annex-indirect.mdwn
git-annex-info.mdwn better doc for --json-error-messages 2018-02-19 15:33:59 -04:00
git-annex-init.mdwn .noannex file 2017-12-13 14:34:32 -04:00
git-annex-initremote.mdwn
git-annex-inprogress.mdwn Added inprogress command for accessing files as they are being downloaded. 2017-12-28 11:46:39 -04:00
git-annex-list.mdwn
git-annex-lock.mdwn better doc for --json-error-messages 2018-02-19 15:33:59 -04:00
git-annex-log.mdwn
git-annex-lookupkey.mdwn
git-annex-map.mdwn
git-annex-matchexpression.mdwn
git-annex-matching-options.mdwn
git-annex-merge.mdwn configuration to disable automatic merge conflict resolution 2017-06-01 12:51:01 -04:00
git-annex-metadata.mdwn better doc for --json-error-messages 2018-02-19 15:33:59 -04:00
git-annex-migrate.mdwn
git-annex-mirror.mdwn better doc for --json-error-messages 2018-02-19 15:33:59 -04:00
git-annex-move.mdwn better doc for --json-error-messages 2018-02-19 15:33:59 -04:00
git-annex-multicast.mdwn
git-annex-numcopies.mdwn
git-annex-p2p.mdwn
git-annex-post-receive.mdwn
git-annex-pre-commit.mdwn
git-annex-preferred-content.mdwn fix outdated docs 2018-01-15 14:25:35 -04:00
git-annex-proxy.mdwn
git-annex-readpresentkey.mdwn
git-annex-registerurl.mdwn
git-annex-reinit.mdwn
git-annex-reinject.mdwn
git-annex-rekey.mdwn
git-annex-remotedaemon.mdwn
git-annex-repair.mdwn
git-annex-required.mdwn fsck: Warn when required content is not present in the repository that requires it. 2018-02-08 14:08:41 -04:00
git-annex-resolvemerge.mdwn expand docs 2017-06-01 11:56:56 -04:00
git-annex-rmurl.mdwn
git-annex-schedule.mdwn
git-annex-semitrust.mdwn
git-annex-setkey.mdwn
git-annex-setpresentkey.mdwn
git-annex-shell.mdwn use P2P protocol for drop 2018-03-08 16:56:17 -04:00
git-annex-smudge.mdwn
git-annex-status.mdwn better doc for --json-error-messages 2018-02-19 15:33:59 -04:00
git-annex-sync.mdwn sync: Added --cleanup, which removes local and remote synced/ branches. 2017-09-28 14:58:48 -04:00
git-annex-test.mdwn add links 2017-11-09 11:34:53 -04:00
git-annex-testremote.mdwn add links 2017-11-09 11:34:53 -04:00
git-annex-transferkey.mdwn
git-annex-transferkeys.mdwn
git-annex-trust.mdwn
git-annex-unannex.mdwn
git-annex-undo.mdwn
git-annex-ungroup.mdwn
git-annex-uninit.mdwn
git-annex-unlock.mdwn better doc for --json-error-messages 2018-02-19 15:33:59 -04:00
git-annex-untrust.mdwn
git-annex-unused.mdwn
git-annex-upgrade.mdwn
git-annex-vadd.mdwn
git-annex-vcycle.mdwn
git-annex-version.mdwn
git-annex-vfilter.mdwn
git-annex-vicfg.mdwn
git-annex-view.mdwn
git-annex-vpop.mdwn
git-annex-wanted.mdwn
git-annex-watch.mdwn
git-annex-webapp.mdwn
git-annex-whereis.mdwn better doc for --json-error-messages 2018-02-19 15:33:59 -04:00
git-annex.mdwn fix markdown 2018-03-08 12:54:56 -04:00
git-remote-tor-annex.mdwn
git-union-merge.mdwn
how_it_works.mdwn
index.mdwn
install.mdwn remove links to trees of files, as they confuse users and prevent them reading the instructions before downloading 2017-08-28 13:05:03 -04:00
internals.mdwn change export.log format to support multiple export remotes 2017-09-12 17:45:52 -04:00
license.mdwn
location_tracking.mdwn
logo-old-bw.svg
logo-old.png
logo-old.svg
logo-old_small.png
logo.mdwn
logo.svg
logo_16x16.png
logo_32x32.png
logo_small.png
meta.mdwn
metadata.mdwn
news.mdwn
not.mdwn Update boar link 2018-01-12 01:15:23 +00:00
polls.mdwn
preferred_content.mdwn
privacy.mdwn
publicrepos.mdwn Added datalad "super-dataset". 2017-09-05 17:00:38 +00:00
related_software.mdwn 2018-03-07 23:19:56 +00:00
repomap.png
required_content.mdwn fsck: Warn when required content is not present in the repository that requires it. 2018-02-08 14:08:41 -04:00
scalability.mdwn
shortcuts.mdwn
sidebar.mdwn
sitemap.mdwn
special_remotes.mdwn Fixed typo: added "to" to "the --size parameter can adjust it [to] test using smaller files" 2017-11-02 22:25:47 +00:00
stickers.mdwn
submodules.mdwn
summary.mdwn
sync.mdwn
testimonials.mdwn
thanks.mdwn updates 2018-01-02 16:28:33 -04:00
tips.mdwn
todo.mdwn limit rss/atom feeds to 10 pages to avoid enormous files 2017-09-29 12:42:09 -04:00
transferring_data.mdwn
trust.mdwn
tuning.mdwn
upgrades.mdwn
users.mdwn
videos.mdwn
Void.mdwn
walkthrough.mdwn
workflow.mdwn