Sign-up to receive product updates
Sign up to our low-traffic, text-only mailing list to hear about new patch releases and major updates to Arm Forge.
ARM’s developer website includes documentation, tutorials, support resources and more.
Over the next few months we will be adding more developer resources and documentation for all the products and technologies that ARM provides.
CloseSorry, your browser is not supported. We recommend upgrading your browser. We have done our best to make all the documentation and resources available on old versions of Internet Explorer, but vector image support and the layout may not be optimal. Technical documentation is available as a PDF Download.
This page describes the changes between releases of Arm Forge.
To download and install the latest version of Arm Forge, see our downloads page and follow the installation steps given in the Arm Forge user guide.
For more compatibility information, see our known issues and supported platforms topics.
Arm Forge 22.1 covers the following releases:
Arm Forge:
Arm DDT:
Arm MAP and Performance Reports:
Arm Forge:
Arm DDT:
Arm MAP and Performance Reports:
Arm Forge:
Arm DDT:
Arm MAP and Performance Reports:
Arm Forge:
Arm DDT:
Arm MAP and Performance Reports:
Arm Forge:
Arm DDT:
Arm MAP and Performance Reports:
Arm Forge:
Arm DDT:
Arm MAP and Performance Reports:
Arm Forge:
Arm DDT:
Arm MAP and Performance Reports:
Arm Forge:
Arm DDT:
Arm MAP and Performance Reports:
The following features have been deprecated in this release, and might be removed in a future version:
If you rely on this functionality, please send an email to support-hpc-sw@arm.com. Arm will respond as soon as possible.
Please refer to the known issues page.
Arm Forge 22.1.3 Release Note
================================
Copyright (c) 2017-2023 Arm Limited (or its affiliates). All rights reserved.
Copyright (c) 2002-2017 Allinea Software Limited.
Arm 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
================
Product description
-------------------
Arm Forge 22.1.3 combines Arm DDT, Arm MAP, and Arm Performance Reports. Arm DDT is the leading debugger for time-saving high-performance application debugging. Arm MAP is the trusted performance profiler for invaluable optimization advice across native and Python HPC codes. Arm Performance Reports provides advanced reporting capabilities.
This release includes enhancements and bug fixes.
Release status
--------------
This is the 22.1.3 release of Arm Forge.
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 subsections detail:
- The component 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 Forge, which includes:
- Arm DDT
- Arm MAP
- Arm Performance Reports
- Release Notes (this document, also available at:
https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-forge/release-history)
- Documentation is available in the documentation area of your product installation or online at:
https://developer.arm.com/documentation/101136/22-1-3
Information about how to use the Arm HPC tools to debug, profile, and analyze many common scientific applications are available on the Arm Developer website:
https://developer.arm.com/tools-and-software/server-and-hpc/debug-and-profile/arm-forge
Further documentation about all the tools can be found online at:
https://developer.arm.com/tools-and-software/server-and-hpc/help
Documentation can change between product releases. For the latest product documentation, check the software downloads page on the Arm Developer website at:
https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-forge
Arm tests its 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
---------------------------------
Differences from the previous release of Arm Forge are detailed in the following subsections.
Additions and changes
~~~~~~~~~~~~~~~~~~~~~
- Arm Forge:
None in this release.
- Arm DDT:
None in this release.
- Arm MAP and Arm Performance Reports:
None in this release.
Resolved issues
~~~~~~~~~~~~~~~
- Arm Forge:
[FOR-17351] Added support for Open MPI's --mca mca_base_env_list flag.
[FOR-17562] Fixed Cray PALS autodetection when aprun launcher is specified.
[FOR-17576] Fixed setting breakpoints on CUDA 11.4+ compiled code.
- Arm DDT:
[FOR-17087] Fixed MDA visualizer missing menu items on MacOS.
[FOR-17244] Fixed variable view resizing depending on variable type.
- Arm MAP and Arm Performance Reports:
None in this release.
Deprecated features
~~~~~~~~~~~~~~~~~~~
The following features have been deprecated in this release, and might be removed in a future version:
- Support for the IBM Power (ppc64le) architecture.
- Support for CUDA 10 Debugging.
- Support for CUDA 10 Profiling.
If you rely on this functionality, please send an email to support-hpc-sw@arm.com. Arm will respond as soon as possible.
Known limitations
-----------------
See the known issues section on the Arm Developer website:
https://developer.arm.com/documentation/101136/22-1-3/Known-issues-and-notes/Known-issues
Get started
===========
This section describes how to get started with accessing, setting up, and using Arm Forge.
For more information, see:
https://developer.arm.com/tools-and-software/server-and-hpc/debug-and-profile/arm-forge/resources/get-started
Licensing information
---------------------
Arm Forge requires a valid license to run.
Note: You do not need to install a license file on a machine that is running the Remote Client for connecting remotely to Arm Forge products. The license is only required on the machine on which Arm Forge is installed.
To request a license, go to:
https://store.developer.arm.com/store/high-performance-computing-hpc-tools/arm-forge
To request an evaluation license, go to:
https://pages.arm.com/Hpc-trial-request.html
For more information about Arm HPC tools licensing, see:
https://developer.arm.com/tools-and-software/server-and-hpc/debug-and-profile/arm-forge/licensing
When you have obtained a license file from Arm, download and install the appropriate platform version of the product here:
https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-forge
See the Arm Forge User Guide for installation methods, such as using the command-line interface and using the GUI to install Arm Forge on Windows, Linux, and MAC, at:
https://developer.arm.com/documentation/101136/22-1-3/Arm-Forge/Installing-Arm-Forge
Run the product
---------------
See the Arm Forge User Guide for information about running each of the tools, Arm DDT, Arm MAP, and Arm Performance Reports:
https://developer.arm.com/documentation/101136/22-1-3/Arm-Forge/Connecting-to-a-remote-system/Starting-Arm-Forge
Configure the product
---------------------
To learn how to configure the Arm Forge tools, see the user guide at:
https://developer.arm.com/documentation/101136/22-1-3/Configuration
Examples
--------
A range of example applications are provided with the product installation that you can use alongside information in the User Guide to explore Arm Forge functionality.
The example applications are located in the <install_directory>/examples directory.
Support
-------
If you have any issues with the installation, content, or use of this release, please send an email to support-hpc-sw@arm.com. 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.
Note: Support for this release of the product is only provided by Arm to partners who have a current support and maintenance contract for the product.
Tools
-----
Full information about the supported platforms for Arm Forge are available on the Developer website:
https://developer.arm.com/documentation/101136/22-1-3/Supported-platforms/Reference-table
Release history
===============
A full release history for Arm Forge is available at:
https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-forge/release-history
Glossary
========
The Arm Glossary is a list of terms 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.
Proprietary notices
===================
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 http://www.arm.com/company/policies/trademarks.
Copyright (c) 2017-2023 Arm Limited (or its affiliates). All rights reserved.
Copyright (c) 2002-2017 Allinea Software Limited.
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
-----------
http://www.arm.com
Progressive terminology statement
---------------------------------
Arm values inclusive communities. Arm recognizes that we and our industry have used terms that can be offensive. Arm strives to lead the industry and create change.
If you find offensive terms in this document, please email terms@arm.com.
Arm Forge 22.0 covers the following releases:
Arm Forge:
Arm DDT:
Arm MAP and Performance Reports:
Arm Forge:
Arm DDT:
Arm MAP and Arm Performance Reports:
None in this release.
Arm Forge:
None in this release.
Arm DDT:
Arm MAP and Performance Reports:
Arm Forge:
Arm DDT:
Arm MAP and Arm Performance Reports:
None in this release.
Arm Forge:
Arm DDT:
Arm MAP and Performance Reports:
Arm Forge:
Arm DDT:
Arm MAP and Arm Performance Reports:
Arm Forge:
Arm DDT:
Arm MAP and Performance Reports:
Arm Forge:
Arm DDT:
Arm MAP and Performance Reports:
Arm Forge:
Arm DDT:
Arm MAP and Performance Reports:
Arm Forge:
Arm DDT:
Arm MAP and Performance Reports:
The following features have been deprecated in this release, and might be removed in a future version:
If you rely on this functionality, create a ticket on https://support.developer.arm.com. Arm will respond as soon as possible.
Please refer to the known issues page.
Arm Forge 22.0.4 Release Note
================================
Copyright (c) 2017-2022 Arm Limited (or its affiliates). All rights reserved.
Copyright (c) 2002-2017 Allinea Software Limited.
Arm 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
================
Product description
-------------------
Arm Forge 22.0.4 combines Arm DDT, Arm MAP, and Arm Performance Reports. Arm DDT is the leading debugger for time-saving high-performance application debugging. Arm MAP is the trusted performance profiler for invaluable optimization advice across native and Python HPC codes. Arm Performance Reports provides advanced reporting capabilities.
This release includes enhancements and bug fixes.
Release status
--------------
This is the 22.0.4 release of Arm Forge.
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 subsections detail:
- The component 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 Forge, which includes:
- Arm DDT
- Arm MAP
- Arm Performance Reports
- Release Notes (this document, also available at:
https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-forge/release-history)
- Documentation is available in the documentation area of your product installation or online at:
https://developer.arm.com/documentation/101136/22-0-4
Information about how to use the Arm HPC tools to debug, profile, and analyze many common scientific applications are available on the Arm Developer website:
https://developer.arm.com/tools-and-software/server-and-hpc/debug-and-profile/arm-forge
Further documentation about all the tools can be found online at:
https://developer.arm.com/tools-and-software/server-and-hpc/help
Documentation can change between product releases. For the latest product documentation, check the software downloads page on the Arm Developer website at:
https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-forge
Arm tests its 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
---------------------------------
Differences from the previous release of Arm Forge are detailed in the following subsections.
Additions and changes
~~~~~~~~~~~~~~~~~~~~~
- Arm Forge:
Changed support contact details from https://developer.arm.com/support to the email address support-hpc-sw@arm.com
- Arm DDT:
None in this release.
- Arm MAP and Arm Performance Reports:
None in this release.
Resolved issues
~~~~~~~~~~~~~~~
- Arm Forge:
None in this release.
- Arm DDT:
[FOR-16324] Fixed a bug when inspecting self-referential Fortran types.
- Arm MAP and Arm Performance Reports:
None in this release.
Deprecated features
~~~~~~~~~~~~~~~~~~~
The following features have been deprecated in this release, and might be removed in a future version:
- Support for Ubuntu 19.10 and earlier (aarch64 and x86_64).
- Support for SUSE Linux Enterprise Server (SLES) 12 (x86_64).
If you rely on this functionality, please send an email to support-hpc-sw@arm.com. Arm will respond as soon as possible.
Known limitations
-----------------
See the known issues section on the Arm Developer website:
https://developer.arm.com/documentation/101136/22-0-4/Known-issues-and-notes/Known-issues
Get started
===========
This section describes how to get started with accessing, setting up, and using Arm Forge.
For more information, see:
https://developer.arm.com/tools-and-software/server-and-hpc/debug-and-profile/arm-forge/resources/get-started
Licensing information
---------------------
Arm Forge requires a valid license to run.
Note: You do not need to install a license file on a machine that is running the Remote Client for connecting remotely to Arm Forge products. The license is only required on the machine on which Arm Forge is installed.
To request a license, go to:
https://store.developer.arm.com/store/high-performance-computing-hpc-tools/arm-forge
To request an evaluation license, go to:
https://pages.arm.com/Hpc-trial-request.html
For more information about Arm HPC tools licensing, see:
https://developer.arm.com/tools-and-software/server-and-hpc/debug-and-profile/arm-forge/licensing
When you have obtained a license file from Arm, download and install the appropriate platform version of the product here:
https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-forge
See the Arm Forge User Guide for installation methods, such as using the command-line interface and using the GUI to install Arm Forge on Windows, Linux, and MAC, at:
https://developer.arm.com/documentation/101136/22-0-4/Arm-Forge/Installing-Arm-Forge
Run the product
---------------
See the Arm Forge User Guide for information about running each of the tools, Arm DDT, Arm MAP, and Arm Performance Reports:
https://developer.arm.com/documentation/101136/22-0-4/Arm-Forge/Connecting-to-a-remote-system/Starting-Arm-Forge
Configure the product
---------------------
To learn how to configure the Arm Forge tools, see the user guide at:
https://developer.arm.com/documentation/101136/22-0-4/Configuration
Examples
--------
A range of example applications are provided with the product installation that you can use alongside information in the User Guide to explore Arm Forge functionality.
The example applications are located in the <install_directory>/examples directory.
Support
-------
If you have any issues with the installation, content, or use of this release, please send an email to support-hpc-sw@arm.com. 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.
Note: Support for this release of the product is only provided by Arm to partners who have a current support and maintenance contract for the product.
Tools
-----
Full information about the supported platforms for Arm Forge are available on the Developer website:
https://developer.arm.com/documentation/101136/22-0-4/Supported-platforms/Reference-table
Release history
===============
A full release history for Arm Forge is available at:
https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-forge/release-history
Glossary
========
The Arm Glossary is a list of terms 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.
Proprietary notices
===================
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 http://www.arm.com/company/policies/trademarks.
Copyright (c) 2017-2022 Arm Limited (or its affiliates). All rights reserved.
Copyright (c) 2002-2017 Allinea Software Limited.
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
-----------
http://www.arm.com
Progressive terminology statement
---------------------------------
Arm values inclusive communities. Arm recognizes that we and our industry have used terms that can be offensive. Arm strives to lead the industry and create change.
If you find offensive terms in this document, please email terms@arm.com.
Arm Forge 21.1 covers the following releases:
Arm Forge:
Arm DDT:
Arm MAP and Performance Reports:
Arm Forge:
Arm DDT:
Arm MAP and Performance Reports:
The following features have been deprecated in this release, and might be removed in a future version:
Arm Forge:
Arm DDT:
Arm MAP and Performance Reports:
Arm Forge:
Arm DDT:
Arm MAP and Performance Reports:
The following features have been deprecated in this release, and might be removed in a future version:
Arm Forge:
Arm DDT:
Arm MAP and Performance Reports:
Arm Forge:
Arm DDT:
Arm MAP and Performance Reports:
The following features have been deprecated in this release, and might be removed in a future version:
Arm Forge:
Arm DDT:
Arm MAP and Performance Reports:
Arm Forge:
Arm DDT:
Arm MAP and Performance Reports:
The following features have been deprecated in this release, and might be removed in a future version:
Please refer to the known issues page.
Arm Forge 21.1.3 Release Note
================================
Copyright (c) 2017-2022 Arm Limited (or its affiliates). All rights reserved.
Copyright (c) 2002-2017 Allinea Software Limited.
Arm 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
================
Product description
-------------------
Arm Forge 21.1.3 combines Arm DDT, Arm MAP, and Arm Performance Reports. Arm DDT is the leading debugger for time-saving high-performance application debugging. Arm MAP is the trusted performance profiler for invaluable optimization advice across native and Python HPC codes. Arm Performance Reports provides advanced reporting capabilities.
This release includes enhancements and bug fixes.
Release status
--------------
This is the 21.1.3 release of Arm Forge.
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 subsections detail:
- The component 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 Forge, which includes:
- Arm DDT
- Arm MAP
- Arm Performance Reports
- Release Notes (this document, also available at:
https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-forge/release-history)
- Documentation is available in the documentation area of your product installation or online at:
https://developer.arm.com/documentation/101136/2113
Information about how to use the Arm HPC tools to debug, profile, and analyze many common scientific applications are available on the Arm Developer website:
https://developer.arm.com/tools-and-software/server-and-hpc/debug-and-profile/arm-forge
Further documentation about all the tools can be found online at:
https://developer.arm.com/tools-and-software/server-and-hpc/help
Documentation can change between product releases. For the latest product documentation, check the software downloads page on the Arm Developer website at:
https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-forge
Arm tests its 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
---------------------------------
Differences from the previous release of Arm Forge are detailed in the following subsections.
Additions and changes
~~~~~~~~~~~~~~~~~~~~~
- Arm Forge:
None in this release.
- Arm DDT:
Fixed a performance regression in the backend debugger when debugging Fortran codes with a large amount of modules.
Improved frameless unwinding on AMD/Intel (x86_64).
- Arm MAP and Arm Performance Reports:
None in this release.
Resolved issues
~~~~~~~~~~~~~~~
- Arm Forge:
[FOR-14307] Fixed an issue that prevented terminating the remote daemon when selecting an alternate remote system.
[FOR-14525] Added workarounds to the Arm Forge User Guide for Slurm 21.08.0x where x <= 4.
[FOR-14601] Significantly reduced the number of threads that GDB spawns during startup.
- Arm DDT:
None in this release.
- Arm MAP and Arm Performance Reports:
None in this release.
Deprecated features
~~~~~~~~~~~~~~~~~~~
The following features have been deprecated in this release, and might be removed in a future version:
- Automatically adding breakpoints and tracepoints based on version control information.
- Support for PAPI metrics in MAP. Arm recommends using perf metrics instead.
If you rely on this functionality, create a ticket on https://support.developer.arm.com. Arm will respond as soon as possible.
Known limitations
-----------------
See the known issues section on the Arm Developer website:
https://developer.arm.com/documentation/101136/2113/Known-issues-and-notes/Known-issues
Get started
===========
This section describes how to get started with accessing, setting up, and using Arm Forge.
For more information, see:
https://developer.arm.com/tools-and-software/server-and-hpc/debug-and-profile/arm-forge/resources/get-started
Licensing information
---------------------
Arm Forge requires a valid license to run.
Note: You do not need to install a license file on a machine that is running the Remote Client for connecting remotely to Arm Forge products. The license is only required on the machine on which Arm Forge is installed.
To request a license, go to:
https://store.developer.arm.com/store/high-performance-computing-hpc-tools/arm-forge
To request an evaluation license, go to:
https://pages.arm.com/Hpc-trial-request.html
For more information about Arm HPC tools licensing, see:
https://developer.arm.com/tools-and-software/server-and-hpc/debug-and-profile/arm-forge/licensing
When you have obtained a license file from Arm, download and install the appropriate platform version of the product here:
https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-forge
See the Arm Forge User Guide for installation methods, such as using the command-line interface and using the GUI to install Arm Forge on Windows, Linux, and MAC, at:
https://developer.arm.com/documentation/101136/2113/Arm-Forge/Installing-Arm-Forge
Run the product
---------------
See the Arm Forge User Guide for information about running each of the tools, Arm DDT, Arm MAP, and Arm Performance Reports:
https://developer.arm.com/documentation/101136/2113/Arm-Forge/Connecting-to-a-remote-system/Starting-Arm-Forge
Configure the product
---------------------
To learn how to configure the Arm Forge tools, see the user guide at:
https://developer.arm.com/documentation/101136/2113/Configuration
Examples
--------
A range of example applications are provided with the product installation that you can use alongside information in the User Guide to explore Arm Forge functionality.
The example applications are located in the <install_directory>/examples directory.
Support
-------
If you have any issues with the installation, content, or use of this release, please create a ticket on https://developer.arm.com/support. 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.
Note: Support for this release of the product is only provided by Arm to partners who have a current support and maintenance contract for the product.
Tools
-----
Full information about the supported platforms for Arm Forge are available on the Developer website:
https://developer.arm.com/documentation/101136/2113/Supported-platforms/Reference-table
Release history
===============
A full release history for Arm Forge is available at:
https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-forge/release-history
Glossary
========
The Arm Glossary is a list of terms 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.
Proprietary notices
===================
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 http://www.arm.com/company/policies/trademarks.
Copyright (c) 2017-2022 Arm Limited (or its affiliates). All rights reserved.
Copyright (c) 2002-2017 Allinea Software Limited.
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
-----------
http://www.arm.com
Progressive terminology statement
---------------------------------
Arm values inclusive communities. Arm recognizes that we and our industry have used terms that can be offensive. Arm strives to lead the industry and create change.
If you find offensive terms in this document, please email terms@arm.com.
Arm Forge 21.0 covers the following releases:
Arm Forge:
Arm DDT:
Arm MAP and Performance Reports:
Arm Forge:
Arm DDT:
Arm MAP and Performance Reports:
Arm Forge:
Arm DDT:
Arm MAP and Performance Reports:
Arm Forge:
Arm DDT:
Arm MAP and Performance Reports:
Arm Forge:
Arm DDT:
Arm MAP and Performance Reports:
The following features remain deprecated since the release of version 21.0, and might be removed in a future version:
Please refer to the known issues page.
Arm Forge 21.0.3 Release Note
================================
Copyright (c) 2017-2021 Arm Limited (or its affiliates). All rights reserved.
Copyright (c) 2002-2017 Allinea Software Limited.
Arm 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
================
Product description
-------------------
Arm Forge 21.0.3 combines Arm DDT, Arm MAP, and Arm Performance Reports. Arm DDT is the leading debugger for time-saving high-performance application debugging. Arm MAP is the trusted performance profiler for invaluable optimization advice across native and Python HPC codes. Arm Performance Reports provides advanced reporting capabilities.
This release includes enhancements and bug fixes.
Release status
--------------
This is the 21.0.3 release of Arm Forge.
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 subsections detail:
- The component 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 Forge, which includes:
- Arm DDT
- Arm MAP
- Arm Performance Reports
- Release Notes (this document, also available at:
https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-forge/release-history)
- Documentation is available in the documentation area of your product installation or online at:
https://developer.arm.com/documentation/101136/2103
Information about how to use the Arm HPC tools to debug, profile, and analyze many common scientific applications are available on the Arm Developer website:
https://developer.arm.com/tools-and-software/server-and-hpc/debug-and-profile/arm-forge
Further documentation about all the tools can be found online at:
https://developer.arm.com/tools-and-software/server-and-hpc/help
Documentation can change between product releases. For the latest product documentation, check the software downloads page on the Arm Developer website at:
https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-forge
Differences from previous release
---------------------------------
Differences from the previous release of Arm Forge are detailed in the following subsections.
Additions and changes
~~~~~~~~~~~~~~~~~~~~~
- Arm Forge:
Added support for GCC 11.
- Arm DDT:
Added a warning to notify when the debugger cannot debug shared libraries because of an unknown library path.
- Arm MAP and Arm Performance Reports:
None in this release.
Resolved issues
~~~~~~~~~~~~~~~
- Arm Forge:
None in this release.
- Arm DDT:
[FOR-13309] Fixed an issue that was preventing start up with GCC 11.
[FOR-13499] Fixed a bug where Python Debugging would not work correctly with SLURM if the Python binary was using the Python shared library.
- Arm MAP and Arm Performance Reports:
[FOR-12903] Fixed a numerical scaling issue with SPE counts on long profiling runs.
Deprecated features
~~~~~~~~~~~~~~~~~~~
The following features have been deprecated in this release, and might be removed in a future version:
- VisIt Visualization.
- Automatically adding breakpoints and tracepoints based on version control information.
- Support for the IPMI energy agent.
- Support for PAPI metrics in MAP. Arm recommends using perf metrics instead.
- Support for Python 2.x.x.
- Support for Open MPI 3.x.x.
- Support for Red Hat Enterprise Linux 7.x on aarch64 and ppc64le.
- Support for Ubuntu 16.04.
- Support for SUSE Linux Enterprise Server 12 on aarch64.
- Support for macOS High Sierra (10.13).
If you rely on this functionality, please contact support-hpc-sw@arm.com.
Known limitations
-----------------
See the known issues section on the Arm Developer website:
https://developer.arm.com/documentation/101136/2103/Appendix/Known-issues
Get started
===========
This section describes how to get started with accessing, setting up, and using Arm Forge.
For more information, see:
https://developer.arm.com/tools-and-software/server-and-hpc/debug-and-profile/arm-forge/resources/get-started
Licensing information
---------------------
Arm Forge requires a valid license to run.
Note: You do not need to install a license file on a machine that is running the Remote Client for connecting remotely to Arm Forge products. The license is only required on the machine on which Arm Forge is installed.
To request a license, go to:
https://store.developer.arm.com/store/high-performance-computing-hpc-tools/arm-forge
To request an evaluation license, go to:
https://pages.arm.com/Hpc-trial-request.html
For more information about Arm HPC tools licensing, see:
https://developer.arm.com/tools-and-software/server-and-hpc/debug-and-profile/arm-forge/licensing
When you have obtained a license file from Arm, download and install the appropriate platform version of the product here:
https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-forge
See the Arm Forge User Guide for installation methods, such as using the command-line interface and using the GUI to install Arm Forge on Windows, Linux, and MAC, at:
https://developer.arm.com/documentation/101136/2103/Arm-Forge/Installation
Run the product
---------------
See the Arm Forge User Guide for information about running each of the tools, Arm DDT, Arm MAP, and Arm Performance Reports:
https://developer.arm.com/documentation/101136/2103/Arm-Forge/Connecting-to-a-remote-system/Starting-Arm-Forge
Configure the product
---------------------
To learn how to configure the Arm Forge tools, see the user guide at:
https://developer.arm.com/documentation/101136/2103/Appendix/Configuration
Examples
--------
A range of example applications are provided with the product installation that you can use alongside information in the User Guide to explore Arm Forge functionality.
The example applications are located in the <install_directory>/examples directory.
Support
-------
If you have any issues with the installation, content, or use of this release, please create a ticket on https://support.developer.arm.com. 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.
Note: Support for this release of the product is only provided by Arm to partners who have a current support and maintenance contract for the product.
Tools
-----
Full information about the supported platforms for Arm Forge are available on the Developer website:
https://developer.arm.com/documentation/101136/2103/Appendix/Supported-platforms
Release history
===============
A full release history for Arm Forge is available at:
https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-forge/release-history
Glossary
========
The Arm Glossary is a list of terms 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.
Proprietary notices
===================
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 http://www.arm.com/company/policies/trademarks.
Copyright (c) 2017-2021 Arm Limited (or its affiliates). All rights reserved.
Copyright (c) 2002-2017 Allinea Software Limited.
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
-----------
http://www.arm.com
Progressive terminology statement
---------------------------------
Arm values inclusive communities. Arm recognizes that we and our industry have used terms that can be offensive. Arm strives to lead the industry and create change.
If you find offensive terms in this document, please email terms@arm.com.
Arm Forge 20.2 covers the following releases:
20.2.1
Disabled Python evaluations when multiple Python threads are present, as this could cause hanging issues with Python's global interpreter lock.
Added support for CUDA 11.0.
Added support for CUDA versions up to 11.1.
Removed the requirement to match CUDA driver and runtime versions when debugging CUDA applications.
Added support for Ubuntu 20.04.
Added support for Arm Compiler for Linux 20.3.
Various improvements and fixes for python debugging. Includes viewing objects, complex numbers, and dictionaries.
CUDA stepping focus feature removed after being broken for several releases.
Added support for evaluating Python classes.
Added Python source code files to the list in Project File View.
Changed the default launch strategy for IBM Spectrum MPI to avoid shipping Forge binaries. This often improves performance. To revert, export environment variable ALLINEA_DISABLE_SPECTRUMMPI_SCALABLE_SHIPOUT=0.
Python global variables now appear in the locals view when the selected frame is at the module level.
Updated PuTTY shipped with the Windows client to version 0.74.
Added support for evaluating pretty printing Python sequences.
20.2.1
[FOR-11678] Fixed an issue that could cause a debug session to fail when passing floating point arguments to functions on A64FX hardware.
[FOR-11851] Fixed an issue where mixed Fortran 90 and Fortran 77 relational operators were evaluated with the wrong precedence in the "Evaluate" panel.
[FOR-11641] Fixed an issue that caused Python debugging to fail for MPI programs when the Python interpreter binary included no debug information.
20.2.1
Added support for a full set of A64FX hardware counters.
Added the papi_uninstall.sh uninstall script for removing PAPI metrics.
20.2
20.2.1
20.2
20.2.1
None in this release
20.2.1
[FOR-11840] Fixed a bug in GNU OpenMP support on AArch64 and ppc64le.
20.2
The following features remain deprecated since the release of version 20.1, and might be removed in a future version:
Please refer to the known issues page.
Arm Forge 20.2.1 Release Note
================================
Copyright (c) 2017-2020 Arm Limited (or its affiliates). All rights reserved.
Copyright (c) 2002-2017 Allinea Software Limited.
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.
If any of the provisions contained in these terms conflict with any of the provisions of any click through or signed written agreement covering this document with Arm, then the click through or signed written agreement prevails over and supersedes the conflicting provisions of these terms. 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 http://www.arm.com/company/policies/trademarks.
Copyright (c) 2017-2020 Arm Limited (or its affiliates). All rights reserved.
Copyright (c) 2002-2017 Allinea Software Limited.
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
-----------
http://www.arm.com
Progressive terminology commitment
----------------------------------
Arm values inclusive communities. Arm recognizes that we and our industry have used terms that can be offensive. Arm strives to lead the industry and create change.
If you find offensive terms in this document, please contact terms@arm.com.
Contents
========
- Glossary
- Release overview
- Release contents
- Get started
- Support
- Release History
Glossary
========
The Arm Glossary is a list of terms 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.
Release overview
================
Product description
-------------------
Arm Forge 20.2.1 combines Arm DDT, Arm MAP, and Arm Performance Reports. Arm DDT is the leading debugger for time-saving high-performance application debugging. Arm MAP is the trusted performance profiler for invaluable optimization advice across native and Python HPC codes. Arm Performance Reports provides advanced reporting capabilities.
This release includes enhancements and bug fixes.
Release status
--------------
This is the 20.2.1 release of Arm Forge.
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 subsections detail:
- The component 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
------------
Note: Product Download Hub (PDH) delivers all product parts in a single package.
- Arm Forge, which includes:
- Arm DDT
- Arm MAP
- Arm Performance Reports
- Release Notes (this document, also available at: https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-forge/release-history)
- Documentation is available in the documentation area of your product installation or online at:
https://developer.arm.com/documentation/101136/2021
Information about how to use the Arm HPC tools to debug, profile, and analyze many common scientific applications are available on the Arm Developer website:
https://developer.arm.com/tools-and-software/server-and-hpc/debug-and-profile/arm-forge
Further documentation about all the tools can be found online at:
https://developer.arm.com/tools-and-software/server-and-hpc/help
Documentation can change between product releases. For the latest product documentation, check the software downloads page on the Arm Developer website at:
https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-forge
Arm tests the PDF only in Adobe Acrobat and Acrobat Reader and cannot guarantee the quality of the represented document when used with any other PDF reader. A suitable file reader can be downloaded from Adobe at http://www.adobe.com.
Differences from previous release
---------------------------------
Differences from the previous release of Arm Forge are detailed in the following subsections.
Additions and changes
~~~~~~~~~~~~~~~~~~~~~
- Arm DDT:
Disabled Python evaluations when multiple Python threads are present, as this could cause hanging issues with Python's global interpreter lock.
- Arm MAP:
Added support for a full set of A64FX hardware counters.
Added the papi_uninstall.sh uninstall script for removing PAPI metrics.
- Arm Performance Reports:
Resolved issues
~~~~~~~~~~~~~~~
- Arm DDT:
[FOR-11678] Fixed an issue that could cause a debug session to fail when passing floating point arguments to functions on A64FX hardware.
[FOR-11851] Fixed an issue where mixed Fortran 90 and Fortran 77 relational operators were evaluated with the wrong precedence in the "Evaluate" panel.
[FOR-11641] Fixed an issue that caused Python debugging to fail for MPI programs when the Python interpreter binary included no debug information.
- Arm MAP:
[FOR-11840] Fixed a bug in GNU OpenMP support on AArch64 and ppc64le.
- Arm Performance Reports:
[FOR-11840] Fixed a bug in GNU OpenMP support on AArch64 and ppc64le.
Deprecated features
~~~~~~~~~~~~~~~~~~~
The following features are deprecated. You can still use them, but Arm plans to end support in the future:
- VisIt Visualization.
- Automatically adding breakpoints and tracepoints based on version control information.
- Support for CUDA 8.x
- Support for Python 2.x.x.
- Support for the following MPIs: SGI MPT (prior to HPE MPI), Open MPI on Cray X-series systems, Open MPI 2.x.x, Parastation MPI.
- IPMI Energy Agent
- PAPI metrics. Use Perf metrics instead.
If you rely on this functionality, please contact support-hpc-sw@arm.com.
Known limitations
-----------------
See the known issues section on the Arm Developer website:
https://developer.arm.com/documentation/101136/2021/Known-issues
Get started
===========
This section describes how to get started with accessing, setting up, and using Arm Forge.
For more information, see:
https://developer.arm.com/tools-and-software/server-and-hpc/debug-and-profile/arm-forge/resources/get-started
Licensing information
---------------------
Arm Forge requires a valid license to run.
Note: You do not need to install a license file on a machine that is running the Remote Client for connecting remotely to Arm Forge products. The license is only required on the machine on which Arm Forge is installed.
To request a license, go to:
https://store.developer.arm.com/store/high-performance-computing-hpc-tools/arm-forge
To request an evaluation license, go to:
https://pages.arm.com/Hpc-trial-request.html
For more information about Arm HPC tools licensing, see:
https://developer.arm.com/documentation/101169/2021/Using-Arm-Licence-Server.
When you have obtained a license file from Arm, download and install the appropriate platform version of the product here:
https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-forge
See the Arm Forge User Guide for installation methods, such as using the command-line interface and using the GUI to install Arm Forge on Windows, Linux, and MAC, at:
https://developer.arm.com/documentation/101136/2021/Arm-Forge/Installation
Run the product
---------------
See the Arm Forge User Guide for information about running each of the components, Arm DDT, Arm MAP, and Arm Performance Reports:
https://developer.arm.com/documentation/101136/2021/Arm-Forge/Starting-Arm-Forge
Configure the product
---------------------
To learn how to configure the Arm Forge components, see the user guide at:
https://developer.arm.com/documentation/101136/2021/Configuration
Examples
--------
A range of example applications are provided with the product installation that you can use alongside information in the User Guide to explore Arm Forge functionality.
The example applications are located in the <install_directory>/examples directory.
Support
-------
If you have any issues with the installation, content, or use of this release, please create a ticket on https://support.developer.arm.com. 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.
Note: Support for this release of the product is only provided by Arm to partners who have a current support and maintenance contract for the product.
Tools
-----
Full information about the supported platforms for Arm Forge are available on the Developer website:
https://developer.arm.com/documentation/101136/2021/Supported-platforms
Release history
===============
A full release history for Arm Forge is available at:
https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-forge/release-history
Arm Forge 20.1 covers the following releases:
20.1.3
20.1.2
20.1.1
20.1
20.1.3
20.1.2
20.1.1
20.1
20.1.3
20.1.2
20.1.1
20.1
20.1.3
20.1.2
20.1.1
20.1
20.1.3
20.1.2
20.1.1
20.1
20.1.3
20.1.2
20.1.1
20.1
The following features remain deprecated since the release of version 20.1, and might be removed in a future version:
Please refer to the known issues page.
Arm Forge 20.1.3 Release Note
================================
Copyright (c) 2017-2020 Arm Limited (or its affiliates). All rights reserved.
Copyright (c) 2002-2017 Allinea Software Limited.
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.
If any of the provisions contained in these terms conflict with any of the provisions of any click through or signed written agreement covering this document with Arm, then the click through or signed written agreement prevails over and supersedes the conflicting provisions of these terms. 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 http://www.arm.com/company/policies/trademarks.
Copyright (c) 2017-2020 Arm Limited (or its affiliates). All rights reserved.
Copyright (c) 2002-2017 Allinea Software Limited.
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
-----------
http://www.arm.com
Contents
========
- Glossary
- Release overview
- Release contents
- Get started
- Support
- Release History
Glossary
========
The Arm Glossary is a list of terms 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.
Release overview
================
Product description
-------------------
Arm Forge 20.1.3 combines Arm DDT, Arm MAP, and Arm Performance Reports. Arm DDT is the leading debugger for time-saving high-performance application debugging. Arm MAP is the trusted performance profiler for invaluable optimization advice across native and Python HPC codes. Arm Performance Reports provides advanced reporting capabilities.
This release includes enhancements and bug fixes.
Release status
--------------
This is the 20.1.3 release of Arm Forge.
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 subsections detail:
- The component 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
------------
Note: Product Download Hub (PDH) delivers all product parts in a single package.
- Arm Forge, which includes:
- Arm DDT
- Arm MAP
- Arm Performance Reports
- Release Notes (this document, also available at: https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-forge/release-history)
- Documentation is available in the documentation area of your product installation or online at:
https://developer.arm.com/documentation/101136/2013
Information about how to use the Arm HPC tools to debug, profile, and analyze many common scientific applications are available on the Arm Developer website:
https://developer.arm.com/tools-and-software/server-and-hpc/debug-and-profile/arm-forge
Further documentation about all the tools can be found online at:
https://developer.arm.com/tools-and-software/server-and-hpc/help
Documentation can change between product releases. For the latest product documentation, check the software downloads page on the Arm Developer website at:
https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-forge
Arm tests the PDF only in Adobe Acrobat and Acrobat Reader and cannot guarantee the quality of the represented document when used with any other PDF reader. A suitable file reader can be downloaded from Adobe at http://www.adobe.com.
Differences from previous release
---------------------------------
Differences from the previous release of Arm Forge are detailed in the following subsections.
Additions and changes
~~~~~~~~~~~~~~~~~~~~~
- Arm DDT:
A link to the Arm Forge downloads website has been added to the product notification that prompts you to update older versions of the product.
- Arm MAP:
A link to the Arm Forge downloads website has been added to the product notification that prompts you to update older versions of the product.
- Arm Performance Reports:
Resolved issues
~~~~~~~~~~~~~~~
- Arm DDT:
[FOR-11216] Fixed an issue which disabled the Pin to Address feature in the Watchpoints window.
[FOR-11271] Fixed an issue which caused processes to be interrupted or killed when DDT detached from them.
- Arm MAP:
- Arm Performance Reports:
Deprecated features
~~~~~~~~~~~~~~~~~~~
The following features are deprecated. You can still use them, but Arm plans to end support in the future:
- VisIt Visualization.
- Automatically adding breakpoints and tracepoints based on version control information.
- Support for CUDA 8.x
- Support for Python 2.x.x.
- Support for the following MPIs: SGI MPT (prior to HPE MPI), Open MPI on Cray X-series systems, Open MPI 2.x.x, Parastation MPI.
If you rely on this functionality, please contact support-hpc-sw@arm.com.
Known limitations
-----------------
See the known issues section on the Arm Developer website:
https://developer.arm.com/documentation/101136/2013/Known-issues
Get started
===========
This section describes how to get started with accessing, setting up, and using Arm Forge.
For more information, see:
https://developer.arm.com/tools-and-software/server-and-hpc/debug-and-profile/arm-forge/resources/get-started
Licensing information
---------------------
Arm Forge requires a valid license to run.
Note: You do not need to install a license file on a machine that is running the Remote Client for connecting remotely to Arm Forge products. The license is only required on the machine on which Arm Forge is installed.
To request a license, go to:
https://store.developer.arm.com/store/high-performance-computing-hpc-tools/arm-forge
To request an evaluation license, go to:
https://pages.arm.com/Hpc-trial-request.html
For more information about Arm HPC tools licensing, see:
https://developer.arm.com/documentation/101169/2013/Using-Arm-Licence-Server.
When you have obtained a license file from Arm, download and install the appropriate platform version of the product here:
https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-forge
See the Arm Forge User Guide for installation methods, such as using the command-line interface and using the GUI to install Arm Forge on Windows, Linux, and MAC, at:
https://developer.arm.com/documentation/101136/2013/Arm-Forge/Installation
Run the product
---------------
See the Arm Forge User Guide for information about running each of the components, Arm DDT, Arm MAP, and Arm Performance Reports:
https://developer.arm.com/documentation/101136/2013/Arm-Forge/Starting-Arm-Forge
Configure the product
---------------------
To learn how to configure the Arm Forge components, see the user guide at:
https://developer.arm.com/documentation/101136/2013/Configuration
Examples
--------
A range of example applications are provided with the product installation that you can use alongside information in the User Guide to explore Arm Forge functionality.
The example applications are located in the <install_directory>/examples directory.
Support
-------
If you have any issues with the installation, content, or use of this release, please create a ticket on https://support.developer.arm.com. 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.
Note: Support for this release of the product is only provided by Arm to partners who have a current support and maintenance contract for the product.
Tools
-----
Full information about the supported platforms for Arm Forge are available on the Developer website:
https://developer.arm.com/documentation/101136/2013/Supported-platforms
Release history
===============
A full release history for Arm Forge is available at:
https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-forge/release-history
Arm Forge 20.0 covers the following releases:
20.0
20.0.1
20.0.2
20.0.3
20.0
20.0.1
20.0.2
20.0.3
20.0
20.0.1
20.0.2
20.0.3
20.0
20.0.1
20.0.2
20.0.3
Please refer to the known issues page.
Arm Forge 20.0.3 Release Notes
==============================
Copyright (c) 2002-2020 Arm Limited (or its affiliates). All rights reserved.
Arm Forge 20.0.3 provides a complete debugging and profiling environment for C, C++ and Fortran high-performance code on Linux, to help you develop and tune your HPC applications. Arm Forge combines an industry-leading debugger, Arm DDT, and an out-of-the-box-ready profiler, Arm MAP.
Contents
========
This document provides information specific to the 20.0.3 release of Arm Forge:
- Changes in this release:
- New features and enhancements
- Bug fixes
- Known issues
- System requirements
- Installing, uninstalling, licensing
- Running the tools
- Where to find example code
- How to access user documentation
- How to contact support
For information about previous releases of Arm Forge, see the release history online:
https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-forge/release-history
Changes in this release
=======================
Arm DDT:
- New features and enhancements:
None in this release.
- Bug fixes:
[FOR-9068] Fixed a race condition from within cuda-gdb which caused DDT to occasionally fail when launching a kernel.
[FOR-9374] The value of pointer items in the locals, current line, and evaluate views can now be modified.
Arm MAP:
- New features and enhancements:
None in this release.
- Bug fixes:
None in this release.
Known issues
============
See the known issues section on the Arm Developer website:
https://developer.arm.com/docs/101136/latest/known-issues
System requirements
===================
See the Supported Platforms page for Arm DDT and Arm MAP on the Arm Developer website at:
https://developer.arm.com/docs/101136/latest/supported-platforms
Installation instructions
=========================
Run the graphical "installer" or the text-only "textinstall.sh" from the download tarball.
You can choose to install just for you, or for all users on your system.
When installing on a cluster, ensure that Arm Forge is available at the same path on every machine.
If you have a job submission system such as PBS or LoadLeveler running, see the Configuration section in the Arm Forge User Guide for additional setup information:
https://developer.arm.com/docs/101136/latest/configuration
Full installation instructions are available in the Arm Forge user guide, and available on the Arm Developer website at:
https://developer.arm.com/docs/101136/latest/arm-forge/installation
To install the Remote Client for Windows, follow the instructions here:
https://developer.arm.com/tools-and-software/server-and-hpc/debug-and-profile/arm-forge/resources/tutorials/setting-up-arm-forge-remote-client-on-windows
Uninstalling Arm Forge
======================
To uninstall Arm Forge, remove the installation directory from your system:
rm -r <installation-dir>
Licences
========
To get licence files for each product, contact Arm by emailing HPCToolsSales@arm.com. You can obtain evaluation licences from the Arm website at:
https://www.arm.com/products/development-tools/server-and-hpc/allinea-studio/get-software
Licence files must be stored in a directory called licences below the installation directory.
For a default (root) installation, the licences directory is:
/opt/arm/forge/licences
For a default user-only installation, the licences directory is:
${HOME}/arm/forge/licences
Running DDT
===========
If you are using a supported desktop environment (KDE or Gnome), find the DDT icon in your Development > Programming menu.
To run DDT from the command line, type:
{arm-forge-path}/bin/ddt
If {arm-forge-path}/bin is in your $PATH, type:
ddt
You can optionally provide a program name as the first argument.
At startup, the Welcome page displays. From here you can choose to run a program, attach to an existing program, or open a core file.
To start debugging a program, click "Run". In the Run window, set the path to your program in the Application field, and click "Run" to start the program.
The program you choose runs using mpirun. If you have problems starting your program under DDT, ensure that it can run without DDT from the command line.
Running MAP
===========
If you are using a supported desktop environment (KDE or Gnome), find the MAP icon in your Development/Programming menu.
To run MAP from the command line, type:
{arm-forge-path}/bin/map
If {arm-forge-path}/bin is in your $PATH, type:
map
You can optionally provide a program name as the first argument.
At startup, the Welcome page displays. From this page, you can profile a program, or load a profile from a previous run.
To start profiling a program, select "Profile". In the Run window, set the path to your program in the Application field, and click "Run" to start the program.
The program you choose runs using mpirun. If you have problems starting your program under MAP, ensure that it can run without MAP from the command line.
Examples
========
Example code is available in the installation directory:
<INSTALL_DIR>/examples
Copy the example code to a writeable directory and run the examples using the makefiles provided.
Documentation
=============
After you install Arm Forge, you can find a copy of these release notes in the installation directory. You can also find them online at:
https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-forge/release-history
The Arm Forge user guide is available in the <INSTALL_DIR>/doc directory, or online here:
https://developer.arm.com/docs/101136/latest/arm-forge
Further documentation, help, and tutorials are available online at:
https://developer.arm.com/tools-and-software/server-and-hpc/help
Support
=======
If you require support or would like to provide feedback, contact support-hpc-sw@arm.com, or use our support request form online:
https://developer.arm.com/tools-and-software/server-and-hpc/help
Arm Forge 19.1 covers the following releases:
19.1.0
19.1.1
19.1.2
19.1.3
19.1.4
19.1.0
19.1.1
19.1.2
19.1.3
19.1.4
19.1.0
19.1.1
19.1.2
19.1.3
19.1.4
19.1.0
19.1.1
19.1.2
19.1.3
19.1.4
Please refer to the known issues page.
Arm Forge 19.1.4 Release Notes
==============================
Copyright (c) 2002-2019 Arm Limited (or its affiliates). All rights reserved.
Arm Forge 19.1.4 provides a complete debugging and profiling environment for C, C++ and Fortran high performance code on Linux, to help you develop and tune your HPC applications. Arm Forge combines an industry-leading debugger, Arm DDT, and an out-of-the-box-ready profiler, Arm MAP.
Contents
========
This document provides information specific to the 19.1.4 release of Arm Forge:
- Changes in this release:
- New features and enhancements
- Bug fixes
- Known issues
- System requirements
- Installing, uninstalling, licensing
- Running the tools
- Where to find example code
- How to access user documentation
- How to contact support
For information about previous releases of Arm Forge, refer to the release history online:
https://developer.arm.com/products/software-development-tools/hpc/arm-forge/release-history
Changes in this release
=======================
Arm DDT:
- New features and enhancements:
None in this release.
- Bug fixes:
[FOR-8191] Fixed an issue which prevented the MPI message debugging library from loading.
Arm MAP:
- New features and enhancements:
None in this release.
- Bug fixes:
[FOR-8100] Fixed issues when profiling Python scripts run under Anaconda Python and Python 3.7.
[FOR-8187] Fixed an issue which prevented the Caliper sampler library from loading.
Known issues
============
Please refer to the known issues section on the Arm Developer website:
https://developer.arm.com/products/software-development-tools/hpc/arm-forge/known-issues
System requirements
===================
Please refer to the supported platforms pages on the Arm Developer website:
Arm DDT:
https://developer.arm.com/products/software-development-tools/hpc/arm-forge/arm-ddt/arm-ddt-platforms
Arm MAP:
https://developer.arm.com/products/software-development-tools/hpc/arm-forge/arm-map/arm-map-platforms
Installation instructions
=========================
Run the graphical "installer" or the text-only "textinstall.sh" from the download tarball.
You may choose to install just for you or for all users on your system.
If you are installing on a cluster, please make sure that it is available at the same path on every machine.
If you have a job submission system such as PBS or LoadLeveler running, please refer to the Configuration section in the Arm Forge User Guide for additional setup information:
https://developer.arm.com/docs/101136/latest/appendix/configuration
Full installation instructions are available in the Arm Forge user guide, available on the Arm Developer website:
https://developer.arm.com/docs/101136/latest/arm-forge/installation
If you're installing the Remote Client for Windows, follow the instructions here:
https://developer.arm.com/products/software-development-tools/hpc/documentation/setting-up-arm-forge-remote-client-on-windows
Uninstalling Arm Forge
======================
To uninstall Arm Forge, remove the installation directory from your system:
rm -r <installation-dir>
Licences
========
If you do not have licence files for each product you will need to obtain them from Arm. Evaluation licences may be obtained from the Arm website:
https://www.arm.com/products/development-tools/hpc-tools/get-software
Full licences may be obtained by emailing HPCToolsSales@arm.com. Licence files should be stored in a directory called licences below the installation directory. For a default (root) installation, that directory would be:
/opt/arm/forge/licences
and for a user-only installation it would be:
${HOME}/arm/forge/licences
Running DDT
===========
If you are using a supported desktop environment (KDE or Gnome) you will find a DDT icon in your Development/Programming menu.
To run DDT from the command line, type:
{arm-forge-path}/bin/ddt
or, if {arm-forge-path}/bin is in your $PATH, just type:
ddt
You may optionally provide a program name as the first argument.
Upon startup you will be presented with the Welcome page. From here you may choose to run a program, attach to an existing program or open a core file.
To start debugging a program, choose "Run". In the Run window, set the path to your program in the Application field and click "Run" to start the program.
Your chosen program will be run using mpirun. If you have problems starting your program under DDT, first ensure it can run without DDT from the command line.
Running MAP
===========
If you are using a supported desktop environment (KDE or Gnome) you will find a MAP icon in your Development/Programming menu.
To run MAP from the command line, type:
{arm-forge-path}/bin/map
or, if {arm-forge-path}/bin is in your $PATH, just type:
map
You may optionally provide a program name as the first argument.
Upon startup you will be presented with the Welcome page. From here you may profile a program, or load a profile from a previous run.
To start profiling a program, choose "Profile". In the Run window, set the path to your program in the Application field and click "Run" to start the program.
Your chosen program will be run using mpirun. If you have problems starting your program under MAP, first ensure it can run without MAP from the command line.
Examples
========
Example code can be found in the installation directory:
<INSTALL_DIR>/examples
Copy the example code to a writeable directory and run the examples using the makefiles provided.
Documentation
=============
Once installed these release notes can be found in the installation directory, and online at:
https://developer.arm.com/products/software-development-tools/hpc/arm-forge/release-history
The Arm Forge user guide is available in the <INSTALL_DIR>/doc directory, or online here:
https://developer.arm.com/docs/101136/latest/arm-forge
Further documentation, help and tutorials can be found online at:
https://developer.arm.com/products/software-development-tools/hpc/documentation
Support
=======
If you require support or would like to provide feedback, please contact allinea-support@arm.com or use our support request form online:
https://developer.arm.com/products/software-development-tools/hpc/get-support
Arm Forge 19.0 covers the following releases:
19.0.0
19.0.1
19.0.2
19.0.3
19.0.4
19.0.5
19.0.0
std::shared_ptr
in the variable view.
19.0.1
19.0.2
19.0.3
19.0.4
19.0.5
19.0.0
-g
) should at least be compiled with the -fasynchronous-unwind-tables
flag or the -funwind-tables
flag, preferably the former."
19.0.1
19.0.2
19.0.3
19.0.4
19.0.5
19.0.0
19.0.1
19.0.2
19.0.3
19.0.4
libpython3.5mu.so
.19.0.5
Arm Forge 19.0 covers the following releases:
19.0.0
19.0.1
19.0.2
19.0.3
19.0.4
19.0.5
19.0.0
std::shared_ptr
in the variable view.19.0.1
19.0.2
19.0.3
19.0.4
19.0.5
19.0.0
-g
) should at least be compiled with the -fasynchronous-unwind-tables
flag or the -funwind-tables
flag, preferably the former."19.0.1
19.0.2
19.0.3
19.0.4
19.0.5
19.0.0
19.0.1
19.0.2
19.0.3
19.0.4
libpython3.5mu.so
.19.0.5
Please refer to the supported platforms pages for Arm DDT and Arm MAP.
Run the graphical "installer" or the text-only "textinstall.sh" from the download tarball. You may choose to install just for you or for all users on your system.
If you are installing on a cluster, please make sure that it is available at the same path on every machine.
If you have a job submission system such as PBS or LoadLeveler running, please refer to the Configuration section in the Arm Forge user guide for additional setup information.
Full installation instructions are available in the Arm Forge user guide.
If you're installing the Remote Client for Windows, follow the instructions here.
To uninstall Arm Forge, remove the installation directory from your system:
rm -r <installation-dir>
If you do not have licence files for each product you will need to obtain them from Arm - Get an evaluation license.
Full licences may be obtained by emailing HPCToolsSales@arm.com. Licence files should be stored in a directory called licences below the installation directory. For a default (root) installation, that directory would be:
/opt/arm/forge/licences
For a user-only installation it would be:
${HOME}/arm/forge/licences
If you are using a supported desktop environment (KDE or Gnome) you will find a DDT icon in your Development/Programming menu.
To run DDT from the command line, type:
{arm-forge-path}/bin/ddt
or, if {arm-forge-path}/bin
is in your $PATH
, just type:
ddt
You may optionally provide a program name as the first argument.
Upon startup you will be presented with the Welcome page. From here you may choose to run a program, attach to an existing program or open a core file.
To start debugging a program, choose "Run". In the Run window, set the path to your program in the Application field and click "Run" to start the program.
Your chosen program will be run using mpirun
. If you have problems starting your program under DDT, first ensure it can run without DDT from the command line.
If you are using a supported desktop environment (KDE or Gnome) you will find a MAP icon in your Development/Programming menu.
To run MAP from the command line, type:
{arm-forge-path}/bin/map
or, if {arm-forge-path}/bin
is in your $PATH
, just type:
map
You may optionally provide a program name as the first argument.
Upon startup you will be presented with the Welcome page. From here you may profile a program, or load a profile from a previous run.
To start profiling a program, choose "Profile". In the Run window, set the path to your program in the Application field and click "Run" to start the program.
Your chosen program will be run using mpirun
. If you have problems starting your program under MAP, first ensure it can run without MAP from the command line.
Example code can be found in the installation directory:
<INSTALL_DIR>/examples
Copy the example code to a writeable directory and run the examples using the makefiles provided.
Once installed these release notes can be found in the installation directory, and on the Release History page on the Arm Developer website.
The Arm Forge user guide is available in the <INSTALL_DIR>/doc directory, or online here.
Further documentation, help and tutorials can be found on the Arm Developer website.
If you require support or would like to provide feedback, please contact allinea-support@arm.com or use our support request form.
Sign up to our low-traffic, text-only mailing list to hear about new patch releases and major updates to Arm Forge.
Important Information for the Arm website. This site uses cookies to store information on your computer. By continuing to use our site, you consent to our cookies. If you are not happy with the use of these cookies, please review our Cookie Policy to learn how they can be disabled. By disabling cookies, some features of the site will not work.