Category
Pragma equivalent
None.
Purpose
Searches for the specified library file. For static and dynamic linking, the linker searches for libkey.a. For runtime linking with the -brtl option, the linker searches for libkey.so, and then libkey.a if libkey.so is not found.
Defaults
The compiler default is to search only some of the compiler runtime libraries. The default configuration file specifies the default library names to search for with the -l compiler option, and the default search path for libraries with the -L compiler option.
The C runtime libraries are automatically added.
Parameters
- key
- The name of the library minus the lib characters.
Usage
You must also provide additional search path information for libraries not located in the default search path. The search path can be modified with the -L or -Z option. See -B, -brtl, and -b for information on specifying the types of libraries that are searched (for static or dynamic linking).
The -l option is cumulative. Subsequent appearances of the -l option on the command line do not replace, but add to, the list of libraries specified by earlier occurrences of -l. Libraries are searched in the order in which they appear on the command line, so the order in which you specify libraries can affect symbol resolution in your application.
For more information, refer to the ld documentation for your operating system.
Predefined macros
None.
Examples
xlc myprogram.c -lmylibrary -L/usr/mylibdir