git-annex-testremote

git-annex-testremote(1)      General Commands Manual     git-annex-testremote(1)



NAME
       git-annex-testremote - test transfers to/from a remote

SYNOPSIS
       git annex testremote remote

DESCRIPTION
       This tests a remote by sending objects to it, downloading objects from
       it, etc.

       It's safe to run in an existing repository (the repository contents are
       not altered), although it may perform expensive data transfers.

       It's best to make a new remote for testing purposes. While the test tries
       to clean up after itself, if the remote being tested had a bug, the
       cleanup might fail, leaving test data in the remote.

       Testing will use the remote's configuration, automatically varying the
       chunk sizes, and with simple shared encryption disabled and enabled, and
       exporttree disabled and enabled. If the remote is readonly, testing is
       limited to checking various properties of downloading from it.

OPTIONS
       --fast

              Perform a smaller set of tests.

       --test-readonly=file
              Normally, random objects are generated for the test and are sent
              to the remote. When a readonly remote is being tested, that cannot
              be done, and so you need to specify some annexed files to use in
              the testing, using this option. Their content needs to be present
              in the readonly remote being tested, and in the local repository.

              This option can be repeated.

       --size=NUnits
              Tune the base size of generated objects. The default is 1MiB.

SEE ALSO
       git-annex(1)

       git-annex-test(1)

AUTHOR
       Joey Hess <id@joeyh.name>

                                                         git-annex-testremote(1)