Каталоги назначения BinPlace

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 будет размещать файлы, если выполняется одно из двух условий:

1. Файл указан в командной строке BinPlace.

2. Файл представляет собой файл символов, размещенный в том же каталоге, что и связанный с ним исполняемый файл, а исполняемый файл указан в командной строке. В этом случае файл символов и исполняемый файл будут помещены в разные каталоги. BinPlace также может выполнять разделение или удаление (см. общедоступные символы и закрытые символы) или отрезки (см. файлы файловых систем символов) в этом сценарии.

Если BinPlace помещает файлы, он автоматически перезаписывает старый файл с тем же именем. Однако BinPlace по умолчанию не перезаписывает новый файл. В частности, если присутствует более новая (или идентичная) версия исполняемого файла, ни исполняемый файл, ни связанные файлы символов не будут записаны на диск. If you wish BinPlace to overwrite files regardless of their timestamp, use the -f command-line option.

Назначения файлов

Имя каталога, в который BinPlace помещает любой файл, указанный в командной строке, создается путем объединения двух каталогов: корневого каталога назначения и подкаталога класса. (Каталоги могут иметь любые имена, которые вы выбираете, но обычно корневой целевой каталог является корнем дерева каталогов, где вы помещаете файлы, и подкаталог класса является подкаталогом, где кажется логическим разместить определенный файл или группу файлов.)

• Корневой каталог назначения можно указать с помощью параметра командной строки rootDestinationPath -r. Если это опущено, значение по умолчанию определяется _NT386TREE, _NTIA64TREE или _NTAMD64TREE переменной среды на основе x86, на основе Itanium или на компьютере на основе x64 соответственно. Корневой каталог назначения должен быть определен одним из этих способов; Если он не определен вообще, BinPlace не будет выполняться.

• Подкаталог класса обычно указывается в файле места. Можно указать несколько подкаталогов класса для одного файла; Это приводит к тому, что BinPlace делает копии файла и помещает их в каждое из указанных расположений. Подробные сведения см. в синтаксисе файла по месту . Подкаталог класса также можно указать с помощью параметра командной строки -:D EST ClassPath.

Назначения файлов символов

Если исполняемый файл указан в командной строке BinPlace и есть связанный файл символов в том же каталоге, BinPlace будет копировать (или изменять) файл символов. Каталог, в котором размещается этот файл символов, создается путем объединения трех каталогов: корневого каталога символов, подкаталога класса и подкаталога типа файла.

• Корневой каталог символов можно указать с помощью параметра командной строки SymbolRoot -s. 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.

• Подкаталог класса обычно указывается в файле места. Можно указать несколько подкаталогов класса для одного файла; Это приводит к тому, что BinPlace делает копии файла и помещает их в каждое из указанных расположений. Подробные сведения см. в синтаксисе файла по месту . Подкаталог класса также можно указать с помощью параметра командной строки -: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, но эти файлы символов будут размещены в разных подкаталогах.

Существует одно исключение из этого алгоритма. 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, необходимо указать имя исполняемого файла, а не имя файла символов.