SymChk のコマンドライン オプション

  • [アーティクル]

SymChk は、次の構文を使用します。

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

パラメーター

/r
Files で ディレクトリが指定されている場合 、/r オプションを指定すると、 SymChk はこのディレクトリの下にあるすべてのサブディレクトリでプログラム ファイルを再帰的に検索します。

/v
詳細な情報を表示します. これには、シンボルが調査されたすべてのプログラム ファイルのファイル名と、渡された、失敗した、または無視されたかどうかが含まれます。

/q
静音モードを有効にします。 すべての出力は抑制されます (/ot オプションが 含まれていない場合)。

ファイル名
シンボルをチェックするプログラム ファイルを指定します。 絶対パス、相対パス、UNC パスを使用できます。 アスタリスク (*) ワイルドカードを使用できます。 *FileNames がスラッシュで終わると、ディレクトリ名になり、そのディレクトリ内のすべてのファイルがチェックされます。 ファイル名 にスペースが含まれる場合は、引用符で囲む必要があります。

/ieExeFile
現在実行中のプログラムの名前を指定します。 このプログラムのシンボルがチェックされます。 ExeFile には、ファイルとファイル拡張子の名前 (通常は.exe) を含める必要がありますが、パス情報は含めてはなりません。 同じ名前の 2 つの異なる実行可能ファイルがある場合、このオプションは推奨されません。 ExeFile は、カーネル モード ドライバーを含む任意のプログラムを指定できます。 ExeFile が 1 つのアスタリスク ( ) の場合*、SymChk は、ドライバーを含むすべての実行中のプロセスのシンボルをチェックします。

/idDumpFile
メモリ ダンプ ファイルを指定します。 このダンプ ファイルのシンボルがチェックされます。

/ihHotFixFile
自己展開修正プログラム CAB ファイルを指定します。

/ipProcessID
現在実行中のプログラムのプロセス ID を指定します。 このプログラムのシンボルがチェックされます。 ProcessID は、10 進数として指定する必要があります。 2 つの特殊なワイルドカードがサポートされています。

  • ProcessID が 0 ( 0 ) の場合 、SymChk は実行中のすべてのドライバーのシンボルをチェックします。

  • ProcessID が 1 つのアスタリスク ( ) の場合*、SymChk は、ドライバーを含むすべての実行中のプロセスのシンボルをチェックします。

/itTextFileList
プログラム ファイルのリストを含むテキスト ファイルを指定します。 これらすべてのプログラムのシンボルがチェックされます。 TextFileList は、ファイルを 1 つだけ指定する必要があります (相対パス、絶対パス、UNC パスで指定しますが、ワイルドカードは指定できません)。スペースが含まれている場合は、引用符で囲む必要があります。 このファイル内では、各行はプログラム ファイル (相対パス、絶対パス、UNC パス) を示し、アスタリスクワイルドカード (*) を使用できます。 ただし、このワイルドを使用する行カードは相対パスを使用する必要があります。

このファイル内の行にスペースが含まれている場合は、引用符で囲む必要があります。 このファイル内のセミコロンはコメント文字です。セミコロンと行末の間のすべてが無視されます。

/imManifestList
コマンドへの入力が、/om パラメーターを使用して 以前に作成されたマニフェスト ファイルであることを指定します。 マニフェスト ファイルには、シンボルが取得されるファイルに関する情報が含まれています。 マニフェスト ファイルの使用の詳細については、「SymChk でのマニフェスト ファイルの使用」を参照してください。

/omマニフェスト
マニフェスト ファイルを作成することを指定します。 マニフェスト ファイルには、後で /im パラメーターを使用してシンボルを取得する一連の ファイルに関する情報が含まれています。

/s[Opts] SymbolPath
シンボルを含むディレクトリを指定します。 絶対パス、相対パス、UNC パスを使用できます。 任意の数のディレクトリを指定できます。複数のディレクトリはセミコロンで区切る必要があります。 SymbolPath にスペースが含まれる場合は、引用符で囲む必要があります。 このパス内でシンボル サーバーを指定する場合は、次のいずれかの構文を使用する必要があります。

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

/s [Opts]SymbolPath パラメーターを 省略することはお勧めしませんが、省略すると、SymChk は次の既定のパスを使用してパブリック シンボル ストアを指します。

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

/s の後には、次のオプションの任意の 数を指定できます。 /s と次のオプションの間に スペースを入れすることはできません。

e
SymChk は、すべてのパスを一度にチェックするのではなく、各パスを個別にチェックします。

u
ダウンストリーム ストアが更新されます。 シンボル パスにダウンストリーム ストアが含まれている場合、シンボル ストアはシンボル ファイルを検索します。 SymChk によってチェックされているシンボル ストアのみが更新されます。

P
プライベート シンボルのチェックを強制します。 パブリック シンボルは一致しないものとして扱われます。 p オプションは e と u を意味し、s では使用できません。

s
パブリック (分割) シンボルのチェックを強制します。 プライベート シンボルは一致しないものとして扱われます。 s オプションは e と u を意味し、p では使用できません。

r
パスの詳細な検索を行うには、指定したパス内のすべての非シンボル サーバー要素を展開します。 注: このオプションは、指定されたシンボル パスを変更するため、デバッガー内では発生しない一致を生成する場合があります。

オプション 使用可能なオプションは、複数のクラスに分かれています。 オプションの各クラスは、異なる機能のセットを制御します。

出力オプション。 以下ののオプションをいくつでも指定できます。 これらのオプションは、/o を 1 回だけ使用 して省略できます。たとえば、 /oi /oe は /oie として記述できます。

オプション 効果

/oe

出力には個々のエラーが含まれます。 このオプションは、/q が使用されている場合 にのみ役立ちます。静音モードがアクティブ化されていない場合は、個々のエラーが自動的に表示されるためです。

/op

出力には、渡される各ファイルが一覧表示されます。 (既定では、SymChk にはテストに失敗したファイルのみが表示されます)。

/oi

出力には、無視された各ファイルが一覧表示されます。 (既定では、SymChk にはテストに失敗したファイルのみが表示されます)。

/od

出力には完全な詳細が含まれます。 /oe /op /oi と同じです。

/ot

出力には結果の合計が含まれます。 このオプションは、/q が使用されている場合 にのみ役立ちます。静音モードがアクティブ化されていない場合は、その合計が自動的に表示されるためです。

/ob

バイナリの完全なパスは、すべての出力メッセージに含まれます。

/os

シンボルの完全なパスは、すべての出力メッセージに含まれます。

/ocDir

SymChk は、ディレクトリ Dir に従来のシンボル ツリーを作成します。このツリー には、チェックされたすべてのシンボル ファイルの一覧が含まれます。

/ov

SymChk は、チェックバイナリのバージョン情報も出力します。

/ol ファイル

標準出力に送信されるメッセージに加えて、シンボルのチェックを渡すすべてのバイナリとそのシンボルのコンマ区切りリストを含むファイルを記述します。

DBG ファイルのオプション これらのオプションは、SymChk が .dbg シンボル ファイルをチェック する方法を制御します。 次のいずれかのオプションのみを指定できます。

オプション 効果

/ds

SymChk は、.dbg 情報が実行可能ファイルから削除され、.dbg ファイルにのみ表示され、実行可能ファイルが .dbg ファイルを指していることを確認します。 プログラムが .dbg シンボル ファイルなしでビルドされた場合、このオプションは無効です。 これが既定です。

/de

SymChk は、.dbg 情報が実行可能ファイルから削除されていないこと、および実行可能ファイルが .dbg ファイルを指していないことを確認します。 プログラムが .dbg シンボル ファイルなしでビルドされた場合、このオプションは無効です。

/dn

SymChk は、.dbg 情報がイメージに存在せず、イメージが .dbg ファイルを指していないことを確認します。

PDB ファイルのオプション これらのオプションは、SymChk が .pdb シンボル ファイルをチェック する方法を制御します。 次のいずれかのオプションのみを指定できます。

オプション 効果

/pf

SymChk は、.pdb ファイルの内容に対してチェックを実行しません。ファイルが存在し、バイナリと一致することを確認するだけです。 これが既定です。

/ps

SymChk は、.pdb ファイルがソース行、データ型、およびグローバル情報から削除されたことを確認します。

/pt

SymChk は、.pdb ファイルにデータ型情報が含まれていることを確認します。

フィルター処理オプション。 これらのオプションは、SymChk がプロセスまたはダンプ ファイルをチェックする場合のモジュール フィルター処理の実行方法を制御します。 次のいずれかのオプションのみを指定できます。

オプション 効果

/fmモジュール

SymChk は、指定したモジュールに関連付けられているダンプ ファイルまたはプロセスのみをチェックします。 モジュール には完全なファイル名を含める必要がありますが、ディレクトリ パスの一部を含めることはできません。

シンボル チェック オプション。 以下ののオプションをいくつでも指定できます。

オプション 効果

/cs

SymChk は CodeView データが存在することを確認しません。 (既定では、CodeView データの存在が確認されます)。

SET/cc

SymChk が修正プログラム CAB ファイルをチェックしている場合、cab 内のシンボルは検索されません。 (既定では、SymChk は、提供されたシンボル パスと同様に、cab 内のシンボルを検索します)。

/eaファイル

SymChk は、指定されたファイルに一覧表示されているプログラムのシンボルを確認しません。 これにより、検証される特定のプログラムを拒否できます。 ファイル は、ファイルを 1 つだけ指定する必要があります (相対パス、絶対パス、UNC パスで指定しますが、ワイルドカードは指定できません)。スペースが含まれている場合は、引用符で囲む必要があります。 File 内では、各行はプログラム ファイル (相対パス、絶対パス、または UNC パス) を示します。ワイルドカードは許可されません。 このファイル内の行にスペースが含まれている場合は、引用符で囲む必要があります。 このファイル内のセミコロンはコメント文字です。セミコロンと行末の間のすべてが無視されます。 シンボル サーバーが使用されている場合、これらのプログラムのシンボルはダウンストリーム ストアにコピーされません。

/eeファイル

指定されたファイルにリストされているプログラムのエラー メッセージは表示されません。 "成功" メッセージと "無視" メッセージは通常どおりに表示され、シンボル ファイルは通常どおりダウンストリーム ストアにコピーされます。 File の形式とその内容の形式は、/eaFileの場合と同じです。

追加情報

ジョブの詳細については、「 SymChk」 (SymChkの使用) を参照してください。