winedbg-development - Dalam Talian di Awan

JADUAL:

NAMA

winedbg - Penyahpepijat wain

SINOPSIS

wineedbg [ pilihan ] [ nama_program [ hujah_program ] | wpid ]

wineedbg --gdb [ pilihan ] [ nama_program [ hujah_program ] | wpid ]

wineedbg --auto wpid

wineedbg --minidump [ fail.mdmp ] wpid

wineedbg fail.mdmp

DESCRIPTION

wineedbg ialah penyahpepijat untuk Wine. Ia membolehkan:
+ menyahpepijat aplikasi Win32 asli
+ menyahpepijat aplikasi Winelib
+ menjadi pengganti drop-in untuk Dr Watson

MODUL

wineedbg boleh digunakan dalam lima mod. Hujah pertama untuk program menentukan mod
winedbg akan masuk.

lalai
Tanpa sebarang mod eksplisit, ini adalah standard wineedbg mod operasi. wineedbg akan
bertindak sebagai hujung hadapan untuk pengguna.

--gdb wineedbg akan digunakan sebagai proksi untuk gdb. gdb akan menjadi bahagian hadapan untuk arahan
pengendalian, dan wineedbg akan memproksi semua permintaan penyahpepijatan daripada gdb kepada Win32 API.

--auto Mod ini digunakan apabila wineedbg disediakan dalam AeDebug entri pendaftaran sebagai lalai
penyahpepijat. wineedbg kemudian akan memaparkan maklumat asas tentang ranap sistem. Ini berguna
untuk pengguna yang tidak mahu menyahpepijat ranap sistem, sebaliknya mengumpulkan maklumat yang berkaitan
tentang ranap sistem yang akan dihantar kepada pembangun.

--minidump
Mod ini serupa dengan --auto satu, kecuali bahawa bukannya mencetak
maklumat pada skrin (seperti --auto tidak), ia disimpan ke dalam fail minidump. The
nama fail sama ada dihantar pada baris arahan, atau dijana oleh WineDbg apabila
tiada yang diberi. Fail ini kemudiannya boleh dimuat semula ke dalam wineedbg untuk lebih lanjut
pemeriksaan.

fail.mdmp
Dalam mod ini wineedbg memuatkan semula keadaan debuggee yang telah disimpan ke dalam a
fail minidump. Lihat sama ada tempat pembuangan mini perintah di bawah, atau --minidump mod.

PILIHAN

Apabila di lalai mod, pilihan berikut tersedia:

--perintah rentetan
wineedbg akan melaksanakan perintah tersebut rentetan seolah-olah ia dikunci pada baris arahan winedbg,
dan kemudian akan keluar. Ini boleh berguna untuk mendapatkan pid proses yang sedang berjalan
(winedbg --perintah "maklumat proc").

--fail nama fail
wineedbg akan melaksanakan senarai arahan yang terkandung dalam nama fail fail seolah-olah mereka
telah dikunci pada baris arahan winedbg, dan kemudian akan keluar.

Apabila di gdb mod proksi, pilihan berikut tersedia:

--tidak-mula
gdb tidak akan dimulakan secara automatik. Maklumat yang berkaitan untuk memulakan gdb is
dicetak pada skrin. Ini entah bagaimana berguna apabila tidak digunakan secara langsung gdb tetapi sebilangan
bahagian hadapan grafik, seperti ddd or kgbd.

--dengan-xterm
Ini akan berjalan gdb dalam xtermnya sendiri dan bukannya menggunakan konsol Unix semasa untuk
paparan teks.

Dalam semua mod, baris arahan yang lain, apabila diluluskan, digunakan untuk mengenal pasti yang mana
program, jika ada, perlu nyahpepijat:

nama_program
Ini ialah nama boleh laku untuk dimulakan untuk sesi nyahpepijat. wineedbg akan
sebenarnya mencipta proses dengan boleh laku ini. Jika program_argumen juga
diberikan, ia akan digunakan sebagai hujah untuk mencipta proses untuk dinyahpepijat.

wpid wineedbg akan dilampirkan pada proses yang mana Windows pid adalah wpid. Menggunakan maklumat proc
perintah dalam wineedbg untuk menyenaraikan proses yang sedang berjalan dan pid Windows mereka.

lalai
Jika tiada apa yang dinyatakan, anda akan memasukkan penyahpepijat tanpa sebarang larian atau dilampirkan
proses. Anda perlu melakukan kerja itu sendiri.

PERINTAH

Lalai mod, and manakala tambah semula a tempat pembuangan mini fail:
Kebanyakan arahan digunakan dalam wineedbg adalah serupa dengan yang dari gdb. Sila rujuk kepada gdb
dokumentasi untuk beberapa butiran lanjut. Lihat gdb perbezaan bahagian kemudian untuk mendapatkan a
senarai variasi daripada gdb menyuruh.

Misc. arahan

abort Menggugurkan penyahpepijat.

berhenti Keluar dari penyahpepijat.

melampirkan N
Lampirkan pada proses Wain (N ialah Windows ID, angka atau perenambelasan). ID boleh
diperoleh dengan menggunakan maklumat proses perintah. Perhatikan maklumat proses arahan kembali
nilai heksadesimal

lepaskan Berpisah daripada proses Wain.

Bantuan arahan

membantu Mencetak beberapa bantuan pada arahan.

membantu maklumat
Mencetak beberapa bantuan pada arahan maklumat

Aliran kawalan arahan

akaun Teruskan pelaksanaan sehingga titik putus atau pengecualian seterusnya.

lulus Lulus acara pengecualian sehingga rantai penapis.

langkah Teruskan pelaksanaan sehingga baris kod C seterusnya (masuk panggilan fungsi)

seterusnya Teruskan pelaksanaan sehingga baris kod C seterusnya (tidak memasuki panggilan fungsi)

stepi Laksanakan arahan pemasangan seterusnya (masuk panggilan fungsi)

seterusnya Laksanakan arahan pemasangan seterusnya (tidak memasuki panggilan fungsi)

selesai Laksanakan sehingga pemulangan fungsi semasa dicapai.

akaun, langkah, seterusnya, stepi, seterusnya boleh postfixed oleh nombor (N), bermakna arahan itu
mesti dilaksanakan N kali sebelum kawalan dikembalikan kepada pengguna.

Titik putus, titik pemerhatian

membolehkan N
Membolehkan (break|watch)-point N

melumpuhkan N
Lumpuhkan (break|watch)-point N

memadam N
Padam (break|watch)-point N

cond N Mengalih keluar sebarang keadaan sedia ada ke (break|watch)-point N

cond N expr
Menambah syarat expr untuk (break|watch)-point N. expr akan dinilai setiap kali
(break|watch)-point dipukul. Jika hasilnya adalah nilai sifar, titik putusnya tidak
dicetuskan.

memecahkan * N
Menambah titik putus pada alamat N

memecahkan id
Menambah titik putus pada alamat simbol id

memecahkan id N
Menambah titik putus pada baris N simbol dalam id.

memecahkan N
Menambah titik putus pada baris N fail sumber semasa.

memecahkan Menambah titik putus pada arus $PC alamat.

menonton * N
Menambah arahan jam tangan (sedang ditulis) di alamat N (pada 4 bait).

menonton id
Menambah arahan jam tangan (pada tulisan) pada alamat simbol id. Saiz bergantung pada saiz
of id.

rwatch * N
Menambah arahan jam tangan (sedang dibaca) di alamat N (pada 4 bait).

rwatch id
Menambah arahan jam tangan (sedang dibaca) pada alamat simbol id. Saiz bergantung pada saiz
id.

maklumat memecahkan
Menyenaraikan semua (break|watch)-points (dengan keadaannya).

Anda boleh menggunakan simbol Titik Masuk untuk menandakan titik masuk Dll.

Apabila menetapkan (break|watch)-titik oleh id, jika simbol tidak ditemui (contohnya,
simbol terkandung dalam modul yang belum dimuatkan), wineedbg akan mengingati nama
simbol dan akan cuba menetapkan titik putus setiap kali modul baharu dimuatkan (sehingga ia
berjaya).

Menumpukkan manipulasi

bt Cetak timbunan panggilan bagi benang semasa.

bt N Cetak timbunan panggilan benang ID N. Nota: ini tidak mengubah kedudukan
bingkai semasa seperti yang dimanipulasi oleh up & dn perintah).

up Naik satu bingkai dalam tindanan benang semasa

up N Naik N bingkai dalam timbunan benang semasa

dn Turun satu bingkai dalam timbunan benang semasa

dn N Turun ke bawah N bingkai dalam timbunan benang semasa

bingkai N
Set N sebagai bingkai semasa untuk tindanan benang semasa.

maklumat penduduk tempatan
Mencetak maklumat tentang pembolehubah tempatan untuk bingkai fungsi semasa.

Direktori & sumber fail manipulasi

Menunjukkan dir
Mencetak senarai dir tempat fail sumber dicari.

dir nama jalan
Tambah nama jalan ke senarai dir tempat mencari fail sumber

dir Memadamkan senarai dir tempat mencari fail sumber

fail simbol nama jalan
Memuatkan fail definisi simbol luaran nama jalan

fail simbol nama jalan N
Memuatkan fail definisi simbol luaran nama jalan (menggunakan offset daripada N kepada
alamat)

senarai Menyenaraikan 10 talian sumber ke hadapan dari kedudukan semasa.

senarai - Menyenaraikan 10 baris sumber ke belakang dari kedudukan semasa

senarai N Menyenaraikan 10 baris sumber daripada baris N dalam fail semasa

senarai nama jalan:N
Menyenaraikan 10 baris sumber daripada baris N dalam fail nama jalan

senarai id
Menyenaraikan 10 baris sumber fungsi id

senarai * N
Menyenaraikan 10 talian sumber daripada alamat N

Anda boleh menentukan sasaran akhir (untuk menukar nilai 10 baris) menggunakan pemisah ','. Untuk
contoh:

senarai 123, 234
menyenaraikan baris sumber dari baris 123 hingga baris 234 dalam fail semasa

senarai foo.c:1,56
menyenaraikan baris sumber dari baris 1 hingga 56 dalam fail foo.c

Memaparkan

Paparan ialah ungkapan yang dinilai dan dicetak selepas pelaksanaan mana-mana wineedbg
perintah.

memaparkan

maklumat memaparkan
Menyenaraikan paparan aktif

memaparkan expr
Menambah paparan untuk ekspresi expr

memaparkan /fmt expr
Menambah paparan untuk ekspresi expr. Percetakan dinilai expr dilakukan menggunakan yang diberikan
format (lihat cetak arahan untuk maklumat lanjut tentang format)

yang memaparkan N

tidak dipamerkan N
Memadam paparan N

Membongkar

disas Buka dari kedudukan semasa

disas expr
Buka dari alamat expr

disas expr,expr
Membongkar kod antara alamat yang ditentukan oleh dua ungkapan

Memori (membaca, menulis, menaip)

x expr Memeriksa ingatan di alamat expr

x /fmt expr
Memeriksa ingatan di alamat expr menggunakan format fmt

cetak expr
Mencetak nilai expr (mungkin menggunakan jenisnya)

cetak /fmt expr
Mencetak nilai expr (mungkin menggunakan jenisnya)

menetapkan var = expr
Menulis nilai expr in var berubah-ubah

apa expr
Mencetak jenis ungkapan C expr

fmt sama ada surat or mengira surat, Di mana surat boleh jadi:

s rentetan ASCII

ua UTF16 Unicode rentetan

i arahan (buka)

x 32-bit integer heksadesimal tidak bertanda

d integer perpuluhan bertanda 32-bit

w 16-bit integer heksadesimal tidak bertanda

aksara c (hanya boleh dicetak 0x20-0x7f sebenarnya dicetak)

b 8-bit integer heksadesimal tak bertanda

g Win32 GUID

Ungkapan

Ungkapan dalam Wine Debugger kebanyakannya ditulis dalam bentuk C. Walau bagaimanapun, terdapat beberapa
percanggahan:

Pengecam boleh mengambil '!' dalam nama mereka. Ini membolehkan terutamanya untuk menentukan modul
dari mana hendak mencari ID, cth USER32!CreateWindowExA.

Dalam operasi cast, apabila menentukan struktur atau kesatuan, anda mesti menggunakan struct
atau kata kunci kesatuan (walaupun program anda menggunakan typedef).

Apabila menentukan pengecam, jika beberapa simbol dengan nama ini wujud, penyahpepijat akan
gesaan untuk simbol yang anda mahu gunakan. Ambil yang anda mahu daripada nombornya.

Misc.

tempat pembuangan mini fail.mdmp menyimpan konteks penyahpepijatan penyahpepijat ke dalam fail minidump yang dipanggil
fail.mdmp.

Maklumat on Wain dalaman

maklumat kelas
Menyenaraikan semua kelas Windows yang didaftarkan dalam Wine

maklumat kelas id
Mencetak maklumat pada kelas Windows id

maklumat saham
Menyenaraikan semua perpustakaan dinamik yang dimuatkan dalam program nyahpepijat (termasuk .so
fail, NE dan PE DLL)

maklumat saham N
Mencetak maklumat mengenai modul di alamat N

maklumat regs
Mencetak nilai daftar CPU

maklumat semua-reg
Mencetak nilai daftar CPU dan Titik Terapung

maklumat segmen
Menyenaraikan semua segmen yang diperuntukkan (i386 sahaja)

maklumat segmen N
Mencetak maklumat pada segmen N (i386 sahaja)

maklumat timbunan
Mencetak nilai di atas timbunan

maklumat peta
Menyenaraikan semua pemetaan maya yang digunakan oleh program nyahpepijat

maklumat peta N
Menyenaraikan semua pemetaan maya yang digunakan oleh program Windows pid N

maklumat wnd
Memaparkan hierarki tetingkap bermula dari tetingkap desktop

maklumat wnd N
Mencetak maklumat Tetingkap pemegang N

maklumat proses
Menyenaraikan semua proses-w dalam sesi Wine

maklumat thread
Menyenaraikan semua w-thread dalam sesi Wine

maklumat bingkai
Menyenaraikan bingkai pengecualian (bermula dari bingkai tindanan semasa). Anda juga boleh lulus,
sebagai hujah pilihan, id utas (bukan utas semasa) untuk memeriksanya
bingkai pengecualian.

Mesej nyahpepijat boleh dihidupkan dan dimatikan semasa anda menyahpepijat menggunakan menetapkan perintah, tetapi
hanya untuk saluran yang dimulakan dengan WINEDEBUG pembolehubah persekitaran.

menetapkan memberi amaran kepada + menang
Menghidupkan amaran menang saluran

menetapkan + menang
Hidupkan amaran/fixme/err/trace menang saluran

menetapkan - menang
Mematikan warn/fixme/err/trace on menang saluran

menetapkan fixme - semua
Mematikan kelas fixme pada semua saluran

Gdb mod:
Melihat gdb dokumentasi untuk semua gdb menyuruh.

Walau bagaimanapun, beberapa sambungan Wine tersedia, melalui memantau arahan:

memantau wnd
Menyenaraikan semua tetingkap dalam sesi Wine

memantau proc
Menyenaraikan semua proses dalam sesi Wine

memantau mem
Memaparkan pemetaan memori proses nyahpepijat

Auto and tempat pembuangan mini mod:
Memandangkan tiada input pengguna boleh dilakukan, tiada arahan tersedia.

PERSEKITARAN

WINE_GDB
Apabila digunakan di gdb mod proksi, WINE_GDB menentukan nama (dan laluan) bagi
boleh laksana untuk digunakan gdb. "gdb" digunakan secara lalai.

PENGARANG

Versi pertama ditulis oleh Eric Youngdale.

Lihat senarai pembangun Wine untuk penyumbang yang lain.

Gunakan winedbg-development dalam talian menggunakan perkhidmatan onworks.net