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.

Voir aussi

Fonctionnalités WinDbg