Directory di destinazione BinPlace

BinPlace crea un albero di directory per contenere i file che inserisce. The structure of that tree is determined by the parameters that are passed to BinPlace's command line, the values of certain environment variables, and the contents of a text file known as a place file.

BinPlace inserisce i file se viene soddisfatta una delle due condizioni seguenti:

1. Il file viene specificato nella riga di comando di BinPlace.

2. Il file è un file di simboli che si trova nella stessa directory del file eseguibile associato e il file eseguibile viene specificato nella riga di comando. In questo caso, il file di simboli e il file eseguibile verranno inseriti in directory diverse. BinPlace può anche eseguire la suddivisione o la rimozione (vedere Simboli pubblici e simboli privati) o rimozione (vedere File system di simboli) in questo scenario.

Quando BinPlace inserisce i file, sovrascriverà automaticamente un file precedente con lo stesso nome. Tuttavia, BinPlace non sovrascriverà per impostazione predefinita un file più recente. In particolare, se è presente una versione più recente (o identica) di un file eseguibile, né il file eseguibile né i file di simboli associati verranno scritti sul disco. If you wish BinPlace to overwrite files regardless of their timestamp, use the -f command-line option.

Destinazioni file

Il nome della directory in cui BinPlace inserisce qualsiasi file specificato nella riga di comando viene creato concatenando due directory: la directory di destinazione radice e la sottodirectory della classe. Le directory possono avere nomi scelti, ma in genere la directory di destinazione radice è la radice dell'albero della directory in cui si inseriscono i file e la sottodirectory della classe è una sottodirectory in cui sembra logico inserire un file o un gruppo di file specifico.

• È possibile specificare la directory di destinazione radice usando il parametro della riga di comando -r RootDestinationPath. Se questo viene omesso, il valore predefinito è determinato rispettivamente dal _NT386TREE, _NTIA64TREE o _NTAMD64TREE variabile di ambiente in un computer basato su x86, basato su Itanium o x64. La directory di destinazione radice deve essere definita in uno di questi modi; se non è definito affatto, BinPlace non verrà eseguito.

• La sottodirectory della classe viene in genere specificata nel file di posizione. È possibile specificare più sottodirectory di classe per un file; In questo modo BinPlace crea copie del file e le inserisce in ognuna delle posizioni specificate. Per informazioni dettagliate, vedere Inserire la sintassi dei file . È anche possibile specificare la sottodirectory della classe usando il parametro della riga di comando -:D EST ClassPath.

Destinazioni file di simboli

Quando un file eseguibile è elencato nella riga di comando di BinPlace e nella stessa directory è presente un file di simboli associato, BinPlace copia (o modifica) anche il file di simboli. La directory in cui viene inserito questo file di simboli viene creata concatenando tre directory: la directory radice dei simboli, la sottodirectory della classe e la sottodirectorydi tipo file.

• È possibile specificare la directory radice dei simboli usando il parametro della riga di comando -s SymbolRoot. If you are using the -a and -x switches, stripped symbol files will be placed under the SymbolRoot directory -- in this case, you can use -n FullSymbolRoot to specify the location of full symbol files.

• La sottodirectory della classe viene in genere specificata nel file di posizione. È possibile specificare più sottodirectory di classe per un file; In questo modo BinPlace crea copie del file e le inserisce in ognuna delle posizioni specificate. Per informazioni dettagliate, vedere Inserire la sintassi dei file . È anche possibile specificare la sottodirectory della classe usando il parametro della riga di comando -:D EST ClassPath. And if the -y command-line switch is used, no class subdirectory will be used for symbol files -- the destination directory will simply consist of the symbol root directory plus the file-type subdirectory.

• La sottodirectory di tipo file viene usata solo per i file di simboli. È determinata dall'estensione del nome file del file eseguibile originale. Pertanto, i file di simboli associati ai file .exe verranno inseriti in una sottodirectory exe, i file di simboli associati alle DLL verranno inseriti in una sottodirectory dll e i file di simboli associati ai driver verranno inseriti in una sottodirectory sys. Questa convenzione consente di evitare conflitti di nomi di file, ad esempio myprogram.exe e myprogram.dll potrebbero avere entrambi file di simboli denominati myprogram.pdb, ma questi file di simboli verranno inseriti in sottodirectory diverse.

Esiste un'eccezione a questo algoritmo. If neither -s nor -n is supplied, the full symbol files will be placed in the same location as the binaries.

Note If you list the symbol file name in BinPlace's command line, BinPlace will move it like any other file and will not examine its contents. Per usare le tecniche di manipolazione dei file di simboli di BinPlace, è necessario elencare il nome del file eseguibile, non il nome del file di simboli.