Opciones de SymChk Command-Line

SymChk usa la sintaxis siguiente:

symchk [/r] [/v | /q ] FileNames /s[Opts] SymbolPath Options

symchk [/r] [/v | /q ] /ie ExeFile /s[Opts] SymbolPath Options

symchk [/r] [/v | /q ] /id DumpFile /s[Opts] SymbolPath Options

symchk [/r] [/v | /q ] /ih HotFixFile /s[Opts] SymbolPath Options

symchk [/r] [/v | /q ] /ip ProcessID /s[Opts] SymbolPath Options

symchk [/r] [/v | /q ] /it TextFileList /s[Opts] SymbolPath Options

symchk [/r] [/v | /q ] /om Manifest FileNames

symchk [/v | /q ] /im ManifestList /s[Opts] SymbolPath Options

symchk [/v | /q ] /om Manifest /ie ExeFile

symchk [/v | /q ] /om Manifest /id DumpFile

symchk [/v | /q ] /om Manifest /ih HotFixFile

symchk [/v | /q ] /om Manifest /ip ProcessFile

symchk [/v | /q ] /om Manifest /it TextFileList

Parámetros

/r
Si Files especifica un directorio, la opción /r hace que SymChk busque recursivamente todos los subdirectorios en este directorio para los archivos de programa.

/V
Muestra información detallada. Esto incluye el nombre de archivo de cada archivo de programa cuyos símbolos se investigaron y si se pasó, produjo un error o se omitió.

/Q
Habilita el modo silencioso. Se suprimirá toda la salida (a menos que se incluya la opción /ot ).

Nombres
Especifica los archivos de programa cuyos símbolos se van a comprobar. Se permiten rutas de acceso absolutas, rutas de acceso relativas y rutas UNC. Se permite un carácter comodín asterisco (*). Si *FileNames termina en una barra diagonal, se toma como nombre de directorio y se comprueban todos los archivos de ese directorio. Si FileNames contiene espacios, debe ir entre comillas.

/ieExeFile
Especifica el nombre de un programa que se está ejecutando actualmente. Se comprobarán los símbolos de este programa. ExeFile debe incluir el nombre del archivo y la extensión de archivo (normalmente .exe), pero no hay información de ruta de acceso. Si hay dos ejecutables diferentes con el mismo nombre, no se recomienda esta opción. ExeFile puede especificar cualquier programa, incluido un controlador en modo kernel. Si ExeFile es un solo asterisco (*), SymChk comprobará los símbolos de todos los procesos en ejecución, incluidos los controladores.

/idDumpFile
Especifica un archivo de volcado de memoria. Se comprobarán los símbolos de este archivo de volcado de memoria.

/ihHotFixFile
Especifica un archivo CAB de revisión autoextraído.

/ipProcessID
Especifica el identificador de proceso de un programa que se está ejecutando actualmente. Se comprobarán los símbolos de este programa. ProcessID debe especificarse como un número decimal. Se admiten dos caracteres comodín especiales:

• Si ProcessID es cero ( 0 ), SymChk comprobará los símbolos de todos los controladores en ejecución.

• Si ProcessID es un único asterisco (*), SymChk comprobará los símbolos de todos los procesos en ejecución, incluidos los controladores.

/itTextFileList
Especifica un archivo de texto que contiene una lista de archivos de programa. Se comprobarán los símbolos de todos estos programas. TextFileList debe especificar exactamente un archivo (por ruta de acceso relativa, absoluta o UNC, pero sin caracteres comodín); si contiene espacios, debe ir entre comillas. Dentro de este archivo, cada línea indica un archivo de programa (por rutas relativas, absolutas o UNC) y se permite un carácter comodín asterisco (*). Sin embargo, cualquier línea que use este carácter comodín debe usar una ruta de acceso relativa.

Si una línea de este archivo contiene espacios, debe ir entre comillas. Un punto y coma dentro de este archivo es un carácter de comentario: se omitirá todo lo que haya entre un punto y coma y el final de la línea.

/imManifestList
Especifica que la entrada del comando es un archivo de manifiesto creado anteriormente mediante el parámetro /om . El archivo de manifiesto contiene información sobre los archivos para los que se recuperan los símbolos. Para obtener más información sobre el uso de un archivo de manifiesto, vea Uso de un archivo de manifiesto con SymChk.

/omManifest
Especifica que se crea un archivo de manifiesto. El archivo de manifiesto contiene información sobre un conjunto de archivos para los que se recuperarán los símbolos, mediante el parámetro /im , más adelante.

/s[Opts] SymbolPath
Especifica los directorios que contienen símbolos. Se permiten rutas de acceso absolutas, rutas de acceso relativas y rutas UNC. Se puede especificar cualquier número de directorios: se deben separar varios directorios con punto y coma. Si SymbolPath contiene espacios, debe ir entre comillas. Si desea especificar un servidor de símbolos dentro de esta ruta de acceso, debe usar una de las sintaxis siguientes:

srv*DownstreamStore*\\Server\Share
srv*\\Server\Share

No se recomienda omitir el parámetro /s[Opts] SymbolPath, pero si se omite, SymChk apuntará al almacén de símbolos público mediante la siguiente ruta de acceso predeterminada:

srv*%SystemRoot%\symbols*https://msdl.microsoft.com/download/symbols

Cualquier número de las siguientes opciones puede seguir /s. No puede haber espacio entre /s y estas opciones:

e
SymChk comprobará cada ruta individualmente en lugar de comprobar todas las rutas de acceso a la vez.

u
Se actualizarán los almacenes de bajada. Si la ruta de acceso al símbolo incluye un almacén de bajada, se buscará en los archivos de símbolos. Solo se actualizarán los almacenes de símbolos que SymChk comprueba.

P
Forzar la comprobación de símbolos privados. Los símbolos públicos se tratarán como no coincidentes. La opción p implica e y u, y no se puede usar con s.

s
Forzar la comprobación de símbolos públicos (divididos). Los símbolos privados se tratarán como no coincidentes. La opción s implica e y u, y no se puede usar con p.

R
Expanda todos los elementos del servidor que no son símbolos de la ruta de acceso especificada para realizar una búsqueda en profundidad de la ruta de acceso. NOTA: Esta opción puede producir coincidencias que no se producirán dentro del depurador, ya que modifica la ruta de acceso del símbolo especificada.

Opciones Las opciones disponibles se dividen en varias clases. Cada clase de opciones controla un conjunto diferente de características.

Opciones de salida. Se puede especificar cualquier número de las siguientes opciones. Estas opciones se pueden abreviar mediante /o solo una vez; por ejemplo, /oi /oe se puede escribir como /oie.

Opción	Efecto
/Oe	La salida incluirá errores individuales. Esta opción solo es útil si se usa /q , ya que los errores individuales se muestran automáticamente si no se ha activado el modo silencioso.
/op	La salida enumerará cada archivo que pase. (De forma predeterminada, SymChk solo muestra los archivos que producen errores en las pruebas).
/Oi	La salida enumerará cada archivo que se omitió. (De forma predeterminada, SymChk solo muestra los archivos que producen errores en las pruebas).
/od	La salida incluirá detalles completos. Igual que /oe /op /oi.
/Ot	La salida incluirá los totales de resultados. Esta opción solo es útil si se usa /q , ya que estos totales se muestran automáticamente si no se ha activado el modo silencioso.
/Ob	La ruta de acceso completa para los archivos binarios se incluirá en todos los mensajes de salida.
/os	La ruta de acceso completa para los símbolos se incluirá en todos los mensajes de salida.
/ocDir	SymChk creará un árbol de símbolos tradicional en el directorio Dir que contiene una lista de todos los archivos de símbolos activados.
/Ov	SymChk imprimirá también la información de la versión de los archivos binarios comprobados.
/ol File	Además de los mensajes enviados a estándar, escriba un archivo que contenga una lista separada por comas de todos los archivos binarios y sus símbolos que pasen la comprobación de símbolos.

Opciones de archivo DBG. Estas opciones controlan cómo SymChk comprueba los archivos de símbolos .dbg . Solo se puede especificar una de las siguientes opciones.

Opción	Efecto
/ds	SymChk comprobará que la información .dbg se quitó del archivo ejecutable y solo aparece en el archivo .dbg y que el ejecutable apunta al archivo .dbg. Si el programa se creó sin archivos de símbolos .dbg, esta opción no tiene ningún efecto. Este es el valor predeterminado.
/de	SymChk comprobará que la información .dbg no se quitó del ejecutable y que el ejecutable no apunta a un archivo .dbg. Si el programa se creó sin archivos de símbolos .dbg, esta opción no tiene ningún efecto.
/Dn	SymChk comprobará que la información de .dbg no está presente en la imagen y que la imagen no apunta a un archivo .dbg.

Opciones de archivo PDB. Estas opciones controlan cómo SymChk comprueba los archivos de símbolos .pdb. Solo se puede especificar una de las siguientes opciones.

Opción	Efecto
/Pf	SymChk no realiza ninguna comprobación del contenido del archivo .pdb; solo comprueba que los archivos existen y coinciden con el binario. Este es el valor predeterminado.
/Ps	SymChk comprobará que los archivos .pdb se han quitado de la línea de origen, el tipo de datos y la información global.
/Pt	SymChk comprobará que los archivos .pdb contienen información de tipo de datos.

Opciones de filtrado. Estas opciones controlan cómo se realiza el filtrado de módulos cuando SymChk comprueba los procesos o los archivos de volcado. Solo se puede especificar una de las siguientes opciones.

Opción	Efecto
Módulo /fm	SymChk solo comprobará los archivos o procesos de volcado de memoria asociados al módulo especificado. El módulo debe incluir el nombre de archivo completo, pero no debe incluir ninguna parte de la ruta de acceso del directorio.

Opciones de comprobación de símbolos. Se puede especificar cualquier número de las siguientes opciones.

Opción	Efecto
/Cs	SymChk no comprobará que los datos de CodeView están presentes. (De forma predeterminada, se comprueba la presencia de datos de CodeView).
/Cc	Cuando SymChk está comprobando un archivo CAB de revisión, no buscará símbolos dentro de la cabina. (De forma predeterminada, SymChk buscará símbolos en la cabina, así como en la ruta de acceso de símbolo proporcionada).
/eaFile	SymChk no comprobará los símbolos de los programas enumerados en el archivo especificado. Esto le permite vetar ciertos programas que, de lo contrario, se verificarían. El archivo debe especificar exactamente un archivo (por ruta de acceso relativa, absoluta o UNC, pero sin caracteres comodín); si contiene espacios, debe ir entre comillas. En Archivo, cada línea indica un archivo de programa (por rutas relativas, absolutas o UNC); no se permiten caracteres comodín. Si una línea de este archivo contiene espacios, debe incluirse entre comillas. Un punto y coma dentro de este archivo es un carácter de comentario; todo lo que hay entre un punto y coma y el final de la línea se omitirá. Si se usa un servidor de símbolos, los símbolos de estos programas no se copiarán en el almacén de bajada.
/eeFile	Se suprimen los mensajes de error de los programas enumerados en el archivo especificado. Los mensajes "Correcto" e "omitir" aparecerán como de costumbre, y los archivos de símbolos se copiarán en el almacén de bajada como de costumbre. El formato de File y el formato de su contenido son los mismos que para /eaFile.

Información adicional

Para obtener más información sobre SymChk, consulte Uso de SymChk.