sub-rotina perfstat_processor_pool_util

Propósito

Calcula as métricas relacionadas à utilização do pool do processador.

Biblioteca

perfstat library (libperfstat.a)

Sintaxe

#include <libperfstat.h>
int perfstat_processor_pool_util (perfstat_rawdata_t * data ,perfstat_processor_pool_util_t * userbuff
int sizeoff_userbuff,
int desired_number);

Descrição

A subroutina perfstat_processor_pool_util calcula as métricas relacionadas à utilização do pool do processador para a corrente e os valores anteriores passados para a estrutura de dados perfstat_rawdata_t .

A utilização do pool é calculada especificando o campo Tipo da estrutura de dados perfstat_rawdata_t para SHARED_POOL_UTIL. O SHARED_POOL_UTIL é uma macro que pode ser referida na definição da estrutura de dados perfstat_rawdata_t .

Parâmetros

data
Calcula as métricas relacionadas à utilização do pool do processador relacionadas a valores atuais e anteriores.

O parâmetro data pertence ao tipo de estrutura de dados perfstat_rawdata_t . O curstat e os atributos prevstat apontam para a estrutura de dados perfstat_partition_total .

userbuff
Especifica a área de memória que deve ser preenchida com uma ou mais estrutura perfstat_processor_util_t .
tamanho do buffer do usuário
Especifica o tamanho da estrutura perfstat_processor_util_t .
número_desejado
Especifica o número de estruturas perfstat_processor_util_t para copiar para o parâmetro userbuff . O valor precisa ser definido para 1.

Códigos De Erro

A subroutine perfstat_processor_pool_util não é bem-sucedida se o seguinte for true:
EINVAL
O valor é definido se um dos parâmetros não for válido.
EPERM
O valor é definido se a coleta de dados de desempenho não estiver ativada.

Valores De Retorno

Se o parâmetro data for configurado como NULL e o parâmetro userbuff também será configurado como NULL e o parâmetro sizeof_userbuff será configurado como 0, tamanho da subroutine perfstat_processor_pool_util_util_t é retornado.

A menos que a subroutine perfstat_processor_pool_util seja usada para recuperar o número de estruturas disponíveis, o número de estruturas preenchidas é devolvido mediante conclusão bem-sucedida. Caso contrário, um valor de -1 é retornado e a variável global errno é definida.
Nota: A subroutine perfstat_processor_pool_util requer que a coleta de dados de desempenho seja ativada para retornar os valores do pool do processador.