winedbg-development - Online di Cloud

PROGRAM:

NAMA

winedbg - Debugger anggur

RINGKASAN

anggurdbg [ Pilihan ] [ nama program [ program_argumen ] | wpid ]

anggurdbg --gdb [ Pilihan ] [ nama program [ program_argumen ] | wpid ]

anggurdbg --mobil wpid

anggurdbg --minidump [ file.mdmp ] wpid

anggurdbg file.mdmp

DESKRIPSI

anggurdbg adalah debugger untuk Wine. Ini memungkinkan:
+ men-debug aplikasi Win32 asli
+ men-debug aplikasi Winelib
+ menjadi pengganti drop-in untuk Dr Watson

MODE

anggurdbg dapat digunakan dalam lima mode. Argumen pertama untuk program menentukan mode
winedbg akan berjalan masuk.

kegagalan
Tanpa mode eksplisit, ini standar anggurdbg Modus operasi. anggurdbg akan
bertindak sebagai ujung depan bagi pengguna.

--gdb anggurdbg akan digunakan sebagai proxy untuk gdb. gdb akan menjadi ujung depan untuk perintah
penanganan, dan anggurdbg akan mem-proxy semua permintaan debug dari gdb ke API Win32.

--mobil Mode ini digunakan ketika anggurdbg diatur dalam Debug entri registri sebagai default
debugger anggurdbg kemudian akan menampilkan informasi dasar tentang crash. Ini berguna
untuk pengguna yang tidak ingin men-debug kerusakan, melainkan mengumpulkan informasi yang relevan
tentang kerusakan yang akan dikirim ke pengembang.

--minidump
Modus ini mirip dengan --mobil satu, kecuali bahwa alih-alih mencetak
informasi di layar (sebagai --mobil tidak), itu disimpan ke dalam file minidump. NS
nama file dilewatkan pada baris perintah, atau dihasilkan oleh AnggurDbg ketika
tidak ada yang diberikan. File ini nantinya bisa di reload ke anggurdbg untuk selanjutnya
pemeriksaan.

file.mdmp
Dalam mode ini anggurdbg memuat ulang status debuggee yang telah disimpan ke dalam a
berkas minidump. Lihat salah satu Minidump perintah di bawah ini, atau --minidump mode.

PILIHAN

Saat masuk kegagalan mode, opsi berikut tersedia:

--memerintah tali
anggurdbg akan menjalankan perintah tali seolah-olah itu dikunci pada baris perintah winedbg,
dan kemudian akan keluar. Ini bisa berguna untuk mendapatkan pid dari proses yang berjalan
(winedbg --command "info proc").

--mengajukan nama file
anggurdbg akan mengeksekusi daftar perintah yang terkandung dalam nama file file seolah-olah mereka
dikunci pada baris perintah winedbg, dan kemudian akan keluar.

Saat masuk gdb mode proxy, opsi berikut tersedia:

--tidak memulai
gdb tidak akan otomatis dimulai. Informasi yang relevan untuk memulai gdb is
dicetak di layar. Ini entah bagaimana berguna ketika tidak langsung menggunakan gdb tetapi beberapa
ujung depan grafis, seperti ddd or kgbd.

--dengan-xterm
Ini akan berjalan gdb dalam xtermnya sendiri alih-alih menggunakan konsol Unix saat ini untuk
tampilan tekstual.

Dalam semua mode, sisa baris perintah, ketika diteruskan, digunakan untuk mengidentifikasi
program, jika ada, harus di-debug:

nama program
Ini adalah nama executable untuk memulai sesi debugging. anggurdbg akan
benar-benar membuat proses dengan executable ini. Jika program_argumen juga merupakan
diberikan, mereka akan digunakan sebagai argumen untuk membuat proses yang akan di-debug.

wpid anggurdbg akan dilampirkan ke proses yang merupakan pid Windows wpid. Menggunakan Info proc
perintah dalam anggurdbg untuk membuat daftar proses yang berjalan dan pid Windows mereka.

kegagalan
Jika tidak ada yang ditentukan, Anda akan memasuki debugger tanpa menjalankan atau memasang
proses. Anda harus melakukan pekerjaan itu sendiri.

PERINTAH

Default mode, dan sementara memuat ulang a Minidump File:
Sebagian besar perintah yang digunakan dalam anggurdbg mirip dengan yang dari gdb. Silakan merujuk ke gdb
dokumentasi untuk beberapa detail lebih lanjut. Lihat gdb perbedaan bagian nanti untuk mendapatkan
daftar variasi dari gdb perintah.

Lain-lain. perintah

menggugurkan Membatalkan debugger.

berhenti Keluar dari debugger.

melampirkan N
Lampirkan ke proses Wine (N adalah Windows ID, numerik atau heksadesimal). ID bisa
diperoleh dengan menggunakan Info proses memerintah. Perhatikan Info proses perintah kembali
nilai heksadesimal

Lepaskan Lepaskan dari proses Wine.

Bantuan perintah

membantu Mencetak beberapa bantuan pada perintah.

membantu Info
Mencetak beberapa bantuan pada perintah info

Aliran kontrol perintah

rekening Lanjutkan eksekusi hingga breakpoint atau pengecualian berikutnya.

lulus Lewati peristiwa pengecualian ke rantai filter.

langkah Lanjutkan eksekusi hingga baris kode C berikutnya (masuk ke panggilan fungsi)

berikutnya Lanjutkan eksekusi hingga baris kode C berikutnya (tidak masuk ke panggilan fungsi)

langkah Jalankan instruksi perakitan berikutnya (masuk ke panggilan fungsi)

selanjutnya Jalankan instruksi perakitan berikutnya (tidak masuk ke panggilan fungsi)

menyelesaikan Jalankan sampai kembalinya fungsi saat ini tercapai.

rekening, langkah, berikutnya, langkah, selanjutnya dapat ditempel dengan angka (N), artinya perintah
harus dieksekusi N kali sebelum kontrol dikembalikan ke pengguna.

Breakpoint, titik pengawasan

aktif N
Mengaktifkan (break|watch)-point N

menonaktifkan N
Nonaktifkan (break|watch)-point N

hapus N
Menghapus (break|watch)-point N

cond N Menghapus kondisi yang ada ke (break|watch)-point N

cond N cepat
Menambahkan kondisi cepat ke (break|watch)-titik N. cepat akan dievaluasi setiap kali
(break|watch)-titik dipukul. Jika hasilnya adalah nilai nol, breakpoint tidak
dipicu.

istirahat * N
Menambahkan breakpoint di alamat N

istirahat id
Menambahkan breakpoint di alamat simbol id

istirahat id N
Menambahkan breakpoint pada baris N simbol dalam id.

istirahat N
Menambahkan breakpoint pada baris N dari file sumber saat ini.

istirahat Menambahkan breakpoint pada saat ini $PC alamat.

menonton * N
Menambahkan perintah menonton (saat menulis) di alamat N (pada 4 byte).

menonton id
Menambahkan perintah arloji (saat menulis) di alamat simbol id. Ukuran tergantung ukuran
of id.

jam tangan * N
Menambahkan perintah menonton (sedang dibaca) di alamat N (pada 4 byte).

jam tangan id
Menambahkan perintah arloji (saat dibaca) di alamat simbol id. Ukuran tergantung pada ukuran
id.

Info istirahat
Mencantumkan semua (break|watch)-poin (dengan statusnya).

Anda dapat menggunakan simbol Titik masuk berdiri untuk titik masuk Dll.

Saat menyetel (break|watch)-poin dengan id, jika simbol tidak dapat ditemukan (misalnya,
simbol terkandung dalam modul yang belum dimuat), anggurdbg akan mengingat nama
simbol dan akan mencoba mengatur breakpoint setiap kali modul baru dimuat (sampai
berhasil).

Tumpukan manipulasi

bt Cetak tumpukan panggilan dari utas saat ini.

bt N Cetak tumpukan panggilan dari utas ID N. Catatan: ini tidak mengubah posisi
bingkai saat ini seperti yang dimanipulasi oleh up & dn perintah).

up Naik satu bingkai di tumpukan utas saat ini

up N Naik N bingkai di tumpukan utas saat ini

dn Turun satu frame di tumpukan utas saat ini

dn N Turun N bingkai di tumpukan utas saat ini

bingkai N
set N sebagai bingkai saat ini untuk tumpukan utas saat ini.

Info penduduk setempat
Mencetak informasi tentang variabel lokal untuk bingkai fungsi saat ini.

Direktori & sumber fillet manipulasi

Menunjukkan dir
Mencetak daftar direktori tempat file sumber dicari.

dir nama jalur
Menambahkan nama jalur ke daftar direktori tempat mencari file sumber

dir Menghapus daftar direktori tempat mencari file sumber

file simbol nama jalur
Memuat file definisi simbol eksternal nama jalur

file simbol nama jalur N
Memuat file definisi simbol eksternal nama jalur (menerapkan offset dari N untuk
alamat)

daftar Daftar 10 baris sumber ke depan dari posisi saat ini.

daftar - Daftar 10 baris sumber mundur dari posisi saat ini

daftar N Daftar 10 baris sumber dari baris N dalam file saat ini

daftar nama jalur:N
Daftar 10 baris sumber dari baris N dalam file nama jalur

daftar id
Daftar 10 baris sumber fungsi id

daftar * N
Daftar 10 baris sumber dari alamat N

Anda dapat menentukan target akhir (untuk mengubah nilai 10 baris) menggunakan pemisah ','. Untuk
contoh:

daftar 123, 234
daftar baris sumber dari baris 123 hingga baris 234 dalam file saat ini

daftar foo.c:1,56
daftar baris sumber dari baris 1 hingga 56 dalam file foo.c

Menampilkan

Tampilan adalah ekspresi yang dievaluasi dan dicetak setelah eksekusi apa pun anggurdbg
perintah.

pameran

Info pameran
Mencantumkan tampilan aktif

pameran cepat
Menambahkan tampilan untuk ekspresi cepat

pameran /fmt cepat
Menambahkan tampilan untuk ekspresi cepat. Pencetakan dievaluasi cepat dilakukan dengan menggunakan yang diberikan
format (lihat mencetak Command untuk lebih lanjut tentang format)

itu pameran N

batal tampilkan N
Hapus tampilan N

pembongkaran

bencana Bongkar dari posisi saat ini

bencana cepat
Bongkar dari alamat cepat

bencana cepat,cepat
Membongkar kode antara alamat yang ditentukan oleh dua ekspresi

Memori (membaca, penulisan, mengetik)

x cepat Memeriksa memori di alamat cepat

x /fmt cepat
Memeriksa memori di alamat cepat menggunakan format fmt

mencetak cepat
Mencetak nilai cepat (mungkin menggunakan tipenya)

mencetak /fmt cepat
Mencetak nilai cepat (mungkin menggunakan tipenya)

set adalah = cepat
Tulis nilai dari cepat in adalah variabel

apa yang cepat
Mencetak ekspresi tipe C cepat

fmt juga surat or menghitung surat, Di mana surat dapat:

adalah string ASCII

ua UTF16 Unicode string

saya instruksi (membongkar)

x 32-bit bilangan bulat heksadesimal tidak bertanda

d bilangan bulat desimal bertanda 32-bit

w 16-bit unsigned heksadesimal integer

karakter c (hanya 0x20-0x7f yang dapat dicetak yang benar-benar dicetak)

b bilangan bulat heksadesimal 8-bit unsigned

g GUID Win32

Ekspresi

Ekspresi dalam Wine Debugger sebagian besar ditulis dalam bentuk C. Namun, ada beberapa
perbedaan:

Pengidentifikasi dapat mengambil '!' dalam nama mereka. Ini memungkinkan terutama untuk menentukan modul
dari mana mencari ID, mis USER32!BuatWindowExA.

Dalam operasi cast, saat menentukan struktur atau gabungan, Anda harus menggunakan struct
atau kata kunci union (bahkan jika program Anda menggunakan typedef).

Saat menentukan pengidentifikasi, jika beberapa simbol dengan nama ini ada, debugger akan
prompt untuk simbol yang ingin Anda gunakan. Ambil yang Anda inginkan dari nomornya.

Lain-lain.

Minidump file.mdmp menyimpan konteks debug dari debuggee ke dalam file minidump bernama
file.mdmp.

Informasi on anggur internal

Info kelas
Daftar semua kelas Windows yang terdaftar di Wine

Info kelas id
Mencetak informasi tentang kelas Windows id

Info 'share'
Mencantumkan semua pustaka dinamis yang dimuat dalam program yang di-debug (termasuk .so
file, NE dan PE DLL)

Info 'share' N
Mencetak informasi pada modul di alamat N

Info reg
Mencetak nilai register CPU

Info semua-reg
Mencetak nilai register CPU dan Floating Point

Info ruas
Mencantumkan semua segmen yang dialokasikan (hanya i386)

Info ruas N
Mencetak informasi tentang segmen N (i386 saja)

Info tumpukan
Mencetak nilai di atas tumpukan

Info peta
Mencantumkan semua pemetaan virtual yang digunakan oleh program yang di-debug

Info peta N
Daftar semua pemetaan virtual yang digunakan oleh program Windows pid N

Info wnd
Menampilkan hierarki jendela mulai dari jendela desktop

Info wnd N
Mencetak informasi Window of handle N

Info proses
Daftar semua w-proses dalam sesi Wine

Info benang
Daftar semua w-utas dalam sesi Wine

Info bingkai
Daftar bingkai pengecualian (mulai dari bingkai tumpukan saat ini). Bisa juga lewat,
sebagai argumen opsional, id utas (bukan utas saat ini) untuk memeriksanya
bingkai pengecualian.

Pesan debug dapat dihidupkan dan dimatikan saat Anda melakukan debug menggunakan set perintah, tapi
hanya untuk saluran yang diinisialisasi dengan ANGGUR DEBUG variabel lingkungan.

set memperingatkan + menang
Mengaktifkan peringatan menang saluran

set + menang
Mengaktifkan warning/fixme/err/trace on menang saluran

set - menang
Mematikan warning/fixme/err/trace on menang saluran

set Perbaiki aku - semua
Matikan kelas fixme di semua saluran

Gdb mode:
Lihat gdb dokumentasi untuk semua gdb perintah.

Namun, beberapa ekstensi Wine tersedia, melalui Monitor perintah:

Monitor wnd
Daftar semua jendela di sesi Wine

Monitor proc
Daftar semua proses dalam sesi Wine

Monitor Anggota
Menampilkan pemetaan memori dari proses debug

Mobil dan Minidump mode:
Karena tidak ada input pengguna yang memungkinkan, tidak ada perintah yang tersedia.

LINGKUNGAN

ANGGUR_GDB
Saat digunakan di gdb modus proksi, ANGGUR_GDB menentukan nama (dan jalur) dari
dieksekusi untuk digunakan untuk gdb. "gdb" digunakan secara default.

PENULIS

Versi pertama ditulis oleh Eric Youngdale.

Lihat daftar pengembang Wine untuk kontributor lainnya.

Gunakan winedbg-development online menggunakan layanan onworks.net