Freigeben über

BinPlace-Befehlszeilensyntax

  • Artikel

BinPlace verwendet die folgende Syntax in der Befehlszeile:

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

Parameter

Optionen
Dies kann eine der folgenden Optionen umfassen. Den Schaltern sollte ein Bindestrich (-) oder ein Schrägstrich (/) vorangestellt werden. Es ist möglich, mehrere Optionen nach einem Bindestrich oder Schrägstrich zu kombinieren, aber Optionen mit zusätzlichen Parametern sollten durch ein Leerzeichen gefolgt werden. Somit sind die folgenden beiden Befehle gleichwertig:

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

Die folgenden Schalter sind verfügbar:

-a
Bewirkt, dass BinPlace private Symbole aus den Symboldateien entfernt, wenn sie platziert werden. Dadurch werden entfernte Symboldateien erstellt, die öffentliche Symbole, aber keine privaten Symbole enthalten. Bei Verwendung des Schalters -a müssen Sie auch -s und -x verwenden. Wenn -a verwendet wird, werden stripped-Symboldateien in dem pfad platziert, der durch -sSymbolRoot angegeben wird. Wenn "-nFullSymbolRoot " ebenfalls vorhanden ist, werden die vollständigen Symboldateien in FullSymbolRoot platziert. Andernfalls werden sie nicht überall platziert.

-b ExtraSubdirectory
Bewirkt, dass BinPlace Dateien an einem anderen Speicherort als üblich platziert. Nach der Verkettung des Stammzielverzeichnisses, des Klassenunterverzeichnisses und des Dateityp-Unterverzeichnisses wie gewohnt fügt BinPlace an diesen Pfad extraSubdirectory an, um das endgültige Zielverzeichnis zu erstellen. ExtraSubdirectory sollte weder mit noch mit einem umgekehrten Schrägstrich enden. Weitere Details finden Sie unter "BinPlace-Zielverzeichnisse ".

-e
Bewirkt, dass BinPlace die Ausführung fortsetzen kann, wenn eine Datei nicht platziert werden kann. Standardmäßig wird BinPlace beendet, wenn dieser Fehler auftritt.

-f
Erzwingt BinPlace, eine Datei zu platzieren, auch wenn eine neuere Datei überschrieben wird. Wenn BinPlace versucht, eine Datei zu platzieren, wird standardmäßig eine ältere Version überschrieben, aber keine neuere Version überschrieben.

-g LCFile
Bewirkt, dass BinPlace die ausführbare Datei überprüft. LCFile gibt die Lokalisierungseinschränkungsdatei an, die für diese Überprüfung verwendet werden soll.

-h
Bewirkt, dass BinPlace feste Verknüpfungen erstellt, anstatt die Datei beim Platzieren von Dateien zu kopieren. Diese Option ist nur im NTFS-Dateisystem verfügbar.

-j
Bewirkt, dass BinPlace überprüft, ob die richtigen Symbole vorhanden sind, bevor sie ausführbare Dateien kopieren. Damit diese Option verwendet werden kann, muss sich das SymChk-Tool in Ihrem Pfad befinden. (SymChk ist Teil des Debugtools für Windows-Pakets. Weitere Informationen finden Sie unter Windows Debugging .)

-k
Bewirkt, dass BinPlace Dateiattribute behält. Standardmäßig deaktiviert BinPlace das Archiv-Attribut.

-n FullSymbolRoot
Gibt das Stammverzeichnis für vollständige Symboldateien an (Symboldateien, die sowohl öffentliche als auch private Symbole enthalten). Dies erfordert auch die Schalter "-a", "-x" und "-s ". Weitere Details finden Sie unter "BinPlace-Zielverzeichnisse ".

-o RootSubdirectory
Gibt ein Unterverzeichnis des zu verwendenden Stammzielverzeichnisses an. Wenn das Zielverzeichnis erstellt wird, wird rootSubdirectory nach dem Stammzielverzeichnis und vor dem Klassenunterverzeichnis eingefügt. Weitere Details finden Sie unter "BinPlace-Zielverzeichnisse ".

-p PlaceFile
Gibt den Pfad und Dateinamen der Ortsdatei an. Wenn der Schalter "-p " nicht verwendet wird, verwendet BinPlace einen Ort namens "\tools\placefil.txt". Unter "Dateisyntax platzieren" finden Sie eine Erläuterung des Inhalts einer Ortsdatei.

Hinweis : Der Switch -p und die Speicherortdateien sind jetzt veraltet und sollten nicht verwendet werden.

-q
Verhindert, dass BinPlace eine Protokolldatei verwendet. Wenn der Switch -q ausgelassen wird, wird die durch die BINPLACE_LOG Umgebungsvariable angegebene Datei als Protokolldatei verwendet.

-r RootDestinationPath
Gibt das Stammzielverzeichnis an. Wenn dies nicht angegeben wird, wird der Standardwert durch die _NT386TREE, _NTIA64TREE oder _NTAMD64TREE Umgebungsvariable auf einem x86-basierten, Itanium- oder x64-basierten Computer bestimmt. Details finden Sie unter "BinPlace-Zielverzeichnisse ".

-s SymbolRoot
Gibt das Stammverzeichnis für Symboldateien an. Wenn die Schalter "-a " und "-x " ebenfalls verwendet werden, werden private Symbole aus den Symboldateien entfernt, und die entfernten Symboldateien werden in dem verzeichnis platziert, das von SymbolRoot angegeben wird. Wenn Sie sowohl stripped- als auch vollständige Symboldateien platzieren möchten, sollten Sie -a -x -s SymbolRoot -n FullSymbolRoot verwenden. Weitere Details finden Sie unter "BinPlace-Zielverzeichnisse ".

-t
Testmodus. Wenn diese Option verwendet wird, werden keine Dateien kopiert, aber BinPlace zeigt Warnungen und Fehlermeldungen an, als würden Sie Dateien platzieren. Möglicherweise möchten Sie auch die Option "-v " verwenden, um die Anzahl der Nachrichten zu erhöhen.

-u
Bewirkt, dass BinPlace \up an das Unterverzeichnis der Klasse anzufügen. Dies ist nützlich zum Trennen von Uniprocessortreibern (UP). Wenn dieser Schalter verwendet wird, teilt BinPlace außerdem keine ausführbaren Dateien mit Symbolen auf. Weitere Details finden Sie unter "BinPlace-Zielverzeichnisse ".

-v
Ausführlicher Modus. Bewirkt, dass BinPlace detailliertere Fehler-, Warnungs- und Statusmeldungen anzeigt.

-w
Bewirkt, dass BinPlace der Symbolstruktur Windows 95-Symboldateien (.sym) hinzu fügt.

-x
Wenn BinPlace auf Dateien trifft, die das alte Symbolsystem verwenden, bewirkt diese Option, dass alle Symbole aus den ausführbaren Dateien entfernt und diese Informationen in separate Symboldateien verschoben werden. Details finden Sie unter Symbol File Systems . Wenn Sie den Schalter -x verwenden, müssen Sie auch -s und -a verwenden.

-y
Verhindert, dass BinPlace Klassenunterverzeichnisse verwendet. Das Zielverzeichnis wird ausschließlich aus dem Stammzielverzeichnis und dem Unterverzeichnis des Dateityps erstellt. Details finden Sie unter "BinPlace-Zielverzeichnisse ".

-z
Bricht den Schalter -x ab. Dies kann nützlich sein, wenn Sie BinPlace für mehrere Ziele verwenden . Sie können einen Befehl der Form binplace-ArgumenteTarget1argumenteTarget2 verwenden, und da die Befehlszeile von links nach rechts analysiert wird, wird Target1 und Target2 von verschiedenen Argumenten beeinflusst. (Weitere Informationen finden Sie im Folgenden im Abschnitt "Parsing Order"). Wenn ein -z-Schalter gefunden wird, wird dadurch die Auswirkung eines vorherigen -x-Schalters abgebrochen.

-ci ReturnCode,Application,Argument, ...
Bewirkt, dass BinPlace eine benutzerdefinierte Anwendung verwendet, um alle ausführbaren Dateien zu überprüfen. Sie können die Option "-ci " verwenden, wenn BinPlace eine andere Anwendung zur Überprüfung verwenden soll.

ReturnCode sollte der Wert sein, der von dieser Anwendung zurückgegeben wird, wenn ein Fehler in einer ausführbaren Datei gefunden wird. Die zusätzlichen Parameter werden verwendet, um diese Anwendung zu starten. Diese müssen alle durch Kommas getrennt werden. Die Anwendung gibt den Namen des Programms an. Auf diese Weise kann eine beliebige Anzahl von Befehlszeilenargumenten gefolgt werden. Das Programm wird mit einer Befehlszeile gestartet, die Die Anwendung gefolgt von allen Argumenten enthält (getrennt durch Leerzeichen und nicht durch Kommas) und schließlich mit dem Namen der ausführbaren Datei, die überprüft werden soll.

-:BOGEN
Bewirkt, dass BinPlace nur Dateien platziert, deren Archivattribute festgelegt sind.

-:D BG
Verhindert, dass BinPlace DBG-Dateien platziert. Wenn die Option "-j " auch verwendet wird, wird dadurch verhindert, dass BinPlace BinPlace Binärdateien platziert, die auf DBG-Dateien verweisen. Damit diese Option verwendet werden kann, muss sich das SymChk-Tool in Ihrem Pfad befinden. (SymChk ist Teil des Debugtools für Windows-Pakets. Weitere Informationen finden Sie unter Windows Debugging .)

-:D EST ClassPath
Bewirkt, dass BinPlace die Ortsdatei ignoriert und den angegebenen ClassPath als Unterverzeichnis der Klasse verwendet. Details finden Sie unter "BinPlace-Zielverzeichnisse ".

-:LOGPDB
Bewirkt, dass BinPlace die vollständigen PDB-Pfade in die Protokolldatei einschließt.

-:REN NewName
Bewirkt, dass BinPlace die gespeicherten Dateien umbenennen. Der ursprüngliche Dateiname, einschließlich der Erweiterung, wird durch NewName ersetzt. (Wenn es sich bei der Originaldatei um eine ausführbare Datei handelt, die geteilt wird, erhält die neue Symboldatei den ursprünglichen Dateinamen sowie die Erweiterung DBG.)

-:TMF
Bewirkt, dass BinPlace eine Nachrichtenformatdatei (.tmf) erstellt, indem Anweisungen zur Formatierung von Ablaufverfolgungsmeldungen aus der PDB-Symboldatei extrahiert werden. Die TMF-Datei wird in das verzeichnis eingefügt, das durch die BinPlace-TRACE_FORMAT_PATH Umgebungsvariable angegeben wird. Siehe BinPlace-Makros und Umgebungsvariablen.

-ChangeAsmsToRetailForSymbols
Bewirkt, dass BinPlace die Zeichenfolge "asms" durch die Zeichenfolge "retail" ersetzt, wenn sie im Zielverzeichnis für Symboldateien auftritt. Weitere Details finden Sie unter "BinPlace-Zielverzeichnisse ".

Datei
Gibt den vollständigen Pfad und Dateinamen einer Datei an, auf die BinPlace reagiert. Sie können eine beliebige Anzahl von Dateien auflisten, getrennt durch Leerzeichen. Wenn ein Pfad und Dateiname ein Leerzeichen enthält, müssen Sie den Pfad und dateinamen in Anführungszeichen setzen.

@PlaceFile
Wenn einem Dateinamen ein At-Zeichen ( @ ) vorangestellt ist, stellt der Dateiname den Namen einer Ortsdatei dar. Weitere Informationen finden Sie in den folgenden Abschnitten zum Bereitstellen von Parametern in einem Dateiabschnitt.

Analysereihenfolge

BinPlace analysiert die Befehlszeile von links nach rechts. Sie können mehrere Optionen, dann einen Dateiparameter , dann neue Optionen, dann einen anderen Dateiparameter usw. angeben. Jedes Mal, wenn BinPlace auf eine neue Option trifft, wird sie übernommen, wobei alle zuvor gesehenen widersprüchlichen Optionen außer Kraft gesetzt werden. Immer wenn ein Dateibezeichner auftritt, handelt es sich um diese Datei, indem sie die angesammelten Optionen verwendet, die sie bereits in der Befehlszeile gefunden hat.

Angeben von Parametern in einer Datei

Es ist möglich, Parameter aus einer Textdatei an BinPlace zu übergeben. Hierfür gibt es zwei Möglichkeiten:

  • Sie können einen Dateinamen in der umgebungsvariablen BINPLACE_OVERRIDE_FLAGS angeben. Diese Datei wird gelesen und der Inhalt wird immer dann als Parameter verwendet, wenn BinPlace ausgeführt wird. Die Parameter in dieser Datei werden vor den Parametern analysiert, die tatsächlich in der BinPlace-Befehlszeile angezeigt werden.

  • Sie können einen Dateinamen in der BinPlace-Befehlszeile angeben, indem Sie ihn mit einem At-Zeichen ( @ ) voranstellen. Wenn BinPlace eine Zeichenfolge sieht, die mit diesem Zeichen in der Befehlszeile beginnt, nimmt sie die Zeichenfolge, entfernen Sie das At-Zeichen, und suchen Sie dann nach einer Datei mit diesem Namen. Wenn sie diese Datei findet, fügt sie den Text genau an der Stelle ein, an der der ursprüngliche Parameter beginnt, der mit dem At-Zeichen beginnt. Da BinPlace Parameter von links nach rechts analysiert, können Sie diese Technik zusammen mit mehreren Instanzen von "Datei " für mehrere Dateien mit verschiedenen Optionen verwenden, ohne jedes Mal alle Optionen eingeben zu müssen. (Wenn diese Datei nicht gefunden wird, behandelt BinPlace die ursprüngliche Zeichenfolge, einschließlich des At-Zeichens, als Dateiparameter .)