serviço do kernel trcgenk

Propósito

Registra um evento de rastreio para um canal de rastreio genérico.

Sintaxe

#include <sys/types.h>
#include <sys/errno.h>
#include <sys/trchkid.h>

void trcgenk (chan, hk_word, data_word, len, buf) unsigned int chan, hk_word, data_word, len; char * buf;

Parâmetros

Item	Descrição
chan	Especifica o número do canal para a sessão de rastreio. Este número é obtido a partir do subbroutine trcstart .
hk_word	Um inteiro contendo um ID de gancho e um tipo de gancho: hk_id Antes do AIX 6.1, o identificador de gancho é um valor de 12 bits. No AIX 6.1 e acima, o identificador de gancho é um valor de 16 bits. Um valor de 16 bits do formulário hhh0 é equivalente a um valor de 12 bits do formulário hhh. hk_type Um tipo de gancho de 4-bit. O serviço trcgenk registra automaticamente essas informações. Esse valor é válido apenas antes do AIX 6.1.
palavra_dados	Especifica uma palavra de dados definidos pelo usuário.
Com	Especifica o comprimento em bytes do buffer especificado pelo parâmetro buf .
buf	Aponta para um buffer de dados de rastreio. A quantidade máxima de dados de rastreio é de 4096 bytes.

Descrição

O serviço de kernel trcgenk registra um evento de rastreio se uma sessão de rastreio estiver ativa para o canal de rastreio especificado. Se uma sessão de rastreio não estiver ativa, o serviço kernel trcgenk simplesmente retorna. O serviço kernel trcgenk está localizado em memória de kernel pintado.

O serviço kernel trcgenk é usado para registrar uma entrada de rastreio que consiste em uma entrada hk_word , uma entrada data_word , um número variável de bytes de dados de rastreio e, no AIX 5L Versão 5.3 com o Nível de tecnologia 5300-05 e acima, um registro de data e hora.

Ambiente de Execução

O serviço kernel trcgenk pode ser chamado a partir do ambiente processo ou interrupção .

Valores De Retorno

O serviço kernel trcgenk não tem valores de retorno.