BinPlace のコマンド ライン構文

  • [アーティクル]

BinPlace では、コマンド ラインで次の構文が使用されます。

    binplace [Options] File [ [Options] [@PlaceFile] File [...] ]

パラメーター

Options
これには、次のいずれかのスイッチを含めることができます。 スイッチの前にハイフン (-) またはスラッシュ (/) を付ける必要があります。 1 つのハイフンまたはスラッシュの後に複数のオプションを組み合わせることができますが、追加のパラメーターを受け取るオプションの後にスペースを付ける必要があります。 したがって、次の 2 つのコマンドは同等です。

binplace -q -k -g LCFile -v -s SymbolRoot File 
binplace -qkg LCFile -vs SymbolRoot File

次のスイッチも使用できます。

-a
BinPlace が配置されるときに、シンボル ファイルからプライベート シンボルを取り除きます。 これにより、パブリック シンボルを含むがプライベート シンボルを含まない、削除されたシンボル ファイルが作成されます。 -a スイッチを使用する場合は、-s と -x も使用する必要があります。 -aを使用すると、削除されたシンボル ファイルは、-sSymbolRoot で指定されたパスに配置されます。 -nFullSymbolRoot も存在する場合、完全なシンボル ファイルは FullSymbolRoot に配置されます。 それ以外の場合は、どこにも配置されません。

-b ExtraSubdirectory
BinPlace が通常とは異なる場所にファイルを配置します。 通常どおりルートの宛先ディレクトリ、クラス サブディレクトリ、およびファイルの種類のサブディレクトリを連結した後、BinPlace はこのパスに ExtraSubdirectory を追加して最終的な宛先ディレクトリを作成します。 ExtraSubdirectory は円記号で始まりも終わりでもありません。 詳細については、「 BinPlace 変換先ディレクトリ を参照してください。

-e
ファイルを配置できない場合、BinPlace が実行を続行します。 既定では、このエラーが発生すると BinPlace は終了します。

-f
新しいファイルを上書きする場合でも、BinPlace に強制的にファイルを配置します。 既定では、BinPlace がファイルを配置しようとすると、古いバージョンが上書きされますが、より新しいバージョンは上書きされません。

-g LCFile
BinPlace で実行可能ファイルが検証されます。 LCFile では、この検証に使用するローカライズ制約ファイルを指定します。

-h
ファイルを配置するときにファイルをコピーするのではなく、BinPlace でハード リンクを作成します。 このオプションは、NTFS ファイル システムでのみ使用できます。

-j
実行可能ファイルをコピーする前に、BinPlace で適切なシンボルが存在することを確認します。 このオプションを使用するには、SymChk ツールがパス内にある必要があります。 (SymChk は、Windows 用デバッグ ツール パッケージの一部です。詳細については、「Windows デバッグ」を参照してください。)

-k
BinPlace でファイル属性が保持されます。 既定では、BinPlace はアーカイブ属性をオフにします。

-n FullSymbolRoot
完全なシンボル ファイル (パブリック シンボルとプライベート シンボルの両方を含むシンボル ファイル) のルート ディレクトリを指定します。 これには、 -a、 -x、および -s スイッチも必要です。 詳細については、「 BinPlace 変換先ディレクトリ を参照してください。

-o RootSubdirectory
使用するルート宛先ディレクトリのサブディレクトリを指定します。 宛先ディレクトリが作成されると、ルートの宛先ディレクトリの後とクラスサブディレクトリの前に RootSubdirectory が挿入されます。 詳細については、「 BinPlace 変換先ディレクトリ を参照してください。

-p PlaceFile
場所ファイルのパスとファイル名を指定します。 -p スイッチが使用されていない場合、BinPlace は \tools\placefil.txt という名前の場所を使用します。 場所ファイルの内容の説明については、「 Place ファイル構文 」を参照してください。

注 -p スイッチファイルと配置ファイルは廃止され、使用しないでください。

-q
BinPlace がログ ファイルを使用できないようにします。 -q スイッチを省略すると、BINPLACE_LOG環境変数で指定されたファイルがログ ファイルとして使用されます。

-r RootDestinationPath
ルートの宛先ディレクトリを指定します。 省略した場合、既定値は、x86 ベース、Itanium ベース、または x64 ベースのコンピューターの_NT386TREE、_NTIA64TREE、または_NTAMD64TREE環境変数によって決定されます。 詳細については、「 BinPlace 変換先ディレクトリ を参照してください。

-s SymbolRoot
シンボル ファイルのルート ディレクトリを指定します。 -a および -x スイッチも使用すると、プライベート シンボルはシンボル ファイルから削除され、削除されたシンボル ファイルは SymbolRoot で指定されたディレクトリに配置されます。 削除されたシンボル ファイルと完全なシンボル ファイルの両方を配置する場合は、-a -x -s SymbolRoot -n FullSymbolRoot を使用する必要があります。 詳細については、「 BinPlace 変換先ディレクトリ を参照してください。

-t
テスト モード。 このスイッチを使用すると、ファイルはコピーされませんが、BinPlace では、ファイルを配置しているかのように警告とエラー メッセージが表示されます。 メッセージの数を増やすには、 -v スイッチを使用することもできます。

-u
BinPlace がクラス サブディレクトリに \up を追加します。 これは、ユニプロセッサ (UP) ドライバーを分離する場合に便利です。 さらに、このスイッチを使用するたびに、BinPlace はシンボルを含む実行可能ファイルを分割しません。 詳細については、「 BinPlace 変換先ディレクトリ を参照してください。

-v
詳細モード。 BinPlace により、より詳細なエラー、警告、および進行状況のメッセージが表示されます。

-w
BinPlace で Windows 95 シンボル ファイル (.sym) がシンボル ツリーに追加されます。

-x
old シンボル システムを使用するファイルが BinPlace で検出された場合このスイッチにより、実行可能ファイルからすべてのシンボルが削除され、この情報が個別のシンボル ファイルに移動されます。 詳細については、「 Symbol ファイル システム を参照してください。 -x スイッチを使用する場合は、-s と -a も使用する必要があります。

-y
BinPlace がクラス サブディレクトリを使用できないようにします。 宛先ディレクトリは、ルートの宛先ディレクトリとファイルの種類のサブディレクトリからのみ作成されます。 詳細については、「 BinPlace 変換先ディレクトリ を参照してください。

-z
-x スイッチを取り消します。 これは、複数のターゲットで BinPlace を使用している場合に便利です。つまり、フォーム binplace argumentsTarget1argumentsTarget2 のコマンドを使用できます。コマンド ラインは左から右に解析されるため、 Target1 と Target2 は異なる引数の影響を受けます。 (後の「解析順序」セクションを参照してください)。 -z スイッチが検出されると、以前の -x スイッチの効果が取り消されます。

-ci ReturnCode,Application,Argument,Argument, ...
BinPlace でカスタム アプリケーションを使用して、すべての実行可能ファイルを検証します。 BinPlace で他のアプリケーションを使用して検証を行う場合は、 -ci スイッチを使用できます。

ReturnCode は、実行可能ファイルでエラーが見つかると、このアプリケーションによって返される値である必要があります。 追加のパラメーターを使用して、このアプリケーションを起動します。 これらはすべてコンマで区切る必要があります。 アプリケーション プログラムの名前を指定します。 この後には、任意の数のコマンド ライン引数を指定できます。 プログラムは、コマンド ラインで開始され、 Application その後にすべての引数 (コンマではなくスペースで区切られます) が続き、最後にチェックする実行可能ファイルの名前で終わるようになります。

-：弧
BinPlace にアーカイブ属性が設定されているファイルのみを配置します。

-:D BG
BinPlace が .dbg ファイルを配置できないようにします。 -j スイッチも使用すると、BinPlace が .dbg ファイルを指すバイナリを配置できなくなります。 このオプションを使用するには、SymChk ツールがパス内にある必要があります。 (SymChk は、Windows 用デバッグ ツール パッケージの一部です。詳細については、「Windows デバッグ」を参照してください。)

-:D EST ClassPath
BinPlace が place ファイルを無視し、指定した ClassPath をクラス サブディレクトリとして使用します。 詳細については、「 BinPlace 変換先ディレクトリ を参照してください。

-:LOGPDB
BinPlace がログ ファイルに完全な .pdb パスを含めます。

-:REN NewName
BinPlace に配置されているファイルの名前を変更します。 拡張子を含む元のファイル名は、 NewNameに置き換えられます。 (元のファイルが分割されている実行可能ファイルの場合、新しいシンボル ファイルには元のファイル名と拡張子 .dbg が付けられます)。

-:TMF
PDB シンボル ファイルからトレース メッセージの書式設定命令を抽出して、binPlace にトレース メッセージ形式 (.tmf) ファイルを作成します。 TMF ファイルは、BinPlace TRACE_FORMAT_PATH環境変数で指定されたディレクトリに配置されます。 「 BinPlace マクロと環境変数を参照してください。

-ChangeAsmsToRetailForSymbols
シンボル ファイルのコピー先ディレクトリで発生した場合、BinPlace で文字列 "asms" が文字列 "retail" に置き換えられます。 詳細については、「 BinPlace 変換先ディレクトリ を参照してください。

File
BinPlace が動作するファイルの完全なパスとファイル名を指定します。 任意の数のファイルをスペースで区切って一覧表示できます。 パスとファイル名にスペースが含まれている場合は、パスとファイル名を引用符で囲む必要があります。

@PlaceFile
ファイル名の前にアット マーク ( @ ) が付いた場合、ファイル名は場所ファイルの名前を表します。 詳細については、次の「ファイル内のパラメーターの指定」セクションを参照してください。

解析順序

BinPlace は、コマンド ラインを左から右に解析します。 いくつかのオプション、 File パラメーター、新しいオプション、別の File パラメーターなどを指定できます。 BinPlace が新しいオプションを検出するたびに、それが採用され、以前に見られていた矛盾したオプションがオーバーライドされます。 File指定子が検出されるたびに、コマンド ラインで既に検出された累積オプションを使用してそのファイルに対して動作します。

ファイルにパラメーターを指定する

テキスト ファイルから BinPlace にパラメーターを渡すことができます。 これには、2 つの方法があります。

  • BINPLACE_OVERRIDE_FLAGS環境変数でファイル名を指定できます。 このファイルは、BinPlace が実行されるたびに読み取られ、その内容がパラメーターとして使用されます。 このファイル内のパラメーターは、実際に BinPlace コマンド ラインに表示されるパラメーターの前に解析されます。

  • BinPlace コマンド ラインでファイル名を指定するには、先頭にアット マーク ( @ ) を付けます。 コマンド ラインでこの記号で始まる文字列が BinPlace に表示されると、文字列が取得され、アット マークが削除され、この名前のファイルが検索されます。 このファイルが見つかると、at 記号で始まる元のパラメーターが存在していた場所にテキストがコマンド ラインに挿入されます。 BinPlace は左から右にパラメーターを解析するため、この手法を File の複数のインスタンスと共に使用して、毎回すべてのオプションを入力しなくても、それぞれ異なるオプションを持つ複数のファイルで BinPlace を使用できます。 (このファイルが見つからない場合、BinPlace はアット マークを含む元の文字列を として扱いますFile パラメーター)。)