NAME

netmgt_fetch_data - get data statistics

SYNOPSIS

bool_t

netmgt_fetch_data(data)
        Netmgt_data     * data;

DESCRIPTION

netmgt_fetch_data gets data statistics from a data report and places them into a local buffer data. When a rendezvous receives a data report, the first call to this function gets the first data 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

pointer to a buffer where individual data stats are placed. It has the following fields:

name

attribute name.

type

attribute type code, as defined in netmgt_arglist.h.

length

length of the attribute value, in bytes.

value

attribute value. The value's internal representation is described by type.

RETURN VALUE

TRUE if successful, otherwise FALSE.

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)