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

NAME
       git-annex-put - send content of files to other repositories

SYNOPSIS
       git annex put [path ...]

DESCRIPTION
       Sends the content of annexed files to remotes. By default, files are
       sent to all remotes (except for certian special remotes that have to be
       populated using git-annex export).

       With no parameters, operates on all annexed files in the current
       directory.  Paths of files or directories to operate on can be
       specified.

OPTIONS
       --wanted -w

              Send files only to remotes that want them.  See git-
              annex-preferred-content(1)

       --auto Only send files to remotes that want them, or when there are not
              yet the desired number of copies.

       --fast Only send files to remotes with the lowest annex-cost value
              configured.

       --jobs=N -JN
              Enables parallel transfers with up to the specified number of
              jobs running at once. For example: -J10

              Setting this to "cpus" will run one job per CPU core.

       --all -A
              Rather than specifying a filename or path to send, this option
              can be used to send all available versions of all files.

              This is the default behavior when running git-annex in a bare
              repository.

       --branch=ref
              Operate on files in the specified branch or treeish.

       --unused
              Operate on files found by last run of git-annex unused.

       --failed
              Operate on files that have recently failed to be transferred.

       --key=keyname
              Use this option to send a specified key.

       matching options
              The git-annex-matching-options(1) can be used to specify what to
              send.

       --batch
              Enables batch mode, in which lines containing names of files to
              send are read from stdin.

              As each specified file is processed, the usual progress output
              is displayed. If a file's content does not need to be sent, or
              it does not match specified matching options, or it is not an
              annexed file, a blank line is output in response instead.

              Since the usual output while sending a file is verbose and not
              machine-parseable, you may want to use --json in combination
              with --batch.

       --batch-keys
              This is like --batch but the lines read from stdin are parsed as
              keys.

       -z     Makes batch input be delimited by nulls instead of the usual
              newlines.

       --json Enable JSON output. This is intended to be parsed by programs
              that use git-annex. Each line of output is a JSON object.

       --json-progress
              Include progress objects in JSON output.

       --json-error-messages
              Messages that would normally be output to standard error are
              included in the JSON instead.

       Also the git-annex-common-options(1) can be used.

SEE ALSO
       git-annex(1)

       git-annex-get(1)

       git-annex-copy(1)

AUTHOR
       Joey Hess <id@joeyh.name>

                                                              git-annex-put(1)