git-annex/doc/git-annex-trust.mdwn
Joey Hess 6a0030a110
Behavior change: git-annex trust now needs --force
Since unconsidered use of trusted repositories can lead to data loss.

Trusted has always been this way, but it used to be acceptable for
git-annex to be set up so that data could be lost without using --force,
and most or all other ways that can happen have already been eliminated.

This commit was sponsored by Mark Reidenbach on Patreon.
2021-01-07 10:09:39 -04:00

38 lines
936 B
Markdown

# NAME
git-annex trust - trust a repository
# SYNOPSIS
git annex trust `[repository ...]`
# DESCRIPTION
Records that a repository is trusted to not unexpectedly lose
content. Use with care.
Repositories can be specified using their remote name, their
description, or their UUID. To trust the current repository, use "here".
Before trusting a repository, consider this scenario. Repository A
is trusted and B is not; both contain the same content. `git-annex drop`
is run on repository A, which checks that B still contains the content,
and so the drop proceeds. Then `git-annex drop` is run on repository B,
which trusts A to still contain the content, so the drop succeeds. Now
the content has been lost.
# SEE ALSO
[[git-annex]](1)
[[git-annex-semitrust]](1)
[[git-annex-untrust]](1)
[[git-annex-dead]](1)
# AUTHOR
Joey Hess <id@joeyh.name>
Warning: Automatically converted into a man page by mdwn2man. Edit with care.