Compartir a través de

Sintaxis de la línea de comandos de BinPlace

  • Artículo

BinPlace usa la sintaxis siguiente en la línea de comandos:

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

Parámetros

Opciones
Esto puede incluir cualquiera de los siguientes modificadores. Los modificadores deben ir precedidos de un guión (-) o una barra diagonal (/). Es posible combinar varias opciones después de un guión o barra diagonal, pero las opciones que toman parámetros adicionales deben ir seguidos de un espacio. Así, los dos comandos siguientes son equivalentes:

binplace -q -k -g LCFile -v -s SymbolRoot File 
binplace -qkg LCFile -vs SymbolRoot File

Están disponibles los siguientes conmutadores:

-a
Hace que BinPlace quite símbolos privados de los archivos de símbolos cuando se colocan. Esto crea archivos de símbolos eliminados que contienen símbolos públicos, pero no símbolos privados. Al usar el modificador -a , también debe usar -s y -x . Cuando se usa -a , los archivos de símbolos quitados se colocarán en la ruta de acceso especificada por -sSymbolRoot. Si -nFullSymbolRoot también está presente, los archivos de símbolos completos se colocarán en FullSymbolRoot. De lo contrario, no se colocarán en ningún lugar.

-b ExtraSubdirectory
Hace que BinPlace coloque archivos en una ubicación diferente de la habitual. Después de concatenar el directorio de destino raíz, el subdirectorio de clase y el subdirectorio de tipo de archivo como de costumbre, BinPlace anexará ExtraSubdirectory a esta ruta de acceso para crear el directorio de destino final. ExtraSubdirectory no debe comenzar ni terminar con una barra diagonal inversa. Consulte Directorios de destino de BinPlace para obtener más detalles.

-e
Hace que BinPlace continúe la ejecución si no se puede colocar un archivo. De forma predeterminada, BinPlace se cerrará cuando se produzca este error.

-f
Obliga a BinPlace a colocar un archivo aunque sobrescriba un archivo más reciente. De forma predeterminada, cuando BinPlace intenta colocar un archivo, sobrescribirá una versión anterior, pero no sobrescribirá una versión más reciente.

-g LCFile
Hace que BinPlace compruebe el archivo ejecutable. LCFile especifica el archivo de restricción de localización que se va a usar para esta comprobación.

-h
Hace que BinPlace cree vínculos duros en lugar de copiar el archivo al colocar archivos. Esta opción solo está disponible en el sistema de archivos NTFS.

-j
Hace que BinPlace compruebe que existen los símbolos adecuados antes de copiar los archivos ejecutables. Para que se use esta opción, la herramienta SymChk debe estar en la ruta de acceso. (SymChk forma parte del paquete Herramientas de depuración para Windows. Consulte Depuración de Windows para obtener más información).

-k
Hace que BinPlace conserve los atributos de archivo. De forma predeterminada, BinPlace desactivará el atributo archive.

-n FullSymbolRoot
Especifica el directorio raíz para los archivos de símbolos completos (archivos de símbolos que contienen símbolos públicos y privados). Esto también requiere los modificadores -a, -x y -s . Consulte Directorios de destino de BinPlace para obtener más detalles.

-o RootSubdirectory
Especifica un subdirectorio del directorio de destino raíz que se va a usar. Cuando se crea el directorio de destino, RootSubdirectory se insertará después del directorio de destino raíz y antes del subdirectorio de clase. Consulte Directorios de destino de BinPlace para obtener más detalles.

-p PlaceFile
Especifica la ruta de acceso y el nombre de archivo del archivo place. Si no se usa el modificador -p , BinPlace usa un lugar denominado \tools\placefil.txt. Consulte Place File Syntax (Colocar sintaxis de archivo) para obtener una explicación del contenido de un archivo de lugar.

Nota Los archivos -p switch y place ahora están obsoletos y no deben usarse.

-q
Impide que BinPlace use un archivo de registro. Si se omite el modificador -q , el archivo especificado por la variable de entorno BINPLACE_LOG se usa como archivo de registro.

-r RootDestinationPath
Especifica el directorio de destino raíz. Si se omite, el valor predeterminado viene determinado por el _NT386TREE, _NTIA64TREE o _NTAMD64TREE variable de entorno en un equipo basado en x86, basado en Itanium o basado en x64, respectivamente. Consulte Directorios de destino de BinPlace para obtener más información.

-s SymbolRoot
Especifica el directorio raíz para los archivos de símbolos. Si también se usan los modificadores -a y -x , los símbolos privados se quitarán de los archivos de símbolos y los archivos de símbolos eliminados se colocarán en el directorio especificado por SymbolRoot. Si desea colocar archivos de símbolos eliminados y completos, debe usar -a -x -s SymbolRoot -n FullSymbolRoot. Consulte Directorios de destino de BinPlace para obtener más detalles.

-t
Modo de prueba. Cuando se usa este modificador, no se copiarán archivos, pero BinPlace mostrará mensajes de advertencia y error como si estuviera colocando archivos. Es posible que también desee usar el modificador -v para aumentar el número de mensajes.

-u
Hace que BinPlace anexe \up al subdirectorio de clase. Esto resulta útil para separar los controladores de un uniprocesador (UP). Además, siempre que se use este modificador, BinPlace no dividirá los archivos ejecutables que contengan símbolos. Consulte Directorios de destino de BinPlace para obtener más detalles.

-v
Modo detallado. Hace que BinPlace muestre mensajes de error, advertencia y progreso más detallados.

-w
Hace que BinPlace agregue archivos de símbolos de Windows 95 (.sym) al árbol de símbolos.

-x
Si BinPlace encuentra archivos que usan el sistema de símbolos antiguo, este modificador hace que quite todos los símbolos de los archivos ejecutables y mueva esta información a archivos de símbolos independientes. Consulte Sistemas de archivos de símbolos para obtener más información. Al usar el modificador -x , también debe usar -s y -a .

-y
Impide que BinPlace use cualquier subdirectorio de clase. El directorio de destino se creará únicamente desde el directorio de destino raíz más el subdirectorio de tipo de archivo. Consulte Directorios de destino de BinPlace para obtener más información.

-z
Cancela el modificador -x . Esto puede ser útil si usa BinPlace en varios destinos: puede usar un comando del formulario binplace argumentsTarget1argumentsTarget2 y, dado que la línea de comandos se analiza de izquierda a derecha, Target1 y Target2 se verán afectados por distintos argumentos. (Consulte la sección Orden de análisis siguiente). Si se encuentra un modificador -z, esto cancela el efecto de cualquier modificador -x anterior.

-ci ReturnCode,Application,Argument,Argument, ...
Hace que BinPlace use una aplicación personalizada para validar todos los archivos ejecutables. Puede usar el modificador -ci si desea que BinPlace use alguna otra aplicación para realizar su validación.

ReturnCode debe ser el valor devuelto por esta aplicación si encuentra un error en un archivo ejecutable. Los parámetros adicionales se usan para iniciar esta aplicación. Todos deben estar separados por comas. Application especifica el nombre del programa. Esto puede ir seguido de cualquier número de argumentos de línea de comandos. El programa se iniciará con una línea de comandos que incluye Application seguido de todos los argumentos (separados por espacios en lugar de comas) y, por último, finalizando con el nombre del archivo ejecutable que se va a comprobar.

-:ARCO
Hace que BinPlace coloque solo los archivos cuyos atributos de archivo están establecidos.

-:D BG
Impide que BinPlace coloque archivos .dbg. Si también se usa el modificador -j , esto impedirá que BinPlace coloque archivos binarios que apunten a archivos .dbg. Para que se use esta opción, la herramienta SymChk debe estar en la ruta de acceso. (SymChk forma parte del paquete Herramientas de depuración para Windows. Consulte Depuración de Windows para obtener más información).

-:D EST ClassPath
Hace que BinPlace omita el archivo de posición y use classPath especificado como subdirectorio de clase. Consulte Directorios de destino de BinPlace para obtener más información.

-:LOGPDB
Hace que BinPlace incluya las rutas de acceso .pdb completas en el archivo de registro.

-:REN NewName
Hace que BinPlace cambie el nombre de los archivos que se están colocando. El nombre de archivo original, incluida la extensión, se reemplazará por NewName. (Si el archivo original es un archivo ejecutable que se va a dividir, al nuevo archivo de símbolos se le asignará el nombre de archivo original más la extensión .dbg).

-:TMF
Hace que BinPlace cree un archivo de formato de mensaje de seguimiento (.tmf) mediante la extracción de instrucciones de formato de mensaje de seguimiento del archivo de símbolos PDB. El archivo TMF se colocará en el directorio especificado por la variable de entorno BinPlace TRACE_FORMAT_PATH. Consulte Variables de entorno y macros binPlace.

-ChangeAsmsToRetailForSymbols
Hace que BinPlace reemplace la cadena "asms" por la cadena "retail" si se produce en el directorio de destino para los archivos de símbolos. Consulte Directorios de destino de BinPlace para obtener más detalles.

Archivo
Especifica la ruta de acceso completa y el nombre de archivo de un archivo en el que Actuará BinPlace. Puede enumerar cualquier número de archivos, separados por espacios. Si una ruta de acceso y un nombre de archivo contienen un espacio, debe incluir la ruta de acceso y el nombre de archivo entre comillas.

@PlaceFile
Si un nombre de archivo va precedido por un signo en ( @ ), el nombre de archivo representa el nombre de un archivo de lugar. Para obtener más información, consulte la sección Proporcionar parámetros en un archivo a continuación.

Orden de análisis

BinPlace analiza la línea de comandos de izquierda a derecha. Puede especificar varias opciones, luego un parámetro File , luego nuevas opciones, otro parámetro File , etc. Cada vez que BinPlace encuentre una nueva opción, se adoptará, reemplazando las opciones opuestas que se han visto anteriormente. Cada vez que encuentre un especificador de archivo , actuará en ese archivo con las opciones acumuladas que ya ha encontrado en la línea de comandos.

Proporcionar parámetros en un archivo

Es posible pasar parámetros a BinPlace desde un archivo de texto. Existen dos modos para hacer esto:

  • Puede especificar un nombre de archivo en la variable de entorno BINPLACE_OVERRIDE_FLAGS. Este archivo se leerá y su contenido se usará como parámetros cada vez que se ejecute BinPlace. Los parámetros de este archivo se analizarán antes de los parámetros que realmente aparecen en la línea de comandos binPlace.

  • Puede especificar un nombre de archivo en la línea de comandos binPlace prefijo con un signo en ( @ ). Cuando BinPlace ve una cadena que comienza con este inicio de sesión en su línea de comandos, tomará la cadena, quitará el signo y, a continuación, buscará un archivo con este nombre. Si encuentra este archivo, insertará su texto en la línea de comandos exactamente en el lugar donde se había iniciado el parámetro original con el signo en. Dado que BinPlace analiza los parámetros de izquierda a derecha, puede usar esta técnica junto con varias instancias de File para usar BinPlace en varios archivos con diferentes opciones para cada uno, sin tener que escribir todas las opciones cada vez. (Si no se encuentra este archivo, BinPlace tratará la cadena original, incluido el signo at, como Parámetro de archivo ).