Skip to content

Commit c9ec818

Browse files
(@silopolis)kdave
authored andcommitted
btrfs-progs: docs: auto-repair editing
1 parent e61a0da commit c9ec818

File tree

1 file changed

+13
-11
lines changed

1 file changed

+13
-11
lines changed

Documentation/Auto-repair.rst

Lines changed: 13 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,16 @@
11
Auto-repair on read
22
===================
33

4-
Data or metadata that are found to be damaged (e.g. because the checksum does
5-
not match) at the time they're read from a device can be salvaged in case the
6-
filesystem has another valid copy when using block group profile with redundancy
7-
(DUP, RAID1-like, RAID5/6). The correct data are returned to the user application
8-
and the damaged copy is replaced by it. When this happen a message is emitted
9-
to the system log.
10-
11-
If there are more copies of data and one of them is damaged but not read by
12-
user application then this is not detected. To verify all data and metadata
13-
copies there's :doc:`scrub<Scrub>` that needs to be started manually, automatic
14-
repairs happens in that case.
4+
If data or metadata that are found to be damaged at the time they’re read from a device,
5+
for example because the checksum does not match, they can be salvaged if the filesystem
6+
has another valid copy. This can be achieved by using a block group profile with redundancy
7+
like DUP, RAID1-like, or RAID5/6.
8+
9+
The correct data is returned to the user application and the damaged copy is replaced by it.
10+
When this happens, a message is emitted to the system log.
11+
12+
If there are multiple copies of data and one of them is damaged but not read by the user
13+
application, then this is not detected.
14+
15+
To ensure the verification and automatic repair of all data and metadata copies, the
16+
:doc:`scrub<Scrub>` operation must be initiated manually.

0 commit comments

Comments
 (0)