check

Purpose

Validate working tree structure, branch consistency and repository history.

Usage

brz check [PATH]

Options
--branch

Check the branch related to the current directory.

-h, --help

Show help message.

-q, --quiet

Only display errors and warnings.

--repo

Check the repository related to the current directory.

--tree

Check the working tree related to the current directory.

--usage

Show usage message and options.

-v, --verbose

Display more information.

Description

This command checks various invariants about branch and repository storage to detect data corruption or brz bugs.

The working tree and branch checks will only give output if a problem is detected. The output fields of the repository check are:

revisions

This is just the number of revisions checked. It doesn’t indicate a problem.

versionedfiles

This is just the number of versionedfiles checked. It doesn’t indicate a problem.

unreferenced ancestors

Texts that are ancestors of other texts, but are not properly referenced by the revision ancestry. This is a subtle problem that Breezy can work around.

unique file texts

This is the total number of unique file contents seen in the checked revisions. It does not indicate a problem.

repeated file texts

This is the total number of repeated texts seen in the checked revisions. Texts can be repeated when their file entries are modified, but the file contents are not. It does not indicate a problem.

If no restrictions are specified, all data that is found at the given location will be checked.

Examples

Check the tree and branch at ‘foo’:

brz check --tree --branch foo

Check only the repository at ‘bar’:

brz check --repo bar

Check everything at ‘baz’:

brz check baz
See also

reconcile