Skip to content

Commit b8eb177

Browse files
committed
Merge bitcoin/bitcoin#32175: fuzz: doc: add info about afl-system-config for macOS
61ea5f3 fuzz: doc: add info about `afl-system-config` for macOS (brunoerg) Pull request description: `afl-system-config` adjusts the shared memory segment size limits and configures kernel parameters for better fuzzing performance. Since macOS has more conservative values on shared memory, it's necessary to run `afl-system-config`, or manually adjust the values to fuzz with AFL++. e.g.: ```sh kern.sysv.shmmax: 524288000 kern.sysv.shmmin: 1 kern.sysv.shmseg: 48 kern.sysv.shmall: 131072000 ``` ACKs for top commit: janb84: reACK [61ea5f3](bitcoin/bitcoin@61ea5f3) w0xlt: ACK bitcoin/bitcoin@61ea5f3 Crypt-iQ: ACK 61ea5f3 Tree-SHA512: 8fd9fcb397a6b22e344ac37d3d18052ce8b6b32a5118ab3554c49116d7dd8769cdcbad41f0784d9ab525d4284a82e3d7a89b2c66966b725bf3781d9389d7454d
2 parents 52e6e93 + 61ea5f3 commit b8eb177

File tree

1 file changed

+2
-0
lines changed

1 file changed

+2
-0
lines changed

doc/fuzzing.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -225,6 +225,8 @@ $ cmake -B build_fuzz \
225225
$ cmake --build build_fuzz
226226
# For macOS you may need to ignore x86 compilation checks when running "cmake --build". If so,
227227
# try compiling using: AFL_NO_X86=1 cmake --build build_fuzz
228+
# Also, it might be required to run "afl-system-config" to adjust the shared
229+
# memory parameters.
228230
$ mkdir -p inputs/ outputs/
229231
$ echo A > inputs/thin-air-input
230232
$ FUZZ=bech32 ./AFLplusplus/afl-fuzz -i inputs/ -o outputs/ -- build_fuzz/bin/fuzz

0 commit comments

Comments
 (0)