subrotina pm_set_program

Propósito

Programar programação de Monitor de Desempenho amplo do sistema.

Biblioteca

Biblioteca de APIs do Performance Monitor (libpmapi.a)

Sintaxe

#include <pmapi.h>

int pm_set_program ( *prog)
pm_prog_t *prog;

Descrição

A sub-rotina pm_set_program configura a programação do Monitor de Desempenho do sistema. A configuração inclui os eventos a serem contados, e um modo no qual contar. Os eventos a contar estão em uma lista de identificadores de eventos. Os identificadores devem ser selecionados nas listas que são retornadas pela sub-rotina pm_init .

O modo de contagem inclui o Modo Kernel and/or do Modo de Usuário, o Estado de Contagem Inicial e o Modo de Árvore de Processo O Process Tree Mode estabelece a contagem para On somente para o processo de chamada e seus descendentes. Os padrões são configurados para Off para o Modo de Usuário e o Modo Kernel. O estado padrão inicial é configurado para atrasar a contagem até a sub-rotina pm_start ser chamada e para contar a atividade de todos os processos em execução no sistema.

Se a lista incluir um evento, que pode ser usado com um limite (conforme indicado pela sub-rotina pm_init ), um valor de limite também poderá ser especificado.

Em algumas plataformas, grupos de eventos podem ser especificados em vez de eventos individuais. Isso é feito configurando o bitfield is_group no modo e colocando o ID do grupo no primeiro elemento da matriz de eventos. (O ID do grupo foi obtido por pm_init)

Parâmetros

Tabela 1. Parâmetros
Item	Descrição
`* prog`	Especifica os eventos e modos a serem utilizados no setup Performance Monitor. Os seguintes modos são suportados: `PM_USUÁRIO` Processa processos em execução no Modo de Usuário (padrão é definido como Off) `PM_KERNEL` Processa processos em execução no Modo Kernel (padrão é definido para Off) `PM_COUNT` Contagens imediatamente (o padrão é configurado como Não Iniciar Contagem) `PM_PROCTREE` Conjuntos contando com On apenas para o processo de chamada e seus descendentes (padrão está configurado para Off)

Valores De Retorno

Tabela 2.. Valores de Retorno
Item	Descrição
0	Operação concluída com êxito.
Código de erro positivo	Consulte a Subroutine pm_error para decodificar o código de erro.

Códigos De Erro

Consulte a Subroutine pm_error.

Arquivos

Tabela 3.. arquivos
Item	Descrição
/usr/include/pmapi.h	Define macros padrão, tipos de dados e subroutines.