ArmIE Release History
This page lists the Arm Instruction Emulator (ArmIE) release history.
To download and install the latest version of Arm Instruction Emulator (ArmIE), see our ArmIE downloads page and follow the installation instructions.
Details on release versions and links to the Release Notes and Documentation of Arm Instruction Emulator (ArmIE) are provided below.
-
Download Arm Instruction Emulator: 22.0 March 31, 2022
What's new in 22.0
Arm Instruction Emulator 22.0 covers the following releases:
- Arm Instruction Emulator 22.0 - Release 31st March, 2022
22.0
Additions and changes
- New license issued with this release that has no expiration date.
- Updated GCC runtime support from GCC 10.2 to GCC 11.2.
Resolved issues
- None in this release.
Known limitations
There are DynamoRIO defects and issues logged at https://github.com/DynamoRIO/ dynamorio/issues which might result in instrumentation and emulation failures.
Note: Thorough testing and validation of this release has not resulted in any bugs related to those issues.
-
https://github.com/DynamoRIO/dynamorio/issues/1698 ArmIE has a workaround for this using the --unsafe-ldstex option. This feature is enabled by default and has now been deprecated. It will be removed in a future release./li>
-
Release Note
Release Note for Download Arm Instruction Emulator 22.0
×
Arm Instruction Emulator 22.0 Release Note
==========================================
Copyright (c) 2020-2022 Arm Limited (or its affiliates). All rights reserved.
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
-------------------
The Arm Instruction Emulator (ArmIE) allows users to emulate Scalable Vector
Extension (SVE and SVE2) instructions on AArch64 hardware. ArmIE also includes
features for instrumenting AArch64 and SVE instructions.
Note: On some Arm-based hardware, some Armv8.2 and Armv8.3 AArch64 instructions
can also be emulated.
ArmIE is based on the Open Source DynamoRIO dynamic binary instrumentation
platform (http://www.dynamorio.org/home.html). The DynamoRIO API has been
augmented with an emulation interface which allows run-time analysis of SVE
binaries using the existing DynamoRIO instrumentation capabilities. Examples are
provided to help users develop their own instrumentation clients.
Release status
--------------
This is the 22.0 release of Arm Instruction Emulator.
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 Instruction Emulator 22.0
- Release Notes (this document, also available at:
https://developer.arm.com/tools-and-software/server-and-hpc/compile/
arm-instruction-emulator/get-software/download/release-history)
- The Arm Instruction Emulator Developer and Reference guide is available on the
Arm Developer website at:
https://developer.arm.com/documentation/102190/22-0
Information about how to use the Arm Instruction Emulator to emulate Scalable
Vector Extension (SVE) and SVE2 instructions on AArch64 platforms is available
on the Arm Developer website at:
https://developer.arm.com/tools-and-software/server-and-hpc/compile/
arm-instruction-emulator/
Further documentation about all Arm HPC 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/compile/
arm-instruction-emulator/get-software/download/
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 Instruction Emulator are detailed
in the following subsections.
Additions and changes
~~~~~~~~~~~~~~~~~~~~~
- New license issued with this release that has no expiration date.
- Updated GCC runtime support from GCC 10.2 to GCC 11.2.
Resolved issues
~~~~~~~~~~~~~~~
- None in this release.
Deprecated features
~~~~~~~~~~~~~~~~~~~
The following features have been deprecated in this release, and might be
removed in a future version:
- None in this release.
Known limitations
-----------------
There are DynamoRIO defects and issues logged at https://github.com/DynamoRIO/
dynamorio/issues which might result in instrumentation and emulation failures.
Note: Thorough testing and validation of this release has not resulted in any
bugs related to those issues.
There is a known DynamoRIO issue which causes hangs on some AArch64 hardware:
https://github.com/DynamoRIO/dynamorio/issues/1698
ArmIE has a workaround for this using the --unsafe-ldstex option. This feature
is enabled by default and has now been deprecated. It will be removed in a
future release.
Get started
===========
This section describes how to get started with Arm Instruction Emulator.
For more information, see:
https://developer.arm.com/documentation/102190/22-0/Get-started
Licensing information
---------------------
Arm Instruction Emulator 22.0 includes a time-unlimited license which is
installed with the product.
Download the product
--------------------
Arm delivers the files through the Arm Developer website:
https://developer.arm.com/tools-and-software/server-and-hpc/compile/
arm-instruction-emulator/get-software/download
Unpack the product
------------------
The following steps describe how to unpack each constituent part delivered in
this bundle:
1. Relocate the bundle file. Move the .tar files to the directory in which you
want to install the product.
2. Extract the tar file contents using a tar utility:
tar -xvzf <package_name>.tar.gz
Directory structure
-------------------
Shows the principal directory structure of this release created after unpacking
the bundle:
license_terms/
arm-instruction-emulator-22.0*.sh
RELEASE_NOTES.txt
Install the product
-------------------
To install Arm Instruction Emulator, run the installation script as a privileged
user and pass any options to configure the installation:
./arm-instruction-emulator-22.0*.sh <option> <option>
Some common installation options are:
- For a headless installation and to automatically accept the EULA, use
the '--accept' option.
- To perform a local install, use the '--install-to <dir>' option.
The installer displays the EULA and prompts you to agree to the terms. If you
agree, type 'yes' at the prompt to continue.
All the packages are unpacked to <install_location>/<package_name> with
environment modulefiles available under <install_location>/modulefiles.
The default installation location is /opt/arm/. Local installs have the
same directory structure starting from your chosen installation root.
If, after installation, you decide not to agree to the terms of the EULA, you
must not run the emulator and you should delete all the installed files as
described in 'Uninstalling' below.
See also the product installation instructions in the documentation at:
https://developer.arm.com/documentation/102190/22-0/Get-started/
Install-Arm-Instruction-Emulator.
Run the product
---------------
Note: Ensure that you have a pre-compiled binary to emulate with ArmIE.
1. Load the ArmIE environment module:
module load armie22/22.0
2. Run the binary with Arm Instruction Emulator using one of these methods:
* Invoke Arm Instruction Emulator and specify the vector length to use:
armie -msve-vector-bits=<length> ./<binary>
* Invoke Arm Instruction Emulator with an instrumentation (-i) or emulation
(-e) client, and specify the vector length to use:
armie -msve-vector-bits=<length> -e <emulation_client> -i
<instrumentation_client> -- ./<binary>
Instrumentation and emulation clients enable you to extract data on the
execution of your binary.
Examples
--------
See worked examples provided in the README.txt file supplied with this release.
Uninstall
---------
For convenience, this package includes an "uninstall.sh" script at:
<install_location>/arm-instruction-emulator-22.0*/uninstall.sh
This script uninstalls all the components supplied as part of
Arm Instruction Emulator. When other packages outside of this product depend
on the GNU GCC component, GNU GCC is not uninstalled.
If you require support when uninstalling any version of Arm Instruction
Emulator, contact support-hpc-sw@arm.com.
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.
Supported platforms
-------------------
Arm Instruction Emulator (ArmIE) version 22.0 is supported on the following Linux platforms:
- AArch64 Red Hat Enterprise Linux (RHEL) version 8 (Up to version 8.3).
- AArch64 SUSE Linux Enterprise Server (SLES) 15.
- AArch64 Ubuntu 18.04.
ArmIE is not supported on the following platform:
- Red Hat Linux Enterprise Linux version 8.4 and later.
Release history
===============
A full release history for Arm Instruction Emulator is also available at:
https://developer.arm.com/tools-and-software/server-and-hpc/compile/
arm-instruction-emulator/get-software/download/release-history
Changes in Release 22.0
-----------------------
Removed Features
~~~~~~~~~~~~~~~~
- None
New Features and Enhancements
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- Updated GCC runtime support from GCC 10.2 to GCC 11.2.
Bug Fixes
~~~~~~~~~
- None
Other Changes
~~~~~~~~~~~~~
- The license that is included in ArmIE 22.0 is no longer set to expire.
Changes in Release 21.0
-----------------------
Removed Features
~~~~~~~~~~~~~~~~
- None
New Features and Enhancements
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- Added support for the following v8.2 instructions, based on detection of hardware capability at startup:
* Scalar half-precision variants of ucvtf and scvtf.
* Half-precision fabd.
- Updated GCC runtime support from GCC 9.2 to GCC 10.2.
Bug Fixes
~~~~~~~~~
- Fixed some hardware feature checks for v8.2 and v8.3 emulation.
- Fixed a v8.3 fcmla emulation error.
Other Changes
~~~~~~~~~~~~~
- The license that is included in ArmIE 21.0 is set to expire after 31st March
2022.
Changes in Release 20.1
-----------------------
Removed Features
~~~~~~~~~~~~~~~~
- None
New Features and Enhancements
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- Added support for the following v8.2 instructions based on detection of
hardware capability at startup:
fmov, scvtf, frecpe, fabs, fcmgtz, fcvtzs, frintn, frsqrte, frsqrts, fmax,
fmaxp and fdiv, scvtf, ucvtf
Bug Fixes
~~~~~~~~~
- Some SVE2 instructions that were not being emulated correctly have been
fixed.
- CAS-164399-V9L7T0
Output from the -s option now shows double-quoted client parameter strings
correctly.
Other Changes
~~~~~~~~~~~~~
- The license that is included in ArmIE 20.1 is set to expire after 31st August
2021.
Changes in Release 20.0
-----------------------
Removed Features
~~~~~~~~~~~~~~~~
- The --unsafe-ldstex has been deprecated and is enabled by default. A new
option, --safe-ldstex, has been added in the unlikely event that
--unsafe-ldstex needs to be disabled.
New Features and Enhancements
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- Added command option --safe-ldstex, (see 'Removed Features' above).
- Added support for the emulated v8.2 instructions: frsqrte, frsqrts, fmax, fmaxp
and fdiv. Optimization of emulated v8.2 instructions: fmax and fma.
- Adds support for the full diagnostic reporting of illegal instructions
(SIGILL), in other words, displaying the illegal encoding and its subject
binary PC address.
- Added armie command line option, --arg-iclient, to enable the passing of
arguments to instrumentation clients.
- Consistency updates to Region-of-Interest (ROI) feature, originally extended
from memory tracing instrumentation client to instruction counting, opcode
counting, and instruction tracing clients.
- Added an example of using Region-of-Interest (ROI) macros in Fortran source
code in the samples/fortran_roi directory.
- Updated GCC linker/loader support from GCC 8.2 to GCC 9.2.
Bug Fixes
~~~~~~~~~
- Critical bug fix for OpenMPI applications.
- Improved installation compatibility with Arm Compiler for Linux and Arm
Performance Libraries. This fixes a bug which required users to load the ArmIE
environment module before loading the Arm Compiler for Linux and Arm
Performance Libraries environment module.
Other Changes
~~~~~~~~~~~~~
- License is set to expire after 31st January 2021.
Changes in Release 19.2
-----------------------
Removed Features
~~~~~~~~~~~~~~~~
- None.
New Features and Enhancements
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- Emulation of the following v8.2 and v8.3 instructions based on detection of
hardware capability at startup:
v8.2 half-precision instructions:
fadd, fsub, fmul, fmul (by element), fmla, fmla (by element), fmadd, fmsub,
fmls, fmls (by element), fneg, fcmp.
v8.3: fcmla, fcadd
- Upgraded to be compatible with GCC 8.2 linker/loader, (from GCC 7.1).
Bug Fixes
~~~~~~~~~
- None.
Other Changes
~~~~~~~~~~~~~
- License set to expire after 31st August 2020.
Changes in Release 19.1
-----------------------
Removed Features
~~~~~~~~~~~~~~~~
- None.
New Features and Enhancements
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- Addition of an uninstall.sh script
Bug Fixes
~~~~~~~~~
- None.
Other Changes
~~~~~~~~~~~~~
- License extended to 31st March 2021.
Changes in Release 19.0
-----------------------
Removed Features
~~~~~~~~~~~~~~~~
- None.
New Features and Enhancements
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- The regions-of-interest feature (ROI), has been added to the following
instrumentation clients:
api/samples/inscount_emulated.cpp
api/samples/instrace_emulated.c
api/samples/memtrace_emulated.c
api/samples/opcodes_emulated.cpp
Bug Fixes
~~~~~~~~~
- An ELF loader bug which resulted in failures when running Fortran binaries has
been fixed.
Other Changes
~~~~~~~~~~~~~
- Documentation has been updated to include more information about analysing
specific aspects of runtime performance using existing instrumentation
clients, or developing your own. See:
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator/tutorials
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator/structure-of-an-instrumentation-client
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator/building-custom-analysis-instrumentation
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator/building-an-emulation-aware-instrumentation-client
Change in Release 18.4
----------------------
Removed Features
~~~~~~~~~~~~~~~~
- None.
New Features and Enhancements
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- None.
Bug Fixes
~~~~~~~~~
- This version can successfully run multi-threaded subject binaries, including
those linked with OpenMP libraries.
Other Changes
~~~~~~~~~~~~~
- None.
Changes in Release 18.3
-----------------------
Removed Features
~~~~~~~~~~~~~~~~
- None.
New Features and Enhancements
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- Emulation has been separated from instrumentation based on the addition of an
emulation interface to the DynamoRIO API allowing users to develop their own
instrumentation clients:
drmgr_is_emulation_start()
drmgr_is_emulation_end()
drmgr_get_emulation_instr_data()
drmgr_create_emulation_start()
drmgr_create_emulation_end()
emulated_instr_t
Two instruction count clients, an opcodes client and a memory trace client have
been provided as examples. Another emulation feature to simplify iteration over
blocks with emulated instructions is planned for a future release. If accepted
upstream, this emulation-aware iterator will simplify instrumentation when
running with emulation clients.
Bug Fixes
~~~~~~~~~
- None
Other Changes
~~~~~~~~~~~~~
- A script, enc2instr.py, which can be used to disassemble instruction encodings
to mnemonics. Useful for disassembling the output from
drmgr_get_emulation_instr_data(). The script is based on llvm-mc and defaults
to disassembling SVE, but can be any legal -mattr value supported by llvm-mc.
- All license files are now in the license_terms directory.
Changes in Release 18.2
-----------------------
Removed Features
~~~~~~~~~~~~~~~~
- None.
New Features and Enhancements
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
This release begins the process of separating emulation clients from
instrumentation clients. The implementation of an instruction count client and
memory tracing clients are the first examples of such a separation.
Bug Fixes
~~~~~~~~~
- A bug in counting non-SVE instructions has been fixed.
Other Changes
~~~~~~~~~~~~~
- A helper option to output the full drrun command used by armie:
-s, --show-drrun-cmd.
Changes in Release 18.1
-----------------------
Removed Features
~~~~~~~~~~~~~~~~
- None.
New Features and Enhancements
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- There are significant improvements in runtime performance principally due to
optimisations in SVE emulation functions (mostly floating-point emulation
including faster FCMLA) and memory copying.
Bug Fixes
~~~~~~~~~
- Floating point corrections including:
- Handling of inactive vector elements.
- Floating point <-> integer conversions.
- FPSR updates by and for modifying instructions.
- Operand ordering for commutative operations.
- Handling of NaNs.
Other Changes
~~~~~~~~~~~~~
- None.
Changes in Release 18.0
-----------------------
This is the first release which integrates ArmIE with the Open Source DynamoRIO
dynamic binary instrumentation platform (http://www.dynamorio.org/home.html).
The previous release of Arm Instruction Emulator was 1.2.1. The version
numbering scheme has changed with this release in order to remain consistent
with other Arm AArch64 HPC software tools.
Removed Features
~~~~~~~~~~~~~~~~
The functionality enabled by the following command line options is not available
in this release. They may be added in future releases.
-d, --debug Enabled assertion checks in the emulator.
-o, --output Redirected all messages generated by armie to a file.
-p, --profile-period Enabled the performance profiler.
-msve-memtrace Enabled memory tracing.
New Features
~~~~~~~~~~~~
- Arm Instruction Emulator 18.0 runs using DynamoRIO clients to provide SVE
emulation and limited instrumentation for both emulated SVE instructions and
native AArch64 instructions. Previous releases emulated SVE instructions with
no coverage of native AArch64 instructions.
Bug Fixes
~~~~~~~~~
- None. This is the first release based on DynamoRIO.
Other Changes
~~~~~~~~~~~~~
- None.
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) 2020-2022 Arm Limited (or its affiliates). All rights reserved.
Arm Limited. Company 02557590 registered in England.
110 Fulbourn Road, Cambridge, England CB1 9NJ.
(LES-PRE-20349)
Confidentiality status
----------------------
This document is Non-Confidential. The right to use, copy and disclose this
document may be subject to license restrictions in accordance with the terms of
the agreement entered into by Arm and the party that Arm delivered this document
to.
Unrestricted Access is an Arm internal classification.
Product status
--------------
The information in this document is final, that is for a developed product.
Web address
-----------
http://www.arm.com
Progressive terminology statement
---------------------------------
Arm values inclusive communities. Arm recognizes that we and our industry have
used language that can be offensive. Arm strives to lead the industry and
create change.
We believe that this document contains no offensive language. To report
offensive language in this document, email terms@arm.com
- EULA
-
Download Arm Instruction Emulator: 21.0 March 30, 2021
What's new in 21.0
Changes in Release 20.1
=======================
Removed Features
----------------- None
New Features and Enhancements
------------------------------
Added support for the following v8.2 instructions, based on detection of hardware capability at startup:
- Scalar half-precision variants of ucvtf and scvtf.
- Half-precision fabd.
- Updated GCC runtime support from GCC 9.2 to GCC 10.2.
Bug Fixes
---------- Fixed some hardware feature checks for v8.2 and v8.3 emulation.
- Fixed a v8.3 fcmla emulation error.
Other Changes
-------------- The license that is included in ArmIE 21.0 is set to expire after 31st March 2022.
-
Release Note
Release Note for Download Arm Instruction Emulator 21.0
×-------------------------------
| Arm Instruction Emulator 21.0 |
-------------------------------
Arm Instruction Emulator (ArmIE) allows users to emulate SVE instructions on
AArch64 hardware. Based on the DynamoRIO dynamic binary instrumentation API,
ArmIE has added features for instrumenting AArch64 and SVE instructions. See
'RELEASE HISTORY' below for changes in this release.
System Requirements
===================
ArmIE is supported on the following Linux platforms:
- AArch64 Redhat 8
- AArch64 SLES 15
- AArch64 Ubuntu 18.04
Installation Instructions
=========================
To install the emulator, untar the release package:
tar -xvzf ARM-Instruction-Emulator_21.0_AArch64_<OS>_<OS_Version>_aarch64.tar.gz
Where:
ARM-Instruction-Emulator_21.0_AArch64_<OS>_<OS_Version>_aarch64.tar.gz
is the name of the <OS> <OS_Version> package.
cd ARM-Instruction-Emulator_21.0_AArch64_<OS>_<OS_Version>_aarch64
Install the emulator in /opt/arm as root user:
sudo ./arm-instruction-emulator-21.0_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux-rpm.sh
Or use either the '-i <directory>' or '--install-to <directory>' option to
install to a specified location.
You must read the EULA, presented to you as part of the install process, before
accepting or rejecting the agreement.
All files including the EULA file, license_agreement.txt, are unpacked to
/opt/arm/arm-instruction-emulator-21.0_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux
If either the '-i <directory>' or '--install-to <directory>' option is used,
files are unpacked to <directory>/arm-instruction-emulator-21.0_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux.
If, after installation, you decide not to agree to the terms of the EULA you
must not run the emulator and you should delete all the installed files as
described in 'Uninstalling' below.
Known Issues
============
There are DynamoRIO defects and issues logged at https://github.com/DynamoRIO/dynamorio/issues
which may result in instrumentation and emulation failures. Note that thorough
testing and validation of this release has not resulted in any bugs related to
those issues.
There is a known DynamoRIO issue which causes hangs on some AArch64 hardware:
https://github.com/DynamoRIO/dynamorio/issues/1698
ArmIE has a workaround for this using the --unsafe-ldstex option. This feature
is enabled by default and has now been deprecated. It will be removed in a
future release.
Documentation
=============
Refer to the Arm Developer website for supporting information about Arm
Instruction Emulator:
https://developer.arm.com/tools-and-software/server-and-hpc/compile/arm-instruction-emulator
This includes tutorials and other useful information for custom analysis of your
code:
https://developer.arm.com/tools-and-software/server-and-hpc/compile/arm-instruction-emulator/resources
Further help and tutorials for all of Arm's HPC tools can be found online at:
https://developer.arm.com/tools-and-software/server-and-hpc/help/help-and-tutorials
There is also a README.txt file in /opt/arm/arm-instruction-emulator-21.0_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux.
If you require support please contact support-hpc-sw@arm.com
Uninstalling
============
Run the <directory>/arm-instruction-emulator-21.0_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux/uninstall.sh script.
For a default installation, '<directory>' is '/opt/arm'.
-----------------
| RELEASE HISTORY |
-----------------
Changes in Release 21.0
=======================
Removed Features
----------------
- None
New Features and Enhancements
-----------------------------
- Added support for the following v8.2 instructions, based on detection of
hardware capability at startup:
* Scalar half-precision variants of ucvtf and scvtf.
* Half-precision fabd.
- Updated GCC runtime support from GCC 9.2 to GCC 10.2.
Bug Fixes
---------
- Fixed some hardware feature checks for v8.2 and v8.3 emulation.
- Fixed a v8.3 fcmla emulation error.
Other Changes
-------------
- The license that is included in ArmIE 21.0 is set to expire after 31st March
2022.
Changes in Release 20.1
=======================
Removed Features
----------------
- None
New Features and Enhancements
-----------------------------
- Added support for the following v8.2 instructions based on detection of
hardware capability at startup:
fmov, scvtf, frecpe, fabs, fcmgtz, fcvtzs, frintn, frsqrte, frsqrts, fmax,
fmaxp and fdiv, scvtf, ucvtf
Bug Fixes
---------
- Some SVE2 instructions that were not being emulated correctly have been
fixed.
- CAS-164399-V9L7T0
Output from the -s option now shows double-quoted client parameter strings
correctly.
Other Changes
-------------
- The license that is included in ArmIE 20.1 is set to expire after 31st August
2021.
Changes in Release 20.0
=======================
Removed Features
----------------
- The --unsafe-ldstex has been deprecated and is enabled by default. A new
option, --safe-ldstex, has been added in the unlikely event that
--unsafe-ldstex needs to be disabled.
New Features and Enhancements
-----------------------------
- Added command option --safe-ldstex, (see 'Removed Features' above).
- Added support for the emulated v8.2 instructions: frsqrte, frsqrts, fmax, fmaxp
and fdiv. Optimization of emulated v8.2 instructions: fmax and fma.
- Adds support for the full diagnostic reporting of illegal instructions
(SIGILL), in other words, displaying the illegal encoding and its subject
binary PC address.
- Added armie command line option, --arg-iclient, to enable the passing of
arguments to instrumentation clients.
- Consistency updates to Region-of-Interest (ROI) feature, originally extended
from memory tracing instrumentation client to instruction counting, opcode
counting, and instruction tracing clients.
- Added an example of using Region-of-Interest (ROI) macros in Fortran source
code in the samples/fortran_roi directory.
- Updated GCC linker/loader support from GCC 8.2 to GCC 9.2.
Bug Fixes
---------
- Critical bug fix for OpenMPI applications.
- Improved installation compatibility with Arm Compiler for Linux and Arm
Performance Libraries. This fixes a bug which required users to load the ArmIE
environment module before loading the Arm Compiler for Linux and Arm
Performance Libraries environment module.
Other Changes
-------------
- License is set to expire after 31st January 2021.
Changes in Release 19.2
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- Emulation of the following v8.2 and v8.3 instructions based on detection of
hardware capability at startup:
v8.2 half-precision instructions:
fadd, fsub, fmul, fmul (by element), fmla, fmla (by element), fmadd, fmsub,
fmls, fmls (by element), fneg, fcmp.
v8.3: fcmla, fcadd
- Upgraded to be compatible with GCC 8.2 linker/loader, (from GCC 7.1).
Bug Fixes
---------
- None.
Other Changes
-------------
- License set to expire after 31st August 2020.
Changes in Release 19.1
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- Addition of an uninstall.sh script
Bug Fixes
---------
- None.
Other Changes
-------------
- License extended to 31st March 2021.
Changes in Release 19.0
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- The regions-of-interest feature (ROI), has been added to the following
instrumentation clients:
api/samples/inscount_emulated.cpp
api/samples/instrace_emulated.c
api/samples/memtrace_emulated.c
api/samples/opcodes_emulated.cpp
Bug Fixes
---------
- An ELF loader bug which resulted in failures when running Fortran binaries has
been fixed.
Other Changes
-------------
- Documentation has been updated to include more information about analysing
specific aspects of runtime performance using existing instrumentation
clients, or developing your own. See:
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator/tutorials
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator/structure-of-an-instrumentation-client
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator/building-custom-analysis-instrumentation
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator/building-an-emulation-aware-instrumentation-client
Change in Release 18.4
======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- None.
Bug Fixes
---------
- This version can successfully run multi-threaded subject binaries, including
those linked with OpenMP libraries.
Other Changes
-------------
- None.
Changes in Release 18.3
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- Emulation has been separated from instrumentation based on the addition of an
emulation interface to the DynamoRIO API allowing users to develop their own
instrumentation clients:
drmgr_is_emulation_start()
drmgr_is_emulation_end()
drmgr_get_emulation_instr_data()
drmgr_create_emulation_start()
drmgr_create_emulation_end()
emulated_instr_t
Two instruction count clients, an opcodes client and a memory trace client have
been provided as examples. Another emulation feature to simplify iteration over
blocks with emulated instructions is planned for a future release. If accepted
upstream, this emulation-aware iterator will simplify instrumentation when
running with emulation clients.
Bug Fixes
---------
- None
Other Changes
-------------
- A script, enc2instr.py, which can be used to disassemble instruction encodings
to mnemonics. Useful for disassembling the output from
drmgr_get_emulation_instr_data(). The script is based on llvm-mc and defaults
to disassembling SVE, but can be any legal -mattr value supported by llvm-mc.
- All license files are now in the license_terms directory.
Changes in Release 18.2
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
This release begins the process of separating emulation clients from
instrumentation clients. The implementation of an instruction count client and
memory tracing clients are the first examples of such a separation.
Bug Fixes
---------
- A bug in counting non-SVE instructions has been fixed.
Other Changes
-------------
- A helper option to output the full drrun command used by armie:
-s, --show-drrun-cmd.
Changes in Release 18.1
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- There are significant improvements in runtime performance principally due to
optimisations in SVE emulation functions (mostly floating-point emulation
including faster FCMLA) and memory copying.
Bug Fixes
---------
- Floating point corrections including:
- Handling of inactive vector elements.
- Floating point <-> integer conversions.
- FPSR updates by and for modifying instructions.
- Operand ordering for commutative operations.
- Handling of NaNs.
Other Changes
-------------
- None.
Changes in Release 18.0
=======================
This is the first release which integrates ArmIE with the Open Source DynamoRIO
dynamic binary instrumentation platform (http://www.dynamorio.org/home.html).
The previous release of Arm Instruction Emulator was 1.2.1. The version
numbering scheme has changed with this release in order to remain consistent
with other Arm AArch64 HPC software tools.
Removed Features
----------------
The functionality enabled by the following command line options is not available
in this release. They may be added in future releases.
-d, --debug Enabled assertion checks in the emulator.
-o, --output Redirected all messages generated by armie to a file.
-p, --profile-period Enabled the performance profiler.
-msve-memtrace Enabled memory tracing.
New Features
------------
- Arm Instruction Emulator 18.0 runs using DynamoRIO clients to provide SVE
emulation and limited instrumentation for both emulated SVE instructions and
native AArch64 instructions. Previous releases emulated SVE instructions with
no coverage of native AArch64 instructions.
Bug Fixes
---------
- None. This is the first release based on DynamoRIO.
Other Changes
-------------
- None.
- EULA
- None
-
Download Arm Instruction Emulator: 20.1 August 21, 2020
What's new in 20.1
Changes in Release 20.1
=======================
Removed Features
----------------
- None
New Features and Enhancements
-----------------------------
- Added support for the following v8.2 instructions based on detection of
hardware capability at startup:
fmov, scvtf, frecpe, fabs, fcmgtz, fcvtzs, frintn, frsqrte, frsqrts, fmax,
fmaxp and fdiv, scvtf, ucvtf
Bug Fixes
---------
- Some SVE2 instructions that were not being emulated correctly have been
fixed.
- CAS-164399-V9L7T0
Output from the -s option now shows double-quoted client parameter strings
correctly.
Other Changes
-------------
- The license that is included in ArmIE 20.1 is set to expire after 31st August
2021.
-
Release Note
Release Note for Download Arm Instruction Emulator 20.1
×-------------------------------
| Arm Instruction Emulator 20.1 |
-------------------------------
Arm Instruction Emulator (ArmIE) allows users to emulate SVE instructions on
AArch64 hardware. Based on the DynamoRIO dynamic binary instrumentation API,
ArmIE has added features for instrumenting AArch64 and SVE instructions. See
'RELEASE HISTORY' below for changes in this release.
System Requirements
===================
ArmIE is supported on the following Linux platforms:
- AArch64 Redhat 7.2 and 7.3
- AArch64 SuSE 12
- AArch64 Ubuntu 16.04
Installation Instructions
=========================
To install the emulator, untar the release package:
$ tar -xvzf ARM-Instruction-Emulator_20.1_AArch64_<OS>_<OS_Version>_aarch64.tar.gz
Where:
ARM-Instruction-Emulator_20.1_AArch64_<OS>_<OS_Version>_aarch64.tar.gz
is the name of the <OS> <OS_Version> package.
$ cd ARM-Instruction-Emulator_20.1_AArch64_<OS>_<OS_Version>_aarch64
Install the emulator in /opt as root user:
$ sudo ./arm-instruction-emulator-20.1_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux-rpm.sh
Or use the -i, --install-to <directory> option to install to a specified location.
You must read the EULA, presented to you as part of the install process, before
accepting or rejecting the agreement.
All files including the EULA file, license_agreement.txt, are unpacked to
/opt/arm/arm-instruction-emulator-20.1_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux
If the -i, --install-to <directory> option is used, files are unpacked to
<directory>/arm-instruction-emulator-20.1_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux.
If, after installation, you decide not to agree to the terms of the EULA you
must not run the emulator and you should delete all the installed files as
described in 'Uninstalling' below.
Known Issues
============
There are DynamoRIO defects and issues logged at https://github.com/DynamoRIO/dynamorio/issues
which may result in instrumentation and emulation failures. Note that thorough
testing and validation of this release has not resulted in any bugs related to
those issues.
There is a known DynamoRIO issue which causes hangs on some AArch64 hardware:
https://github.com/DynamoRIO/dynamorio/issues/1698
ArmIE has a workaround for this using the --unsafe-ldstex option. This feature
is enabled by default and has now been deprecated. It will be removed in a
future release.
Documentation
=============
Refer to the Arm Developer website for supporting information about Arm
Instruction Emulator:
https://developer.arm.com/tools-and-software/server-and-hpc/compile/arm-instruction-emulator
This includes tutorials and other useful information for custom analysis of your
code:
https://developer.arm.com/tools-and-software/server-and-hpc/compile/arm-instruction-emulator/resources
Further help and tutorials for all of Arm's HPC tools can be found online at:
https://developer.arm.com/tools-and-software/server-and-hpc/help/help-and-tutorials
There is also a README.txt file in /opt/arm/arm-instruction-emulator-20.1_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux.
If you require support please contact support-hpc-sw@arm.com
Uninstalling
============
Run the /opt/arm/arm-instruction-emulator-20.1_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux/uninstall.sh script.
-----------------
| RELEASE HISTORY |
-----------------
Changes in Release 20.1
=======================
Removed Features
----------------
- None
New Features and Enhancements
-----------------------------
- Added support for the following v8.2 instructions based on detection of
hardware capability at startup:
fmov, scvtf, frecpe, fabs, fcmgtz, fcvtzs, frintn, frsqrte, frsqrts, fmax,
fmaxp and fdiv, scvtf, ucvtf
Bug Fixes
---------
- Some SVE2 instructions that were not being emulated correctly have been
fixed.
- CAS-164399-V9L7T0
Output from the -s option now shows double-quoted client parameter strings
correctly.
Other Changes
-------------
- The license that is included in ArmIE 20.1 is set to expire after 31st August
2021.
Changes in Release 20.0
=======================
Removed Features
----------------
- The --unsafe-ldstex has been deprecated and is enabled by default. A new
option, --safe-ldstex, has been added in the unlikely event that
--unsafe-ldstex needs to be disabled.
New Features and Enhancements
-----------------------------
- Added command option --safe-ldstex, (see 'Removed Features' above).
- Added support for the emulated v8.2 instructions: frsqrte, frsqrts, fmax, fmaxp
and fdiv. Optimization of emulated v8.2 instructions: fmax and fma.
- Adds support for the full diagnostic reporting of illegal instructions
(SIGILL), in other words, displaying the illegal encoding and its subject
binary PC address.
- Added armie command line option, --arg-iclient, to enable the passing of
arguments to instrumentation clients.
- Consistency updates to Region-of-Interest (ROI) feature, originally extended
from memory tracing instrumentation client to instruction counting, opcode
counting, and instruction tracing clients.
- Added an example of using Region-of-Interest (ROI) macros in Fortran source
code in the samples/fortran_roi directory.
- Updated GCC linker/loader support from GCC 8.2 to GCC 9.2.
Bug Fixes
---------
- Critical bug fix for OpenMPI applications.
- Improved installation compatibility with Arm Compiler for Linux and Arm
Performance Libraries. This fixes a bug which required users to load the ArmIE
environment module before loading the Arm Compiler for Linux and Arm
Performance Libraries environment module.
Other Changes
-------------
- License is set to expire after 31st January 2021.
Changes in Release 19.2
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- Emulation of the following v8.2 and v8.3 instructions based on detection of
hardware capability at startup:
v8.2 half-precision instructions:
fadd, fsub, fmul, fmul (by element), fmla, fmla (by element), fmadd, fmsub,
fmls, fmls (by element), fneg, fcmp.
v8.3: fcmla, fcadd
- Upgraded to be compatible with GCC 8.2 linker/loader, (from GCC 7.1).
Bug Fixes
---------
- None.
Other Changes
-------------
- License set to expire after 31st August 2020.
Changes in Release 19.1
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- Addition of an uninstall.sh script
Bug Fixes
---------
- None.
Other Changes
-------------
- License extended to 31st March 2021.
Changes in Release 19.0
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- The regions-of-interest feature (ROI), has been added to the following
instrumentation clients:
api/samples/inscount_emulated.cpp
api/samples/instrace_emulated.c
api/samples/memtrace_emulated.c
api/samples/opcodes_emulated.cpp
Bug Fixes
---------
- An ELF loader bug which resulted in failures when running Fortran binaries has
been fixed.
Other Changes
-------------
- Documentation has been updated to include more information about analysing
specific aspects of runtime performance using existing instrumentation
clients, or developing your own. See:
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator/tutorials
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator/structure-of-an-instrumentation-client
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator/building-custom-analysis-instrumentation
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator/building-an-emulation-aware-instrumentation-client
Change in Release 18.4
======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- None.
Bug Fixes
---------
- This version can successfully run multi-threaded subject binaries, including
those linked with OpenMP libraries.
Other Changes
-------------
- None.
Changes in Release 18.3
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- Emulation has been separated from instrumentation based on the addition of an
emulation interface to the DynamoRIO API allowing users to develop their own
instrumentation clients:
drmgr_is_emulation_start()
drmgr_is_emulation_end()
drmgr_get_emulation_instr_data()
drmgr_create_emulation_start()
drmgr_create_emulation_end()
emulated_instr_t
Two instruction count clients, an opcodes client and a memory trace client have
been provided as examples. Another emulation feature to simplify iteration over
blocks with emulated instructions is planned for a future release. If accepted
upstream, this emulation-aware iterator will simplify instrumentation when
running with emulation clients.
Bug Fixes
---------
- None
Other Changes
-------------
- A script, enc2instr.py, which can be used to disassemble instruction encodings
to mnemonics. Useful for disassembling the output from
drmgr_get_emulation_instr_data(). The script is based on llvm-mc and defaults
to disassembling SVE, but can be any legal -mattr value supported by llvm-mc.
- All license files are now in the license_terms directory.
Changes in Release 18.2
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
This release begins the process of separating emulation clients from
instrumentation clients. The implementation of an instruction count client and
memory tracing clients are the first examples of such a separation.
Bug Fixes
---------
- A bug in counting non-SVE instructions has been fixed.
Other Changes
-------------
- A helper option to output the full drrun command used by armie:
-s, --show-drrun-cmd.
Changes in Release 18.1
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- There are significant improvements in runtime performance principally due to
optimisations in SVE emulation functions (mostly floating-point emulation
including faster FCMLA) and memory copying.
Bug Fixes
---------
- Floating point corrections including:
- Handling of inactive vector elements.
- Floating point <-> integer conversions.
- FPSR updates by and for modifying instructions.
- Operand ordering for commutative operations.
- Handling of NaNs.
Other Changes
-------------
- None.
Changes in Release 18.0
=======================
This is the first release which integrates ArmIE with the Open Source DynamoRIO
dynamic binary instrumentation platform (http://www.dynamorio.org/home.html).
The previous release of Arm Instruction Emulator was 1.2.1. The version
numbering scheme has changed with this release in order to remain consistent
with other Arm AArch64 HPC software tools.
Removed Features
----------------
The functionality enabled by the following command line options is not available
in this release. They may be added in future releases.
-d, --debug Enabled assertion checks in the emulator.
-o, --output Redirected all messages generated by armie to a file.
-p, --profile-period Enabled the performance profiler.
-msve-memtrace Enabled memory tracing.
New Features
------------
- Arm Instruction Emulator 18.0 runs using DynamoRIO clients to provide SVE
emulation and limited instrumentation for both emulated SVE instructions and
native AArch64 instructions. Previous releases emulated SVE instructions with
no coverage of native AArch64 instructions.
Bug Fixes
---------
- None. This is the first release based on DynamoRIO.
Other Changes
-------------
- None. - EULA
-
-
Download Arm Instruction Emulator: 20.0 February 18, 2020
What's new in 20.0
Changes in Release 20.0
=======================
Removed Features
----------------
- The --unsafe-ldstex has been deprecated and is enabled by default. A new
option, --safe-ldstex, has been added in the unlikely event that
--unsafe-ldstex needs to be disabled.
New Features and Enhancements
-----------------------------
- Added command option --safe-ldstex, (see 'Removed Features' above).
- Added support for the emulated v8.2 instructions: frsqrte, frsqrts, fmax, fmaxp
and fdiv. Optimization of emulated v8.2 instructions: fmax and fma.
- Adds support for the full diagnostic reporting of illegal instructions
(SIGILL), in other words, displaying the illegal encoding and its subject
binary PC address.
- Added armie command line option, --arg-iclient, to enable the passing of
arguments to instrumentation clients.
- Consistency updates to Region-of-Interest (ROI) feature, originally extended
from memory tracing instrumentation client to instruction counting, opcode
counting, and instruction tracing clients.
- Added an example of using Region-of-Interest (ROI) macros in Fortran source
code in the samples/fortran_roi directory.
- Updated GCC linker/loader support from GCC 8.2 to GCC 9.2.
Bug Fixes
---------
- Critical bug fix for OpenMPI applications.
- Improved installation compatibility with Arm Compiler for Linux and Arm
Performance Libraries. This fixes a bug which required users to load the ArmIE
environment module before loading the Arm Compiler for Linux and Arm
Performance Libraries environment module.
Other Changes
-------------
- License is set to expire after 31st January 2021.
-
Release Note
Release Note for Download Arm Instruction Emulator 20.0
×-------------------------------
| Arm Instruction Emulator 20.0 |
-------------------------------
Arm Instruction Emulator (ArmIE) allows users to emulate SVE instructions on
AArch64 hardware. Based on the DynamoRIO dynamic binary instrumentation API,
ArmIE has added features for instrumenting AArch64 and SVE instructions. See
'RELEASE HISTORY' below for changes in this release.
System Requirements
===================
ArmIE is supported on the following Linux platforms:
- AArch64 Redhat 7.2 and 7.3
- AArch64 SuSE 12
- AArch64 Ubuntu 16.04
Installation Instructions
=========================
To install the emulator, untar the release package:
$ tar -xvzf ARM-Instruction-Emulator_20.0_AArch64_<OS>_<OS_Version>_aarch64.tar.gz
Where:
ARM-Instruction-Emulator_20.0_AArch64_<OS>_<OS_Version>_aarch64.tar.gz
is the name of the <OS> <OS_Version> package.
$ cd ARM-Instruction-Emulator_20.0_AArch64_<OS>_<OS_Version>_aarch64
Install the emulator in /opt as root user:
$ sudo ./arm-instruction-emulator-20.0_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux-rpm.sh
Or use the -i, --install-to <directory> option to install to a specified location.
You must read the EULA, presented to you as part of the install process, before
accepting or rejecting the agreement.
All files including the EULA file, license_agreement.txt, are unpacked to
/opt/arm/arm-instruction-emulator-20.0_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux
If the -i, --install-to <directory> option is used, files are unpacked to
<directory>/arm-instruction-emulator-20.0_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux.
If, after installation, you decide not to agree to the terms of the EULA you
must not run the emulator and you should delete all the installed files as
described in 'Uninstalling' below.
Known Issues
============
There are DynamoRIO defects and issues logged at https://github.com/DynamoRIO/dynamorio/issues
which may result in instrumentation and emulation failures. Note that thorough
testing and validation of this release has not resulted in any bugs related to
those issues.
There is a known DynamoRIO issue which causes hangs on some AArch64 hardware:
https://github.com/DynamoRIO/dynamorio/issues/1698
ArmIE has a workaround for this using the --unsafe-ldstex option. This feature
is enabled by default and has now been deprecated. It will be removed in a
future release.
Documentation
=============
Refer to the Arm Developer website for supporting information about Arm
Instruction Emulator:
https://developer.arm.com/tools-and-software/server-and-hpc/compile/arm-instruction-emulator
This includes tutorials and other useful information for custom analysis of your
code:
https://developer.arm.com/tools-and-software/server-and-hpc/compile/arm-instruction-emulator/resources
Further help and tutorials for all of Arm's HPC tools can be found online at:
https://developer.arm.com/tools-and-software/server-and-hpc/help/help-and-tutorials
There is also a README.txt file in /opt/arm/arm-instruction-emulator-20.0_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux.
If you require support please contact support-hpc-sw@arm.com
Uninstalling
============
Run the /opt/arm/arm-instruction-emulator-20.0_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux/uninstall.sh script.
-----------------
| RELEASE HISTORY |
-----------------
Changes in Release 20.0
=======================
Removed Features
----------------
- The --unsafe-ldstex has been deprecated and is enabled by default. A new
option, --safe-ldstex, has been added in the unlikely event that
--unsafe-ldstex needs to be disabled.
New Features and Enhancements
-----------------------------
- Added command option --safe-ldstex, (see 'Removed Features' above).
- Added support for the emulated v8.2 instructions: frsqrte, frsqrts, fmax, fmaxp
and fdiv. Optimization of emulated v8.2 instructions: fmax and fma.
- Adds support for the full diagnostic reporting of illegal instructions
(SIGILL), in other words, displaying the illegal encoding and its subject
binary PC address.
- Added armie command line option, --arg-iclient, to enable the passing of
arguments to instrumentation clients.
- Consistency updates to Region-of-Interest (ROI) feature, originally extended
from memory tracing instrumentation client to instruction counting, opcode
counting, and instruction tracing clients.
- Added an example of using Region-of-Interest (ROI) macros in Fortran source
code in the samples/fortran_roi directory.
- Updated GCC linker/loader support from GCC 8.2 to GCC 9.2.
Bug Fixes
---------
- Critical bug fix for OpenMPI applications.
- Improved installation compatibility with Arm Compiler for Linux and Arm
Performance Libraries. This fixes a bug which required users to load the ArmIE
environment module before loading the Arm Compiler for Linux and Arm
Performance Libraries environment module.
Other Changes
-------------
- License is set to expire after 31st January 2021.
Changes in Release 19.2
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- Emulation of the following v8.2 and v8.3 instructions based on detection of
hardware capability at startup:
v8.2 half-precision instructions:
fadd, fsub, fmul, fmul (by element), fmla, fmla (by element), fmadd, fmsub,
fmls, fmls (by element), fneg, fcmp.
v8.3: fcmla, fcadd
- Upgraded to be compatible with GCC 8.2 linker/loader, (from GCC 7.1).
Bug Fixes
---------
- None.
Other Changes
-------------
- License set to expire after 31st August 2020.
Changes in Release 19.1
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- Addition of an uninstall.sh script
Bug Fixes
---------
- None.
Other Changes
-------------
- License extended to 31st March 2021.
Changes in Release 19.0
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- The regions-of-interest feature (ROI), has been added to the following
instrumentation clients:
api/samples/inscount_emulated.cpp
api/samples/instrace_emulated.c
api/samples/memtrace_emulated.c
api/samples/opcodes_emulated.cpp
Bug Fixes
---------
- An ELF loader bug which resulted in failures when running Fortran binaries has
been fixed.
Other Changes
-------------
- Documentation has been updated to include more information about analysing
specific aspects of runtime performance using existing instrumentation
clients, or developing your own. See:
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator/tutorials
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator/structure-of-an-instrumentation-client
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator/building-custom-analysis-instrumentation
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator/building-an-emulation-aware-instrumentation-client
Change in Release 18.4
======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- None.
Bug Fixes
---------
- This version can successfully run multi-threaded subject binaries, including
those linked with OpenMP libraries.
Other Changes
-------------
- None.
Changes in Release 18.3
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- Emulation has been separated from instrumentation based on the addition of an
emulation interface to the DynamoRIO API allowing users to develop their own
instrumentation clients:
drmgr_is_emulation_start()
drmgr_is_emulation_end()
drmgr_get_emulation_instr_data()
drmgr_create_emulation_start()
drmgr_create_emulation_end()
emulated_instr_t
Two instruction count clients, an opcodes client and a memory trace client have
been provided as examples. Another emulation feature to simplify iteration over
blocks with emulated instructions is planned for a future release. If accepted
upstream, this emulation-aware iterator will simplify instrumentation when
running with emulation clients.
Bug Fixes
---------
- None
Other Changes
-------------
- A script, enc2instr.py, which can be used to disassemble instruction encodings
to mnemonics. Useful for disassembling the output from
drmgr_get_emulation_instr_data(). The script is based on llvm-mc and defaults
to disassembling SVE, but can be any legal -mattr value supported by llvm-mc.
- All license files are now in the license_terms directory.
Changes in Release 18.2
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
This release begins the process of separating emulation clients from
instrumentation clients. The implementation of an instruction count client and
memory tracing clients are the first examples of such a separation.
Bug Fixes
---------
- A bug in counting non-SVE instructions has been fixed.
Other Changes
-------------
- A helper option to output the full drrun command used by armie:
-s, --show-drrun-cmd.
Changes in Release 18.1
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- There are significant improvements in runtime performance principally due to
optimisations in SVE emulation functions (mostly floating-point emulation
including faster FCMLA) and memory copying.
Bug Fixes
---------
- Floating point corrections including:
- Handling of inactive vector elements.
- Floating point <-> integer conversions.
- FPSR updates by and for modifying instructions.
- Operand ordering for commutative operations.
- Handling of NaNs.
Other Changes
-------------
- None.
Changes in Release 18.0
=======================
This is the first release which integrates ArmIE with the Open Source DynamoRIO
dynamic binary instrumentation platform (http://www.dynamorio.org/home.html).
The previous release of Arm Instruction Emulator was 1.2.1. The version
numbering scheme has changed with this release in order to remain consistent
with other Arm AArch64 HPC software tools.
Removed Features
----------------
The functionality enabled by the following command line options is not available
in this release. They may be added in future releases.
-d, --debug Enabled assertion checks in the emulator.
-o, --output Redirected all messages generated by armie to a file.
-p, --profile-period Enabled the performance profiler.
-msve-memtrace Enabled memory tracing.
New Features
------------
- Arm Instruction Emulator 18.0 runs using DynamoRIO clients to provide SVE
emulation and limited instrumentation for both emulated SVE instructions and
native AArch64 instructions. Previous releases emulated SVE instructions with
no coverage of native AArch64 instructions.
Bug Fixes
---------
- None. This is the first release based on DynamoRIO.
Other Changes
-------------
- None. - EULA
-
-
Download Arm Instruction Emulator: 19.2 August 30, 2019
What's new in 19.2
Changes in Release 19.2
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- Emulation of the following v8.2 and v8.3 instructions based on detection of
hardware capability at startup:
v8.2 half-precision instructions:
fadd, fsub, fmul, fmul (by element), fmla, fmla (by element), fmadd, fmsub,
fmls, fmls (by element), fneg, fcmp.
v8.3: fcmla, fcadd
- Upgraded to be compatible with GCC 8.2 linker/loader, (from GCC 7.1).
Bug Fixes
---------
- None.
Other Changes
-------------
- License set to expire after 31st August 2020.-
Release Note
Release Note for Download Arm Instruction Emulator 19.2
×-------------------------------
| Arm Instruction Emulator 19.2 |
-------------------------------
Arm Instruction Emulator (ArmIE) allows users to emulate SVE instructions on
AArch64 hardware. Based on the DynamoRIO dynamic binary instrumentation API,
ArmIE has added features for instrumenting AArch64 and SVE instructions. See
'RELEASE HISTORY' below for changes in this release.
System Requirements
===================
ArmIE is supported on the following Linux platforms:
- AArch64 Redhat 7.2 and 7.3
- AArch64 SuSE 12
- AArch64 Ubuntu 16.04
Installation Instructions
=========================
To install the emulator, you should untar the release package:
$ tar -xvzf ARM-Instruction-Emulator_19.2_AArch64_<OS>_<OS_Version>_aarch64.tar.gz
Where:
ARM-Instruction-Emulator_19.2_AArch64_<OS>_<OS_Version>_aarch64.tar.gz
is the name of the <OS> <OS_Version> package.
$ cd ARM-Instruction-Emulator_19.2_AArch64_<OS>_<OS_Version>_aarch64
Install the emulator in /opt as root user:
$ sudo ./arm-instruction-emulator-19.2_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux-rpm.sh
Or use the -i, --install-to <directory> option to install to a specified location.
You must read the EULA, presented to you as part of the install process, before
accepting or rejecting the agreement.
All files including the EULA file, license_agreement.txt, are unpacked to
/opt/arm/arm-instruction-emulator-19.2_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux
If the -i, --install-to <directory> option is used, files are unpacked to
<directory>/opt/arm/arm-instruction-emulator-19.2_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux.
If, after installation, you decide not to agree to the terms of the EULA you
must not run the emulator and you should delete all the installed files as
described in 'Uninstalling' below.
Known Issues
============
There are DynamoRIO defects and issues logged at https://github.com/DynamoRIO/dynamorio/issues
which may result in instrumentation and emulation failures. Note that thorough
testing and validation of this release has not resulted in any bugs related to
those issues.
There is a known DynamoRIO issue which causes hangs on some AArch64 hardware:
https://github.com/DynamoRIO/dynamorio/issues/1698
ArmIE has a workaround for this using the --unsafe-ldstex option. This feature
is not enabled by default as it is not yet a reliable fix.
Code Advisor is not compatible with this version of the Arm Instruction Emulator.
Documentation
=============
Refer to the Arm Developer website for supporting information about Arm
Instruction Emulator:
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator
This includes tutorials and other useful information for custom analysis of your
code:
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator/tutorials
Further help and tutorials for all of Arm's HPC tools can be found online at:
https://developer.arm.com/tools-and-software/server-and-hpc
There is also a README.txt file in /opt/arm/arm-instruction-emulator-19.2_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux.
If you require support please contact support-hpc-sw@arm.com
Uninstalling
============
Run the /opt/arm/arm-instruction-emulator-19.2_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux/uninstall.sh script.
-----------------
| RELEASE HISTORY |
-----------------
Changes in Release 19.2
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- Emulation of the following v8.2 and v8.3 instructions based on detection of
hardware capability at startup:
v8.2 half-precision instructions:
fadd, fsub, fmul, fmul (by element), fmla, fmla (by element), fmadd, fmsub,
fmls, fmls (by element), fneg, fcmp.
v8.3: fcmla, fcadd
- Upgraded to be compatible with GCC 8.2 linker/loader, (from GCC 7.1).
Bug Fixes
---------
- None.
Other Changes
-------------
- License set to expire after 31st August 2020.
Changes in Release 19.1
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- Addition of an uninstall.sh script
Bug Fixes
---------
- None.
Other Changes
-------------
- License extended to 31st March 2021.
Changes in Release 19.0
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- The regions-of-interest feature (ROI), has been added to the following
instrumentation clients:
api/samples/inscount_emulated.cpp
api/samples/instrace_emulated.c
api/samples/memtrace_emulated.c
api/samples/opcodes_emulated.cpp
Bug Fixes
---------
- An ELF loader bug which resulted in failures when running Fortran binaries has
been fixed.
Other Changes
-------------
- Documentation has been updated to include more information about analysing
specific aspects of runtime performance using existing instrumentation
clients, or developing your own. See:
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator/tutorials
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator/structure-of-an-instrumentation-client
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator/building-custom-analysis-instrumentation
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator/building-an-emulation-aware-instrumentation-client
Change in Release 18.4
======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- None.
Bug Fixes
---------
- This version can successfully run multi-threaded subject binaries, including
those linked with OpenMP libraries.
Other Changes
-------------
- None.
Changes in Release 18.3
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- Emulation has been separated from instrumentation based on the addition of an
emulation interface to the DynamoRIO API allowing users to develop their own
instrumentation clients:
drmgr_is_emulation_start()
drmgr_is_emulation_end()
drmgr_get_emulation_instr_data()
drmgr_create_emulation_start()
drmgr_create_emulation_end()
emulated_instr_t
Two instruction count clients, an opcodes client and a memory trace client have
been provided as examples. Another emulation feature to simplify iteration over
blocks with emulated instructions is planned for a future release. If accepted
upstream, this emulation-aware iterator will simplify instrumentation when
running with emulation clients.
Bug Fixes
---------
- None
Other Changes
-------------
- A script, enc2instr.py, which can be used to disassemble instruction encodings
to mnemonics. Useful for disassembling the output from
drmgr_get_emulation_instr_data(). The script is based on llvm-mc and defaults
to disassembling SVE, but can be any legal -mattr value supported by llvm-mc.
- All license files are now in the license_terms directory.
Changes in Release 18.2
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
This release begins the process of separating emulation clients from
instrumentation clients. The implementation of an instruction count client and
memory tracing clients are the first examples of such a separation.
Bug Fixes
---------
- A bug in counting non-SVE instructions has been fixed.
Other Changes
-------------
- A helper option to output the full drrun command used by armie:
-s, --show-drrun-cmd.
Changes in Release 18.1
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- There are significant improvements in runtime performance principally due to
optimisations in SVE emulation functions (mostly floating-point emulation
including faster FCMLA) and memory copying.
Bug Fixes
---------
- Floating point corrections including:
- Handling of inactive vector elements.
- Floating point <-> integer conversions.
- FPSR updates by and for modifying instructions.
- Operand ordering for commutative operations.
- Handling of NaNs.
Other Changes
-------------
- None.
Changes in Release 18.0
=======================
This is the first release which integrates ArmIE with the Open Source DynamoRIO
dynamic binary instrumentation platform (http://www.dynamorio.org/home.html).
The previous release of Arm Instruction Emulator was 1.2.1. The version
numbering scheme has changed with this release in order to remain consistent
with other Arm AArch64 HPC software tools.
Removed Features
----------------
The functionality enabled by the following command line options is not available
in this release. They may be added in future releases.
-d, --debug Enabled assertion checks in the emulator.
-o, --output Redirected all messages generated by armie to a file.
-p, --profile-period Enabled the performance profiler.
-msve-memtrace Enabled memory tracing.
New Features
------------
- Arm Instruction Emulator 18.0 runs using DynamoRIO clients to provide SVE
emulation and limited instrumentation for both emulated SVE instructions and
native AArch64 instructions. Previous releases emulated SVE instructions with
no coverage of native AArch64 instructions.
Bug Fixes
---------
- None. This is the first release based on DynamoRIO.
Other Changes
-------------
- None.
- EULA
-
-
Download Arm Instruction Emulator: 19.1 July 03, 2019
What's new in 19.1
Changes in Release 19.1
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- Addition of an uninstall.sh script
Bug Fixes
---------
- None.
Other Changes
-------------
- License extended to 31st March 2021.-
Release Note
Release Note for Download Arm Instruction Emulator 19.1
×-------------------------------
| Arm Instruction Emulator 19.1 |
-------------------------------
Arm Instruction Emulator (ArmIE) allows users to emulate SVE instructions on
AArch64 hardware. Based on the DynamoRIO dynamic binary instrumentation API,
ArmIE has added features for instrumenting AArch64 and SVE instructions. See
'RELEASE HISTORY' below for changes in this release.
System Requirements
===================
ArmIE is supported on the following Linux platforms:
- AArch64 Redhat 7.2 and 7.3
- AArch64 SuSE 12
- AArch64 Ubuntu 16.04
Installation Instructions
=========================
To install the emulator, you should untar the release package:
$ tar -xvzf ARM-Instruction-Emulator_19.1_AArch64_<OS>_<OS_Version>_aarch64.tar.gz
Where:
ARM-Instruction-Emulator_19.1_AArch64_<OS>_<OS_Version>_aarch64.tar.gz
is the name of the <OS> <OS_Version> package.
$ cd ARM-Instruction-Emulator_19.1_AArch64_<OS>_<OS_Version>_aarch64
Install the emulator in /opt as root user:
$ sudo ./arm-instruction-emulator-19.1_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux-rpm.sh
Or use the -i, --install-to <directory> option to install to a specified location.
You must read the EULA, presented to you as part of the install process, before
accepting or rejecting the agreement.
All files including the EULA file, license_agreement.txt, are unpacked to
/opt/arm/arm-instruction-emulator-19.1_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux
If the -i, --install-to <directory> option is used, files are unpacked to
<directory>/opt/arm/arm-instruction-emulator-19.1_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux.
If, after installation, you decide not to agree to the terms of the EULA you
must not run the emulator and you should delete all the installed files as
described in 'Uninstalling' below.
Known Issues
============
There are DynamoRIO defects and issues logged at https://github.com/DynamoRIO/dynamorio/issues
which may result in instrumentation and emulation failures. Note that thorough
testing and validation of this release has not resulted in any bugs related to
those issues.
There is a known DynamoRIO issue which causes hangs on some AArch64 hardware:
https://github.com/DynamoRIO/dynamorio/issues/1698
ArmIE has a workaround for this using the --unsafe-ldstex option. This feature
is not enabled by default as it is not yet a reliable fix.
Code Advisor is not compatible with this version of the Arm Instruction Emulator.
Documentation
=============
Refer to the Arm Developer website for supporting information about Arm
Instruction Emulator:
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator
This includes tutorials and other useful information for custom analysis of your
code:
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator/tutorials
Further help and tutorials for all of Arm's HPC tools can be found online at:
https://developer.arm.com/tools-and-software/server-and-hpc
There is also a README.txt file in /opt/arm/arm-instruction-emulator-19.1_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux.
If you require support please contact support-hpc-sw@arm.com
Uninstalling
============
Run the /opt/arm/arm-instruction-emulator-19.1_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux/uninstall.sh script.
-----------------
| RELEASE HISTORY |
-----------------
Changes in Release 19.1
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- Addition of an uninstall.sh script
Bug Fixes
---------
- None.
Other Changes
-------------
- License extended to 31st March 2021.
Changes in Release 19.0
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- The regions-of-interest feature (ROI), has been added to the following
instrumentation clients:
api/samples/inscount_emulated.cpp
api/samples/instrace_emulated.c
api/samples/memtrace_emulated.c
api/samples/opcodes_emulated.cpp
Bug Fixes
---------
- An ELF loader bug which resulted in failures when running Fortran binaries has
been fixed.
Other Changes
-------------
- Documentation has been updated to include more information about analysing
specific aspects of runtime performance using existing instrumentation
clients, or developing your own. See:
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator/tutorials
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator/structure-of-an-instrumentation-client
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator/building-custom-analysis-instrumentation
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator/building-an-emulation-aware-instrumentation-client
Change in Release 18.4
======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- None.
Bug Fixes
---------
- This version can successfully run multi-threaded subject binaries, including
those linked with OpenMP libraries.
Other Changes
-------------
- None.
Changes in Release 18.3
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- Emulation has been separated from instrumentation based on the addition of an
emulation interface to the DynamoRIO API allowing users to develop their own
instrumentation clients:
drmgr_is_emulation_start()
drmgr_is_emulation_end()
drmgr_get_emulation_instr_data()
drmgr_create_emulation_start()
drmgr_create_emulation_end()
emulated_instr_t
Two instruction count clients, an opcodes client and a memory trace client have
been provided as examples. Another emulation feature to simplify iteration over
blocks with emulated instructions is planned for a future release. If accepted
upstream, this emulation-aware iterator will simplify instrumentation when
running with emulation clients.
Bug Fixes
---------
- None
Other Changes
-------------
- A script, enc2instr.py, which can be used to disassemble instruction encodings
to mnemonics. Useful for disassembling the output from
drmgr_get_emulation_instr_data(). The script is based on llvm-mc and defaults
to disassembling SVE, but can be any legal -mattr value supported by llvm-mc.
- All license files are now in the license_terms directory.
Changes in Release 18.2
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
This release begins the process of separating emulation clients from
instrumentation clients. The implementation of an instruction count client and
memory tracing clients are the first examples of such a separation.
Bug Fixes
---------
- A bug in counting non-SVE instructions has been fixed.
Other Changes
-------------
- A helper option to output the full drrun command used by armie:
-s, --show-drrun-cmd.
Changes in Release 18.1
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- There are significant improvements in runtime performance principally due to
optimisations in SVE emulation functions (mostly floating-point emulation
including faster FCMLA) and memory copying.
Bug Fixes
---------
- Floating point corrections including:
- Handling of inactive vector elements.
- Floating point <-> integer conversions.
- FPSR updates by and for modifying instructions.
- Operand ordering for commutative operations.
- Handling of NaNs.
Other Changes
-------------
- None.
Changes in Release 18.0
=======================
This is the first release which integrates ArmIE with the Open Source DynamoRIO
dynamic binary instrumentation platform (http://www.dynamorio.org/home.html).
The previous release of Arm Instruction Emulator was 1.2.1. The version
numbering scheme has changed with this release in order to remain consistent
with other Arm AArch64 HPC software tools.
Removed Features
----------------
The functionality enabled by the following command line options is not available
in this release. They may be added in future releases.
-d, --debug Enabled assertion checks in the emulator.
-o, --output Redirected all messages generated by armie to a file.
-p, --profile-period Enabled the performance profiler.
-msve-memtrace Enabled memory tracing.
New Features
------------
- Arm Instruction Emulator 18.0 runs using DynamoRIO clients to provide SVE
emulation and limited instrumentation for both emulated SVE instructions and
native AArch64 instructions. Previous releases emulated SVE instructions with
no coverage of native AArch64 instructions.
Bug Fixes
---------
- None. This is the first release based on DynamoRIO.
Other Changes
-------------
- None.
- EULA
-
-
Download Arm Instruction Emulator: 19.0 April 05, 2019
What's new in 19.0
Changes in Release 19.0
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- The regions-of-interest feature (ROI), has been added to the following
instrumentation clients:
api/samples/inscount_emulated.cpp
api/samples/instrace_emulated.c
api/samples/memtrace_emulated.c
api/samples/opcodes_emulated.cpp
Bug Fixes
---------
- An ELF loader bug which resulted in failures when running Fortran binaries has
been fixed.
Other Changes
-------------
- Documentation has been updated to include more information about analysing
specific aspects of runtime performance using existing instrumentation
clients, or developing your own. See:
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator/tutorials
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator/structure-of-an-instrumentation-client
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator/building-custom-analysis-instrumentation
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator/building-an-emulation-aware-instrumentation-client-
Release Note
Release Note for Download Arm Instruction Emulator 19.0
×-------------------------------
| Arm Instruction Emulator 19.0 |
-------------------------------
Arm Instruction Emulator (ArmIE) allows users to emulate SVE instructions on
AArch64 hardware. Based on the DynamoRIO dynamic binary instrumentation API,
ArmIE has added features for instrumenting AArch64 and SVE instructions. See
'RELEASE HISTORY' below for changes in this release.
System Requirements
===================
ArmIE is supported on the following Linux platforms:
- AArch64 Redhat 7.2 and 7.3
- AArch64 SuSE 12
- AArch64 Ubuntu 16.04
Installation Instructions
=========================
To install the emulator, you should untar the release package:
$ tar -xvzf ARM-Instruction-Emulator_19.0_AArch64_<OS>_<OS_Version>_aarch64.tar.gz
Where:
ARM-Instruction-Emulator_19.0_AArch64_<OS>_<OS_Version>_aarch64.tar.gz
is the name of the <OS> <OS_Version> package.
$ cd ARM-Instruction-Emulator_19.0_AArch64_<OS>_<OS_Version>_aarch64
Install the emulator in /opt as root user:
$ sudo ./arm-instruction-emulator-19.0_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux-rpm.sh
Or use the -i, --install-to <directory> option to install to a specified location.
You must read the EULA, presented to you as part of the install process, before
accepting or rejecting the agreement.
All files including the EULA file, license_agreement.txt, are unpacked to
/opt/arm/arm-instruction-emulator-19.0_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux
If the -i, --install-to <directory> option is used, files are unpacked to
<directory>/opt/arm/arm-instruction-emulator-19.0_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux.
If, after installation, you decide not to agree to the terms of the EULA you
must not run the emulator and you should delete all the installed files as
described in 'Uninstalling' below.
Known Issues
============
There are DynamoRIO defects and issues logged at https://github.com/DynamoRIO/dynamorio/issues
which may result in instrumentation and emulation failures. Note that thorough
testing and validation of this release has not resulted in any bugs related to
those issues.
There is a known DynamoRIO issue which causes hangs on some AArch64 hardware:
https://github.com/DynamoRIO/dynamorio/issues/1698
ArmIE has a workaround for this using the --unsafe-ldstex option. This feature
is not enabled by default as it is not yet a reliable fix.
Code Advisor is not compatible with this version of the Arm Instruction Emulator.
Documentation
=============
Refer to the Arm Developer website for supporting information about Arm
Instruction Emulator:
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator
This includes tutorials and other useful information for custom analysis of your
code:
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator/tutorials
Further help and tutorials for all of Arm's HPC tools can be found online at:
https://developer.arm.com/tools-and-software/server-and-hpc
There is also a README.txt file in /opt/arm/arm-instruction-emulator-19.0_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux.
If you require support please contact support-hpc-sw@arm.com
Uninstalling
============
Delete all files and directories in the /opt/arm/arm-instruction-emulator-19.0_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux directory.
-----------------
| RELEASE HISTORY |
-----------------
Changes in Release 19.0
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- The regions-of-interest feature (ROI), has been added to the following
instrumentation clients:
api/samples/inscount_emulated.cpp
api/samples/instrace_emulated.c
api/samples/memtrace_emulated.c
api/samples/opcodes_emulated.cpp
Bug Fixes
---------
- An ELF loader bug which resulted in failures when running Fortran binaries has
been fixed.
Other Changes
-------------
- Documentation has been updated to include more information about analysing
specific aspects of runtime performance using existing instrumentation
clients, or developing your own. See:
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator/tutorials
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator/structure-of-an-instrumentation-client
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator/building-custom-analysis-instrumentation
https://developer.arm.com/tools-and-software/server-and-hpc/arm-architecture-tools/arm-instruction-emulator/building-an-emulation-aware-instrumentation-client
Change in Release 18.4
======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- None.
Bug Fixes
---------
- This version can successfully run multi-threaded subject binaries, including
those linked with OpenMP libraries.
Other Changes
-------------
- None.
Changes in Release 18.3
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- Emulation has been separated from instrumentation based on the addition of an
emulation interface to the DynamoRIO API allowing users to develop their own
instrumentation clients:
drmgr_is_emulation_start()
drmgr_is_emulation_end()
drmgr_get_emulation_instr_data()
drmgr_create_emulation_start()
drmgr_create_emulation_end()
emulated_instr_t
Two instruction count clients, an opcodes client and a memory trace client have
been provided as examples. Another emulation feature to simplify iteration over
blocks with emulated instructions is planned for a future release. If accepted
upstream, this emulation-aware iterator will simplify instrumentation when
running with emulation clients.
Bug Fixes
---------
- None
Other Changes
-------------
- A script, enc2instr.py, which can be used to disassemble instruction encodings
to mnemonics. Useful for disassembling the output from
drmgr_get_emulation_instr_data(). The script is based on llvm-mc and defaults
to disassembling SVE, but can be any legal -mattr value supported by llvm-mc.
- All license files are now in the license_terms directory.
Changes in Release 18.2
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
This release begins the process of separating emulation clients from
instrumentation clients. The implementation of an instruction count client and
memory tracing clients are the first examples of such a separation.
Bug Fixes
---------
- A bug in counting non-SVE instructions has been fixed.
Other Changes
-------------
- A helper option to output the full drrun command used by armie:
-s, --show-drrun-cmd.
Changes in Release 18.1
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- There are significant improvements in runtime performance principally due to
optimisations in SVE emulation functions (mostly floating-point emulation
including faster FCMLA) and memory copying.
Bug Fixes
---------
- Floating point corrections including:
- Handling of inactive vector elements.
- Floating point <-> integer conversions.
- FPSR updates by and for modifying instructions.
- Operand ordering for commutative operations.
- Handling of NaNs.
Other Changes
-------------
- None.
Changes in Release 18.0
=======================
This is the first release which integrates ArmIE with the Open Source DynamoRIO
dynamic binary instrumentation platform (http://www.dynamorio.org/home.html).
The previous release of Arm Instruction Emulator was 1.2.1. The version
numbering scheme has changed with this release in order to remain consistent
with other Arm AArch64 HPC software tools.
Removed Features
----------------
The functionality enabled by the following command line options is not available
in this release. They may be added in future releases.
-d, --debug Enabled assertion checks in the emulator.
-o, --output Redirected all messages generated by armie to a file.
-p, --profile-period Enabled the performance profiler.
-msve-memtrace Enabled memory tracing.
New Features
------------
- Arm Instruction Emulator 18.0 runs using DynamoRIO clients to provide SVE
emulation and limited instrumentation for both emulated SVE instructions and
native AArch64 instructions. Previous releases emulated SVE instructions with
no coverage of native AArch64 instructions.
Bug Fixes
---------
- None. This is the first release based on DynamoRIO.
Other Changes
-------------
- None.
- EULA
-
-
Download Arm Instruction Emulator: 18.4 November 02, 2018
What's new in 18.4
Changes in Release 18.4
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- None.
Bug Fixes
---------
- This version can successfully run multi-threaded subject binaries, including
those linked with OpenMP libraries.
Other Changes
-------------
- None.-
Release Note
Release Note for Download Arm Instruction Emulator 18.4
×-------------------------------
| Arm Instruction Emulator 18.4 |
-------------------------------
This version of the Arm Instruction Emulator (ArmIE) allows users to emulate
SVE instructions on AArch64 hardware with added features for instrumenting
AArch64 and SVE instructions. See 'RELEASE HISTORY' below for changes in this
release.
System Requirements
===================
ArmIE is supported on the following Linux platforms:
- AArch64 Redhat 7.2 and 7.3
- AArch64 SuSE 12
- AArch64 Ubuntu 16.04
Installation Instructions
=========================
To install the emulator, you should untar the release package:
$ tar -xvzf ARM-Instruction-Emulator_18.4_AArch64_<OS>_<OS_Version>_aarch64.tar.gz
Where:
ARM-Instruction-Emulator_18.4_AArch64_<OS>_<OS_Version>_aarch64.tar.gz
is the name of the <OS> <OS_Version> package.
$ cd ARM-Instruction-Emulator_18.4_AArch64_<OS>_<OS_Version>_aarch64
Install the emulator in /opt as root user:
$ sudo ./arm-instruction-emulator-18.4_Generic-AArch64_<OS>-<OS_Version_aarch64-linux-rpm.sh
Or use the -i, --install-to <directory> option to install to a specified location.
You must read the EULA, presented to you as part of the install process, before
accepting or rejecting the agreement.
All files including the EULA file, license_agreement.txt, are unpacked to
/opt/arm/arm-instruction-emulator-18.4_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux
If the -i, --install-to <directory> option is used, files are unpacked to
<directory>/opt/arm/arm-instruction-emulator-18.4_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux.
If, after installation, you decide not to agree to the terms of the EULA you
must not run the emulator and you should delete all the installed files as
described in 'Uninstalling' below.
Known Issues
============
There are DynamoRIO defects and issues logged at https://github.com/DynamoRIO/dynamorio/issues
which may result in instrumentation and emulation failures.
There is a known DynamoRIO issue which causes hangs on some AArch64 hardware:
https://github.com/DynamoRIO/dynamorio/issues/1698
ArmIE has a workaround for this using the --unsafe-ldstex option. This feature
is not enabled by default as it is not yet a reliable fix.
Code Advisor is not compatible with this version of the Arm Instruction Emulator.
Documentation
=============
Refer to the Arm Developer website for supporting information about Arm
Instruction Emulator:
https://developer.arm.com/products/software-development-tools/hpc/arm-instruction-emulator
Further help and tutorials for all of Arm’s HPC tools can be found online at:
https://developer.arm.com/products/software-development-tools/hpc/documentation
There is also a README.txt file in /opt/arm/arm-instruction-emulator-18.4_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux.
If you require support please contact support-hpc-sw@arm.com
Uninstalling
============
Delete all files and directories in the /opt/arm/arm-instruction-emulator-18.4_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux directory.
-----------------
| RELEASE HISTORY |
-----------------
Changes in Release 18.4
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- None.
Bug Fixes
---------
- This version can successfully run multi-threaded subject binaries, including
those linked with OpenMP libraries.
Other Changes
-------------
- None.
Changes in Release 18.3
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- Emulation has been separated from instrumentation based on the addition of an
emulation interface to the DynamoRIO API allowing users to develop their own
instrumentation clients:
drmgr_is_emulation_start()
drmgr_is_emulation_end()
drmgr_get_emulation_instr_data()
drmgr_create_emulation_start()
drmgr_create_emulation_end()
emulated_instr_t
Two instruction count clients, an opcodes client and a memory trace client have
been provided as examples. Another emulation feature to simplify iteration over
blocks with emulated instructions is planned for a future release. If accepted
upstream, this emulation-aware iterator will simplify instrumentation when
running with emulation clients.
Bug Fixes
---------
- None
Other Changes
-------------
- A script, enc2instr.py, which can be used to disassemble instruction encodings
to mnemonics. Useful for disassembling the output from
drmgr_get_emulation_instr_data(). The script is based on llvm-mc and defaults
to disassembling SVE, but can be any legal -mattr value supported by llvm-mc.
- All license files are now in the license_terms directory.
Changes in Release 18.2
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
This release begins the process of separating emulation clients from
instrumentation clients. The implementation of an instruction count client and
memory tracing clients are the first examples of such a separation.
Bug Fixes
---------
- A bug in counting non-SVE instructions has been fixed.
Other Changes
-------------
- A helper option to output the full drrun command used by armie:
-s, --show-drrun-cmd.
Changes in Release 18.1
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- There are significant improvements in runtime performance principally due to
optimisations in SVE emulation functions (mostly floating-point emulation
including faster FCMLA) and memory copying.
Bug Fixes
---------
- Floating point corrections including:
- Handling of inactive vector elements.
- Floating point <-> integer conversions.
- FPSR updates by and for modifying instructions.
- Operand ordering for commutative operations.
- Handling of NaNs.
Other Changes
-------------
- None.
Changes in Release 18.0
=======================
This is the first release which integrates ArmIE with the Open Source DynamoRIO
dynamic binary instrumentation platform (http://www.dynamorio.org/home.html).
The previous release of Arm Instruction Emulator was 1.2.1. The version
numbering scheme has changed with this release in order to remain consistent
with other Arm AArch64 HPC software tools.
Removed Features
----------------
The functionality enabled by the following command line options is not available
in this release. They may be added in future releases.
-d, --debug Enabled assertion checks in the emulator.
-o, --output Redirected all messages generated by armie to a file.
-p, --profile-period Enabled the performance profiler.
-msve-memtrace Enabled memory tracing.
New Features
------------
- Arm Instruction Emulator 18.0 runs using DynamoRIO clients to provide SVE
emulation and limited instrumentation for both emulated SVE instructions and
native AArch64 instructions. Previous releases emulated SVE instructions with
no coverage of native AArch64 instructions.
Bug Fixes
---------
- None. This is the first release based on DynamoRIO.
Other Changes
-------------
- None.
- EULA
-
-
Download Arm Instruction Emulator: 18.3 October 05, 2018
What's new in 18.3
Changes in Release 18.3
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- Emulation has been separated from instrumentation based on the addition of an
emulation interface to the DynamoRIO API allowing users to develop their own
instrumentation clients:
drmgr_is_emulation_start()
drmgr_is_emulation_end()
drmgr_get_emulation_instr_data()
drmgr_create_emulation_start()
drmgr_create_emulation_end()
emulated_instr_t
Two instruction count clients, an opcodes client and a memory trace client have
been provided as examples. Another emulation feature to simplify iteration over
blocks with emulated instructions is planned for a future release. If accepted
upstream, this emulation-aware iterator will simplify instrumentation when
running with emulation clients.
Bug Fixes
---------
- None
Other Changes
-------------
- A script, enc2instr.py, which can be used to disassemble instruction encodings
to mnemonics. Useful for disassembling the output from
drmgr_get_emulation_instr_data(). The script is based on llvm-mc and defaults
to disassembling SVE, but can be any legal -mattr value supported by llvm-mc.
- All license files are now in the license_terms directory.-
Release Note
Release Note for Download Arm Instruction Emulator 18.3
×-------------------------------
| Arm Instruction Emulator 18.3 |
-------------------------------
This version of the Arm Instruction Emulator (ArmIE) allows users to emulate
SVE instructions on AArch64 hardware with added features for instrumenting
AArch64 and SVE instructions. See 'RELEASE HISTORY' below for changes in this
release.
System Requirements
===================
ArmIE is supported on the following Linux platforms:
- AArch64 Redhat 7.2 and 7.3
- AArch64 SuSE 12
- AArch64 Ubuntu 16.04
Installation Instructions
=========================
To install the emulator, you should untar the release package:
$ tar -xvzf ARM-Instruction-Emulator_18.3_AArch64_<OS>_<OS_Version>_aarch64.tar.gz
Where:
ARM-Instruction-Emulator_18.3_AArch64_<OS>_<OS_Version>_aarch64.tar.gz
is the name of the <OS> <OS_Version> package.
$ cd ARM-Instruction-Emulator_18.3_AArch64_<OS>_<OS_Version>_aarch64
Install the emulator in /opt as root user:
$ sudo ./arm-instruction-emulator-18.3_Generic-AArch64_<OS>-<OS_Version_aarch64-linux-rpm.sh
Or use the -i, --install-to <directory> option to install to a specified location.
You must read the EULA, presented to you as part of the install process, before
accepting or rejecting the agreement.
All files including the EULA file, license_agreement.txt, are unpacked to
/opt/arm/arm-instruction-emulator-18.3_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux
If the -i, --install-to <directory> option is used, files are unpacked to
<directory>/opt/arm/arm-instruction-emulator-18.3_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux.
If, after installation, you decide not to agree to the terms of the EULA you
must not run the emulator and you should delete all the installed files as
described in 'Uninstalling' below.
Known Issues
============
Execution of multi-threaded applications may be unreliable in this release. For
example, programs built using OpenMPI and MPI may fail. Full multi-threading
support will be available in a later release.
There are DynamoRIO defects and issues logged at https://github.com/DynamoRIO/dynamorio/issues
which may result in instrumentation and emulation failures.
There is a known DynamoRIO issue which causes hangs on some AArch64 hardware:
https://github.com/DynamoRIO/dynamorio/issues/1698
ArmIE has a workaround for this using the --unsafe-ldstex option. This feature
is not enabled by default as it is not yet a reliable fix.
Code Advisor is not compatible with this version of the Arm Instruction Emulator.
Documentation
=============
Refer to the Arm Developer website for supporting information about Arm
Instruction Emulator:
https://developer.arm.com/products/software-development-tools/hpc/arm-instruction-emulator
Further help and tutorials for all of Arm’s HPC tools can be found online at:
https://developer.arm.com/products/software-development-tools/hpc/documentation
There is also a README.txt file in /opt/arm/arm-instruction-emulator-18.3_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux.
If you require support please contact support-hpc-sw@arm.com
Uninstalling
============
Delete all files and directories in the /opt/arm/arm-instruction-emulator-18.3_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux directory.
-----------------
| RELEASE HISTORY |
-----------------
Changes in Release 18.3
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- Emulation has been separated from instrumentation based on the addition of an
emulation interface to the DynamoRIO API allowing users to develop their own
instrumentation clients:
drmgr_is_emulation_start()
drmgr_is_emulation_end()
drmgr_get_emulation_instr_data()
drmgr_create_emulation_start()
drmgr_create_emulation_end()
emulated_instr_t
Two instruction count clients, an opcodes client and a memory trace client have
been provided as examples. Another emulation feature to simplify iteration over
blocks with emulated instructions is planned for a future release. If accepted
upstream, this emulation-aware iterator will simplify instrumentation when
running with emulation clients.
Bug Fixes
---------
- None
Other Changes
-------------
- A script, enc2instr.py, which can be used to disassemble instruction encodings
to mnemonics. Useful for disassembling the output from
drmgr_get_emulation_instr_data(). The script is based on llvm-mc and defaults
to disassembling SVE, but can be any legal -mattr value supported by llvm-mc.
- All license files are now in the license_terms directory.
Changes in Release 18.2
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
This release begins the process of separating emulation clients from
instrumentation clients. The implementation of an instruction count client and
memory tracing clients are the first examples of such a separation.
Bug Fixes
---------
- A bug in counting non-SVE instructions has been fixed.
Other Changes
-------------
- A helper option to output the full drrun command used by armie:
-s, --show-drrun-cmd.
Changes in Release 18.1
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- There are significant improvements in runtime performance principally due to
optimisations in SVE emulation functions (mostly floating-point emulation
including faster FCMLA) and memory copying.
Bug Fixes
---------
- Floating point corrections including:
- Handling of inactive vector elements.
- Floating point <-> integer conversions.
- FPSR updates by and for modifying instructions.
- Operand ordering for commutative operations.
- Handling of NaNs.
Other Changes
-------------
- None.
Changes in Release 18.0
=======================
This is the first release which integrates ArmIE with the Open Source DynamoRIO
dynamic binary instrumentation platform (http://www.dynamorio.org/home.html).
The previous release of Arm Instruction Emulator was 1.2.1. The version
numbering scheme has changed with this release in order to remain consistent
with other Arm AArch64 HPC software tools.
Removed Features
----------------
The functionality enabled by the following command line options is not available
in this release. They may be added in future releases.
-d, --debug Enabled assertion checks in the emulator.
-o, --output Redirected all messages generated by armie to a file.
-p, --profile-period Enabled the performance profiler.
-msve-memtrace Enabled memory tracing.
New Features
------------
- Arm Instruction Emulator 18.0 runs using DynamoRIO clients to provide SVE
emulation and limited instrumentation for both emulated SVE instructions and
native AArch64 instructions. Previous releases emulated SVE instructions with
no coverage of native AArch64 instructions.
Bug Fixes
---------
- None. This is the first release based on DynamoRIO.
Other Changes
-------------
- None.
- EULA
-
-
Download Arm Instruction Emulator: 18.2 August 24, 2018
What's new in 18.2
Changes in Release 18.2
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
This release begins the process of separating emulation clients from
instrumentation clients. The implementation of an instruction count client and
memory tracing clients are the first examples of such a separation.
Bug Fixes
---------
- A bug in counting non-SVE instructions has been fixed.
Other Changes
-------------
- None.-
Release Note
Release Note for Download Arm Instruction Emulator 18.2
×-------------------------------
| Arm Instruction Emulator 18.2 |
-------------------------------
This version of the Arm Instruction Emulator (ArmIE) allows users to emulate
SVE instructions on AArch64 hardware with added features for instrumenting
AArch64 and SVE instructions.
System Requirements
===================
ArmIE is supported on the following Linux platforms:
- AArch64 Redhat 7.2 and 7.3
- AArch64 SuSE 12
- AArch64 Ubuntu 16.04
Installation Instructions
=========================
To install the emulator, you should untar the release package:
$ tar -xvzf ARM-Instruction-Emulator_18.2_AArch64_<OS>_<OS_Version>_aarch64.tar.gz
Where:
ARM-Instruction-Emulator_18.2_AArch64_<OS>_<OS_Version>_aarch64.tar.gz
is the name of the <OS> <OS_Version> package.
$ cd ARM-Instruction-Emulator_18.2_AArch64_<OS>_<OS_Version>_aarch64
Install the emulator in /opt as root user:
$ sudo ./arm-instruction-emulator-18.2_Generic-AArch64_<OS>-<OS_Version_aarch64-linux-rpm.sh
Or use the -i, --install-to <directory> option to install to a specified location.
You must read the EULA, presented to you as part of the install process, before
accepting or rejecting the agreement.
All files including EULA.txt are unpacked to /opt/arm/arm-instruction-emulator-18.2_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux
unless the -i, --install-to <directory> option is used.
If, after installation, you decide not to agree to the terms of the EULA you
must not run the emulator and you should delete all the installed files as
described in 'Uninstalling' below.
Known Issues
============
Execution of multi-threaded applications may be unreliable in this release. For
example, programs built using OpenMPI and MPI may fail. Full multi-threading
support will be available in a later release.
There are DynamoRIO defects and issues logged at https://github.com/DynamoRIO/dynamorio/issues
which may result in instrumentation and emulation failures.
There is a known DynamoRIO issue which causes hangs on some AArch64 hardware:
https://github.com/DynamoRIO/dynamorio/issues/1698
ArmIE has a workaround for this using the --unsafe-ldstex option. This feature
is not enabled by default as it is not yet a reliable fix.
Code Advisor is not compatible with this version of the Arm Instruction Emulator.
Documentation
=============
Refer to the Arm Developer website for supporting information about Arm
Instruction Emulator:
https://developer.arm.com/products/software-development-tools/hpc/arm-instruction-emulator
Further help and tutorials for all of Arm’s HPC tools can be found online at:
https://developer.arm.com/products/software-development-tools/hpc/documentation
There is also a README.txt file in /opt/arm/arm-instruction-emulator-18.2_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux.
If you require support please contact support-hpc-sw@arm.com
Uninstalling
============
Delete all files and directories in the /opt/arm/arm-instruction-emulator-18.2_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux directory.
----------------
| RELEASE HISTORY |
----------------
Changes in Release 18.2
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
This release begins the process of separating emulation clients from
instrumentation clients. The implementation of an instruction count client and
memory tracing clients are the first examples of such a separation.
Bug Fixes
---------
- A bug in counting non-SVE instructions has been fixed.
Other Changes
-------------
- None.
Changes in Release 18.1
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- There are significant improvements in runtime performance principally due to
optimisations in SVE emulation functions (mostly floating-point emulation
including faster FCMLA) and memory copying.
Bug Fixes
---------
- Floating point corrections including:
- Handling of inactive vector elements.
- Floating point <-> integer conversions.
- FPSR updates by and for modifying instructions.
- Operand ordering for commutative operations.
- Handling of NaNs.
Other Changes
-------------
- None.
Changes in Release 18.0
=======================
This is the first release which integrates ArmIE with the Open Source DynamoRIO
dynamic binary instrumentation platform (http://www.dynamorio.org/home.html).
The previous release of Arm Instruction Emulator was 1.2.1. The version
numbering scheme has changed with this release in order to remain consistent
with other Arm AArch64 HPC software tools.
Removed Features
----------------
The functionality enabled by the following command line options is not available
in this release. They may be added in future releases.
-d, --debug Enabled assertion checks in the emulator.
-o, --output Redirected all messages generated by armie to a file.
-p, --profile-period Enabled the performance profiler.
-msve-memtrace Enabled memory tracing.
New Features
------------
- Arm Instruction Emulator 18.0 runs using DynamoRIO clients to provide SVE
emulation and limited instrumentation for both emulated SVE instructions and
native AArch64 instructions. Previous releases emulated SVE instructions with
no coverage of native AArch64 instructions.
Bug Fixes
---------
- None. This is the first release based on DynamoRIO.
Other Changes
-------------
- None.
- EULA
-
-
Download Arm Instruction Emulator: 18.1 April 30, 2018
What's new in 18.1
Changes in Release 18.1
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- There are significant improvements in runtime performance principally due to
optimisations in SVE emulation functions (mostly floating-point emulation
including faster FCMLA) and memory copying.
Bug Fixes
---------
- Floating point corrections including:
- Handling of inactive vector elements.
- Floating point <-> integer conversions.
- FPSR updates by and for modifying instructions.
- Operand ordering for commutative operations.
- Handling of NaNs.
Other Changes
-------------
- None.-
Release Note
Release Note for Download Arm Instruction Emulator 18.1
×-------------------------------
| Arm Instruction Emulator 18.1 |
-------------------------------
This version of the Arm Instruction Emulator (ArmIE) allows users to emulate
SVE instructions on AArch64 hardware with added features for instrumenting
AArch64 and SVE instructions.
System Requirements
===================
ArmIE is supported on the following Linux platforms:
- AArch64 Redhat 7.2 and 7.3
- AArch64 SuSE 12
- AArch64 Ubuntu 16.04
Installation Instructions
=========================
To install the emulator, you should untar the release package:
$ tar -xvzf ARM-Instruction-Emulator_18.1_AArch64_<OS>_<OS_Version>_aarch64.tar.gz
Where:
ARM-Instruction-Emulator_18.1_AArch64_<OS>_<OS_Version>_aarch64.tar.gz
is the name of the <OS> <OS_Version> package.
$ cd ARM-Instruction-Emulator_18.1_AArch64_<OS>_<OS_Version>_aarch64
Install the emulator as root user:
$ sudo ./arm-instruction-emulator-18.1_Generic-AArch64_<OS>-<OS_Version_aarch64-linux-rpm.sh
You must read the EULA, presented to you as part of the install process, before
accepting or rejecting the agreement.
All files including EULA.txt are unpacked to /opt/arm/arm-instruction-emulator-18.1_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux
If, after installation, you decide not to agree to the terms of the EULA you
must not run the emulator and you should delete all the installed files as
described in 'Uninstalling' below.
Known Issues
============
Execution of multi-threaded applications may be unreliable in this release. For
example, programs built using OpenMPI and MPI may fail. Full multi-threading
support will be available in a later release.
There are DynamoRIO defects and issues logged at https://github.com/DynamoRIO/dynamorio/issues
which may result in instrumentation and emulation failures.
There is a known DynamoRIO issue which causes hangs on some AArch64 hardware:
https://github.com/DynamoRIO/dynamorio/issues/1698
ArmIE has a workaround for this using the --unsafe-ldstex option. This feature
is not enabled by default as it is not yet a reliable fix.
Code Advisor is not compatible with this version of the Arm Instruction Emulator.
Documentation
=============
Refer to the Arm Developer website for supporting information about Arm
Instruction Emulator:
https://developer.arm.com/products/software-development-tools/hpc/arm-instruction-emulator
Further help and tutorials for all of Arm’s HPC tools can be found online at:
https://developer.arm.com/products/software-development-tools/hpc/documentation
There is also a README.txt file in /opt/arm/arm-instruction-emulator-18.1_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux.
If you require support please contact support-hpc-sw@arm.com
Uninstalling
============
Delete all files and directories in the /opt/arm/arm-instruction-emulator-18.1_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux directory.
----------------
| RELEASE HISTORY |
----------------
Changes in Release 18.1
=======================
Removed Features
----------------
- None.
New Features and Enhancements
-----------------------------
- There are significant improvements in runtime performance principally due to
optimisations in SVE emulation functions (mostly floating-point emulation
including faster FCMLA) and memory copying.
Bug Fixes
---------
- Floating point corrections including:
- Handling of inactive vector elements.
- Floating point <-> integer conversions.
- FPSR updates by and for modifying instructions.
- Operand ordering for commutative operations.
- Handling of NaNs.
Other Changes
-------------
- None.
Changes in Release 18.0
=======================
This is the first release which integrates ArmIE with the Open Source DynamoRIO
dynamic binary instrumentation platform (http://www.dynamorio.org/home.html).
The previous release of Arm Instruction Emulator was 1.2.1. The version
numbering scheme has changed with this release in order to remain consistent
with other Arm AArch64 HPC software tools.
Removed Features
----------------
The functionality enabled by the following command line options is not available
in this release. They may be added in future releases.
-d, --debug Enabled assertion checks in the emulator.
-o, --output Redirected all messages generated by armie to a file.
-p, --profile-period Enabled the performance profiler.
-msve-memtrace Enabled memory tracing.
New Features
------------
- Arm Instruction Emulator 18.0 runs using DynamoRIO clients to provide SVE
emulation and limited instrumentation for both emulated SVE instructions and
native AArch64 instructions. Previous releases emulated SVE instructions with
no coverage of native AArch64 instructions.
Bug Fixes
---------
- None. This is the first release based on DynamoRIO.
Other Changes
-------------
- None.
- EULA
-
-
Download Arm Instruction Emulator: 18.0 March 28, 2018
What's new in 18.0
Changes in this Release
=======================
Removed features:
The functionality enabled by the following command line options is not available
in this release. They may be added in future releases.
-d, --debug Enabled assertion checks in the emulator.
-o, --output Redirected all messages generated by armie to a file.
-p, --profile-period Enabled the performance profiler.
-msve-memtrace Enabled memory tracing.
New features:
- Arm Instruction Emulator 18.0 runs using DynamoRIO clients to provide SVE
emulation and limited instrumentation for both emulated SVE instructions and
native AArch64 instructions. Previous releases emulated SVE instructions with
no coverage of native AArch64 instructions.
Bug fixes:
- None. This is the first release based on DynamoRIO.
Other changes:
- None.-
Release Note
Release Note for Download Arm Instruction Emulator 18.0
×Arm Instruction Emulator 18.0
=============================
This version of the Arm Instruction Emulator (ArmIE) allows users to emulate
SVE instructions on AArch64 hardware with added features for instrumenting
AArch64 and SVE instructions.
This is the first release which integrates ArmIE with the Open Source DynamoRIO
dynamic binary instrumentation platform (http://www.dynamorio.org/home.html).
The previous release of Arm Instruction Emulator was 1.2.1. The version
numbering scheme has changed with this release in order to remain consistent
with other Arm AArch64 HPC software tools.
Changes in this Release
=======================
Removed features:
The functionality enabled by the following command line options is not available
in this release. They may be added in future releases.
-d, --debug Enabled assertion checks in the emulator.
-o, --output Redirected all messages generated by armie to a file.
-p, --profile-period Enabled the performance profiler.
-msve-memtrace Enabled memory tracing.
New features:
- Arm Instruction Emulator 18.0 runs using DynamoRIO clients to provide SVE
emulation and limited instrumentation for both emulated SVE instructions and
native AArch64 instructions. Previous releases emulated SVE instructions with
no coverage of native AArch64 instructions.
Bug fixes:
- None. This is the first release based on DynamoRIO.
Other changes:
- None.
System Requirements
===================
This suite is supported on the following Linux platforms:
- AArch64 Redhat 7.2 and 7.3
- AArch64 SuSE 12
- AArch64 Ubuntu 16.04
Installation Instructions
=========================
To install the emulator, you should untar the release package:
$ tar -xvzf ARM-Instruction-Emulator_18.0_AArch64_<OS>_<OS_Version>_aarch64.tar.gz
Where:
ARM-Instruction-Emulator_18.0_AArch64_<OS>_<OS_Version>_aarch64.tar.gz
is the name of the <OS> <OS_Version> package.
$ cd ARM-Instruction-Emulator_18.0_AArch64_<OS>_<OS_Version>_aarch64
Install the emulator as root user:
$ sudo ./arm-instruction-emulator-18.0_Generic-AArch64_<OS>-<OS_Version_aarch64-linux-rpm.sh
You must read the EULA, presented to you as part of the install process, before
accepting or rejecting the agreement.
All files including EULA.txt are unpacked to /opt/arm/arm-instruction-emulator-18.0_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux
If, after installation, you decide not to agree to the terms of the EULA you
must not run the emulator and you should delete all the installed files as
described in 'Uninstalling' below.
Known Issues
============
Execution of multi-threaded applications may be unreliable in this release. For
example, programs built using OpenMPI and MPI may fail. Full multi-threading
support will be available in a later release.
There are DynamoRIO defects and issues logged at https://github.com/DynamoRIO/dynamorio/issues
which may result in instrumentation and emulation failures.
There is a known DynamoRIO issue which causes hangs on some AArch64 hardware:
https://github.com/DynamoRIO/dynamorio/issues/1698
ArmIE has a workaround for this using the --unsafe-ldstex option. This feature
is not enabled by default as it is not yet a reliable fix.
Code Advisor is not compatible with this version of the Arm Instruction Emulator.
Documentation
=============
Refer to the Arm Developer website for supporting information about Arm
Instruction Emulator:
https://developer.arm.com/products/software-development-tools/hpc/arm-instruction-emulator
Further help and tutorials for all of Arm’s HPC tools can be found online at:
https://developer.arm.com/products/software-development-tools/hpc/documentation
There is also a README.txt file in /opt/arm/arm-instruction-emulator-18.0_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux.
If you require support please contact support-hpc-sw@arm.com
Uninstalling
============
Delete all files and directories in the /opt/arm/arm-instruction-emulator-18.0_Generic-AArch64_<OS>-<OS_Version>_aarch64-linux directory.
- EULA
-