aboutsummaryrefslogtreecommitdiffstats
path: root/README-maintainer
diff options
context:
space:
mode:
authorJay Berkenbilt <ejb@ql.org>2020-10-22 11:11:36 +0200
committerJay Berkenbilt <ejb@ql.org>2020-10-22 11:11:36 +0200
commit6cc9489fd85fe0b89a06ef73ab0186d1e6e026c0 (patch)
tree6f74c50708ef7c1c09f7646a2605363093e427fc /README-maintainer
parent956c8f643219778c445d7062d1d0e7e3b96c7676 (diff)
downloadqpdf-6cc9489fd85fe0b89a06ef73ab0186d1e6e026c0.tar.zst
Update fuzz information
Diffstat (limited to 'README-maintainer')
-rw-r--r--README-maintainer17
1 files changed, 11 insertions, 6 deletions
diff --git a/README-maintainer b/README-maintainer
index 3eda6e63..d8c0bc73 100644
--- a/README-maintainer
+++ b/README-maintainer
@@ -33,6 +33,11 @@ GOOGLE OSS-FUZZ
* qpdf project: https://github.com/google/oss-fuzz/tree/master/projects/qpdf
+* Adding new test cases: download the file from oss-fuzz and drop it
+ in fuzz/qpdf_extra/issue-number.fuzz. If not ready to include, it
+ can be stored anywhere, and the absolute path can be passed to the
+ reproduction code as described below.
+
* To test locally, see https://github.com/google/oss-fuzz/tree/master/docs/,
especially new_project_guide.md. Summary:
@@ -41,15 +46,15 @@ GOOGLE OSS-FUZZ
Add `-e GITHUB_FORK=fork -e GITHUB_BRANCH=branch` to build_fuzzers
from a qpdf fork/branch rather than qpdf/master.
- python infra/helper.py build_image --pull qpdf
- python infra/helper.py build_fuzzers [ --sanitizer memory|undefined|address ] qpdf
- python infra/helper.py check_build qpdf
- python infra/helper.py build_fuzzers --sanitizer coverage qpdf
- python infra/helper.py coverage qpdf
+ python3 infra/helper.py build_image --pull qpdf
+ python3 infra/helper.py build_fuzzers [ --sanitizer memory|undefined|address ] qpdf
+ python3 infra/helper.py check_build qpdf
+ python3 infra/helper.py build_fuzzers --sanitizer coverage qpdf
+ python3 infra/helper.py coverage qpdf
To reproduce a test case, build with the correct sanitizer, then run
- python infra/helper.py reproduce qpdf fuzzer testcase
+ python3 infra/helper.py reproduce qpdf <specific-fuzzer> testcase
where fuzzer is the fuzzer used in the crash.