[Dexter] add an optnone attribute debug experience test for loops.
[llvm-project.git] / openmp / www / README.txt
blob55ba40c74c7f1b4af905700ec4541523bfaa7d1b
2                README for the LLVM* OpenMP* Runtime Library
3                ============================================
5 How to Build Documentation
6 ==========================
8 The main documentation is in Doxygen* format, and this distribution
9 should come with pre-built PDF documentation in doc/Reference.pdf.
10 However, an HTML version can be built by executing:
12 % doxygen doc/doxygen/config
14 in the runtime directory.
16 That will produce HTML documentation in the doc/doxygen/generated
17 directory, which can be accessed by pointing a web browser at the
18 index.html file there.
20 If you don't have Doxygen installed, you can download it from
21 www.doxygen.org.
24 How to Build the LLVM* OpenMP* Runtime Library
25 ==============================================
26 In-tree build:
28 $ cd where-you-want-to-live
29 Check out openmp into llvm/projects
30 $ cd where-you-want-to-build
31 $ mkdir build && cd build
32 $ cmake path/to/llvm -DCMAKE_C_COMPILER=<C compiler> -DCMAKE_CXX_COMPILER=<C++ compiler>
33 $ make omp
35 Out-of-tree build:
37 $ cd where-you-want-to-live
38 Check out openmp
39 $ cd where-you-want-to-live/openmp
40 $ mkdir build && cd build
41 $ cmake path/to/openmp -DCMAKE_C_COMPILER=<C compiler> -DCMAKE_CXX_COMPILER=<C++ compiler>
42 $ make
44 For details about building, please look at README.rst.
46 Architectures Supported
47 =======================
48 * IA-32 architecture
49 * Intel(R) 64 architecture
50 * Intel(R) Many Integrated Core Architecture
51 * ARM* architecture
52 * Aarch64 (64-bit ARM) architecture
53 * IBM(R) Power architecture (big endian)
54 * IBM(R) Power architecture (little endian)
55 * MIPS and MIPS64 architectures
56 * RISC-V 64 bit architecture
58 Supported RTL Build Configurations
59 ==================================
61 Supported Architectures: IA-32 architecture, Intel(R) 64, and
62 Intel(R) Many Integrated Core Architecture
64               ----------------------------------------------
65               |   icc/icl     |    gcc      |   clang      |
66 --------------|---------------|----------------------------|
67 | Linux* OS   |   Yes(1,5)    |  Yes(2,4)   | Yes(4,6,7)   |
68 | FreeBSD*    |   No          |  No         | Yes(4,6,7,8) |
69 | OS X*       |   Yes(1,3,4)  |  No         | Yes(4,6,7)   |
70 | Windows* OS |   Yes(1,4)    |  No         | No           |
71 ------------------------------------------------------------
73 (1) On IA-32 architecture and Intel(R) 64, icc/icl versions 12.x are
74     supported (12.1 is recommended).
75 (2) GCC* version 4.7 is supported.
76 (3) For icc on OS X*, OS X* version 10.5.8 is supported.
77 (4) Intel(R) Many Integrated Core Architecture not supported.
78 (5) On Intel(R) Many Integrated Core Architecture, icc/icl versions 13.0
79     or later are required.
80 (6) Clang* version 3.3 is supported.
81 (7) Clang* currently does not offer a software-implemented 128 bit extended
82     precision type.  Thus, all entry points reliant on this type are removed
83     from the library and cannot be called in the user program.  The following
84     functions are not available:
85     __kmpc_atomic_cmplx16_*
86     __kmpc_atomic_float16_*
87     __kmpc_atomic_*_fp
88 (8) Community contribution provided AS IS, not tested by Intel.
90 Supported Architectures: IBM(R) Power 7 and Power 8
92               -----------------------------
93               |   gcc      |   clang      |
94 --------------|------------|--------------|
95 | Linux* OS   |  Yes(1,2)  | Yes(3,4)     |
96 -------------------------------------------
98 (1) On Power 7, gcc version 4.8.2 is supported.
99 (2) On Power 8, gcc version 4.8.2 is supported.
100 (3) On Power 7, clang version 3.7 is supported.
101 (4) On Power 8, clang version 3.7 is supported.
104 Front-end Compilers that work with this RTL
105 ===========================================
107 The following compilers are known to do compatible code generation for
108 this RTL: clang (from the OpenMP development branch at
109 http://clang-omp.github.io/ ), Intel compilers, GCC.  See the documentation
110 for more details.
112 -----------------------------------------------------------------------
114 Notices
115 =======
117 *Other names and brands may be claimed as the property of others.