git-annex/doc/git-annex-get.mdwn

# NAME

git-annex get - make content of annexed files available

# SYNOPSIS

git annex get `[path ...]`

# DESCRIPTION

Makes the content of annexed files available in this repository. This
will involve copying them from a remote repository, or downloading them,
or transferring them from some kind of key-value store.

# OPTIONS

* `--auto`

  Rather than getting all files, get only files that don't yet have
  the desired number of copies, or that are preferred content of the
  repository. See [[git-annex-preferred-content]](1)

* `--from=remote`

  Normally git-annex will choose which remotes to get the content
  from. Use this option to specify which remote to use. 
  
  Any files that are not available on the remote will be silently skipped.

* `--jobs=N` `-JN`

  Enables parallel download with up to the specified number of jobs
  running at once. For example: `-J10`

* `--all`

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

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

* `--unused`

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

* `--key=keyname`

  Use this option to get a specified key.

* file matching options
 
  The [[git-annex-matching-options]](1)
  can be used to specify files to get.

# SEE ALSO

[[git-annex]](1)

[[git-annex-drop]](1)

# AUTHOR

Joey Hess <id@joeyh.name>

Warning: Automatically converted into a man page by mdwn2man. Edit with care.
splitting up the man page Common command man pages all split out and often expanded. A few sections split out into their own pages. Still need to do all the other commands.. 2015-03-23 19:36:10 +00:00			`# NAME`

			`git-annex get - make content of annexed files available`

			`# SYNOPSIS`

			git annex get `[path ...]`

			`# DESCRIPTION`

			`Makes the content of annexed files available in this repository. This`
			`will involve copying them from a remote repository, or downloading them,`
			`or transferring them from some kind of key-value store.`

			`# OPTIONS`

--auto is no longer a global option; only get, drop, and copy accept it. Not a behavior change unless you were passing it to a command that ignored it. 2015-03-25 21:06:14 +00:00			* `--auto`

			`Rather than getting all files, get only files that don't yet have`
			`the desired number of copies, or that are preferred content of the`
			`repository. See [[git-annex-preferred-content]](1)`

splitting up the man page Common command man pages all split out and often expanded. A few sections split out into their own pages. Still need to do all the other commands.. 2015-03-23 19:36:10 +00:00			* `--from=remote`

			`Normally git-annex will choose which remotes to get the content`
fix thru documentation 2015-05-01 18:13:30 +00:00			`from. Use this option to specify which remote to use.`

			`Any files that are not available on the remote will be silently skipped.`
splitting up the man page Common command man pages all split out and often expanded. A few sections split out into their own pages. Still need to do all the other commands.. 2015-03-23 19:36:10 +00:00
get, move, copy, mirror: Concurrent downloads and uploads are now supported! This works, and seems fairly robust. Clean get of 20 files at -J3. At -J10, there are some messages about ssh multiplexing, probably due to a race spinning up the ssh connection cacher. But, it manages to get all the files ok regardless. The progress bars are a scrambled mess though, due to bugs in ascii-progress, which I've already filed. Particularly this one: https://github.com/yamadapc/haskell-ascii-progress/issues/8 2015-04-10 21:08:07 +00:00			* `--jobs=N` `-JN`

			`Enables parallel download with up to the specified number of jobs`
			running at once. For example: `-J10`

splitting up the man page Common command man pages all split out and often expanded. A few sections split out into their own pages. Still need to do all the other commands.. 2015-03-23 19:36:10 +00:00			* `--all`

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

finished splitting out man pages for all commands 2015-03-25 16:09:49 +00:00			`This is the default behavior when running git-annex in a bare repository.`

separated man pages for all the maintenance commands 2015-03-24 19:23:59 +00:00			* `--unused`

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

splitting up the man page Common command man pages all split out and often expanded. A few sections split out into their own pages. Still need to do all the other commands.. 2015-03-23 19:36:10 +00:00			* `--key=keyname`

			`Use this option to get a specified key.`

			`* file matching options`

			`The [[git-annex-matching-options]](1)`
			`can be used to specify files to get.`

			`# SEE ALSO`

			`[[git-annex]](1)`

			`[[git-annex-drop]](1)`

			`# AUTHOR`

			`Joey Hess <id@joeyh.name>`

			`Warning: Automatically converted into a man page by mdwn2man. Edit with care.`