From c75ff07b143e1917fe65abeddd221fa3252fb02d Mon Sep 17 00:00:00 2001 From: Joey Hess Date: Tue, 29 Nov 2016 17:31:10 -0400 Subject: update docs for git-annex p2p command It is not yet implemented. --- doc/git-annex-p2p.mdwn | 35 +++++++++-------------------- doc/git-annex-remotedaemon.mdwn | 3 +++ doc/git-annex.mdwn | 5 +++++ doc/tips/peer_to_peer_network_with_tor.mdwn | 6 ++--- 4 files changed, 21 insertions(+), 28 deletions(-) diff --git a/doc/git-annex-p2p.mdwn b/doc/git-annex-p2p.mdwn index 41e1967ee..8e06cc47c 100644 --- a/doc/git-annex-p2p.mdwn +++ b/doc/git-annex-p2p.mdwn @@ -1,6 +1,6 @@ # NAME -git-annex p2p - manage peer-to-peer connections +git-annex p2p - configure peer-2-peer links between repositories # SYNOPSIS @@ -8,36 +8,21 @@ git annex p2p [options] # DESCRIPTION -When using git-annex with peer-to-peer communication, this manages -connections between the peers. - -Currently, git-annex supports peer-to-peer communication over Tor. +This command can be used to link git-annex repositories over peer-2-peer +networks. # OPTIONS -* `--gen-address [name]` - - Generates one or more addresses, which allow whoever knows them to access - your repository. The addresses are output on standard output, one per - supported P2P network. - - You can re-run this command repeatedly to generate as many addresses - as you like. - - The name is an optional parameter, the name of the person or device you - intend to give this address to. Providig it makes it easier to use - `--remove-address` - -* `--link-remote name address` +* `--gen-address` - Link the local repository to a remote repository. This sets up a git remote - with the specified name. The address is one generated by `--gen-address` - run on the remote repository. + Generates addresses that can be used to access this git-annex repository + over a P2P network. The address or addresses is output to stdout. -* `--remove-address [address|name]` +* `--link-remote remotename address` - If you've given out an address to someone, and don't want to accept - connections from them anymore, this can be used to remove it. + Sets up a git remote with the specified remotename that is accessed over + a P2P network. The address is one generated in the remote repository using + `git annex p2p --gen-address` # SEE ALSO diff --git a/doc/git-annex-remotedaemon.mdwn b/doc/git-annex-remotedaemon.mdwn index 71dd32d30..d4960c4ff 100644 --- a/doc/git-annex-remotedaemon.mdwn +++ b/doc/git-annex-remotedaemon.mdwn @@ -27,6 +27,7 @@ that supports it is 5.20140405. For tor-annex remotes, the remotedaemon runs as a tor hidden service, accepting connections from other nodes and serving up the contents of the repository. This is only done if you first run `git annex enable-tor`. +Use `git annex p2p` to configure access to tor-annex remotes. # OPTIONS @@ -48,6 +49,8 @@ comes back up. [[git-annex-enable-tor]](1) +[[git-annex-p2p]](1) + # AUTHOR Joey Hess diff --git a/doc/git-annex.mdwn b/doc/git-annex.mdwn index 773e1b817..d0cc31019 100644 --- a/doc/git-annex.mdwn +++ b/doc/git-annex.mdwn @@ -391,6 +391,11 @@ subdirectories). See [[git-annex-remotedaemon]](1) for details. +* `p2p` + + Configure peer-2-Peer links between repositories. + + See [[git-annex-p2p]](1) for details. # QUERY COMMANDS diff --git a/doc/tips/peer_to_peer_network_with_tor.mdwn b/doc/tips/peer_to_peer_network_with_tor.mdwn index d7461a1e4..94470b96a 100644 --- a/doc/tips/peer_to_peer_network_with_tor.mdwn +++ b/doc/tips/peer_to_peer_network_with_tor.mdwn @@ -16,7 +16,7 @@ To make git-annex use Tor, run these commands in your git-annex repository: git annex remotedaemon git annex p2p --gen-address -The p2p-auth command will output a long address, such as: +The p2p command will output a long address, such as: tor-annex::eeaytkuhaupbarfi.onion:4412:7f53c5b65b8957ef626fd461ceaae8056e3dbc459ae715e4 @@ -55,8 +55,8 @@ You can run any commands you normally would to sync with that remote: git annex sync --content peer1 -You can also generate an address for this new peer, by running -`git annex p2p --gen`, and add that address to other peers using `git annex +You can also generate an address for this new peer, by running `git annex +p2p --gen-address`, and add that address to other peers using `git annex p2p --link-remote`. It's often useful to link peers up in both directions, so peer1 is a remote of peer2 and peer2 is a remote of peer1. -- cgit v1.2.3