Correct raid_scan documentation on candidate search and return semantics

This commit is contained in:
Andrea Mazzoleni 2026-08-20 20:56:48 +02:00
parent ecb26a6aee
commit e5ca862a37
2 changed files with 17 additions and 6 deletions

View file

@ -62,9 +62,12 @@ detect CPU capabilities and initialize mode dispatch.
int raid_scan(int *ir, int nd, int np, size_t size, void **v)
Searches for up to 'np - 1' failed blocks using available redundancy.
Each block pointed to by 'v' must be aligned to a 64-byte boundary.
Fills 'ir' with failed block indexes and returns the number of failures
found (0 if no error), or -1 if failed blocks cannot be uniquely located.
Candidates are tested with an increasing number of failures, and the
first combination matching the redundancy is returned. If multiple
combinations match, the first one encountered is returned without
checking uniqueness. Each block pointed to by 'v' must be aligned to a
64-byte boundary. Fills 'ir' with the matching block indexes and returns
their number (0 if no error), or -1 if no compatible combination is found.
int raid_selftest(void)
Runs startup verification tests for parity generation, recovery, and