sub-rotina perfstat_process_util

Propósito

Calcula métricas de utilização do processo.

Biblioteca

biblioteca perfstat (libperfstat.a)

Sintaxe

#include <libperfstat.h>

int perfstat_process (data, userbuff, sizeof_userbuff, desired_number)
perfstat_id_t * data;
perfstat_process_t * userbuff;
int  sizeof_userbuff ;
int  desired_number ;

Descrição

A sub-rotina perfstat_process_util fornece a interface para métricas de utilização do processo. A sub-rotina perfstat_process recupera uma ou mais estatísticas de processo para preencher a estrutura de dados do perfstat_process_t A sub-rotina perfstat_process_util usa os valores atual e anterior para calcular as métricas relacionadas à utilização Se os parâmetros name e userbuff forem configurados como NULL e o parâmetro sizeof_userbuff for configurado como 0, o tamanho da versão atual da estrutura de dados perfstat_process_t será retornado. Se o parâmetro desired_number for configurado como 0, o número de elementos atuais, da estrutura de dados perfstat_rawdata_t , será retornado.

Parâmetros

Tabela 1. Parâmetros
Item	Descrição
`data`	Especifica que o parâmetro `data` é do tipo `perfstat_rawdata_t`.. A estrutura de dados do `perfstat_rawdata_t` pode usar os valores atual e anterior para calcular as métricas relacionadas à utilização
`userbuff`	Especifica a área de memória a ser preenchida com uma ou mais estruturas de dados do `perfstat_process_t`
`tamanho do buffer do usuário`	Especifica o tamanho do `perfstat_process_t` estrutura de dados. Nota: Para obter o tamanho da versão mais recente da estrutura de dados `perfstat_process_t`, configure o parâmetro `sizeof_userbuff` como 0 e os parâmetros `name` e `userbuff` como NULL.
`número_desejado`	Especifica o número das estruturas `perfstat_process_t` para copiar para o parâmetro `userbuff` .

Valores De Retorno

A menos que a sub-rotina perfstat_process_util seja usada para recuperar o número de estruturas disponíveis, o número de estruturas preenchidas será retornado após a conclusão bem-sucedida. Se não tiver êxito, um valor de -1 é retornado e a variável global errno é definida.

Códigos De Erro

A sub-rotina perfstat_process_util será malsucedida se o seguinte código de erro for verdadeiro:

Tabela 2.. Códigos de Erro
Item	Descrição
`EINVAL`	Um dos parâmetros não é válido.

Arquivos

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