subrotina pm_set_program_pthread

Editar online

Propósito

Configura programação do Monitor de Desempenho para um pthread de destino.

Biblioteca

Biblioteca de APIs do Performance Monitor (libpmapi.a)

Sintaxe

#include <pmapi.h>  

int pm_set_program_pthread ( pid,  tid,  ptid,  *prog)
pid_t pid;
tid_t tid;
ptid_t ptid;
pm_prog_t *prog;

Descrição

A subroutine pm_set_program_pthread configura a programatização Performance Monitor para um pthread de destino. O pthread deve ser interrompido e deve fazer parte de um processo de debuggee, sob o controle do processo de chamada. 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 a partir das listas retornadas pelo subroutine pm_inititialize .

Se o pthread estiver rodando no modo 1: 1 bits, apenas o parâmetro tid deve ser especificado. Se o pthread estiver rodando em m: n mode, apenas o parâmetro ptid deve ser especificado. Se ambos os parâmetros ptid e tid forem especificados, eles devem estar se referindo a um único pthread com o parâmetro ptid especificado e atualmente em execução em uma thread de kernel com parâmetro tid especificado.

O modo de contagem inclui Modo de Usuário e / ou Modo Kernel, e o Estado de Contagem Inicial. Os padrões são configurados para Off para o Modo de Usuário e o Modo Kernel, e o Estado Padrão Inicial é configurado para atrasar a contagem até que a subroutine pm_start_pthread seja chamada.

Se a lista incluir um evento que pode ser usado com um limite (conforme indicado pelo subroutine pm_initialize ), um valor limite também pode ser especificado.

Parâmetros

Item Descrição
pid ID do processo de pthread de destino. O processo de destino deve ser um debuggee do processo de chamamento.
TID Linha ID do pthread de destino. Para ignorar este parâmetro, configure-o para 0.
ptid Pthread ID do pthread de destino. Para ignorar este parâmetro, configure-o para 0.
* prog Especifica os modos de evento a serem usados na configuração do 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
Começa a contar imediatamente (padrão é definido para Não Iniciar Contagem)

Valores De Retorno

Item Descrição
0 Operação concluída com êxito.
Positive error code Consulte a Subroutine pm_error para decodificar o código de erro.

Códigos De Erro

Consulte a Subroutine pm_error.

Arquivos

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