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

NAME

6       git-annex-testremote - test transfers to/from a remote
7

SYNOPSIS

9       git annex testremote remote
10

DESCRIPTION

12       This  tests a remote by sending objects to it, downloading objects from
13       it, etc.
14
15       It's safe to run in an existing repository (the repository contents are
16       not altered), although it may perform expensive data transfers.
17
18       It's  best  to  make  a new remote for testing purposes. While the test
19       tries to clean up after itself, if the remote being tested had  a  bug,
20       the cleanup might fail, leaving test data in the remote.
21
22       Testing  will use the remote's configuration, automatically varying the
23       chunk sizes, and with simple shared encryption  disabled  and  enabled,
24       and exporttree disabled and enabled. If the remote is readonly, testing
25       is limited to checking various properties of downloading from it.
26

OPTIONS

28       --fast
29
30              Perform a smaller set of tests.
31
32       --test-readonly=file
33              Normally, random objects are generated for the test and are sent
34              to the remote. When a readonly remote is being tested, that can‐
35              not be done, and so you need to specify some  annexed  files  to
36              use in the testing, using this option. Their content needs to be
37              present in the readonly remote being tested, and  in  the  local
38              repository.
39
40              This option can be repeated.
41
42       --size=NUnits
43              Tune the base size of generated objects. The default is 1MiB.
44
45       Also the git-annex-common-options(1) can be used.
46

SEE ALSO

48       git-annex(1)
49
50       git-annex-test(1)
51

AUTHOR

53       Joey Hess <id@joeyh.name>
54
55                                                       git-annex-testremote(1)