Update docs for 11.6-2 release.

ROCm · Jun 30, 2020 · 6691732 · 6691732
1 parent 95a02ba
commit 6691732
Show file tree

Hide file tree

Showing 8 changed files with 35 additions and 32 deletions.
diff --git a/README.md b/README.md
@@ -1,4 +1,4 @@
-AOMP - V 11.6-1
+AOMP - V 11.6-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 11.6-1](https://github.com/ROCm-Developer-Tools/aomp/releases).
-Currently AOMP 11.6-2 is under development.
+The last [release is AOMP 11.6-2](https://github.com/ROCm-Developer-Tools/aomp/releases).
+Currently AOMP 11.7-0 is under development.
 
 
 Attention Users!  Please use this repository for [issues](https://github.com/ROCm-Developer-Tools/aomp/issues).
@@ -96,6 +96,5 @@ Software License Agreement.
 See the [release notes](https://github.com/ROCm-Developer-Tools/aomp/releases) in github.  Here are some limitations.
 
 ```
- - Dwarf debugging is turned off for GPUs. -g will turn on host level debugging only.
  - Some simd constructs fail to vectorize on both host and GPUs.  
 ```
diff --git a/bin/README.md b/bin/README.md
@@ -26,6 +26,7 @@ build_openmp.sh          -  Builds the OpenMP libraries and device RTL.
 build_pgmath.sh          -  Builds the pgmath support for flang.
 build_flang.sh           -  Builds flang for aomp.
 build_flang_runtime.sh   -  Builds the flang runtime for aomp.
+build_ocl.sh             -  Builds OpenCL.
 ```
 
 These scripts install into $HOME/rocm/aomp (or $AOMP if set).
@@ -146,6 +147,9 @@ Developers may update a component and then run these scripts in the following or
 
    ./build_flang_runtime.sh
    ./build_flang_runtime.sh install
+   
+   ./build_ocl.sh
+   ./build_ocl.sh install
 ```
 Once you have a successful development build, individual components can be incrementally rebuilt without rebuilding the entire system or the entire component. For example, if you change a file in the llvm-project repository. Run this command to incrementally build llvm, clang, and lld and update your installation.
 ```
@@ -159,10 +163,10 @@ WARNING: When the build scripts are run with NO arguments (that is, you do not s
 The install location is defined by the $AOMP environment variable. The value of AOMP needs to be reserved as a symbolic link.
 That is, the physical installation will be in directory $AOMP concatonated with the version string.
 The install script will make a symbolic link from the physical directory to the symbolic directory $AOMP.
-For example, when building AOMP version 11.6-1 with the default value for AOMP=$HOME/rocm/aomp,
-the install scripts will put all files and directories in $HOME/rocm/aomp_11.6-1 and create a symbolic link as follows.
+For example, when building AOMP version 11.6-2 with the default value for AOMP=$HOME/rocm/aomp,
+the install scripts will put all files and directories in $HOME/rocm/aomp_11.6-2 and create a symbolic link as follows.
 
 ```
-ln -sf ${AOMP}_11.6-1 ${AOMP}
+ln -sf ${AOMP}_11.6-2 ${AOMP}
 ```
 This symbolic link makes it easy to switch between versions of AOMP for testing.
diff --git a/docs/NOROOTINSTALL.md b/docs/NOROOTINSTALL.md
@@ -7,13 +7,13 @@ Once installed go to [TESTINSTALL](TESTINSTALL.md) for instructions on getting s
 To install the debian package without root access into your home directory, you can run these commands.<br>
 On Ubuntu 18.04 LTS (bionic beaver):
 ```
-   wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-1/aomp_Ubuntu1804_11.6-1_amd64.deb
-   dpkg -x aomp_Ubuntu1804_11.6-1_amd64.deb /tmp/temproot
+   wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-2/aomp_Ubuntu1804_11.6-2_amd64.deb
+   dpkg -x aomp_Ubuntu1804_11.6-2_amd64.deb /tmp/temproot
 ```
 On Ubuntu 16.04:
 ```
-   wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-1/aomp_Ubuntu1604_11.6-1_amd64.deb
-   dpkg -x aomp_Ubuntu1604_11.6-1_amd64.deb /tmp/temproot
+   wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-2/aomp_Ubuntu1604_11.6-2_amd64.deb
+   dpkg -x aomp_Ubuntu1604_11.6-2_amd64.deb /tmp/temproot
 ```
 Move to $HOME and set variables:
 ```
@@ -30,13 +30,13 @@ 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_11.6-1/aomp_REDHAT_7-11.6-1.x86_64.rpm
-   rpm2cpio aomp_REDHAT_7-11.6-1.x86_64.rpm | cpio -idmv
+   wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-2/aomp_REDHAT_7-11.6-2.x86_64.rpm
+   rpm2cpio aomp_REDHAT_7-11.6-2.x86_64.rpm | cpio -idmv
 ```
 For SLES15-SP1:
 ```
-   wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-1/aomp_SLES15_SP1-11.6-1.x86_64.rpm
-   rpm2cpio aomp_SLES15_SP1-11.6-1.x86_64.rpm | cpio -idmv
+   wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-2/aomp_SLES15_SP1-11.6-2.x86_64.rpm
+   rpm2cpio aomp_SLES15_SP1-11.6-2.x86_64.rpm | cpio -idmv
 ```
 Move to $HOME and set variables:
 ```

diff --git a/docs/RELEASESOURCEINSTALL.md b/docs/RELEASESOURCEINSTALL.md
@@ -101,8 +101,8 @@ Remember,the aomp spack configuration file is currently missing dependencies, so
 To build and install aomp from the release source tarball run these commands:
 
 ```
-   wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-1/aomp-11.6-1.tar.gz
-   tar -xzf aomp-11.6-1.tar.gz
+   wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-2/aomp-11.6-2.tar.gz
+   tar -xzf aomp-11.6-2.tar.gz
    cd aomp
    nohup make &
 ```
@@ -117,9 +117,9 @@ 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_11.6-1 and create a symbolic link from $HOME/rocm/aomp to $HOME/rocm/aomp_11.6-1.
+The build_aomp.sh script will install into $HOME/rocm/aomp_11.6-2 and create a symbolic link from $HOME/rocm/aomp to $HOME/rocm/aomp_11.6-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_11.5-0.
+To enable a backlevel version of AOMP, simply set AOMP to $HOME/rocm/aomp_11.6-1.
 
 ## Build AOMP with spack
 
@@ -128,7 +128,7 @@ Currently the aomp configuration is not yet in the spack git hub so you must cre
 
 ```
    wget https://github.com/ROCm-Developer-Tools/aomp/blob/master/bin/package.py
-   spack create -n aomp -t makefile --force https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-1/aomp-11.6-1.tar.gz
+   spack create -n aomp -t makefile --force https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-2/aomp-11.6-2.tar.gz
    spack edit aomp
    spack install aomp
 ```

diff --git a/docs/RHELINSTALL.md b/docs/RHELINSTALL.md
@@ -8,12 +8,12 @@ sudo yum install perl-Digest-MD5
 ```
 ### Download and Install
 ```
-wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-1/aomp_REDHAT_7-11.6-1.x86_64.rpm
-sudo rpm -i aomp_REDHAT_7-11.6-1.x86_64.rpm
+wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-2/aomp_REDHAT_7-11.6-2.x86_64.rpm
+sudo rpm -i aomp_REDHAT_7-11.6-2.x86_64.rpm
 ```
 If CUDA is not installed the installation may cancel, to bypass this:
 ```
-sudo rpm -i --nodeps aomp_REDHAT_7-11.6-1.x86_64.rpm
+sudo rpm -i --nodeps aomp_REDHAT_7-11.6-2.x86_64.rpm
 ```
 Confirm AOMP environment variable is set:
 ```

diff --git 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_11.6-1/aomp_SLES15_SP1-11.6-1.x86_64.rpm
-sudo rpm -i aomp_SLES15_SP1-11.6-1.x86_64.rpm
+wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-2/aomp_SLES15_SP1-11.6-2.x86_64.rpm
+sudo rpm -i aomp_SLES15_SP1-11.6-2.x86_64.rpm
 ```
 Confirm AOMP environment variable is set:
 ```

diff --git a/docs/SOURCEINSTALL.md b/docs/SOURCEINSTALL.md
@@ -1,4 +1,4 @@
-# Source Install V 11.6-2 (DEV)
+# Source Install V 11.7-0 (DEV)
 
 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.
@@ -99,7 +99,7 @@ Create a /etc/yum.repos.d/rocm.repo file with the following contents:
 ```
 
 <b>Choose a Build Version (Development or Release)</b>
-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 11.6-1 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 11.6-2 that is possible as well.
 
 <b>For the Development Branch:</b>
 ```
@@ -109,7 +109,7 @@ The development version is the next version to be released.  It is possible that
 
 <b>For the Release Branch:</b>
 ```
-   git checkout rel_11.6-1
+   git checkout rel_11.6-2
    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/UBUNTUINSTALL.md b/docs/UBUNTUINSTALL.md
@@ -3,13 +3,13 @@ AOMP will install to /usr/lib/aomp. The AOMP environment variable will automatic
 
 On Ubuntu 18.04 LTS (bionic beaver), run these commands:
 ```
-wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-1/aomp_Ubuntu1804_11.6-1_amd64.deb
-sudo dpkg -i aomp_Ubuntu1804_11.6-1_amd64.deb
+wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-2/aomp_Ubuntu1804_11.6-2_amd64.deb
+sudo dpkg -i aomp_Ubuntu1804_11.6-2_amd64.deb
 ```
 On Ubuntu 16.04,  run these commands:
 ```
-wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-1/aomp_Ubuntu1604_11.6-1_amd64.deb
-sudo dpkg -i aomp_Ubuntu1604_11.6-1_amd64.deb
+wget https://github.com/ROCm-Developer-Tools/aomp/releases/download/rel_11.6-2/aomp_Ubuntu1604_11.6-2_amd64.deb
+sudo dpkg -i aomp_Ubuntu1604_11.6-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.