| title | Running LIB | Microsoft Docs | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ms.custom | |||||||||||||||||||
| ms.date | 09/24/2018 | ||||||||||||||||||
| ms.technology |
|
||||||||||||||||||
| ms.topic | reference | ||||||||||||||||||
| f1_keywords |
|
||||||||||||||||||
| dev_langs |
|
||||||||||||||||||
| helpviewer_keywords |
|
||||||||||||||||||
| ms.assetid | d54f5c81-7147-4b2c-a8db-68ce6eb1eabd | ||||||||||||||||||
| author | corob-msft | ||||||||||||||||||
| ms.author | corob | ||||||||||||||||||
| ms.workload |
|
Various command-line options can be used to control LIB.
To run LIB, type the command lib followed by the options and file names for the task you are using LIB to perform. LIB also accepts command-line input in command files, which are described in the following section. LIB does not use an environment variable.
Note
If you are accustomed to the LINK32.exe and LIB32.exe tools provided with the Microsoft Win32 Software Development Kit for Windows NT, you may have been using either the command link32 -lib or the command lib32 for managing libraries and creating import libraries. Be sure to change your makefiles and batch files to use the lib command instead.
You can pass command-line arguments to LIB in a command file using the following syntax:
LIB @commandfile
The file commandfile is a text file. No space or tab is allowed between the at sign (@) and the file name. There is no default extension; you must specify the full file name, including any extension. Wildcards cannot be used. You can specify an absolute or relative path with the file name.
In the command file, arguments can be separated by spaces or tabs, as they can on the command line; they can also be separated by newline characters. Use a semicolon (;) to mark a comment. LIB ignores all text from the semicolon to the end of the line.
You can specify either all or part of the command line in a command file, and you can use more than one command file in a LIB command. LIB accepts the command-file input as if it were specified in that location on the command line. Command files cannot be nested. LIB echoes the contents of command files unless the /NOLOGO option is used.
An option consists of an option specifier, which is either a dash ( - ) or a forward slash ( / ), followed by the name of the option. Option names cannot be abbreviated. Some options take an argument, specified after a colon (:). No spaces or tabs are allowed within an option specification. Use one or more spaces or tabs to separate option specifications on the command line. Option names and their keyword or file name arguments are not case sensitive, but identifiers used as arguments are case sensitive. LIB processes options in the order specified on the command line and in command files. If an option is repeated with different arguments, the last one to be processed takes precedence.
The following options apply to all modes of LIB:
/ERRORREPORT [NONE | PROMPT | QUEUE | SEND]
If lib.exe fails at runtime, you can use /ERRORREPORT to send information to Microsoft about these internal errors.
For more information about /ERRORREPORT, see /errorReport (Report Internal Compiler Errors).
/LTCG
"LTCG" stands for link-time code generation which enables build optimizations and requires cooperation between the compiler (cl.exe), LIB, and the linker (LINK). Use this option to tell LIB that the inputs from cl.exe include object files that were generated by using the /GL compiler option. (If LIB.exe encounters such inputs and /LTCG is not specified, it will restart with /LTCG enabled after displaying an informational message.) In the build process, the output from LIB is sent to LINK, which has its own separate /LTCG option which is used to perform various optimizations include whole-program optimization, and profile-guided optimization (PGO) instrumentation. (See /LTCG for more information about the LINK option.)
/MACHINE
Specifies the target platform for the program. Usually, you do not need to specify /MACHINE. LIB infers the machine type from the .obj files. However, in some circumstances, LIB cannot determine the machine type and issues an error message. If such an error occurs, specify /MACHINE. In /EXTRACT mode, this option is for verification only. Use lib /? at the command line to see available machine types.
/NOLOGO
Suppresses display of the LIB copyright message and version number and prevents echoing of command files.
/VERBOSE
Displays details about the progress of the session, including names of the .obj files being added. The information is sent to standard output and can be redirected to a file.
/WX[:NO]
Treat warnings as errors. See /WX (Treat Linker Warnings as Errors) for more information.
Other options apply only to specific modes of LIB. These options are discussed in the sections describing each mode.