.dump (建立傾印檔案)

.dump命令會建立使用者模式或核心模式損毀傾印檔案。

.dump [options] FileName
.dump /?

參數

選項
代表下列一或多個選項。

/a
針對所有進程建立傾印 (需要 -u) 。

/b[a]
CAB 中的套件傾印和刪除傾印。 如果 指定選項， 則會包含其他資訊。

/c < 批註>
在所有格式) 不支援新增批註 (。

/j < addr>
提供JIT_DEBUG_INFO位址。

/o
覆寫具有相同名稱的現有傾印檔案。 如果未使用此選項，而且有具有相同檔案名的檔案，則不會寫入傾印檔案。

/u
將唯一識別碼附加至傾印名稱。

/f[FullOptions]
(核心模式：) 建立 完整的記憶體傾印。

(不支援使用者模式：) 。 先前，此選項會建立 完整的使用者模式傾印，這是比較新迷你傾印格式還少資訊的舊版格式。 如需詳細資訊，請參閱 各種 User-Mode 傾印檔案。

您可以新增下列 FullOptions 來變更傾印檔案的內容;選項區分大小寫。

FullOption	效果
y	將 AVX 註冊資訊新增至傾印檔案。

/m[MiniOptions]
在核心模式中建立 小型記憶體傾印 () 或使用者模式中的 迷你傾印 () 如需詳細資訊，請參閱 使用者模式傾印檔案。 如果未指定 /f 或 /m ， 則 /m 是預設值。

在使用者模式中， /m 可以遵循額外的 MiniOptions ，以指定要包含在傾印中的額外資料。 如果未包含 MiniOptions ，傾印將會包含模組、執行緒和堆疊資訊，但不會包含其他資料。 您可以新增下列任何 MiniOptions 來變更傾印檔案的內容;它們區分大小寫。

MiniOption	效果
a	建立具有所有選擇性新增功能的迷你傾印。 /ma 選項相當於 /mfFhut -- 它會將完整記憶體資料、處理資料、卸載的模組資訊、基本記憶體資訊和執行緒時間資訊新增至迷你傾印。 讀取無法存取記憶體的任何失敗都會導致迷你傾印產生終止。
A	/mA 選項相當於 /ma，不同之處在于它會忽略讀取無法存取記憶體的任何失敗，並繼續產生迷你傾印。
f	將完整記憶體資料新增至迷你傾印。 將會包含目標應用程式所擁有的所有可存取認可頁面。
F	將所有基本記憶體資訊新增至迷你傾印。 這會將資料流程新增至包含所有基本記憶體資訊的迷你傾印，而不只是有關有效記憶體的資訊。 這可讓偵錯工具在偵錯迷你傾印時重新建構進程的完整虛擬記憶體配置。
h	將與目標應用程式相關聯的控制碼相關資料新增至迷你傾印。
u	將卸載的模組資訊新增至迷你傾印。
t	將其他執行緒資訊新增至迷你傾印。 這包括執行緒時間，您可以在偵錯迷你傾印時使用 ！runaway 副檔名或 .ttime (Display Thread Times) 命令來顯示。
i	將次要記憶體新增至迷你傾印。 次要記憶體是堆疊或備份存放區指標所參考的任何記憶體，加上此位址周圍的小型區域。
p	將進程環境區塊 (PEB) 和執行緒環境區塊 (TEB) 資料新增至迷你傾印。 如果您需要存取有關應用程式進程和執行緒的 Windows 系統資訊，這非常有用。
w	將所有認可的讀寫私人頁面新增至迷你傾印。
d	將可執行檔映射內的所有讀寫資料區段新增至迷你傾印。
c	在影像中新增程式碼區段。
r	從迷你傾印中刪除這些堆疊部分，並儲存不可用於重新建立堆疊追蹤的記憶體。 也會刪除區域變數和其他資料類型值。 此選項不會讓小型傾印 (較小，因為這些記憶體區段只是) 零，但如果您想要保護其他應用程式的隱私權，這會很有用。
R	從迷你傾印中刪除完整的模組路徑。 只會包含模組名稱。 如果您想要保護使用者目錄結構的隱私權，這是有用的選項。
y	將 AVX 註冊資訊新增至傾印檔案。

核心模式選項

下列選項可在核心模式中使用。

/K
僅建立具有核心記憶體的傾印。

/嘉
建立具有作用中核心和使用者模式記憶體的傾印。

其他資訊

如需核心模式傾印檔案的描述及其使用說明，請參閱 核心模式傾印檔案。 如需使用者模式傾印檔案的描述及其使用說明，請參閱 使用者模式傾印檔案。

備註

此命令可用於各種情況：

• 在即時使用者模式偵錯期間，此命令會指示目標應用程式產生傾印檔案，但目標應用程式不會終止。

• 在即時核心模式偵錯期間，此命令會指示目的電腦產生傾印檔案，但目的電腦不會當機。

• 在損毀傾印偵錯期間，此命令會從舊的傾印檔案建立新的損毀傾印檔案。 如果您有大型損毀傾印檔案，而且想要建立較小的傾印檔案，這會很有用。

您可以控制將產生何種類型的傾印檔案：

• 在核心模式中，若要產生 完整的記憶體傾印，請使用 /f 選項。 若要產生 小型記憶體傾印，請使用 /m 選項 (或沒有選項) 。 .dump 命令無法產生 核心記憶體傾印。

• 在使用者模式中， .dump/m[MiniOptions] 是最佳選擇。 雖然 「m」 代表 「minidump」，但是使用此 MiniOption 建立的傾印檔案大小可能從非常小到非常大。 藉由指定適當的 MiniOptions ，您可以完全控制包含哪些資訊。 例如， .dump /ma 會產生具有大量資訊的傾印。 舊版命令 .dump /f會產生中等大型的「標準傾印」檔案，而且無法自訂。

您無法指定哪個進程已傾印。 所有執行中的進程都會傾印。

/xc、/xr、/xp和/xt選項可用來在傾印檔案中儲存例外狀況和內容資訊。 這可讓 .ecxr (顯示例外狀況內容記錄) 命令在此傾印檔案上執行。

下列範例會建立使用者模式迷你傾印，其中包含完整記憶體並處理資訊：

0:000> .dump /mfh myfile.dmp

您可以使用 ！handle 擴充功能命令來讀取 控制碼 資訊。

另請參閱

各種 Kernel-Mode 傾印檔案