NAME
netmgt_build_report - add a statistic to a report
SYNOPSIS
bool_t netmgt_build_report (
You should call this function once for each attribute in the group/table. Once all statistics are added (via repeated calls to this function), the agent should call netmgt_send_report(3n) to send the report to the rendezvous process.
There are two methods available for reporting, each with its own strengths. The recommended method is to call netmgt_send_report(3n) only after all the attributes have been checked - the entire report has been created. This is the most efficient use of network resources. However, it will fail if the total size of the report is larger than 6KB, which can happen for large tables. The other method is to call netmgt_send_report(3n) after each row has been checked. This second method will almost always work, but is not an efficient use of network resources and is discouraged unless the agent returns large reports. This restriction applies only to event reports.
INPUT ARGUMENTS
Pointer to a structure that gets filled in with the following fields:
name attribute name.
type attribute type code, as defined in netmgt_arglist.h.
length
attribute value length, in bytes.
value
pointer to the attribute value buffer. The value's internal representation is described by type.
event
event status buffer. If an event has occurred for this attribute, this flag will be set to TRUE; otherwise, it will be set to FALSE.
RETURN VALUE
TRUE if successful, otherwise FALSE. Additionally, event is set to indicate if an event has occurred.
DIAGNOSTICS
If FALSE is returned, global variable netmgt_error 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), netmgt_send_report(3n)