changeset 36698:e437de3881c1 draft

fuzz: add some more docs about building/running fuzzers Differential Revision: https://phab.mercurial-scm.org/D2635
author Augie Fackler <augie@google.com>
date Sun, 04 Mar 2018 09:40:12 -0500
parents aa9c5d447980
children d77c3b023393
files contrib/fuzz/README.rst
diffstat 1 files changed, 12 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/contrib/fuzz/README.rst	Sun Mar 04 11:49:33 2018 -0500
+++ b/contrib/fuzz/README.rst	Sun Mar 04 09:40:12 2018 -0500
@@ -10,5 +10,17 @@
   7) ln -s /hg-new mercurial
   8) cd mercurial
   9) compile
+  10) ls $OUT
+
+Step 9 is literally running the command "compile", which is part of
+the docker container. Once you have that working, you can build the
+fuzzers like this (in the oss-fuzz repo):
+
+python infra/helper.py build_fuzzers --sanitizer address mercurial $HG_REPO_PATH
+
+(you can also say "memory", "undefined" or "coverage" for
+sanitizer). Then run the built fuzzers like this:
+
+python infra/helper.py run_fuzzer mercurial -- $FUZZER
 
 0: https://github.com/google/oss-fuzz/blob/master/docs/new_project_guide.md