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

split out section on common configuration parameters

Browse source
This commit is contained in:
Joey Hess 2019-04-16 13:09:12 -04:00
parent 935eed0bb0
commit 7f50371bf2
No known key found for this signature in database
GPG key ID: DB12DB0FF05F8F38
1 changed files with 33 additions and 19 deletions
Download patch file Download diff file Expand all files Collapse all files

52
doc/git-annex-initremote.mdwn
View file

@ -19,36 +19,20 @@ For a list and details, see <https://git-annex.branchable.com/special_remotes/>
The remote's configuration is specified by the parameters passed The remote's configuration is specified by the parameters passed
to this command. Different types of special remotes need different to this command. Different types of special remotes need different
configuration values. The command will prompt for parameters as needed. configuration values. The command will prompt for parameters as needed. A
few parameters that are supported by all special remotes are documented in
All special remotes support encryption. You can specify the next section below.
`encryption=none` to disable encryption, or specify
`encryption=hybrid keyid=$keyid ...` to specify a GPG key id (or an email
address associated with a key). For details about ways to configure
encryption, see <https://git-annex.branchable.com/encryption/>
Once a special remote has been initialized once with this command, Once a special remote has been initialized once with this command,
other clones of the repository can also be set up to access it using other clones of the repository can also be set up to access it using
`git annex enableremote`. `git annex enableremote`.
To avoid `git annex enableremote` needing to be run,
you can pass "autoenable=true". Then when [[git-annex-init]](1)
is run in a new clone, it will attempt to enable the special remote. Of
course, this works best when the special remote does not need anything
special to be done to get it enabled.
The name you provide for the remote can't be one that's been used for any The name you provide for the remote can't be one that's been used for any
other special remote before, because `git-annex enableremote` uses the name other special remote before, because `git-annex enableremote` uses the name
to identify which special remote to enable. If some old special remote to identify which special remote to enable. If some old special remote
that's no longer used has taken the name you want to reuse, you might that's no longer used has taken the name you want to reuse, you might
want to use `git annex renameremote`. want to use `git annex renameremote`.
Normally, git-annex generates a new UUID for the new special remote.
If you want to, you can specify a UUID for it to use, by passing a
uuid=whatever parameter. This can be useful in some situations, eg when the
same data can be accessed via two different remote backends.
But if in doubt, don't do this.
# OPTIONS # OPTIONS
* `--fast` * `--fast`
@ -59,6 +43,36 @@ But if in doubt, don't do this.
and re-run with `--fast`, which causes it to use a lower-quality source of and re-run with `--fast`, which causes it to use a lower-quality source of
randomness. (Ie, /dev/urandom instead of /dev/random) randomness. (Ie, /dev/urandom instead of /dev/random)
# COMMON CONFIGURATION PARAMETERS
* `encryption`
All special remotes support encryption. You will need to specify
what encryption, if any, to use.
If you do not want any encryption, use `encryption=none`
To encrypt to a GPG key, use `encryption=hybrid keyid=$keyid ...`
and fill in the GPG key id (or an email address associated with a GPG key).
For details about this and other encrpytion settings, see
<https://git-annex.branchable.com/encryption/>
* `autoenable`
To avoid `git annex enableremote` needing to be run,
you can pass "autoenable=true". Then when [[git-annex-init]](1)
is run in a new clone, it will attempt to enable the special remote. Of
course, this works best when the special remote does not need anything
special to be done to get it enabled.
* `uuid`
Normally, git-annex initremote generates a new UUID for the new special
remote. If you want to, you can specify a UUID for it to use, by passing a
uuid=whatever parameter. This can be useful in some unusual situations.
But if in doubt, don't do this.
# SEE ALSO # SEE ALSO
[[git-annex]](1) [[git-annex]](1)