oss-fuzz/docs/clusterfuzz.md

43 lines
1.5 KiB
Markdown
Raw Normal View History

# ClusterFuzz
2016-11-18 20:32:51 +00:00
[ClusterFuzz](https://blog.chromium.org/2012/04/fuzzing-for-security.html) is the distributed fuzzing infrastructure behind OSS-Fuzz. It was initially built
2016-11-18 20:05:42 +00:00
for fuzzing Chrome at scale.
## Web interface
2016-11-18 20:10:52 +00:00
ClusterFuzz also provides a [web interface](https://clusterfuzz-external.appspot.com/v2)
2016-11-30 16:29:19 +00:00
to view statistics about your fuzz targets, as well as current crashes.
2016-11-29 19:36:05 +00:00
*Note*: This is a work in progress. Access is restricted to project developers who we auto CC on new bug
reports.
## Fuzzer stats
2016-11-30 16:29:19 +00:00
You can view statistics about your fuzz targets (e.g. speed, coverage information,
2016-11-18 20:05:42 +00:00
memory usage) on our fuzzer statistics dashboard.
![stats]
(https://raw.githubusercontent.com/google/oss-fuzz/master/docs/images/freetype_stats.png)
## Coverage reports
2016-11-18 20:01:58 +00:00
We also provide coverage reports, where we highlight the parts of source code that are being
2016-11-30 16:29:19 +00:00
reached by your fuzz target.
![coverage_1]
(https://raw.githubusercontent.com/google/oss-fuzz/master/docs/images/freetype_coverage_1.png)
![coverage_2]
(https://raw.githubusercontent.com/google/oss-fuzz/master/docs/images/freetype_coverage_2.png)
## Testcase reports
ClusterFuzz will automatically de-duplicate and file reproducible crashes into
our [bug tracker](https://bugs.chromium.org/p/monorail). We provide a crash
report page that gives you the stack trace, a link to the crashing testcase, and
regression ranges where the bug was most likely introduced.
![report]
(https://raw.githubusercontent.com/google/oss-fuzz/master/docs/images/pcre2_testcase.png)