LIB task
Note
This task is only available when using the C++ build system.
Wraps the Microsoft 32-Bit Library Manager tool, lib.exe. The Library Manager creates and manages a library of Common Object File Format (COFF) object files. The Library Manager can also create export files and import libraries to reference exported definitions. For more information, see LIB reference and Running LIB.
Parameters
The following table describes the parameters of the LIB task. Most task parameters correspond to a command-line option.
| Parameter | Description |
|---|---|
| AdditionalDependencies | Optional String[] parameter. Specifies additional items to add to the command line. |
| AdditionalLibraryDirectories | Optional String[] parameter. Overrides the environment library path. Specify a directory name. For more information, see /LIBPATH (Additional Libpath). |
| AdditionalOptions | Optional String parameter. A list of lib.exe options as specified on the command line. For example, /<option1> /<option2> /<option#>. Use this parameter to specify lib.exe options that are not represented by any other LIB task parameter. For more information, see Running LIB. |
| DisplayLibrary | Optional String parameter. Displays information about the output library. Specify a file name to redirect the information to a file. Specify "CON" or nothing to redirect the information to the console. This parameter corresponds to the /LIST option of lib.exe. |
| ErrorReporting | Optional String parameter. Specifies how to send internal error information to Microsoft if lib.exe fails at run time. Specify one of the following values, each of which corresponds to a command-line option. - NoErrorReport - /ERRORREPORT:NONE - PromptImmediately - /ERRORREPORT:PROMPT - QueueForNextLogin - /ERRORREPORT:QUEUE - SendErrorReport - /ERRORREPORT:SEND For more information, see the /ERRORREPORT command-line option at Running LIB. |
| ExportNamedFunctions | Optional String[] parameter. Specifies one or more functions to export. This parameter corresponds to the /EXPORT: option of lib.exe. |
| ForceSymbolReferences | Optional String parameter. Forces lib.exe to include a reference to the specified symbol. This parameter corresponds to the /INCLUDE: option of lib.exe. |
| IgnoreAllDefaultLibraries | Optional Boolean parameter.If true, removes all default libraries from the list of libraries that lib.exe searches when it resolves external references.This parameter corresponds to the parameter-less form of the /NODEFAULTLIB option of lib.exe. |
| IgnoreSpecificDefaultLibraries | Optional String[] parameter. Removes the specified libraries from the list of libraries that lib.exe searches when it resolves external references. This parameter corresponds to the /NODEFAULTLIB option of lib.exe that takes a library argument. |
| LinkLibraryDependencies | Optional Boolean parameter.If true, specifies that library outputs from project dependencies are automatically linked in. |
| LinkTimeCodeGeneration | Optional Boolean parameter.If true, specifies link-time code generation.This parameter corresponds to the /LCTG option of lib.exe. |
| MinimumRequiredVersion | Optional String parameter. Specifies the minimum required version of the subsystem. Specify a comma-delimited list of decimal numbers in the range 0 through 65535. |
| ModuleDefinitionFile | Optional String parameter. Specifies the name of the module-definition file (.def). This parameter corresponds to the /DEF option of lib.exe that takes a filename argument. |
| Name | Optional String parameter. When an import library is built, specifies the name of the DLL for which the import library is being built. This parameter corresponds to the /NAME option of lib.exe that takes a filename argument. |
| OutputFile | Optional String parameter. Overrides the default name and location of the program that lib.exe creates. This parameter corresponds to the /OUT option of lib.exe that takes a filename argument. |
| RemoveObjects | Optional String[] parameter. Omits the specified object from the output library. Lib.exe creates an output library by combining all objects (whether in object files or libraries), and then deleting any objects that are specified by this option. This parameter corresponds to the /REMOVE option of lib.exe that takes a membername argument. |
| Sources | Required ITaskItem[] parameter.Specifies a list of source files separated by spaces. |
| SubSystem | Optional String parameter. Specifies the environment for the executable. The choice of subsystem affects the entry point symbol or entry point function. Specify one of the following values, each of which corresponds to a command-line option. - Console - /SUBSYSTEM:CONSOLE - Windows - /SUBSYSTEM:WINDOWS - Native - /SUBSYSTEM:NATIVE - EFI Application - /SUBSYSTEM:EFI_APPLICATION - EFI Boot Service Driver - /SUBSYSTEM:EFI_BOOT_SERVICE_DRIVER - EFI ROM - /SUBSYSTEM:EFI_ROM - EFI Runtime - /SUBSYSTEM:EFI_RUNTIME_DRIVER - WindowsCE - /SUBSYSTEM:WINDOWSCE - POSIX - /SUBSYSTEM:POSIX For more information, see /SUBSYSTEM (Specify subsystem). |
| SuppressStartupBanner | Optional Boolean parameter. If true, prevents the display of the copyright and version number message when the task starts.For more information, see the /NOLOGO option at Running LIB. |
| TargetMachine | Optional String parameter. Specifies the target platform for the program or DLL. Specify one of the following values, each of which corresponds to a command-line option. - MachineARM - /MACHINE:ARM - MachineEBC - /MACHINE:EBC - MachineIA64 - /MACHINE:IA64 - MachineMIPS - /MACHINE:MIPS - MachineMIPS16 - /MACHINE:MIPS16 - MachineMIPSFPU -/MACHINE:MIPSFPU - MachineMIPSFPU16 - /MACHINE:MIPSFPU16 - MachineSH4 - /MACHINE:SH4 - MachineTHUMB - /MACHINE:THUMB - MachineX64 - /MACHINE:X64 - MachineX86 - /MACHINE:X86 For more information, see /MACHINE (Specify target platform). |
| TrackerLogDirectory | Optional String parameter. Specifies the directory of the tracker log. |
| TreatLibWarningAsErrors | Optional Boolean parameter. If true, causes the LIB task to not generate an output file if lib.exe generates a warning. If false, an output file is generated.For more information, see the /WX option at Running LIB. |
| UseUnicodeResponseFiles | Optional Boolean parameter. If true, instructs the project system to generate UNICODE response files when the librarian is spawned. Specify true when files in the project have UNICODE paths. |
| Verbose | Optional Boolean parameter. If true, displays details about the progress of the session; this includes names of the .obj files being added. The information is sent to standard output and can be redirected to a file.For more information, see the /VERBOSE option in Running LIB. |