Uso de SrcSrv

Para usar SrcSrv con WinDbg, KD, NTSD o CDB, compruebe que ha instalado una versión reciente del paquete Herramientas de depuración para Windows (versión 6.3 o posterior). A continuación, incluya el texto srv* en la ruta de acceso de origen, separados por punto y coma de los directorios que también estén en la ruta de acceso de origen.

Por ejemplo:

.srcpath srv*;c:\someSourceCode

Si la ruta de acceso de origen se establece como se muestra en el ejemplo anterior, el depurador usa primero SrcSrv para recuperar los archivos de origen de las ubicaciones especificadas en los archivos de símbolo de los módulos de destino. Si SrcSrv no puede recuperar un archivo de origen, el depurador intenta recuperarlo de c:\someSourceCode. Independientemente de si srv* es el primer elemento de la ruta de acceso o aparece más adelante, el depurador siempre usa SymSrv antes de buscar en otros directorios enumerados en la ruta de acceso.

Si SrcSrv recupera un archivo de origen, permanece en el disco duro una vez finalizada la sesión de depuración. Los archivos de origen se almacenan localmente en el subdirectorio src del directorio principal (a diferencia del servidor de símbolos, el servidor de origen no especifica una caché local en la srv* propia sintaxis). El directorio principal tiene como valor predeterminado el directorio de instalación herramientas de depuración para Windows; se puede cambiar mediante la extensión !homedir o estableciendo la variable de entorno DBGHELP_HOMEDIR. Si el subdirectorio src del directorio principal aún no existe, se crea.

Depuración de SrcSrv

Si experimenta algún problema al extraer los archivos de origen del depurador, inicie el depurador con el parámetro de línea de comandos -n para ver los comandos de extracción de origen reales junto con la salida de esos comandos. El comando !sym ruidoso hace lo mismo, pero es posible que ya haya perdido información importante de los intentos de extracción anteriores. Esto se debe a que el depurador deja de intentar acceder al origen desde repositorios de control de versiones que parecen no accesibles.

Recuperación de archivos de origen

Si usa el comando .open (Archivo de código abierto) para abrir un nuevo archivo de código fuente a través de SrcSrv, debe incluir el parámetro -m Address.

Para facilitar el uso de SrcSrv desde herramientas distintas de los depuradores enumerados anteriormente, dbgHelp API proporciona acceso a la funcionalidad SrcSrv a través de la función SymGetSourceFile . Para recuperar el nombre del archivo de origen que se va a recuperar, llame a la función SymEnumSourceFiles o SymGetLineFromAddr64. Para obtener más información sobre dbgHelp API, consulte la documentación de dbghelp.chm, que se puede encontrar en el subdirectorio sdk/help del directorio de instalación de Herramientas de depuración para Windows o consulte Biblioteca de ayuda de depuración.

Uso de AgeStore para reducir el tamaño de caché

Los archivos de código fuente descargados por SrcSrv permanecen en el disco duro después de que finalice la sesión de depuración. Para controlar el tamaño de la memoria caché de origen, la herramienta AgeStore se puede usar para eliminar archivos almacenados en caché anteriores a una fecha especificada o para reducir el contenido de la memoria caché por debajo de un tamaño especificado. Para obtener más información, consulte AgeStore.