Patchwork D2635: fuzz: add some more docs about building/running fuzzers

login
register
mail settings
Submitter phabricator
Date March 4, 2018, 2:40 p.m.
Message ID <differential-rev-PHID-DREV-mfru5v4odgf6zte7ties-req@phab.mercurial-scm.org>
Download mbox | patch
Permalink /patch/28913/
State Superseded
Headers show

Comments

phabricator - March 4, 2018, 2:40 p.m.
durin42 created this revision.
Herald added a subscriber: mercurial-devel.
Herald added a reviewer: hg-reviewers.

REPOSITORY
  rHG Mercurial

REVISION DETAIL
  https://phab.mercurial-scm.org/D2635

AFFECTED FILES
  contrib/fuzz/README.rst

CHANGE DETAILS




To: durin42, #hg-reviewers
Cc: mercurial-devel

Patch

diff --git a/contrib/fuzz/README.rst b/contrib/fuzz/README.rst
--- a/contrib/fuzz/README.rst
+++ b/contrib/fuzz/README.rst
@@ -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