How googleprojectzero/fuzzilli works
Main components
• Fuzzilli CLI (Sources/FuzzilliCli)
• Core library (Sources/Fuzzilli)
– Fuzzer instance (Fuzzer.swift)
– Engines (MutationEngine, HybridEngine, etc.)
– Mutators, Corpus, Minimizer, Evaluator, Lifter, Environment, ScriptRunner/REPRL
– Event system (Events.swift)
• Intermediate Language (FuzzIL)
• C helper libs (libcoverage, libreprl, libsocket)
• Target engine processes (JS shells instrumented via patches in Targets/)
• Optional modules: Storage, NetworkSync, ThreadSync, Statistics
• Deployment: Docker builders, Cloud-GCE scripts
Relationships and data flows
a. CLI → config → instantiate one or more Fuzzer instances
b. Fuzzer loop:
– Corpus supplies seed programs
– MutationEngine applies Mutators → new FuzzIL programs
– Lifter translates IR to JavaScript
– ScriptRunner (via REPRL) sends code over socket/shared memory to target engine process
– libcoverage collects coverage feedback
– Evaluator grades program (coverage gain, crash)
– Corpus & Minimizer update stored programs/crashes
– Events propagate between components (decoupled via EventDispatcher)
c. Modules can subscribe to events to:
– Store crashes to disk (Storage)
– Sync corpora across threads/processes (ThreadSync)
– Sync corpora over network (NetworkSync)
– Gather stats (Statistics)
d. For distributed fuzzing: multiple Fuzzer instances form a tree hierarchy; parent/child sync via modules
Architectural patterns
• Event-driven, modular design: components decoupled by Events
• Pipeline pattern: IR generation → translation → execution → feedback
• Reader–Eval–Print–Reset loop (REPRL) for efficient reuse of target engine
• Tree-based distribution for scalability
• Platform abstraction layers: Swift code for core logic; C for low-level IPC & coverage
Technologies & frameworks
• Swift (fuzzer logic, CLI, lifting, engines, mutators)
• C (libcoverage, libreprl, libsocket)
• Docker (Cloud/Docker builders for Fuzzilli and JS engines)
• Google Compute Engine scripts (Cloud/GCE)
• Protobuf for sync protocol (Sources/Fuzzilli/Protobuf)