summaryrefslogtreecommitdiffstats
path: root/src/fluent-bit/lib/monkey/FUZZ.md
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-05-05 12:08:03 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-05-05 12:08:18 +0000
commit5da14042f70711ea5cf66e034699730335462f66 (patch)
tree0f6354ccac934ed87a2d555f45be4c831cf92f4a /src/fluent-bit/lib/monkey/FUZZ.md
parentReleasing debian version 1.44.3-2. (diff)
downloadnetdata-5da14042f70711ea5cf66e034699730335462f66.tar.xz
netdata-5da14042f70711ea5cf66e034699730335462f66.zip
Merging upstream version 1.45.3+dfsg.
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'src/fluent-bit/lib/monkey/FUZZ.md')
-rw-r--r--src/fluent-bit/lib/monkey/FUZZ.md33
1 files changed, 33 insertions, 0 deletions
diff --git a/src/fluent-bit/lib/monkey/FUZZ.md b/src/fluent-bit/lib/monkey/FUZZ.md
new file mode 100644
index 000000000..9074cdfac
--- /dev/null
+++ b/src/fluent-bit/lib/monkey/FUZZ.md
@@ -0,0 +1,33 @@
+# Fuzz Monkey
+
+## Prepare and Build
+
+Set the compiler path:
+
+```
+$ export CC=PATH/TO/honggfuzz/hfuzz_cc/hfuzz-clang
+```
+
+Build Monkey Fuzz tool with the following options:
+
+```
+$ cd build/
+$ cmake -DMK_LOCAL=On -DMK_DEBUG=On \
+ -DMK_LIB_ONLY=On -DMK_SYSTEM_MALLOC=On \
+ -DMK_FUZZ_MODE=On ../
+$ make
+```
+
+the build process will generate two executables:
+
+- mk_fuzz_me: to be used with honggfuzz for the Fuzzing process
+- mk_check: used to validate a crash/fix
+
+## Run HonggFuzz with mk-fuzz-me
+
+Fuzz Monkey using Apache corpus and wordlist:
+
+```
+$ cd /path/to/honggfuzz/examples/apache-httpd/
+$ honggfuzz -Q --logfile out.log -f corpus_http1 -w ./httpd.wordlist -- /path/to/mk-fuzz-me
+```