From d8f95bb49e8f2cf8c7c4d7b00d13c07f5231c5a2 Mon Sep 17 00:00:00 2001 From: Axel Burri Date: Sun, 10 Jan 2021 16:21:30 +0100 Subject: [PATCH] documentation: btrbk.1: fix indentation --- doc/btrbk.1.asciidoc | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/doc/btrbk.1.asciidoc b/doc/btrbk.1.asciidoc index 77c4fb9..ee36ec0 100644 --- a/doc/btrbk.1.asciidoc +++ b/doc/btrbk.1.asciidoc @@ -382,30 +382,31 @@ FLAGS "+" file accessed at offset 0 (at least once) Print accurate disk space usage and diff based on extent data (FIEMAP ioctl, slow!). + +-- Subvolumes following the 'exclusive' keyword are added to a separate set, and additional set-exclusive data is printed at the end of the list. This gives a hint of how much data will be freed if deleting all subvolumes in the set. Example: - btrbk diff extents /backup/data.* exclusive /backup/data.2010* + btrbk extents diff /backup/data.* exclusive /backup/data.2010* -+ The EXCLUSIVE column shows the set-exclusive data of all other listed (!) subvolumes (relative complement of block regions). Provided that all related subvolumes (holding references to extents) are also listed, this amount of disk space would be freed when deleting the subvolume. -+ + The DIFF column shows the data added to the previous subvolume (relative complement of block regions). -+ + If called with the '--related' option, btrbk also lists all related subvolumes. This is not recommended for backups, as parent-uuid relations break for received subvolumes as soon as an intermediate subvolume is deleted. -+ + Note that reading all extents is a disk-intensive task, expect long execution times and high ram usage. Consider setting 'cache_dir'. +-- *ls* |...:: List all btrfs subvolumes below . Use the '--format' command