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 displays fields describing differences and similarities between the two dataset trees. This is useful for assisting with replication operations 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 sup- ported. --text Forces default output (notices) to print as plain text standard out- put. -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 in- dicated. For example, a depth of 1 will only include the indicated dataset. --exclude, -X Exclude datasets or source snapshots matching the specified exclu- sion pattern. This option can include multiple patterns separated by commas and can be specified multiple times. See EXCLUSION PAT- TERNS 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 below 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 between each host. zelta match -d2 backuphost:rust101/Backups rust000/Backups Dry Run: Display the zfs list commands that would be used without executing 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>