From 52f447058909735a9774b13ce568f72543d8942e Mon Sep 17 00:00:00 2001 From: Ethan Stewart Date: Thu, 19 May 2022 16:22:35 -0500 Subject: [PATCH] Update docs for 15.0-2. --- README.md | 6 +++--- bin/README.md | 12 ++++++------ bin/debian/changelog | 14 ++++++++++++-- bin/package.py | 4 ++-- docs/CENTOSINSTALL.md | 8 ++++---- docs/NOROOTINSTALL.md | 20 ++++++++++---------- docs/RELEASESOURCEINSTALL.md | 12 ++++++------ docs/RHELINSTALL.md | 6 +++--- docs/SLES15INSTALL.md | 4 ++-- docs/SOURCEINSTALL.md | 6 +++--- docs/UBUNTUINSTALL.md | 8 ++++---- 11 files changed, 55 insertions(+), 45 deletions(-) diff --git a/README.md b/README.md index 4bc7a95f3..8f1328f4d 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -AOMP - V 15.0-1 +AOMP - V 15.0-2 ============== This is README.md for https://github.com/ROCM-Developer-Tools/aomp. @@ -8,8 +8,8 @@ This is the base repository for AOMP. Use this github repository for documentation, and [examples](https://github.com/ROCm-Developer-Tools/aomp/tree/master/examples). -The last [release is AOMP 15.0-1](https://github.com/ROCm-Developer-Tools/aomp/releases). -Currently AOMP 15.0-2 is under development. +The last [release is AOMP 15.0-2](https://github.com/ROCm-Developer-Tools/aomp/releases). +Currently AOMP 15.0-3 is under development. Attention Users! Please use this repository for [issues](https://github.com/ROCm-Developer-Tools/aomp/issues). Do not put issues in any of the source code repositories. diff --git a/bin/README.md b/bin/README.md index 94e00811a..82b4355f5 100644 --- a/bin/README.md +++ b/bin/README.md @@ -62,7 +62,7 @@ These are some important environment variables and their default values. | AOMP_REPOS | $HOME/git/aomp15.0 | The base directory for all AOMP build repositories | AOMP_STANDALONE_BUILD | 1 | Build all components, do NOT use installed ROCm | AOMP_VERSION | 15.0 | Clang version. -| AOMP_VERSION_MOD | 2 | This implies the next release will be AOMP_15.0-2. +| AOMP_VERSION_MOD | 3 | This implies the next release will be AOMP_15.0-3. | AOMP_VERSION_STRING | $AOMP_VERSION-$AOMP_VERSION_MOD | | GFXLIST | gfx700 gfx701 gfx801 gfx803 | List of AMDGPU gpus to build for | | gfx900 gfx902 gfx906 gfx908 | @@ -249,17 +249,17 @@ The install location is defined by the $AOMP environment variable. The value of That is, the physical installation will be in directory name formed by concatonating the version string to the value of $AOMP. The "build_project.sh install" script will make a symbolic link from the physical directory to the symbolic directory $AOMP. The default value for AOMP is $HOME/rocm/aomp. -For example, when building AOMP version 15.0-1 the install scripts will put all files and directories -in $HOME/rocm/aomp_15.0-1 and create a symbolic link as follows: +For example, when building AOMP version 15.0-2 the install scripts will put all files and directories +in $HOME/rocm/aomp_15.0-2 and create a symbolic link as follows: ``` -ln -sf ${AOMP}_15.0-1 ${AOMP} +ln -sf ${AOMP}_15.0-2 ${AOMP} ``` All testing for AOMP uses the environment variable AOMP to locate the installation. This makes it easy to switch between versions of AOMP for testing by simply changing the environment variable AOMP. You do NOT need to change the symbolic link. -For example, if the aomp symbolic link currently points to aomp_15.0-1 and you want to test aomp_15.0-0, do this: +For example, if the aomp symbolic link currently points to aomp_15.0-2 and you want to test aomp_15.0-1, do this: ``` -export AOMP=$HOME/rocm/aomp_15.0-0 +export AOMP=$HOME/rocm/aomp_15.0-1 ``` The aomp package installs in /usr/lib/aomp_\ and symlinks /usr/lib/aomp to the versioned directory. To test the installed package, set AOMP to /usr/lib/aomp or /usr/lib/aomp_\. diff --git a/bin/debian/changelog b/bin/debian/changelog index b7369d146..e5f5fe60b 100644 --- a/bin/debian/changelog +++ b/bin/debian/changelog @@ -1,4 +1,4 @@ -aomp (15.0-1) UNRELEASED; urgency=medium +aomp (15.0-2) UNRELEASED; urgency=medium * Initial release of aomp is 0.3-2 * Please see example in /usr/lib/aomp/examples/vmuldemo @@ -732,5 +732,15 @@ aomp (15.0-1) UNRELEASED; urgency=medium * * 15.0-1 * Update to ROCm 5.1 sources. + * + * 15.0-2 + * Add user requested hint value AMD_unsafe_fp_atomics to match AMD_fast_fp_atomics + * Fixes to compile SPEC CPU with A + A options + * Add implementation of omp_is_initial_device to the new OpenMP runtime. + * Add Fortran specific functions to the new OpenMP runtime. Classic flang compiler does not use the + * same OpenMP API as Clang and does not use __kmpc_parallel_51. This function is responsible + * for thread parallelization. __kmpc_parallel_51 increases parallel level and it launches parallel code. + * Updated cloc.sh in aomp-extras to pass bitcode for abi version. + * Fixed timing accuracy for OMPT target data transfer and kernel dispatch trace records - -- Greg Rodgers Mon, 04 Apr 2022 23:34:44 -0500 + -- Greg Rodgers Thu, 19 May 2022 23:34:44 -0500 diff --git a/bin/package.py b/bin/package.py index 19fea6937..45d52d650 100644 --- a/bin/package.py +++ b/bin/package.py @@ -12,10 +12,10 @@ class Aomp(MakefilePackage): """ llvm openmp compiler from AMD""" homepage = "https://github.com/ROCm-Developer-Tools/aomp" - url = "https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_15.0-1/aomp-15.0-1.tar.gz" + url = "https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_15.0-2/aomp-15.0-2.tar.gz" # Fixme: this will be adjusted when spack create is called. When copying over to your own package.py omit this line. - version('15.0-1', sha256='7ea4e218b171585441278f3562d97779006b12bc3b5dc201901f2d757226da84') + version('15.0-2', sha256='7ea4e218b171585441278f3562d97779006b12bc3b5dc201901f2d757226da84') family = 'compiler' diff --git a/docs/CENTOSINSTALL.md b/docs/CENTOSINSTALL.md index 65ca0dbeb..10ba8d16e 100644 --- a/docs/CENTOSINSTALL.md +++ b/docs/CENTOSINSTALL.md @@ -5,13 +5,13 @@ AOMP will install to /usr/lib/aomp. The AOMP environment variable will automatic ### Download and Install (CentOS 8) ``` -wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_15.0-1/aomp_CENTOS_8-15.0-1.x86_64.rpm -sudo rpm -i aomp_CENTOS_8-15.0-1.x86_64.rpm +wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_15.0-2/aomp_CENTOS_8-15.0-2.x86_64.rpm +sudo rpm -i aomp_CENTOS_8-15.0-2.x86_64.rpm ``` ### Download and Install (CentOS 7) ``` -wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_15.0-1/aomp_CENTOS_7-15.0-1.x86_64.rpm -sudo rpm -i aomp_CENTOS_7-15.0-1.x86_64.rpm +wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_15.0-2/aomp_CENTOS_7-15.0-2.x86_64.rpm +sudo rpm -i aomp_CENTOS_7-15.0-2.x86_64.rpm ``` Confirm AOMP environment variable is set: ``` diff --git a/docs/NOROOTINSTALL.md b/docs/NOROOTINSTALL.md index da1dfe2fc..5d0464dce 100644 --- a/docs/NOROOTINSTALL.md +++ b/docs/NOROOTINSTALL.md @@ -8,13 +8,13 @@ To install the debian package without root access into your home directory, you On Ubuntu 20.04: ``` - wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_15.0-1/aomp_Ubuntu2004_15.0-1_amd64.deb - dpkg -x aomp_Ubuntu2004_15.0-1_amd64.deb /tmp/temproot + wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_15.0-2/aomp_Ubuntu2004_15.0-2_amd64.deb + dpkg -x aomp_Ubuntu2004_15.0-2_amd64.deb /tmp/temproot ``` On Ubuntu 18.04 LTS (bionic beaver): ``` - wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_15.0-1/aomp_Ubuntu1804_15.0-1_amd64.deb - dpkg -x aomp_Ubuntu1804_15.0-1_amd64.deb /tmp/temproot + wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_15.0-2/aomp_Ubuntu1804_15.0-2_amd64.deb + dpkg -x aomp_Ubuntu1804_15.0-2_amd64.deb /tmp/temproot ``` Move to $HOME and set variables: ``` @@ -31,18 +31,18 @@ To install the rpm package without root access into your home directory, you can ``` For SLES15-SP1: ``` - wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_15.0-1/aomp_SLES15_SP1-15.0-1.x86_64.rpm - rpm2cpio aomp_SLES15_SP1-15.0-1.x86_64.rpm | cpio -idmv + wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_15.0-2/aomp_SLES15_SP1-15.0-2.x86_64.rpm + rpm2cpio aomp_SLES15_SP1-15.0-2.x86_64.rpm | cpio -idmv ``` For CentOS/RHEL 7: ``` - wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_15.0-1/aomp_CENTOS_7-15.0-1.x86_64.rpm - rpm2cpio aomp_CENTOS_7-15.0-1.x86_64.rpm | cpio -idmv + wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_15.0-2/aomp_CENTOS_7-15.0-2.x86_64.rpm + rpm2cpio aomp_CENTOS_7-15.0-2.x86_64.rpm | cpio -idmv ``` For CentOS 8: ``` - wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_15.0-1/aomp_CENTOS_8-15.0-1.x86_64.rpm - rpm2cpio aomp_CENTOS_8-15.0-1.x86_64.rpm | cpio -idmv + wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_15.0-2/aomp_CENTOS_8-15.0-2.x86_64.rpm + rpm2cpio aomp_CENTOS_8-15.0-2.x86_64.rpm | cpio -idmv ``` Move to $HOME and set variables: ``` diff --git a/docs/RELEASESOURCEINSTALL.md b/docs/RELEASESOURCEINSTALL.md index a62c05970..316d2e964 100644 --- a/docs/RELEASESOURCEINSTALL.md +++ b/docs/RELEASESOURCEINSTALL.md @@ -14,8 +14,8 @@ To build AOMP from source you must: 1. Install certain distribution packages, 2. To build and install aomp from the release source tarball run these commands: ``` - wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_15.0-1/aomp-15.0-1.tar.gz - tar -xzf aomp-15.0-1.tar.gz + wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_15.0-2/aomp-15.0-2.tar.gz + tar -xzf aomp-15.0-2.tar.gz cd aomp15.0 nohup make & ``` @@ -30,17 +30,17 @@ If you set the environment variable AOMP, the Makefile will install to that dire Otherwise, the Makefile will install into /usr/local. So you must have authorization to write into /usr/local if you do not set the environment variable AOMP. Let's assume you set the environment variable AOMP to "$HOME/rocm/aomp" in .bash_profile. -The build_aomp.sh script will install into $HOME/rocm/aomp_15.0-1 and create a symbolic link from $HOME/rocm/aomp to $HOME/rocm/aomp_15.0-1. +The build_aomp.sh script will install into $HOME/rocm/aomp_15.0-2 and create a symbolic link from $HOME/rocm/aomp to $HOME/rocm/aomp_15.0-2. This feature allows multiple versions of AOMP to be installed concurrently. -To enable a backlevel version of AOMP, simply set AOMP to $HOME/rocm/aomp_15.0-0. +To enable a backlevel version of AOMP, simply set AOMP to $HOME/rocm/aomp_15.0-1. ## Build AOMP with spack Assuming your have installed the [prerequisites](SOURCEINSTALL_PREREQUISITE.md), use these commands to fetch the source and build aomp. Currently the aomp configuration is not yet in the spack git hub so you must create the spack package first. ``` - wget https://github.com/ROCm-Developer-Tools/aomp/blob/aomp-15.0-1/bin/package.py - spack create -n aomp -t makefile --force https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_15.0-1/aomp-15.0-1.tar.gz + wget https://github.com/ROCm-Developer-Tools/aomp/blob/aomp-15.0-2/bin/package.py + spack create -n aomp -t makefile --force https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_15.0-2/aomp-15.0-2.tar.gz spack edit aomp spack install aomp ``` diff --git a/docs/RHELINSTALL.md b/docs/RHELINSTALL.md index 29f23e409..1c0240069 100644 --- a/docs/RHELINSTALL.md +++ b/docs/RHELINSTALL.md @@ -8,12 +8,12 @@ sudo yum install perl-Digest-MD5 perl-URI-Encode ``` ### Download and Install ``` -wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_15.0-1/aomp_CENTOS_7-15.0-1.x86_64.rpm -sudo rpm -i aomp_CENTOS_7-15.0-1.x86_64.rpm +wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_15.0-2/aomp_CENTOS_7-15.0-2.x86_64.rpm +sudo rpm -i aomp_CENTOS_7-15.0-2.x86_64.rpm ``` If CUDA is not installed the installation may cancel, to bypass this: ``` -sudo rpm -i --nodeps aomp_CENTOS_7-15.0-1.x86_64.rpm +sudo rpm -i --nodeps aomp_CENTOS_7-15.0-2.x86_64.rpm ``` Confirm AOMP environment variable is set: ``` diff --git a/docs/SLES15INSTALL.md b/docs/SLES15INSTALL.md index 535d1004e..82f94259e 100644 --- a/docs/SLES15INSTALL.md +++ b/docs/SLES15INSTALL.md @@ -1,8 +1,8 @@ # AOMP SUSE SLES-15-SP1 Install AOMP will install to /usr/lib/aomp. The AOMP environment variable will automatically be set to the install location. This may require a new terminal to be launched to see the change. ``` -wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_15.0-1/aomp_SLES15_SP1-15.0-1.x86_64.rpm -sudo rpm -i aomp_SLES15_SP1-15.0-1.x86_64.rpm +wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_15.0-2/aomp_SLES15_SP1-15.0-2.x86_64.rpm +sudo rpm -i aomp_SLES15_SP1-15.0-2.x86_64.rpm ``` Confirm AOMP environment variable is set: ``` diff --git a/docs/SOURCEINSTALL.md b/docs/SOURCEINSTALL.md index c5eb75aad..7cf3679a3 100644 --- a/docs/SOURCEINSTALL.md +++ b/docs/SOURCEINSTALL.md @@ -1,4 +1,4 @@ -# Source Install V 15.0-1 +# Source Install V 15.0-2 Build and install from sources is possible. However, the source build for AOMP is complex for several reasons. - Many repos are required. @@ -40,14 +40,14 @@ Here are the commands to do a source build of AOMP: ``` The development version is the next version to be released. It is possible that the development version is broken due to regressions that often occur during development. -These commands will build a previous release of AOMP such as aomp-15.0-1.
+These commands will build a previous release of AOMP such as aomp-15.0-2.
Release Branch: ``` export AOMP_VERSION=15.0 export AOMP_REPOS=$HOME/git/aomp${AOMP_VERSION} mkdir -p $AOMP_REPOS cd $AOMP_REPOS - git clone -b aomp-15.0-1 https://github.com/ROCm-Developer-Tools/aomp + git clone -b aomp-15.0-2 https://github.com/ROCm-Developer-Tools/aomp ``` Clone and build: ``` diff --git a/docs/UBUNTUINSTALL.md b/docs/UBUNTUINSTALL.md index f73272488..0d95a7657 100644 --- a/docs/UBUNTUINSTALL.md +++ b/docs/UBUNTUINSTALL.md @@ -3,14 +3,14 @@ AOMP will install to /usr/lib/aomp. The AOMP environment variable will automatic On Ubuntu 20.04, run these commands: ``` -wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_15.0-1/aomp_Ubuntu2004_15.0-1_amd64.deb -sudo dpkg -i aomp_Ubuntu2004_15.0-1_amd64.deb +wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_15.0-2/aomp_Ubuntu2004_15.0-2_amd64.deb +sudo dpkg -i aomp_Ubuntu2004_15.0-2_amd64.deb ``` On Ubuntu 18.04 LTS (bionic beaver), run these commands: ``` -wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_15.0-1/aomp_Ubuntu1804_15.0-1_amd64.deb -sudo dpkg -i aomp_Ubuntu1804_15.0-1_amd64.deb +wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_15.0-2/aomp_Ubuntu1804_15.0-2_amd64.deb +sudo dpkg -i aomp_Ubuntu1804_15.0-2_amd64.deb ``` The AOMP bin directory (which includes the standard clang and llvm binaries) is not intended to be in your PATH for typical operation.