Синтаксис файла размещения
Файлы с примечанием о месте теперь устарели и не должны использоваться. .
Файл места — это текстовый файл, считывающий BinPlace для определения подкаталогов класса, связанных с файлом, который он помещает.
Путь и имя этого файла задаются параметром командной строки -p PlaceFile. Если это не используется, значение по умолчанию — \tools\placefil.txt. Файл места может иметь любое количество строк. Каждая строка содержит файл и подкаталог класса. Перечисление файла не приводит к тому, что BinPlace будет выполнять какие-либо действия. Скорее, когда BinPlace предоставляет имя файла в командной строке, он откроет файл места, чтобы узнать, указан ли этот файл. Если это так, BinPlace будет использовать подкаталог класса, указанный в файле места для этого конкретного файла.
Каждая строка файла места имеет одинаковый формат.
FileName Class[:Class[...] [ ; Comment ]
Каждая строка в файле места соответствует следующим правилам:
- Поле FileName должно начинать строку.
- Поля FileName и Class должны быть разделены одним или несколькими пробелами.
- Если точка с запятой отображается в любом месте линии, все справа от него рассматривается как комментарий.
- Разрешены пустые строки и строки комментариев, начинающиеся с запятой.
Поля FileName и Class описаны следующим образом:
Параметры
Имя файла
Поле, указывающее имя файла, с которым может работать BinPlace. Имя файла должно включать расширение имени файла, но оно не должно включать путь к файлу. (Пути к файлам будут указаны в командной строке BinPlace.)
Класс
Поле, указывающее подкаталог класса, используемый для этого файла. Если параметры командной строки -y или -:D EST не используются, BinPlace помещает файл в каталог, созданный путем получения корневого целевого каталога, добавления подкаталога класса, а затем добавления подкаталога типа файла. Полные сведения см . в каталогах назначения BinPlace.
Класс не должен начинаться или заканчиваться обратной косой чертой. Имена каталогов не должны содержать пробелы. Существуют специальные строки, которые можно использовать в значении класса . Эффект строки отличается от размещения исполняемых файлов и файлов символов. В следующих таблицах показаны результаты этих строк.
Для всех сборок:
| Строка | Влияние на исполняемые файлы | Влияние на файлы символов |
|---|---|---|
розничный |
Пропускается. Этот уровень каталога будет пропущен. |
Рассматривается как литеральный каталог с именем retail. |
* |
На компьютере x86: i386. На компьютере на основе Itanium: IA64. На компьютере на основе x64: AMD64. | Пропускается. Этот уровень каталога будет пропущен. |
system |
Становится system32. |
|
system16 |
Становится системой. |
|
windows |
Становится "." Игнорировать. Этот уровень каталога будет пропущен. |
Путь к символам — розничная торговля. |
Драйверы |
Становится system32\drivers. |
|
drvetc |
Становится system32\drivers\etc. |
|
config |
Становится system32\config. |
Для сборок x86:
| Строка | Влияние на исполняемые файлы | Влияние на файлы символов |
|---|---|---|
hal |
Становится system32. |
|
принтер |
Становится system32\spool\drivers\w32x86. |
|
prtprocs |
Становится system32\spool\prtprocs\w32x86. |
Для сборок AMD64:
| Строка | Влияние на исполняемые файлы | Влияние на файлы символов |
|---|---|---|
hal |
Становится ". Например, если корневой каталог назначения — C:\Binaries\Amd64, файл помещается в C:\Binaries. |
Путь к символам лишается одного каталога. |
принтер |
Становится system32\spool\drivers\w32amd64. |
|
prtprocs |
Становится system32\spool\prtprocs\w32amd64. |
Для сборок IA64:
| Строка | Влияние на исполняемые файлы | Влияние на файлы символов |
|---|---|---|
hal |
Становится ". |
Путь к символам лишается одного каталога. |
принтер |
Становится system32\spool\drivers\w32ia64. |
|
prtprocs |
Становится system32\spool\prtprocs\w32ia64. |
Если иное не указано, путь к символам усечен, чтобы включить только первый каталог в путь. Например, если вы использовали BinPlace для перемещения файла x86 с именем Build.exe с целевым классом принтера, можно использовать следующий синтаксис команды:
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 используйте класс hal с осторожностью, так как результаты BinPlace могут не быть ожидаемыми. Например, если корневой каталог назначения — C:\Binaries\Amd64, и вы указали класс hal , файл помещается в C:\Binaries, а не в каталоге обработчика, который может потребоваться.
Если вы хотите поместить файл в несколько расположений , можно включить несколько экземпляров класса, разделенных двоеточиями. Между каталогами и двоеточиями не должно быть пробелов. Например:
someprogram.exe dir1\dir2\dir3:otherdir1\otherdir2 ; To two locations
Комментарий
Любой текст после запятой будет игнорироваться BinPlace.