Return to README CVS log

Up to [cvsweb.bsd.lv] / texi2mdoc / afl

Have Makefile install source as 0644 (thanks Sviatoslav Mishyn!) and add
some AFL instructions and another test case.

$Id: README,v 1.1 2015/02/26 10:43:25 kristaps Exp $

This is the AFL test directory for texi2mdoc, http://mdocml.bsd.lv/texi2mdoc.

First, you'll need the AFL system, http://lcamtuf.coredump.cx/afl/.

Next, you'll need to compile texi2mdoc with the AFL bindings.  You can do this
from the top-level texi2mdoc directory as follows:

 % cd ..
 % make clean && make texi2mdoc CC=afl-clang
 % cp texi2mdoc afl
 % cd afl

(You may need to invoke afl-gcc instead of afl-clang.)

Next, you'll want to build the dictionary of Texinfo terms:

 % sh ./mkdict.sh

Finally, run the instrumentation itself.

 % afl-fuzz -i in -o out -x dict -- ./texi2mdoc @@

See the AFL website for details on how to exercise multiple cores and so on.