place ファイルの構文
注 place ファイルは古くなっているため、使用しないでください。 .
place ファイルは、BinPlace が読み取って、配置するファイルに関連付けられているクラス サブディレクトリを判断するテキスト ファイルです。
このファイルのパスと名前は、-p PlaceFile コマンド ライン パラメーターで指定します。 これを使用しない場合、既定は \tools\placefil.txt です。 place ファイルには任意の数の行を含めることができます。 各行には、ファイルとクラス サブディレクトリが一覧表示されます。 ファイルを一覧表示しても、BinPlace は一切アクションを実行しません。 代わりに、BinPlace はコマンド ラインでファイル名が指定されるたびに、place ファイルを開いて、そのファイルが一覧表示されているかどうかを確認します。 その場合、BinPlace は、その特定のファイルの place ファイルで指定されたクラス サブディレクトリを使用します。
place ファイルの各行の形式は同一です。
FileName Class[:Class[...] [ ; Comment ]
place ファイルの各行は、次のルールに従っています。
- FileName フィールドは行を開始する必要があります。
- FileName フィールドと Class フィールドは、1 つ以上のスペースで区切る必要があります。
- セミコロンが行の任意の位置に表示されている場合、セミコロンの右側にあるすべてがコメントとして扱われます。
- セミコロンで始まる空白行とコメント行を使用できます。
FileName フィールドと Class フィールドについての説明は次のとおりです。
パラメーター
FileName
BinPlace が操作できるファイルの名前を指定するフィールド。 FileName にはファイル名拡張子を含める必要がありますが、ファイル パスを含めることはできません。 (ファイル パスは BinPlace コマンド ラインで指定されます)。
Class
このファイルに使用されるクラス サブディレクトリを指定するフィールド。 -y または -:DEST コマンド ライン スイッチが使用されない限り、BinPlace は、ルート宛先ディレクトリを取得し、クラス サブディレクトリを追加し、次にファイルの種類のサブディレクトリを追加して作成したディレクトリにファイルを配置します。 詳細については、「BinPlace 宛先ディレクトリ」を参照してください。
Class の先頭と末尾をバックスラッシュにすることはできません。 ディレクトリ名にスペースを含めることはできません。 Class 値内で使用できる特殊な文字列があります。 この文字列の効果は、実行可能ファイルとシンボル ファイルの配置によって異なります。 次の表は、これらの文字列の効果を示しています。
すべてのビルド:
| 文字列 | 実行可能ファイルへの影響 | シンボル ファイルへの影響 |
|---|---|---|
retail |
無視されます。 このディレクトリ レベルはスキップされます。 |
retail という名前のリテラル ディレクトリとして扱われます。 |
* |
x86 コンピューターの場合: i386。 Itanium ベースのコンピューターの場合: IA64。 x64 ベースのコンピューターの場合: AMD64。 | 無視されます。 このディレクトリ レベルはスキップされます。 |
system |
system32 になります。 |
|
system16 |
system になります。 |
|
windows |
「.」になり、無視されます。 このディレクトリ レベルはスキップされます。 |
シンボル パスは retail です。 |
drivers |
system32\drivers になります。 |
|
drvetc |
system32\drivers\etc になります。 |
|
config |
system32\config になります。 |
x86 ビルド:
| 文字列 | 実行可能ファイルへの影響 | シンボル ファイルへの影響 |
|---|---|---|
hal |
system32 になります。 |
|
printer |
system32\spool\drivers\w32x86 になります。 |
|
prtprocs |
system32\spool\prtprocs\w32x86 になります。 |
AMD64 ビルド:
| 文字列 | 実行可能ファイルへの影響 | シンボル ファイルへの影響 |
|---|---|---|
hal |
「..」になります。たとえば、ルート宛先ディレクトリが C:\Binaries\Amd64 の場合、ファイルは C:\Binaries に配置されます。 |
シンボル パスは 1 つのディレクトリから削除されます。 |
printer |
system32\spool\drivers\w32amd64 になります。 |
|
prtprocs |
system32\spool\prtprocs\w32amd64 になります。 |
IA64 ビルド:
| 文字列 | 実行可能ファイルへの影響 | シンボル ファイルへの影響 |
|---|---|---|
hal |
「..」になります |
シンボル パスは 1 つのディレクトリから削除されます。 |
printer |
system32\spool\drivers\w32ia64 になります。 |
|
prtprocs |
system32\spool\prtprocs\w32ia64 になります。 |
特に指定がない限り、シンボル パスは、パス内の最初のディレクトリのみを含むように切り詰められます。 たとえば、BinPlace を使用して printer のターゲット クラスがある Build.exe という x86 ファイルを移動する場合は、次のコマンド構文を使用できます。
binplace -r BinaryRoot -xa -s SymbolsDir1 -n SymbolsDir2 SourceFileLocation\build.exe
コマンドは、次の出力ツリーを生成します。
<SymbolsDir1>\system32\exe\build.pdb
<SymbolsDir2>\system32\exe\build.pdb
<BinaryRoot>\system32\spool\drivers\w32x86\build.exe
AMD64 および IA64 ビルドの場合は、BinPlace の結果が予期したものにならない可能性があるため、hal クラスを慎重に使用してください。 たとえば、ルート宛先ディレクトリが C:\Binaries\Amd64 で、hal クラスを指定した場合、ファイルは、意図したプロセッサ固有のディレクトリではなく C:\Binaries に配置されます。
ファイルを複数の場所に配置するには、コロンで区切って、Class の複数のインスタンスを含めることができます。 ディレクトリとコロンの間にスペースを挿入しないでください。 次に例を示します。
someprogram.exe dir1\dir2\dir3:otherdir1\otherdir2 ; To two locations
Comment
セミコロンの後のテキストは、BinPlace に無視されます。