sub-rotina perfstat_virtualdiskadapter
Propósito
Recupera as estatísticas de uso do adaptador Virtual Small Computer System Interface (SCSI) ou Serial Attached SCSI (SAS) em Virtual I/O Server (VIOS).
Biblioteca
Biblioteca perfstat (libperfstat.a)
Sintaxe
#include <libperfstat.h>
int perfstat_virtualdiskadapter (name, userbuff, sizeof_struct, desired_number)
perfstat_id_t * name;
perfstat_diskadapter_t * userbuff;
size_t sizeof_struct;int desired_number;Descrição
A subroutine perfstat_virtualdiskadapter recupera uma ou mais estatísticas de uso do adaptador SCSI/SAS Virtual.
A mesma função também pode ser usada para recuperar o número de conjuntos disponíveis de estatísticas do adaptador Virtual SCSI/SAS (VHOST).
Para obter um ou mais conjuntos de métricas de uso SCSI Virtual, configure o parâmetro name para o nome do primeiro adaptador SCSI Virtual para o qual as estatísticas devem ser coletadas, e configure o parâmetro desired_number . Para iniciar a partir do primeiro adaptador SCSI Virtual, configure o parâmetro name para as aspas ("") ou FIRST_VHOST. 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_diskadapter_t que esta subroutine é para copiar. Ao retornar, o parâmetro name é configurado como o nome do próximo adaptador de rede, 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 adaptador SCSI 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 adaptador vhost disponível. A subroutine perfstat_virtualdiskadapter fornece as estatísticas apenas na máquina VIOS.
Parâmetros
| Item | Descrição |
|---|---|
| nome | Contém as aspas (""), FIRST_VHOST, ou o nome indicando o primeiro grupo de volume do adaptador de rede para o qual as estatísticas devem ser recuperadas. Por exemplo: vhost0, vhost1. |
| userbuff | Aponta para a memória que deve ser preenchida com uma ou mais estruturas perfstat_diskadapter_t . |
| tamanho da estrutura | Especifica o tamanho da estrutura perfstat_diskadapter_t . |
| número_desejado | Especifica o número de estruturas perfstat_diskadapter_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 for bem-sucedido, um valor de -1 será retornado.
Códigos De Erro
A subroutine perfstat_virtualdiskadapter 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.