WinDbg - Options de démarrage de la ligne de commande
Démarrage de WinDbg
Une fois WinDbg installé, WinDbgX.exe est disponible pour s’exécuter à partir de n’importe quel emplacement de répertoire.
Options de démarrage de la ligne de commande
WinDbgX [options]
Les tableaux suivants résument les options de ligne de commande disponibles.
Options générales
| Option | Description |
|---|---|
| -c « command » | Exécute une ligne de commande après l’attachement du débogueur. Cette commande doit être placée entre guillemets. Plusieurs commandes peuvent être séparées par des points-virgules. |
| -v | Active la sortie détaillée dans le débogueur. |
| -T Title | Définit le titre de la fenêtre. |
| -logo LogFile | Ouvrir le journal. Commence la journalisation des informations dans un fichier journal. Si le fichier existe déjà, il sera remplacé. |
| -loga LogFile | Ajout de journal. Commence la journalisation des informations dans un fichier journal. Si le fichier existe, il est ajouté à . |
| -e EventHandle | Signale l’événement avec le handle donné après l’exception suivante dans une cible. |
| -? | Affiche un résumé des commandes disponibles. |
Options du noyau
| Option | Description |
|---|---|
| -k [ConnectType] | Démarre une session de débogage du noyau. Si -k est utilisé sans aucune option ConnectType , il doit s’agir de l’entrée finale sur la ligne de commande. |
| -kqm | Démarre KD en mode silencieux. |
| -Kl | Démarre une session de débogage du noyau sur la même machine que le débogueur. |
| -kx ExdiOptions | Démarre une session de débogage du noyau à l’aide d’un pilote EXDI. Pour plus d’informations sur EXDI, consultez Configuration du transport du débogueur EXDI. |
| -d | Après un redémarrage, le débogueur s’arrête sur l’ordinateur cible dès qu’un module de noyau est chargé. |
Options du mode utilisateur
| Option | Description |
|---|---|
| -o | Débogue tous les processus lancés par l’application cible (processus enfants). |
| -g | Ignore le point d’arrêt initial dans l’application cible. |
| -G | Ignore le point d’arrêt final dans l’application cible. |
| -Pv | Spécifie que le débogueur doit s’attacher au processus cible de manière non invasive. |
| -Hd | Spécifie que le tas de débogage ne doit pas être utilisé. |
| -cimp | Spécifie que tous les processus créés utilisent une ligne de commande implicite définie par le serveur au lieu d’une chaîne de ligne de commande donnée par l’utilisateur à partir du client. |
Options de la cible
| Option | Description |
|---|---|
| - remote ClientTransport | Se connecte à un serveur de débogage qui est 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. |
| -server ServerTransport | Crée un serveur de débogage accessible par d’autres débogueurs. Pour obtenir une explication des valeurs possibles de ServerTransport , consultez Activation d’un serveur de débogage. |
| -premote SmartClientTransport | Crée un client intelligent et se connecte à un serveur de processus qui est déjà en cours d’exécution. Pour obtenir une explication des valeurs SmartClientTransport possibles, consultez Activation d’un client intelligent. |
| -p PID | Spécifie l’ID de processus décimal à déboguer. |
| -tid TID | Spécifie l’ID de thread d’un thread à reprendre au démarrage de la session de débogage. |
| -psn ServiceName | Spécifie le nom du service contenu dans le processus à déboguer. Il est utilisé pour déboguer un processus qui est déjà en cours d’exécution. |
| -pn ProcessName | Spécifie le nom du processus à déboguer. |
| -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, celui-ci doit être entouré de guillemets. |
| -debugArch x86 -ou- amd64 | Remplacez le comportement de détection automatique et définissez le nombre de bits cible pour le débogueur. |
| -loadSession | Chargez un fichier de configuration de session enregistré. |
| -setupFirewallRules | Configure les règles de pare-feu requises sur le système local pour autoriser le débogage du noyau à l’aide de KDNET. |
| -openPrivateDumpByHandle Handle | Utilisation interne de Microsoft uniquement. Spécifie le handle d’un fichier de vidage sur incident à déboguer. |
| -benchmarkStartup | Utilisation interne de Microsoft uniquement. Exécute un benchmark de démarrage et ajoute le résultat à un fichier. |
Options de symbole
| Option | Description |
|---|---|
| -y SymbolPath | Spécifie le chemin d’accès au symbole à utiliser. 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 connaître d’autres façons de modifier ce chemin d’accès, consultez Chemin du symbole. |
| -n | Chargement de symboles bruyants. Active la sortie détaillée à partir du gestionnaire de symboles. |
| -i ImagePath | Définit le chemin de recherche d’images à utiliser. |
| -sdce | Provoque le débogueur à afficher les messages « Erreur d’accès aux fichiers » pendant le chargement du symbole. |
| -ses | Oblige le débogueur à effectuer une évaluation stricte de tous les fichiers de symboles et à ignorer tous les symboles douteux. |
| -sicv | Fait que le gestionnaire de symboles ignore l’enregistrement CV |
| -Péchés | Fait que le débogueur ignore les variables d’environnement du chemin d’accès du symbole et du chemin d’accès d’image exécutable. |
| -Snc | Entraîne la désactivation de la traduction C++ par le débogueur. |
| -snul | Désactive le chargement automatique des symboles pour les noms non qualifiés. |
| -Sup | Provoque la recherche du gestionnaire de symboles dans la table de symboles publics lors de chaque recherche de symboles |
| -sflags | Définit toutes les options du gestionnaire de symboles à la fois. |
Options de chemin d’accès source
| Option | Description |
|---|---|
| -srcpath | Spécifie le chemin d’accès source à utiliser sur le serveur de débogage. |
| -lsrcpath | Spécifie le chemin d’accès source à utiliser sur le client local. |
Si vous êtes dans une session de débogueur locale, srcpath et lsrcpath sont en fait identiques (votre « serveur » est votre session locale). Pour le débogage à distance, il existe des emplacements dans lesquels vous pouvez les définir sur des valeurs différentes. Pour plus d’informations sur le débogage à distance, consultez Débogage à distance.
Gestion des exceptions
| Option | Description |
|---|---|
| -X | Activez la gestion de la deuxième chance uniquement pour les exceptions de violation d’accès. |
| -xe Exception | Activez la gestion des exceptions de première chance pour l’exception spécifiée. |
| -xd Exception | Activez la gestion des exceptions de la deuxième chance pour l’exception spécifiée. |
| -xn Exception | Pour l’exception donnée, désactivez la gestion de la première et de la deuxième chance et affichez uniquement un message sur la console. |
| -xi Exception | Ignorez complètement l’exception donnée, en désactivant la gestion de la première et de la deuxième chance et en ne sortant rien dans la console. |
Pour obtenir la liste des exceptions qui peuvent être spécifiées, consultez Définitions d’événements et valeurs par défaut.
Post Mortem
| Option | Description |
|---|---|
| -I | Définit WinDbg comme débogueur post-mortem par défaut pour le système. |
| -EST | Définit WinDbg comme débogueur post-mortem par défaut pour le système en mode silencieux, avec uniquement les erreurs signalées. |
Options déconseillées
| Option | Description |
|---|---|
| -Q | Option de ligne de commande déconseillée. |
| -QY | Option de ligne de commande déconseillée. |
| -QS | Option de ligne de commande déconseillée. |
| -QSY | Option de ligne de commande déconseillée. |
| -WX | Option de ligne de commande déconseillée. |
Pour obtenir des informations générales sur les paramètres de démarrage, consultez Options de Command-Line WinDbg.
Vous pouvez utiliser - ? pour répertorier les options de ligne de commande prises en charge.
