Configuration de tools.ini

  • Article

Le fichier tools.ini contient des informations pour initialiser les débogueurs de ligne de commande. Au démarrage, le débogueur recherche l’en-tête de section approprié dans le fichier tools.ini et extrait les informations d’initialisation des entrées sous l’en-tête. Chaque débogueur de ligne de commande a son propre en-tête de section : [CDB], [NTSD] et [KD]. La variable d’environnement INIT doit pointer vers le répertoire contenant le fichier tools.ini.

WinDbg n’utilise pas le fichier tools.ini. Au lieu de cela, WinDbg enregistre les paramètres d’initialisation dans les espaces de travail.

Les entrées tools.ini sont indiquées dans le tableau suivant.

Les mots clés doivent être séparés des valeurs par un espace blanc ou un signe deux-points. Les mots clés ne respectent pas la casse.

Pour les valeurs TRUE ou FALSE , « FALSE » est la seule valeur false. Tout le reste est VRAI.

Entrée Description

$u 0 :value ... $u 9 :value

Attribuez des valeurs à des alias de nom fixe. Vous pouvez spécifier des valeurs numériques n ou 0xn ou toute autre chaîne. Pour plus d’informations, consultez Utilisation d’alias . Aucune ligne de commande équivalente.

DebugChildren :flag

TRUE ou FALSE. Si la valeur est TRUE, CDB débogue l’application spécifiée ainsi que tous les processus enfants qu’elle peut générer. L’équivalent de ligne de commande est -o.

DebugOutput :flag

TRUE ou FALSE. Si la valeur est TRUE, la base de données CDB envoie la sortie et reçoit l’entrée via un terminal. Si la valeur est FALSE, la sortie est envoyée à l’écran de l’utilisateur. L’option de ligne de commande -d est similaire, mais pas identique.

IniFile :file

Spécifie le nom du fichier de script à partir duquel CDB ou KD prend des commandes au démarrage. La valeur par défaut est le fichier ntsd.ini dans le répertoire actif. L’équivalent de ligne de commande est -cf. Pour plus d’informations, consultez Utilisation de fichiers de script.

LazyLoad :flag

TRUE ou FALSE. Si la valeur EST TRUE, CDB effectue le chargement de symboles paresseux ; autrement dit, les symboles ne sont pas chargés tant que cela n’est pas nécessaire. L’équivalent de ligne de commande est -s.

Pour plus d’informations et d’autres méthodes de définition de cette option, consultez Chargement différé de symboles.

SetDll :filename

Définissez la DLL d’extension. L’extension de nom de fichier .dll doit être omise. La valeur par défaut est userexts.dll. L’équivalent de ligne de commande est -a.

Pour plus d’informations et pour d’autres méthodes permettant de définir cette valeur par défaut, consultez Chargement des DLL d’extension de débogueur.

StopFirst :flag

TRUE ou FALSE. Si la valeur est true, CDB s’arrête sur le point d’arrêt à la fin du processus de chargement d’images. L’équivalent de ligne de commande est -g.

StopOnProcessExit :flag

TRUE ou FALSE. Si la valeur EST TRUE, la base de données CDB s’arrête lorsqu’elle reçoit une notification d’arrêt de processus. L’équivalent de ligne de commande est -G.

sxd :eventsxe :event

Définit la réponse du débogueur et la gestion des status pour l’exception ou l’événement spécifié.

Les exceptions et les événements peuvent être spécifiés de la manière suivante :

*: Exception par défaut n : Exception n (décimal) 0xn : Exception 0xn (hexadécimale) (autre) : code d’événement

Pour plus d’informations sur ce processus et pour d’autres méthodes de contrôle de ces paramètres, consultez Contrôle des exceptions et des événements .

VerboseOutput :flag

TRUE ou FALSE. Si la valeur est TRUE, CDB affiche des informations détaillées sur la gestion des symboles, la notification d’événement et d’autres occurrences au moment de l’exécution. L’équivalent de ligne de commande est -v.

lines :flag

TRUE ou FALSE. L’indicateur lignes active ou désactive la prise en charge des informations de ligne source.

srcopt :options

Définit les options de ligne source qui contrôlent l’affichage de la source et les options de pas à pas de programme. Pour plus d’informations, consultez l+, l- (Définir les options source).

srcpath :directory

Définit le chemin de recherche du fichier source. Pour plus d’informations, consultez .srcpath, .lsrcpath (Définir le chemin source).

enable_unicode :flag

TRUE ou FALSE. L’indicateur enable_unicode spécifie si le débogueur affiche des pointeurs et des tableaux USHORT sous forme de chaînes Unicode.

force_radix_output :flag

TRUE ou FALSE. L’indicateur force_radix_output spécifie si les entiers sont affichés au format décimal ou dans le radix par défaut.

col_mode :flag

TRUE ou FALSE. L’indicateur col_mode contrôle le paramètre de mode de couleur. Lorsque le mode couleur est activé, le débogueur peut produire une sortie de couleur. Par défaut, la plupart des couleurs ne sont pas définies et par défaut sur les couleurs de la console actuelle.

col :namecolspec

Le nom indique l’élément que vous coloriez. Le colspec est un indicateur RVB à trois lettres de la forme [rR-][gG-][bB-]. Une lettre minuscule indique plus sombre, une lettre majuscule indique plus clair et un tiret indique qu’aucune contribution de composant de couleur n’est apportée. En raison des limitations de couleur de la console, la luminosité n’est pas réellement par composant, mais s’applique à tous les composants si une demande est lumineuse. En d’autres termes, rgB est identique à RVB. Pour cette raison, il est recommandé d’utiliser toutes les majuscules si des majuscules sont utilisées.

Exemple d’utilisation :

col : emphfg R--

Voici un exemple de section [NTSD] dans le fichier tools.ini :

[NTSD]
sxe: 3c
sxe: cc
$u0: VeryLongName
VerboseOutput:true