Inserisci sintassi file
Nota I file di posizione sono ora obsoleti e non devono essere usati. .
Il file di posizione è un file di testo letto da BinPlace per determinare le sottodirectory della classe associate a un file che sta inserendo.
Il percorso e il nome di questo file vengono specificati dal parametro della riga di comando -p PlaceFile. Se non viene usato, il valore predefinito è \tools\placefil.txt. Un file di posizione può avere un numero qualsiasi di righe. Ogni riga elenca un file e una sottodirectory di classe. L'inserimento di un file non comporta l'esecuzione di alcuna azione da parte di BinPlace. Invece, ogni volta che BinPlace viene fornito un nome file nella riga di comando, verrà aperto il file di posizione per verificare se il file è elencato. In caso affermativo, BinPlace userà la sottodirectory della classe specificata nel file di posizione per quel particolare file.
Ogni riga di un file di posizione ha lo stesso formato.
FileName Class[:Class[...] [ ; Comment ]
Ogni riga nel file di posizione segue queste regole:
- Il campo FileName deve iniziare la riga.
- I campi FileName e Class devono essere separati da uno o più spazi.
- Se viene visualizzato un punto e virgola in un punto qualsiasi della riga, tutti gli elementi a destra di esso vengono considerati come un commento.
- Sono consentite righe vuote e righe di commento che iniziano con punti e virgola.
I campi FileName e Class sono illustrati come segue:
Parametri
Filename
Campo che specifica il nome di un file su cui Può agire BinPlace. FileName deve includere l'estensione del nome file, ma non deve includere il percorso del file. I percorsi dei file verranno specificati nella riga di comando di BinPlace.
Classe
Campo che specifica la sottodirectory della classe utilizzata per questo file. A meno che non vengano usate le opzioni della riga di comando -y o -:D EST , BinPlace inserisce un file in una directory creata prendendo la directory di destinazione radice, aggiungendo la sottodirectory della classe e quindi aggiungendo la sottodirectory di tipo file. Per informazioni dettagliate, vedere Directory di destinazione binPlace.
La classe non deve iniziare né terminare con una barra rovesciata. I nomi di directory non devono contenere spazi. Esistono stringhe speciali che possono essere usate all'interno di un valore Class . L'effetto della stringa è diverso nella posizione dei file eseguibili e dei file di simboli. Le tabelle seguenti mostrano i risultati di queste stringhe.
Per tutte le compilazioni:
| String | Effetto sui file eseguibili | Effetto sui file di simboli |
|---|---|---|
Commercio al dettaglio |
Ignorato. Questo livello di directory verrà ignorato. |
Considerato come una directory letterale denominata retail. |
* |
In un computer x86: i386. In un computer basato su Itanium: IA64. In un computer basato su x64: AMD64. | Ignorato. Questo livello di directory verrà ignorato. |
system |
Diventa system32. |
|
system16 |
Diventa sistema. |
|
windows |
Diventa "." Ignorato. Questo livello di directory verrà ignorato. |
Il percorso del simbolo è retail. |
Driver |
Diventa system32\drivers. |
|
drvetc |
Diventa system32\drivers\etc. |
|
config |
Diventa system32\config. |
Per le build x86:
| String | Effetto sui file eseguibili | Effetto sui file di simboli |
|---|---|---|
hal |
Diventa system32. |
|
stampante |
Diventa system32\spool\drivers\w32x86. |
|
prtprocs |
Diventa system32\spool\prtprocs\w32x86. |
Per le build AMD64:
| String | Effetto sui file eseguibili | Effetto sui file di simboli |
|---|---|---|
hal |
Diventa ".." Ad esempio, se la directory di destinazione radice è C:\Binaries\Amd64, il file viene inserito in C:\Binaries. |
Il percorso del simbolo viene rimosso da una directory. |
stampante |
Diventa system32\spool\drivers\w32amd64. |
|
prtprocs |
Diventa system32\spool\prtprocs\w32amd64. |
Per le build IA64:
| String | Effetto sui file eseguibili | Effetto sui file di simboli |
|---|---|---|
hal |
Diventa ".." |
Il percorso del simbolo viene rimosso da una directory. |
stampante |
Diventa system32\spool\drivers\w32ia64. |
|
prtprocs |
Diventa system32\spool\prtprocs\w32ia64. |
Se non diversamente specificato, il percorso del simbolo viene troncato per includere solo la prima directory nel percorso. Ad esempio, se si usa BinPlace per spostare un file x86 denominato Build.exe con la classe di destinazione della stampante, è possibile usare la sintassi di comando seguente:
binplace -r BinaryRoot -xa -s SymbolsDir1 -n SymbolsDir2 SourceFileLocation\build.exe
Il comando genera l'albero di output seguente:
<SymbolsDir1>\system32\exe\build.pdb
<SymbolsDir2>\system32\exe\build.pdb
<BinaryRoot>\system32\spool\drivers\w32x86\build.exe
Per le build AMD64 e IA64, usare la classe hal con cautela perché i risultati di BinPlace potrebbero non essere quello previsto. Ad esempio, se la directory di destinazione radice è C:\Binaries\Amd64 e hai specificato la classe hal , il file viene inserito in C:\Binaries e non nella directory specifc del processore che potresti aver previsto.
Se si vuole inserire un file in più posizioni, è possibile includere più istanze di Class, separate da due punti. Non devono essere presenti spazi tra le directory e i due punti. Ad esempio:
someprogram.exe dir1\dir2\dir3:otherdir1\otherdir2 ; To two locations
Commento
Qualsiasi testo dopo un punto e virgola verrà ignorato da BinPlace.