13.07.2015 Views

Intel(R) - Computational and Systems Biology at MIT

Intel(R) - Computational and Systems Biology at MIT

Intel(R) - Computational and Systems Biology at MIT

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

5 <strong>Intel</strong>® M<strong>at</strong>h Kernel Library User’s GuideSpecifying Makefile ParametersThere are several macros (parameters) for the makefile:export = functions_listdetermines the name of the file th<strong>at</strong> contains the list of entry point functions to beincluded into shared object. This file is used for definition file cre<strong>at</strong>ion <strong>and</strong> then forexport table cre<strong>at</strong>ion. Default name is functions_list.name = mkl_customspecifies the name of the cre<strong>at</strong>ed library. By default, the library mkl_custom.so isbuilt.xerbla = user_xerbla.ospecifies the name of object file th<strong>at</strong> contains user's error h<strong>and</strong>ler. This errorh<strong>and</strong>ler will be added to the library <strong>and</strong> then will be used instead of the <strong>Intel</strong> MKLerror h<strong>and</strong>ler xerbla. By default, th<strong>at</strong> is, when this parameter is not specified, then<strong>at</strong>ive <strong>Intel</strong> MKL xerbla is used.Note th<strong>at</strong> if the user’s error h<strong>and</strong>ler has the same name as the <strong>Intel</strong> MKL h<strong>and</strong>ler,the name of the user’s h<strong>and</strong>ler must be upper-case, th<strong>at</strong> is, XERBLA.o.All parameters are not m<strong>and</strong><strong>at</strong>ory. In the simplest case, the comm<strong>and</strong> line could bemake ia32 <strong>and</strong> the values of the remaining parameters will be taken by default. As aresult, mkl_custom.so library for processors using IA-32 architecture will be cre<strong>at</strong>ed, thefunctions list will be taken from the functions_list.txt file, <strong>and</strong> the n<strong>at</strong>ive <strong>Intel</strong> MKLerror h<strong>and</strong>ler xerbla will be used.Another example for a more complex case is as follows:make ia32 export=my_func_list.txt name=mkl_small xerbla=my_xerbla.oIn this case, mkl_small.so library for processors using IA-32 architecture will be cre<strong>at</strong>ed,the functions list will be taken from my_func_list.txt file, <strong>and</strong> user's error h<strong>and</strong>lermy_xerbla.o will be used.The process is similar for processors using <strong>Intel</strong>® 64 or IA-64 architecture.Specifying List of FunctionsEntry points in functions_list file should be adjusted to interface. For example, Fortranfunctions get an underscore character "_" as a suffix when added to the library:dgemm_ddot_dgetrf_If selected functions have several processor-specific versions, they all will be included intothe custom library <strong>and</strong> managed by disp<strong>at</strong>cher.5-12

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!