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)