.dump (Crear archivo de volcado de memoria)

El comando .dump crea un archivo de volcado de memoria en modo de usuario o en 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. Si se especifica una opción, se incluye información adicional.

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 modo de 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 en modo de usuario.

Puede agregar las siguientes opciones 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 pequeño volcado de memoria (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 de memoria. Si no se incluye ningún MiniOptions , el volcado incluirá información del módulo, el subproceso y la pila, pero no hay datos adicionales. Puede agregar cualquiera de las siguientes MiniOptions para cambiar el contenido del archivo de volcado de memoria; distingue 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, datos de control, información de módulo descargado, información de memoria básica e 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 acceso a la información del sistema de Windows con respecto a los procesos y subprocesos de la aplicación.
t	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 las 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 ceros), pero es útil si desea proteger la privacidad de otras aplicaciones.
R	Elimina las rutas de acceso de módulo completa del 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 de 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 en 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 activa, 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 en directo, 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 a partir del anterior. 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 volcado de memoria pequeño, 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 volcado. 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 de memoria.

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 !handle extension.

Consulte también

Variedades de archivos de volcado en modo kernel

.ecxr