Commande ctctrl

Objectif

Modifie ou affiche les attributs de trace des composants système. Vous pouvez spécifier des valeurs d'attribut persistant pour les composants qui n'ont pas encore été créés.

Syntaxe

Pour modifier les attributs de trace de certains ou de tous les composants, utilisez la commande suivante:

ctctrl [ -n r u ] ComponentSelector... sous-commande ...

Pour vider des mémoires tampon de composant dans des fichiers, utilisez la commande suivante:

ctctrl [-r u] {-D [-d nom_rép] } ComponentSelector ...

Pour spécifier des valeurs d'attribut persistant pour les composants qui n'ont pas encore été créés, utilisez la commande suivante:

ctctrl -p [ -ru ] ComponentSelector... sous-commande ...

Pour spécifier des valeurs d'attribut persistant qui prendront effet après le prochain redémarrage, utilisez la commande suivante:

ctctrl -P [ -ru ] ComponentSelector... sous-commande ...

Pour supprimer des personnalisations d'attribut persistant, utilisez la commande suivante:

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

Pour interroger les attributs de trace des composants existants ou pour interroger la personnalisation des attributs persistants existants, utilisez la commande suivante:

ctctrl -q [-r u p P] {Sélecteur de composant ...}

Pour afficher un message d'utilisation, utilisez la commande suivante:

ctctrl {-h | -? }

Pour activer ou désactiver le traçage de la mémoire pour tous les composants de manière persistante, utilisez la commande suivante:

ctctrl -P {memtraceon | memtraceoff}

Les valeurs du paramètre ComponentSelector sont les suivantes:

-c: componentPatternList
-l: aliasPatternList
-t: typePatternList

Chaque liste se compose d'un ou de plusieurs modèles séparés par des espaces ou des virgules. Les modèles peuvent contenir des caractères spéciaux, comme décrit par la sous-routine fnmatch . Vous pouvez utiliser les caractères de modèle suivants:

?
*
[ ]

Vous ne pouvez pas utiliser de classes de caractères et de séquences de classement entre crochets ([ ]). La spécification de -c all sélectionne tous les composants, si aucun autre paramètre ComponentSelector n'est spécifié.

Descriptif

La commande ctctrl modifie ou affiche les paramètres de trace de certains ou de tous les composants. Les composants sont sélectionnés par nom, par alias ou par type ou sous-type. La commande ctctrl peut également être utilisée avec l'option -p ou -P pour spécifier la personnalisation des attributs persistants. Voir la section Persistant Customizations .

Pour activer ou désactiver la fonction de trace de niveau composant pour tous les composants immédiatement et de manière persistante, spécifiez la sous-commande memtraceon ou memtraceoff avec l'indicateur -P . Vous ne pouvez pas spécifier d'autres indicateurs ou sous-commandes avec l'indicateur -P . Vous devez utiliser la commande bosboot pour rendre les paramètres persistants d'un amorçage à l'autre.

L'attribut modifié dépend de la sous-commande transmise à la commande ctctrl . Plusieurs sous-commandes peuvent être utilisées dans un même appel ctctrl . Vous pouvez spécifier les sous-commandes suivantes:

Article	Descriptif
memtraceon	Active le mode trace de mémoire.
memtraceoff	Désactive le mode trace de mémoire.
memtraceresume	Reprend le mode de trace de mémoire.
memtracesuspend	Interrompt le mode trace de mémoire.
memtracebufsize=sz	Modifie la taille de la mémoire tampon privée allouée en mode trace de mémoire.
memtraceminimal	Remplace le niveau de mode de trace de mémoire par `1`.
memtracenormal	Remplace le niveau de mode de trace de mémoire par `3`.
memtracedetail	Remplace le niveau de mode de trace de mémoire par `7`.
memtracemax	Modifie le niveau du mode de trace de la mémoire en lui affectant le niveau de détail maximal `9`.
memtracelevel=d	Modifie le niveau de trace du mode de trace de la mémoire. Le définit sur le niveau spécifié.
memtracefilltime	Affiche le temps de conservation des données (c'est-à-dire le temps estimé pour remplir la mémoire tampon privée). Cette option est disponible uniquement si le mode de trace de mémoire est activé.
systraceon	Active la fonction de trace via la trace système.
systraceoff	Désactive le traçage via la trace système.
systraceminimal	Remplace le niveau de mode de trace système par `1`.
systracenormal	Remplace le niveau de mode de trace système par `3`.
systracedetail	Remplace le niveau de mode de trace système par `7`.
systracemax	Modifie le niveau du mode de trace système sur le niveau de détail maximal `9`.
systracelevel=d	Modifie le niveau de trace utilisé pour effectuer la trace via la trace système. La définit sur la valeur spécifiée.

Remarque: memtracesuspend, memtraceresume, et les sous-commandes memtracefilltime ne peuvent pas être utilisées avec l'option -p ou -P , car ces sous-commandes ne peuvent pas être utilisées dans les personnalisations persistantes.

Les autres sous-commandes qui ne figurent pas dans la liste précédente peuvent être reconnues par des composants individuels. Une sous-commande non reconnue par un composant est ignorée.

Les valeurs d'attribut en cours peuvent être affichées à l'aide de l'indicateur -q . Si vous ne spécifiez pas le paramètre ComponentSelector , les valeurs d'attribut sont affichées pour tous les composants qui utilisent la fonction de trace de niveau composant.

Personnalisations persistantes

Les indicateurs -p et -P permettent de spécifier des valeurs d'attribut pour les composants système qui n'ont pas encore été créés. Par conséquent, les attributs des composants nouvellement créés peuvent être personnalisés avant que les composants ne deviennent actifs. L'indicateur -p est utilisé pour spécifier les personnalisations des composants qui seront créés ultérieurement, mais avant le redémarrage du système d'exploitation AIX. L'indicateur -P est utilisé pour spécifier les personnalisations qui prendront effet après le prochain redémarrage. Ces personnalisations sont ajoutées au fichier /var/adm/ras/raspertune . Vous devez exécuter la commande bosboot pour sauvegarder ces personnalisations dans l'image d'amorçage et redémarrer le système d'exploitation AIX pour que les personnalisations soient prises en compte.

Le composant spécifié par le paramètre ComponentSelectors avec les indicateurs -p et -P peut contenir des caractères de correspondance de modèle. Ainsi, une personnalisation persistante peut s'appliquer à plusieurs composants. En outre, plusieurs personnalisations peuvent s'appliquer au même composant, si des composants différents sont utilisés. Si des valeurs d'attribut en conflit sont spécifiées dans plusieurs personnalisations, la dernière personnalisation est prioritaire. Si une personnalisation existe déjà pour un composant spécifié, la nouvelle personnalisation remplace l'ancienne.

Vous pouvez spécifier plusieurs composants avec le paramètre ComponentSelectors lorsque des personnalisations persistantes sont spécifiées. Dans tous les cas, l'utilisation de plusieurs sélecteurs équivaut à spécifier plusieurs commandes, chacune avec un seul sélecteur de composant. Par exemple, la personnalisation ctctrl -p -l hdisk0 -l hdisk1 memtracenormal est équivalente aux deux personnalisations suivantes:

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

Lorsque vous utilisez l'indicateur -D , une image instantanée des tampons de trace pour les composants sélectionnés est vidée dans des fichiers. Le répertoire par défaut est /var/adm/ras/trc_ct, mais vous pouvez spécifier un répertoire de destination facultatif. Un fichier de trace par composant est utilisé ; tous les fichiers sont nommés avec les noms complets des composants. Les fichiers sont générés et gérés de la même manière que la commande trace pour plusieurs fichiers de processeur.

Les personnalisations spécifiées avec l'indicateur -p ou -P ne sont pas supprimées même après leur utilisation. Par conséquent, une seule personnalisation peut affecter plusieurs nouveaux composants. Vous pouvez spécifier l'indicateur -x pour supprimer les personnalisations persistantes. Vous devez spécifier le paramètre ComponentSelector de la même manière que vous le spécifiez lors de la création de la personnalisation. Par exemple, si une personnalisation est créée avec le composant spécifié par -l hdisk0, la personnalisation ne peut pas être supprimée avec le composant spécifié par -l hdisk[0], même si les deux composants correspondent au même alias de composant. Lorsqu'une personnalisation persistante est supprimée, aucune modification n'est apportée aux attributs des composants créés lorsque la personnalisation est active.

Les personnalisations persistantes qui sont supprimées avec les indicateurs -x et -P restent en vigueur sauf si vous exécutez la commande amorçage du bosse et redémarrez le système d'exploitation AIX . Vous pouvez supprimer une personnalisation persistante créée avec l'indicateur -P après le redémarrage à l'aide des indicateurs -x et -p . Dans ce cas, la personnalisation est à nouveau active si vous redémarrez le système d'exploitation AIX .

Si vous ne connaissez pas les personnalisations effectuées mais que vous souhaitez restaurer le paramètre système par défaut, vous pouvez utiliser l'une des méthodes suivantes:

Dans le fichier /var/adm/ras/raspertune , supprimez les lignes correspondant aux personnalisations. Exécutez ensuite la commande bosboot et redémarrez le système d'exploitation AIX .
Lisez le fichier /var/adm/ras/raspertune pour déterminer les indicateurs et paramètres appropriés qui ont été spécifiés. Utilisez ensuite l'indicateur -x pour supprimer les personnalisations, comme illustré dans l'exemple 11. Exécutez la commande bosboot et redémarrez le système d'exploitation AIX .

Les indicateurs -r et -u peuvent être utilisés lors de la spécification de personnalisations persistantes. L'utilisation d'un indicateur spécifie un espace de nom différent pour les sélecteurs de composant spécifiés. L'utilisation des deux indicateurs en même temps équivaut à deux appels de commande distincts, chacun avec l'un des indicateurs. Par exemple, la personnalisation persistante ctctrl -p -l hdisk0 -u -r memtracedetail est équivalente aux deux personnalisations distinctes suivantes:

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

Les personnalisations persistantes suivantes sont toutes distinctes et peuvent être modifiées ou supprimées indépendamment.

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

Les personnalisations récursives (spécifiées par l'indicateur -r ) sont prioritaires sur toutes les autres personnalisations, quel que soit l'ordre dans lequel elles sont spécifiées par rapport aux autres personnalisations non récursives.

Vous pouvez interroger les personnalisations persistantes à l'aide de l'indicateur -q avec l'indicateur -P ou -p . La spécification de l'indicateur -q avec l'indicateur -P affiche les lignes du fichier /var/adm/ras/raspertune . La spécification de l'indicateur -q avec les indicateurs -p et -r affiche les personnalisations persistantes que vous avez spécifiées à l'origine avec l'indicateur -r . Sans l'indicateur -r , les indicateurs -q et -p affichent les personnalisations persistantes que vous spécifiez avec ou sans l'indicateur -u .

Vous pouvez spécifier plusieurs sous-commandes pour une personnalisation persistante. Si vous spécifiez des sous-commandes en conflit, la dernière sous-commande est utilisée. Par exemple, les sous-commandes memtracenormal et memtracedetail spécifient des valeurs différentes pour le même attribut de vérification des erreurs, de sorte que la dernière sous-commande spécifiée est utilisée.

Indicateurs

Article	Descriptif
-n	Applique les sous-commandes immédiatement. Il s'agit de l'option par défaut si ni l'option -p ni l'option -P n'est utilisée.
-c componentList	Indique une liste de noms de composant. Séparez les noms dans la liste à l'aide d'une virgule ou d'un espace. L'indicateur -c all sélectionne tous les composants s'il s'agit du seul ComponentSelector.
-D	Prend une image instantanée de la mémoire tampon privée du composant et la vide dans des fichiers (un fichier par composant). Le répertoire de sortie par défaut peut être modifié à l'aide de l'indicateur -d .
-d dirName	Indique le répertoire utilisé pour le cliché. Le répertoire par défaut est /var/adm/ras/trc_ct. Si certains fichiers existent déjà, ils sont remplacés par la nouvelle demande de vidage. Les indicateurs -p et -P s'excluent mutuellement avec l'indicateur -d .
-h ou -?	Affiche un message d'utilisation.
-l aliasList	Indique une liste d'alias de composant. Séparez les alias à l'aide d'une virgule ou d'un espace.
-P	Indique les sous-commandes qui seront conservées lors des redémarrages. Vous devez exécuter la commande bosboot et redémarrer AIX pour que ces commandes soient utilisées.
-x	Supprime la personnalisation persistante pour les composants spécifiés. Le " ComponentSelector(s) doit être saisi exactement comme il l'a été lors de la spécification initiale de la personnalisation.
-p	Indique les sous-commandes persistantes. Les sous-commandes spécifiées sont appliquées aux composants nouvellement créés.
-q	Affiche les paramètres de trace des composants. Cet indicateur peut également être utilisé avec l'indicateur -p ou -P pour afficher les personnalisations persistantes.
-r	Applique les sous-commandes de manière récursive à tous les sous-composants des composants sélectionnés.
-t type_sous-type	Indique une liste de noms type ou type_subtype . Séparez les noms à l'aide d'une virgule ou d'un espace. Les noms de type valides incluent `device`, `filesystem`, `network`, `services`, `storage`et `ui`. La liste complète des noms type et type_subtype se trouve dans le fichier d'en-tête /usr/include/sys/ras_base.h .
-u	Applique les sous-commandes de manière récursive aux ancêtres des composants spécifiés.

Remarque: Vous pouvez utiliser les indicateurs -u et -r ensemble. Vous pouvez utiliser plusieurs indicateurs -c, -let -t sur la ligne de commande.

Statut de sortie

Article	Descriptif
0	La commande a abouti.
>0	Une erreur s'est produite.

Exemples

Pour vider le contenu de toutes les mémoires tampon de trace de composant, utilisez la commande suivante:
```
ctctrl -D -c all
```
Pour vider le contenu de la mémoire tampon de trace de composant mbuf dans /tmp, utilisez la commande suivante:
```
ctctrl -D -d /tmp -c mbuf
```
Pour interroger l'état de tous les composants prenant en compte la trace de composant, utilisez la commande suivante:
```
ctctrl -q
```
Pour interroger uniquement l'état des composants netinet , utilisez la commande suivante:
```
ctctrl -c netinet -q -r
```
Pour activer le mode de traçage de la mémoire pour le composant socket , utilisez la commande suivante:
```
ctctrl memtraceon -c socket
```
Pour désactiver de manière permanente le traçage des composants pour tous les composants, utilisez la commande suivante:
```
ctctrl -P memtraceoff
```
Remarque: Un bosboot est requis pour rendre la commande persistante entre les amorçages.
Pour spécifier une personnalisation permanente pour le composant userdata des nouveaux systèmes de fichiers JFS2 , utilisez la commande suivante:
```
ctctrl -p -c 'jfs2.filesystem.*.userdata' memtraceminimal
```
Remarque: Les composants userdata existants ne sont pas affectés.
Pour spécifier une personnalisation qui sera conservée lors des redémarrages, utilisez la commande suivante:
```
ctctrl -P -c 'jfs2.filesystem.*.userdata' memtraceminimal
```
Si vous exécutez la commande bosboot et que vous redémarrez AIX, le traçage minimal des composants sera appliqué à tous les composants JFS2 userdata.
Pour définir un traçage de composant minimal pour tous les composants de données utilisateur JFS2 , utilisez la commande suivante:
```
ctctrl -npP -c 'jfs2.filesystem.*.userdata' memtraceminimal
```
Pour spécifier plusieurs valeurs d'attribut persistant pour le composant Ethernet, utilisez la commande suivante:
```
ctctrl -P -c ethernet memtraceminimal memtracebufsize=1m
```
Pour supprimer la personnalisation spécifiée dans l'exemple 7, utilisez la commande suivante:
```
ctctrl -p -x -c 'jfs2.filesystem.*.userdata'
```
Pour répertorier toutes les personnalisations d'attribut récursives persistantes, utilisez la commande suivante:
```
ctctrl -q -p -r
```
Pour activer toutes les traces de composant pour le composant netmalloc, utilisez la commande suivante:
```
ctctrl memtracedetail -c netmalloc
```
ou
```
ctctrl memtracelevel=7 -c netmalloc
```
Pour collecter des événements de trace net_malloc_police dans la mémoire tampon de trace de composant, utilisez la commande suivante:
```
ctctrl  memtracedetail -c netmalloc.police
```

Emplacement

/usr/sbin/ctctrl

Fichiers

Article	Descriptif
/var/adm/ras/raspertune	Fichier contenant la personnalisation d'attribut persistant qui sera appliquée après un redémarrage, si vous exécutez d'abord la commande bosboot .
/var/adm/ras/trc_ct	Répertoire par défaut dans lequel sont sauvegardées toutes les images instantanées des mémoires tampon.
trc_ct.master	Fichier de trace maître qui pointe vers les fichiers de trace de tous les composants.