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

NAME

6       git-annex-unregisterurl - unregisters an url for a key
7

SYNOPSIS

9       git annex unregisterurl [key url]
10

DESCRIPTION

12       This  plumbing-level  command  can be used to unregister urls when keys
13       can no longer be downloaded from them.
14
15       Normally the key is a git-annex formatted key. However, if the key can‐
16       not  be  parsed as a key, and is a valid url, an URL key is constructed
17       from the url.
18
19       Unregistering a key's last web url will make git-annex no longer  treat
20       content  as being present in the web special remote. If some other spe‐
21       cial remote claims the url, unregistering the url will not update pres‐
22       ence  information  for  it, because the content may still be present on
23       the remote.
24

OPTIONS

26       --remote=name|uuid
27
28              Indicate that the url is expected to be claimed by the specified
29              remote.   If  some other remote claims the url instead, unregis‐
30              tering it will fail.
31
32              Note that --remote=web will prevent any other remote from claim‐
33              ing the url.
34
35       --batch
36              In  batch  input  mode, lines are read from stdin, and each line
37              should contain a key and url, separated by a single space.
38
39       -z     When in batch mode, the input is delimited by nulls  instead  of
40              the usual newlines.
41
42       --json Enable  JSON  output.  This is intended to be parsed by programs
43              that use git-annex. Each line of output is a JSON object.
44
45       --json-error-messages
46              Messages that would normally be output to standard error are in‐
47              cluded in the JSON instead.
48
49       Also the git-annex-common-options(1) can be used.
50

SEE ALSO

52       git-annex(1)
53
54       git-annex-registerurl(1)
55
56       git-annex-rmurl(1)
57

AUTHOR

59       Joey Hess <id@joeyh.name>
60
61                                                    git-annex-unregisterurl(1)