Skip to content

Commit 8fe001d

Browse files
committed
doc: Updates how to reproduce fuzz CI failure locally
The current version of the doc does not explain how to reproduce a recent fuzzing CI failure (not yet part of the corpora). Add instructions on how to manually create a crash file based on a report.
1 parent e1dfa4f commit 8fe001d

File tree

1 file changed

+7
-0
lines changed

1 file changed

+7
-0
lines changed

doc/fuzzing.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -136,6 +136,13 @@ Patience is useful; even with improved throughput, libFuzzer may need days and
136136
- run the fuzzer with the case number appended to the seed corpus path:
137137
`FUZZ=process_message build_fuzz/bin/fuzz
138138
qa-assets/fuzz_corpora/process_message/1bc91feec9fc00b107d97dc225a9f2cdaa078eb6`
139+
- If the file does not exist, make sure you are checking out the exact same commit id
140+
for the qa-assets repo. If the file was found while running the fuzz engine in the CI,
141+
you should be able to reproduce the crash locally with the same (or a similar input)
142+
within a few minutes. Alternatively, you can use the base64 encoded file from the CI log,
143+
if it exists. e.g.
144+
`echo "Nb6Fc/97AACAAAD/ewAAgAAAAIAAAACAAAAAoA==" |
145+
base64 --decode > qa-assets/fuzz_corpora/process_message/1bc91feec9fc00b107d97dc225a9f2cdaa078eb6`
139146
140147
## Submit improved coverage
141148

0 commit comments

Comments
 (0)