winedbg-development - Online sa Cloud

PROGRAMA:

NAME

winedbg - Debugger ng alak

SINOPSIS

winedbg [ pagpipilian ] [ pangalan_programa [ program_arguments ] | wpid ]

winedbg --gdb [ pagpipilian ] [ pangalan_programa [ program_arguments ] | wpid ]

winedbg --auto wpid

winedbg --minidump [ file.mdmp ] wpid

winedbg file.mdmp

DESCRIPTION

winedbg ay isang debugger para sa Wine. Pinapayagan nito:
+ pag-debug ng mga katutubong application ng Win32
+ pag-debug ng mga application ng Winelib
+ pagiging isang drop-in na kapalit para kay Dr Watson

mode

winedbg maaaring gamitin sa limang mga mode. Ang unang argumento sa programa ay tumutukoy sa mode
tatakbo ang winedbg.

default
Nang walang anumang tahasang mode, ito ay pamantayan winedbg operating mode. winedbg habilin
kumilos bilang front end para sa gumagamit.

--gdb winedbg ay gagamitin bilang proxy para sa gdb. gdb ang magiging front end para sa command
paghawak, at winedbg ay i-proxy ang lahat ng mga kahilingan sa pag-debug mula sa gdb sa mga Win32 API.

--auto Ang mode na ito ay ginagamit kapag winedbg ay naka-set up sa AeDebug registry entry bilang default
i-debug. winedbg ay magpapakita ng pangunahing impormasyon tungkol sa isang pag-crash. Ito ay kapaki-pakinabang
para sa mga user na ayaw mag-debug ng pag-crash, ngunit sa halip ay mangalap ng may-katuturang impormasyon
tungkol sa pag-crash na ipapadala sa mga developer.

--minidump
Ang mode na ito ay katulad ng --auto isa, maliban na sa halip na i-print ang
impormasyon sa screen (bilang --auto ginagawa), ito ay nai-save sa isang minidump file. Ang
Ang pangalan ng file ay ipinasa sa command line, o nabuo ni WineDbg kailan
walang binigay. Ang file na ito ay maaaring i-reload sa ibang pagkakataon winedbg para sa karagdagang
pagsusuri.

file.mdmp
Sa ganitong mode winedbg nire-reload ang estado ng isang debuggee na na-save sa a
minidump file. Tingnan ang alinman sa minidump utos sa ibaba, o ang --minidump paraan.

Opsyon

Kapag nasa default mode, ang mga sumusunod na opsyon ay magagamit:

--utos pisi
winedbg ipapatupad ang utos pisi na parang naka-key sa winedbg command line,
at pagkatapos ay lalabas. Maaari itong maging madaling gamitin para sa pagkuha ng pid ng mga prosesong tumatakbo
(winedbg --command "info proc").

--file filename
winedbg ay isasagawa ang listahan ng mga utos na nakapaloob sa filename ng file na parang sila
ay na-key sa winedbg command line, at pagkatapos ay lalabas.

Kapag nasa gdb proxy mode, available ang mga sumusunod na opsyon:

--walang-simula
gdb ay hindi awtomatikong magsisimula. Kaugnay na impormasyon para sa pagsisimula gdb is
naka-print sa screen. Ito ay kahit papaano ay kapaki-pakinabang kapag hindi direktang ginagamit gdb ngunit ang ilan
mga graphical na front-end, tulad ng ddd or kgbd.

--sa-xterm
Tatakbo ito gdb sa sarili nitong xterm sa halip na gamitin ang kasalukuyang Unix console para sa
pagpapakita ng teksto.

Sa lahat ng mga mode, ang natitirang bahagi ng command line, kapag naipasa, ay ginagamit upang matukoy kung alin
ang mga programa, kung mayroon man, ay kailangang i-debug:

pangalan_programa
Ito ang pangalan ng isang executable na magsisimula para sa isang debugging session. winedbg habilin
aktwal na lumikha ng isang proseso gamit ang maipapatupad na ito. Kung programs_arguments din ang mga
ibinigay, gagamitin ang mga ito bilang mga argumento para sa paglikha ng prosesong i-debug.

wpid winedbg ay ilakip sa proseso kung saan ang Windows pid wpid. Gamitin ang info proc
utos sa loob winedbg upang ilista ang mga tumatakbong proseso at ang kanilang mga Windows pid.

default
Kung walang tinukoy, papasok ka sa debugger nang walang anumang run o kalakip
proseso. Kailangan mong gawin ang trabaho sa iyong sarili.

UTOS

default fashion, at habang pag-reload a minidump file:
Karamihan sa mga utos na ginagamit sa winedbg ay katulad ng mga mula sa gdb. Mangyaring sumangguni sa gdb
dokumentasyon para sa ilang karagdagang detalye. Tingnan ang gdb pagkakaiba seksyon mamaya para makakuha ng a
listahan ng mga pagkakaiba-iba mula sa gdb utos.

Misc. utos

magpalaglag Ina-abort ang debugger.

umalis Lumabas sa debugger.

ikabit N
Mag-attach sa isang proseso ng Alak (N ay ang Windows ID nito, numeric o hexadecimal). Ang mga ID ay maaaring
nakuha gamit ang info paraan utos. Pansinin ang info paraan pagbabalik ng utos
mga halaga ng hexadecimal

tanggalin Humiwalay sa isang Wine-process.

Tulong utos

Tulungan Nagpi-print ng ilang tulong sa mga command.

Tulungan info
Nagpi-print ng ilang tulong sa mga utos ng impormasyon

Pag-agos kontrol utos

katuloy Ipagpatuloy ang pagpapatupad hanggang sa susunod na breakpoint o exception.

pumasa Ipasa ang exception event hanggang sa filter chain.

hakbang Ipagpatuloy ang pagpapatupad hanggang sa susunod na linya ng C ng code (papasok sa function call)

susunod Ipagpatuloy ang pagpapatupad hanggang sa susunod na linya ng C ng code (hindi pumapasok sa function call)

stepi Isagawa ang susunod na tagubilin sa pagpupulong (papasok sa function call)

susunod Isagawa ang susunod na pagtuturo sa pagpupulong (hindi pumapasok sa function call)

tapusin Ipatupad hanggang maabot ang pagbabalik ng kasalukuyang function.

katuloy, hakbang, susunod, stepi, susunod maaaring postfixed ng isang numero (N), ibig sabihin na ang command
dapat isagawa ng N beses bago ibalik ang kontrol sa user.

Mga breakpoint, mga watchpoint

paganahin N
Pinapagana ang (break|watch)-point N

huwag paganahin N
Hindi pinapagana ang (break|watch)-point N

alisin N
Tinatanggal (break|watch)-point N

kundisyon N Tinatanggal ang anumang umiiral na kundisyon sa (break|watch)-point N

kundisyon N ipahayag
Nagdadagdag ng kundisyon ipahayag sa (break|watch)-point N. ipahayag susuriin sa tuwing ang
(break|watch)-point ay natamaan. Kung ang resulta ay zero value, ang breakpoint ay hindi
nag-trigger

masira * N
Nagdaragdag ng breakpoint sa address N

masira id
Nagdaragdag ng breakpoint sa address ng simbolo id

masira id N
Nagdaragdag ng breakpoint sa linya N simbolo sa loob id.

masira N
Nagdaragdag ng breakpoint sa linya N ng kasalukuyang source file.

masira Nagdaragdag ng breakpoint sa kasalukuyang $PC address.

panoorin * N
Nagdaragdag ng utos sa panonood (sa pagsulat) sa address N (sa 4 bytes).

panoorin id
Nagdaragdag ng utos sa relo (sa pagsulat) sa address ng simbolo id. Ang laki ay depende sa laki
of id.

rwatch * N
Nagdaragdag ng utos sa panonood (nabasa) sa address N (sa 4 bytes).

rwatch id
Nagdaragdag ng utos sa relo (nabasa) sa address ng simbolo id. Ang laki ay depende sa laki ng
id.

info masira
Inililista ang lahat ng (break|watch)-points (kasama ang kanilang estado).

Maaari mong gamitin ang simbolo Pasukan upang tumayo para sa entry point ng Dll.

Kapag nagtatakda ng (break|watch)-point by id, kung hindi mahanap ang simbolo (halimbawa, ang
ang simbolo ay nakapaloob sa isang hindi pa na-load na module), winedbg aalalahanin ang pangalan ng
simbolo at susubukan na itakda ang breakpoint sa tuwing mag-load ng bagong module (hanggang sa
nagtagumpay).

Magtalaksan pagpapatakbo

bt I-print ang stack ng pagtawag ng kasalukuyang thread.

bt N I-print ang stack ng pagtawag ng thread ng ID N. Tandaan: hindi nito binabago ang posisyon ng
ang kasalukuyang frame bilang manipulahin ng up & dn mga utos).

up Umakyat ng isang frame sa stack ng kasalukuyang thread

up N Umaakyat N mga frame sa stack ng kasalukuyang thread

dn Bumababa sa isang frame sa stack ng kasalukuyang thread

dn N Bumababa N mga frame sa stack ng kasalukuyang thread

balangkas N
Sets N bilang kasalukuyang frame para sa stack ng kasalukuyang thread.

info mga lokal
Nagpi-print ng impormasyon sa mga lokal na variable para sa kasalukuyang function frame.

Directory & pinagmulan file pagpapatakbo

Ipakita dir
Ini-print ang listahan ng mga dir kung saan hinahanap ang mga source file.

dir pangalan ng landas
Nagdadagdag pangalan ng landas sa listahan ng mga dir kung saan hahanapin ang mga source file

dir Tinatanggal ang listahan ng mga dir kung saan hahanapin ang mga source file

symbolfile pangalan ng landas
Naglo-load ng panlabas na file ng kahulugan ng simbolo pangalan ng landas

symbolfile pangalan ng landas N
Naglo-load ng panlabas na file ng kahulugan ng simbolo pangalan ng landas (paglalapat ng offset ng N sa
mga address)

listahan Naglilista ng 10 source na linya ng pasulong mula sa kasalukuyang posisyon.

listahan - Naglilista ng 10 source na linya pabalik mula sa kasalukuyang posisyon

listahan N Naglilista ng 10 source na linya mula sa linya N sa kasalukuyang file

listahan pangalan ng landas:N
Naglilista ng 10 source na linya mula sa linya N nasa file pangalan ng landas

listahan id
Naglilista ng 10 source na linya ng function id

listahan * N
Naglilista ng 10 source na linya mula sa address N

Maaari mong tukuyin ang end target (upang baguhin ang halaga ng 10 linya) gamit ang ',' separator. Para sa
halimbawa:

listahan 123, 234
naglilista ng mga linya ng pinagmulan mula sa linya 123 hanggang sa linya 234 sa kasalukuyang file

listahan foo.c:1,56
naglilista ng mga linya ng pinagmulan mula sa linya 1 hanggang 56 sa file foo.c

Pagpapakita

Ang isang display ay isang expression na sinusuri at naka-print pagkatapos ng pagpapatupad ng anuman winedbg
utos.

magpakita

info magpakita
Naglilista ng mga aktibong display

magpakita ipahayag
Nagdaragdag ng display para sa pagpapahayag ipahayag

magpakita /fmt ipahayag
Nagdaragdag ng display para sa pagpapahayag ipahayag. Nasuri ang pag-print ipahayag ay ginagawa gamit ang ibinigay
format (tingnan i-print utos para sa higit pa sa mga format)

del magpakita N

hindi ipinapakita N
Tinatanggal ang display N

Pagwawakas

disas I-disassemble mula sa kasalukuyang posisyon

disas ipahayag
I-disassemble mula sa address ipahayag

disas ipahayag,ipahayag
Idinidisassemble ang code sa pagitan ng mga address na tinukoy ng dalawang expression

Memorya (pagbabasa, pagsusulat, pagta-type)

x ipahayag Sinusuri ang memorya sa address ipahayag

x /fmt ipahayag
Sinusuri ang memorya sa address ipahayag gamit ang format fmt

i-print ipahayag
Nagpi-print ng halaga ng ipahayag (maaaring gamit ang uri nito)

i-print /fmt ipahayag
Nagpi-print ng halaga ng ipahayag (maaaring gamit ang uri nito)

itakda ay = ipahayag
Isinulat ang halaga ng ipahayag in ay nagbabago

ano ang ipahayag
Nagpi-print ng C uri ng expression ipahayag

fmt ay alinman sulat or bilangin sulat, Kung saan sulat ay maaaring maging:

s isang ASCII string

ua UTF16 Unicode string

i mga tagubilin (i-disassemble)

x 32-bit unsigned hexadecimal integer

d 32-bit na nilagdaang decimal integer

w 16-bit unsigned hexadecimal integer

c character (napi-print lang na 0x20-0x7f ang aktwal na naka-print)

b 8-bit unsigned hexadecimal integer

g Win32 GUID

expression

Ang mga expression sa Wine Debugger ay kadalasang nakasulat sa isang C form. Gayunpaman, may iilan
mga pagkakaiba-iba:

Ang mga identifier ay maaaring kumuha ng '!' sa kanilang mga pangalan. Ito ay nagbibigay-daan sa pangunahin upang tukuyin ang isang module
kung saan titingnan ang ID, hal USER32!CreateWindowExA.

Sa isang pagpapatakbo ng cast, kapag tinukoy ang isang istraktura o isang unyon, dapat mong gamitin ang istraktura
o keyword ng unyon (kahit na gumagamit ang iyong programa ng typedef).

Kapag tinukoy ang isang identifier, kung mayroong maraming mga simbolo na may ganitong pangalan, gagawin ng debugger
prompt para sa simbolo na gusto mong gamitin. Kunin ang gusto mo mula sa numero nito.

Misc.

minidump file.mdmp sine-save ang konteksto ng pag-debug ng debuggee sa isang minidump file na tinatawag
file.mdmp.

Impormasyon on Alak mga internal

info klase
Inililista ang lahat ng klase sa Windows na nakarehistro sa Wine

info klase id
Nagpi-print ng impormasyon sa klase ng Windows id

info ibahagi
Inililista ang lahat ng mga dynamic na aklatan na na-load sa na-debug na program (kabilang ang .so
mga file, NE at PE DLL)

info ibahagi N
Nagpi-print ng impormasyon sa module sa address N

info magparehistro
Ini-print ang halaga ng mga rehistro ng CPU

info all-regs
Ini-print ang halaga ng mga rehistro ng CPU at Floating Point

info bahagi
Inililista ang lahat ng inilaan na segment (i386 lang)

info bahagi N
Nagpi-print ng impormasyon sa segment N (i386 lang)

info magtalaksan
Ini-print ang mga halaga sa tuktok ng stack

info mapa
Inililista ang lahat ng virtual na pagmamapa na ginagamit ng na-debug na programa

info mapa N
Inililista ang lahat ng virtual mapping na ginagamit ng program ng Windows pid N

info wnd
Ipinapakita ang hierarchy ng window simula sa desktop window

info wnd N
Nagpi-print ng impormasyon ng Window of handle N

info paraan
Inililista ang lahat ng w-process sa Wine session

info sinulid
Inililista ang lahat ng w-thread sa Wine session

info balangkas
Inililista ang mga exception frame (nagsisimula sa kasalukuyang stack frame). Makakapasa ka rin,
bilang opsyonal na argumento, isang thread id (sa halip na kasalukuyang thread) upang suriin ito
mga frame ng exception.

Maaaring i-on at i-off ang mga mensahe sa pag-debug habang nagde-debug ka gamit ang itakda utos, ngunit
para lamang sa mga channel na sinimulan sa WINEDEBUG variable ng kapaligiran.

itakda balaan + manalo
Naka-on ang babala manalo channel

itakda + manalo
Ino-on ang warn/fixme/err/trace on manalo channel

itakda - manalo
Ino-off ang warn/fixme/err/trace on manalo channel

itakda ayusin mo ako - lahat
Ino-off ang fixme class sa lahat ng channel

Gdb mode:
Tingnan ang gdb dokumentasyon para sa lahat ng gdb utos.

Gayunpaman, available ang ilang extension ng Wine, sa pamamagitan ng monitor utos:

monitor wnd
Inililista ang lahat ng mga window sa session ng Wine

monitor proc
Inililista ang lahat ng proseso sa session ng Wine

monitor mem
Ipinapakita ang memory mapping ng debugged na proseso

Auto at minidump mga mode:
Dahil walang input ng user ang posible, walang available na command.

Kapaligiran

WINE_GDB
Kapag ginamit sa gdb proxy mode, WINE_GDB tumutukoy sa pangalan (at ang landas) ng
executable na gagamitin para sa gdb. Ang "gdb" ay ginagamit bilang default.

MGA AUTHORS

Ang unang bersyon ay isinulat ni Eric Youngdale.

Tingnan ang listahan ng mga developer ng Wine para sa iba pang mga contributor.

Gumamit ng winedbg-development online gamit ang mga serbisyo ng onworks.net