From 1c2e450660884c4c599e617d8203fb66eef7e117 Mon Sep 17 00:00:00 2001 From: Julien Cretin Date: Thu, 12 Nov 2020 16:24:35 +0100 Subject: [PATCH] Improve documentation --- libraries/persistent_store/fuzz/src/lib.rs | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/libraries/persistent_store/fuzz/src/lib.rs b/libraries/persistent_store/fuzz/src/lib.rs index 3f45620..1feeabc 100644 --- a/libraries/persistent_store/fuzz/src/lib.rs +++ b/libraries/persistent_store/fuzz/src/lib.rs @@ -30,6 +30,12 @@ /// Bit-level entropy source based on a byte slice shared reference. /// +/// This is used to convert the byte slice provided by the fuzzer into the entropy used by the +/// fuzzing code to generate a sequence of store manipulations, among other things. Entropy +/// operations use the shortest necessary sequence of bits from the byte slice, such that fuzzer +/// mutations of the byte slice have local impact or cascading effects towards future operations +/// only. +/// /// The entropy has the following properties (in order of precedence): /// - It always returns a result. /// - It is deterministic: for a given slice and a given sequence of operations, the same results