From e9621ead4c28af5791c9fb0ac42229faf075f19d Mon Sep 17 00:00:00 2001 From: Andrea Mazzoleni Date: Fri, 4 Sep 2026 09:58:58 +0200 Subject: [PATCH] Clarify cache policy and usage of streaming hint in raid_gen() --- raid/raid.h | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/raid/raid.h b/raid/raid.h index e3b0fe69..f8a7f94d 100644 --- a/raid/raid.h +++ b/raid/raid.h @@ -202,6 +202,10 @@ int raid_selftest(void); * Entries may point to the same block buffer. * @streaming Store policy hint: nonzero for streaming / non-temporal stores * (bypassing cache) where supported, or 0 for normal cached / temporal stores. + * Use nonzero when generated output will not be read immediately by the CPU + * (e.g., parity queued for disk writes during sync), avoiding cache pollution. + * Use 0 when output will be consumed immediately by the CPU (e.g., in-memory + * parity verification or single-disk data recovery). * Both modes produce bit-identical parity data. Backends without streaming * stores ignore this hint. */