Previous

Next

Function xn_interface_ethernet_statistics

This function returns Ethernet I/O statistics of an interface.

struct ether_statistics 
{ 
    long packets_in; 
    long packets_out; 
    long bytes_in; 
    long bytes_out; 
    long errors_in; 
    long errors_out; 
    long packets_lost; 
    long one_collision;         /* one collision occurred, xmit ok    */ 
    long multiple_collisions;   /* more than one collision, xmit ok   */ 
    long owc_collision;         /* out of window collision occurred,  */ 
                                /* xmit ok                            */ 
    long collision_errors;      /* excessive collisions, xmit aborted */ 
    long rx_overwrite_errors;   /* ring buffer overflow               */ 
    long rx_frame_errors;       /* packet to large                    */ 
    long rx_crc_errors; 
    long rx_fifo_errors;        /* rx fifo overrun                    */ 
    long rx_other_errors;       /* other errors not counted in SNMP   */ 
                                /* statistics (includes ring buffer   */ 
                                /* corrupt, ring buffer overflow,     */ 
                                /* frame alignment error, FIFO        */ 
                                /* overrun, missed packet             */ 
    long tx_carrier_errors;     /* carrier sense errors               */ 
    long tx_fifo_errors;        /* fifo underrun                      */ 
    long tx_delayed;            /* xmit delayed due to medium busy    */ 
    long tx_sqe_errors;         /* SQE Error                          */ 
    long tx_other_errors;       /* other errors not counted in SNMP   */ 
                                /* statistics (includes xmit timeout, */ 
                                /* DMA failed to complete,            */ 
                                /* bus error                          */ 
}; 

int xn_interface_ethernet_statistics(int iface_no, struct ether_statistics * stats);

Parameters

iface_no

Interface number (returned from xn_interface_open or xn_interface_open_config).

stats

pointer to an ether_statistics structure to receive the statistics.

return value

Returns 1 for success or 0 on failure.

Depending on the capabilities of the Ethernet controller of the specified interface, some fields of struct ether_statistics may not be applicable and will be returned as zero.

Extended RTIP-32 API

Function xn_interface_opt

Function xn_interface_statistics