git-annex/doc/git-annex-satisfy.mdwn

70 lines
1.8 KiB
Text
Raw Normal View History

2023-06-29 18:15:01 +00:00
# NAME
git-annex satisfy - transfer and drop content as configured
# SYNOPSIS
git annex satisfy `[remote ...]`
2023-06-29 18:15:01 +00:00
# DESCRIPTION
This transfers and drops content of annexed files to work toward satisfying
the preferred content settings of the local repository and remotes.
2023-06-29 18:15:01 +00:00
It does the same thing as `git-annex sync --content` without the pulling
and pushing of git repositories, and without changing the trees that are
imported to or exported from special remotes.
2023-06-29 18:15:01 +00:00
# OPTIONS
* `[remote]`
2023-06-29 18:15:01 +00:00
By default this command operates on all remotes, except for remotes
that have `remote.<name>.annex-sync` set to false.
2023-06-29 18:15:01 +00:00
By specifying the names of remotes (or remote groups), you can control
which ones to operate on.
2023-06-29 18:15:01 +00:00
* `--content-of=path` `-C path`
2023-06-29 18:15:01 +00:00
Operate on only files in the specified path. The default is to operate on
all files in the working tree.
2023-06-29 18:15:01 +00:00
This option can be repeated multiple times with different paths.
2023-06-29 18:15:01 +00:00
Note that this option is ignored when syncing with "exporttree=yes"
remotes.
* `--jobs=N` `-JN`
2023-06-29 18:15:01 +00:00
Enables parallel processing with up to the specified number of jobs
running at once. For example: `-J10`
2023-06-29 18:15:01 +00:00
Setting this to "cpus" will run one job per CPU core.
2023-06-29 18:15:01 +00:00
* `--all` `-A`
2023-06-29 18:15:01 +00:00
Usually this command operates on annexed files in the current branch.
This option makes it operate on all available versions of all annexed files
(when preferred content settings allow).
2023-06-29 18:15:01 +00:00
Note that preferred content settings that use `include=` or `exclude=`
will only match the version of files currently in the work tree, but not
past versions of files.
2023-06-29 18:15:01 +00:00
* Also the [[git-annex-common-options]](1) can be used.
# SEE ALSO
[[git-annex]](1)
[[git-annex-sync]](1)
[[git-annex-preferred-content]](1)
# AUTHOR
Joey Hess <id@joeyh.name>
Warning: Automatically converted into a man page by mdwn2man. Edit with care.