ARM Compiler toolchain Using the Linker - ARM Information Center

4.25 Specifying user libraries when linking
4.25.1 See also
Image structure and generation
To specify user libraries:
• include them with path information explicitly in the input file list
• add the --userlibpath option to the armlink command line with a comma-separated list of
directories, and then specify the names of the libraries as input files.
You can use the --library=name option to specify static libraries, libname.a, or dynamic shared
objects, libname.so. Dynamic searching is controlled by the --search_dynamic_libraries option.
For example, the following command searches for libfoo.so before libfoo.a:
armlink --arm_linux --shared --fpic --search_dynamic_libraries --library=foo
If you do not specify a full path name to a library on the command line, the linker tries to locate
the library in the directories specified by the --userlibpath option. For example, if the directory
/mylib contains my_lib.a and other_lib.a, add /mylib/my_lib.a to the input file list with the
command:
armlink --userlibpath /mylib my_lib.a *.o
If you add a particular member from a library this does not add the library to the list of
searchable libraries used by the linker. To load a specific member and add the library to the list
of searchable libraries include the library filename on its own as well as specifying
library(member). For example, to load strcmp.o and place mystring.lib on the searchable library
list add the following to the input file list:
mystring.lib(strcmp.o) mystring.lib
Note
Any search paths used for the ARM standard libraries specified by either the linker
command-line option --libpath or the ARMLIB or ARMCC41LIB environment variables are not
searched for user libraries.
Tasks
• Controlling how the linker searches for the ARM standard libraries on page 4-36.
Reference
Linker Reference:
• --libpath=pathlist on page 2-96
• --library=name on page 2-97
• --search_dynamic_libraries, --no_search_dynamic_libraries on page 2-144
• --userlibpath=pathlist on page 2-179.
ARM ® C and C++ Libraries and Floating-Point Support Reference:
• Chapter 2 The C and C++ libraries.
Introducing the ARM Compiler toolchain:
• Toolchain environment variables on page 2-14.
ARM DUI 0474C Copyright © 2010-2011 ARM. All rights reserved. 4-38
ID080411 Non-Confidential