blob: 6bc8be4953c2a9cefbeb08e080c7a210a820f2ed [file] [log] [blame] [view]
inferno-chromiuma660ca32016-11-23 08:35:07 -08001# OSS-Fuzz - Continuous Fuzzing for Open Source Software
Mike Aizatsky3986fa32016-09-14 09:44:10 -07002
Kostya Serebryany1250af62016-11-21 13:48:02 -08003## Introduction
Mike Aizatsky8f24df72016-10-25 14:31:45 -07004
5[Fuzz testing](https://en.wikipedia.org/wiki/Fuzz_testing) is a well-known
Kostya Serebryanyb2f73b22016-11-18 16:50:54 -08006technique for uncovering various kinds of programming errors in software.
inferno-chromiuma660ca32016-11-23 08:35:07 -08007Many of these detectable errors (e.g. [buffer overflow](https://en.wikipedia.org/wiki/Buffer_overflow)) can have serious security implications.
Mike Aizatsky8f24df72016-10-25 14:31:45 -07008
jonathanmetzman9a6cb172019-02-07 17:54:49 -08009We successfully deployed
Kostya Serebryanyb48c72b2016-11-18 16:47:25 -080010[guided in-process fuzzing of Chrome components](https://security.googleblog.com/2016/08/guided-in-process-fuzzing-of-chrome.html)
inferno-chromiuma660ca32016-11-23 08:35:07 -080011and found [hundreds](https://bugs.chromium.org/p/chromium/issues/list?can=1&q=label%3AStability-LibFuzzer+-status%3ADuplicate%2CWontFix) of security vulnerabilities and stability bugs. We now want to share the experience and the service with the open source community.
Mike Aizatsky8f24df72016-10-25 14:31:45 -070012
inferno-chromiuma660ca32016-11-23 08:35:07 -080013In cooperation with the [Core Infrastructure Initiative](https://www.coreinfrastructure.org/),
14OSS-Fuzz aims to make common open source software more secure and stable by
Kostya Serebryanyb48c72b2016-11-18 16:47:25 -080015combining modern fuzzing techniques and scalable
16distributed execution.
17
Florian Mayer834c12d2018-12-11 22:31:51 +000018We support [libFuzzer](http://llvm.org/docs/LibFuzzer.html) and [AFL](http://lcamtuf.coredump.cx/afl/) as fuzzing engines
19in combination with [Sanitizers](https://github.com/google/sanitizers).
Abhishek Aryacf4af862019-08-07 07:37:16 -070020[ClusterFuzz](https://google.github.io/oss-fuzz/furthur-reading/clusterfuzz)
jonathanmetzman9a6cb172019-02-07 17:54:49 -080021provides a distributed fuzzer execution environment and reporting. You can
22checkout ClusterFuzz [here](https://github.com/google/clusterfuzz).
Mike Aizatsky8f24df72016-10-25 14:31:45 -070023
Kostya Serebryany229ffae2016-12-02 20:41:47 -080024Currently OSS-Fuzz supports C and C++ code (other languages supported by [LLVM](http://llvm.org) may work too).
25
Abhishek Aryacf4af862019-08-07 07:37:16 -070026## Documentation
27You can find detailed documentation [here](https://google.github.io/oss-fuzz).
Max Morozaa9c2572018-12-11 13:56:48 -080028
Oliver Chang9e0c1432016-10-25 20:44:34 -070029## Trophies
Abhishek Aryacf4af862019-08-07 07:37:16 -070030As of August 2019, OSS-Fuzz has found [~14,000] bugs in over [200] open source
31projects.
Mike Aizatsky26819642016-10-06 14:02:52 -070032
Abhishek Aryacf4af862019-08-07 07:37:16 -070033[~14,000]: https://bugs.chromium.org/p/oss-fuzz/issues/list?can=1&q=-status%3AWontFix%2CDuplicate+-Infra
34[200]: https://github.com/google/oss-fuzz/tree/master/projects
Mike Aizatsky26819642016-10-06 14:02:52 -070035
Abhishek Aryacf4af862019-08-07 07:37:16 -070036## Blog posts
37
38* 2016-12-01 ([1](https://opensource.googleblog.com/2016/12/announcing-oss-fuzz-continuous-fuzzing.html),
39[2](https://testing.googleblog.com/2016/12/announcing-oss-fuzz-continuous-fuzzing.html),
40[3](https://security.googleblog.com/2016/12/announcing-oss-fuzz-continuous-fuzzing.html))
41* 2017-05-08 ([1](https://opensource.googleblog.com/2017/05/oss-fuzz-five-months-later-and.html),
42[2](https://testing.googleblog.com/2017/05/oss-fuzz-five-months-later-and.html),
43[3](https://security.googleblog.com/2017/05/oss-fuzz-five-months-later-and.html))
44* 2018-11-06 ([1](https://security.googleblog.com/2018/11/a-new-chapter-for-oss-fuzz.html))
45
46