Sintaxis del archivo de Place
Nota Colocar archivos ahora están obsoletos y no se deben usar. .
El archivo place es un archivo de texto que BinPlace lee para determinar los subdirectorios de clase asociados a un archivo que está colocando.
La ruta de acceso y el nombre de este archivo se especifican mediante el parámetro de línea de comandos -p PlaceFile. Si no se usa, el valor predeterminado es \tools\placefil.txt. Un archivo de posición puede tener cualquier número de líneas. Cada línea muestra un archivo y un subdirectorio de clase. La enumeración de un archivo no hace que BinPlace realice ninguna acción. En su lugar, siempre que binPlace se proporcione un nombre de archivo en la línea de comandos, abrirá el archivo de lugar para ver si ese archivo aparece en la lista. Si es así, BinPlace usará el subdirectorio de clase especificado en el archivo place para ese archivo en particular.
Cada línea de un archivo de lugar tiene el mismo formato.
FileName Class[:Class[...] [ ; Comment ]
Cada línea del archivo place sigue estas reglas:
- El campo FileName debe comenzar la línea.
- Los campos FileName y Class deben estar separados por uno o varios espacios.
- Si aparece un punto y coma en cualquier parte de la línea, todo a la derecha de él se trata como comentario.
- Se permiten líneas en blanco y líneas de comentario que comienzan por punto y coma.
Los campos FileName y Class se explican de la siguiente manera:
Parámetros
Nombre
Campo que especifica el nombre de un archivo en el que BinPlace puede actuar. FileName debe incluir la extensión de nombre de archivo, pero no debe incluir la ruta de acceso del archivo. (Las rutas de acceso de archivo se especificarán en la línea de comandos binPlace).
Clase
Campo que especifica el subdirectorio de clase que se usa para este archivo. A menos que se usen los modificadores de línea de comandos -y o -:D EST , BinPlace coloca un archivo en un directorio que se crea tomando el directorio de destino raíz, anexando el subdirectorio de clase y, a continuación, anexando el subdirectorio de tipo de archivo. Consulte Directorios de destino de BinPlace para obtener más información.
La clase no debe comenzar ni terminar con una barra diagonal inversa. Los nombres de directorio no deben contener espacios. Hay cadenas especiales que se pueden usar dentro de un valor class . El efecto de la cadena es diferente en la ubicación de archivos ejecutables y archivos de símbolos. En las tablas siguientes se muestran los resultados de estas cadenas.
Para todas las compilaciones:
| Cadena | Efecto en los archivos ejecutables | Efecto en los archivos de símbolos |
|---|---|---|
venta al por menor |
ignorado. Este nivel de directorio se omitirá. |
Se trata como un directorio literal denominado retail. |
* |
En un equipo x86: i386. En un equipo basado en Itanium: IA64. En un equipo basado en x64: AMD64. | ignorado. Este nivel de directorio se omitirá. |
fría |
Se convierte en system32. |
|
system16 |
Se convierte en sistema. |
|
windows |
Se convierte en "." Ignorado. Este nivel de directorio se omitirá. |
La ruta de acceso al símbolo es comercial. |
Controladores |
Se convierte en system32\drivers. |
|
drvetc |
Se convierte en system32\drivers\etc. |
|
config |
Se convierte en system32\config. |
Para compilaciones x86:
| Cadena | Efecto en los archivos ejecutables | Efecto en los archivos de símbolos |
|---|---|---|
hal |
Se convierte en system32. |
|
impresora |
Se convierte en system32\spool\drivers\w32x86. |
|
prtprocs |
Se convierte en system32\spool\prtprocs\w32x86. |
Para compilaciones AMD64:
| Cadena | Efecto en los archivos ejecutables | Efecto en los archivos de símbolos |
|---|---|---|
hal |
Se convierte en "."." Por ejemplo, si el directorio de destino raíz es C:\Binaries\Amd64, el archivo se coloca en C:\Binaries. |
La ruta de acceso al símbolo se quita de un directorio. |
impresora |
Se convierte en system32\spool\drivers\w32amd64. |
|
prtprocs |
Se convierte en system32\spool\prtprocs\w32amd64. |
Para compilaciones IA64:
| Cadena | Efecto en los archivos ejecutables | Efecto en los archivos de símbolos |
|---|---|---|
hal |
Se convierte en "."." |
La ruta de acceso al símbolo se quita de un directorio. |
impresora |
Se convierte en system32\spool\drivers\w32ia64. |
|
prtprocs |
Se convierte en system32\spool\prtprocs\w32ia64. |
A menos que se indique lo contrario, la ruta de acceso del símbolo se trunca para incluir solo el primer directorio de la ruta de acceso. Por ejemplo, si estaba usando BinPlace para mover un archivo x86 denominado Build.exe que tiene la clase de destino de impresora, puede usar la siguiente sintaxis de comando:
binplace -r BinaryRoot -xa -s SymbolsDir1 -n SymbolsDir2 SourceFileLocation\build.exe
El comando daría como resultado el siguiente árbol de salida:
<SymbolsDir1>\system32\exe\build.pdb
<SymbolsDir2>\system32\exe\build.pdb
<BinaryRoot>\system32\spool\drivers\w32x86\build.exe
En el caso de las compilaciones AMD64 e IA64, use la clase hal con precaución porque es posible que los resultados de BinPlace no sean los esperados. Por ejemplo, si el directorio de destino raíz es C:\Binaries\Amd64 y especificó la clase hal , el archivo se coloca en C:\Binaries y no en el directorio processor-specifc que podría haber previsto.
Si desea que un archivo se coloque en varias ubicaciones, puede incluir varias instancias de Class, separadas por dos puntos. No debe haber espacios entre los directorios y los dos puntos. Por ejemplo:
someprogram.exe dir1\dir2\dir3:otherdir1\otherdir2 ; To two locations
Comentario
BinPlace omitirá cualquier texto después de un punto y coma.