BinPlace は、配置するファイルを保持するディレクトリ ツリーを作成します。 The structure of that tree is determined by the parameters that are passed to BinPlace's command line, the values of certain environment variables, and the contents of a text file known as a place file.
BinPlace は、次の 2 つの条件のいずれかが満たされた場合にファイルを配置します。
ファイルは BinPlace コマンド ラインで指定されます。
ファイルは、関連付けられている実行可能ファイルと同じディレクトリに存在するシンボル ファイルであり、実行可能ファイルはコマンド ラインで指定されます。 この場合、シンボル ファイルと実行可能ファイルは異なるディレクトリに配置されます。 このシナリオでは、BinPlace で分割または削除 ( パブリック シンボルとプライベート シンボルを参照) または削除 ( シンボル ファイル システムを参照) を実行することもできます。
BinPlace がファイルを配置すると、同じ名前の古いファイルが自動的に上書きされます。 ただし、BinPlace では、既定では新しいファイルは上書きされません。 特に、実行可能ファイルの新しい (または同一の) バージョンが存在する場合、実行可能ファイルも関連するシンボル ファイルもディスクに書き込まれなくなります。 If you wish BinPlace to overwrite files regardless of their timestamp, use the -f command-line option.
ファイル変換先
BinPlace がコマンド ラインに指定したファイルを配置するディレクトリの名前は、 ルート変換先ディレクトリ と クラス サブディレクトリの 2 つのディレクトリを連結して作成されます。 (ディレクトリには任意の名前を指定できますが、通常、ルート変換先ディレクトリはファイルを配置するディレクトリ ツリーのルートであり、クラス サブディレクトリは、特定のファイルまたはファイル のグループを配置するのが論理的と思われるサブディレクトリです)。
ルートの宛先ディレクトリは、-r RootDestinationPath コマンド ライン パラメーターを使用して指定できます。 省略した場合、既定値は、x86 ベース、Itanium ベース、または x64 ベースのコンピューターの_NT386TREE、_NTIA64TREE、または_NTAMD64TREE環境変数によって決定されます。 ルートの宛先ディレクトリは、次のいずれかの方法で定義する必要があります。定義されていない場合、BinPlace は実行されません。
クラス サブディレクトリは通常、place ファイルで指定されます。 1 つのファイルに対して複数のクラス サブディレクトリを指定できます。これにより、BinPlace はファイルのコピーを作成し、指定された各場所に配置します。 詳細については、「 ファイルの構文を配置する 」を参照してください。 class サブディレクトリは、-:D EST ClassPath コマンド ライン パラメーターを使用して指定することもできます。
シンボル ファイルの変換先
実行可能ファイルが BinPlace のコマンド ラインに一覧表示され、同じディレクトリに関連するシンボル ファイルがある場合、BinPlace はシンボル ファイルもコピー (または変更) します。 このシンボル ファイルが配置されるディレクトリは、 シンボル ルート ディレクトリ、 クラス サブディレクトリ、および ファイルの種類のサブディレクトリの 3 つのディレクトリを連結することによって作成されます。
シンボル ルート ディレクトリは、-s SymbolRoot コマンド ライン パラメーターを使用して指定できます。 If you are using the -a and -x switches, stripped symbol files will be placed under the SymbolRoot directory -- in this case, you can use -n FullSymbolRoot to specify the location of full symbol files.
クラス サブディレクトリは通常、place ファイルで指定されます。 1 つのファイルに対して複数のクラス サブディレクトリを指定できます。これにより、BinPlace はファイルのコピーを作成し、指定された各場所に配置します。 詳細については、「 ファイルの構文を配置する 」を参照してください。 class サブディレクトリは、-:D EST ClassPath コマンド ライン パラメーターを使用して指定することもできます。 And if the -y command-line switch is used, no class subdirectory will be used for symbol files -- the destination directory will simply consist of the symbol root directory plus the file-type subdirectory.
ファイルの種類のサブディレクトリは、シンボル ファイルにのみ使用されます。 これは、元の実行可能ファイルのファイル名拡張子によって決まります。 したがって、.exe ファイルに関連付けられたシンボル ファイルは exe サブディレクトリに配置され、DLL に関連付けられているシンボル ファイルは dll サブディレクトリに配置され、ドライバーに関連付けられているシンボル ファイルは sys サブディレクトリに配置されます。 この規則は、ファイル名の競合を回避するのに役立ちます。たとえば、myprogram.exe と myprogram.dll の両方に myprogram.pdb という名前のシンボル ファイルがある場合がありますが、これらのシンボル ファイルは異なるサブディレクトリに配置されます。
このアルゴリズムには 1 つの例外があります。 If neither -s nor -n is supplied, the full symbol files will be placed in the same location as the binaries.
Note If you list the symbol file name in BinPlace's command line, BinPlace will move it like any other file and will not examine its contents. BinPlace のシンボル ファイル操作手法を使用するには、シンボル ファイル名ではなく実行可能ファイル名を一覧表示する必要があります。