Partager via

Options de ligne de commande SymChk

  • Article

SymChk utilise la syntaxe suivante :

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

Paramètres

/r
Si Files spécifie un répertoire, l’option /r fait en sorte que SymChk recherche de manière récursive toutes les sous-répertoires sous ce répertoire pour les fichiers programme.

/v
Affiche les informations détaillées. Cela inclut le nom de fichier de chaque fichier programme dont les symboles ont été examinés et s’il a réussi, échoué ou a été ignoré.

/q
Active le mode silencieux. Toutes les sorties sont supprimées (sauf si l’option /ot est incluse).

Noms
Spécifie les fichiers programme dont les symboles doivent être vérifiés. Les chemins absolus, les chemins relatifs et les chemins UNC sont autorisés. Un caractère générique astérisque (*) est autorisé. Si *FileNames se termine par une barre oblique, il est considéré comme un nom de répertoire et tous les fichiers de ce répertoire sont vérifiés. Si FileNames contient des espaces, il doit être placé entre guillemets .

/Ie ExeFile
Spécifie le nom d’un programme en cours d’exécution. Les symboles de ce programme seront vérifiés. ExeFile doit inclure le nom du fichier et de l’extension de fichier (généralement .exe), mais aucune information de chemin d’accès. S’il existe deux exécutables différents portant le même nom, cette option n’est pas recommandée. ExeFile peut spécifier n’importe quel programme, y compris un pilote en mode noyau. Si ExeFile est un astérisque unique (*), SymChk vérifie les symboles de tous les processus en cours d’exécution, y compris les pilotes.

/id DumpFile
Spécifie un fichier de vidage de mémoire. Les symboles de ce fichier de vidage seront vérifiés.

/ih HotFixFile
Spécifie un fichier CAB de correctif logiciel auto-extrait.

/Ip ProcessID
Spécifie l’ID de processus d’un programme en cours d’exécution. Les symboles de ce programme seront vérifiés. ProcessID doit être spécifié en tant que nombre décimal. Il existe deux caractères génériques spéciaux pris en charge :

  • Si ProcessID est égal à zéro ( 0 ), SymChk vérifie les symboles de tous les pilotes en cours d’exécution.

  • Si ProcessID est un astérisque unique (*), SymChk vérifie les symboles de tous les processus en cours d’exécution, y compris les pilotes.

/il TextFileList
Spécifie un fichier texte qui contient une liste de fichiers programme. Les symboles de tous ces programmes seront vérifiés. TextFileList doit spécifier exactement un fichier (par chemin relatif, absolu ou UNC, mais sans caractères génériques) ; s’il contient des espaces, il doit être placé entre guillemets. Dans ce fichier, chaque ligne indique un fichier de programme (par chemins relatifs, absolus ou UNC) et un caractère générique astérisque (*) est autorisé. Toutefois, toute ligne utilisant ce caractère générique doit utiliser un chemin relatif.

Si une ligne de ce fichier contient des espaces, elle doit être placée entre guillemets. Un point-virgule dans ce fichier est un caractère de commentaire : tout entre un point-virgule et la fin de la ligne sera ignoré.

/Im ManifestList
Spécifie que l’entrée de la commande est un fichier manifeste créé précédemment à l’aide du paramètre /om . Le fichier manifeste contient des informations sur les fichiers pour lesquels les symboles sont récupérés. Pour plus d’informations sur l’utilisation d’un fichier manifeste, consultez Utilisation d’un fichier manifeste avec SymChk.

/Om Manifeste
Spécifie qu’un fichier manifeste est créé. Le fichier manifeste contient des informations sur un ensemble de fichiers pour lesquels les symboles seront récupérés, à l’aide du paramètre /im , ultérieurement.

/s[Opts] SymbolPath
Spécifie les répertoires contenant des symboles. Les chemins absolus, les chemins relatifs et les chemins UNC sont autorisés. Un nombre quelconque de répertoires peut être spécifié : plusieurs répertoires doivent être séparés par des points-virgules. Si SymbolPath contient des espaces, il doit être placé entre guillemets. Si vous souhaitez spécifier un serveur de symboles dans ce chemin d’accès, vous devez utiliser l’une des syntaxes suivantes :

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

Il n’est pas recommandé d’omettre le paramètre /s[Opts] SymbolPath, mais s’il est omis, SymChk pointe vers le magasin de symboles public à l’aide du chemin d’accès par défaut suivant :

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

N’importe quel nombre des options suivantes peuvent suivre /s. Il ne peut y avoir d’espace entre / s et ces options :

e
SymChk vérifie chaque chemin individuellement au lieu de vérifier tous les chemins à la fois.

u
Les magasins en aval seront mis à jour. Si le chemin d’accès aux symboles inclut un magasin en aval, le magasin de symboles est recherché pour les fichiers de symboles. Seuls les magasins de symboles vérifiés par SymChk sont mis à jour.

p
Forcer la vérification des symboles privés. Les symboles publics seront traités comme ne correspondant pas. L’option p implique e et u, et ne peut pas être utilisée avec s.

s
Forcer la vérification des symboles publics (fractionnés). Les symboles privés seront traités comme ne correspondant pas. L’option s implique e et u, et ne peut pas être utilisée avec p.

r
Développez tous les éléments serveur non-symboles dans le chemin spécifié afin d’effectuer une recherche approfondie du chemin d’accès. REMARQUE : cette option peut produire des correspondances qui ne se produisent pas à l’intérieur du débogueur, car elle modifie le chemin d’accès au symbole spécifié.

Les options disponibles sont divisées en plusieurs classes. Chaque classe d’options contrôle un ensemble différent de fonctionnalités.

Options de sortie. Vous pouvez spécifier n’importe quel nombre des options suivantes. Ces options peuvent être abrégées en utilisant /o une seule fois : par exemple, /oi /oe peut être écrit en tant que /oie.

Option Résultat

/Œ

La sortie inclut des erreurs individuelles. Cette option est utile uniquement si /q est utilisé, car les erreurs individuelles sont automatiquement affichées si le mode silencieux n’a pas été activé.

/op

La sortie répertorie chaque fichier qui passe. (Par défaut, SymChk affiche uniquement les fichiers qui échouent à tester.)

/oi

La sortie répertorie chaque fichier qui a été ignoré. (Par défaut, SymChk affiche uniquement les fichiers qui échouent à tester.)

/Od

La sortie inclut des détails complets. Identique à /oe /op /oi.

/Ot

La sortie inclut les totaux des résultats. Cette option est utile uniquement si /q est utilisé, car ces totaux sont automatiquement affichés si le mode silencieux n’a pas été activé.

/Ob

Le chemin complet des fichiers binaires sera inclus dans tous les messages de sortie.

/Os

Le chemin complet des symboles sera inclus dans tous les messages de sortie.

/oc Dir

SymChk crée une arborescence de symboles traditionnelle dans le répertoire Dir qui contient une liste de tous les fichiers de symboles vérifiés.

/Ov

SymChk imprime également les informations de version pour les fichiers binaires vérifiés.

Fichier /ol

En plus des messages envoyés à la norme, écrivez un fichier qui contient une liste séparée par des virgules de tous les fichiers binaires et leurs symboles qui passent la vérification des symboles.

Options de fichier DBG. Ces options contrôlent la façon dont SymChk vérifie les fichiers de symboles .dbg . Une seule des options suivantes peut être spécifiée.

Option Résultat

/Ds

SymChk vérifie que les informations .dbg ont été supprimées de l’exécutable et apparaissent uniquement dans le fichier .dbg, et que l’exécutable pointe vers le fichier .dbg. Si le programme a été généré sans fichiers de symboles .dbg, cette option n’a aucun effet. Il s’agit de la valeur par défaut.

/de

SymChk vérifie que les informations .dbg n’ont pas été supprimées de l’exécutable et que l’exécutable ne pointe pas vers un fichier .dbg. Si le programme a été généré sans fichiers de symboles .dbg, cette option n’a aucun effet.

/Dn

SymChk vérifie que les informations .dbg ne sont pas présentes dans l’image et que l’image ne pointe pas vers un fichier .dbg.

Options de fichier PDB. Ces options contrôlent la façon dont SymChk vérifie les fichiers de symboles .pdb. Une seule des options suivantes peut être spécifiée.

Option Résultat

/Pf

SymChk n’effectue aucune vérification sur le contenu du fichier .pdb. Il vérifie simplement que les fichiers existent et correspondent au fichier binaire. Il s’agit de la valeur par défaut.

/Ps

SymChk vérifie que les fichiers .pdb ont été supprimés de la ligne source, du type de données et des informations globales.

/Pt

SymChk vérifie que les fichiers .pdb contiennent des informations de type de données.

Options de filtrage. Ces options contrôlent la façon dont le filtrage des modules est effectué lorsque SymChk vérifie les processus ou les fichiers de vidage. Une seule des options suivantes peut être spécifiée.

Option Résultat

/fm Module

SymChk vérifie uniquement les fichiers de vidage ou les processus associés au module spécifié. Le module doit inclure le nom de fichier complet, mais ne doit pas inclure une partie du chemin d’accès au répertoire.

Options de vérification des symboles. Vous pouvez spécifier n’importe quel nombre des options suivantes.

Option Résultat

/Cs

SymChk ne vérifie pas que les données CodeView sont présentes. (Par défaut, la présence de données CodeView est vérifiée.)

/cc

Lorsque SymChk vérifie un fichier CAB de correctif logiciel, il ne recherche pas de symboles à l’intérieur de la cabine. (Par défaut, SymChk recherche les symboles dans la cabine, ainsi que dans le chemin de symbole fourni.)

Fichier /ea

SymChk ne vérifie pas les symboles des programmes répertoriés dans le fichier spécifié. Cela vous permet de veto sur certains programmes qui seraient autrement vérifiés. Le fichier doit spécifier exactement un fichier (par chemin relatif, absolu ou UNC, mais sans caractères génériques) ; s’il contient des espaces, il doit être placé entre guillemets. Dans le fichier, chaque ligne indique un fichier de programme (par chemins relatifs, absolus ou UNC) ; aucun caractère générique n’est autorisé. Si une ligne de ce fichier contient des espaces, elle doit être placée entre guillemets. Un point-virgule dans ce fichier est un caractère de commentaire : tout entre un point-virgule et la fin de la ligne sera ignoré. Si un serveur de symboles est utilisé, les symboles de ces programmes ne seront pas copiés dans le magasin en aval.

Fichier /ee

Les messages d’erreur pour ces programmes répertoriés dans le fichier spécifié sont supprimés. Les messages « Réussite » et « ignorer » s’affichent comme d’habitude, et les fichiers de symboles sont copiés dans le magasin en aval comme d’habitude. Le format de fichier et le format de son contenu sont identiques à ceux de /ea File.

Informations supplémentaires

Pour plus d’informations sur SymChk, consultez Utilisation de SymChk.