This file provides instructions on how to compile and link your programs with the library. You could link C or C++ programs with the library. The package will install library libiml.a and header file iml.h in the target machine. To link with the library, you need to locate the package directory as well as GMP and CBLAS (ATLAS by default) directories. Suppose compiler is CC, this package header file is in directory <iml-include-dir>, this package library is in directory <iml-lib-dir>, GMP header file is in directory <gmp-include-dir>, GMP library is in directory <gmp-lib-dir>, CBLAS header file is in directory <cblas-include-dir>, CBLAS library is in directory <cblas-lib-dir>, linker flags needed to link to CBLAS are <cblas-linker-flags>. Header Include ============== In the source code of your program, you should include both "gmp.h" and "iml.h" like this: #include "gmp.h" #include "iml.h" It is important to put "gmp.h" ahead of "iml.h" since iml.h uses symbols defined in GMP. Header Options ============== If the header files are not installed in the default search path, which is usually /usr or /usr/local, you should add one more of the following options -I<iml-include-dir>, -I<cblas-include-dir>, -I<gmp-include-dir> Linking ======= Your program must have the following linking flags -liml <cblas-linker-flags> -lgmp It is important to put flag -liml ahead of other three flags. If ATLAS is used, then <cblas-linker-flags> should be "-lcblas -latlas" Note that it is also important to put -lcblas ahead of -latlas. If the libraries are not installed in the default search path, you should add one or more of the following options -L<iml-lib-dir> -L<cblas-lib-dir> -L<gmp-lib-dir> Overall, you could use the following way to compile and link your program with this library: CC [-I<iml-include-dir> -I<cblas-include-dir> -I<gmp-include-dir>] yourprogram.c [-o yourprogram] [-L<iml-lib-dir> -L<cblas-lib-dir> -L<gmp-lib-dir>] -liml <cblas-linker-flags> -lgmp icc compiler ============= If you compile C programs using icc, you might need add another linker flag -no_cpprt. Otherwise, the linker might link with a run time C++ library and end up with an error message. Use the Library in C++ ====================== If you want to call the library functions from C++ programs, you need to include the package header file in the following way extern "C" { #include "iml.h" }
Generated by dwww version 1.15 on Wed Jun 26 04:33:25 CEST 2024.