File tree 1 file changed +33
-1
lines changed
1 file changed +33
-1
lines changed Original file line number Diff line number Diff line change 1
1
# qa-assets
2
- Bitcoin Core related blobs used for quality assurance
2
+
3
+ Bitcoin Core related blobs used for quality assurance.
4
+
5
+ ## Fuzz inputs
6
+
7
+ ` qa-assets/fuzz_seed_corpus ` contains one input corpus per fuzz target (one
8
+ folder per target named the same as each target).
9
+
10
+ ### Contributing inputs
11
+
12
+ * For documentation on how to fuzz Bitcoin Core please see
13
+ [ fuzzing.md] ( https://github.com/bitcoin/bitcoin/blob/master/doc/fuzzing.md ) .*
14
+
15
+ If you want to contribute fuzz inputs, please "merge" the inputs before
16
+ submitting a pull request. You can use the libFuzzer option ` -merge=1 `
17
+ (recommended with ` -use_value_profile=1 ` ) or the ` --m_dir ` option of the fuzz
18
+ runner:
19
+ [ ` test_runner.py ` ] ( https://github.com/bitcoin/bitcoin/blob/master/test/fuzz/test_runner.py ) .
20
+
21
+ ### Pruning non-reduced inputs
22
+
23
+ Over time fuzz engines reduce inputs (produce a smaller input that yields the
24
+ same coverage statistics). This causes our copora to accumulate larger
25
+ non-reduced inputs.
26
+
27
+ To avoid corpora bloat and potential CI timeouts, we usually prune/minimize our
28
+ copora around the branch-off point using the
29
+ [ ` delete_nonreduced_fuzz_inputs.sh ` ] ( https://raw.githubusercontent.com/bitcoin-core/bitcoin-maintainer-tools/main/delete_nonreduced_fuzz_inputs.sh )
30
+ script (Recommended to run in a fresh VM, see documentation in the script).
31
+
32
+ ### Pulling inputs from oss-fuzz
33
+
34
+ Use ` download_oss_fuzz_inputs.py ` to pull fuzz inputs from oss-fuzz.
You can’t perform that action at this time.
0 commit comments