Kdb, commande
Permet l'examen d'un cliché système ou d'un noyau en cours d'exécution.
Syntaxe
kdb -h
kdb [-c CommandFile] [-cp] [-i HeaderFile] [-l] [-script] [-v] [SystemImageFile [KernelFile [KernelModule ...]]]
kdb [-c CommandFile] [-cp] [-i HeaderFile] [-l] [-script] [-v] [-m SystemImageFile] [-u KernelFile] [-k KernelModule]
Descriptif
La commande kdb est un utilitaire interactif qui permet d'examiner une image de système d'exploitation ou le noyau en cours d'exécution. La commande kdb interprète et formate les structures de contrôle dans le système et fournit diverses fonctions permettant d'examiner un vidage.
Le paramètre SystemImageFile indique le fichier qui contient l'image du système. La valeur peut indiquer un vidage système, le nom d'une unité de vidage ou le fichier spécial /dev/pmem . Le SystemImageFile par défaut est " /dev/pmem.
Le paramètre KernelFile spécifie le noyau AIX que kdb utilisera pour résoudre les définitions de symboles du noyau. Un fichier de noyau doit être disponible. Lors de l'examen d'un cliché système, il est impératif que le fichier de noyau soit le même que le noyau utilisé pour prendre le cliché système. La valeur par défaut de KernelFile est /unix.
Les paramètres KernelModule spécifient les noms de fichier des modules de noyau supplémentaires que la commande kdb utilise pour résoudre les définitions de symbole introuvables dans le fichier de noyau lui-même.
Des droits d'accès root sont requis pour l'utilisation de la commande kdb sur le système actif. Cette opération est obligatoire car le fichier spécial /dev/pmem est utilisé. Pour exécuter la commande kdb sur le système actif, entrez ce qui suit:
kdbPour appeler la commande kdb sur un fichier image système, entrez:
kdb SystemImageFileLorsque kdb démarre, il recherche un fichier .kdbinit dans le répertoire de base de l'utilisateur et dans le répertoire de travail en cours. Si un fichier .kdbinit existe dans l'un de ces emplacements, kdb exécute toutes les commandes dans le fichier comme si elles avaient été entrées à l'invite kdb interactive. Si un fichier .kdbinit existe dans ces deux emplacements, le fichier du répertoire de base sera traité en premier, suivi du fichier du répertoire de travail en cours (sauf si le répertoire en cours est le répertoire de base, auquel cas le fichier n'est traité qu'une seule fois).
Indicateurs
| Article | Descriptif |
|---|---|
| -c CommandFile | Indique un nom différent pour le fichier script de démarrage. Si cette option est utilisée, kdb recherche le paramètre CommandFile dans les répertoires de base et en cours, au lieu du fichier .kdbinit . |
| -cp | Permet à kdb d'imprimer chaque commande dans les fichiers de script de démarrage lors de l'exécution de cette commande. Cette commande peut être utilisée pour faciliter le débogage des fichiers .kdbinit (ou de tout autre fichier spécifié avec l'indicateur -c ). Chaque commande est imprimée avec un signe + (plus) devant elle. |
| -h | Affiche un court message d'aide en ce qui a trait à l'utilisation de la ligne de commande et une brève liste des options de ligne de commande disponibles. |
| -i HeaderFile | Rend toutes les structures C définies dans le paramètre HeaderFile disponibles pour une utilisation avec la sous-commande kdb print . Cette option requiert l'installation d'un compilateur C sur le système. Si la variable HeaderFile a besoin de fichiers .h supplémentaires pour être compilée, vous devez également les spécifier avec des options -i distinctes. |
| -k Module | Indique à kdb d'utiliser le paramètre Module comme module de noyau supplémentaire pour résoudre les définitions de symbole non trouvées dans le noyau lui-même. L'utilisation de cette option revient à spécifier le module de noyau avec le paramètre KernelModule . |
| -l | Désactive le pager en ligne (c'est-à-dire l'invite more
(^C to quit) ? ) dans kdb. Dans ce cas, la sous-commande set
scroll dans kdb n'a aucun effet et le pager en ligne est toujours désactivé quel que soit le paramètre de défilement. |
| -m Image | Indique à kdb d'utiliser le paramètre Image comme fichier image système. L'utilisation de cette option équivaut à spécifier le fichier image du système avec le paramètre SystemImageFile. |
| -script | Désactive le pager en ligne (c'est-à-dire l'invite more
(^C to quit) ? ) et désactive l'impression de la plupart des informations de statut lorsque kdb démarre. Cette option facilite l'analyse syntaxique de la sortie de la commande kdb par des scripts et d'autres programmes qui agissent en tant que programme frontal pour kdb. |
| -u Noyau | Indique à kdb d'utiliser Noyau comme fichier de noyau pour la résolution des définitions de symbole. L'utilisation de cette option revient à spécifier le noyau avec le paramètre KernelFile . |
| -v | Affiche la liste de toutes les tables de vidage de composant (CDT) dans le fichier de vidage système lorsque kdb démarre. Les CDT répertores les régions de mémoire qui sont effectivement incluses dans le vidage système. Si kdb est utilisé sur un système actif, cette option est ignorée. |
| -w | Il examine un fichier de noyau directement à la place d'une image système. Toutes les sous-commandes kdb qui affichent normalement des emplacements de mémoire à partir du fichier image système lisent les données directement à partir de KernelFile. Les sous-commandes qui écrivent de la mémoire ne sont pas disponibles. |
Exemples
Les exemples suivants illustrent les options d'appel de la commande kdb
- Pour appeler la commande kdb avec les fichiers d'image système et d'image de noyau par défaut, entrez:
kdbLe programme kdb renvoie une invite (0) > et attend l'entrée d'une sous-commande.
- Pour invoquer la commande 'kdb en utilisant un fichier dump nommé '
/var/adm/ras/vmcore.0et le fichier du noyau UNIX nommé '/unix, tapez :kdb /var/adm/ras/vmcore.0 /unixLe programme kdb renvoie une invite (0) > et attend l'entrée d'une sous-commande.
Fichiers
| Article | Descriptif |
|---|---|
| /usr/sbin/kdb | Contient la commande kdb . |
| /dev/pmem | Fichier image système par défaut |
| /unix | Fichier de noyau par défaut |