Arm Performance Libraries 22.0.1 Release Note
=============================================

Non-Confidential
Copyright © [2015, 2022] Arm Limited (or its affiliates). All rights reserved.

Arm conventions and proprietary notices, including confidentiality status,
terminology statement, and product release status, can be found at the end of
this document.

Contents
========

- Release overview
- Release contents
- Get started
- Support
- Release history
- Glossary
- Proprietary notices

Release overview
================

Use of the free of charge version of Arm Performance Libraries is subject to the
terms and conditions of the applicable End User License Agreement (“EULA”). A
copy of the EULA can be found in the 'license_terms' folder of your product
installation.

Product description
-------------------

The freely distributed version of Arm Performance Libraries contains optimized
math functions, such as linear algebra and Fast Fourier Transforms, for Arm
AArch64 implementations, including those with SVE. It is compatible with GCC
8.2.

Arm Performance Libraries is optimized for a number of microarchitectures. The
latest information is available on the Arm Developer website:

https://developer.arm.com/tools-and-software/server-and-hpc/compile/arm-compiler-for-linux/resources/supported-platforms

Release status
--------------

This is the 22.0.1 release of Arm Performance Libraries.

These deliverables are being released under the terms of the agreement between
Arm and each licensee (the "Agreement"). All planned verification and
validation is complete.
The release is suitable for volume production under the terms of the Agreement.

Release contents
================

The following sub-sections describe:
- The product parts that are delivered as part of this release.
- Any changes since the previous release.
- Any known issues and limitations that exist at the time of this release.

Deliverables
------------

- Arm Performance Libraries 22.0.1
- Release Notes (this document)
- Documentation

  Product documentation is available on the Arm Developer website. See the
  'Documentation' section on:

  https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-performance-libraries

  Documentation and release notes might change between product releases. For the
  latest documentation bundle, check the product download page.

  Arm tests PDFs only in Adobe Acrobat and Acrobat Reader. Arm cannot guarantee
  the quality of its PDFs when used with any other PDF reader. Adobe reader
  products are available at https://www.adobe.com.

Differences from previous release
---------------------------------

The following subsections describe differences from the previous release of
Arm Performance Libraries.

Additions and changes:
~~~~~~~~~~~~~~~~~~~~~~

There are no new features or components added, or any technical changes to
features or components, in the 22.0.1 release.

This section describes the new features or components added, or any technical
changes to features or components, in the 22.0.0 release.

- The freely distributed version of Arm Performance Libraries is now optimized
  for more microarchitectures, including:

  * Neoverse N1 (such as Amazon Graviton 2 and Ampere Altra)

  * Neoverse V1

  * Neoverse N2

  * Fujitsu A64FX

  * Marvell ThunderX2

- Improved the performance for:

  * BLAS level 1 routines: SVE optimizations for ?COPY, ?SCAL, ?AXPY

  * BLAS level 2 routines: packed and banded functionality; ?TRMV and ?TRSV
  for large problems

  * BLAS level 3 routines: ?TRMM and ?TRSM for large problems

  * LAPACK routines: ?EEVD (eigenvalue decomposition) for small problems;
  ?POTRF for multithreaded cases

- Added support for I?AMIN BLAS extension routines for all types, finding the
  location of the first minimum value in a vector.

- Added support for LAPACK version 3.10.0. In addition, an out of bounds bug
  in LAPACK ?LARRV routines (CVE-2021-4048) has been patched.

- Performance improvements in libamath, for:

  * atan, atanf (vector)

  * atan2, atan2f (scalar & vector)

  * cos, cosf (vector)

  * erfc, erfcf (vector)

  * exp, expf (vector)

  * logf (vector)

  * pow (vector)

  * sin, sinf (vector)

  * tanf (vector)

- When using Arm Performance Libraries built for GCC, C/C++ users do not need
  to link to libgfortran.


Resolved issues:
~~~~~~~~~~~~~~~~

There are no resolved issues to report in the 22.0.1 release.


Known limitations
-----------------

The following subsection describes any issues known at the time of this release.

Open technical issues:
~~~~~~~~~~~~~~~~~~~~~~

There are no open technical issues in the 22.0.1 release.


Get started
===========

This section describes information to help you get started with accessing,
setting up, and using Arm Performance Libraries.

For more information, see the Get Started information on the Arm Developer
website:

  https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-performance-libraries

Licensing information
---------------------

Use of the free of charge version of Arm Performance Libraries is subject to the
terms and conditions of the applicable End User License Agreement (“EULA”). A
copy of the EULA can be found in the 'license_terms' folder of your product
installation.

You do not require a license to use this Arm Performance Libraries package.

Prerequisites
-------------

If any of the following tools are not already installed by your Linux
distribution, you must install them before installing Arm Performance Libraries:

- Python (version 2.7 or later)
- C Libraries:
   - SLES and RHEL: glibc-devel
   - Ubuntu:        libc6-dev

Download the product
--------------------

Arm delivers the files through the Arm Developer website:

  https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-performance-libraries

Unpack the product
------------------

The following steps describe how to unpack each constituent part delivered in
this bundle:

1. Relocate the bundle file. Move the .tar files to the directory you want to
   install the product in.

2. Extract the tar file contents using a tar utility:

     tar -xvf <package_name>.tar

Directory structure:
--------------------

Shows the principal directory structure of this release created after unpacking
the bundle:

  license_terms/
  arm-performance-libraries_<version>_*.sh
  RELEASE_NOTES.txt

Install the product
-------------------

To install Arm Performance Libraries, navigate into the extracted package
directory (<package_name>) and run the installation script as a privileged user.
Pass any options to configure the installation:

  cd path/to/<package_name>/
  ./arm-performance-libraries_<version>_*.sh [option]...

Some common installation options are:

- For a headless installation and to automatically accept the EULA, use
  the '--accept' option.
- To perform a local install, use the '--install-to <dir>' option.

For a full list of supported installation options, see:

  https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-performance-libraries

The installer displays the EULA and prompts you to agree to the terms. Type
'yes' at the prompt to continue.

The packages are unpacked to
<install_location>/arm-performance-libraries_22.0.1_gcc-8.2,
and <install_location>/armpl_22.0.1_gcc-8.2,
with environment modulefiles available under <install_location>/modulefiles. The
default installation location is /opt/arm/. Local installs have the same
directory structure starting from your chosen installation root.

RPMs
----

The installed packages are shipped as RPMs for RPM based Linux distributions.
These RPMs are signed by Arm's High Performance Computing (HPC) GPG key. The
public key can be downloaded from:

  https://developer.arm.com/-/media/files/keys/GPG-PUB-KEY-ARM-HPC-SW-TOOLS.PUB

This key can be imported by running:

  rpm --import GPG-PUB-KEY-ARM-HPC-SW-TOOLS.PUB

More information about Environment Modules can be found at:

http://modules.sourceforge.net

Run the product
---------------

1. Load the environment module.

     module load <install_location>/modulefiles/armpl/22.0.1_gcc-8.2

2. To generate an executable binary with GCC, compile your program with Arm
   Performance Libraries. Use:

     gcc -I<install_dir>/include -L<install_dir>/lib <-larmpl> -lm [options] -o <binary> <input>

   or

     gfortran -I<install_dir>/include -L<install_dir>/lib <-larmpl> -lm [options] -o <binary> <input>

   where:

   - <-larmpl> is one of: -larmpl, -larmpl_lp64, -larmpl_ilp64, -larmpl_lp64_mp,
     or -larmpl_ilp64_mp.
   - [options] denotes any other GCC compiler options
   - <input> is the source file (or files)
   - <binary> is the application executable to build

3. Run the generated binary <binary>:

     ./<binary>

Examples
--------

Example code can be found at:

<install_location>/armpl_22.0.1_gcc-8.2/examples*

Multiple examples directories are provided in the installation. The suffix of
the directory name indicates whether the examples inside link to the 32-bit
('_lp64') or 64-bit ('_ilp64') integer variants, and sequential (no suffix
indicator) or OpenMP ('_mp') multi-threaded variants, of Arm Performance
Libraries.

The default set of examples in the 'examples' directory link to the sequential,
32-bit integers variant of Arm Performance Libraries.

You need to copy this code to a writeable directory and load Arm Performance
Libraries environment module for the examples to build.

For example:

1. Copy the default 'examples' directory somewhere writeable:

     cp -r <install_location>/armpl_22.0.1_gcc-8.2/examples ./
     cd examples

2. Load the correct environment modules:

     module load <install_location>/modulefiles/armpl/22.0.1_gcc-8.2

3. Build the examples:

     make

For more information about the Arm Performance Libraries examples, see:

https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-performance-libraries/get-started-with-armpl-free-version/compile-an-example

Uninstall
---------

For convenience, this package includes an "uninstall.sh" script at:

  <install_location>/arm-performance-libraries_22.0.1_gcc-8.2/uninstall.sh

This script attempts to uninstall all the components supplied as part of
Arm Performance Libraries. However, if other packages outside of this product
depend on the GCC component, GCC will not be uninstalled.

If you require support when uninstalling any version of Arm Performance
Libraries, contact Arm Support at https://developer.arm.com/support.

Support
=======

The documentation that is available for Arm Performance Libraries is listed on
the product downloads page on the Arm Developer website:

  https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-performance-libraries

Reference documentation for the supported routines in Arm Performance Libraries
is available at:

  https://developer.arm.com/docs/101004/latest

If you have any issues with the installation, content or use of this release,
create a post that describes your issue on the Arm Community HPC forum:

  https://community.arm.com/developer/tools-software/hpc/f/hpc-user-group

Arm will respond as soon as possible.

These deliverables are being released under the terms of the agreement between
Arm and each licensee (the “Agreement”). All planned verification and
validation is complete. The release is suitable for volume production under
the terms of the Agreement.

OS
--

These libraries are supported on the following Linux platforms:

- AArch64 RHEL 7 and 8
- AArch64 SLES 15
- AArch64 Ubuntu 18.04 and 20.04
- Amazon Linux 2022 (AL 2022)

Full information about the platforms supported by Arm Performance Libraries is
available on the Arm Developer website:

  https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-performance-libraries

Release history
===============

A full release history (with release notes) for Arm Performance Libraries is
available on the Arm Developer website:

  https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-performance-libraries/release-history

Glossary
========

The Arm Glossary is a list of terms that are used in Arm documentation, together
with definitions for those terms. The Arm Glossary does not contain terms that
are industry standard unless the Arm meaning differs from the generally accepted
meaning.

See the Arm Glossary for more information: https://developer.arm.com/glossary.

Non-Confidential Proprietary Notice
===================================

This document is protected by copyright and other related rights and the
practice or implementation of the information contained in this document may be
protected by one or more patents or pending patent applications. No part of this
document may be reproduced in any form by any means without the express prior
written permission of Arm. No license, express or implied, by estoppel or
otherwise to any intellectual property rights is granted by this document
unless specifically stated.

Your access to the information in this document is conditional upon your
acceptance that you will not use or permit others to use the information for
the purposes of determining whether implementations infringe any third party
patents.

THIS DOCUMENT IS PROVIDED “AS IS”. ARM PROVIDES NO REPRESENTATIONS AND NO
WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, INCLUDING, WITHOUT LIMITATION, THE
IMPLIED WARRANTIES OF MERCHANTABILITY, SATISFACTORY QUALITY, NON-INFRINGEMENT
OR FITNESS FOR A PARTICULAR PURPOSE WITH RESPECT TO THE DOCUMENT. For the
avoidance of doubt, Arm makes no representation with respect to, and has
undertaken no analysis to identify or understand the scope and content of,
patents, copyrights, trade secrets, or other rights.

This document may include technical inaccuracies or typographical errors.

TO THE EXTENT NOT PROHIBITED BY LAW, IN NO EVENT WILL ARM BE LIABLE FOR ANY
DAMAGES, INCLUDING WITHOUT LIMITATION ANY DIRECT, INDIRECT, SPECIAL,
INCIDENTAL, PUNITIVE, OR CONSEQUENTIAL DAMAGES, HOWEVER CAUSED AND REGARDLESS
OF THE THEORY OF LIABILITY, ARISING OUT OF ANY USE OF THIS DOCUMENT, EVEN IF
ARM HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

This document consists solely of commercial items. You shall be responsible for
ensuring that any use, duplication or disclosure of this document complies fully
with any relevant export laws and regulations to assure that this document or
any portion thereof is not exported, directly or indirectly, in violation of
such export laws. Use of the word “partner” in reference to Arm’s customers is
not intended to create or refer to any partnership relationship with any other
company. Arm may make changes to this document at any time and without notice.

This document may be translated into other languages for convenience, and you
agree that if there is any conflict between the English version of this document
and any translation, the terms of the English version of the Agreement shall
prevail.

The Arm corporate logo and words marked with ® or ™ are registered trademarks or
trademarks of Arm Limited (or its affiliates) in the US and/or elsewhere. All
rights reserved. Other brands and names mentioned in this document may be the
trademarks of their respective owners. Please follow Arm’s trademark usage
guidelines at https://www.arm.com/company/policies/trademarks.

Copyright © [2015, 2022] Arm Limited (or its affiliates). All rights reserved.

Arm Limited. Company 02557590 registered in England.

110 Fulbourn Road, Cambridge, England CB1 9NJ.

(LES-PRE-20349)

Confidentiality Status
----------------------

This document is Non-Confidential. The right to use, copy and disclose this
document may be subject to license restrictions in accordance with the terms
of the agreement entered into by Arm and the party that Arm delivered this
document to.

Unrestricted Access is an Arm internal classification.

Product Status
--------------

The information in this document is Final, that is for a developed product.

Web Address
-----------

https://developer.arm.com

Inclusive language commitment
-----------------------------

Arm values inclusive communities. Arm recognizes that we and our industry have
used language that can be offensive. Arm strives to lead the industry and create
change.

We believe that this document contains no offensive terms. To report offensive
language in this document, email terms@arm.com.

Arm Performance Libraries 22.0.1 Release Note
=============================================

Non-Confidential
Copyright © [2015, 2022] Arm Limited (or its affiliates). All rights reserved.

Arm conventions and proprietary notices, including confidentiality status,
terminology statement, and product release status, can be found at the end of
this document.

Contents
========

- Release overview
- Release contents
- Get started
- Support
- Release history
- Glossary
- Proprietary notices

Release overview
================

Use of the free of charge version of Arm Performance Libraries is subject to the
terms and conditions of the applicable End User License Agreement (“EULA”). A
copy of the EULA can be found in the 'license_terms' folder of your product
installation.

Product description
-------------------

The freely distributed version of Arm Performance Libraries contains optimized
math functions, such as linear algebra and Fast Fourier Transforms, for Arm
AArch64 implementations, including those with SVE. It is compatible with GCC
9.3.

Arm Performance Libraries is optimized for a number of microarchitectures. The
latest information is available on the Arm Developer website:

https://developer.arm.com/tools-and-software/server-and-hpc/compile/arm-compiler-for-linux/resources/supported-platforms

Release status
--------------

This is the 22.0.1 release of Arm Performance Libraries.

These deliverables are being released under the terms of the agreement between
Arm and each licensee (the "Agreement"). All planned verification and
validation is complete.
The release is suitable for volume production under the terms of the Agreement.

Release contents
================

The following sub-sections describe:
- The product parts that are delivered as part of this release.
- Any changes since the previous release.
- Any known issues and limitations that exist at the time of this release.

Deliverables
------------

- Arm Performance Libraries 22.0.1
- Release Notes (this document)
- Documentation

  Product documentation is available on the Arm Developer website. See the
  'Documentation' section on:

  https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-performance-libraries

  Documentation and release notes might change between product releases. For the
  latest documentation bundle, check the product download page.

  Arm tests PDFs only in Adobe Acrobat and Acrobat Reader. Arm cannot guarantee
  the quality of its PDFs when used with any other PDF reader. Adobe reader
  products are available at https://www.adobe.com.

Differences from previous release
---------------------------------

The following subsections describe differences from the previous release of
Arm Performance Libraries.

Additions and changes:
~~~~~~~~~~~~~~~~~~~~~~

There are no new features or components added, or any technical changes to
features or components, in the 22.0.1 release.

This section describes the new features or components added, or any technical
changes to features or components, in the 22.0.0 release.

- The freely distributed version of Arm Performance Libraries is now optimized
  for more microarchitectures, including:

  * Neoverse N1 (such as Amazon Graviton 2 and Ampere Altra)

  * Neoverse V1

  * Neoverse N2

  * Fujitsu A64FX

  * Marvell ThunderX2

- Improved the performance for:

  * BLAS level 1 routines: SVE optimizations for ?COPY, ?SCAL, ?AXPY

  * BLAS level 2 routines: packed and banded functionality; ?TRMV and ?TRSV
  for large problems

  * BLAS level 3 routines: ?TRMM and ?TRSM for large problems

  * LAPACK routines: ?EEVD (eigenvalue decomposition) for small problems;
  ?POTRF for multithreaded cases

- Added support for I?AMIN BLAS extension routines for all types, finding the
  location of the first minimum value in a vector.

- Added support for LAPACK version 3.10.0. In addition, an out of bounds bug
  in LAPACK ?LARRV routines (CVE-2021-4048) has been patched.

- Performance improvements in libamath, for:

  * atan, atanf (vector)

  * atan2, atan2f (scalar & vector)

  * cos, cosf (vector)

  * erfc, erfcf (vector)

  * exp, expf (vector)

  * logf (vector)

  * pow (vector)

  * sin, sinf (vector)

  * tanf (vector)

- When using Arm Performance Libraries built for GCC, C/C++ users do not need
  to link to libgfortran.


Resolved issues:
~~~~~~~~~~~~~~~~

There are no resolved issues to report in the 22.0.1 release.


Known limitations
-----------------

The following subsection describes any issues known at the time of this release.

Open technical issues:
~~~~~~~~~~~~~~~~~~~~~~

There are no open technical issues in the 22.0.1 release.


Get started
===========

This section describes information to help you get started with accessing,
setting up, and using Arm Performance Libraries.

For more information, see the Get Started information on the Arm Developer
website:

  https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-performance-libraries

Licensing information
---------------------

Use of the free of charge version of Arm Performance Libraries is subject to the
terms and conditions of the applicable End User License Agreement (“EULA”). A
copy of the EULA can be found in the 'license_terms' folder of your product
installation.

You do not require a license to use this Arm Performance Libraries package.

Prerequisites
-------------

If any of the following tools are not already installed by your Linux
distribution, you must install them before installing Arm Performance Libraries:

- Python (version 2.7 or later)
- C Libraries:
   - SLES and RHEL: glibc-devel
   - Ubuntu:        libc6-dev

Download the product
--------------------

Arm delivers the files through the Arm Developer website:

  https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-performance-libraries

Unpack the product
------------------

The following steps describe how to unpack each constituent part delivered in
this bundle:

1. Relocate the bundle file. Move the .tar files to the directory you want to
   install the product in.

2. Extract the tar file contents using a tar utility:

     tar -xvf <package_name>.tar

Directory structure:
--------------------

Shows the principal directory structure of this release created after unpacking
the bundle:

  license_terms/
  arm-performance-libraries_<version>_*.sh
  RELEASE_NOTES.txt

Install the product
-------------------

To install Arm Performance Libraries, navigate into the extracted package
directory (<package_name>) and run the installation script as a privileged user.
Pass any options to configure the installation:

  cd path/to/<package_name>/
  ./arm-performance-libraries_<version>_*.sh [option]...

Some common installation options are:

- For a headless installation and to automatically accept the EULA, use
  the '--accept' option.
- To perform a local install, use the '--install-to <dir>' option.

For a full list of supported installation options, see:

  https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-performance-libraries

The installer displays the EULA and prompts you to agree to the terms. Type
'yes' at the prompt to continue.

The packages are unpacked to
<install_location>/arm-performance-libraries_22.0.1_gcc-9.3,
and <install_location>/armpl_22.0.1_gcc-9.3,
with environment modulefiles available under <install_location>/modulefiles. The
default installation location is /opt/arm/. Local installs have the same
directory structure starting from your chosen installation root.

RPMs
----

The installed packages are shipped as RPMs for RPM based Linux distributions.
These RPMs are signed by Arm's High Performance Computing (HPC) GPG key. The
public key can be downloaded from:

  https://developer.arm.com/-/media/files/keys/GPG-PUB-KEY-ARM-HPC-SW-TOOLS.PUB

This key can be imported by running:

  rpm --import GPG-PUB-KEY-ARM-HPC-SW-TOOLS.PUB

More information about Environment Modules can be found at:

http://modules.sourceforge.net

Run the product
---------------

1. Load the environment module.

     module load <install_location>/modulefiles/armpl/22.0.1_gcc-9.3

2. To generate an executable binary with GCC, compile your program with Arm
   Performance Libraries. Use:

     gcc -I<install_dir>/include -L<install_dir>/lib <-larmpl> -lm [options] -o <binary> <input>

   or

     gfortran -I<install_dir>/include -L<install_dir>/lib <-larmpl> -lm [options] -o <binary> <input>

   where:

   - <-larmpl> is one of: -larmpl, -larmpl_lp64, -larmpl_ilp64, -larmpl_lp64_mp,
     or -larmpl_ilp64_mp.
   - [options] denotes any other GCC compiler options
   - <input> is the source file (or files)
   - <binary> is the application executable to build

3. Run the generated binary <binary>:

     ./<binary>

Examples
--------

Example code can be found at:

<install_location>/armpl_22.0.1_gcc-9.3/examples*

Multiple examples directories are provided in the installation. The suffix of
the directory name indicates whether the examples inside link to the 32-bit
('_lp64') or 64-bit ('_ilp64') integer variants, and sequential (no suffix
indicator) or OpenMP ('_mp') multi-threaded variants, of Arm Performance
Libraries.

The default set of examples in the 'examples' directory link to the sequential,
32-bit integers variant of Arm Performance Libraries.

You need to copy this code to a writeable directory and load Arm Performance
Libraries environment module for the examples to build.

For example:

1. Copy the default 'examples' directory somewhere writeable:

     cp -r <install_location>/armpl_22.0.1_gcc-9.3/examples ./
     cd examples

2. Load the correct environment modules:

     module load <install_location>/modulefiles/armpl/22.0.1_gcc-9.3

3. Build the examples:

     make

For more information about the Arm Performance Libraries examples, see:

https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-performance-libraries/get-started-with-armpl-free-version/compile-an-example

Uninstall
---------

For convenience, this package includes an "uninstall.sh" script at:

  <install_location>/arm-performance-libraries_22.0.1_gcc-9.3/uninstall.sh

This script attempts to uninstall all the components supplied as part of
Arm Performance Libraries. However, if other packages outside of this product
depend on the GCC component, GCC will not be uninstalled.

If you require support when uninstalling any version of Arm Performance
Libraries, contact Arm Support at https://developer.arm.com/support.

Support
=======

The documentation that is available for Arm Performance Libraries is listed on
the product downloads page on the Arm Developer website:

  https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-performance-libraries

Reference documentation for the supported routines in Arm Performance Libraries
is available at:

  https://developer.arm.com/docs/101004/latest

If you have any issues with the installation, content or use of this release,
create a post that describes your issue on the Arm Community HPC forum:

  https://community.arm.com/developer/tools-software/hpc/f/hpc-user-group

Arm will respond as soon as possible.

These deliverables are being released under the terms of the agreement between
Arm and each licensee (the “Agreement”). All planned verification and
validation is complete. The release is suitable for volume production under
the terms of the Agreement.

OS
--

These libraries are supported on the following Linux platforms:

- AArch64 RHEL 7 and 8
- AArch64 SLES 15
- AArch64 Ubuntu 18.04 and 20.04
- Amazon Linux 2022 (AL 2022)

Full information about the platforms supported by Arm Performance Libraries is
available on the Arm Developer website:

  https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-performance-libraries

Release history
===============

A full release history (with release notes) for Arm Performance Libraries is
available on the Arm Developer website:

  https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-performance-libraries/release-history

Glossary
========

The Arm Glossary is a list of terms that are used in Arm documentation, together
with definitions for those terms. The Arm Glossary does not contain terms that
are industry standard unless the Arm meaning differs from the generally accepted
meaning.

See the Arm Glossary for more information: https://developer.arm.com/glossary.

Non-Confidential Proprietary Notice
===================================

This document is protected by copyright and other related rights and the
practice or implementation of the information contained in this document may be
protected by one or more patents or pending patent applications. No part of this
document may be reproduced in any form by any means without the express prior
written permission of Arm. No license, express or implied, by estoppel or
otherwise to any intellectual property rights is granted by this document
unless specifically stated.

Your access to the information in this document is conditional upon your
acceptance that you will not use or permit others to use the information for
the purposes of determining whether implementations infringe any third party
patents.

THIS DOCUMENT IS PROVIDED “AS IS”. ARM PROVIDES NO REPRESENTATIONS AND NO
WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, INCLUDING, WITHOUT LIMITATION, THE
IMPLIED WARRANTIES OF MERCHANTABILITY, SATISFACTORY QUALITY, NON-INFRINGEMENT
OR FITNESS FOR A PARTICULAR PURPOSE WITH RESPECT TO THE DOCUMENT. For the
avoidance of doubt, Arm makes no representation with respect to, and has
undertaken no analysis to identify or understand the scope and content of,
patents, copyrights, trade secrets, or other rights.

This document may include technical inaccuracies or typographical errors.

TO THE EXTENT NOT PROHIBITED BY LAW, IN NO EVENT WILL ARM BE LIABLE FOR ANY
DAMAGES, INCLUDING WITHOUT LIMITATION ANY DIRECT, INDIRECT, SPECIAL,
INCIDENTAL, PUNITIVE, OR CONSEQUENTIAL DAMAGES, HOWEVER CAUSED AND REGARDLESS
OF THE THEORY OF LIABILITY, ARISING OUT OF ANY USE OF THIS DOCUMENT, EVEN IF
ARM HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

This document consists solely of commercial items. You shall be responsible for
ensuring that any use, duplication or disclosure of this document complies fully
with any relevant export laws and regulations to assure that this document or
any portion thereof is not exported, directly or indirectly, in violation of
such export laws. Use of the word “partner” in reference to Arm’s customers is
not intended to create or refer to any partnership relationship with any other
company. Arm may make changes to this document at any time and without notice.

This document may be translated into other languages for convenience, and you
agree that if there is any conflict between the English version of this document
and any translation, the terms of the English version of the Agreement shall
prevail.

The Arm corporate logo and words marked with ® or ™ are registered trademarks or
trademarks of Arm Limited (or its affiliates) in the US and/or elsewhere. All
rights reserved. Other brands and names mentioned in this document may be the
trademarks of their respective owners. Please follow Arm’s trademark usage
guidelines at https://www.arm.com/company/policies/trademarks.

Copyright © [2015, 2022] Arm Limited (or its affiliates). All rights reserved.

Arm Limited. Company 02557590 registered in England.

110 Fulbourn Road, Cambridge, England CB1 9NJ.

(LES-PRE-20349)

Confidentiality Status
----------------------

This document is Non-Confidential. The right to use, copy and disclose this
document may be subject to license restrictions in accordance with the terms
of the agreement entered into by Arm and the party that Arm delivered this
document to.

Unrestricted Access is an Arm internal classification.

Product Status
--------------

The information in this document is Final, that is for a developed product.

Web Address
-----------

https://developer.arm.com

Inclusive language commitment
-----------------------------

Arm values inclusive communities. Arm recognizes that we and our industry have
used language that can be offensive. Arm strives to lead the industry and create
change.

We believe that this document contains no offensive terms. To report offensive
language in this document, email terms@arm.com.

Arm Performance Libraries 22.0.1 Release Note
=============================================

Non-Confidential
Copyright © [2015, 2022] Arm Limited (or its affiliates). All rights reserved.

Arm conventions and proprietary notices, including confidentiality status,
terminology statement, and product release status, can be found at the end of
this document.

Contents
========

- Release overview
- Release contents
- Get started
- Support
- Release history
- Glossary
- Proprietary notices

Release overview
================

Use of the free of charge version of Arm Performance Libraries is subject to the
terms and conditions of the applicable End User License Agreement (“EULA”). A
copy of the EULA can be found in the 'license_terms' folder of your product
installation.

Product description
-------------------

The freely distributed version of Arm Performance Libraries contains optimized
math functions, such as linear algebra and Fast Fourier Transforms, for Arm
AArch64 implementations, including those with SVE. It is compatible with GCC
10.2.

Arm Performance Libraries is optimized for a number of microarchitectures. The
latest information is available on the Arm Developer website:

https://developer.arm.com/tools-and-software/server-and-hpc/compile/arm-compiler-for-linux/resources/supported-platforms

Release status
--------------

This is the 22.0.1 release of Arm Performance Libraries.

These deliverables are being released under the terms of the agreement between
Arm and each licensee (the "Agreement"). All planned verification and
validation is complete.
The release is suitable for volume production under the terms of the Agreement.

Release contents
================

The following sub-sections describe:
- The product parts that are delivered as part of this release.
- Any changes since the previous release.
- Any known issues and limitations that exist at the time of this release.

Deliverables
------------

- Arm Performance Libraries 22.0.1
- Release Notes (this document)
- Documentation

  Product documentation is available on the Arm Developer website. See the
  'Documentation' section on:

  https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-performance-libraries

  Documentation and release notes might change between product releases. For the
  latest documentation bundle, check the product download page.

  Arm tests PDFs only in Adobe Acrobat and Acrobat Reader. Arm cannot guarantee
  the quality of its PDFs when used with any other PDF reader. Adobe reader
  products are available at https://www.adobe.com.

Differences from previous release
---------------------------------

The following subsections describe differences from the previous release of
Arm Performance Libraries.

Additions and changes:
~~~~~~~~~~~~~~~~~~~~~~

There are no new features or components added, or any technical changes to
features or components, in the 22.0.1 release.

This section describes the new features or components added, or any technical
changes to features or components, in the 22.0.0 release.

- The freely distributed version of Arm Performance Libraries is now optimized
  for more microarchitectures, including:

  * Neoverse N1 (such as Amazon Graviton 2 and Ampere Altra)

  * Neoverse V1

  * Neoverse N2

  * Fujitsu A64FX

  * Marvell ThunderX2

- Improved the performance for:

  * BLAS level 1 routines: SVE optimizations for ?COPY, ?SCAL, ?AXPY

  * BLAS level 2 routines: packed and banded functionality; ?TRMV and ?TRSV
  for large problems

  * BLAS level 3 routines: ?TRMM and ?TRSM for large problems

  * LAPACK routines: ?EEVD (eigenvalue decomposition) for small problems;
  ?POTRF for multithreaded cases

- Added support for I?AMIN BLAS extension routines for all types, finding the
  location of the first minimum value in a vector.

- Added support for LAPACK version 3.10.0. In addition, an out of bounds bug
  in LAPACK ?LARRV routines (CVE-2021-4048) has been patched.

- Performance improvements in libamath, for:

  * atan, atanf (vector)

  * atan2, atan2f (scalar & vector)

  * cos, cosf (vector)

  * erfc, erfcf (vector)

  * exp, expf (vector)

  * logf (vector)

  * pow (vector)

  * sin, sinf (vector)

  * tanf (vector)

- When using Arm Performance Libraries built for GCC, C/C++ users do not need
  to link to libgfortran.


Resolved issues:
~~~~~~~~~~~~~~~~

There are no resolved issues to report in the 22.0.1 release.


Known limitations
-----------------

The following subsection describes any issues known at the time of this release.

Open technical issues:
~~~~~~~~~~~~~~~~~~~~~~

There are no open technical issues in the 22.0.1 release.


Get started
===========

This section describes information to help you get started with accessing,
setting up, and using Arm Performance Libraries.

For more information, see the Get Started information on the Arm Developer
website:

  https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-performance-libraries

Licensing information
---------------------

Use of the free of charge version of Arm Performance Libraries is subject to the
terms and conditions of the applicable End User License Agreement (“EULA”). A
copy of the EULA can be found in the 'license_terms' folder of your product
installation.

You do not require a license to use this Arm Performance Libraries package.

Prerequisites
-------------

If any of the following tools are not already installed by your Linux
distribution, you must install them before installing Arm Performance Libraries:

- Python (version 2.7 or later)
- C Libraries:
   - SLES and RHEL: glibc-devel
   - Ubuntu:        libc6-dev

Download the product
--------------------

Arm delivers the files through the Arm Developer website:

  https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-performance-libraries

Unpack the product
------------------

The following steps describe how to unpack each constituent part delivered in
this bundle:

1. Relocate the bundle file. Move the .tar files to the directory you want to
   install the product in.

2. Extract the tar file contents using a tar utility:

     tar -xvf <package_name>.tar

Directory structure:
--------------------

Shows the principal directory structure of this release created after unpacking
the bundle:

  license_terms/
  arm-performance-libraries_<version>_*.sh
  RELEASE_NOTES.txt

Install the product
-------------------

To install Arm Performance Libraries, navigate into the extracted package
directory (<package_name>) and run the installation script as a privileged user.
Pass any options to configure the installation:

  cd path/to/<package_name>/
  ./arm-performance-libraries_<version>_*.sh [option]...

Some common installation options are:

- For a headless installation and to automatically accept the EULA, use
  the '--accept' option.
- To perform a local install, use the '--install-to <dir>' option.

For a full list of supported installation options, see:

  https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-performance-libraries

The installer displays the EULA and prompts you to agree to the terms. Type
'yes' at the prompt to continue.

The packages are unpacked to
<install_location>/arm-performance-libraries_22.0.1_gcc-10.2,
and <install_location>/armpl_22.0.1_gcc-10.2,
with environment modulefiles available under <install_location>/modulefiles. The
default installation location is /opt/arm/. Local installs have the same
directory structure starting from your chosen installation root.

RPMs
----

The installed packages are shipped as RPMs for RPM based Linux distributions.
These RPMs are signed by Arm's High Performance Computing (HPC) GPG key. The
public key can be downloaded from:

  https://developer.arm.com/-/media/files/keys/GPG-PUB-KEY-ARM-HPC-SW-TOOLS.PUB

This key can be imported by running:

  rpm --import GPG-PUB-KEY-ARM-HPC-SW-TOOLS.PUB

More information about Environment Modules can be found at:

http://modules.sourceforge.net

Run the product
---------------

1. Load the environment module.

     module load <install_location>/modulefiles/armpl/22.0.1_gcc-10.2

2. To generate an executable binary with GCC, compile your program with Arm
   Performance Libraries. Use:

     gcc -I<install_dir>/include -L<install_dir>/lib <-larmpl> -lm [options] -o <binary> <input>

   or

     gfortran -I<install_dir>/include -L<install_dir>/lib <-larmpl> -lm [options] -o <binary> <input>

   where:

   - <-larmpl> is one of: -larmpl, -larmpl_lp64, -larmpl_ilp64, -larmpl_lp64_mp,
     or -larmpl_ilp64_mp.
   - [options] denotes any other GCC compiler options
   - <input> is the source file (or files)
   - <binary> is the application executable to build

3. Run the generated binary <binary>:

     ./<binary>

Examples
--------

Example code can be found at:

<install_location>/armpl_22.0.1_gcc-10.2/examples*

Multiple examples directories are provided in the installation. The suffix of
the directory name indicates whether the examples inside link to the 32-bit
('_lp64') or 64-bit ('_ilp64') integer variants, and sequential (no suffix
indicator) or OpenMP ('_mp') multi-threaded variants, of Arm Performance
Libraries.

The default set of examples in the 'examples' directory link to the sequential,
32-bit integers variant of Arm Performance Libraries.

You need to copy this code to a writeable directory and load Arm Performance
Libraries environment module for the examples to build.

For example:

1. Copy the default 'examples' directory somewhere writeable:

     cp -r <install_location>/armpl_22.0.1_gcc-10.2/examples ./
     cd examples

2. Load the correct environment modules:

     module load <install_location>/modulefiles/armpl/22.0.1_gcc-10.2

3. Build the examples:

     make

For more information about the Arm Performance Libraries examples, see:

https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-performance-libraries/get-started-with-armpl-free-version/compile-an-example

Uninstall
---------

For convenience, this package includes an "uninstall.sh" script at:

  <install_location>/arm-performance-libraries_22.0.1_gcc-10.2/uninstall.sh

This script attempts to uninstall all the components supplied as part of
Arm Performance Libraries. However, if other packages outside of this product
depend on the GCC component, GCC will not be uninstalled.

If you require support when uninstalling any version of Arm Performance
Libraries, contact Arm Support at https://developer.arm.com/support.

Support
=======

The documentation that is available for Arm Performance Libraries is listed on
the product downloads page on the Arm Developer website:

  https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-performance-libraries

Reference documentation for the supported routines in Arm Performance Libraries
is available at:

  https://developer.arm.com/docs/101004/latest

If you have any issues with the installation, content or use of this release,
create a post that describes your issue on the Arm Community HPC forum:

  https://community.arm.com/developer/tools-software/hpc/f/hpc-user-group

Arm will respond as soon as possible.

These deliverables are being released under the terms of the agreement between
Arm and each licensee (the “Agreement”). All planned verification and
validation is complete. The release is suitable for volume production under
the terms of the Agreement.

OS
--

These libraries are supported on the following Linux platforms:

- AArch64 RHEL 7 and 8
- AArch64 SLES 15
- AArch64 Ubuntu 18.04 and 20.04
- Amazon Linux 2022 (AL 2022)

Full information about the platforms supported by Arm Performance Libraries is
available on the Arm Developer website:

  https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-performance-libraries

Release history
===============

A full release history (with release notes) for Arm Performance Libraries is
available on the Arm Developer website:

  https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-performance-libraries/release-history

Glossary
========

The Arm Glossary is a list of terms that are used in Arm documentation, together
with definitions for those terms. The Arm Glossary does not contain terms that
are industry standard unless the Arm meaning differs from the generally accepted
meaning.

See the Arm Glossary for more information: https://developer.arm.com/glossary.

Non-Confidential Proprietary Notice
===================================

This document is protected by copyright and other related rights and the
practice or implementation of the information contained in this document may be
protected by one or more patents or pending patent applications. No part of this
document may be reproduced in any form by any means without the express prior
written permission of Arm. No license, express or implied, by estoppel or
otherwise to any intellectual property rights is granted by this document
unless specifically stated.

Your access to the information in this document is conditional upon your
acceptance that you will not use or permit others to use the information for
the purposes of determining whether implementations infringe any third party
patents.

THIS DOCUMENT IS PROVIDED “AS IS”. ARM PROVIDES NO REPRESENTATIONS AND NO
WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, INCLUDING, WITHOUT LIMITATION, THE
IMPLIED WARRANTIES OF MERCHANTABILITY, SATISFACTORY QUALITY, NON-INFRINGEMENT
OR FITNESS FOR A PARTICULAR PURPOSE WITH RESPECT TO THE DOCUMENT. For the
avoidance of doubt, Arm makes no representation with respect to, and has
undertaken no analysis to identify or understand the scope and content of,
patents, copyrights, trade secrets, or other rights.

This document may include technical inaccuracies or typographical errors.

TO THE EXTENT NOT PROHIBITED BY LAW, IN NO EVENT WILL ARM BE LIABLE FOR ANY
DAMAGES, INCLUDING WITHOUT LIMITATION ANY DIRECT, INDIRECT, SPECIAL,
INCIDENTAL, PUNITIVE, OR CONSEQUENTIAL DAMAGES, HOWEVER CAUSED AND REGARDLESS
OF THE THEORY OF LIABILITY, ARISING OUT OF ANY USE OF THIS DOCUMENT, EVEN IF
ARM HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

This document consists solely of commercial items. You shall be responsible for
ensuring that any use, duplication or disclosure of this document complies fully
with any relevant export laws and regulations to assure that this document or
any portion thereof is not exported, directly or indirectly, in violation of
such export laws. Use of the word “partner” in reference to Arm’s customers is
not intended to create or refer to any partnership relationship with any other
company. Arm may make changes to this document at any time and without notice.

This document may be translated into other languages for convenience, and you
agree that if there is any conflict between the English version of this document
and any translation, the terms of the English version of the Agreement shall
prevail.

The Arm corporate logo and words marked with ® or ™ are registered trademarks or
trademarks of Arm Limited (or its affiliates) in the US and/or elsewhere. All
rights reserved. Other brands and names mentioned in this document may be the
trademarks of their respective owners. Please follow Arm’s trademark usage
guidelines at https://www.arm.com/company/policies/trademarks.

Copyright © [2015, 2022] Arm Limited (or its affiliates). All rights reserved.

Arm Limited. Company 02557590 registered in England.

110 Fulbourn Road, Cambridge, England CB1 9NJ.

(LES-PRE-20349)

Confidentiality Status
----------------------

This document is Non-Confidential. The right to use, copy and disclose this
document may be subject to license restrictions in accordance with the terms
of the agreement entered into by Arm and the party that Arm delivered this
document to.

Unrestricted Access is an Arm internal classification.

Product Status
--------------

The information in this document is Final, that is for a developed product.

Web Address
-----------

https://developer.arm.com

Inclusive language commitment
-----------------------------

Arm values inclusive communities. Arm recognizes that we and our industry have
used language that can be offensive. Arm strives to lead the industry and create
change.

We believe that this document contains no offensive terms. To report offensive
language in this document, email terms@arm.com.

Arm Performance Libraries 22.0.1 Release Note
=============================================

Non-Confidential
Copyright © [2015, 2022] Arm Limited (or its affiliates). All rights reserved.

Arm conventions and proprietary notices, including confidentiality status,
terminology statement, and product release status, can be found at the end of
this document.

Contents
========

- Release overview
- Release contents
- Get started
- Support
- Release history
- Glossary
- Proprietary notices

Release overview
================

Use of the free of charge version of Arm Performance Libraries is subject to the
terms and conditions of the applicable End User License Agreement (“EULA”). A
copy of the EULA can be found in the 'license_terms' folder of your product
installation.

Product description
-------------------

The freely distributed version of Arm Performance Libraries contains optimized
math functions, such as linear algebra and Fast Fourier Transforms, for Arm
AArch64 implementations, including those with SVE. It is compatible with GCC
11.2.

Arm Performance Libraries is optimized for a number of microarchitectures. The
latest information is available on the Arm Developer website:

https://developer.arm.com/tools-and-software/server-and-hpc/compile/arm-compiler-for-linux/resources/supported-platforms

Release status
--------------

This is the 22.0.1 release of Arm Performance Libraries.

These deliverables are being released under the terms of the agreement between
Arm and each licensee (the "Agreement"). All planned verification and
validation is complete.
The release is suitable for volume production under the terms of the Agreement.

Release contents
================

The following sub-sections describe:
- The product parts that are delivered as part of this release.
- Any changes since the previous release.
- Any known issues and limitations that exist at the time of this release.

Deliverables
------------

- Arm Performance Libraries 22.0.1
- Release Notes (this document)
- Documentation

  Product documentation is available on the Arm Developer website. See the
  'Documentation' section on:

  https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-performance-libraries

  Documentation and release notes might change between product releases. For the
  latest documentation bundle, check the product download page.

  Arm tests PDFs only in Adobe Acrobat and Acrobat Reader. Arm cannot guarantee
  the quality of its PDFs when used with any other PDF reader. Adobe reader
  products are available at https://www.adobe.com.

Differences from previous release
---------------------------------

The following subsections describe differences from the previous release of
Arm Performance Libraries.

Additions and changes:
~~~~~~~~~~~~~~~~~~~~~~

There are no new features or components added, or any significant technical
changes to features or components, in the 22.0.1 release.

This section describes the new features or components added, or any technical
changes to features or components, in the 22.0.0 release.

- The freely distributed version of Arm Performance Libraries is now optimized
  for more microarchitectures, including:

  * Neoverse N1 (such as Amazon Graviton 2 and Ampere Altra)

  * Neoverse V1

  * Neoverse N2

  * Fujitsu A64FX

  * Marvell ThunderX2

- Improved the performance for:

  * BLAS level 1 routines: SVE optimizations for ?COPY, ?SCAL, ?AXPY

  * BLAS level 2 routines: packed and banded functionality; ?TRMV and ?TRSV
  for large problems

  * BLAS level 3 routines: ?TRMM and ?TRSM for large problems

  * LAPACK routines: ?EEVD (eigenvalue decomposition) for small problems;
  ?POTRF for multithreaded cases

- Added support for I?AMIN BLAS extension routines for all types, finding the
  location of the first minimum value in a vector.

- Added support for LAPACK version 3.10.0. In addition, an out of bounds bug
  in LAPACK ?LARRV routines (CVE-2021-4048) has been patched.

- Performance improvements in libamath, for:

  * atan, atanf (vector)

  * atan2, atan2f (scalar & vector)

  * cos, cosf (vector)

  * erfc, erfcf (vector)

  * exp, expf (vector)

  * logf (vector)

  * pow (vector)

  * sin, sinf (vector)

  * tanf (vector)

- When using Arm Performance Libraries built for GCC, C/C++ users do not need
  to link to libgfortran.


Resolved issues:
~~~~~~~~~~~~~~~~

There are no resolved issues to report in the 22.0.1 release.

Known limitations
-----------------

The following subsection describes any issues known at the time of this release.

Open technical issues:
~~~~~~~~~~~~~~~~~~~~~~

There are no open technical issues in the 22.0.1 release.


Get started
===========

This section describes information to help you get started with accessing,
setting up, and using Arm Performance Libraries.

For more information, see the Get Started information on the Arm Developer
website:

  https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-performance-libraries

Licensing information
---------------------

Use of the free of charge version of Arm Performance Libraries is subject to the
terms and conditions of the applicable End User License Agreement (“EULA”). A
copy of the EULA can be found in the 'license_terms' folder of your product
installation.

You do not require a license to use this Arm Performance Libraries package.

Prerequisites
-------------

If any of the following tools are not already installed by your Linux
distribution, you must install them before installing Arm Performance Libraries:

- Python (version 2.7 or later)
- C Libraries:
   - SLES and RHEL: glibc-devel
   - Ubuntu:        libc6-dev

Download the product
--------------------

Arm delivers the files through the Arm Developer website:

  https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-performance-libraries

Unpack the product
------------------

The following steps describe how to unpack each constituent part delivered in
this bundle:

1. Relocate the bundle file. Move the .tar files to the directory you want to
   install the product in.

2. Extract the tar file contents using a tar utility:

     tar -xvf <package_name>.tar

Directory structure:
--------------------

Shows the principal directory structure of this release created after unpacking
the bundle:

  license_terms/
  arm-performance-libraries_<version>_*.sh
  RELEASE_NOTES.txt

Install the product
-------------------

To install Arm Performance Libraries, navigate into the extracted package
directory (<package_name>) and run the installation script as a privileged user.
Pass any options to configure the installation:

  cd path/to/<package_name>/
  ./arm-performance-libraries_<version>_*.sh [option]...

Some common installation options are:

- For a headless installation and to automatically accept the EULA, use
  the '--accept' option.
- To perform a local install, use the '--install-to <dir>' option.

For a full list of supported installation options, see:

  https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-performance-libraries

The installer displays the EULA and prompts you to agree to the terms. Type
'yes' at the prompt to continue.

The packages are unpacked to
<install_location>/arm-performance-libraries_22.0.1_gcc-11.2,
and <install_location>/armpl_22.0.1_gcc-11.2,
with environment modulefiles available under <install_location>/modulefiles. The
default installation location is /opt/arm/. Local installs have the same
directory structure starting from your chosen installation root.

RPMs
----

The installed packages are shipped as RPMs for RPM based Linux distributions.
These RPMs are signed by Arm's High Performance Computing (HPC) GPG key. The
public key can be downloaded from:

  https://developer.arm.com/-/media/files/keys/GPG-PUB-KEY-ARM-HPC-SW-TOOLS.PUB

This key can be imported by running:

  rpm --import GPG-PUB-KEY-ARM-HPC-SW-TOOLS.PUB

More information about Environment Modules can be found at:

http://modules.sourceforge.net

Run the product
---------------

1. Load the environment module.

     module load <install_location>/modulefiles/armpl/22.0.1_gcc-11.2

2. To generate an executable binary with GCC, compile your program with Arm
   Performance Libraries. Use:

     gcc -I<install_dir>/include -L<install_dir>/lib <-larmpl> -lm [options] -o <binary> <input>

   or

     gfortran -I<install_dir>/include -L<install_dir>/lib <-larmpl> -lm [options] -o <binary> <input>

   where:

   - <-larmpl> is one of: -larmpl, -larmpl_lp64, -larmpl_ilp64, -larmpl_lp64_mp,
     or -larmpl_ilp64_mp.
   - [options] denotes any other GCC compiler options
   - <input> is the source file (or files)
   - <binary> is the application executable to build

3. Run the generated binary <binary>:

     ./<binary>

Examples
--------

Example code can be found at:

<install_location>/armpl_22.0.1_gcc-11.2/examples*

Multiple examples directories are provided in the installation. The suffix of
the directory name indicates whether the examples inside link to the 32-bit
('_lp64') or 64-bit ('_ilp64') integer variants, and sequential (no suffix
indicator) or OpenMP ('_mp') multi-threaded variants, of Arm Performance
Libraries.

The default set of examples in the 'examples' directory link to the sequential,
32-bit integers variant of Arm Performance Libraries.

You need to copy this code to a writeable directory and load Arm Performance
Libraries environment module for the examples to build.

For example:

1. Copy the default 'examples' directory somewhere writeable:

     cp -r <install_location>/armpl_22.0.1_gcc-11.2/examples ./
     cd examples

2. Load the correct environment modules:

     module load <install_location>/modulefiles/armpl/22.0.1_gcc-11.2

3. Build the examples:

     make

For more information about the Arm Performance Libraries examples, see:

https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-performance-libraries/get-started-with-armpl-free-version/compile-an-example

Uninstall
---------

For convenience, this package includes an "uninstall.sh" script at:

  <install_location>/arm-performance-libraries_22.0.1_gcc-11.2/uninstall.sh

This script attempts to uninstall all the components supplied as part of
Arm Performance Libraries. However, if other packages outside of this product
depend on the GCC component, GCC will not be uninstalled.

If you require support when uninstalling any version of Arm Performance
Libraries, contact Arm Support at https://developer.arm.com/support.

Support
=======

The documentation that is available for Arm Performance Libraries is listed on
the product downloads page on the Arm Developer website:

  https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-performance-libraries

Reference documentation for the supported routines in Arm Performance Libraries
is available at:

  https://developer.arm.com/docs/101004/latest

If you have any issues with the installation, content or use of this release,
create a post that describes your issue on the Arm Community HPC forum:

  https://community.arm.com/developer/tools-software/hpc/f/hpc-user-group

Arm will respond as soon as possible.

These deliverables are being released under the terms of the agreement between
Arm and each licensee (the “Agreement”). All planned verification and
validation is complete. The release is suitable for volume production under
the terms of the Agreement.

OS
--

These libraries are supported on the following Linux platforms:

- AArch64 RHEL 7 and 8
- AArch64 SLES 15
- AArch64 Ubuntu 18.04 and 20.04
- Amazon Linux 2022 (AL 2022)

Full information about the platforms supported by Arm Performance Libraries is
available on the Arm Developer website:

  https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-performance-libraries

Release history
===============

A full release history (with release notes) for Arm Performance Libraries is
available on the Arm Developer website:

  https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-performance-libraries/release-history

Glossary
========

The Arm Glossary is a list of terms that are used in Arm documentation, together
with definitions for those terms. The Arm Glossary does not contain terms that
are industry standard unless the Arm meaning differs from the generally accepted
meaning.

See the Arm Glossary for more information: https://developer.arm.com/glossary.

Non-Confidential Proprietary Notice
===================================

This document is protected by copyright and other related rights and the
practice or implementation of the information contained in this document may be
protected by one or more patents or pending patent applications. No part of this
document may be reproduced in any form by any means without the express prior
written permission of Arm. No license, express or implied, by estoppel or
otherwise to any intellectual property rights is granted by this document
unless specifically stated.

Your access to the information in this document is conditional upon your
acceptance that you will not use or permit others to use the information for
the purposes of determining whether implementations infringe any third party
patents.

THIS DOCUMENT IS PROVIDED “AS IS”. ARM PROVIDES NO REPRESENTATIONS AND NO
WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, INCLUDING, WITHOUT LIMITATION, THE
IMPLIED WARRANTIES OF MERCHANTABILITY, SATISFACTORY QUALITY, NON-INFRINGEMENT
OR FITNESS FOR A PARTICULAR PURPOSE WITH RESPECT TO THE DOCUMENT. For the
avoidance of doubt, Arm makes no representation with respect to, and has
undertaken no analysis to identify or understand the scope and content of,
patents, copyrights, trade secrets, or other rights.

This document may include technical inaccuracies or typographical errors.

TO THE EXTENT NOT PROHIBITED BY LAW, IN NO EVENT WILL ARM BE LIABLE FOR ANY
DAMAGES, INCLUDING WITHOUT LIMITATION ANY DIRECT, INDIRECT, SPECIAL,
INCIDENTAL, PUNITIVE, OR CONSEQUENTIAL DAMAGES, HOWEVER CAUSED AND REGARDLESS
OF THE THEORY OF LIABILITY, ARISING OUT OF ANY USE OF THIS DOCUMENT, EVEN IF
ARM HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

This document consists solely of commercial items. You shall be responsible for
ensuring that any use, duplication or disclosure of this document complies fully
with any relevant export laws and regulations to assure that this document or
any portion thereof is not exported, directly or indirectly, in violation of
such export laws. Use of the word “partner” in reference to Arm’s customers is
not intended to create or refer to any partnership relationship with any other
company. Arm may make changes to this document at any time and without notice.

This document may be translated into other languages for convenience, and you
agree that if there is any conflict between the English version of this document
and any translation, the terms of the English version of the Agreement shall
prevail.

The Arm corporate logo and words marked with ® or ™ are registered trademarks or
trademarks of Arm Limited (or its affiliates) in the US and/or elsewhere. All
rights reserved. Other brands and names mentioned in this document may be the
trademarks of their respective owners. Please follow Arm’s trademark usage
guidelines at https://www.arm.com/company/policies/trademarks.

Copyright © [2015, 2022] Arm Limited (or its affiliates). All rights reserved.

Arm Limited. Company 02557590 registered in England.

110 Fulbourn Road, Cambridge, England CB1 9NJ.

(LES-PRE-20349)

Confidentiality Status
----------------------

This document is Non-Confidential. The right to use, copy and disclose this
document may be subject to license restrictions in accordance with the terms
of the agreement entered into by Arm and the party that Arm delivered this
document to.

Unrestricted Access is an Arm internal classification.

Product Status
--------------

The information in this document is Final, that is for a developed product.

Web Address
-----------

https://developer.arm.com

Inclusive language commitment
-----------------------------

Arm values inclusive communities. Arm recognizes that we and our industry have
used language that can be offensive. Arm strives to lead the industry and create
change.

We believe that this document contains no offensive terms. To report offensive
language in this document, email terms@arm.com.