4.7 Compiling in Unix

This section describes how to use Unix compilers to compile programs that use Rogue Wave's Math.h++ class library.

To use the Math.h++ library in your own program:

Add the directory containing the Math.h++ header files to your include list.
Link to the appropriate Math.h++, Tools.h++, and BLA libraries.

For instance, to build a program called myapp you might use the following command line (all on one line):

CC -Irwav/workspaces/SOLARIS251/SUNPRO420/4s myapp.cpp 
   rwav/workspaces/SOLARIS251/SUNPRO420/4s/lib/libtls4s.a
   rwav/workspaces/SOLARIS251/SUNPRO420/4s/lib/libmth4s.a
   rwav/workspaces/SOLARIS251/SUNPRO420/4s/lib/libbla4s.a -o myapp

The example assumes the library was exported to the rwav/workspaces/SOLARIS251/SUNPRO420/4s directory.

To determine what to do next, read the instructions in the section that applies to you, either "Using a Static Version of Math.h++ (Unix)" or "Using a Shared Version of Math.h++ (Unix)."

4.7.1 Using a Static Version of Math.h++ (Unix)

If you linked to a static Math.h++ library, you are ready to run the resulting program.

4.7.1.1 Static Version of Math.h++ for AIX CSet++

Follow these instructions when using a static version of Math.h++ for AIX CSet++.

NOTE: It is only necessary to follow this procedure when using the static library. You do not need to follow this procedure if you are using the shared version of the library.

In the directory in which you are compiling your applications, you must create a new directory named tempinc, then copy the contents of the <rw_root>/<workspace>/rw/math/tempinc directory into the new tempinc directory. You can call the new tempinc directory by another name as long as you use the compiler option -qtempinc=<your directory name>.

The CSet++ compiler for AIX creates a directory named tempinc by default, in the directory where you are compiling. It stores information about the templates that need to be instantiated at link time in that directory. The Math.h++ library uses some templates internally. However, when building a static library, the linker is never invoked and the result is that the templates are not instantiated. Copying the .C files from the <rw_root>/parts/mth<ver>u/source/src/tempinc directory into your application's tempinc directory, tells the linker which templates the Math.h++ library needs instantiated. Failure to do this will result in undefined symbols at link time.

4.7.2 Using a Shared Version of Math.h++ (Unix)

If you linked to a shared Math.h++ library, before running the resulting program, be sure that the library location is available in the environmental variable that your operating system uses to describe the possible locations of shared libraries. For many operating systems, this environmental variable is LD_LIBRARY_PATH. Some operating systems use a different name; be sure to use the one appropriate to your operating system.

NOTE: The preceding step is recommended for all shared Unix Math.h++ libraries, and required for some platforms.

You may set the library path variable from your shell or by including it in your rc or profile script.

For example, in a Korn or Bourne shell, if your library is installed in the /rwav/workspaces/SOLARIS251/SUNPRO420/4s/lib directory, use the following command (all on one line):

export LD_LIBRARY_PATH=rwav/workspaces/SOLARIS251/SUNPRO420
/4s/lib:$LD_LIBRARY_PATH

If you are running in other than a Bourne or Korn shell, the command is:

setenv LD_LIBRARY_PATH rwav/workspaces/SOLARIS251/SUNPRO420
/4s/lib:$LD_LIBRARY_PATH

For more information on compiling using shared libraries, review the Math.h++ readme files located in <rw_root>/parts/mth<ver>u/docs.