winedbg - En ligne dans le Cloud

PROGRAMME:

Nom

winedbg - Débogueur de vin

SYNOPSIS

vindbg [ Options ] [ nom du programme [ arguments_programme ] | wpid ]

vindbg --gdb [ Options ] [ nom du programme [ arguments_programme ] | wpid ]

vindbg --auto wpid

vindbg --minidump [ fichier.mdmp ] wpid

vindbg fichier.mdmp

DESCRIPTION

vindbg est un débogueur pour Wine. Il permet:
+ débogage des applications natives Win32
+ débogage des applications Winelib
+ être un remplaçant sans rendez-vous pour le Dr Watson

MODES

vindbg peut être utilisé dans cinq modes. Le premier argument du programme détermine le mode
winedbg s'exécutera.

défaut
Sans aucun mode explicite, c'est standard vindbg mode de fonctionnement. vindbg sera
agir en tant que frontal pour l'utilisateur.

--gdb vindbg sera utilisé comme proxy pour gdb. gdb sera le front end pour la commande
manipulation, et vindbg va proxy toutes les demandes de débogage de gdb aux API Win32.

--auto Ce mode est utilisé lorsque vindbg est installé dans AeDebug entrée de registre par défaut
débogueur. vindbg affichera alors des informations de base sur un plantage. C'est utile
pour les utilisateurs qui ne veulent pas déboguer un plantage, mais plutôt rassembler des informations pertinentes
sur le crash à envoyer aux développeurs.

--minidump
Ce mode est similaire au --auto un, sauf qu'au lieu d'imprimer le
informations à l'écran (comme --auto fait), il est enregistré dans un fichier minidump. Les
le nom du fichier est soit passé sur la ligne de commande, soit généré par VinDbg quand
aucun n'est donné. Ce fichier pourra plus tard être rechargé dans vindbg Pour de plus amples
examen.

fichier.mdmp
Dans ce mode vindbg recharge l'état d'un débogué qui a été enregistré dans un
fichier minidump. Voir soit le minidump commande ci-dessous, ou la --minidump mode.

OPTIONS

Quand à défaut mode, les options suivantes sont disponibles :

--commander un magnifique
vindbg exécutera la commande un magnifique comme s'il était tapé sur la ligne de commande winedbg,
puis sortira. Cela peut être pratique pour obtenir le pid des processus en cours d'exécution
(winedbg --commande "info proc").

--déposer nom de fichier
vindbg exécutera la liste des commandes contenues dans le fichier filename comme si elles
ont été saisis sur la ligne de commande winedbg, puis se termineront.

Quand à gdb mode proxy, les options suivantes sont disponibles :

--pas de démarrage
gdb ne sera pas automatiquement démarré. Informations utiles pour démarrer gdb
imprimé à l'écran. Ceci est en quelque sorte utile lorsque vous n'utilisez pas directement gdb mais quelques
frontaux graphiques, comme ddd or kgbd.

--avec-xterm
Cela fonctionnera gdb dans son propre xterm au lieu d'utiliser la console Unix actuelle pour
affichage textuel.

Dans tous les modes, le reste de la ligne de commande, lorsqu'il est passé, est utilisé pour identifier quel
les programmes, le cas échéant, doivent être débogués :

nom du programme
C'est le nom d'un exécutable à démarrer pour une session de débogage. vindbg sera
créer réellement un processus avec cet exécutable. Si arguments_programmes sont également
donnés, ils seront utilisés comme arguments pour créer le processus à déboguer.

wpid vindbg attachera au processus quel Windows pid est wpid. Utilisez le info proc
commande à l'intérieur vindbg pour répertorier les processus en cours d'exécution et leurs pid Windows.

défaut
Si rien n'est spécifié, vous entrerez dans le débogueur sans aucun run ni attaché
traiter. Vous devrez faire le travail vous-même.

COMMANDES

Réglage par défaut Mode, ainsi que tout en rechargement a minidump fichier:
La plupart des commandes utilisées dans vindbg sont similaires à ceux de gdb. S'il vous plaît se référer à la gdb
documentations pour plus de détails. Voir le gdb différences section plus tard pour obtenir un
liste des variantes de gdb les commandes.

Divers. commandes

avortement Abandonne le débogueur.

quitter Quitte le débogueur.

joindre N
Attacher à un processus Wine (N est son identifiant Windows, numérique ou hexadécimal). Les identifiants peuvent être
obtenu en utilisant le info processus commander. Noter la info processus la commande renvoie
valeurs hexadécimales

détacher Détacher d'un processus de vin.

d’aide commandes

aider Affiche de l'aide sur les commandes.

aider info
Imprime de l'aide sur les commandes d'informations

Flow des bactéries commandes

compte Continuer l'exécution jusqu'au prochain point d'arrêt ou exception.

pass Transmettez l'événement d'exception à la chaîne de filtrage.

étape Continuer l'exécution jusqu'à la prochaine ligne de code C (entre l'appel de fonction)

next Continuer l'exécution jusqu'à la prochaine ligne de code C (n'entre pas dans l'appel de fonction)

stepi Exécuter la prochaine instruction d'assemblage (entre dans l'appel de fonction)

ensuite je Exécuter la prochaine instruction d'assemblage (n'entre pas dans l'appel de fonction)

finition Exécuter jusqu'à ce que le retour de la fonction actuelle soit atteint.

compte, étape, next, stepi, ensuite je peut être précédé d'un nombre (N), ce qui signifie que la commande
doit être exécuté N fois avant que le contrôle ne soit rendu à l'utilisateur.

Points d'arrêt, points d'observation

permettre N
Active (break|watch)-point N

désactiver N
Désactive (break|watch)-point N

effacer N
Supprime (break|watch)-point N

cond N Supprime toute condition existante au point (break|watch) N

cond N expr
Ajoute une condition expr à (casser|regarder)-point N. expr sera évalué à chaque fois que le
(break|watch)-point est touché. Si le résultat est une valeur nulle, le point d'arrêt n'est pas
déclenché.

pause * N
Ajoute un point d'arrêt à l'adresse N

pause id
Ajoute un point d'arrêt à l'adresse du symbole id

pause id N
Ajoute un point d'arrêt à la ligne N symbole à l'intérieur id.

pause N
Ajoute un point d'arrêt à la ligne N du fichier source actuel.

pause Ajoute un point d'arrêt à l'adresse actuelle du PC.

montre de luxe. * N
Ajoute une commande watch (sur écriture) à l'adresse N (sur 4 octets).

montre de luxe. id
Ajoute une commande watch (sur écriture) à l'adresse du symbole id. La taille dépend de la taille
of id.

rwatch * N
Ajoute une commande watch (en lecture) à l'adresse N (sur 4 octets).

rwatch id
Ajoute une commande watch (en lecture) à l'adresse du symbole id. La taille dépend de la taille de
id.

info pause
Répertorie tous les points (break|watch) (avec leur état).

Vous pouvez utiliser le symbole Point d'accès pour représenter le point d'entrée de la Dll.

Lors de la définition d'un point (break|watch) par id, si le symbole est introuvable (par exemple, le
symbole est contenu dans un module pas encore chargé), vindbg rappellera le nom du
symbole et essaiera de définir le point d'arrêt à chaque fois qu'un nouveau module est chargé (jusqu'à ce qu'il
réussit).

Stack manipulation

bt Imprimer la pile d'appel du thread actuel.

bt N Imprimer la pile d'appel du thread d'ID N. Remarque : cela ne change pas la position de
l'image actuelle telle que manipulée par le up & dn commandes).

up Remonte d'une image dans la pile du thread actuel

up N Monte N cadres dans la pile du thread actuel

dn Descend d'une image dans la pile du thread actuel

dn N Diminue N cadres dans la pile du thread actuel

cadre N
Sets N comme frame actuel pour la pile du thread actuel.

info des locaux
Imprime des informations sur les variables locales pour le cadre de fonction actuel.

Annuaire & la source filet manipulation

montrer dir
Imprime la liste des répertoires où les fichiers source sont recherchés.

dir chemin d'accès
Ajoute chemin d'accès à la liste des répertoires où chercher les fichiers sources

dir Supprime la liste des répertoires où rechercher les fichiers source

fichier de symboles chemin d'accès
Charge le fichier de définition de symbole externe chemin d'accès

fichier de symboles chemin d'accès N
Charge le fichier de définition de symbole externe chemin d'accès (en appliquant un décalage de N à
adresses)

liste Répertorie 10 lignes source en avant de la position actuelle.

liste - Répertorie 10 lignes source en arrière de la position actuelle

liste N Répertorie 10 lignes source à partir de la ligne N dans le fichier courant

liste chemin d'accès:N
Répertorie 10 lignes source à partir de la ligne N dans le fichier chemin d'accès

liste id
Répertorie 10 lignes de fonction source id

liste * N
Répertorie 10 lignes source de l'adresse N

Vous pouvez spécifier la destination finale (pour modifier la valeur de 10 lignes) à l'aide du séparateur ','. Pour
Exemple:

liste 123 234
répertorie les lignes source de la ligne 123 à la ligne 234 dans le fichier actuel

liste truc.c:1,56
répertorie les lignes source de la ligne 1 à 56 dans le fichier foo.c

visualisation

Un affichage est une expression qui est évaluée et imprimée après l'exécution de tout vindbg
commander.

l’affichage

info l’affichage
Liste les affichages actifs

l’affichage expr
Ajoute un affichage pour l'expression expr

l’affichage /fmt expr
Ajoute un affichage pour l'expression expr. Impression évaluée expr est fait en utilisant le donné
format (voir impression commander pour en savoir plus sur les formats)

de la l’affichage N

annuler l'affichage N
Supprime l'affichage N

Démontage

désas Démonter de la position actuelle

désas expr
Démonter de l'adresse expr

désas expr,expr
Désassemble le code entre les adresses spécifiées par les deux expressions

Mémoire (en train de lire, l'écriture, dactylographie)

x expr Examine la mémoire à l'adresse expr

x /fmt expr
Examine la mémoire à l'adresse expr en utilisant le format fmt

impression expr
Imprime la valeur de expr (éventuellement en utilisant son type)

impression /fmt expr
Imprime la valeur de expr (éventuellement en utilisant son type)

set var = expr
Écrit la valeur de expr in var variable

quel est expr
Imprime le type d'expression C expr

fmt est soit lettre or compter lettre, Où lettre peut être:

s une chaîne ASCII

ua UTF16 chaîne Unicode

i instructions (démonter)

x entier hexadécimal non signé 32 bits

d Entier décimal signé 32 bits

w Entier hexadécimal non signé 16 bits

caractère c (seuls les 0x20-0x7f imprimables sont réellement imprimés)

b Entier hexadécimal 8 bits non signé

g GUID Win32

Expressions

Les expressions dans Wine Debugger sont principalement écrites sous une forme C. Cependant, il existe quelques
écarts:

Les identifiants peuvent prendre un '!' dans leurs noms. Cela permet principalement de spécifier un module
d'où chercher l'ID, par exemple USER32!CréerWindowExA.

Dans une opération de transtypage, lors de la spécification d'une structure ou d'une union, vous devez utiliser la structure
ou un mot-clé union (même si votre programme utilise un typedef).

Lors de la spécification d'un identifiant, si plusieurs symboles portant ce nom existent, le débogueur
demander le symbole que vous souhaitez utiliser. Choisissez celui que vous voulez parmi son numéro.

Divers.

minidump fichier.mdmp enregistre le contexte de débogage du débogué dans un fichier minidump appelé
fichier.mdmp.

Informations on Vin internes

info classe
Répertorie toutes les classes Windows enregistrées dans Wine

info classe id
Imprime des informations sur la classe Windows id

info Partager
Répertorie toutes les bibliothèques dynamiques chargées dans le programme débogué (y compris .so
fichiers, DLL NE et PE)

info Partager N
Imprime les informations sur le module à l'adresse N

info regs
Imprime la valeur des registres CPU

info tous-regs
Imprime la valeur des registres CPU et virgule flottante

info clignotant
Répertorie tous les segments alloués (i386 uniquement)

info clignotant N
Imprime les informations sur le segment N (i386 uniquement)

info empiler
Imprime les valeurs en haut de la pile

info Localisation
Répertorie tous les mappages virtuels utilisés par le programme débogué

info Localisation N
Répertorie tous les mappages virtuels utilisés par le programme de Windows pid N

info wnd
Affiche la hiérarchie des fenêtres à partir de la fenêtre du bureau

info wnd N
Imprime les informations de la fenêtre de la poignée N

info processus
Répertorie tous les processus w dans la session Wine

info fil
Répertorie tous les threads w dans la session Wine

info cadre
Répertorie les cadres d'exception (à partir du cadre de pile actuel). Vous pouvez également passer,
comme argument facultatif, un identifiant de thread (au lieu du thread actuel) pour examiner son
cadres d'exception.

Les messages de débogage peuvent être activés et désactivés pendant que vous déboguez à l'aide du set commande, mais
uniquement pour les canaux initialisés avec le COUP DE COEUR variable d'environnement.

set prévenir + gagner
Activer avertir gagner chaine

set + gagner
Active warn/fixme/err/trace on gagner chaine

set - gagner
Désactive warn/fixme/err/trace on gagner chaine

set Répare-moi - TOUTE
Désactive la classe fixme sur tous les canaux

GDB mode:
Voir le gdb documentation pour tous les gdb les commandes.

Cependant, quelques extensions Wine sont disponibles, via le moniteur commander:

moniteur wnd
Répertorie toutes les fenêtres de la session Wine

moniteur proc
Répertorie tous les processus de la session Wine

moniteur Membre
Affiche le mappage de la mémoire du processus débogué

Automatique ainsi que minidump modes :
Comme aucune entrée utilisateur n'est possible, aucune commande n'est disponible.

ENVIRONNEMENT

VIN_GDB
Lorsqu'il est utilisé dans gdb mode proxy, VIN_GDB spécifie le nom (et le chemin) du
exécutable à utiliser pour gdb. "gdb" est utilisé par défaut.

AUTEURS

La première version a été écrite par Eric Youngdale.

Voir la liste des développeurs de Wine pour le reste des contributeurs.

Utilisez winedbg en ligne en utilisant les services onworks.net