From 71f5cd2505750c34f454fda94068b2fc545c8c9f Mon Sep 17 00:00:00 2001 From: Ethan Stewart Date: Wed, 28 Jul 2021 19:38:44 -0500 Subject: [PATCH] Update docs/changelog for 13.0-5. --- README.md | 6 +++--- bin/README.md | 14 +++++++------- bin/debian/changelog | 27 +++++++++++++++++++++++++-- bin/package.py | 4 ++-- docs/CENTOSINSTALL.md | 4 ++-- docs/INSTALL.md | 1 + docs/NOROOTINSTALL.md | 20 ++++++++++---------- docs/RELEASESOURCEINSTALL.md | 12 ++++++------ docs/RHELINSTALL.md | 6 +++--- docs/SLES15INSTALL.md | 4 ++-- docs/SOURCEINSTALL.md | 6 +++--- docs/SOURCEINSTALL_PREREQUISITE.md | 6 +++--- docs/UBUNTUINSTALL.md | 8 ++++---- 13 files changed, 71 insertions(+), 47 deletions(-) diff --git a/README.md b/README.md index 060d7243b..45de9bb1a 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -AOMP - V 13.0-4 +AOMP - V 13.0-5 ============== 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 13.0-4](https://github.com/ROCm-Developer-Tools/aomp/releases). -Currently AOMP 13.0-5 is under development. +The last [release is AOMP 13.0-5](https://github.com/ROCm-Developer-Tools/aomp/releases). +Currently AOMP 13.0-6 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 fd0ee8ea4..7c68693ae 100644 --- a/bin/README.md +++ b/bin/README.md @@ -38,7 +38,7 @@ each component build script with the name build_\.sh . | rocminfo |Latest ROCm| $HOME/git/aomp13/rocminfo | [rocminfo](https://github.com/radeonopencompute/rocminfo) | rocdbgapi |Latest ROCm| $HOME/git/aomp13/ROCdbgapi | [rocdbgapi](https://github.com/ROCm-Developer-Tools/ROCdbgapi) | rocgdb |Latest ROCm| $HOME/git/aomp13/ROCgdb | [rocgdb](https://github.com/ROCm-Developer-Tools/ROCgdb) -| roctrace |Latest ROCm| $HOME/git/aomp13/roctracer | [roctracer](https://github.com/ROCm-Developer-Tools/roctracer) +| roctracer |Latest ROCm| $HOME/git/aomp13/roctracer | [roctracer](https://github.com/ROCm-Developer-Tools/roctracer) | rocprofiler|Latest ROCm| $HOME/git/aomp13/rocprofiler | [rocprofiler](https://github.com/ROCm-Developer-Tools/rocprofiler) If the component is a core aomp component, then the development branch name is aomp-dev. @@ -76,7 +76,7 @@ AOMP=/tmp/$USER/rocm/aomp AOMP_REPOS=/tmp/$USER/git/aomp13 NVPTXGPUS=30,35,70 GFXLIST="gfx803 gfx906" -AOMP_VERSION="12.0" +AOMP_VERSION="13.0" export AOMP BUILD_TYPE NVPTXGPUS GFXLIST ``` ## Quick Start to AOMP Development @@ -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 13.0-4 the install scripts will put all files and directories -in $HOME/rocm/aomp_13.0-4 and create a symbolic link as follows: +For example, when building AOMP version 13.0-5 the install scripts will put all files and directories +in $HOME/rocm/aomp_13.0-5 and create a symbolic link as follows: ``` -ln -sf ${AOMP}_13.0-4 ${AOMP} +ln -sf ${AOMP}_13.0-5 ${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_13.0-4 and you want to test aomp_13.0-3, do this: +For example, if the aomp symbolic link currently points to aomp_13.0-5 and you want to test aomp_13.0-4, do this: ``` -export AOMP=$HOME/rocm/aomp_13.0-3 +export AOMP=$HOME/rocm/aomp_13.0-4 ``` 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 b4947b5fc..042b1ba3c 100644 --- a/bin/debian/changelog +++ b/bin/debian/changelog @@ -1,4 +1,4 @@ -aomp (13.0-4) UNRELEASED; urgency=medium +aomp (13.0-5) UNRELEASED; urgency=medium * Initial release of aomp is 0.3-2 * Please see example in /usr/lib/aomp/examples/vmuldemo @@ -622,4 +622,27 @@ aomp (13.0-4) UNRELEASED; urgency=medium * * Known Regressions: * 9 Clang lit test failures - -- Greg Rodgers Thu, 17 Jun 2021 14:01:06 -0500 + * + * 13.0-5 + * This release includes a demo of a new LLVM library called libLLVMOffloadArch.cpp. + * The clang tool offload-arch is now build with this library. The libomptarget runtime + * no longer calls the binary "offload-arch -c" and traps its stdout. Instead a library + * call is made to libLLVMOffloadArch.cpp to determine current capabilities. The tool + * offload-arch is still create with the llvm build but its sources are in + * llvm-project/llvm/lib/OffloadArch/offload-arch. Updates were made so offload-arch + * returns the first VISIBLE gpu which could be the result of setting ROCM_VISIBLE_DEVICES + * for amdgpus. + * This release starts to deprecate the use of mygpu in favor of offload-arch. A new version + * of mygpu calls offload-arch. The tables used to drive mygpu have been deleted. All pci-id + * tables for offloading identification are now in llvm library OffloadArch. + * Added a new command line option -offload-usm which turns on OpenMP pragma requires + * unified_shared_memory and sets toolchain flags appropriately. This saves having to + * change every source file to turn on unified shared memory. + * Build changes: + * Update list of gfx names to include gfx1030 and gfx1031 + * Known Issues: + * 9 Clang lit test failures + * Long build times when large numbers of archive libraries are needed because toolchain must + * unbundle the archive for device linking. + + -- Greg Rodgers Wed, 28 Jul 2021 11:27:13 -0500 diff --git a/bin/package.py b/bin/package.py index 2cf1f8240..2ac726035 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_13.0-2/aomp-13.0-2.tar.gz" + url = "https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-5/aomp-13.0-5.tar.gz" # Fixme: this will be adjusted when spack create is called. When copying over to your own package.py omit this line. - version('13.0-2', sha256='7ea4e218b171585441278f3562d97779006b12bc3b5dc201901f2d757226da84') + version('13.0-5', sha256='7ea4e218b171585441278f3562d97779006b12bc3b5dc201901f2d757226da84') family = 'compiler' diff --git a/docs/CENTOSINSTALL.md b/docs/CENTOSINSTALL.md index 9e4a7b83a..eaed709a0 100644 --- a/docs/CENTOSINSTALL.md +++ b/docs/CENTOSINSTALL.md @@ -5,8 +5,8 @@ AOMP will install to /usr/lib/aomp. The AOMP environment variable will automatic ### Download and Install ``` -wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-4/aomp_CENTOS_8-13.0-4.x86_64.rpm -sudo rpm -i aomp_CENTOS_8-13.0-4.x86_64.rpm +wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-5/aomp_CENTOS_8-13.0-5.x86_64.rpm +sudo rpm -i aomp_CENTOS_8-13.0-5.x86_64.rpm ``` Confirm AOMP environment variable is set: ``` diff --git a/docs/INSTALL.md b/docs/INSTALL.md index 1a6d5eb52..d5fb786ed 100644 --- a/docs/INSTALL.md +++ b/docs/INSTALL.md @@ -3,6 +3,7 @@ Platform Install Options: - [Ubuntu or Debian](UBUNTUINSTALL.md) - [SUSE SLES-15-SP1](SLES15INSTALL.md) - [RHEL 7](RHELINSTALL.md) +- [CENTOS 8](CENTOSINSTALL.md) - [Install Without Root](NOROOTINSTALL.md) - Build AOMP from source: * [Prerequisites to install from source](SOURCEINSTALL_PREREQUISITE.md) diff --git a/docs/NOROOTINSTALL.md b/docs/NOROOTINSTALL.md index 610188b7b..8c96b91fd 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_13.0-4/aomp_Ubuntu2004_13.0-4_amd64.deb - dpkg -x aomp_Ubuntu2004_13.0-4_amd64.deb /tmp/temproot + wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-5/aomp_Ubuntu2004_13.0-5_amd64.deb + dpkg -x aomp_Ubuntu2004_13.0-5_amd64.deb /tmp/temproot ``` On Ubuntu 18.04 LTS (bionic beaver): ``` - wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-4/aomp_Ubuntu1804_13.0-4_amd64.deb - dpkg -x aomp_Ubuntu1804_13.0-4_amd64.deb /tmp/temproot + wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-5/aomp_Ubuntu1804_13.0-5_amd64.deb + dpkg -x aomp_Ubuntu1804_13.0-5_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 Red Hat: ``` - wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-4/aomp_REDHAT_7-13.0-4.x86_64.rpm - rpm2cpio aomp_REDHAT_7-13.0-4.x86_64.rpm | cpio -idmv + wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-5/aomp_REDHAT_7-13.0-5.x86_64.rpm + rpm2cpio aomp_REDHAT_7-13.0-5.x86_64.rpm | cpio -idmv ``` For SLES15-SP1: ``` - wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-4/aomp_SLES15_SP1-13.0-4.x86_64.rpm - rpm2cpio aomp_SLES15_SP1-13.0-4.x86_64.rpm | cpio -idmv + wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-5/aomp_SLES15_SP1-13.0-5.x86_64.rpm + rpm2cpio aomp_SLES15_SP1-13.0-5.x86_64.rpm | cpio -idmv ``` For CentOS: ``` - wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-4/aomp_CENTOS_8-13.0-4.x86_64.rpm - rpm2cpio aomp_CENTOS_8-13.0-4.x86_64.rpm | cpio -idmv + wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-5/aomp_CENTOS_8-13.0-5.x86_64.rpm + rpm2cpio aomp_CENTOS_8-13.0-5.x86_64.rpm | cpio -idmv ``` Move to $HOME and set variables: ``` diff --git a/docs/RELEASESOURCEINSTALL.md b/docs/RELEASESOURCEINSTALL.md index 091d00cb8..4aa436edb 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_13.0-4/aomp-13.0-4.tar.gz - tar -xzf aomp-13.0-4.tar.gz + wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-5/aomp-13.0-5.tar.gz + tar -xzf aomp-13.0-5.tar.gz cd aomp13 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_13.0-4 and create a symbolic link from $HOME/rocm/aomp to $HOME/rocm/aomp_13.0-4. +The build_aomp.sh script will install into $HOME/rocm/aomp_13.0-5 and create a symbolic link from $HOME/rocm/aomp to $HOME/rocm/aomp_13.0-5. 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_13.0-3. +To enable a backlevel version of AOMP, simply set AOMP to $HOME/rocm/aomp_13.0-4. ## 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-13.0-4/bin/package.py - spack create -n aomp -t makefile --force https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-4/aomp-13.0-4.tar.gz + wget https://github.com/ROCm-Developer-Tools/aomp/blob/aomp-13.0-5/bin/package.py + spack create -n aomp -t makefile --force https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-5/aomp-13.0-5.tar.gz spack edit aomp spack install aomp ``` diff --git a/docs/RHELINSTALL.md b/docs/RHELINSTALL.md index fe16aab08..ab790422f 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_13.0-4/aomp_REDHAT_7-13.0-4.x86_64.rpm -sudo rpm -i aomp_REDHAT_7-13.0-4.x86_64.rpm +wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-5/aomp_REDHAT_7-13.0-5.x86_64.rpm +sudo rpm -i aomp_REDHAT_7-13.0-5.x86_64.rpm ``` If CUDA is not installed the installation may cancel, to bypass this: ``` -sudo rpm -i --nodeps aomp_REDHAT_7-13.0-4.x86_64.rpm +sudo rpm -i --nodeps aomp_REDHAT_7-13.0-5.x86_64.rpm ``` Confirm AOMP environment variable is set: ``` diff --git a/docs/SLES15INSTALL.md b/docs/SLES15INSTALL.md index ccd4a7988..c67ed1da3 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_13.0-4/aomp_SLES15_SP1-13.0-4.x86_64.rpm -sudo rpm -i aomp_SLES15_SP1-13.0-4.x86_64.rpm +wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-5/aomp_SLES15_SP1-13.0-5.x86_64.rpm +sudo rpm -i aomp_SLES15_SP1-13.0-5.x86_64.rpm ``` Confirm AOMP environment variable is set: ``` diff --git a/docs/SOURCEINSTALL.md b/docs/SOURCEINSTALL.md index 08a0ffb2f..ee205902e 100644 --- a/docs/SOURCEINSTALL.md +++ b/docs/SOURCEINSTALL.md @@ -1,4 +1,4 @@ -# Source Install V 13.0-4 (DEV) +# Source Install V 13.0-5 Build and install from sources is possible. However, the source build for AOMP is complex for several reasons. - Many repos are required. The clone_aomp.sh script ensures you have all repos and the correct branch. @@ -19,7 +19,7 @@ To build AOMP from source you must: 1. Install certain distribution packages, 2. ``` Choose a Build Version (Development or Release) -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. If instead, you want to build from the sources of a previous release such as 13.0-2 that is possible as well. +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. If instead, you want to build from the sources of a previous release such as 13.0-4 that is possible as well. For the Development Branch: ``` @@ -29,7 +29,7 @@ The development version is the next version to be released. It is possible that For the Release Branch: ``` - git checkout aomp-13.0-4 + git checkout aomp-13.0-5 git pull export AOMP_CHECK_GIT_BRANCH=0 //Tags will be used to checkout various repos. This will ignore the detached head state to avoid build errors. ``` diff --git a/docs/SOURCEINSTALL_PREREQUISITE.md b/docs/SOURCEINSTALL_PREREQUISITE.md index 52a67cb49..c508e0672 100644 --- a/docs/SOURCEINSTALL_PREREQUISITE.md +++ b/docs/SOURCEINSTALL_PREREQUISITE.md @@ -5,7 +5,7 @@ #### Debian or Ubuntu Packages ``` - sudo apt-get install g++-5 g++-7 pkg-config libpci-dev libnuma-dev libelf-dev libffi-dev git python libopenmpi-dev gawk mesa-common-dev + sudo apt-get install g++-5 g++-7 pkg-config libpci-dev libnuma-dev libffi-dev git python libopenmpi-dev gawk mesa-common-dev # Additional packages used by rocgdb sudo apt-get install python3 texinfo libbison-dev bison flex libbabeltrace-dev python3-pip libncurses5-dev liblzma-dev python3-setuptools python3-dev @@ -15,7 +15,7 @@ #### SLES-15-SP1 Packages ``` - sudo zypper install -y git pciutils-devel python-base libffi-devel gcc gcc-c++ libnuma-devel libelf-devel patchutils openmpi2-devel mesa-libGL-devel libquadmath0 + sudo zypper install -y git pciutils-devel python-base libffi-devel gcc gcc-c++ libnuma-devel patchutils openmpi2-devel mesa-libGL-devel libquadmath0 A symbolic link may be required at /usr/lib64: /usr/lib64/libquadmath.so -> /usr/lib64/libquadmath.so.0. @@ -53,7 +53,7 @@ RHEL 7.7 and later RHEL 7 versions sudo yum install dnf-plugins-core sudo yum config-manager --set-enabled powertools - sudo yum install gcc gcc-c++ git make pciutils-devel numactl-devel libffi-devel mesa-libGL-devel elfutils-libelf-devel libquadmath-devel python3 python3-pip python36-devel python3-setuptools python2 + sudo yum install gcc gcc-c++ git make pciutils-devel numactl-devel libffi-devel mesa-libGL-devel libquadmath-devel python3 python3-pip python36-devel python3-setuptools python2 # Additional packages used by rocgdb sudo yum install texinfo bison flex ncurses-devel expat-devel xz-devel libbabeltrace-devel diff --git a/docs/UBUNTUINSTALL.md b/docs/UBUNTUINSTALL.md index a2c1c07b7..4260b91d7 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_13.0-4/aomp_Ubuntu2004_13.0-4_amd64.deb -sudo dpkg -i aomp_Ubuntu2004_13.0-4_amd64.deb +wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-5/aomp_Ubuntu2004_13.0-5_amd64.deb +sudo dpkg -i aomp_Ubuntu2004_13.0-5_amd64.deb ``` On Ubuntu 18.04 LTS (bionic beaver), run these commands: ``` -wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-4/aomp_Ubuntu1804_13.0-4_amd64.deb -sudo dpkg -i aomp_Ubuntu1804_13.0-4_amd64.deb +wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_13.0-5/aomp_Ubuntu1804_13.0-5_amd64.deb +sudo dpkg -i aomp_Ubuntu1804_13.0-5_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.