sub-rotina perfstat_protocol

Propósito

Recupera estatísticas de uso do protocolo.

Biblioteca

Biblioteca perfstat (libperfstat.a)

Sintaxe

#include <libperfstat.h>


int perfstat_protocol (name, userbuff, sizeof_struct, desired_number)
perfstat_id_t *name;
perfstat_protocol_t *userbuff;
size_t sizeof_struct;
int desired_number;

Descrição

O subroutine perfstat_protocol recupera estatísticas de uso do protocolo como ICMP, ICMPv6, IP, IPv6, TCP, UDP, RPC, NFS, NFSv2, NFSv3. Para obter um ou mais conjuntos de métricas de uso do protocolo, configure o parâmetro name para o nome do primeiro protocolo para o qual as estatísticas são desejadas, e configure o parâmetro desired_number .

Para iniciar a partir do primeiro protocolo, configure o parâmetro name para "" ou FIRST_PROTOCOL. O parâmetro userbuff deve apontar para uma área de memória grande o suficiente para conter o número desejado de estruturas perfstat_protocol_t que serão copiadas por esta função. Ao retornar, o parâmetro name será definido como o nome do próximo protocolo, ou para "" se todas as estruturas tiverem sido copiadas.

Para recuperar o número de conjuntos disponíveis de métricas de uso do protocolo, configure os parâmetros name e userbuff para NULL, e o parâmetro desired_number para 0. O valor retornado será o número de conjuntos disponíveis.

Esta subroutine não é suportada dentro de uma partição de carga de trabalho (WPAR). Ele não está ciente de um WPAR.

Parâmetros

Valores De Retorno

Após a conclusão bem-sucedida, o número de estruturas que poderiam ser preenchidas é devolvido. Se não tiver êxito, um valor de -1 é retornado e a variável global errno é definida.

Códigos De Erro

Arquivos

O arquivo libperfstat.h define macros padrão, tipos de dados e sub-rotinas.