winedbg-ontwikkeling - Online in de Cloud

PROGRAMMA:

NAAM

winedbg - Wijn debugger

KORTE INHOUD

wijndbg [ opties ] [ programma naam [ programma_argumenten ​ wpid ]

wijndbg --gdb [ opties ] [ programma naam [ programma_argumenten ​ wpid ]

wijndbg --auto wpid

wijndbg --minidump [ bestand.mdmp ] wpid

wijndbg bestand.mdmp

PRODUCTBESCHRIJVING

wijndbg is een debugger voor Wine. Het staat toe:
+ debuggen van native Win32-applicaties
+ debuggen van Winelib-applicaties
+ een drop-in vervanging zijn voor Dr. Watson

MODES

wijndbg kan in vijf modi worden gebruikt. Het eerste argument van het programma bepaalt de modus
winedbg komt binnen.

verzuim
Zonder enige expliciete modus is dit standaard wijndbg bedrijfsmodus. wijndbg wil
fungeren als front-end voor de gebruiker.

--gdb wijndbg zal worden gebruikt als een proxy voor gdb. gdb zal de voorkant zijn voor commando
behandeling, en wijndbg zal alle foutopsporingsverzoeken via een proxy uitvoeren gdb naar de Win32 API's.

--auto Deze modus wordt gebruikt wanneer wijndbg is opgezet in AeDebug registervermelding als standaard
debugger. wijndbg zal dan basisinformatie over een crash weergeven. Dit is handig
voor gebruikers die een crash niet willen debuggen, maar relevante informatie willen verzamelen
over de crash die naar ontwikkelaars moet worden verzonden.

--minidump
Deze modus is vergelijkbaar met de --auto één, behalve dat in plaats van het afdrukken van de
informatie op het scherm (zoals --auto doet), wordt het opgeslagen in een minidump-bestand. De
naam van het bestand wordt doorgegeven op de opdrachtregel of gegenereerd door WijnDbg wanneer
er wordt er geen gegeven. Dit bestand kan later opnieuw worden geladen in wijndbg voor verder
examen.

bestand.mdmp
In deze modus wijndbg herlaadt de status van een debuggee die is opgeslagen in een
minidump-bestand. Zie ofwel de minidump onderstaande opdracht, of de --minidump mode.

OPTIES

Wanneer binnen verzuim modus zijn de volgende opties beschikbaar:

--opdracht snaar
wijndbg zal de opdracht uitvoeren snaar alsof het is ingetoetst op de winedbg-opdrachtregel,
en zal dan verlaten. Dit kan handig zijn om de pid van lopende processen te krijgen
(winedbg --commando "info proc").

--het dossier bestandsnaam
wijndbg zal de lijst met opdrachten in het bestand bestandsnaam uitvoeren alsof ze
werden ingetoetst op de winedbg-opdrachtregel en zullen vervolgens worden afgesloten.

Wanneer binnen gdb proxy-modus zijn de volgende opties beschikbaar:

--geen-start
gdb wordt niet automatisch gestart. Relevante informatie om te starten gdb is
afgedrukt op het scherm. Dit is op de een of andere manier handig als je het niet direct gebruikt gdb maar sommige
grafische front-ends, zoals ddd or kgbd.

--met-xterm
Dit zal lopen gdb in zijn eigen xterm in plaats van de huidige Unix-console te gebruiken voor
tekstuele weergave.

In alle modi wordt de rest van de opdrachtregel, wanneer deze wordt doorgegeven, gebruikt om te identificeren welke
programma's, indien aanwezig, moeten worden gedebugd:

programma naam
Dit is de naam van een uitvoerbaar bestand dat moet worden gestart voor een foutopsporingssessie. wijndbg wil
creëer eigenlijk een proces met dit uitvoerbare bestand. Als programma's_argumenten Ook
gegeven, zullen ze worden gebruikt als argumenten voor het maken van het te debuggen proces.

wpid wijndbg zal hechten aan het proces dat Windows pid is wpid. Gebruik de info proc
bevel binnen wijndbg om actieve processen en hun Windows-pids weer te geven.

verzuim
Als er niets is opgegeven, gaat u de debugger binnen zonder enige run of bijlage
proces. Je zult het werk zelf moeten doen.

COMMANDO'S

Standaard mode, en en herladen a minidump file:
De meeste commando's die worden gebruikt in wijndbg zijn vergelijkbaar met die van gdb. Raadpleeg de gdb
documentatie voor wat meer details. Zie de gdb verschillen gedeelte later om een
lijst met variaties van gdb commando's.

Misc. commando's

afbreken Breekt de debugger af.

ophouden Verlaat de debugger.

hechten N
Koppelen aan een wijnproces (N is de Windows ID, numeriek of hexadecimaal). ID's kunnen zijn
verkregen met behulp van de info commando. Merk op info commando keert terug
hexadecimale waarden

DETACH Loskoppelen van een wijnproces.

Help commando's

hulp Drukt wat hulp af bij de opdrachten.

hulp info
Drukt wat hulp af bij info-opdrachten

Stroom onder controle te houden commando's

cont Ga door met de uitvoering tot het volgende onderbrekingspunt of uitzondering.

passeren Geef de uitzonderingsgebeurtenis door aan de filterketen.

stap Ga door met de uitvoering tot de volgende C-regel code (voert functieaanroep in)

volgende Ga door met de uitvoering tot de volgende C-regel code (voert geen functieaanroep in)

stapi Voer volgende montage-instructie uit (voert functieaanroep in)

volgende Voer de volgende montage-instructie uit (voert geen functie-aanroep in)

afmaken Uitvoeren totdat de terugkeer van de huidige functie is bereikt.

cont, stap, volgende, stapi, volgende kan worden gevolgd door een nummer (N), wat betekent dat de opdracht
moet N keer worden uitgevoerd voordat de controle wordt teruggegeven aan de gebruiker.

Breekpunten, uitkijkpunten

in staat stellen N
Activeert (break|watch)-punt N

'disable' N
Schakelt (break|watch)-punt uit N

verwijderen N
Verwijdert (break|watch)-punt N

cond N Verwijdert elke bestaande voorwaarde naar (break|watch)-point N

cond N uitdrukken
Voegt conditie toe uitdrukken naar (breek|kijk)-punt N. uitdrukken wordt elke keer geëvalueerd
(break|watch)-punt is geraakt. Als het resultaat een nulwaarde is, is het breekpunt dat niet
veroorzaakt.

breken * N
Voegt een breekpunt toe aan het adres N

breken id
Voegt een breekpunt toe op het adres van symbol id

breken id N
Voegt een breekpunt toe aan de lijn N binnen symbool id.

breken N
Voegt een breekpunt toe op de lijn N van het huidige bronbestand.

breken Voegt een breekpunt toe bij de huidige $pc adres.

horloge * N
Voegt een wachtcommando toe (bij schrijven) op het adres N (op 4 bytes).

horloge id
Voegt een wachtcommando toe (bij schrijven) op het adres van symbool id. Maat is afhankelijk van maat
of id.

rwatch * N
Voegt een wachtcommando toe (bij lezen) op het adres N (op 4 bytes).

rwatch id
Voegt een wachtcommando toe (bij lezen) op het adres van symbool id. Grootte is afhankelijk van grootte van
id.

info breken
Toont alle (break|watch)-punten (met hun status).

U kunt het symbool gebruiken Ingangspunt om te staan ​​voor het ingangspunt van de Dll.

Bij het instellen van een (break|watch)-punt door id, als het symbool niet kan worden gevonden (bijvoorbeeld de
symbool is opgenomen in een nog niet geladen module), wijndbg herinnert zich de naam van de
symbool en zal proberen het breekpunt in te stellen elke keer dat een nieuwe module wordt geladen (totdat het
slaagt).

Opstapelen manipulatie

bt Druk de aanroepende stapel van de huidige thread af.

bt N Druk de aanroepende stapel van de thread van de ID af N. Let op: dit verandert niets aan de positie van
het huidige frame zoals gemanipuleerd door de up & dn commando's).

up Gaat één frame omhoog in de stapel van de huidige thread

up N Gaat omhoog N frames in de stapel van de huidige thread

dn Gaat één frame naar beneden in de stapel van de huidige thread

dn N Daalt N frames in de stapel van de huidige thread

omlijsting N
Sets N als het huidige frame voor de stapel van de huidige thread.

info lokale bevolking
Drukt informatie af over lokale variabelen voor het huidige functieframe.

Directory & (bron) filet manipulatie

tonen dir
Drukt de lijst met mappen af ​​waar naar bronbestanden wordt gezocht.

dir padnaam
Voegt padnaam naar de lijst met mappen waar naar bronbestanden moet worden gezocht

dir Verwijdert de lijst met mappen waarin naar bronbestanden moet worden gezocht

symboolbestand padnaam
Laadt extern symbooldefinitiebestand padnaam

symboolbestand padnaam N
Laadt extern symbooldefinitiebestand padnaam (een offset toepassen van N naar
adressen)

lijst Toont 10 bronregels voorwaarts vanaf de huidige positie.

lijst - Toont 10 bronregels achteruit vanaf de huidige positie

lijst N Geeft een lijst van 10 bronregels van de regel N in huidig ​​bestand

lijst padnaam:N
Geeft een lijst van 10 bronregels van de regel N in bestand padnaam

lijst id
Geeft een lijst van 10 bronregels met functies id

lijst * N
Geeft een lijst van 10 bronregels van adres N

U kunt het einddoel specificeren (om de waarde van 10 regels te wijzigen) met behulp van het scheidingsteken ','. Voor
voorbeeld:

lijst 123, 234
somt bronregels op van regel 123 tot regel 234 in het huidige bestand

lijst foo.c:1,56
somt bronregels op van regel 1 tot 56 in bestand foo.c

Display

Een weergave is een uitdrukking die wordt geëvalueerd en afgedrukt na de uitvoering van een willekeurige wijndbg
opdracht.

tonen

info tonen
Geeft een overzicht van de actieve beeldschermen

tonen uitdrukken
Voegt een weergave voor expressie toe uitdrukken

tonen /fmt uitdrukken
Voegt een weergave voor expressie toe uitdrukken. Afdrukken geëvalueerd uitdrukken wordt gedaan met behulp van het gegeven
formaat (zie print commando voor meer over formaten)

del tonen N

niet weergeven N
Verwijdert weergave N

demontage

diss Demonteer vanaf de huidige positie

diss uitdrukken
Demonteer van adres uitdrukken

diss uitdrukken,uitdrukken
Demonteert code tussen adressen gespecificeerd door de twee uitdrukkingen

Geheugen (lezing, schrijven, typen)

x uitdrukken Onderzoekt geheugen op adres uitdrukken

x /fmt uitdrukken
Onderzoekt geheugen op adres uitdrukken formaat gebruiken fmt

print uitdrukken
Drukt de waarde af van uitdrukken (mogelijk met behulp van het type)

print /fmt uitdrukken
Drukt de waarde af van uitdrukken (mogelijk met behulp van het type)

reeks var = uitdrukken
Schrijft de waarde van uitdrukken in var variabele

wat is uitdrukken
Drukt het C-type uitdrukking af uitdrukken

fmt is een van beide letter or tellen letter, Waar letter kan zijn:

is een ASCII-tekenreeks

ua UTF16 Unicode-tekenreeks

i instructies (demonteren)

x 32-bits hexadecimaal geheel getal zonder teken

d 32-bits decimaal geheel getal met teken

w 16-bits hexadecimaal geheel getal zonder teken

c-teken (alleen afdrukbare 0x20-0x7f worden daadwerkelijk afgedrukt)

b 8-bits hexadecimaal geheel getal zonder teken

g Win32-GUID

Uitdrukkingen

Uitdrukkingen in Wine Debugger worden meestal in C-vorm geschreven. Er zijn er echter een paar
afwijkingen:

Identifiers kunnen een '!' op hun naam. Dit maakt het voornamelijk mogelijk om een ​​module te specificeren
waar je de ID vandaan moet halen, bijv USER32!MaakWindowExA.

Bij een cast-bewerking moet u bij het specificeren van een structuur of een unie de struct
of union-sleutelwoord (zelfs als uw programma een typedef gebruikt).

Als er een identifier wordt opgegeven en er meerdere symbolen met deze naam bestaan, zal de debugger dat doen
vraag naar het symbool dat u wilt gebruiken. Kies degene die je wilt van zijn nummer.

Misc.

minidump bestand.mdmp slaat de foutopsporingscontext van de foutopsporing op in een minidumpbestand met de naam
bestand.mdmp.

Informatie on Wijn binnenwerk

info klasse
Geeft een overzicht van alle Windows-klassen die zijn geregistreerd in Wine

info klasse id
Drukt informatie af over de Windows-klasse id

info deel
Geeft een lijst van alle dynamische bibliotheken die in het foutopsporingsprogramma zijn geladen (inclusief .so
bestanden, NE en PE DLL's)

info deel N
Print informatie over module op adres N

info register
Drukt de waarde van de CPU-registers af

info alle-regs
Drukt de waarde van de CPU- en Floating Point-registers af

info segment
Toont alle toegewezen segmenten (alleen i386)

info segment N
Drukt informatie over segment af N (alleen i386)

info stack
Drukt de waarden boven op de stapel af

info kaart
Geeft een lijst van alle virtuele toewijzingen die door het foutopsporingsprogramma worden gebruikt

info kaart N
Geeft een lijst van alle virtuele toewijzingen die worden gebruikt door het programma van Windows pid N

info wnd
Geeft de vensterhiërarchie weer vanaf het bureaubladvenster

info wnd N
Drukt informatie af van het venster van de handgreep N

info
Toont alle w-processen in Wine-sessie

info draad
Toont alle w-threads in Wine-sessie

info omlijsting
Geeft een lijst van de uitzonderingsframes (beginnend met het huidige stackframe). U kunt ook passeren,
als optioneel argument, een thread-ID (in plaats van de huidige thread) om de thread te onderzoeken
uitzonderingskaders.

Foutopsporingsberichten kunnen worden in- en uitgeschakeld terwijl u aan het debuggen bent met behulp van de reeks opdracht, maar
alleen voor kanalen die zijn geïnitialiseerd met de WIJNBUG variabele omgeving.

reeks waarschuwen + winnen
Schakelt waarschuwing in winnen kanaal

reeks + winnen
Schakelt waarschuwing/fixme/err/trace in winnen kanaal

reeks - winnen
Schakelt waarschuwing/fixme/err/trace uit winnen kanaal

reeks repareer mij - allen
Schakelt fixme-klasse uit op alle kanalen

GDB modus:
Zie de gdb documentatie voor alle gdb commando's.

Er zijn echter enkele Wine-extensies beschikbaar via de controleren opdracht:

controleren wnd
Toont alle vensters in de Wine-sessie

controleren proc
Geeft een overzicht van alle processen in de Wine-sessie

controleren Lid
Toont geheugentoewijzing van foutopsporingsproces

automobiel en minidump modi:
Aangezien er geen gebruikersinvoer mogelijk is, zijn er geen commando's beschikbaar.

MILIEU

WINE_GDB
Bij gebruik in gdb proxy-modus, WINE_GDB specificeert de naam (en het pad) van het
uitvoerbaar om voor te gebruiken gdb. "gdb" wordt standaard gebruikt.

AUTEURS

De eerste versie is geschreven door Eric Youngdale.

Zie Wine-ontwikkelaarslijst voor de rest van bijdragers.

Gebruik wijndbg-ontwikkeling online met behulp van onworks.net-services