Синтаксис командной строки BinPlace

BinPlace использует следующий синтаксис в командной строке:

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

Параметры

Параметры
Это может включать любой из следующих коммутаторов. Параметры должны предшествовать дефису (-) или косой черте (/). Можно объединить несколько вариантов после одного дефиса или косой черты, но параметры, которые принимают дополнительные параметры, должны следовать пробелу. Таким образом, следующие две команды эквивалентны:

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

Обратите внимание , что параметр -p и файлы размещения теперь устарели и не должны использоваться.

-q
Запрещает binPlace использовать файл журнала. Если параметр -q опущен, файл, указанный переменной среды BINPLACE_LOG, используется в качестве файла журнала.

-r RootDestinationPath
Указывает корневой каталог назначения. Если это опущено, значение по умолчанию определяется _NT386TREE, _NTIA64TREE или _NTAMD64TREE переменной среды на основе x86, на основе Itanium или на компьютере на основе x64 соответственно. Дополнительные сведения см. в каталогах назначения 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
Если BinPlace встречает файлы, использующие старую систему символов, этот параметр приводит к удалению всех символов из исполняемых файлов и перемещению этих сведений в отдельные файлы символов. Дополнительные сведения см. в файловой системе символов . При использовании переключателя -x также необходимо использовать -s и -a .

-y
Запрещает использование подкаталогов класса BinPlace. Целевой каталог будет создан исключительно из корневого целевого каталога, а также подкаталога типа файла. Дополнительные сведения см. в каталогах назначения BinPlace.

-z
Отменяет параметр -x . Это может быть полезно, если вы используете BinPlace в нескольких целевых объектах. Вы можете использовать команду аргументов binplace в форматеTarget1argumentsTarget2, и так как командная строка анализируется слева направо, Target1 и Target2 будут затронуты различными аргументами. (См. раздел "Анализ порядка" ниже). Если обнаружен параметр -z, это отменяет эффект любого предыдущего коммутатора -x.

-ci ReturnCode,Application,Argument,Argument, ...
Позволяет BinPlace использовать пользовательское приложение для проверки всех исполняемых файлов. Вы можете использовать переключатель -ci , если вы хотите, чтобы BinPlace использовало другое приложение для его проверки.

ReturnCode должен быть значением, возвращаемым этим приложением, если он находит ошибку в исполняемом файле. Для запуска этого приложения используются дополнительные параметры. Все они должны быть разделены запятыми. Приложение задает имя программы. За ним можно следовать любое количество аргументов командной строки. Программа будет запущена с командной строкой, включающей приложение , за которым следуют все аргументы (разделенные пробелами, а не запятыми), и, наконец, заканчивается именем исполняемого файла, который необходимо проверить.

-:ДУГА
Позволяет BinPlace размещать только файлы, архивные атрибуты которых заданы.

-:D BG
Запрещает BinPlace размещать dbg-файлы. Если параметр -j также используется, это не позволит BinPlace размещать двоичные файлы, указывающие на DBG-файлы. Для использования этого параметра инструмент SymChk должен находиться в пути. (SymChk является частью пакета средств отладки для Windows. Дополнительные сведения см. в отладке Windows.)

-:D EST ClassPath
Позволяет BinPlace игнорировать файл места и использовать указанный ClassPath в качестве подкаталога класса. Дополнительные сведения см. в каталогах назначения BinPlace.

-:LOGPDB
Приводит к тому, что BinPlace включает полные пути PDB в файл журнала.

-:REN NewName
Приводит к переименованию файлов, размещенных в BinPlace. Исходное имя файла, включая расширение, будет заменено NewName. (Если исходный файл является исполняемым файлом, разделенным, новый файл символа будет присвоен исходное имя файла, а также расширение DBG.)

-:TMF
Позволяет BinPlace создать файл формата сообщения трассировки (.tmf), извлекая инструкции по форматированию сообщений трассировки из файла символов PDB. Файл TMF будет помещен в каталог, указанный переменной среды BinPlace TRACE_FORMAT_PATH. См . макросы BinPlace и переменные среды.

-ChangeAsmsToRetailForSymbols
Позволяет BinPlace заменить строку asms строкой "retail", если она возникает в целевом каталоге для файлов символов. Дополнительные сведения см . в каталогах назначения BinPlace.

Файл
Указывает полный путь и имя файла, с которым будет работать BinPlace. Вы можете указать любое количество файлов, разделенных пробелами. Если путь и имя файла содержат пробел, необходимо заключить путь и имя файла в кавычки.

@PlaceFile
Если имя файла предшествует @ знаку (), имя файла представляет имя файла места. Дополнительные сведения см. в разделе "Предоставление параметров" в разделе "Файл".

Порядок синтаксического анализа

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

Предоставление параметров в файле

Можно передать параметры в BinPlace из текстового файла. Это можно сделать двумя способами.

• Имя файла можно указать в переменной среды BINPLACE_OVERRIDE_FLAGS. Этот файл будет считываться и его содержимое используется в качестве параметров при запуске BinPlace. Параметры в этом файле будут проанализированы перед параметрами, которые на самом деле отображаются в командной строке BinPlace.

• Имя файла в командной строке BinPlace можно указать, префиксируя его с помощью знака ( @ ). Когда BinPlace видит строку, начинаемую с этого входа в командной строке, она будет принимать строку, удалять при входе, а затем искать файл с таким именем. Если он находит этот файл, он вставляет его текст в командную строку точно в место, где был исходный параметр, начиная с знака. Так как BinPlace анализирует параметры слева направо, этот метод можно использовать вместе с несколькими экземплярами файла для использования BinPlace в нескольких файлах с разными параметрами для каждого, не вводя все параметры каждый раз. (Если этот файл не найден, BinPlace будет обрабатывать исходную строку, включая знак входа, как Параметр файла .)