Module libafl::events

An EventManager manages all events that go to other instances of the fuzzer. The messages are commonly information about new Testcases as well as stats and other Events.

Re-exports

• pub use simple::*;
• pub use centralized::*;
• pub use llmp::*;
• pub use launcher::*;

Modules

• centralized
  Centralized event manager is a special event manager that will be used to achieve a more efficient message passing architecture.
• hooks
  Hooks for event managers, especifically these are used to hook before and and handle_in_client. This will allow user to define pre/post-processing code when the event manager receives any message from other clients
• launcher
  The Launcher launches multiple fuzzer instances in parallel. Thanks to it, we won’t need a for loop in a shell script…
• llmp
  LLMP-backed event manager for scalable multi-processed fuzzing
• simple
  A very simple event manager, that just supports log outputs, but no multiprocessing
• tcp
  TCP-backed event manager for scalable multi-processed fuzzing

Structs

• EventManagerId
  A per-fuzzer unique ID, usually starting with 0 and increasing by 1 in multiprocessed EventManagers, such as self::llmp::LlmpEventManager.
• MonitorTypedEventManager
  An EventManager type that wraps another manager, but captures a monitor type as well. This is useful to keep the same API between managers with and without an internal monitor.
• NopEventManager
  An eventmgr for tests, and as placeholder if you really don’t need an event manager.
• ShutdownSignalData
  A signal handler for releasing StateRestore ShMem This struct holds a pointer to StateRestore and clean up the ShMem segment used by it.

Enums

• BrokerEventResult
  Indicate if an event worked or not
• CustomBufEventResult
  The result of a custom buf handler added using HasCustomBufHandlers::add_custom_buf_handler
• Event
  Events sent around in the library
• EventConfig
  Distinguish a fuzzer by its config
• LogSeverity
  The log event severity

Statics

• EVENTMGR_SIGHANDLER_STATE
  Check if ctrl-c is sent with this struct

Traits

• AdaptiveSerializer
  Collected stats to decide if observers must be serialized or not
• EventFirer
  EventFirer fire an event.
• EventManager
  EventManager is the main communications hub. For the “normal” multi-processed mode, you may want to look into LlmpRestartingEventManager
• EventProcessor
  EventProcessor process all the incoming messages
• EventRestarter
  Restartable trait
• HasCustomBufHandlers
  Supports custom buf handlers to handle CustomBuf events.
• HasEventManagerId
  The id of this EventManager. For multi processed EventManagers, each connected client should have a unique ids.
• ProgressReporter
  ProgressReporter report progress to the broker.