sub-rotina perfstat_virtualdisktarget

Editar online

Propósito

Recupera as estatísticas de uso do Virtual Target Device (VTD) em Virtual I/O Server (VIOS).

Biblioteca

Biblioteca perfstat (libperfstat.a)

Sintaxe

#include <libperfstat.h>
int perfstat_virtualdisktarget (name, userbuff, sizeof_struct, desired_number)
perfstat_id_t * name;
perfstat_disk_t * userbuff;
size_t sizeof_struct;int desired_number;

Descrição

A subroutine perfstat_virtualdisktarget recupera uma ou mais estatísticas de uso do dispositivo de destino virtual.

A mesma função também pode ser usada para recuperar o número de conjuntos disponíveis de estatísticas de uso do dispositivo de destino virtual.

Para obter um ou mais conjuntos de métricas de uso do dispositivo de destino virtual, configure o parâmetro name para o nome do primeiro dispositivo de destino virtual para o qual as estatísticas devem ser coletadas, e configure o parâmetro desired_number . Para iniciar a partir do primeiro dispositivo de destino virtual, configure o parâmetro name para as aspas ("") ou FIRST_VTD. O parâmetro userbuff deve sempre apontar para a área de memória que é grande o suficiente para conter o número de estruturas perfstat_disk_t que esta subroutine é para copiar. Ao retornar, o parâmetro name é configurado como o nome do próximo adaptador de rede, ou para as aspas ("") depois que todas as estruturas são copiadas.

Para recuperar o número de conjuntos disponíveis de métricas de uso do dispositivo de destino virtual, configure o parâmetro name e o parâmetro userbuff para o valor de null, e o parâmetro desired_number para o valor de zero. O valor retornado é o número de conjuntos disponíveis. A subroutine perfstat_virtualdisktarget fornece as estatísticas apenas na máquina VIOS.

Os campos de estrutura perfstat_disk_t a seguir não são preenchidos pela subroutinha perfstat_virtualdisktarget :
  • Descrição
  • vgname
  • tamanho
  • grátis
  • qprofundidade
  • adaptador
  • paths_count
  • wpar_id

Parâmetros

Item Descrição
nome Contém as aspas (""), FIRST_VTD, ou o nome indicando o primeiro adaptador de rede para o qual as estatísticas devem ser recuperadas. Por exemplo: vtscsi0, vtscsi1.
userbuff Aponta para a memória que deve ser preenchida com uma ou mais estruturas perfstat_disk_t .
tamanho da estrutura Especifica o tamanho da estrutura perfstat_disk_t .
número_desejado Especifica o número de estruturas perfstat_disk_t para copiar para o parâmetro userbuff .

Valores De Retorno

Após a conclusão bem-sucedida, o número de estruturas preenchidas é devolvido.

Se não tiver êxito, um valor de -1 é retornado e a variável global errno é definida.

Códigos De Erro

A subroutine perfstat_virtualdisktarget não é bem-sucedida se um dos seguintes for true:

Item Descrição
EINVAL Um dos parâmetros não é válido
EFAULT A memória não é suficiente
ENOMEM O comprimento padrão da sequência é muito curto.
ENOMSG O dicionário não é acessível.

Arquivos

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