Compartir a través de


.dump (Crear archivo de volcado de memoria)

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

.dump [options] FileName
.dump /?

Parámetros

Opciones
Representa una o más de las siguientes opciones.

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

/b[a]
Empaquete el volcado en un CAB y elimine el volcado. La información adicional se incluye si se especifica la opción a.

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

/j <addr>
Proporciona 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 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, consulte Tipos de archivos de volcado de memoria en modo usuario.

Puede agregar las siguientes opciones de 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 usuario). Para obtener más información, consulte Archivos de volcado en modo usuario. Si no se especifica /f ni /m, /m es el valor predeterminado.

En el modo usuario, /m puede ir seguido de MiniOptions para especificar datos adicionales que se van a incluir en el volcado de memoria. Si no se incluye MiniOptions, el volcado incluirá información del módulo, el subproceso y la pila, pero no de los 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 al minivolcado datos completos de memoria, datos de identificadores, información de módulos descargados, información básica de memoria e información del tiempo de subproceso. Cualquier error en la lectura de memoria inaccesible provoca la finalización de la generación del minivolcado.
A La opción /mA es equivalente a /ma, salvo que omite cualquier error en la lectura de memoria inaccesible 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 la disposición completa de la memoria virtual del proceso cuando se está depurando el minivolcado.
h Agrega al minivolcado datos sobre los identificadores asociados a la aplicación de destino.
u Agrega información del módulo descargado al minivolcado.
t Agrega información adicional del subproceso al minivolcado. Esto incluye los tiempos de los subprocesos, que se pueden mostrar mediante la extensión !runaway o el comando .ttime (Mostrar tiempos de subproceso) al depurar el minivolcado.
i Agrega memoria secundaria al minivolcado. La memoria secundaria es cualquier memoria a la que un puntero hace referencia 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 (PEB) de proceso y 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 del minivolcado aquellas partes de la pila y de la memoria de almacenamiento que no son útiles para recrear 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 (porque estas secciones de memoria simplemente se ponen a cero), pero es útil si desea proteger la privacidad de otras aplicaciones.
R Elimina las rutas de acceso completas de los módulos 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 el modo kernel.

/k
Crea un volcado de memoria solo con memoria de kernel.

/ka
Crea 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 usuario y una explicación de su uso, consulte Archivos de volcado en modo usuario.

Comentarios

Este comando se puede usar en diversas situaciones:

  • Durante la depuración en vivo en modo usuario, este comando indica a la aplicación de destino que genere un archivo de volcado, pero la aplicación destino no finaliza.

  • Durante la depuración en vivo en modo kernel, este comando indica al equipo de destino que genere un archivo de volcado, 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 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 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 esta MiniOption pueden variar de tamaño de muy pequeño a muy grande. Al especificar el modificador MiniOptions adecuado, 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 volcará. 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 usuario, que contiene memoria completa y controla la información:

0:000> .dump /mfh myfile.dmp

La información del identificador se puede leer mediante la extension de comando !handle.

Consulte también

Variedades de archivos de volcado en modo kernel

.ecxr