Opções de linha de comando do SymChk

O SymChk usa a seguinte sintaxe:

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
Se Files especificar um diretório, a opção /r fará com que o SymChk pesquise recursivamente todos os subdiretórios nesse diretório em busca de arquivos de programa.

/v
Exibe informações detalhadas. Isso inclui o nome do arquivo de cada arquivo de programa cujos símbolos foram investigados e se ele foi aprovado, reprovado ou ignorado.

/q
Ativa o modo silencioso. Todas as saídas serão suprimidas (a menos que a opção /ot esteja incluída).

Nomes
Especifica os arquivos de programa cujos símbolos devem ser verificados. Caminhos absolutos, caminhos relativos e caminhos UNC são permitidos. Um curinga asterisco (*) é permitido. Se *FileNames terminar em uma barra, ele será considerado um nome de diretório e todos os arquivos dentro desse diretório serão verificados. Se FileNames contiver espaços, ele deverá ser colocado entre aspas.

/Ie Arquivo ExeFile
Especifica o nome de um programa que está sendo executado no momento. Os símbolos para este programa serão verificados. ExeFile deve incluir o nome do arquivo e a extensão do arquivo (geralmente .exe), mas nenhuma informação de caminho. Se houver dois executáveis diferentes com o mesmo nome, essa opção não será recomendada. ExeFile pode especificar qualquer programa, incluindo um driver de modo kernel. Se ExeFile for um único asterisco (*), o SymChk verificará os símbolos de todos os processos em execução, incluindo drivers.

/id Dumpfile
Especifica um arquivo de despejo de memória. Os símbolos para este arquivo de despejo serão verificados.

/ih Arquivo de HotFix
Especifica um arquivo CAB de hotfix de extração automática.

/IP ID do processo
Especifica a ID do processo de um programa que está sendo executado no momento. Os símbolos para este programa serão verificados. ProcessID deve ser especificado como um número decimal. Há dois curingas especiais com suporte:

• Se ProcessID for zero ( 0 ), o SymChk verificará os símbolos de todos os drivers em execução.

• Se ProcessID for um único asterisco (*), o SymChk verificará os símbolos de todos os processos em execução, incluindo drivers.

/ela Lista de arquivos de texto
Especifica um arquivo de texto que contém uma lista de arquivos de programa. Os símbolos de todos esses programas serão verificados. TextFileList deve especificar exatamente um arquivo (por caminho relativo, absoluto ou UNC, mas sem curingas); se ele contiver espaços, deverá ser colocado entre aspas. Dentro desse arquivo, cada linha indica um arquivo de programa (por caminhos relativos, absolutos ou UNC) e um curinga asterisco (*) é permitido. No entanto, qualquer linha que use esse curinga deve usar um caminho relativo.

Se uma linha neste arquivo contiver espaços, ela deverá ser colocada entre aspas. Um ponto e vírgula dentro deste arquivo é um caractere de comentário - tudo entre um ponto e vírgula e o final da linha será ignorado.

/Im Lista de Manifestos
Especifica que a entrada para o comando é um arquivo de manifesto criado anteriormente usando o parâmetro /om . O arquivo de manifesto contém informações sobre os arquivos para os quais os símbolos são recuperados. Para obter mais informações sobre como usar um arquivo de manifesto, consulte Usando um arquivo de manifesto com SymChk.

/Om Manifesto
Especifica que um arquivo de manifesto é criado. O arquivo de manifesto contém informações sobre um conjunto de arquivos para os quais os símbolos serão recuperados, usando o parâmetro /im , posteriormente.

/s[Opta] SymbolPath
Especifica os diretórios que contêm símbolos. Caminhos absolutos, caminhos relativos e caminhos UNC são permitidos. Qualquer número de diretórios pode ser especificado - vários diretórios devem ser separados por ponto e vírgula. Se SymbolPath contiver espaços, ele deverá ser colocado entre aspas. Se você deseja especificar um servidor de símbolos dentro desse caminho, use uma das seguintes sintaxes:

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

Não é recomendável omitir o parâmetro /s[Opts] SymbolPath , mas se ele for omitido, SymChk apontará para o repositório de símbolos público usando o seguinte caminho padrão:

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

Qualquer número das opções a seguir pode seguir /s. Não pode haver espaço entre o /s e estas opções:

e
O SymChk verificará cada caminho individualmente em vez de verificar todos os caminhos de uma vez.

u
As lojas downstream serão atualizadas. Se o caminho do símbolo incluir um repositório downstream, o repositório de símbolos será pesquisado para os arquivos de símbolo. Somente os repositórios de símbolos que estão sendo verificados pelo SymChk serão atualizados.

p
Forçar a verificação de símbolos privados. Os símbolos públicos serão tratados como não correspondentes. A opção p implica e e u, e não pode ser usada com s.

s
Forçar a verificação de símbolos públicos (divididos). Os símbolos privados serão tratados como não correspondentes. A opção s implica e e u, e não pode ser usada com p.

r
Expanda todos os elementos de servidor que não são de símbolo no caminho especificado para fazer uma pesquisa profunda no caminho. OBSERVAÇÃO: essa opção pode produzir correspondências que não ocorrerão dentro do depurador, pois modifica o caminho do símbolo especificado.

Opções As opções disponíveis são divididas em várias classes. Cada classe de opções controla um conjunto diferente de recursos.

Opções de saída. Qualquer número das opções a seguir pode ser especificado. Essas opções podem ser abreviadas usando /o apenas uma vez -- por exemplo, /oi /oe pode ser escrito como /oie.

Opção	Efeito
/Œ	A saída incluirá erros individuais. Essa opção só é útil se /q for usado, pois erros individuais são exibidos automaticamente se o modo silencioso não tiver sido ativado.
/op	A saída listará cada arquivo que passar. (Por padrão, o SymChk exibe apenas arquivos que falham no teste.)
/oi	A saída listará cada arquivo que foi ignorado. (Por padrão, o SymChk exibe apenas arquivos que falham no teste.)
/Od	A saída incluirá detalhes completos. O mesmo que /oe /op /oi.
/Ot	A saída incluirá os totais dos resultados. Essa opção só será útil se /q for usado, pois esses totais serão exibidos automaticamente se o modo silencioso não tiver sido ativado.
/Ob	O caminho completo para binários será incluído em todas as mensagens de saída.
/SO	O caminho completo para símbolos será incluído em todas as mensagens de saída.
/oc Dir	O SymChk criará uma árvore de símbolos tradicional no diretório Dir que contém uma lista de todos os arquivos de símbolos verificados.
/Ov	O SymChk também imprimirá informações de versão para binários verificados.
Arquivo /ol	Além das mensagens enviadas para o padrão, escreva um arquivo que contenha uma lista separada por vírgulas de todos os binários e seus símbolos que passam na verificação de símbolos.

Opções de arquivo DBG. Essas opções controlam como o SymChk verifica os arquivos de símbolo .dbg . Apenas uma das opções a seguir pode ser especificada.

Opção	Efeito
/Ds	O SymChk verificará se as informações .dbg foram removidas do executável e só aparecem no arquivo .dbg e se o executável aponta para o arquivo .dbg. Se o programa foi criado sem arquivos de símbolo .dbg, essa opção não terá efeito. Esse é o padrão.
/de	O SymChk verificará se as informações .dbg não foram removidas do executável e se o executável não aponta para um arquivo .dbg. Se o programa foi criado sem arquivos de símbolo .dbg, essa opção não terá efeito.
/Dn	O SymChk verificará se as informações .dbg não estão presentes na imagem e se a imagem não aponta para um arquivo .dbg.

Opções de arquivo PDB. Essas opções controlam como o SymChk verifica os arquivos de símbolo .pdb. Apenas uma das opções a seguir pode ser especificada.

Opção	Efeito
/Pf	O SymChk não executa nenhuma verificação no conteúdo do arquivo .pdb -- ele apenas verifica se os arquivos existem e correspondem ao binário. Esse é o padrão.
/Ps	O SymChk verificará se os arquivos .pdb foram despojados da linha de origem, do tipo de dados e das informações globais.
/pt	O SymChk verificará se os arquivos .pdb contêm informações de tipo de dados.

Opções de filtragem. Essas opções controlam como a filtragem de módulo é executada quando o SymChk está verificando processos ou arquivos de despejo. Apenas uma das opções a seguir pode ser especificada.

Opção	Efeito
Módulo /fm	O SymChk verificará apenas arquivos de despejo ou processos associados ao módulo especificado. O módulo deve incluir o nome completo do arquivo, mas não deve incluir nenhuma parte do caminho do diretório.

Opções de verificação de símbolos. Qualquer número das opções a seguir pode ser especificado.

Opção	Efeito
/Cs	O SymChk não verificará se os dados do CodeView estão presentes. (Por padrão, a presença de dados do CodeView é verificada.)
/Cc	Quando o SymChk estiver verificando um arquivo CAB de hotfix, ele não procurará símbolos dentro do cab. (Por padrão, o SymChk procurará símbolos no cab, bem como no caminho de símbolo fornecido.)
Arquivo /ea	O SymChk não verificará os símbolos dos programas listados no arquivo especificado. Isso permite que você vete certos programas que, de outra forma, seriam verificados. O arquivo deve especificar exatamente um arquivo (por caminho relativo, absoluto ou UNC, mas sem curingas); se contiver espaços, deverá ser colocado entre aspas. Em Arquivo, cada linha indica um arquivo de programa (por caminhos relativos, absolutos ou UNC); nenhum curinga é permitido. Se uma linha neste arquivo contiver espaços, ela deverá ser colocada entre aspas. Um ponto e vírgula dentro deste arquivo é um caractere de comentário - tudo entre um ponto e vírgula e o final da linha será ignorado. Se um servidor de símbolos estiver sendo usado, os símbolos desses programas não serão copiados para o repositório downstream.
Arquivo /ee	As mensagens de erro para os programas listados no arquivo especificado são suprimidas. As mensagens "Êxito" e "ignorar" serão exibidas como de costume e os arquivos de símbolo serão copiados para o repositório downstream como de costume. O formato do arquivo e o formato de seu conteúdo são os mesmos do arquivo /ea.

Informações Adicionais

Para obter mais informações sobre o SymChk, consulte Usando o SymChk.