Skip to content

Commit 68c1027

Browse files
committed
btrfs-progs: docs: add zone reclaim
[ci skip] Issue: #768 Signed-off-by: David Sterba <dsterba@suse.com>
1 parent 582cb01 commit 68c1027

File tree

1 file changed

+14
-0
lines changed

1 file changed

+14
-0
lines changed

Documentation/ch-zoned-intro.rst

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -66,6 +66,20 @@ is 8GiB, which would mean that e.g. offset 0-16GiB would be reserved just for
6666
the super block on a hypothetical device of that zone size. This is wasteful
6767
but required to guarantee crash safety.
6868

69+
Zone reclaim, garbage collection
70+
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
71+
72+
As the zones are append-only, overwriting data or COW changes in metadata
73+
make parts of the zones used but not connected to the filesystem structures.
74+
This makes the space unusable and grows over time. Once the ratio hits a
75+
(configurable) threshold a background reclaim process is started and relocates
76+
the remaining blocks in use to a new zone. The old one is reset and can be used
77+
again.
78+
79+
This process may take some time depending on other background work or
80+
amount of new data written. It is possible to hit an intermittent ENOSPC.
81+
Some devices also limit number of active zones.
82+
6983
Devices
7084
^^^^^^^
7185

0 commit comments

Comments
 (0)