| 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. |
| Max Moroz | 40a183b | 2019-08-09 12:35:14 -0700 | [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 [thousands] 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), |
| kplybon | d8af01c | 2019-08-09 15:24:43 -0400 | [diff] [blame] | 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 | |
| Max Moroz | 40a183b | 2019-08-09 12:35:14 -0700 | [diff] [blame] | 8 | [thousands]: https://bugs.chromium.org/p/chromium/issues/list?q=label%3AStability-LibFuzzer%2CStability-AFL%20-status%3ADuplicate%2CWontFix&can=1 |
| 9 | |
| inferno-chromium | a660ca3 | 2016-11-23 08:35:07 -0800 | [diff] [blame] | 10 | In cooperation with the [Core Infrastructure Initiative](https://www.coreinfrastructure.org/), |
| 11 | 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] | 12 | combining modern fuzzing techniques with scalable, |
| Kostya Serebryany | b48c72b | 2016-11-18 16:47:25 -0800 | [diff] [blame] | 13 | distributed execution. |
| 14 | |
| kplybon | 8216f27 | 2019-08-08 10:12:25 -0400 | [diff] [blame] | 15 | We support the [libFuzzer](http://llvm.org/docs/LibFuzzer.html) and [AFL](http://lcamtuf.coredump.cx/afl/) fuzzing engines |
| 16 | in combination with [Sanitizers](https://github.com/google/sanitizers), as well as |
| 17 | [ClusterFuzz](https://github.com/google/clusterfuzz), |
| 18 | a distributed fuzzer execution environment and reporting tool. |
| Mike Aizatsky | 8f24df7 | 2016-10-25 14:31:45 -0700 | [diff] [blame] | 19 | |
| kplybon | 8216f27 | 2019-08-08 10:12:25 -0400 | [diff] [blame] | 20 | 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] | 21 | |
| kplybon | 8216f27 | 2019-08-08 10:12:25 -0400 | [diff] [blame] | 22 | ## Overview |
| 23 |  |
| 24 | |
| kplybon | 615ff3a | 2019-08-08 10:36:35 -0400 | [diff] [blame] | 25 | ## Documentation |
| kplybon | 8216f27 | 2019-08-08 10:12:25 -0400 | [diff] [blame] | 26 | 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] | 27 | |
| Oliver Chang | 9e0c143 | 2016-10-25 20:44:34 -0700 | [diff] [blame] | 28 | ## Trophies |
| Abhishek Arya | 3433d12 | 2019-08-16 23:38:26 -0700 | [diff] [blame^] | 29 | As of August 2019, OSS-Fuzz has found over [14,000] bugs in [200] open source projects. |
| Mike Aizatsky | 2681964 | 2016-10-06 14:02:52 -0700 | [diff] [blame] | 30 | |
| Abhishek Arya | 055f983 | 2019-08-15 15:07:23 -0700 | [diff] [blame] | 31 | [14,000]: https://bugs.chromium.org/p/oss-fuzz/issues/list?can=1&q=-status%3AWontFix%2CDuplicate+-Infra |
| Abhishek Arya | cf4af86 | 2019-08-07 07:37:16 -0700 | [diff] [blame] | 32 | [200]: https://github.com/google/oss-fuzz/tree/master/projects |
| Mike Aizatsky | 2681964 | 2016-10-06 14:02:52 -0700 | [diff] [blame] | 33 | |
| Abhishek Arya | cf4af86 | 2019-08-07 07:37:16 -0700 | [diff] [blame] | 34 | ## Blog posts |
| 35 | |
| Abhishek Arya | 305e047 | 2019-08-15 15:08:51 -0700 | [diff] [blame] | 36 | * 2016-12-01 - [Announcing OSS-Fuzz: Continuous fuzzing for open source software](https://opensource.googleblog.com/2016/12/announcing-oss-fuzz-continuous-fuzzing.html) |
| Abhishek Arya | 055f983 | 2019-08-15 15:07:23 -0700 | [diff] [blame] | 37 | * 2017-05-08 - [OSS-Fuzz: Five months later, and rewarding projects](https://opensource.googleblog.com/2017/05/oss-fuzz-five-months-later-and.html) |
| 38 | * 2018-11-06 - [A New Chapter for OSS-Fuzz](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] | 39 | |
| 40 | |