Partager via


WinDbg - Options de démarrage de la ligne de commande

Logo WinDbg avec une loupe inspectant les bits.

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.

Capture d’écran de la sortie d’aide de la ligne de commande WinDbgX affichant différentes options.

Voir aussi

Fonctionnalités WinDbg