Arm Performance Libraries

Get Started

Overview Installation Environment configuration Compile and test the examples Optimized math routines - libamath Optimized string routines - libastring Library selection Documentation Related information
Single Page

Library selection

To instruct your compiler to load the optimum version of Arm Performance Libraries for your target architecture and implementation, you can use the -armpl (Arm Compiler) or -larmpl (GCC) option . These options also enable the optimized versions of the C mathematical functions declared in the math.h library, tuned scalar and vector implementations of Fortran math intrinsics, and auto-vectorization of mathematical functions (disable this using -fno-simdmath).

Supported options and arguments are:

Arm Compiler
 GCC
 Description
 -armpl=sve  -larmpl Use the Scalable Vector Extension (SVE)
library.

 Notes
  • This is the generic SVE library
    that is not tuned for a particular
    microarchitecture.
  • -armpl=sve,<arg2>,<arg3> 
    should be used in combination
    with -march=armv8-a+sve.

 -armpl=lp64

(Default)

  -DINTEGER32 (Compile)
 -larmpl_lp64 (Link)		 Use 32-bit integers.

 -armpl=ilp64

(Default if using -i8)

  -DINTEGER64 (Compile)
 -larmpl_ilp64 (Link)		 Use 64-bit integers.

 -armpl=sequential

(Default)

  -larmpl_lp64 Use the single-threaded library.

 -armpl=parallel

(Default if using -fopenmp)

  -larmpl_lp64_mp Use the OpenMP multi-threaded
library.

Separate multiple arguments using a comma, for example: -armpl=<arg1>,<arg2>.

Default option and argument behavior

For information about the default behavior of the -armpl option and its arguments in Arm Compiler for Linux, see the Arm C/C++ Compiler or Arm Fortran Compiler reference guide.

Selecting target architecture

Arm Performance Libraries provides libraries suitable for a range of supported CPUs. If you intend to use -armpl, you must also specify the required architecture using the -mcpu option.

By default the compiler will auto-detect the CPU architecture from the build compiler. To change this behavior, and specify a particular architecture, use the -mcpu option.

-mcpu={native | generic | thunderx2c99 | neoverse-n1 | a64fx}

Linking against static libraries

The Arm Performance Libraries are supplied in both static and shareable versions, libarmpl_lp64.a and libarmpl_lp64.so. By default, the commands given above link to the shareable version of the library, libarmpl_lp64.so, if that version exists in the specified directory.

To force linking with the static library, either:

  • Use the compiler flag -static, for example:
    {armclang|armclang++|armflang} driver.{c|cpp|f90} -L${ARMPL_LIBRARIES} -static -larmpl_lp64
  • Insert the name of the static library in the command line, for example:
    {armclang|armclang++|armflang} driver.{c|cpp|f90} ${ARMPL_LIBRARIES}/libarmpl_lp64.a
Previous Next