X-Git-Url: http://git.ipfire.org/?a=blobdiff_plain;f=docs%2FHACKING.md;h=a86a6f21725b5d18f9cbbea3eb6db6f05266ad46;hb=6b000af4f206a87f424f05c163ea818b142e372e;hp=7dc1eb98cbaf91134fb2ef4db6b6f4efbc853656;hpb=349a6b3534df95ad555b9a12a6243ce93fc9296c;p=thirdparty%2Fsystemd.git diff --git a/docs/HACKING.md b/docs/HACKING.md index 7dc1eb98cba..a86a6f21725 100644 --- a/docs/HACKING.md +++ b/docs/HACKING.md @@ -1,5 +1,7 @@ --- title: Hacking on systemd +category: Contributing +layout: default --- # Hacking on systemd @@ -96,7 +98,7 @@ Happy hacking! ## Fuzzers systemd includes fuzzers in `src/fuzz/` that use libFuzzer and are automatically -run by [OSS-Fuzz](https://github.com/google/oss-fuzz) and [Fuzzit](https://fuzzit.dev) with sanitizers. +run by [OSS-Fuzz](https://github.com/google/oss-fuzz) with sanitizers. To add a fuzz target, create a new `src/fuzz/fuzz-foo.c` file with a `LLVMFuzzerTestOneInput` function and add it to the list in `src/fuzz/meson.build`. @@ -116,16 +118,10 @@ python infra/helper.py build_fuzzers --sanitizer memory systemd ../systemd python infra/helper.py run_fuzzer systemd fuzz-foo ``` -When you add a new target you should also add the target on [Fuzzit](https://app.fuzzit.dev/admin/RxqRpGNXquIvqrmp4iJS/dashboard) - (Please ask someone with permissions). One the target is configured on Fuzzit you need to add it to - `travis-ci/managers/fuzzit.sh` so the new target will run sanity tests on every pull-request and periodic fuzzing jobs. - If you find a bug that impacts the security of systemd, please follow the guidance in [CONTRIBUTING.md](CONTRIBUTING.md) on how to report a security vulnerability. For more details on building fuzzers and integrating with OSS-Fuzz, visit: -- https://github.com/google/oss-fuzz/blob/master/docs/new_project_guide.md -- https://llvm.org/docs/LibFuzzer.html -- https://github.com/google/fuzzer-test-suite/blob/master/tutorial/libFuzzerTutorial.md -- https://chromium.googlesource.com/chromium/src/testing/libfuzzer/+/HEAD/efficient_fuzzer.md +- [Setting up a new project - OSS-Fuzz](https://google.github.io/oss-fuzz/getting-started/new-project-guide/) +- [Tutorials - OSS-Fuzz](https://google.github.io/oss-fuzz/reference/useful-links/#tutorials)