NAME
netmgt_fetch_event - fetch event report statistics
SYNOPSIS
bool_t
netmgt_fetch_event(event)
Netmgt_event *event;
DESCRIPTION
netmgt_fetch_event gets event statistics out of an event report and places them into a local buffer event. When a rendezvous receives an event report, the first call to this function fetches the first event statistic in the report. Successive calls get successive statistics.
A returned name string of NETMGT_ENDOFROW marks the end of a row of tabular data. The string NETMGT_ENDOFARGS marks the end of the report. These strings are defined in netmgt_arglist.h. The caller can repeatedly call this function until NETMGT_ENDOFARGS is seen.
INPUT ARGUMENTS
event
pointer to a buffer where individual event statistics are placed. It has the following fields:
name attribute name.
type attribute type code, as defined in netmgt_arglist.h.
length
attribute value length, in bytes.
value
attribute value. The value's internal representation is described by type.
relop
relational operator, as defined in netmgt_arglist.h, indicating how the threshold was exceeded. If this attribute didn't trigger the event report, this field will be set to NETMGT_NOP.
thresh_val
threshold value. The threshold's internal representation is described by type.
priority
priority of the event. Possible values are NETMGT_LOW_PRIORITY, NETMGT_MEDIUM_PRIORITY or
NETMGT_HIGH_PRIORITY.
RETURN VALUE
TRUE if successful, otherwise FALSE.
DIAGNOSTICS
If FALSE is returned, global variable netmgt_errno indicates the error. The caller can get the reason for the error with netmgt_fetch_error(3n).
FILES
netmgt_arglist.h
SEE ALSO
netmgt_fetch_error(3n)
NOTES
To find out which attributes triggered the event report, cycle through the event statistics via repeated calls to this function. Look for the returned relop value to be something besides NETMGT_NOP.