Partager via

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 affichées dans le tableau suivant.

Les mots clés doivent être séparés des valeurs par espace blanc ou 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 : valeur ... $u 9 : valeur

Affectez 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 des 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’il peut générer. L’équivalent de ligne de commande est -o.

DebugOutput : indicateur

TRUE ou FALSE. Si la valeur est TRUE, CDB envoie la sortie et reçoit des entrées 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 : fichier

Spécifie le nom du fichier de script que CDB ou KD accepte les 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 des fichiers de script.

LazyLoad : indicateur

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

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

SetDll : nom de fichier

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 d’autres méthodes de définition de cette valeur par défaut, consultez Chargement des DLL d’extension de débogueur.

StopFirst : indicateur

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 : indicateur

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

sxd : événementsxe : événement

Définit la réponse du débogueur et l’état de gestion de l’exception ou de 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écimale) 0xn : exception 0xn (hexadécimal) (autre) : code d’événement

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

VerboseOutput : indicateur

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 en ligne de commande est -v.

lignes : indicateur

TRUE ou FALSE. L’indicateur de 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 les options d’affichage de code source et de programme pas à pas. Pour plus d’informations, consultez l+, l- (Définir les options de source).

srcpath : répertoire

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

enable_unicode : indicateur

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 : indicateur

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 : indicateur

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

col : name colspec

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 brillante et un tiret indique aucune contribution de composant de couleur. 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 vont être 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