.dump (Buat File Cadangan)
Perintah .dump membuat file crash dump mode pengguna atau mode kernel.
.dump [options] FileName
.dump /?
Parameter
Opsi
Mewakili satu atau beberapa opsi berikut.
/J
Buat cadangan untuk semua proses (memerlukan -u).
/b[a]
Cadangan paket dalam CAB dan hapus cadangan. Informasi tambahan disertakan jika opsi ditentukan .
/c <komentar>
Tambahkan komentar (tidak didukung dalam semua format).
/j <addr>
Berikan alamat JIT_DEBUG_INFO.
/O
Menimpa file cadangan yang ada dengan nama yang sama. Jika opsi ini tidak digunakan dan ada file dengan nama file yang sama, file cadangan tidak ditulis.
/u
Tambahkan pengidentifikasi unik untuk mencadangkan nama.
/f[FullOptions]
(Mode kernel:) Membuat cadangan memori lengkap.
(Mode pengguna:) Tidak didukung. Sebelumnya opsi ini akan membuat dump mode pengguna penuh, yang merupakan format warisan dengan informasi yang lebih sedikit daripada format minidump yang lebih baru. Untuk informasi selengkapnya, lihat Varietas File Cadangan User-Mode.
Anda dapat menambahkan FullOptions berikut untuk mengubah konten file cadangan; opsi peka huruf besar/kecil.
| FullOption | Efek |
|---|---|
| y | Menambahkan informasi pendaftaran AVX ke file cadangan. |
/m[MiniOptions]
Membuat cadangan memori kecil (dalam mode kernel) atau minidump (dalam mode pengguna) Untuk informasi selengkapnya, lihat File Cadangan Mode Pengguna. Jika tidak ada /f maupun /m yang ditentukan, /m adalah default.
Dalam mode pengguna, /m dapat diikuti dengan MiniOption tambahan yang menentukan data tambahan yang akan disertakan dalam cadangan. Jika tidak ada MiniOption yang disertakan, cadangan akan menyertakan informasi modul, utas, dan tumpukan, tetapi tidak ada data tambahan. Anda dapat menambahkan salah satu MiniOptions berikut untuk mengubah konten file cadangan; peka huruf besar/kecil.
| MiniOption | Efek |
|---|---|
| a | Membuat minidump dengan semua penambahan opsional. Opsi /ma setara dengan /mfFhut -- menambahkan data memori penuh, menangani data, informasi modul yang tidak dimuat, informasi memori dasar, dan informasi waktu utas ke minidump. Setiap kegagalan untuk membaca memori yang tidak dapat diakses menghasilkan penghentian pembuatan minidump. |
| A | Opsi /mA setara dengan /ma kecuali mengabaikan kegagalan untuk membaca memori yang tidak dapat diakses dan terus menghasilkan minidump. |
| f | Menambahkan data memori penuh ke minidump. Semua halaman berkomitmen yang dapat diakses yang dimiliki oleh aplikasi target akan disertakan. |
| F | Menambahkan semua informasi memori dasar ke minidump. Ini menambahkan aliran ke minidump yang berisi semua informasi memori dasar, bukan hanya informasi tentang memori yang valid. Ini memungkinkan debugger untuk merekonstruksi tata letak memori virtual lengkap dari proses ketika minidump sedang di-debug. |
| h | Menambahkan data tentang handel yang terkait dengan aplikasi target ke minidump. |
| u | Menambahkan informasi modul yang tidak dimuat ke minidump. |
| t | Menambahkan informasi utas tambahan ke minidump. Ini termasuk waktu utas, yang dapat ditampilkan dengan menggunakan ekstensi !runaway atau perintah .ttime (Display Thread Times) saat men-debug minidump. |
| i | Menambahkan memori sekunder ke minidump. Memori sekunder adalah memori apa pun yang direferensikan oleh pointer pada tumpukan atau penyimpanan cadangan, ditambah wilayah kecil di sekitar alamat ini. |
| p | Menambahkan data blok lingkungan proses (PEB) dan blok lingkungan utas (TEB) ke minidump. Ini dapat berguna jika Anda memerlukan akses ke informasi sistem Windows mengenai proses dan utas aplikasi. |
| w | Menambahkan semua halaman privat baca-tulis yang diterapkan ke minidump. |
| d | Menambahkan semua segmen data baca-tulis dalam gambar yang dapat dieksekusi ke minidump. |
| c | Menambahkan bagian kode dalam gambar. |
| r | Menghapus dari minidump bagian tumpukan tersebut dan menyimpan memori yang tidak berguna untuk membuat ulang jejak tumpukan. Variabel lokal dan nilai jenis data lainnya juga dihapus. Opsi ini tidak membuat minidump lebih kecil (karena bagian memori ini hanya nol), tetapi berguna jika Anda ingin melindungi privasi aplikasi lain. |
| R | Menghapus jalur modul lengkap dari minidump. Hanya nama modul yang akan disertakan. Ini adalah opsi yang berguna jika Anda ingin melindungi privasi struktur direktori pengguna. |
| y | Menambahkan informasi pendaftaran AVX ke file cadangan. |
Opsi Mode Kernel
Opsi berikut tersedia dalam mode kernel.
/K
Buat cadangan dengan memori kernel saja.
/Ka
Buat cadangan dengan kernel aktif dan memori mode pengguna.
Informasi Tambahan
Untuk deskripsi file cadangan mode kernel dan penjelasan penggunaannya, lihat File Cadangan Mode Kernel. Untuk deskripsi file cadangan mode pengguna dan penjelasan penggunaannya, lihat File Cadangan Mode Pengguna.
Keterangan
Perintah ini dapat digunakan dalam berbagai situasi:
Selama penelusuran kesalahan mode pengguna langsung, perintah ini mengarahkan aplikasi target untuk menghasilkan file cadangan, tetapi aplikasi target tidak dihentikan.
Selama debugging mode kernel langsung, perintah ini mengarahkan komputer target untuk menghasilkan file cadangan, tetapi komputer target tidak crash.
Selama debugging crash dump, perintah ini membuat file crash dump baru dari yang lama. Ini berguna jika Anda memiliki file crash dump besar dan ingin membuat yang lebih kecil.
Anda dapat mengontrol jenis file cadangan apa yang akan dihasilkan:
Dalam mode kernel, untuk menghasilkan cadangan memori lengkap, gunakan opsi /f . Untuk menghasilkan cadangan memori kecil, gunakan opsi /m (atau tanpa opsi). Perintah .dump tidak dapat menghasilkan cadangan memori kernel.
Dalam mode pengguna, .dump/m[MiniOptions] adalah pilihan terbaik. Meskipun "m" adalah singkatan dari "minidump", file dump yang dibuat dengan menggunakan MiniOption ini dapat bervariasi dalam ukuran dari sangat kecil hingga sangat besar. Dengan menentukan MiniOption yang tepat, Anda dapat mengontrol dengan tepat informasi apa yang disertakan. Misalnya, .dump /ma menghasilkan cadangan dengan banyak informasi. Perintah lama, .dump /f, menghasilkan file "cadangan standar" yang cukup besar dan tidak dapat disesuaikan.
Anda tidak dapat menentukan proses mana yang dicadangkan. Semua proses yang berjalan akan dibuang.
Opsi /xc, /xr, /xp, dan /xt digunakan untuk menyimpan informasi pengecualian dan konteks dalam file cadangan. Ini memungkinkan perintah .ecxr (Rekaman Konteks Pengecualian Tampilan) dijalankan pada file cadangan ini.
Contoh berikut akan membuat minidump mode pengguna, yang berisi memori penuh dan menangani informasi:
0:000> .dump /mfh myfile.dmp
Menangani informasi dapat dibaca dengan menggunakan perintah !handle extension.
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk