Technical Reference: Base Operating System and Extensions, Volume 1

perfstat_netinterface_total Subroutine

Purpose

Retrieves global network interface usage statistics.

Library

Perfstat Library (libperfstat.a)

Syntax

#include <libperfstat.h>

int perfstat_netinterface_total (name, userbuff, sizeof_struct, desired_number) perfstat_id_t * name; perfstat_netinterface_total_t * userbuff; int sizeof_struct; int desired_number;

Parameters

name	In AIX 5.1, this must always be set to `NULL`.
userbuff	Points to the memory area that is to be filled with the perfstat_netinterface_total_t structure.
sizeof_struct	Specifies the size of the perfstat_netinterface_total_t structure: `sizeof(perfstat_netinterface_total_t)`.
desired_number	In AIX 5.1, this must always be set to `1`.

Description

The perfstat_netinterface_total subroutine returns global network interface usage statistics in a perfstat_netinterface_total_t structure.

Return Values

The number of structures filled is returned upon successful completion. In AIX 5.1, this will always be 1. Otherwise, a value of -1 is returned and the errno variable is set.

Error Codes

The perfstat_netinterface_total subroutine is unsuccessful if one of the following is true:

EINVAL	One of the parameters is not valid.
EFAULT	Not enough memory.