Ausführen von LIB
Verschiedene Befehlszeilenoptionen können zum Steuern der LIB verwendet werden.
LIB-Befehlszeile
Geben Sie zum Ausführen von LIB den Befehl libein, gefolgt von den Optionen und Dateinamen für die Aufgabe, für die Sie LIB verwenden. LIB akzeptiert auch Befehlszeileneingaben in Befehlsdateien, die im folgenden Abschnitt beschrieben werden. LIB verwendet keine Umgebungsvariable.
LIB-Befehlsdateien
Sie können Befehlszeilenargumente mithilfe der folgenden Syntax an LIB in einer Befehlsdatei übergeben:
LIB @command-file
Die Dateibefehlsdatei ist eine Textdatei. Es sind keine Leerzeichen oder Registerkarten zwischen dem At-Zeichen (@) und dem Dateinamen zulässig. Der Name der Befehlsdatei hat keine Standarderweiterung. Geben Sie den vollständigen Dateinamen an, einschließlich einer beliebigen Erweiterung. Wildcards können nicht verwendet werden. Sie können einen absoluten oder relativen Pfad mit dem Dateinamen angeben.
In der Befehlsdatei können Argumente durch Leerzeichen oder Tabstopps getrennt werden, wie sie in der Befehlszeile möglich sind. Argumente können auch durch Zeilenumbruchzeichen getrennt werden. Verwenden Sie ein Semikolon (;), um einen Kommentar zu markieren. LIB ignoriert den gesamten Text vom Semikolon bis zum Ende der Zeile.
Sie können entweder alle oder einen Teil der Befehlszeile in einer Befehlsdatei angeben, und Sie können mehrere Befehlsdateien in einem LIB-Befehl verwenden. LIB akzeptiert die Befehlsdateieingabe, als ob sie an diesem Speicherort in der Befehlszeile angegeben ist. Befehlsdateien können nicht geschachtelt werden. LIB gibt den Inhalt von Befehlsdateien an, es sei denn, die Option "/NOLOGO " wird verwendet.
Verwenden von LIB-Optionen
Eine Option besteht aus einem Optionsbezeichner, der entweder einen Gedankenstrich (-) oder einen Schrägstrich (/) gefolgt vom Namen der Option ist. Optionsnamen können nicht abgekürzt werden. Einige Optionen verwenden ein Argument, das nach einem Doppelpunkt (:) angegeben wurde. Innerhalb einer Optionsangabe sind keine Leerzeichen oder Tabstopps zulässig. Verwenden Sie eines oder mehrere Leerzeichen bzw. Tabstopps, um Optionsangaben in der Befehlszeile voneinander zu trennen. Bei Optionsnamen und deren Schlüsselwort- oder Dateinamenargumenten wird die Groß-/Kleinschreibung nicht beachtet. Bei Bezeichnern, die als Argumente verwendet werden, wird die Groß-/Kleinschreibung beachtet. LIB verarbeitet Optionen in der reihenfolge, die in der Befehlszeile und in Befehlsdateien angegeben ist. Wenn eine Option mit unterschiedlichen Argumenten wiederholt wird, hat die letzte zu verarbeitende Option Vorrang.
Die folgenden Optionen gelten für alle Lib-Modi:
/ERRORREPORT [KEINE | EINGABEAUFFORDERUNGSWARTESCHLANGE | | SENDEN]
Die Option /ERRORREPORT ist veraltet. Ab Windows Vista wird die Fehlerberichterstattung durch Windows-Fehlerberichterstattung (WER)-Einstellungen gesteuert.
/LINKREPRO:directory-path
/LINKREPROTARGET:filename
Um Microsoft bei der Diagnose von lib.exe Abstürze und internen Fehlern zu unterstützen, können Sie die Option "/LINKREPRO " verwenden. Diese Option generiert einen Link-Repro, eine Reihe von Buildartefakten, mit denen Microsoft ein Problem reproduzieren kann, das während Bibliotheksvorgängen auftritt. Die Option "/LINKREPROTARGET " kann mit der Option "/LINKREPRO" verwendet werden. Es generiert nur Verknüpfungsartefakte, wenn lib.exe die angegebene Datei erzeugt. Weitere Informationen finden Sie unter "So wird's gemacht: Melden eines Problems mit dem Microsoft C++-Toolset".
/LTCG
"LTCG" steht für die Generierung von Linkzeitcode. Dieses Feature erfordert die Zusammenarbeit zwischen dem Compiler (cl.exe), der LIB und dem Linker (LINK). Gemeinsam können sie Code über das, was jede Komponente selbst tun kann, optimieren.
Die /LTCG-Option für LIB gibt an, dass die Eingaben aus cl.exe objektdateien enthalten, die mit der /GL-Compileroption generiert werden. Wenn LIB auf solche Eingaben trifft und /LTCG nicht angegeben ist, wird sie nach dem Anzeigen einer Informationsmeldung neu gestartet, wobei /LTCG aktiviert ist. Mit anderen Worten, es ist nicht erforderlich, diese Option explizit festzulegen, aber es beschleunigt die Buildleistung. Das liegt daran, dass LIB nicht selbst neu gestartet werden muss.
Im Buildprozess wird die Ausgabe von LIB an LINK gesendet. LINK verfügt über eine eigene separate /LTCG-Option . Es wird verwendet, um verschiedene Optimierungen durchzuführen, einschließlich der Optimierung des gesamten Programms und der profilgeführten Optimierung (PGO). Weitere Informationen zur LINK-Option finden Sie unter /LTCG.
/MACHINE
Gibt die Zielplattform für das Programm an. In der Regel müssen Sie /MACHINE nicht angeben. LIB leitet den Computertyp aus den .obj-Dateien ab. Unter bestimmten Umständen kann LIB jedoch nicht den Computertyp bestimmen und eine Fehlermeldung ausgibt. Wenn ein solcher Fehler auftritt, geben Sie /MACHINE an. Im /EXTRACT-Modus ist diese Option nur für die Überprüfung vorgesehen. Verwenden Sie lib /? die Befehlszeile, um die verfügbaren Computertypen anzuzeigen.
/NOLOGO
Unterdrückt die Anzeige der LIB Copyright-Nachricht und Versionsnummer und verhindert das Echo von Befehlsdateien.
/VERBOSE
Zeigt Details zum Fortschritt der Sitzung an, einschließlich der Namen der hinzugefügten .obj Dateien. Die Informationen werden an die Standardausgabe gesendet und können in eine Datei umgeleitet werden.
/WX[:NO]
Warnungen als Fehler behandeln. Weitere Informationen finden Sie unter /WX (Linkerwarnungen als Fehler behandeln).
Andere Optionen gelten nur für bestimmte Lib-Modi. Diese Optionen werden in den Abschnitten erläutert, in denen jeder Modus beschrieben wird.