.dump (Crear archivo de volcado)

El comando .dump crea un archivo de volcado de memoria en modo de usuario o modo kernel.

.dump [options] FileName
.dump /?

Parámetros

Opciones
Representa una o varias de las siguientes opciones.

/a
Cree volcados de memoria para todos los procesos (requiere -u).

/b[a]
Volcado de paquetes en un CAB y eliminación de volcado de memoria. Se incluye información adicional si se especifica la opción .

Comentario /c <>
Agregue un comentario (no se admite en todos los formatos).

/j <addr>
Proporcione una dirección JIT_DEBUG_INFO.

/o
Sobrescribe un archivo de volcado existente con el mismo nombre. Si esta opción no se usa y hay un archivo con el mismo nombre de archivo, el archivo de volcado no se escribe.

/u
Anexe un identificador único al nombre del volcado de memoria.

/f[FullOptions]
(Modo kernel:) Crea un volcado de memoria completo.

(Modo de usuario:) No se admite. Anteriormente, esta opción crearía un volcado de memoria en modo usuario completo, que es un formato heredado con menos información que el formato de minivolcado más reciente. Para obtener más información, vea Variedades de archivos de volcado de User-Mode.

Puede agregar lo siguiente a FullOptions para cambiar el contenido del archivo de volcado de memoria; la opción distingue mayúsculas de minúsculas.

FullOption	Efecto
y	Agrega información de registro de AVX al archivo de volcado de memoria.

/m[MiniOptions]
Crea un volcado de memoria pequeño (en modo kernel) o un minivolcado (en modo de usuario) Para obtener más información, vea Archivos de volcado en modo de usuario. Si no se especifica /f ni /m , /m es el valor predeterminado.

En el modo de usuario, /m se puede seguir con miniopciones adicionales que especifican datos adicionales que se van a incluir en el volcado. Si no se incluye ningún MiniOptions , el volcado incluirá información de módulo, subproceso y pila, pero ningún dato adicional. Puede agregar cualquiera de los siguientes MiniOptions para cambiar el contenido del archivo de volcado; distinguen mayúsculas de minúsculas.

MiniOption	Efecto
a	Crea un minivolcado con todas las adiciones opcionales. La opción /ma es equivalente a /mfFhut: agrega datos de memoria completa, controla los datos, la información del módulo descargado, la información de memoria básica y la información de tiempo de subproceso al minivolcado. Cualquier error al leer la memoria inaccessable da como resultado la finalización de la generación de minivolcados.
A	La opción /mA es equivalente a /ma, salvo que omite cualquier error al leer la memoria accesible y continúa generando el minivolcado.
f	Agrega datos de memoria completa al minivolcado. Se incluirán todas las páginas confirmadas accesibles que pertenecen a la aplicación de destino.
F	Agrega toda la información básica de memoria al minivolcado. Esto agrega una secuencia al minivolcado que contiene toda la información básica de memoria, no solo información sobre la memoria válida. Esto permite al depurador reconstruir el diseño de memoria virtual completo del proceso cuando se depura el minivolcado.
h	Agrega datos sobre los identificadores asociados a la aplicación de destino al minivolcado.
u	Agrega información del módulo descargado al minivolcado.
t	Agrega información adicional sobre subprocesos al minivolcado. Esto incluye tiempos de subproceso, que se pueden mostrar mediante la extensión !runaway o el comando .ttime (Display Thread Times) al depurar el minivolcado.
i	Agrega memoria secundaria al minivolcado. La memoria secundaria es cualquier memoria a la que hace referencia un puntero en la pila o el almacén de respaldo, además de una pequeña región que rodea esta dirección.
p	Agrega datos de bloque de entorno de proceso (PEB) y bloque de entorno de subprocesos (TEB) al minivolcado. Esto puede ser útil si necesita acceder a la información del sistema windows con respecto a los procesos y subprocesos de la aplicación.
w	Agrega todas las páginas privadas de lectura y escritura confirmadas al minivolcado.
d	Agrega todos los segmentos de datos de lectura y escritura dentro de la imagen ejecutable al minivolcado.
c	Agrega secciones de código dentro de imágenes.
r	Elimina de la minivolcado esas partes de la pila y almacena la memoria que no son útiles para volver a crear el seguimiento de la pila. También se eliminan variables locales y otros valores de tipo de datos. Esta opción no hace que el minivolcado sea más pequeño (ya que estas secciones de memoria son simplemente cero), pero es útil si desea proteger la privacidad de otras aplicaciones.
R	Elimina las rutas de acceso completas del módulo desde el minivolcado. Solo se incluirán los nombres de módulo. Esta es una opción útil si desea proteger la privacidad de la estructura de directorios del usuario.
y	Agrega información de registro de AVX al archivo de volcado de memoria.

Opciones del modo kernel

Las siguientes opciones están disponibles en modo kernel.

/K
Cree un volcado de memoria solo con memoria del kernel.

/Ka
Cree un volcado de memoria con el kernel activo y la memoria en modo de usuario.

Información adicional

Para obtener una descripción de los archivos de volcado del modo kernel y una explicación de su uso, consulte Archivos de volcado en modo kernel. Para obtener una descripción de los archivos de volcado en modo de usuario y una explicación de su uso, consulte Archivos de volcado en modo de usuario.

Comentarios

Este comando se puede usar en diversas situaciones:

• Durante la depuración en modo usuario activo, este comando dirige a la aplicación de destino para generar un archivo de volcado de memoria, pero la aplicación de destino no finaliza.

• Durante la depuración en modo kernel activo, este comando dirige al equipo de destino para generar un archivo de volcado de memoria, pero el equipo de destino no se bloquea.

• Durante la depuración del volcado de memoria, este comando crea un nuevo archivo de volcado de memoria del antiguo. Esto es útil si tiene un archivo de volcado de memoria grande y desea crear uno más pequeño.

Puede controlar qué tipo de archivo de volcado se generará:

• En el modo kernel, para generar un volcado de memoria completo, use la opción /f . Para generar un pequeño volcado de memoria, use la opción /m (o ninguna opción). El comando .dump no puede generar un volcado de memoria del kernel.

• En el modo de usuario, .dump/m[MiniOptions] es la mejor opción. Aunque "m" significa "minivolcado", los archivos de volcado creados mediante este MiniOption pueden variar de tamaño de muy pequeño a muy grande. Al especificar los MiniOptions adecuados, puede controlar exactamente qué información se incluye. Por ejemplo, .dump /ma genera un volcado de memoria con una gran cantidad de información. El comando anterior, .dump /f, genera un archivo de "volcado estándar" de tamaño moderado y no se puede personalizar.

No se puede especificar qué proceso se vuelca. Todos los procesos en ejecución se volcarán.

Las opciones /xc, /xr, /xp y /xt se usan para almacenar información de excepciones y contexto en el archivo de volcado de memoria. Esto permite que el comando .ecxr (Mostrar registro de contexto de excepción) se ejecute en este archivo de volcado.

En el ejemplo siguiente se creará un minivolcado en modo de usuario, que contiene memoria completa y controla la información:

0:000> .dump /mfh myfile.dmp

La información de identificador se puede leer mediante el comando de extensión !handle .

Consulte también

Variedades de archivos de volcado de memoria de Kernel-Mode