1.3 More About Linking to Libraries

The name used for compiled SourcePro C++ libraries is based on these elements:

• product mnemonic, such as tls for the Essential Tools Module

• for all naming conventions except the SPM convention for static builds, the component major and minor version numbers

• the build tag, which depends on the naming convention selected when creating the buildspec in RCB

• the extension, which is .lib or .dll on Windows and varies for UNIX

The build tag element is the most complex. Here is a summary of the three naming conventions and the build tags they generate:

SPM	The build tag is a combination of a number component from 8 to 15 plus a binding letter, s for static or d for dynamic. If there is a user tag, it is placed at the end.For example, a static build with the build type 8s and the user tag baja creates a library named tls8sbaja.lib on Windows, or tls8sbaja.a on Solaris.For dynamic builds, the version numbers are included in the shared library name, so a 15d build of this same component yields a shared library named tls9015dbaja.dll on Windows or tls9015dbaja.so on Solaris. On Windows, the dynamic build also generates a link library, whose name is tls15dbaja.lib.
RCB	The RCB convention uses a system of single letters (or the absence of any letter) to represent the main build configuration options. For a table of these values, see Appendix A.The pattern for the library name is:
	-> product mnemonic
	-> the component version number
	-> user tag, if defined
	-> a dash
	-> the single letter codes shown in Appendix A
	-> the extension
	An example with the build type s and the user tag baja is tls80baja-s.lib on Windows or tls80baja-s.a on Solaris. The dynamic build equivalent differs in dropping the s for static, leaving no tag, and substituting the dynamic extension: tls90baja.dll on Windows, tls90baja.so on Solaris.
Verbose RCB	The verbose convention forms library names the same way as the short RCB convention, except that the letter codes are replaced by meaningful strings. Using the above example from the RCB convention, the code s becomes _NativeStdLib_NoThrLib_Static_Release and the library name becomes:
	tls90baja-_NativeStdLib_NoThrLib_Static_Release.lib
	or tls90baja-_NativeStdLib_NoThrLib_Static_Release.a
	The dynamic equivalents are:
	tls90baja-_NativeStdLib_NoThrLib_Dynamic_Release.dll
	or tls90baja-_NativeStdLib_NoThrLib_Dynamic_Release.so

For a table summarizing the three naming conventions and the build tags they generate, see Appendix A.

© Copyright Rogue Wave Software, Inc. All Rights Reserved.
Rogue Wave and SourcePro are registered trademarks of Rogue Wave Software, Inc. in the United States and other countries. All other trademarks are the property of their respective owners.
Contact Rogue Wave about documentation or support issues.