Iniciar a instalação de rastreio

Utilize os seguintes procedimentos para configurar e iniciar um rastreio do sistema:

Configurando o comando trace

O comando trace inicia o rastreio de eventos do sistema e controla o tamanho de e gerencia o arquivo de log trace , bem como os buffers de rastreio internos que coletam dados de eventos de rastreio. Para obter informações sobre a sintaxe deste comando, consulte trace Daemon.

Gravação de dados de eventos de rastreio

Os dados registrados para cada evento rastreado consistem em uma palavra contendo o identificador de gancho de rastreio e o tipo de gancho seguido por um número variável de palavras de dados de rastreio opcionalmente seguido por um carimbo de tempo. A palavra contendo o identificador de gancho de rastreio e o tipo de gancho é chamada de palavra gancho. Os dois bytes restantes da palavra gancho são chamados dados de gancho e estão disponíveis para gravação de dados do evento.

Rastrear identificadores de gancho

Um identificador de gancho de rastreio é um número hexadecimal de três ou quatro dígitos que identifica um evento sendo rastreado. Antes do AIX 6.1 e em aplicativos de 32 bits executados no AIX 6.1 e superior, somente identificadores de hook de três dígitos podem ser usados. Ao usar uma macro de rastreio como TRCHKL1, o gancho de rastreio é especificado como:

hhh0000

onde hhh é o identificador de gancho.

Em aplicativos de 64 bits e rotinas kernel em execução no AIX 6.1 e acima, identificadores de gancho de três e quatro dígitos podem ser usados. Ao usar uma macro de rastreio como TRCHKL1, o gancho de rastreio é especificado como:

hhhh0000

onde hhhh é o identificador de gancho.

Nota: Se um identificador de quatro dígitos for usado e o identificador for menor que 0x1000, o dígito menos significativo deve ser de 0 (do formulário 0x0hh0).

Um identificador de três dígitos tem um implícito 0 em seu dígito menos significativo tal que um identificador de gancho de 32-bit bits de hhh é equivalente a um identificador de gancho de 64-bit de hhh0.

A maioria dos identificadores de gancho de rastreio são definidos no arquivo /usr/include/sys/trchkid.h . Os valores 0x0100 através do 0x0FF0 estão disponíveis para uso por 64-bit aplicativos. Os valores 0x010 através do 0x0FF estão disponíveis para uso por 32-bit aplicativos de usuário. Todos os outros valores são reservados para uso do sistema. Os identificadores de gancho de rastreamento definidos atualmente podem ser listados com o comando trcrpt -j.

Usando canais de rastreio genéricos

A instalação de rastreio suporta até oito sessões de rastreio ativas por vez. Cada sessão de rastreio usa um canal do arquivo especial de rastreio multiplexado, /dev/systrace. O canal 0 é usado pela facilidade de rastreio para registrar eventos do sistema. O rastreio de eventos do sistema é iniciado e interrompido pelos comandos trace e trcstop . Os canais 1 até 7 são chamados de canais de rastreio genéricos e podem ser utilizados por subsistemas para outros tipos de rastreio, como rastreio de link de dados.

Para implementar o rastreio usando os canais de rastreio genéricos da instalação de rastreio, um subsistema chama a subroutine trcstart para ativar um canal de rastreio e determinar o número do canal. Os módulos do subsistema podem, então, registrar os eventos de rastreio TRCGEN ou TRCGENT macros, ou os subroutines trcgen, trcgent, trcgenkou trcgenkt . O número do canal retornado pela subroutine trcstart é um dos parâmetros que devem ser passados para essas subroutines. O subsistema pode suspender e retomar a coleta de dados de rastreio usando as subroutines trcoff e trcon e pode desativar um canal de rastreio usando a subroutine trcstop . Os eventos de rastreio para cada canal são gravados em um arquivo de log trace separado, que, por padrão, é denominado /var/adm/ras/trcfile.n, onde n é o número do canal. O subsistema deve fornecer a interface do usuário para ativar e desativar o rastreio do subsistema.

Iniciando um rastreio

Utilize um dos procedimentos a seguir para iniciar a instalação de rastreio.

Inicie a instalação de rastreio usando o comando trace .
Inicie o rastreio de forma assíncrona. Por exemplo:
```
trace -a
mycmd
trcstop
```
Ao usar o recurso de rastreio de forma assíncrona, use o daemon trace para rastrear os eventos do sistema selecionado (como o comando mycmd ); em seguida, use o comando trcstop para parar o rastreio.

OU
Inicie o rastreio de forma interativa. Por exemplo:
```
trace
->!mycmd
->quit
```
Ao utilizar a facilidade de rastreio de forma interativa, entre no modo interativo conforme denotado pelo->prompt, e use os subcomandos trace (como !) para rastrear os eventos do sistema selecionado. Use o subcomando quit para parar o rastreio.
Use smit trace, e escolha a opção Iniciar Trace .
```
smit trace
```

Parar um rastreio

Use um dos procedimentos a seguir para parar o rastreio que você iniciou anteriormente.

Ao usar o trace assíncronamente na linha de comando, use o comando trcstop :
```
trace -a
mycmd
trcstop
```
Ao usar o recurso de rastreio de forma assíncrona, use o daemon trace para rastrear os eventos do sistema selecionado (como o comando mycmd ); em seguida, use o comando trcstop para parar o rastreio.
Ao usar o trace de forma interativa na linha de comando, use o subcomando quit :
```
trace
->!mycmd
->quit
```
O modo interativo é denotado pelo->Prompt. Use os subcomandos trace (tais como !) para rastrear os eventos do sistema selecionado. Use o subcomando quit para parar o rastreio.
Use smit trace e escolha a opção Stop Trace :
```
smit trace
```

Gerar um relatório de rastreio

Utilize qualquer um dos procedimentos a seguir para gerar um relatório de eventos que foram rastreados.

Use o comando trcrpt :
```
trcrpt>/tmp/NewFile
```
O exemplo anterior formata o arquivo de log trace e envia o relatório para /tmp/newfile. O comando trcrpt lê o arquivo de log trace , formata as entradas de rastreio e escreve um relatório.
Use o comando smit trcrpt :
```
smit trcrpt
```