.dump (создание файла дампа)

Команда .dump создает файл аварийного дампа в режиме пользователя или в режиме ядра.

.dump [options] FileName
.dump /?

Параметры

Параметры
Представляет один или несколько следующих параметров.

/a
Создайте дампы для всех процессов (требуется -u).

/b[a]
Дампа пакетов в CAB-файле и удалении дампа. Дополнительные сведения включаются, если указан параметр.

/c <комментарий>
Добавьте комментарий (не поддерживается во всех форматах).

/j <addr>
Укажите адрес JIT_DEBUG_INFO.

/o
Перезаписывает существующий файл дампа с тем же именем. Если этот параметр не используется и имеется файл с тем же именем файла, файл дампа не записывается.

/u
Добавьте уникальный идентификатор в имя дампа.

/f[FullOptions]
(режим ядра:) Создает полный дамп памяти.

(Режим пользователя:) Не поддерживается. Ранее этот параметр создаст полный дамп в пользовательском режиме, который является устаревшим форматом с меньшей информацией, чем новый формат minidump. Дополнительные сведения см. в разделе "Разновидности файлов дампа в режиме пользователя".

Чтобы изменить содержимое файла дампа, можно добавить следующие функции FullOptions . Параметр учитывает регистр.

FullOption	Действие
г	Добавляет сведения о регистрации AVX в файл дампа.

/m[MiniOptions]
Создает небольшой дамп памяти (в режиме ядра) или мини-dump (в пользовательском режиме) Дополнительные сведения см. в разделе "Файлы дампа в режиме пользователя". Если параметр /f и /m не указан, значение /m по умолчанию.

В пользовательском режиме за /m можно следовать с дополнительными МиниOptions , указывающими дополнительные данные, которые должны быть включены в дамп. Если мини-options не включены, дамп будет включать сведения о модуле, потоке и стеке, но нет дополнительных данных. Вы можете добавить любой из следующих MiniOptions , чтобы изменить содержимое файла дампа; они чувствительны к регистру.

MiniOption	Действие
a	Создает мини-dump со всеми необязательными дополнениями. Параметр /ma эквивалентен параметру /mfFhut. Он добавляет полные данные памяти, обрабатывает данные, выгруженные сведения о модуле, основные сведения о памяти и сведения о времени потока в мини-dump. Любая ошибка чтения недоступной памяти приводит к прекращению создания мини-dump.
а	Параметр /mA эквивалентен /ma, за исключением того, что он игнорирует любые ошибки чтения недоступной памяти и продолжает создавать мини-dump.
f	Добавляет полные данные памяти в мини-dump. Будут включены все доступные зафиксированные страницы, принадлежащие целевому приложению.
F	Добавляет все основные сведения о памяти в мини-dump. Это добавляет поток в мини-dump, содержащий все основные сведения о памяти, а не только сведения о допустимой памяти. Это позволяет отладчику восстановить полный макет виртуальной памяти процесса при отладке мини-dump.
ч	Добавляет данные об дескрипторах, связанных с целевым приложением, в мини-dump.
u	Добавляет выгруженные сведения о модуле в мини-dump.
t	Добавляет дополнительные сведения о потоке в мини-dump. Это включает время потока, которое можно отобразить с помощью расширения !runaway или команды Ttime (Display Thread Times) при отладке мини-ddump.
i	Добавляет вторичную память в мини-dump. Вторичная память — это любая память, на которую ссылается указатель на стек или резервное хранилище, а также небольшой регион, окружающий этот адрес.
п	Добавляет блок среды обработки (PEB) и блок среды потоков (TEB) в мини-dump. Это может быть полезно, если вам нужен доступ к системным данным Windows относительно процессов и потоков приложения.
w	Добавляет все зафиксированные частные страницы для чтения и записи в мини-dump.
d	Добавляет все сегменты данных чтения и записи в исполняемом образе в мини-dump.
c	Добавляет разделы кода в изображениях.
r	Удаляет из мини-dump эти части стека и хранения памяти, которые не полезны для повторного восстановления трассировки стека. Локальные переменные и другие значения типов данных также удаляются. Этот параметр не делает мини-dump меньше (так как эти разделы памяти просто ноль), но полезно, если вы хотите защитить конфиденциальность других приложений.
R	Удаляет полные пути модуля из мини-модуля. Будут включены только имена модулей. Это полезный вариант, если вы хотите защитить конфиденциальность структуры каталогов пользователя.
г	Добавляет сведения о регистрации AVX в файл дампа.

Параметры режима ядра

Следующие параметры доступны в режиме ядра.

/k
Создайте дамп только с памятью ядра.

/Ка
Создайте дамп с активной памятью ядра и пользовательского режима.

Дополнительная информация

Описание файлов дампа в режиме ядра и описание их использования см. в разделе "Файлы дампа в режиме ядра". Описание файлов дампа в пользовательском режиме и описание их использования см. в разделе "Файлы дампа в режиме пользователя".

Замечания

Эта команда может использоваться в различных ситуациях:

• Во время динамической отладки в режиме пользователя эта команда направляет целевое приложение для создания файла дампа, но целевое приложение не завершает работу.

• Во время отладки в режиме динамического ядра эта команда направляет целевой компьютер на создание файла дампа, но целевой компьютер не завершает работу.

• Во время отладки аварийного дампа эта команда создает новый файл аварийного дампа из старого. Это полезно, если у вас есть большой файл дампа аварийного сбоя и требуется создать меньший.

Вы можете управлять типом файла дампа:

• В режиме ядра для создания полного дампа памяти используйте параметр /f . Чтобы создать небольшой дамп памяти, используйте параметр /m (или нет параметров). Команда .dump не может создать дамп памяти ядра.

• В пользовательском режиме .dump /m[MiniOptions] — лучший вариант. Хотя "m" обозначает "minidump", файлы дампа, созданные с помощью этого MiniOption , могут отличаться от очень малого до очень большого. Указав правильные miniOptions , вы можете точно контролировать, какие сведения включены. Например, .dump /ma создает дамп с большой информацией. Старая команда , dump /f создает умеренно большой файл "стандартный дампа" и не может быть настроен.

Нельзя указать, какой процесс сбрасывается. Все выполняемые процессы будут дампами.

Параметры /xc, /xr, /xp и /xt используются для хранения сведений об исключении и контексте в файле дампа. Это позволяет выполнять команду ECXR (отображаемая запись контекста исключения) в этом файле дампа.

В следующем примере будет создан мини-dump в пользовательском режиме, содержащий полную память и обрабатывать сведения:

0:000> .dump /mfh myfile.dmp

Сведения об обработке можно считывать с помощью команды расширения !handle .

См. также

Разновидности файлов дампа в режиме ядра

.ecxr