1
0
mirror of https://github.com/Zygo/bees.git synced 2025-08-03 06:13:29 +02:00

docs: update documentation for new 'recent' scan mode

Also attempted to clarify the descriptions of the modes based on
feedback and questions from users over the years.

Signed-off-by: Zygo Blaxell <bees@furryterror.org>
This commit is contained in:
Zygo Blaxell
2021-11-15 23:43:02 -05:00
parent 03f809bf22
commit 984ceeb2a5
2 changed files with 74 additions and 36 deletions

View File

@@ -40,16 +40,16 @@
* `--scan-mode MODE` or `-m`
Specify extent scanning algorithm. Default `MODE` is 0.
Specify extent scanning algorithm. Default `MODE` is 3.
**EXPERIMENTAL** feature that may go away.
* Mode 0: scan extents in ascending order of (inode, subvol, offset).
Keeps shared extents between snapshots together. Reads files sequentially.
Minimizes temporary space usage.
* Mode 1: scan extents from all subvols in parallel. Good performance
on non-spinning media when subvols are unrelated.
* Mode 2: scan all extents from one subvol at a time. Good sequential
read performance for spinning media. Maximizes temporary space usage.
* Mode 0: lockstep
* Mode 1: independent
* Mode 2: sequential
* Mode 3: recent
For details of the different scanning modes, see
[bees configuration](docs/config.md).
## Workarounds