4.5.14 -library_calls, -lc, (off)

The -library_calls switch directs KAP to replace sections of code with calls to standard numerical library routines that have the same functionality. This can simplify the source code, and, if a version of the library that has been highly tuned for the target machine is available, the use of the standard package will improve performance of the application program. For example, if you specify this switch and you link the application with the Digital Extended Math Library (DXML), calls to the DXML Basic Linear Algebra Subroutines (BLAS) will replace sections of code. Use the following command:

kf77 -fkapargs='-lc' -ldxml myprog.f

The argument for -library_calls identifies which library to create CALLs for. The DXML BLAS Libraries are BLAS1, which performs vector-vector operations such as dot product; BLAS2, which performs matrix-vector operations such as matrix vector multiplication; and BLAS3, which performs matrix-matrix multiplication.

• To specify both BLAS1 and BLAS2, specify BLAS12.

• To specify both BLAS2 and BLAS3, specify BLAS23; this is the recommended switch.

• Specifying BLAS is equivalent to specifying BLAS23. This switch can be disabled within a section of code with the C*$* optimize=o directive. This switch is disabled if -roundoff=0 .

Caution

This switch will introduce calls to BLAS routines to be linked from system libraries. Use of this switch can cause a collision between KAP generated BLAS routine names and user-provided routines in the source code. Even if the user-provided routines are identical in function to the library routines, rename or remove the user routines, since the linker will not use the optimized library routines if the user's calls to routines can be satisfied with the user-provided routines.