BTRBK(1) Btrbk BTRBK(1) (NAME) btrbk - btrfs (SYNOPSIS) btrbk [-h|--help] [--version] [-c|--config ] [-n|--dry-run] [--exclude ] [-p|--preserve] [--preserve-snapshots] [--preserve-backups] [-v|--verbose] [-q|--quiet] [-l|--loglevel ] [-t|--table] [-L|--long] [-1|--single-column] [--format ] [--pretty] [-S|--print-schedule] [--progress] [--lockfile ] [--override =] [[--] ...] (DESCRIPTION) btrbk btrfs btrfs btrfs . . btrbk (root privileges) . "btrfs-progs-sudo" "btrfs-progs-btrbk" btrbk . backend btrbk.conf(5) . (Snapshots and Backups) : .[_N] snapshot_name . ( btrbk ) / . timestamp_format btrbk.conf(5) . / / N . ( ) btrbk . btrfs snapshot << >> ( parent-uuid btrfs-subvolume(8) ) - () . btrbk snapshot << btrfs>> backup << send/receive>> ( received-uuid ) . (OPTIONS) -h, --help . --version btrbk . -c, --config . -n, --dry-run run snapshot resume prune archive clean . btrfs -l debug . --exclude . (FILTER STATEMENTS) . -p, --preserve . ( "--preserve-snapshots --preserve-backups"). --preserve-snapshots . . --preserve-backups . . --wipe . ( ) . (ENOSPC) . -v, --verbose (logging) "--loglevel" . -q, --quiet . btrbk run snapshot resume prune archive . -l, --loglevel stderr . : error warn info debug trace. info . -t, --table ( "--format=table"). -L, --long ( "--format=long"). -1, --single-column ( ). --format table|long|raw|col:[h:] . "raw" = (key=value) ( ) . "col:" ( ) . "h:" . "-" . ":RALIGN" . --pretty ( ). -S, --print-schedule run snapshot resume prune archive . --format . --progress send-receive . "mbuffer" ( >= 20180505) btrbk . --lockfile flock(2) . . "lockfile" . (-n --dry-run) . --override = . (contexts). ! (COMMANDS) (Actions) / . (-n --dry-run) . --format . RETENTION POLICY btrbk.conf(5) . run [filter...] . [filter...] / ( (FILTER STATEMENTS) ). : (Step 0: Read Data) btrfs / received-from. : (Step 1: Create Snapshots) btrbk snapshot_create . : (Step 2: Create Backups) btrbk : btrbk . ( incremental "no" ) ( ) . : (Step 3: Delete Backups) -p --preserve --preserve-backups . / . : (Step 4: Delete Snapshots) -p --preserve --preserve-snapshots . ( ) / . . dryrun [filter...] btrfs run . btrfs -l debug . snapshot [filter...] : ( ) . ( ) -p --preserve ( --preserve-snapshots) . / ( ) . resume [filter...] : ( ) / . / ( ) -p --preserve --preserve-backups --preserve-snapshots . prune [filter...] : ( ) . . ( ) --preserve-backups --preserve-snapshots . / ( ) . archive [--raw] btrbk archive_preserve_* . . () . btrbk . ( "btrfs subvolume create /dir"). --dry-run . linux kernel >=4.4 ! --raw (raw) ( btrbk.conf(5) (TARGET TYPES) ). clean [filter...] () . (kill) send/receive "received_uuid" () . (+S) (+B) (-S) (-B) : Command Option S+ B+ S- B- -------------------------------------------- run x x x x run --preserve x x run --preserve-snapshots x x x run --preserve-backups x x x snapshot x x snapshot --preserve x resume x x x resume --preserve x resume --preserve-snapshots x x resume --preserve-backups x x prune x x prune --preserve-snapshots x prune --preserve-backups x (Informative Commands) . stats [filter...] . [filter...] ( (FILTER STATEMENTS) ). list [filter...] . [filter...] ( (FILTER STATEMENTS) ). ( "all"): all btrbk. snapshots btrbk. backups ( ) btrbk. latest / . config // . source / . volume (volume) . target . --format . usage [filter...] / [filter...] ( (FILTER STATEMENTS) ). "free" . origin : - received-from . --format . diff (transid) . : SIZE file was modified for a total of SIZE bytes COUNT file was modified in COUNT generations FLAGS "+" file accessed at offset 0 (at least once) "c" COMPRESS flag is set (at least once) "i" INLINE flag is set (at least once) extents [diff] ... [exclusive ...] (diff) extent ( FIEMAP ioctl !). exclusive set-exclusive . . : btrbk extents diff /backup/data.* exclusive /backup/data.2010* EXCLUSIVE set-exclusive (!) ( ). ( extent) . DIFF ( ). --related btrbk . parent-uuid . extent (RAM) . cache_dir . ls |... btrfs . --format . lsbtr(1) . config print|print-all . (FILTER STATEMENTS) : group volume subvolume target . [:] hostname volume target . | volume subvolume target ( "/" "ssh://" ":/") "*" . . : volume . / subvolume . // subvolume snapshot_dir snapshot_name . target . / target subvolume snapshot_name . : ssh://[:]/ : run snapshot target subvolume . snapshot resume . ( ). . (FILES) /etc/btrbk.conf, /etc/btrbk/btrbk.conf . btrbk.conf(5) . (EXIT STATUS) btrbk : 0 . 1 . 2 : . 3 : . 10 : . 255 . (AVAILABILITY) btrbk . (SEE ALSO) btrbk.conf(5), btrfs(8) btrfs . (AUTHORS) Axel Burri Btrbk 0.32.7 2026-07-19 BTRBK(1)