llvm-project/libclc
Alan Baker 21427b8eb8 libclc: Add clspv target to libclc
Add clspv as a new target for libclc. clspv is an open-source compiler that compiles OpenCL C to Vulkan SPIR-V. Compiles for the spir target.

The clspv target differs from the the spirv target in the following ways:
* fma is modified to use uint2 instead of ulong for mantissas. This results in lower performance fma, but provides a implementation that can be used on more Vulkan devices where 64-bit integer support is less common.
* Use of a software implementation of nextafter because the generic implementation depends on nextafter being a defined builtin function for which clspv has no definition.
* Full optimization of the library (-O3) and no conversion to SPIR-V

This library is close to what would be produced by running opt -O3 < builtins.opt.spirv-mesa3d-.bc > builtins.opt.clspv--.bc and continuing the build from that point.

Reviewer: jvesely

Differential Revision: https://reviews.llvm.org/D94013
2021-03-04 00:19:10 -05:00
..
amdgcn/lib libclc: Make all built-ins overloadable 2020-08-17 13:55:48 -07:00
amdgcn-amdhsa/lib libclc: Make all built-ins overloadable 2020-08-17 13:55:48 -07:00
amdgpu/lib Remove redundant OVERRRIDES file 2018-11-04 00:54:46 +00:00
clspv/lib libclc: Add clspv target to libclc 2021-03-04 00:19:10 -05:00
cmake libclc: Use temporary files rather than a pipe 2020-04-14 10:03:27 -04:00
generic libclc: Use find_package to find Python 3 and require it 2020-10-01 22:31:33 +02:00
ptx/lib
ptx-nvidiacl/lib libclc: Make all built-ins overloadable 2020-08-17 13:55:48 -07:00
r600/lib libclc: Make all built-ins overloadable 2020-08-17 13:55:48 -07:00
spirv/lib libclc: Add a __builtin to let SPIRV targets select between SW and HW FMA 2020-09-16 01:37:22 -04:00
spirv64/lib libclc: Add a __builtin to let SPIRV targets select between SW and HW FMA 2020-09-16 01:37:22 -04:00
test
utils Revert "Rename F_{None,Text,Append} to OF_{None,Text,Append}. NFC" 2019-08-05 17:23:23 +00:00
www [www] Change URLs to HTTPS. 2019-10-24 13:25:15 -07:00
.gitignore
CMakeLists.txt libclc: Add clspv target to libclc 2021-03-04 00:19:10 -05:00
CREDITS.TXT
LICENSE.TXT Fix typos throughout the license files that somehow I and my reviewers 2019-01-21 09:52:34 +00:00
README.TXT libclc: update website url 2020-05-29 09:18:37 +02:00
amdgcn-mesa3d configure: Provide symlink for amdgcn-mesa3d instead of configure hack 2018-11-04 00:54:45 +00:00
check_external_calls.sh
compile-test.sh
libclc.pc.in cmake: Install libraries to DATADIR from GNUInstallDirs 2019-01-07 20:20:37 +00:00

README.TXT

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

libclc
------

libclc is an open source, BSD licensed implementation of the library
requirements of the OpenCL C programming language, as specified by the
OpenCL 1.1 Specification. The following sections of the specification
impose library requirements:

  * 6.1: Supported Data Types
  * 6.2.3: Explicit Conversions
  * 6.2.4.2: Reinterpreting Types Using as_type() and as_typen()
  * 6.9: Preprocessor Directives and Macros
  * 6.11: Built-in Functions
  * 9.3: Double Precision Floating-Point
  * 9.4: 64-bit Atomics
  * 9.5: Writing to 3D image memory objects
  * 9.6: Half Precision Floating-Point

libclc is intended to be used with the Clang compiler's OpenCL frontend.

libclc is designed to be portable and extensible. To this end, it provides
generic implementations of most library requirements, allowing the target
to override the generic implementation at the granularity of individual
functions.

libclc currently only supports the PTX target, but support for more
targets is welcome.

Compiling and installing with Make
----------------------------------

$ ./configure.py --with-llvm-config=/path/to/llvm-config && make
$ make install

Note you can use the DESTDIR Makefile variable to do staged installs.

$ make install DESTDIR=/path/for/staged/install

Compiling and installing with Ninja
-----------------------------------

$ ./configure.py -g ninja --with-llvm-config=/path/to/llvm-config && ninja
$ ninja install

Note you can use the DESTDIR environment variable to do staged installs.

$ DESTDIR=/path/for/staged/install ninja install

Website
-------

https://libclc.llvm.org/