1git-annex-registerurl(1)    General Commands Manual   git-annex-registerurl(1)
2
3
4

NAME

6       git-annex-registerurl - registers an url for a key
7

SYNOPSIS

9       git annex registerurl [key url]
10

DESCRIPTION

12       This  plumbing-level  command  can be used to register urls where a key
13       can be downloaded from.
14
15       No verification is performed of the url's contents.
16
17       Normally the key is a git-annex formatted key. However, to make it eas‐
18       ier  to use this to add urls, if the key cannot be parsed as a key, and
19       is a valid url, an URL key is constructed from the url.
20
21       Registering an url also makes git-annex treat the key as present in the
22       special remote that claims it. (Usually the web special remote.)
23

OPTIONS

25       --remote=name|uuid
26
27              Indicate that the url is expected to be claimed by the specified
28              remote.  If some other remote claims the url instead,  register‐
29              ing it will fail.
30
31              Note that --remote=web will prevent any other remote from claim‐
32              ing the url.
33
34       --batch
35              In batch input mode, lines are read from stdin,  and  each  line
36              should contain a key and url, separated by a single space.
37
38              For  backwards  compatability with old git-annex before this op‐
39              tion was added, when no key and url pair are  specified  on  the
40              command  line,  batch  input is used, the same as if the --batch
41              option were specified. It is however recommended to use --batch.
42
43       -z     When in batch mode, the input is delimited by nulls  instead  of
44              the usual newlines.
45
46              (Note  that  for  this to be used, you have to explicitly enable
47              batch mode with --batch)
48
49       --json Enable JSON output. This is intended to be  parsed  by  programs
50              that use git-annex. Each line of output is a JSON object.
51
52       --json-error-messages
53              Messages that would normally be output to standard error are in‐
54              cluded in the json instead.
55
56       Also the git-annex-common-options(1) can be used.
57

SEE ALSO

59       git-annex(1)
60
61       git-annex-addurl(1)
62
63       git-annex-unregisterurl(1)
64

AUTHOR

66       Joey Hess <id@joeyh.name>
67
68                                                      git-annex-registerurl(1)
Impressum