git-annex-common-options - options supported by many git-annex commands
These common options are accepted by many git-annex commands, and may not be
explicitly listed on their individual man pages. Most of these options are
accepted by all git-annex commands. (Many commands also accept the
git-annex-matching-options(1).)
- --force
- Force unsafe actions, such as dropping a file's content
when no other source of it can be verified to still exist, or adding
ignored files. Use with care.
- --fast
- Avoid some expensive operations normally performed by a
command. What is avoided depends on the command, see individual command's
man pages for details.
- --quiet
- Avoid the default verbose display of what is done; only
show errors.
- --verbose
- Enable verbose display.
- --debug
- Display debug messages.
- --no-debug
- Disable display of debug messages.
- --debugfilter=name[,name..]
- When debug message display has been enabled by
--debug, this filters the debug messages that are displayed to ones
coming from modules with the specified names.
- To find the names of modules, see the full debug output,
which includes the module name, eg "(Utility.Process)"
- The full module name does not need to be specified when
using this, a substring of the name will do.
- For example, --debugfilter=Process,External will
display debugging output when git-annex runs processes, and when it
communicates with external special remotes.
- --numcopies=n
- Overrides the numcopies setting.
- --mincopies=n
- Overrides the mincopies setting.
- --time-limit=time
- Limits how long a git-annex command runs. The time can be
something like "5h", or "30m" or even "45s"
or "10d".
- Note that git-annex may continue running for some time past
the specified time limit, in order to finish processing files it started
before the time limit was reached. That and a cleaner shutdown are the
differences between using this option and a command like
timeout(1).
- When the time limit prevents git-annex from doing all it
was asked to, it will exit with a special code, 101.
- --size-limit=size
- Limits the total size of annexed files that a git-annex
command can process.
- The size can be specified with any commonly used units, for
example, "50gb".
- In some cases, an annexed file's size is not known. This
option will prevent git-annex from processing such files.
- When the size limit prevents git-annex from acting on any
files, it will exit with a special code, 101.
- --semitrust=repository
- --untrust=repository
- Overrides trust settings for a repository. May be specified
more than once.
- The repository should be specified using the name of a
configured remote, or the UUID or description of a repository.
- --trust=repository
- This used to override trust settings for a repository, but
now will not do so, because trusting a repository can lead to data loss,
and data loss is now only enabled when using the --force
option.
- --trust-glacier
- This used to override trust settings for Glacier special
remotes, but now will not do so, because it could lead to data loss, and
data loss is now only enabled when using the --force option.
- --user-agent=value
- Overrides the User-Agent to use when downloading files from
the web.
- --notify-finish
- Caused a desktop notification to be displayed after each
successful file download and upload.
- (Only supported on some platforms, e.g. Linux with dbus. A
no-op when not supported.)
- --notify-start
- Caused a desktop notification to be displayed when a file
upload or download has started, or when a file is dropped.
- -c name=value
- Overrides git configuration settings. May be specified
multiple times.
git-annex(1)
Joey Hess <
[email protected]>