Powered by

snapdir manifest

Print the manifest of a directory.

The manifest is the canonical, line-oriented description of a directory tree — its checksummed entries are what the snapshot ID is derived from. See Manifests for the format.

Usage

snapdir manifest [OPTIONS] [PATH]

Arguments

Argument Description
[PATH] Directory to describe.

Options

In addition to the universal output options, manifest accepts:

Option Description
--absolute Emit absolute paths instead of ./-relative paths.
--no-follow Do not follow symbolic links (plain find instead of find -L).
--checksum-bin <NAME> Checksum binary to mirror: b3sum (default), md5sum, sha256sum.
--exclude <PATTERN> Exclude paths matching the extended-regex PATTERN; supports %system% and %common% macros.
--walk-jobs <N> Max parallel file-hashing jobs during the directory walk. Env: SNAPDIR_WALK_JOBS.
--catalog <NAME> Catalog adapter to record this manifest's location in. Env: SNAPDIR_CATALOG; unset uses the default catalog, none disables catalog writes.
-q, --quiet / --no-progress / --color <WHEN> / --verbose Universal output-control options.

The input tree should be quiescent while snapdir walks it. If files change, vanish, or directory structure changes during the walk, manifest fails with an in-flux error such as file changed during walk, file vanished during walk, or tree structure changed during walk.

Examples

Print the manifest of the current directory:

snapdir manifest .

Print a manifest with absolute paths and excluding a directory:

snapdir manifest --absolute --exclude '\.git/' ./project

See also