zeek/scripts/policy/misc/dump-events.zeek
Johanna Amann f4d9cf5f89 Introduce generate_all_events bif and add option to misc/dump-events
generate_all_events causes all events to be raised internally; this
makes it possible for dump_events to really capture all events (and not
just those that were handled).

Addresses GH-169
2020-10-12 16:21:18 +02:00

50 lines
1.2 KiB
Text

##! This script dumps the events that Zeek raises out to standard output in a
##! readable form. This is for debugging only and allows to understand events and
##! their parameters as Zeek processes input. Note that it will show only events
##! for which a handler is defined.
module DumpEvents;
export {
## If true, include event arguments in output.
option include_args = T;
## By default, only events that are handled in a script are dumped. Setting this option to true
## will cause unhandled events to be dumped too.
const dump_all_events = F &redef;
## Only include events matching the given pattern into output. By default, the
## pattern matches all events.
option include = /.*/;
}
event zeek_init() &priority=999
{
if ( dump_all_events )
generate_all_events();
}
event new_event(name: string, args: call_argument_vector)
{
if ( include !in name )
return;
print fmt("%17.6f %s", network_time(), name);
if ( ! include_args || |args| == 0 )
return;
for ( i in args )
{
local a = args[i];
local proto = fmt("%s: %s", a$name, a$type_name);
if ( a?$value )
print fmt(" [%d] %-18s = %s", i, proto, a$value);
else
print fmt(" | %-18s = %s [default]", proto, a$value);
}
print "";
}