RepoMirrors
/
btrfs-progs
mirror of https://github.com/kdave/btrfs-progs
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

btrfs-progs: docs: add zone reclaim 

[ci skip]

Issue: #768
Signed-off-by: David Sterba <dsterba@suse.com>
This commit is contained in:
David Sterba 2024-07-30 18:14:25 +02:00
parent 42dad5ea65
commit fca2fe3316
1 changed files with 14 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
Documentation/ch-zoned-intro.rst
View File

@ -66,6 +66,20 @@ is 8GiB, which would mean that e.g. offset 0-16GiB would be reserved just for
the super block on a hypothetical device of that zone size. This is wasteful
but required to guarantee crash safety.
Zone reclaim, garbage collection
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
As the zones are append-only, overwriting data or COW changes in metadata
make parts of the zones used but not connected to the filesystem structures.
This makes the space unusable and grows over time. Once the ratio hits a
(configurable) threshold a background reclaim process is started and relocates
the remaining blocks in use to a new zone. The old one is reset and can be used
again.
This process may take some time depending on other background work or
amount of new data written. It is possible to hit an intermittent ENOSPC.
Some devices also limit number of active zones.
Devices
^^^^^^^