Linking on Intel Xeon Phi Coprocessors

Intel MKL provides both static and dynamic libraries for coprocessors based on Intel MIC Architecture, but the Single Dynamic Library is unavailable for the coprocessors.

See Selecting Libraries to Link with for libraries to list on your link line in the simplest case.

See Detailed Directory Structure of the lib/mic Directory for a full list of libraries provided in the <mkl directory>/lib/mic directory.

You can link either static or dynamic host libraries and either static or dynamic coprocessor-side libraries independently.

To run applications linked dynamically with the host-computer and coprocessor-side libraries, perform the Setting Environment Variables step of the Getting Started process, which sets:

• LD_LIBRARY_PATH to contain <mkl directory>/lib/intel64

• MIC_LD_LIBRARY_PATH to contain <mkl directory>/lib/mic

To make Intel MKL functions available on the coprocessor side, provide the -offload-attribute-target=mic option on your link line.

The following examples illustrate linking with Intel compilers on Intel Xeon Phi coprocessors.

The examples use a .f (Fortran) source file and Intel® Fortran Compiler. C/C++ users should instead specify a .cpp (C++) or .c (C) file and replace ifort with icc.

In these examples, MKLINCLUDE is defined as $MKLROOT/include
(if you successfully completed the Setting Environment Variables step of the Getting Started process, you can omit the -I$MKLINCLUDE parameter):

• Static linking of myprog.f, host-computer and coprocessor-side libraries for parallel Intel MKL using LP64 interface:

  ifort myprog.f -I$MKLINCLUDE -offload-attribute-target=mic
  -Wl,--start-group $MKLROOT/lib/intel64/libmkl_intel_lp64.a
  $MKLROOT/lib/intel64/libmkl_intel_thread.a
  $MKLROOT/lib/intel64/libmkl_core.a -Wl,--end-group
  -openmp -lpthread -lm
  -offload-option,mic,compiler,"-Wl,--start-group $MKLROOT/lib/mic/libmkl_intel_lp64.a $MKLROOT/lib/mic/libmkl_intel_thread.a $MKLROOT/lib/mic/libmkl_core.a -Wl,--end-group"

• Dynamic linking of myprog.f, host-computer and coprocessor-side libraries for parallel Intel MKL using LP64 interface:

  ifort myprog.f -I$MKLROOT/include -offload-attribute-target=mic
  -L$MKLROOT/lib/intel64
  -lmkl_intel_lp64 -lmkl_intel_thread
  -lmkl_core -openmp -lpthread -lm
  -offload-option,mic,compiler,"-L$MKLROOT/lib/mic -lmkl_intel_lp64 -lmkl_intel_thread -lmkl_core"

• Static linking of myprog.f, host-computer and coprocessor-side libraries for parallel Intel MKL using ILP64 interface:

  ifort myprog.f -I$MKLINCLUDE -offload-attribute-target=mic
  -Wl,--start-group $MKLROOT/lib/intel64/libmkl_intel_ilp64.a
  $MKLROOT/lib/intel64/libmkl_intel_thread.a
  $MKLROOT/lib/intel64/libmkl_core.a -Wl,--end-group
  -openmp -lpthread -lm
  -offload-option,mic,compiler,"-Wl,--start-group $MKLROOT/lib/mic/libmkl_intel_ilp64.a $MKLROOT/lib/mic/libmkl_intel_thread.a $MKLROOT/lib/mic/libmkl_core.a -Wl,--end-group"

• Dynamic linking of myprog.f, host-computer and coprocessor-side libraries for parallel Intel MKL using ILP64 interface:

  ifort myprog.f -I$MKLROOT/include -offload-attribute-target=mic
  -L$MKLROOT/lib/intel64
  -lmkl_intel_ilp64 -lmkl_intel_thread
  -lmkl_core -openmp -lpthread -lm
  -offload-option,mic,compiler,"-L$MKLROOT/lib/mic -lmkl_intel_ilp64 -lmkl_intel_thread -lmkl_core"

• Static linking of myprog.f, host-computer and coprocessor-side libraries for sequential version of Intel MKL using LP64 interface:

  ifort myprog.f -I$MKLINCLUDE -offload-attribute-target=mic
  -Wl,--start-group $MKLROOT/lib/intel64/libmkl_intel_lp64.a
  $MKLROOT/lib/intel64/libmkl_sequential.a
  $MKLROOT/lib/intel64/libmkl_core.a -Wl,--end-group -lm
  -offload-option,mic,compiler,"-Wl,--start-group $MKLROOT/lib/mic/libmkl_intel_lp64.a $MKLROOT/lib/mic/libmkl_sequential.a $MKLROOT/lib/mic/libmkl_core.a -Wl,--end-group"

• Dynamic linking of myprog.f, host-computer and coprocessor-side libraries for sequential version of Intel MKL using LP64 interface:

  ifort myprog.f -I$MKLROOT/include -offload-attribute-target=mic
  -L$MKLROOT/lib/intel64
  -lmkl_intel_lp64 -lmkl_sequential -lmkl_core -lm
  -offload-option,mic,compiler,"-L$MKLROOT/lib/mic -lmkl_intel_lp64 -lmkl_sequential -lmkl_core"