| kplybon | 8216f27 | 2019-08-08 10:12:25 -0400 | [diff] [blame] | 1 | # OSS-Fuzz: Continuous Fuzzing for Open Source Software |
| Mike Aizatsky | 8f24df7 | 2016-10-25 14:31:45 -0700 | [diff] [blame] | 2 | |
| 3 | [Fuzz testing](https://en.wikipedia.org/wiki/Fuzz_testing) is a well-known |
| kplybon | 8216f27 | 2019-08-08 10:12:25 -0400 | [diff] [blame] | 4 | technique for uncovering programming errors in software. |
| kplybon | d8af01c | 2019-08-09 15:24:43 -0400 | [diff] [blame^] | 5 | Many of these detectable errors, like [buffer overflow](https://en.wikipedia.org/wiki/Buffer_overflow), can have serious security implications. Google has 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 by deploying [guided in-process fuzzing of Chrome components](https://security.googleblog.com/2016/08/guided-in-process-fuzzing-of-chrome.html), |
| 6 | and we now want to share that service with the open source community. |
| Mike Aizatsky | 8f24df7 | 2016-10-25 14:31:45 -0700 | [diff] [blame] | 7 | |
| inferno-chromium | a660ca3 | 2016-11-23 08:35:07 -0800 | [diff] [blame] | 8 | In cooperation with the [Core Infrastructure Initiative](https://www.coreinfrastructure.org/), |
| 9 | OSS-Fuzz aims to make common open source software more secure and stable by |
| kplybon | 8216f27 | 2019-08-08 10:12:25 -0400 | [diff] [blame] | 10 | combining modern fuzzing techniques with scalable, |
| Kostya Serebryany | b48c72b | 2016-11-18 16:47:25 -0800 | [diff] [blame] | 11 | distributed execution. |
| 12 | |
| kplybon | 8216f27 | 2019-08-08 10:12:25 -0400 | [diff] [blame] | 13 | We support the [libFuzzer](http://llvm.org/docs/LibFuzzer.html) and [AFL](http://lcamtuf.coredump.cx/afl/) fuzzing engines |
| 14 | in combination with [Sanitizers](https://github.com/google/sanitizers), as well as |
| 15 | [ClusterFuzz](https://github.com/google/clusterfuzz), |
| 16 | a distributed fuzzer execution environment and reporting tool. |
| Mike Aizatsky | 8f24df7 | 2016-10-25 14:31:45 -0700 | [diff] [blame] | 17 | |
| kplybon | 8216f27 | 2019-08-08 10:12:25 -0400 | [diff] [blame] | 18 | Currently, OSS-Fuzz supports C and C++ code, though other languages supported by [LLVM](http://llvm.org) may work too. |
| Kostya Serebryany | 229ffae | 2016-12-02 20:41:47 -0800 | [diff] [blame] | 19 | |
| kplybon | 8216f27 | 2019-08-08 10:12:25 -0400 | [diff] [blame] | 20 | ## Overview |
| 21 |  |
| 22 | |
| kplybon | 615ff3a | 2019-08-08 10:36:35 -0400 | [diff] [blame] | 23 | ## Documentation |
| kplybon | 8216f27 | 2019-08-08 10:12:25 -0400 | [diff] [blame] | 24 | Read our [detailed documentation](https://google.github.io/oss-fuzz) to learn how to use OSS-Fuzz. |
| Max Moroz | aa9c257 | 2018-12-11 13:56:48 -0800 | [diff] [blame] | 25 | |
| Oliver Chang | 9e0c143 | 2016-10-25 20:44:34 -0700 | [diff] [blame] | 26 | ## Trophies |
| Abhishek Arya | cf4af86 | 2019-08-07 07:37:16 -0700 | [diff] [blame] | 27 | As of August 2019, OSS-Fuzz has found [~14,000] bugs in over [200] open source |
| 28 | projects. |
| Mike Aizatsky | 2681964 | 2016-10-06 14:02:52 -0700 | [diff] [blame] | 29 | |
| Abhishek Arya | cf4af86 | 2019-08-07 07:37:16 -0700 | [diff] [blame] | 30 | [~14,000]: https://bugs.chromium.org/p/oss-fuzz/issues/list?can=1&q=-status%3AWontFix%2CDuplicate+-Infra |
| 31 | [200]: https://github.com/google/oss-fuzz/tree/master/projects |
| Mike Aizatsky | 2681964 | 2016-10-06 14:02:52 -0700 | [diff] [blame] | 32 | |
| Abhishek Arya | cf4af86 | 2019-08-07 07:37:16 -0700 | [diff] [blame] | 33 | ## Blog posts |
| 34 | |
| kplybon | 615ff3a | 2019-08-08 10:36:35 -0400 | [diff] [blame] | 35 | * 2016-12-01 ([Open Source](https://opensource.googleblog.com/2016/12/announcing-oss-fuzz-continuous-fuzzing.html), |
| 36 | [Testing](https://testing.googleblog.com/2016/12/announcing-oss-fuzz-continuous-fuzzing.html), |
| 37 | [Security](https://security.googleblog.com/2016/12/announcing-oss-fuzz-continuous-fuzzing.html)) |
| 38 | * 2017-05-08 ([Open Source](https://opensource.googleblog.com/2017/05/oss-fuzz-five-months-later-and.html), |
| 39 | [Testing](https://testing.googleblog.com/2017/05/oss-fuzz-five-months-later-and.html), |
| 40 | [Security](https://security.googleblog.com/2017/05/oss-fuzz-five-months-later-and.html)) |
| 41 | * 2018-11-06 ([Security](https://security.googleblog.com/2018/11/a-new-chapter-for-oss-fuzz.html)) |
| Abhishek Arya | cf4af86 | 2019-08-07 07:37:16 -0700 | [diff] [blame] | 42 | |
| 43 | |