Options de ligne de commande KD

Les utilisateurs de KD à la première fois doivent commencer par la section Débogage à l’aide de KD et NTKD .

La ligne de commande KD utilise la syntaxe suivante.

kd [ -server ServerTransport | -remote ClientTransport ] 
   [-b | -x] [-d] [-bonc] [-m] [-myob] [-lines] [-n] [-r] [-s] 
   [-v] [-clines lines] [-failinc] [-noio] [-noshell] 
   [-secure] [-sdce] [-ses] [-sicv] [-sins] [-snc] [-snul]
   [-sup] [-sflags 0xNumber] [-log{a|au|o|ou} LogFile] 
   [-aExtension] [-zp PageFile] 
   [-i ImagePath] [-y SymbolPath]  [-srcpath SourcePath] 
   [-k ConnectType | -kl | -kqm | -kx ExdiOptions] [-ee {masm|c++}] 
   [-z DumpFile] [-cf "filename"] [-cfr "filename"] [-c "command"] 
   [-t PrintErrorLevel] [-version] 

kd -iu KeyString

kd -QR Server 

kd -wake PID 

kd -?

Les descriptions des options de ligne de commande KD suivent. Seules les options -remote et -server respectent la casse. Le trait d’union initial peut être remplacé par une barre oblique (/). Les options qui ne prennent pas de paramètres supplémentaires peuvent être concaténées. Par conséquent , kd -r -n -v peut être écrit en tant que kd -rnv.

Si l’option -remote ou -server est utilisée, elle doit apparaître avant toute autre option sur la ligne de commande.

Paramètres

-serveur ServerTransport
Crée un serveur de débogage accessible par d’autres débogueurs. Pour obtenir une explication du serveur ServerTransport possible, consultez Activation d’un serveur de débogage. Lorsque ce paramètre est utilisé, il doit s’agir des premiers paramètres de la ligne de commande.

-lointain ClientTransport
Crée un client de débogage et se connecte à un serveur de débogage déjà en cours d’exécution. Pour obtenir une explication des valeurs ClientTransport possibles, consultez Activation d’un client de débogage. Lorsque ce paramètre est utilisé, il doit s’agir des premiers paramètres de la ligne de commande.

-un Extension
Définit la DLL d’extension par défaut. La valeur par défaut est kdextx86.dll ou kdexts.dll. Il ne doit pas y avoir d’espace après « a », et l’extension de nom de fichier .dll ne doit pas être incluse. 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.

-b
Cette option n’est plus prise en charge.

-bonc
Si cette option est spécifiée, le débogueur se décompose dans la cible dès que la session commence. Cela est particulièrement utile lors de la connexion à un serveur de débogage qui peut ne pas être actuellement rompu dans la cible.

-c "command"
Spécifie la commande de débogueur initiale à exécuter au démarrage. Cette commande doit être entourée de guillemets. Plusieurs commandes peuvent être séparées par des points-virgules. (Si vous avez une longue liste de commandes, il peut être plus facile de les placer dans un script, puis d’utiliser l’option -c avec la commande $<, $><, $><, $, $$>< (Exécuter le fichier de script).)

Si vous démarrez un client de débogage, cette commande doit être destinée au serveur de débogage. Les commandes spécifiques au client, telles que .lsrcpath, ne sont pas autorisées.

-cf "nom de fichier "
Spécifie le chemin d’accès et le nom d’un fichier de script. Ce fichier de script est exécuté dès que le débogueur est démarré. Si le nom de fichier contient des espaces, il doit être placé entre guillemets. Si le chemin d’accès est omis, le répertoire actif est supposé. Si l’option -cf n’est pas utilisée, le fichier ntsd.ini dans le répertoire actif est utilisé comme fichier de script. Si le fichier n’existe pas, aucune erreur ne se produit. Pour plus d’informations, consultez Utilisation des fichiers de script.

-cfr "nom de fichier "
Spécifie le chemin d’accès et le nom d’un fichier de script. Ce fichier de script est exécuté dès que le débogueur est démarré et chaque fois que la cible est redémarrée. Si le nom de fichier contient des espaces, il doit être placé entre guillemets. Si le chemin d’accès est omis, le répertoire actif est supposé. Si le fichier n’existe pas, aucune erreur ne se produit. Pour plus d’informations, consultez Utilisation des fichiers de script.

-Clines Lignes
Définit le nombre approximatif de commandes dans l’historique des commandes qui sont accessibles pendant le débogage à distance. Pour plus d’informations et pour d’autres façons de modifier ce nombre, consultez Utilisation des commandes du débogueur.

-d
Après un redémarrage, le débogueur se décompose dans l’ordinateur cible dès qu’un module de noyau est chargé. (Ce saut est antérieur à l’arrêt de l’option -b .) Consultez Blocage et redémarrage de l’ordinateur cible pour plus d’informations et pour d’autres méthodes de modification de cet état.

-ee {masm|c++}
Définit l’évaluateur d’expression par défaut. Si masm est spécifié, la syntaxe d’expression MASM est utilisée. Si c++ est spécifié, la syntaxe de l’expression C++ est utilisée. Si l’option -ee est omise, la syntaxe d’expression MASM est utilisée comme valeur par défaut. Pour plus d’informations, consultez Évaluation des expressions .

-failinc
Provoque l’ignorer des symboles interrogeables. Lors du débogage d’un fichier minidump en mode utilisateur ou en mode noyau, cette option empêche également le débogueur de charger les modules dont les images ne peuvent pas être mappées. Pour plus d’informations et pour d’autres méthodes de contrôle, consultez SYMOPT_EXACT_SYMBOLS.

-Je ImagePath
Spécifie l’emplacement des exécutables qui ont généré l’erreur. Si le chemin contient des espaces, il doit être placé entre guillemets.

-Ui KeyString
Inscrit la communication à distance du débogueur en tant que type d’URL afin que les utilisateurs puissent lancer automatiquement un client distant de débogueur avec une URL. KeyString a le format remdbgeng://RemotingOption. RemotingOption est une chaîne qui définit le protocole de transport tel que défini dans la rubrique Activation d’un client de débogage. Si cette action réussit, aucun message n’est affiché ; en cas d’échec, un message d’erreur s’affiche.

Le paramètre -iu ne doit pas être utilisé avec d’autres paramètres. Cette commande ne démarre pas réellement KD.

-k ConnectType
Indique au débogueur comment se connecter à la cible. Pour plus d’informations, consultez Débogage à l’aide de KD et NTKD.

-Kl
Démarre une session de débogage du noyau sur la même machine que le débogueur.

-kqm
Démarre KD en mode silencieux.

-kx ExdiOptions
Démarre une session de débogage de noyau à l’aide d’un pilote EXDI. Les pilotes EXDI ne sont pas décrits dans cette documentation. Si vous disposez d’une interface EXDI pour votre sonde matérielle ou simulateur matériel, contactez Microsoft pour obtenir des informations de débogage.

-Lignes
Active le débogage de ligne source. Si cette option est omise, la commande .lines (Basculer la prise en charge des lignes sources) doit être utilisée avant que le débogage source ne soit autorisé. Pour obtenir d’autres méthodes de contrôle, consultez SYMOPT_LOAD_LINES.

-log{a|au|o|ou} LogFile
Commence la journalisation des informations dans un fichier journal. Si LogFile existe déjà, il est remplacé si -logo est utilisé, ou la sortie est ajoutée au fichier si -loga est utilisé. Les options -logau et -logou fonctionnent respectivement comme -loga et -logo , sauf que le fichier journal est un fichier Unicode. Pour plus d’informations, consultez Conservation d’un fichier journal dans KD.

-m
Indique que le port série est connecté à un modem. Indique au débogueur de surveiller le signal de détection de l’opérateur.

-Myob
S’il existe une incompatibilité de version avec dbghelp.dll, le débogueur continuera à s’exécuter. (Sans le commutateur -myob , cela est considéré comme une erreur irrécupérable.)

Un effet secondaire de cette option est que l’avertissement qui apparaît normalement lors de la rupture dans l’ordinateur cible est supprimé.

-n
Chargement de symboles bruyants : active la sortie détaillée du gestionnaire de symboles. Pour plus d’informations et pour d’autres méthodes de contrôle, consultez SYMOPT_DEBUG.

-noio
Empêche le serveur de débogage d’être utilisé pour l’entrée ou la sortie. L’entrée est acceptée uniquement à partir du client de débogage (ainsi que toute commande initiale ou script de commande spécifié par l’option de ligne de commande -c ).

Toutes les sorties sont dirigées vers le client de débogage. Pour plus d’informations, consultez Activation d’un serveur de débogage.

-noshell
Interdit toutes les commandes .shell . Cette interdiction durera tant que le débogueur est en cours d’exécution, même si une nouvelle session de débogage est commencée. Pour plus d’informations et pour d’autres façons de désactiver les commandes de l’interpréteur de commandes, consultez Utilisation des commandes shell.

-QR Serveur
Répertorie tous les serveurs de débogage s’exécutant sur le serveur réseau spécifié. La barre oblique inverse (\\) précédente est facultative. Pour plus d’informations, consultez La recherche de serveurs de débogage.

Le paramètre -QR ne doit pas être utilisé avec d’autres paramètres. Cette commande ne démarre pas réellement KD.

-r
Affiche les registres.

-s
Désactive le chargement de symboles différés. Cela ralentit le démarrage du processus. Pour plus d’informations et pour d’autres méthodes de contrôle, consultez SYMOPT_DEFERRED_LOADS.

-sdce
Provoque l’affichage des boîtes de dialogue d’erreur d’accès aux fichiers pendant le chargement des symboles. Pour plus d’informations et pour d’autres méthodes de contrôle, consultez SYMOPT_FAIL_CRITICAL_ERRORS.

-sûr
Active le mode sécurisé.

-ses
Fait en sorte que le débogueur effectue une évaluation stricte de tous les fichiers de symboles et ignore les symboles questionnables. Pour plus d’informations et pour d’autres méthodes de contrôle, consultez SYMOPT_EXACT_SYMBOLS.

-sflags 0xNombre
Définit toutes les options du gestionnaire de symboles à la fois. Le nombre doit être un nombre hexadécimal précédé de 0x : un nombre décimal sans 0x est autorisé, mais les options de symbole sont des indicateurs binaires et, par conséquent, hexadécimal est recommandé. Cette option doit être utilisée avec précaution, car elle remplace tous les gestionnaires de symboles par défaut. Pour plus d’informations, consultez Définition des options de symbole.

-sicv
Provoque l’ignorer du gestionnaire de symboles. Pour plus d’informations et pour d’autres méthodes de contrôle, consultez SYMOPT_IGNORE_CVREC.

-Péchés
Le débogueur ignore le chemin d’accès aux symboles et les variables d’environnement de chemin d’accès d’image exécutables. Pour plus d’informations, consultez SYMOPT_IGNORE_NT_SYMPATH.

-snc
Provoque la désactivation de la traduction C++ par le débogueur. Pour plus d’informations et pour d’autres méthodes de contrôle, consultez SYMOPT_NO_CPP.

-snul
Désactive le chargement automatique des symboles pour les noms non qualifiés. Pour plus d’informations et pour d’autres méthodes de contrôle, consultez SYMOPT_NO_UNQUALIFIED_LOADS.

-srcpath SourcePath
Spécifie le chemin de recherche du fichier source. Séparez plusieurs chemins d’accès par un point-virgule ( ;). Si le chemin contient des espaces, il doit être placé entre guillemets. Pour plus d’informations et pour d’autres façons de modifier ce chemin d’accès, consultez Chemin d’accès source.

-souper
Provoque la recherche du gestionnaire de symboles dans la table de symboles publiques pendant chaque recherche de symboles. Pour plus d’informations et pour d’autres méthodes de contrôle, consultez SYMOPT_AUTO_PUBLICS.

-t PrintErrorLevel
Spécifie le niveau d’erreur qui entraîne l’affichage d’un message d’erreur par le débogueur. Il s’agit d’un nombre décimal égal à 0, 1, 2 ou 3. Les valeurs sont décrites comme suit :

Valeur	Constant	Signification
0	NONE	N’affichez aucune erreur.
1	ERROR	Afficher les événements de débogage au niveau erreur.
2	MINORERROR	Afficher les événements de débogage au niveau MINORERROR et ERROR.
3	AVERTISSEMENT	Afficher les événements de débogage au niveau AVERTISSEMENT, MINORERROR et ERROR.

Ce niveau d’erreur a uniquement une signification dans les builds vérifiées de Microsoft Windows. La valeur par défaut est 1. Les builds vérifiées étaient disponibles sur les anciennes versions de Windows, avant la version 1803 de Windows 10.

-v
Génère des messages détaillés pour les chargements, les chargements différés et les déchargements.

-Version
Imprime la chaîne de version du débogueur.

-réveiller PID
Provoque la fin du mode veille pour le débogueur en mode utilisateur dont l’ID de processus est spécifié par piD. Cette commande doit être émise sur l’ordinateur cible pendant le mode veille. Veuillez consulter la section Contrôler le débogueur en mode utilisateur depuis le débogueur noyau pour plus de détails.

Le paramètre -wake ne doit pas être utilisé avec d’autres paramètres. Cette commande ne démarre pas réellement KD.

-x
Provoque l’arrêt du débogueur lorsqu’une exception se produit d’abord, plutôt que de laisser l’application ou le module qui a provoqué la gestion de l’exception. (Identique à -b, sauf avec un eb nt initial  ! NtGlobalFlag 9 ; g command.)

-y SymbolPath
Spécifie le chemin de recherche de symboles. Séparez plusieurs chemins d’accès par un point-virgule ( ;). Si le chemin contient des espaces, il doit être placé entre guillemets. Pour plus d’informations et pour d’autres façons de modifier ce chemin, consultez Chemin d’accès aux symboles.

-z DumpFile
Spécifie le nom d’un fichier de vidage sur incident à déboguer. Si le chemin d’accès et le nom de fichier contiennent des espaces, cela doit être entouré de guillemets. Il est possible d’ouvrir plusieurs fichiers de vidage à la fois en incluant plusieurs options -z, chacune suivie d’une valeur DumpFile différente. Pour plus d’informations, consultez Analyse d’un fichier de vidage en mode noyau avec KD.

-zp PageFile
Spécifie le nom d’un fichier de page modifié. Cela est utile si vous déboguez un fichier de vidage et que vous souhaitez utiliser la commande .pagein (page en mémoire). Vous ne pouvez pas utiliser -zp avec un fichier de page Windows standard. Seuls les fichiers de page modifiés spécialement peuvent être utilisés.

- ?
Affiche le texte d’aide de ligne de commande.

KD détecte automatiquement la plateforme sur laquelle la cible est en cours d’exécution. Vous n’avez pas besoin de spécifier la cible sur la ligne de commande KD. L’ancienne syntaxe (à l’aide du nom I386KD ou IA64KD) est obsolète.