source: CLRX/CLRadeonExtender/trunk/README @ 4652

Last change on this file since 4652 was 4511, checked in by matszpk, 12 months ago

CLRadeonExtender: Add alternative links without SSL to README's.

File size: 2.0 KB
Line 
1-----------------------------------------------------------------------
2                               CLRadeonExtender
3-----------------------------------------------------------------------
4
51. About project.
6
7Currently, main goal is low-level development tools for Radeon GPU's based on
8the GCN 1.0/1.1/1.2/1.4 (AMD VEGA) architecture likes assembler, disassembler, optionally
9linker. These utilities will be designed to be compatible with AMD Catalyst
10drivers and an open-source Gallium drivers.
11CLRadeonExtender doesn't require AMD Catalyst drivers and any other drivers
12for Radeon graphics cards, because delivers standalone utilities.
13
14Project is in: https://clrx.nativeboinc.org (or http://clrx.nativeboinc.org if SSL
15certificate doesn't work) and https://github.com/CLRX/CLRX-mirror.
16
172. Support and license
18
19Text of the license is in the COPYING, COPYING.LIB and COPYING.DOC files
20(GPLv2, LGPLv2 and GFDL).
21
223. Utilities
23
24CLRadeonExtender provides two tools:
25
26* clrxasm - an GCN assembler (compatible with GNU as).
27* clrxdisasm - an GCN disassembler
28
29Currently, these tools can handle the AMD Catalyst OpenCL binaries,
30the GalliumCompute binaries, AMD OpenCL 2.0 binaries and ROCm binaries.
31
324. Documentation
33
34Currently, the Doxygen documentation and onlint CLRX documentation available.
35
365. Installation
37
38Read the INSTALL file.
39
406. Usage of libraries in binaries
41
42The default (without '-gcc5' in name) binary libraries for Linux are compiled
43for C++11 old ABI, hence you must add option -D_GLIBCXX_USE_CXX11_ABI=0 to
44compiler commands if you are using GCC 5.0 or higher or compiler that by default
45uses new C++11 ABI.
46
477. Platform support notes
48
49CLRadeonExtender requires in original MinGW some third-party headers:
50https://github.com/meganz/mingw-std-threads. After that changes, CLRXWrapper still is
51not compilable, so you should disable it by enabling NO_CLWRAPPER option CMake while
52generating Makefiles.
53
54On CygWin environment you should point OpenCL distribution directory to AMD APP SDK or
55system distribution instead CygWin OpenCL.
Note: See TracBrowser for help on using the repository browser.