cnet's Application Programming Interface

NAME

CNET_set_trace - indicate which event handlers should be traced

SYNOPSIS

#include <cnet.h>

int CNET_set_trace(int eventmask);

DESCRIPTION

Event tracing is normally an "all-or-nothing" situation - if requested via cnet's -t command-line switch, the execution of all event handlers is annotated. More specific event tracing may be requested at runtime by specifying an eventmask, such as TE_APPLICATIONREADY|TE_PHYSICALREADY. If event tracing is requested, just the indicated events will be annotated. Each node maintains its own eventmask.

The annotation of all event handlers may be requested by calling CNET_set_trace(TE_ALLEVENTS), this is the default, and all event handler annotation may be disabled by calling CNET_set_trace(TE_NOEVENTS).

RETURN VALUE

The node's previous eventmask is returned. There are no errors.