Opzioni della riga di comando symchk

  • Articolo

SymChk usa la sintassi seguente:

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

Parametri

/r
Se Files specifica una directory, l'opzione /r fa sì che SymChk cerchi in modo ricorsivo tutte le sottodirectory in questa directory per i file di programma.

/v
Visualizza informazioni dettagliate. Questo include il nome file di ogni file di programma i cui simboli sono stati esaminati e se è stato passato, non riuscito o è stato ignorato.

/q
Abilita la modalità non interattiva. Tutto l'output verrà eliminato (a meno che non sia inclusa l'opzione /ot ).

Nomi
Specifica i file di programma i cui simboli devono essere controllati. Sono consentiti percorsi assoluti, percorsi relativi e percorsi UNC. È consentito un carattere jolly asterisco (*). Se *FileNames termina con una barra, viene visualizzato come nome di directory e vengono controllati tutti i file all'interno di tale directory. Se FileNames contiene spazi, deve essere racchiuso tra virgolette.

/Ie ExeFile
Specifica il nome di un programma attualmente in esecuzione. Verranno controllati i simboli per questo programma. ExeFile deve includere il nome del file e dell'estensione di file (in genere .exe), ma nessuna informazione sul percorso. Se sono presenti due file eseguibili diversi con lo stesso nome, questa opzione non è consigliata. ExeFile può specificare qualsiasi programma, incluso un driver in modalità kernel. Se ExeFile è un singolo asterisco (*), SymChk verificherà i simboli per tutti i processi in esecuzione, inclusi i driver.

/Id DumpFile
Specifica un file di dump della memoria. Verranno controllati i simboli per questo file di dump.

/ih HotFixFile
Specifica un file CAB hotfix autoestrante.

/Ip ProcessID
Specifica l'ID processo di un programma attualmente in esecuzione. Verranno controllati i simboli per questo programma. ProcessID deve essere specificato come numero decimale. Sono supportati due caratteri jolly speciali:

  • Se ProcessID è zero ( 0 ), SymChk verificherà i simboli per tutti i driver in esecuzione.

  • Se ProcessID è un singolo asterisco (*), SymChk verificherà i simboli per tutti i processi in esecuzione, inclusi i driver.

/esso TextFileList
Specifica un file di testo che contiene un elenco di file di programma. Verranno controllati i simboli per tutti questi programmi. TextFileList deve specificare esattamente un file (per percorso relativo, assoluto o UNC, ma senza caratteri jolly). Se contiene spazi, deve essere racchiuso tra virgolette. All'interno di questo file, ogni riga indica un file di programma (per percorsi relativi, assoluti o UNC) ed è consentito un carattere jolly asterisco (*). Tuttavia, qualsiasi riga che utilizza questo carattere jolly deve usare un percorso relativo.

Se una riga in questo file contiene spazi, deve essere racchiusa tra virgolette. Un punto e virgola all'interno di questo file è un carattere di commento. Tutti gli elementi tra un punto e virgola e la fine della riga verranno ignorati.

/Im ManifestList
Specifica che l'input per il comando è un file manifesto creato in precedenza usando il parametro /om . Il file manifesto contiene informazioni sui file per i quali vengono recuperati i simboli. Per altre informazioni sull'uso di un file manifesto, vedere Uso di un file manifesto con SymChk.

/Om Manifesto
Specifica che viene creato un file manifesto. Il file manifesto contiene informazioni su un set di file per i quali verranno recuperati i simboli, usando il parametro /im , in un secondo momento.

/s[Opts] SymbolPath
Specifica le directory contenenti i simboli. Sono consentiti percorsi assoluti, percorsi relativi e percorsi UNC. È possibile specificare un numero qualsiasi di directory. È necessario separare più directory con punti e virgola. Se SymbolPath contiene spazi, deve essere racchiuso tra virgolette. Se si desidera specificare un server di simboli all'interno di questo percorso, è consigliabile usare una delle sintassi seguenti:

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

Non è consigliabile omettere il parametro /s[Opts] SymbolPath , ma se viene omesso, SymChk punterà all'archivio simboli pubblico usando il percorso predefinito seguente:

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

Qualsiasi numero di opzioni seguenti può seguire /s. Non può esistere spazio tra / s e le opzioni seguenti:

e
SymChk verificherà singolarmente ogni percorso invece di controllare tutti i percorsi contemporaneamente.

u
Gli archivi downstream verranno aggiornati. Se il percorso del simbolo include un archivio downstream, l'archivio simboli verrà cercato per i file di simboli. Verranno aggiornati solo gli archivi di simboli controllati da SymChk.

p
Forzare il controllo dei simboli privati. I simboli pubblici verranno considerati come non corrispondenti. L'opzione p implica e e u e non può essere usata con s.

s
Forzare il controllo dei simboli pubblici (divisi). I simboli privati verranno considerati come non corrispondenti. L'opzione s implica e e u e non può essere usata con p.

r
Espandere tutti gli elementi del server non simbolo nel percorso specificato per eseguire una ricerca approfondita del percorso. NOTA: questa opzione può produrre corrispondenze che non si verificheranno all'interno del debugger perché modifica il percorso del simbolo specificato.

Opzioni Le opzioni disponibili sono suddivise in diverse classi. Ogni classe di opzioni controlla un set diverso di funzionalità.

Opzioni di output. È possibile specificare un numero qualsiasi di opzioni seguenti. Queste opzioni possono essere abbreviate usando /o una sola volta, ad esempio /oi /oe può essere scritto come /oie.

Opzione Effetto

/Œ

L'output includerà singoli errori. Questa opzione è utile solo se viene usato /q , perché i singoli errori vengono visualizzati automaticamente se la modalità non interattiva non è stata attivata.

/op

L'output elenca ogni file passato. Per impostazione predefinita, SymChk visualizza solo i file che non superano il test.

/oi

L'output elenca ogni file ignorato. Per impostazione predefinita, SymChk visualizza solo i file che non superano il test.

/od

L'output includerà i dettagli completi. Uguale a /oe /op /oi.

/Ot

L'output includerà i totali dei risultati. Questa opzione è utile solo se si usa /q , perché questi totali vengono visualizzati automaticamente se la modalità non interattiva non è stata attivata.

/Ob

Il percorso completo per i file binari verrà incluso in tutti i messaggi di output.

/sistema operativo

Il percorso completo dei simboli verrà incluso in tutti i messaggi di output.

/oc Dir

SymChk creerà un albero dei simboli tradizionale nella directory Dir che contiene un elenco di tutti i file di simboli controllati.

/Ov

SymChk visualizzerà anche le informazioni sulla versione per i file binari controllati.

/ol File

Oltre ai messaggi inviati a standard out, scrivere un file contenente un elenco delimitato da virgole di tutti i file binari e i relativi simboli che passano il controllo dei simboli.

Opzioni del file DBG. Queste opzioni controllano il modo in cui SymChk controlla i file di simboli con estensione dbg . È possibile specificare solo una delle opzioni seguenti.

Opzione Effetto

/Ds

SymChk verificherà che le informazioni dbg siano state rimosse dal file eseguibile e vengano visualizzate solo nel file dbg e che il file eseguibile punti al file dbg. Se il programma è stato compilato senza file di simboli con estensione dbg, questa opzione non ha alcun effetto. Si tratta dell'impostazione predefinita.

/de

SymChk verificherà che le informazioni dbg non siano state rimosse dal file eseguibile e che l'eseguibile non punti a un file con estensione dbg. Se il programma è stato compilato senza file di simboli con estensione dbg, questa opzione non ha alcun effetto.

/Dn

SymChk verificherà che le informazioni dbg non siano presenti nell'immagine e che l'immagine non punti a un file con estensione dbg.

Opzioni del file PDB. Queste opzioni controllano il modo in cui SymChk controlla i file di simboli con estensione pdb. È possibile specificare solo una delle opzioni seguenti.

Opzione Effetto

/Pf

SymChk non esegue alcun controllo sul contenuto del file con estensione pdb. Verifica semplicemente che i file esistano e corrispondano al file binario. Si tratta dell'impostazione predefinita.

/Ps

SymChk verificherà che i file con estensione pdb siano stati rimossi dalla riga di origine, dal tipo di dati e dalle informazioni globali.

/Pt

SymChk verificherà che i file con estensione pdb contengano informazioni sul tipo di dati.

Opzioni di filtro. Queste opzioni controllano la modalità di esecuzione del filtro dei moduli quando SymChk controlla i processi o i file di dump. È possibile specificare solo una delle opzioni seguenti.

Opzione Effetto

/fm Module

SymChk verificherà solo i file o i processi di dump associati al modulo specificato. Il modulo deve includere il nome file completo, ma non deve includere alcuna parte del percorso della directory.

Opzioni di controllo dei simboli. È possibile specificare un numero qualsiasi di opzioni seguenti.

Opzione Effetto

/Cs

SymChk non verificherà che i dati codeView siano presenti. Per impostazione predefinita, la presenza di dati CodeView viene verificata.

/Cc

Quando SymChk controlla un file CAB hotfix, non cercherà i simboli all'interno del cab. Per impostazione predefinita, SymChk cercherà i simboli nel taxi e nel percorso del simbolo specificato.

/ea File

SymChk non verificherà i simboli per i programmi elencati nel file specificato. In questo modo è possibile veto determinati programmi che altrimenti verrebbero verificati. Il file deve specificare esattamente un file (per percorso relativo, assoluto o UNC, ma senza caratteri jolly). Se contiene spazi, deve essere racchiuso tra virgolette. All'interno di File ogni riga indica un file di programma (per percorsi RELATIVI, assoluti o UNC); non sono consentiti caratteri jolly. Se una riga in questo file contiene spazi, deve essere racchiusa tra virgolette. Un punto e virgola all'interno di questo file è un carattere di commento. Tutti gli elementi tra un punto e virgola e la fine della riga verranno ignorati. Se viene usato un server di simboli, i simboli per questi programmi non verranno copiati nell'archivio downstream.

File /ee

I messaggi di errore per tali programmi elencati nel file specificato vengono eliminati. I messaggi "Success" e "ignore" verranno visualizzati come di consueto e i file di simboli verranno copiati nell'archivio downstream come di consueto. Il formato di File e il formato del relativo contenuto sono uguali a quello per /ea File.

Informazioni aggiuntive

Per altre informazioni su SymChk, vedere Uso di SymChk.