Sintassi della riga di comando binPlace

BinPlace usa la sintassi seguente nella riga di comando:

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

Parametri

Opzioni
Ciò può includere una delle opzioni seguenti. Le opzioni devono essere precedute da un trattino (-) o da una barra (/). È possibile combinare diverse opzioni dopo un trattino o una barra, ma le opzioni che accettano parametri aggiuntivi devono essere seguite da uno spazio. Di conseguenza, i due comandi seguenti sono equivalenti:

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

Sono disponibili i seguenti switch:

-a
Fa sì che BinPlace estrae i simboli privati dai file di simboli quando vengono posizionati. In questo modo vengono creati file di simboli rimossi che contengono simboli pubblici, ma non simboli privati. Quando si usa l'opzione -a , è necessario usare anche -s e -x . Quando si usa -a , i file di simboli rimossi verranno inseriti nel percorso specificato da -sSymbolRoot. Se è presente anche -nFullSymbolRoot , i file di simboli completi verranno inseriti in FullSymbolRoot. In caso contrario, non verranno posizionati da nessuna parte.

-b ExtraSubdirectory
Fa sì che BinPlace inserisca i file in un percorso diverso rispetto al solito. Dopo aver concatenato la directory di destinazione radice, la sottodirectory della classe e la sottodirectory di tipo file come di consueto, BinPlace aggiungerà quindi ExtraSubdirectory a questo percorso per creare la directory di destinazione finale. ExtraSubdirectory non deve iniziare con né terminare con una barra rovesciata. Per altri dettagli, vedere Directory di destinazione BinPlace.

-e
Fa sì che BinPlace continui l'esecuzione se non è possibile inserire un file. Per impostazione predefinita, BinPlace verrà chiuso quando si verifica questo errore.

-f
Forza BinPlace a inserire un file anche se sovrascrive un file più recente. Per impostazione predefinita, quando BinPlace tenta di inserire un file, sovrascriverà una versione precedente ma non sovrascriverà una versione più recente.

-g LCFile
Fa sì che BinPlace verifichi il file eseguibile. LCFile specifica il file di vincolo di localizzazione da usare per questa verifica.

-h
Fa sì che BinPlace crei collegamenti rigidi anziché copiare il file durante l'inserimento dei file. Questa opzione è disponibile solo nel file system NTFS.

-j
Fa sì che BinPlace verifichi che i simboli appropriati esistano prima di copiare i file eseguibili. Per usare questa opzione, lo strumento SymChk deve trovarsi nel percorso. SymChk fa parte del pacchetto Strumenti di debug per Windows. Per informazioni dettagliate, vedere Debug di Windows.

-k
Fa sì che BinPlace mantenga gli attributi del file. Per impostazione predefinita, BinPlace disattiva l'attributo archive.

-n FullSymbolRoot
Specifica la directory radice per i file di simboli completi (file di simboli che contengono simboli sia pubblici che privati). Ciò richiede anche le opzioni -a, -x e -s . Per altri dettagli, vedere Directory di destinazione BinPlace.

-o RootSubdirectory
Specifica una sottodirectory della directory di destinazione radice da utilizzare. Quando viene creata la directory di destinazione, RootSubdirectory verrà inserita dopo la directory di destinazione radice e prima della sottodirectory della classe. Per altri dettagli, vedere Directory di destinazione BinPlace.

-p PlaceFile
Specifica il percorso e il nome file del file di posizione. Se l'opzione -p non viene usata, BinPlace usa una posizione denominata \tools\placefil.txt. Per una spiegazione del contenuto di un file di posizione, vedere Inserire la sintassi dei file.

Nota L'opzione -p e il posto dei file sono ora obsoleti e non devono essere usati.

-q
Impedisce a BinPlace di usare un file di log. Se l'opzione -q viene omessa, il file specificato dalla variabile di ambiente BINPLACE_LOG viene usato come file di log.

-r RootDestinationPath
Specifica la directory di destinazione radice. 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. Per informazioni dettagliate, vedere Directory di destinazione binPlace.

-s SymbolRoot
Specifica la directory radice per i file di simboli. Se vengono usate anche le opzioni -a e -x, i simboli privati verranno rimossi dai file di simboli e i file di simboli rimossi verranno inseriti nella directory specificata da SymbolRoot. Se vuoi inserire sia i file di simboli rimossi che completi, devi usare -a -x -s SymbolRoot -n FullSymbolRoot. Per altri dettagli, vedere Directory di destinazione BinPlace.

-t
Modalità test. Quando si usa questa opzione, non verranno copiati file, ma BinPlace visualizzerà i messaggi di avviso e di errore come se fossero stati posizionati file. È possibile usare anche l'opzione -v per aumentare il numero di messaggi.

-u
Fa sì che BinPlace accoda \fino alla sottodirectory della classe. Ciò è utile per separare i driver uniprocessor (UP). Inoltre, ogni volta che viene usata questa opzione, BinPlace non dividerà i file eseguibili contenenti simboli. Per altri dettagli, vedere Directory di destinazione BinPlace.

-v
Modalità dettagliata. Fa sì che BinPlace visualizzi messaggi di errore, avviso e stato più dettagliati.

-w
Fa sì che BinPlace aggiunga i file di simboli di Windows 95 (con estensione sym) all'albero dei simboli.

-x
Se BinPlace rileva file che usano il vecchio sistema di simboli, questa opzione comporta la rimozione di tutti i simboli dai file eseguibili e lo spostamento in file di simboli separati. Per informazioni dettagliate, vedere File system di simboli. Quando si usa l'opzione -x , è necessario usare anche -s e -a .

-y
Impedisce a BinPlace di usare qualsiasi sottodirectory di classe. La directory di destinazione verrà creata esclusivamente dalla directory di destinazione radice e dalla sottodirectory di tipo file. Per informazioni dettagliate, vedere Directory di destinazione binPlace.

-z
Annulla l'opzione -x . Ciò può essere utile se si usa BinPlace in diverse destinazioni: è possibile usare un comando degli argomenti binplace del moduloTarget1argumentsTarget2 e poiché la riga di comando viene analizzata da sinistra a destra, Target1 e Target2 saranno influenzati da argomenti diversi. Vedere la sezione Parsing Order (Ordine di analisi) riportata di seguito. Se viene rilevata un'opzione -z, questo annulla l'effetto di qualsiasi opzione -x precedente.

-ci ReturnCode,Application,Argument,Argument, ...
Fa sì che BinPlace usi un'applicazione personalizzata per convalidare tutti i file eseguibili. È possibile usare l'opzione -ci se si vuole che BinPlace usi un'altra applicazione per eseguire la convalida.

ReturnCode deve essere il valore che verrà restituito dall'applicazione se rileva un errore in un file eseguibile. I parametri aggiuntivi vengono usati per avviare questa applicazione. Questi devono essere separati da virgole. L'applicazione specifica il nome del programma. Questo può essere seguito da un numero qualsiasi di argomenti della riga di comando. Il programma verrà avviato con una riga di comando che include Application seguito da tutti gli argomenti (separati da spazi anziché da virgole) e infine terminando con il nome del file eseguibile da controllare.

-:ARCO
Fa sì che BinPlace inserisca solo i file i cui attributi di archivio sono impostati.

-:D BG
Impedisce a BinPlace di inserire file con estensione dbg. Se viene usata anche l'opzione -j , ciò impedirà a BinPlace di posizionare file binari che puntano ai file con estensione dbg. Per usare questa opzione, lo strumento SymChk deve trovarsi nel percorso. SymChk fa parte del pacchetto Strumenti di debug per Windows. Per informazioni dettagliate, vedere Debug di Windows.

-:D EST ClassPath
Fa sì che BinPlace ignori il file di posizione e usi classPath specificato come sottodirectory della classe. Per informazioni dettagliate, vedere Directory di destinazione binPlace.

-:LOGPDB
Fa sì che BinPlace includa i percorsi con estensione pdb completi nel file di log.

-:REN NewName
Fa sì che BinPlace rinomina i file inseriti. Il nome del file originale, inclusa l'estensione, verrà sostituito da NewName. Se il file originale è un file eseguibile da dividere, al nuovo file di simboli verrà assegnato il nome del file originale più l'estensione dbg.

-:TMF
Fa sì che BinPlace crei un file di formato di messaggio di traccia (con estensione tmf) estraendo le istruzioni di formattazione dei messaggi di traccia dal file di simboli PDB. Il file TMF verrà inserito nella directory specificata dalla variabile di ambiente binPlace TRACE_FORMAT_PATH. Vedere Macro binPlace e variabili di ambiente.

-ChangeAsmsToRetailForSymbols
Fa sì che BinPlace sostituisca la stringa "asms" con la stringa "retail" se si verifica nella directory di destinazione per i file di simboli. Per altri dettagli, vedere Directory di destinazione BinPlace.

File
Specifica il percorso completo e il nome file di un file su cui Verrà usato BinPlace. È possibile elencare un numero qualsiasi di file, separati da spazi. Se un percorso e un nome file contengono uno spazio, è necessario racchiudere il percorso e il nome del file tra virgolette.

@PlaceFile
Se un nome di file è preceduto da un segno ( @ ), il nome del file rappresenta il nome di un file di posizione. Per altre informazioni, vedere la sezione Specifica dei parametri in un file riportata di seguito.

Analisi dell'ordine

BinPlace analizza la riga di comando da sinistra a destra. È possibile specificare diverse opzioni, quindi un parametro File , quindi nuove opzioni, un altro parametro File e così via. Ogni volta che BinPlace incontra una nuova opzione, verrà adottata, ignorando qualsiasi opzione precedentemente vista contraddittoria. Ogni volta che rileva un identificatore di file , agisce su tale file usando le opzioni accumulate già rilevate nella riga di comando.

Specifica di parametri in un file

È possibile passare parametri a BinPlace da un file di testo. A questo scopo è possibile procedere in due modi:

• È possibile specificare un nome file nella variabile di ambiente BINPLACE_OVERRIDE_FLAGS. Questo file verrà letto e il relativo contenuto viene usato come parametri ogni volta che viene eseguito BinPlace. I parametri in questo file verranno analizzati prima dei parametri effettivamente visualizzati nella riga di comando di BinPlace.

• È possibile specificare un nome file nella riga di comando di BinPlace anteponendolo a un segno ( @ ). Quando BinPlace vede una stringa che inizia con questo segno sulla riga di comando, accetta la stringa, rimuove il segno at e quindi cerca un file con questo nome. Se trova questo file, il testo verrà inserito nella riga di comando esattamente nella posizione in cui il parametro originale che inizia con il segno di corrispondenza. Poiché BinPlace analizza i parametri da sinistra a destra, è possibile usare questa tecnica insieme a più istanze di File per usare BinPlace in diversi file con opzioni diverse per ognuna, senza dover digitare tutte le opzioni ogni volta. (Se questo file non viene trovato, BinPlace considererà la stringa originale, incluso il segno, come Parametro del file .