Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/rocm/aomp

AOMP is an open source Clang/LLVM based compiler with added support for the OpenMP® API on Radeon™ GPUs. Use this repository for releases, issues, documentation, packaging, and examples.
https://github.com/rocm/aomp

amd clang fortran-compiler llvm openmp rocm

Last synced: 4 days ago
JSON representation

AOMP is an open source Clang/LLVM based compiler with added support for the OpenMP® API on Radeon™ GPUs. Use this repository for releases, issues, documentation, packaging, and examples.

Awesome Lists containing this project

README 

        
AOMP - V 20.0-1

==============



This is README.md for https://github.com/ROCm/aomp.

This is the base repository for AOMP. Use this github repository for

[packaged releases](https://github.com/ROCm/aomp/releases),

[issues](https://github.com/ROCm/aomp/issues),

documentation, and

[examples](https://github.com/ROCm/aomp/tree/master/examples).



The last [release is AOMP 20.0-1](https://github.com/ROCm/aomp/releases).

Currently AOMP 20.0-2 is under development.



Attention Users!  Please use this repository for [issues](https://github.com/ROCm/aomp/issues).

Do not put issues in any of the source code repositories.



Table of contents

-----------------



- [Overview](#Overview)

- [Copyright and Disclaimer](#Copyright)

- [Software License Agreement](LICENSE)

- [Install](docs/INSTALL.md)

- [Release Packages](https://github.com/ROCm/aomp/releases)

- [Test Install](docs/TESTINSTALL.md)

- [Examples](examples)

- [Issues](https://github.com/ROCm/aomp/issues)

- [Developers Readme](bin/README.md)

- [amd-trunk-dev](trunk/README.md) Only for developers working on upstream integration branch.

- [Limitations](#Limitations)



## Overview






AOMP is a scripted build of LLVM and supporting software.

It has support for OpenMP target offload on AMD GPUs.

Since AOMP is a clang/llvm compiler, it also supports GPU offloading with HIP, stdpar, CUDA, and OpenCL.

The source code used to build AOMP is the amd-staging branch of the

[llvm-project](https://github.com/ROCm/llvm-project) repository used by AMD for llvm developments.



The bin directory of this repository contains the developer [README.md](bin/README.md)

and build scripts needed to download, build, and install AOMP from source.

In addition to the mirrored [llvm-project repository](https://github.com/ROCm/llvm-project),

AOMP uses a number of open-source ROCm components. The build scripts will download, build, and install all components needed for AOMP.



This from-source build is intended for developers. It is long, has many system prerequisites, and requires extensive resources.

If your goal is to test an advanced develpment compiler, we recommend that you install the latest development

release of the [AOMP debian or rpm package](https://github.com/ROCm/aomp/releases)

described in the [install page](docs/INSTALL.md).



## Copyright and Disclaimer






Copyright (c) 2024 ADVANCED MICRO DEVICES, INC.



AMD is granting you permission to use this software and documentation (if any) (collectively, the 

“Materials”) pursuant to the terms and conditions of the Software License Agreement included with the 

Materials.  If you do not have a copy of the Software License Agreement, contact your AMD 

representative for a copy.



You agree that you will not reverse engineer or decompile the Materials, in whole or in part, except for 

example code which is provided in source code form and as allowed by applicable law.



WARRANTY DISCLAIMER: THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY 

KIND.  AMD DISCLAIMS ALL WARRANTIES, EXPRESS, IMPLIED, OR STATUTORY, INCLUDING BUT NOT 

LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR 

PURPOSE, TITLE, NON-INFRINGEMENT, THAT THE SOFTWARE WILL RUN UNINTERRUPTED OR ERROR-

FREE OR WARRANTIES ARISING FROM CUSTOM OF TRADE OR COURSE OF USAGE.  THE ENTIRE RISK 

ASSOCIATED WITH THE USE OF THE SOFTWARE IS ASSUMED BY YOU.  Some jurisdictions do not 

allow the exclusion of implied warranties, so the above exclusion may not apply to You. 



LIMITATION OF LIABILITY AND INDEMNIFICATION:  AMD AND ITS LICENSORS WILL NOT, 

UNDER ANY CIRCUMSTANCES BE LIABLE TO YOU FOR ANY PUNITIVE, DIRECT, INCIDENTAL, 

INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES ARISING FROM USE OF THE SOFTWARE OR THIS 

AGREEMENT EVEN IF AMD AND ITS LICENSORS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH 

DAMAGES.  In no event shall AMD's total liability to You for all damages, losses, and 

causes of action (whether in contract, tort (including negligence) or otherwise) 

exceed the amount of $100 USD.  You agree to defend, indemnify and hold harmless 

AMD and its licensors, and any of their directors, officers, employees, affiliates or 

agents from and against any and all loss, damage, liability and other expenses 

(including reasonable attorneys' fees), resulting from Your use of the Software or 

violation of the terms and conditions of this Agreement.  



U.S. GOVERNMENT RESTRICTED RIGHTS: The Materials are provided with "RESTRICTED RIGHTS." 

Use, duplication, or disclosure by the Government is subject to the restrictions as set 

forth in FAR 52.227-14 and DFAR252.227-7013, et seq., or its successor.  Use of the 

Materials by the Government constitutes acknowledgement of AMD's proprietary rights in them.



EXPORT RESTRICTIONS: The Materials may be subject to export restrictions as stated in the 

Software License Agreement.



## AOMP Limitations






See the [release notes](https://github.com/ROCm/aomp/releases) in github.  Here are some limitations.



```

 - Some simd constructs fail to vectorize on both host and GPUs.

```