winedbg-development - Online în cloud

PROGRAM:

NUME

winedbg - Depanator de vin

REZUMAT

winedbg [ Opțiuni ] [ numele programului [ argumente_program ] | wpid ]

winedbg --gdb [ Opțiuni ] [ numele programului [ argumente_program ] | wpid ]

winedbg --auto wpid

winedbg --minidump [ fișier.mdmp ] wpid

winedbg fișier.mdmp

DESCRIERE

winedbg este un depanator pentru Wine. Permite:
+ depanarea aplicațiilor native Win32
+ depanarea aplicațiilor Winelib
+ fiind un înlocuitor pentru Dr Watson

MODURI

winedbg poate fi folosit în cinci moduri. Primul argument al programului determină modul
winedbg va rula.

lipsă
Fără vreun mod explicit, acesta este standard winedbg mod de operare. winedbg voi
acționează ca front-end pentru utilizator.

--gdb winedbg va fi folosit ca proxy pentru gDB. gDB va fi partea frontală pentru comandă
manipulare, și winedbg va trimite proxy toate solicitările de depanare de la gDB la API-urile Win32.

--auto Acest mod este utilizat când winedbg este înființat în AeDebug intrarea din registry ca implicită
depanator. winedbg va afișa apoi informații de bază despre un accident. Acest lucru este util
pentru utilizatorii care nu doresc să depaneze un accident, ci mai degrabă să adune informații relevante
despre accidentul care urmează să fie trimis dezvoltatorilor.

--minidump
Acest mod este similar cu cel --auto unul, cu excepția faptului că în loc să imprimați
informații de pe ecran (cum --auto face), este salvat într-un fișier minidump. The
numele fișierului este fie transmis pe linia de comandă, fie generat de WineDbg cand
nu se da nici una. Acest fișier ar putea fi reîncărcat ulterior în winedbg pentru mai multe
examinare.

fișier.mdmp
În acest mod winedbg reîncarcă starea unui depanat care a fost salvat într-un
fișier minidump. Vezi fie Minidump comanda de mai jos sau --minidump mod.

OPŢIUNI

Când este în lipsă mod, sunt disponibile următoarele opțiuni:

--comanda şir
winedbg va executa comanda şir ca și cum ar fi fost introdus pe linia de comandă winedbg,
și apoi va ieși. Acest lucru poate fi util pentru a obține pid-ul proceselor care rulează
(winedbg --command "info proc").

--fişier nume de fișier
winedbg va executa lista de comenzi conținute în fișier filename ca și cum ar fi
au fost introduse pe linia de comandă winedbg și apoi vor ieși.

Când este în gDB modul proxy, sunt disponibile următoarele opțiuni:

--nu-pornire
gDB nu va fi pornit automat. Informații relevante pentru pornire gDB is
imprimat pe ecran. Acest lucru este oarecum util atunci când nu este utilizat direct gDB dar unele
front-end-uri grafice, cum ar fi DDD or kgbd.

--cu-xterm
Aceasta va rula gDB în propriul său xterm în loc să folosească actuala consola Unix pentru
afișare textuală.

În toate modurile, restul liniei de comandă, atunci când este transmis, este folosit pentru a identifica care
programele, dacă există, trebuie depanate:

numele programului
Acesta este numele unui executabil de pornit pentru o sesiune de depanare. winedbg voi
creați de fapt un proces cu acest executabil. Dacă programe_argumente sunt, de asemenea,
date, acestea vor fi folosite ca argumente pentru crearea procesului de depanat.

wpid winedbg se va atașa procesului care este Windows pid wpid. Folosește info proc
comandă înăuntru winedbg pentru a enumera procesele care rulează și codurile lor pid-uri Windows.

lipsă
Dacă nu este specificat nimic, veți intra în depanator fără nicio rulare și nici atașat
proces. Va trebui să faci treaba singur.

COMANDE

Mod implicit mod, și în timp ce reîncărcare a Minidump fișier:
Majoritatea comenzilor utilizate în winedbg sunt asemănătoare cu cele de la gDB. Vă rugăm să consultați gDB
documentatii pentru mai multe detalii. Vezi gDB diferenţele secțiunea mai târziu pentru a obține o
lista de variatii de la gDB comenzi.

Misc. comenzi

avorta Anulează depanatorul.

părăsi Iese din depanator.

atașa N
Atașați la un proces de vin (N este ID-ul său Windows, numeric sau hexazecimal). ID-urile pot fi
obtinut folosind info proces comanda. Rețineți că info proces comanda revine
valori hexazecimale

DETAȘEAZĂ Desprindeți dintr-un proces de vin.

Ajutor comenzi

ajutor Imprimă ceva ajutor pentru comenzi.

ajutor info
Imprimă ceva ajutor pentru comenzile de informații

Debit Control comenzi

c Continuați execuția până la următorul punct de întrerupere sau excepție.

trece Treceți evenimentul de excepție până în lanțul de filtrare.

pas Continuați execuția până la următoarea linie C de cod (intră apelul funcției)

următor Continuați execuția până la următoarea linie C de cod (nu introduce apelul de funcție)

stepi Executați următoarea instrucțiune de asamblare (intră în apelul de funcție)

apoi eu Executați următoarea instrucțiune de asamblare (nu intră în apelul de funcție)

termina Executați până când se ajunge la revenirea funcției curente.

c, pas, următor, stepi, apoi eu poate fi postfixat printr-un număr (N), adică comanda
trebuie executat de N ori înainte ca controlul să fie returnat utilizatorului.

Puncte de întrerupere, puncte de veghe

permite N
Activează punctul (break|watch). N

dezactivați N
Dezactivează (break|watch)-point N

șterge N
Șterge (break|watch)-punctul N

Cond N Îndepărtează orice condiție existentă în punctul (break|watch). N

Cond N expres
Adaugă condiție expres la (rupere|vizionare)-punct N. expres va fi evaluat de fiecare dată când
(break|watch)-punctul este lovit. Dacă rezultatul este o valoare zero, punctul de întrerupere nu este
declanșat.

rupe * N
Adaugă un punct de întrerupere la adresa N

rupe id
Adaugă un punct de întrerupere la adresa simbolului id

rupe id N
Adaugă un punct de întrerupere la linie N simbol interior id.

rupe N
Adaugă un punct de întrerupere la linie N a fișierului sursă curent.

rupe Adaugă un punct de întrerupere la curent $PC adresa.

ceas * N
Adaugă o comandă de urmărire (la scriere) la adresă N (pe 4 octeți).

ceas id
Adaugă o comandă de urmărire (la scriere) la adresa simbolului id. Marimea depinde de marime
of id.

ceas * N
Adaugă o comandă de urmărire (la citire) la adresă N (pe 4 octeți).

ceas id
Adaugă o comandă de ceas (la citire) la adresa simbolului id. Mărimea depinde de mărimea
id.

info rupe
Listează toate punctele (break|watch) (cu starea lor).

Puteți folosi simbolul Punct de intrare pentru a reprezenta punctul de intrare al Dll.

Când setați un punct (pauză|watch) de id, dacă simbolul nu poate fi găsit (de exemplu,
simbolul este conținut într-un modul care nu este încă încărcat), winedbg își va aminti numele
simbol și va încerca să seteze punctul de întrerupere de fiecare dată când este încărcat un nou modul (până când acesta
reușește).

Stivui manipulare

bt Imprimați stiva de apelare a firului curent.

bt N Imprimați stiva de apelare de fir de ID N. Notă: acest lucru nu schimbă poziția lui
cadrul curent așa cum este manipulat de up & dn comenzi).

up Urcă cu un cadru în stiva firului curent

up N Merge în sus N cadre în stiva firului curent

dn Coboară cu un cadru în stiva firului curent

dn N Se duce în jos N cadre în stiva firului curent

cadru N
Seturi N ca cadru curent pentru stiva de fir curent.

info localnici
Imprimă informații despre variabilele locale pentru cadrul funcției curente.

director & sursă fişier manipulare

Arăta dir
Tipărește lista de directori în care sunt căutate fișierele sursă.

dir caii de acces
Adaugă caii de acces la lista de directori unde să căutați fișierele sursă

dir Șterge lista de directori unde să caute fișierele sursă

fişier simbol caii de acces
Încarcă fișierul extern de definire a simbolului caii de acces

fişier simbol caii de acces N
Încarcă fișierul extern de definire a simbolului caii de acces (aplicarea unui offset de N la
adrese)

listă Listează 10 linii sursă înainte de la poziția curentă.

listă - Listează 10 linii sursă înapoi de la poziția curentă

listă N Listează 10 linii sursă din linie N în dosarul curent

listă caii de acces:N
Listează 10 linii sursă din linie N în dosar caii de acces

listă id
Listează 10 linii sursă de funcție id

listă * N
Listează 10 linii sursă de la adresă N

Puteți specifica ținta finală (pentru a modifica valoarea celor 10 linii) folosind separatorul „,”. Pentru
exemplu:

listă 123, 234
listează liniile sursă de la linia 123 până la linia 234 în fișierul curent

listă foo.c:1,56
listează liniile sursă de la rândul 1 până la 56 în fișierul foo.c

Afiseaza

Un afișaj este o expresie care este evaluată și tipărită după executarea oricărei winedbg
comanda.

afișa

info afișa
Listează afișajele active

afișa expres
Adaugă un afișaj pentru exprimare expres

afișa /fmt expres
Adaugă un afișaj pentru exprimare expres. Tipărirea evaluată expres se face folosind data
format (vezi imprima comandă pentru mai multe despre formate)

del afișa N

neafișează N
Șterge afișajul N

dezasamblarea

disas Dezasamblați din poziția curentă

disas expres
Dezasamblați de pe adresă expres

disas expres,expres
Dezasambla codul între adresele specificate de cele două expresii

Memorie (citind, scris, tastare)

x expres Examinează memoria la adresa expres

x /fmt expres
Examinează memoria la adresa expres folosind formatul fmt

imprima expres
Imprimă valoarea lui expres (posibil folosind tipul său)

imprima /fmt expres
Imprimă valoarea lui expres (posibil folosind tipul său)

set a fost = expres
Scrie valoarea lui expres in a fost variabil

ce este expres
Imprimă tipul C de expresie expres

fmt este fie scrisoare or conta scrisoare, În cazul în care scrisoare poate fi:

este un șir ASCII

ua șir Unicode UTF16

i instrucțiuni (dezasamblați)

x întreg hexazecimal fără semn pe 32 de biți

d întreg zecimal cu semn pe 32 de biți

w număr întreg hexazecimal fără semn pe 16 biți

caracterul c (numai 0x20-0x7f imprimabile sunt de fapt tipărite)

b întreg hexazecimal fără semn pe 8 biți

g Win32 GUID

Expresii

Expresiile din Wine Debugger sunt scrise în cea mai mare parte într-o formă C. Cu toate acestea, există câteva
discrepanțe:

Identificatorii pot lua un „!” în numele lor. Acest lucru permite în principal specificarea unui modul
de unde să cauti ID-ul, de ex USER32!Create WindowExA.

Într-o operație de turnare, atunci când specificați o structură sau o unire, trebuie să utilizați structura
sau cuvânt cheie union (chiar dacă programul dvs. folosește un typedef).

Când se specifică un identificator, dacă există mai multe simboluri cu acest nume, depanatorul va face acest lucru
solicitați simbolul pe care doriți să îl utilizați. Ridică-l pe cel dorit de la numărul său.

Misc.

Minidump fișier.mdmp salvează contextul de depanare al persoanei depanate într-un fișier minidump numit
fișier.mdmp.

Informații on Vin interne

info clasă
Listează toate clasele Windows înregistrate în Wine

info clasă id
Imprimă informații despre clasa Windows id

info acțiune
Listează toate bibliotecile dinamice încărcate în programul depanat (inclusiv .so
fișiere, DLL-uri NE și PE)

info acțiune N
Imprimă informații despre modul la adresa N

info REGS
Imprimă valoarea registrelor CPU

info toate-reg
Tipărește valoarea CPU și a registrelor în virgulă mobilă

info segment
Listează toate segmentele alocate (numai i386)

info segment N
Imprimă informații pe segment N (doar i386)

info stivui
Imprimă valorile deasupra stivei

info Hartă
Listează toate mapările virtuale utilizate de programul depanat

info Hartă N
Listează toate mapările virtuale utilizate de programul Windows pid N

info wnd
Afișează ierarhia ferestrelor începând de la fereastra desktopului

info wnd N
Imprimă informații despre fereastra mânerului N

info proces
Listează toate procesele w din sesiunea Wine

info fir
Listează toate firele w din sesiunea Wine

info cadru
Listează cadrele de excepție (începând cu cadrul stivei curente). Poți și să treci,
ca argument opțional, un id de fir (în loc de firul curent) pentru a-l examina
cadre de excepție.

Mesajele de depanare pot fi activate și dezactivate pe măsură ce depanați folosind set comanda, dar
numai pentru canalele inițializate cu WINEDBURG variabilă de mediu.

set avertiza + câştiga
Pornește avertizare câştiga canal

set + câştiga
Activează warn/fixme/err/trace câştiga canal

set - câştiga
Dezactivează warn/fixme/err/trace câştiga canal

set fixme - toate
Dezactivează clasa fixme pe toate canalele

Gdb mod:
A se vedea gDB documentatie pentru toate gDB comenzi.

Cu toate acestea, sunt disponibile câteva extensii Wine, prin intermediul monitorizează comanda:

monitorizează wnd
Listează toate ferestrele din sesiunea Wine

monitorizează proc
Listează toate procesele din sesiunea Wine

monitorizează în sine
Afișează maparea memoriei procesului depanat

Auto și Minidump moduri:
Deoarece nu este posibilă introducerea utilizatorului, nu sunt disponibile comenzi.

MEDIUL

WINE_GDB
Când este folosit în gDB modul proxy, WINE_GDB specifică numele (și calea) fișierului
executabil pentru a fi folosit gDB. „gdb” este folosit implicit.

AUTORI

Prima versiune a fost scrisă de Eric Youngdale.

Consultați lista dezvoltatorilor de vinuri pentru restul colaboratorilor.

Utilizați winedbg-development online folosind serviciile onworks.net