sub-rotina pm_set_program_thread

Editar online

Propósito

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

Biblioteca

Biblioteca de APIs do Performance Monitor (libpmapi.a)

Sintaxe

#include <pmapi.h>  

int pm_set_program_thread ( pid,  tid,  *prog)
pid_t pid;
tid_t tid;
pm_prog_t *prog;

Descrição

Esta subroutine suporta apenas o modelo de threading de 1: 1. Ele foi suplantado pela subroutina pm_set_program_pthread , que suporta tanto os modelos 1: de 1 quanto o M: N threading. Uma chamada para esta subroutine é equivalente a uma chamada para a subroutine pm_set_program_program_pthread com um parâmetro ptid igual a 0.

A subroutine pm_set_program_thread configura a programatização Performance Monitor para um encadeamento de kernel de destino. O fio 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_init .

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 Usuário e o Modo Kernel, e o Estado Padrão Inicial é configurado para atrasar a contagem até que a subroutine pm_start_thread seja chamada.

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

Parâmetros

Item Descrição
pid ID do processo de thread de destino. O processo de destino deve ser um debuggee do processo de chamamento.
TID Encadeamento ID do encadeamento de destino.
* 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.
Código de Erro positivo Consulte o subroutine pm_error (pm_error Subroutine) para decodificar o código de erro.

Códigos De Erro

Consulte o subroutine pm_error (pm_error Subroutine).

Arquivos

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