cnet's Application Programming Interface

NAME
CNET_get_linkstats - obtain runtime statistics about one of current node's links

SYNOPSIS
#include <cnet.h>

typedef struct {
    int64_t     tx_frames;
    int64_t     tx_bytes;
    int64_t     tx_cost;

    int64_t     rx_frames;
    int64_t     rx_bytes;
    int64_t     rx_frames_corrupted;
    int64_t     rx_frames_collisions;
} CnetLinkStats;

int CNET_get_linkstats(int link, CnetLinkStats *stats);

DESCRIPTION
CNET_get_linkstats() provides the current node with statistics about each of its own communication links.

A node's link statistics are cleared when the node reboots. The "sum" of all link statistics form the global link statistics which are reported on the GUI and may be requested with the -s command-line option.

RETURN VALUE
The value 0 is returned on success. On failure, the value -1 is returned, and the global variable cnet_errno is set to one of the following values to describe the error:

ER_BADLINK
The value of link is less than zero, or greater than the number of physical links of the current node.
ER_BADARG
stats was a NULL pointer.
SEE ALSO
CNET_get_nodestats.

 cnet v3.3.4, written by Chris.McDonald@uwa.edu.au
 Last modified: Tue Mar 1 7:43AM 2016