FreeBSD Manual Pages
zelta-match(8) System Manager's Manual zelta-match(8) NAME zelta match - Describes the relationship between a dataset tree and its replica. SYNOPSIS zelta match [-Hp] [-d depth] [-o field[,...]] source target DESCRIPTION zelta match recursively displays a dataset and its children, the source, and compares it to its replica, the target. zelta match dis- plays fields describing differences and similarities between the two dataset trees. This is useful for assisting with replication opera- tions and confirming backups. Logging Options -v, --verbose Increase verbosity. Specify once for operational detail and twice (-vv) for debug output. -q, --quiet Quiet output. Specify once to suppress warnings and twice (-qq) to suppress errors. --log-level Specify a log level value 0-4: errors (0), warnings (1), notices (2, default), info (3, verbose), and debug (4). --log-mode Enable the specified log modes: `text' and `json' are currently supported. --text Forces default output (notices) to print as plain text standard output. -n, --dryrun Display `zfs' commands related to the action rather than running them. Dataset and Snapshot Options -d, --depth Limit the recursion depth of operations to the number of levels indicated. For example, a depth of 1 will only include the in- dicated dataset. --exclude, -X Exclude datasets or source snapshots matching the specified ex- clusion pattern. This option can include multiple patterns sep- arated by commas and can be specified multiple times. See EX- CLUSION PATTERNS in zelta-options(7) for details. Columns and Summary Behavior -H Suppress column headers and separate columns with a single tab. -p Output sizes in exact numbers instead of human-readable values like `1M'. -o Specify a list of `zelta match' columns. See FIELD OPTIONS be- low for detail. --written Calculate data sizes for datasets and snapshots. Enabled by de- fault, but it can impact list time. --time Calculate the time of each `zfs list' operation. FIELD OPTIONS FIELD DESCRIPTION ----------------------------------------- ds_suffix Relative dataset name match Latest matching snapshot num_matches Total number of matches xfer_size Unsynced data size based on snapshots xfer_num Unsynced snapshot count src_name Full source dataset name src_first First source snapshot src_next Next source snapshot after match src_last Latest source snapshot src_written Source data written since last snap src_snaps Total source snapshots tgt_name Full target dataset name tgt_first First target snapshot tgt_next Next target snapshot that is blocking sync tgt_last Latest target snapshot tgt_written Target data written since last snap tgt_snaps Total target snapshots info Sync state description EXAMPLES Basic Comparison: Compare snapshots between local source and target datasets. zelta match tank/source/dataset tank/target/dataset Remote Comparison: Compare snapshots and show the size in bytes of missing snapshots on the second system. zelta match user@remote.host1:tank/source/dataset user2@remote.host2:tank/target/dataset Quick backup integrity check: Compare the top two levels of similar backup repositories to see which backups might be missing or out of be- tween each host. zelta match -d2 backuphost:rust101/Backups rust000/Backups Dry Run: Display the zfs list commands that would be used without exe- cuting them. zelta match -n tank/source/dataset tank/target/dataset SEE ALSO zelta(8), zelta-backup(8), zelta-policy(8), zelta-clone(8), zelta-op- tions(7), zelta-revert(8), zelta-rotate(8), cron(8), ssh(1), zfs(8) AUTHORS Daniel J. Bell <bellhyve@zelta.space> WWW https://zelta.space zelta-match(8)
NAME | SYNOPSIS | DESCRIPTION | FIELD OPTIONS | EXAMPLES | SEE ALSO | AUTHORS | WWW
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=zelta-match&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>