comando ctctrl

Propósito

Modifica ou exibe os atributos de rastreio de componentes do sistema. Você pode especificar valores de atributos persistentes para componentes que ainda não foram criados.

Sintaxe

Para modificar os atributos de rastreio de alguns ou todos os componentes, utilize o seguinte comando:

ctctrl [ -n r u ] ComponentSelector... subcomando ...

Para despejar buffers de componentes em arquivos, use o seguinte comando:

ctctrl [-r u] {-D [-d dirName]} ComponentSelector ...

Para especificar valores de atributos persistentes para componentes que não foram criados ainda, use o seguinte comando:

ctctrl -p [ -ru ] ComponentSelector... subcomando ...

Para especificar valores de atributos persistentes que serão efetivados após o próximo reinício, use o seguinte comando:

ctctrl -P [ -ru ] ComponentSelector... subcomando ...

Para excluir customizações de atributo persistente, use o seguinte comando:

ctctrl -x { -P | -p } [ -r u ] ComponentSelector...

Para consultar atributos de rastreio de componentes existentes ou para consultar a personalização de atributo persistente existente, utilize o seguinte comando:

ctctrl -q [-r u p P] {ComponentSeletor ...}

Para exibir uma mensagem de uso, use o seguinte comando:

ctctrl {-h | -? }

Para ativar ou desativar o rastreio de memória para todos os componentes persistentemente, use o seguinte comando:

ctctrl -P { memtraceon | memtraceoff }

Os valores do parâmetro ComponentSelector são os seguintes:

-C: componentPatternList
-l: aliasPatternList
-t: typePatternList

Cada lista consiste em um ou mais padrões que são separados por espaços em branco ou vírgulas. Os padrões podem conter caracteres especiais conforme descrito pela subroutina fnmatch . Você pode usar os seguintes caracteres de padrão:

?
*
[ ]

Não é possível usar classes de caracteres e sequências de ordenação entre colchetes ([]). Especificar -c all seleciona todos os componentes, se nenhum outro parâmetro ComponentSelector for especificado.

Descrição

O comando ctctrl modifica ou exibe as configurações de rastreio de alguns ou todos os componentes. Os componentes são selecionados por nome, por alias, ou por tipo ou subtipo. O comando ctctrl também pode ser usado com a bandeira -p ou -P para especificar customização de atributo persistente. Veja a seção Customizações Persistentes .

Para ativar ou desativar o rastreio de nível de componente para todos os componentes imediatamente e persistentemente, especifique o subcomando memtraceon ou memtraceoff com a bandeira -P . Não é possível especificar outras bandeiras ou subcomandos com a bandeira -P . Você deve usar o comando bosboot para fazer configurações persistentes entre as botas.

O atributo modificado depende do subcomando que é passado para o comando ctctrl . Vários subcomandos podem ser usados em uma única invocação ctctrl . Você pode especificar os seguintes subcomandos:

Item	Descrição
memtraceon	Liga o modo de rastreio de memória.
memtraceoff	Desliga o modo de rastreio de memória.
memtraceresume	Retoma o modo de rastreio de memória.
memtracesuspend	Suspende o modo de rastreio de memória.
memtracebufsize=sz	Altera o tamanho do buffer privado alocado no modo de rastreio de memória.
memtraceminimal	Altera o nível do modo de rastreio de memória para `1`.
memtracenormal	Altera o nível do modo de rastreio de memória para `3`.
memtracedetail	Altera o nível do modo de rastreio de memória para `7`.
memtracemax	Altera o nível do modo de rastreio de memória para o nível de detalhe máximo `9`.
memtracelevel=d	Altera o nível de rastreio do modo de rastreio de memória. Configura-o para o nível especificado.
memtracefilltime	Exibe o tempo de retenção de dados (isto é, o tempo estimado para preencher o buffer de memória privada). Isso está disponível apenas se o modo de rastreio de memória estiver em.
systraceon	Liga-se o rastreio através do rastreio do sistema.
systraceoff	Desliga o rastreio através do rastreio do sistema.
systraceminimal	Altera o nível do modo de rastreio do sistema para `1`.
systracenormal	Altera o nível do modo de rastreio do sistema para `3`.
systracedetail	Altera o nível do modo de rastreio do sistema para `7`.
systracemax	Altera o nível de modo de rastreio do sistema para o nível de detalhe máximo `9`.
systracelevel=d	Altera o nível de rastreio utilizado para rastrear através do rastreio do sistema. Configura-o para o valor especificado.

Nota: O memtracesuspend, memtraceresume, e memtracefilltime subcomandos não podem ser usados com o flag -p ou o -P , pois estes subcomandos não podem ser usados em customizações persistentes.

Outros subcomandos que não estão na lista anterior podem ser reconhecidos por componentes individuais. Um subcomando que não é reconhecido por um componente é ignorado.

Os valores de atributos atuais podem ser exibidos usando a sinalização -q . Se você não especificar o parâmetro ComponentSelector , os valores de atributo serão exibidos para todos os componentes que usam o rastreio de nível de componente

Customizações persistentes

As bandeiras -p e -P permitem que valores de atributo sejam especificados para componentes do sistema que ainda não foram criados. Assim, os atributos para componentes recém-criados podem ser customizados antes que os componentes se tornem ativos. O sinalizador -p é usado para especificar personalizações para componentes que serão criados no futuro, mas antes de você reiniciar o sistema operacional AIX. A sinalização -P é usada para especificar customizações que serão efetivadas após o próximo reinício. Essas customizações são incluídas no arquivo /var/adm/ras/raspertune . Você deve executar o comando bosboot para salvar essas customizações na imagem de inicialização e reiniciar o sistema operacional AIX para que as customizações surtam efeito.

O componente especificado pelo parâmetro ComponentSelectors com as sinalizações -p e -P pode conter caracteres de correspondência padrão. Assim, uma customização persistente pode se aplicar a mais de um componente. Além disso, várias customizações podem se aplicar ao mesmo componente, se diferentes componentes forem usados. Se valores de atributos conflitantes forem especificados em várias customizações, a última customização tem precedência. Se uma customização já existe para um componente especificado, a nova personalização substitui a antiga.

É possível especificar diversos componentes com o parâmetro ComponentSelectors quando as customizações persistentes são especificadas Em todos os casos, utilizar vários seletores é equivalente a especificar múltiplos comandos, cada um com um único seletor de componentes. Por exemplo, a customização ctctrl -p -l hdisk0 -l hdisk1 memtracenormal é equivalente às duas customizações seguintes:

ctctrl -p -l hdisk0 memtracenormal
ctctrl -p -l hdisk1 memtracenormal

Quando você usa a sinalização -D , um instantâneo de buffer de rastreio para componentes selecionados é despejado em arquivos. O diretório padrão é /var/adm/ras/trc_ct, mas você pode especificar um diretório de destino opcional. Um arquivo de rastreio por componente é usado; todos os arquivos são nomeados com os nomes de componentes completos. Os arquivos são gerados e gerenciados da mesma forma que o comando trace faz para vários arquivos do processador.

As customizações especificadas com a sinalização -p ou -P não são excluídas mesmo após serem usadas. Portanto, uma única customização pode afetar diversos novos componentes. Você pode especificar a sinalização -x para excluir customizações persistentes. Deve-se especificar o parâmetro ComponentSelector de forma idêntica à maneira especificada quando a customização é criada. Por exemplo, se uma customização for criada com o componente especificado por -l hdisk0, a customização não pode ser excluída com o componente especificado por -l hdisk[0], mesmo que ambos os componentes correspondam a um mesmo alias de componente. Quando uma customização persistente é excluída, nenhuma alteração é feita aos atributos de componentes criados quando a customização está ativa.

As customizações persistentes que são excluídas com as sinalizadores -x e -P permanecem em vigor a menos que você execute o comando bosta e reinicie o sistema operacional AIX . Você pode excluir uma customização persistente que é criada com a sinalização -P após o reinício usando as bandeiras -x e -p . Neste caso, a customização está ativa novamente se você reiniciar o sistema operacional AIX .

Se você não souber as customizações que foram feitas mas deseja restaurar a configuração padrão do sistema, você pode utilizar uma das seguintes formas:

No arquivo /var/adm/ras/raspertune , exclua as linhas relevantes para as customizações. Em seguida, execute o comando bosboot e reinicie o sistema operacional AIX .
Leia o arquivo /var/adm/ras/raspertune para descobrir as sinalizações e parâmetros apropriados que foram especificados. Em seguida, use a sinalização -x para excluir as customizações como mostrado no Exemplo 11. Execute o comando bosboot e reinicie o sistema operacional AIX .

As bandeiras -r e -u podem ser usadas ao especificar customizações persistentes. O uso de uma sinalização especifica um espaço de nome diferente para os seletores de componentes especificados. Usar ambas as bandeiras ao mesmo tempo equivale a duas invocações de comandos separadas, cada uma com uma das bandeiras. Por exemplo, a customização persistente ctctrl -p -l hdisk0 -u -r memtracedetail é equivalente às duas customizações separadas:

ctctrl -p -l hdisk0 -u memtracedetail
ctctrl -p -l hdisk0 -r memtracedetail

As customizações persistentes a seguir são todas distintas, e podem ser modificadas ou excluídas de forma independente.

ctctrl -p -l hdisk0 memtracedetail
ctctrl -p -l hdisk0 -r memtracedetail
ctctrl -p -l hdisk0 -u memtracedetail

As customizações recursivas (especificadas pela sinalização -r ) têm precedência sobre todas as outras customizações, independentemente da ordem em que são especificadas relativas a outras customizações não recursivas.

Você pode consultar customizações persistentes usando a sinalização -q com a bandeira -P ou -p . Especificar a sinalização -q com a sinalização -P exibe linhas do arquivo /var/adm/ras/raspertune . Especificar a sinalização -q com as bandeiras -p e -r exibe as customizações persistentes que você especificou originalmente com a bandeira -r . Sem a sinalização -r , as bandeiras -q e -p exibem as customizações persistentes que você especifica com ou sem a bandeira -u .

Você pode especificar vários subcomandos para uma customização persistente. Se você especificar subcomandos conflitantes, o último subcomando é usado. Por exemplo, os subcomandos memtracenormal e memtracedetail especificam valores diferentes para o mesmo atributo de verificação de erro, portanto, o último subcomando especificado é usado.

Sinalizações

Item	Descrição
-n	Aplica subcomandos imediatamente. Esta sinalização é o padrão se nem o -p nem a sinalização -P for usada.
-c componentList	Especifica uma lista de nomes de componentes. Separe os nomes na lista usando uma comma ou espaço em branco. A sinalização -c all seleciona todos os componentes se for o único ComponentSelector.
-D	Tira um instantâneo do buffer de memória privada do componente e dumps-o em arquivos (um arquivo por componente). O diretório de saída padrão pode ser alterado com a sinalização -d .
-d dirName	Especifica o diretório usado para o dump. O diretório padrão é /var/adm/ras/trc_ct. Se alguns arquivos já existem, eles são sobrescrito pelo novo pedido de dump. As bandeiras -p e -P são mutuamente exclusivas com a bandeira -d .
-h ou -?	Exibe uma mensagem de uso.
-l aliasList	Especifica uma lista de aliases de componentes. Separe os aliases usando uma vírgula ou espaço em branco.
-P	Especifica subcomandos que persistirá em reinicializações. Você deve executar o comando bosboot e reiniciar o AIX para que estes comandos sejam usados.
-x	Exclui a personalização persistente para os componentes especificados. O ' ComponentSelector(s) deve ser inserido exatamente como foi inserido quando a personalização foi originalmente especificada.
-p	Especifica subcomandos persistentes. Os subcomandos especificados são aplicados em componentes recém-criados.
-q	Exibe as configurações de rastreio do componente dos componentes. Esta sinalização também pode ser usada com a sinalização -p ou -P para exibir customizações persistentes.
-r	Aplica os subcomandos recorrentemente a todos os subcomponentes dos componentes selecionados.
-t tipo_subtipo	Especifica uma lista de nomes type ou type_subtype . Separe os nomes usando uma comma ou espaço em branco. Os nomes válidos do tipo incluem `device`, `filesystem`, `network`, `services`, `storage`e `ui`. Uma lista completa de nomes de type e type_subtype está no arquivo de cabeçalho /usr/include/sys/ras_base.h .
-u	Aplica os subcomandos recorrentemente aos ancestrais dos componentes especificados.

Nota: Você pode usar as bandeiras -u e -r juntas. Você pode usar várias bandeiras -c, -le -t na linha de comando.

Status de saída

Item	Descrição
0	O comando conclui com sucesso.
>0	Ocorre um erro.

Exemplos

Para fazer o dump do conteúdo de todos os buffers de Trace do Componente, use o seguinte comando:
```
ctctrl -D -c all
```
Para fazer o dump do conteúdo do buffer de Trace do Componente mbuf para /tmp, use o seguinte comando:
```
ctctrl -D -d /tmp -c mbuf
```
Para consultar o estado de todos os componentes cientes do Componente Trace, utilize o seguinte comando:
```
ctctrl -q
```
Para consultar o estado de apenas os componentes netinet , use o seguinte comando:
```
ctctrl -c netinet -q -r
```
Para ativar o modo de rastreio de memória para o componente socket , use o seguinte comando:
```
ctctrl memtraceon -c socket
```
Para desligar persistentemente o rastreio de componentes para todos os componentes, use o seguinte comando:
```
ctctrl -P memtraceoff
```
Nota: Um bosboot é necessário para tornar o comando persistente através de botas.
Para especificar uma customização persistente para o componente userdata de novos sistemas de arquivos JFS2 , use o seguinte comando:
```
ctctrl -p -c 'jfs2.filesystem.*.userdata' memtraceminimal
```
Nota: Os componentes de userdata existentes não são afetados.
Para especificar uma customização que persistirá através de reinícios, use o seguinte comando:
```
ctctrl -P -c 'jfs2.filesystem.*.userdata' memtraceminimal
```
Se você executar o comando bosboot e reiniciar o AIX, o rastreio de componente mínimo estará em vigor para todos os componentes de userdata do JFS2 .
Para configurar o rastreio de componente mínimo para todos os componentes de dados do JFS2 userdata, use o seguinte comando:
```
ctctrl -npP -c 'jfs2.filesystem.*.userdata' memtraceminimal
```
Para especificar vários valores de atributo persistente para o componente ethernet, use o seguinte comando:
```
ctctrl -P -c ethernet memtraceminimal memtracebufsize=1m
```
Para excluir a customização especificada no exemplo 7, use o seguinte comando:
```
ctctrl -p -x -c 'jfs2.filesystem.*.userdata'
```
Para listar toda a customização de atributo persistente, recursivo e recorrente, use o seguinte comando:
```
ctctrl -q -p -r
```
Para ativar todos os vestígios de componentes para o componente netmalloc, use o seguinte comando:
```
ctctrl memtracedetail -c netmalloc
```
ou
```
ctctrl memtracelevel=7 -c netmalloc
```
Para coletar os eventos de rastreio net_malloc_police no buffer de rastreio de componentes, use o seguinte comando:
```
ctctrl  memtracedetail -c netmalloc.police
```

Local

/usr/sbin/ctctrl

Arquivos

Item	Descrição
/var/adm/ras/raspertune	Um arquivo contendo personalização de atributo persistente que será aplicado após um reinício, se você executar o comando bosboot primeiro.
/var/adm/ras/trc_ct	O diretório padrão onde todos os snapshots de buffers são salvos.
trc_ct.master	Um arquivo de rastreio principal que aponta para os arquivos de rastreio de todos os componentes.