GGLinnk/bees
1
0
Fork 0
mirror of https://github.com/Zygo/bees.git synced 2025-05-18 05:45:45 +02:00
Code Packages

docs: update front page

Browse Source 
At least one user was significantly confused by "designed for large
filesystems".

The btrfs send workarounds aren't new any more.

Signed-off-by: Zygo Blaxell <bees@furryterror.org>
This commit is contained in:
Zygo Blaxell 2023-02-25 03:12:27 -05:00
parent 73834beb5a
commit 82474b4ef4
1 changed files with 12 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
docs/index.md
View File

@ -6,10 +6,11 @@ Best-Effort Extent-Same, a btrfs deduplication agent.
About bees About bees
---------- ----------
bees is a block-oriented userspace deduplication agent designed for large bees is a block-oriented userspace deduplication agent designed to scale
btrfs filesystems. It is an offline dedupe combined with an incremental up to large btrfs filesystems. It is a daemon that performs offline
data scan capability to minimize time data spends on disk from write dedupe automatically as required. It uses an incremental data scan
to dedupe. capability to minimize memory usage and dedupe new data soon after it
appears in the filesystem.
Strengths Strengths
--------- ---------
@ -17,23 +18,23 @@ Strengths
* Space-efficient hash table and matching algorithms - can use as little as 1 GB hash table per 10 TB unique data (0.1GB/TB) * Space-efficient hash table and matching algorithms - can use as little as 1 GB hash table per 10 TB unique data (0.1GB/TB)
* Daemon incrementally dedupes new data using btrfs tree search * Daemon incrementally dedupes new data using btrfs tree search
* Works with btrfs compression - dedupe any combination of compressed and uncompressed files * Works with btrfs compression - dedupe any combination of compressed and uncompressed files
* **NEW** [Works around `btrfs send` problems with dedupe and incremental parent snapshots](options.md) * Works around btrfs filesystem structure issues to free more disk space than generic dedupe tools
* Works around btrfs filesystem structure to free more disk space * Persistent hash table and checkpoint for rapid restart after shutdown
* Persistent hash table for rapid restart after shutdown
* Whole-filesystem dedupe - including snapshots * Whole-filesystem dedupe - including snapshots
* Constant hash table size - no increased RAM usage if data set becomes larger * Constant hash table size - no increased RAM usage if data set becomes larger
* Works on live data - no scheduled downtime required * Works on live data - no scheduled downtime required
* Automatic self-throttling based on system load * Automatic self-throttling based on system load
* Low memory footprint (excluding the hash table)
Weaknesses Weaknesses
---------- ----------
* Whole-filesystem dedupe - has no include/exclude filters, does not accept file lists * Whole-filesystem dedupe - has no include/exclude filters, does not accept file lists, terminates only when explicitly requested
* Requires root privilege (or `CAP_SYS_ADMIN`) * Requires root privilege (or `CAP_SYS_ADMIN`) to work
* First run may require temporary disk space for extent reorganization * First run may require temporary disk space for extent reorganization
* [First run may increase metadata space usage if many snapshots exist](gotchas.md) * [First run may increase metadata space usage if many snapshots exist](gotchas.md)
* Constant hash table size - no decreased RAM usage if data set becomes smaller * Constant hash table size - no decreased RAM usage if data set becomes smaller
* btrfs only * btrfs only (bcachefs and xfs are missing various features)
Installation and Usage Installation and Usage
---------------------- ----------------------
@ -70,6 +71,6 @@ You can also use Github:
Copyright & License Copyright & License
------------------- -------------------
Copyright 2015-2022 Zygo Blaxell <bees@furryterror.org>. Copyright 2015-2023 Zygo Blaxell <bees@furryterror.org>.
GPL (version 3 or later). GPL (version 3 or later).