llvm-project/libclc
Chandler Carruth 2946cd7010 Update the file headers across all of the LLVM projects in the monorepo
to reflect the new license.

We understand that people may be surprised that we're moving the header
entirely to discuss the new license. We checked this carefully with the
Foundation's lawyer and we believe this is the correct approach.

Essentially, all code in the project is now made available by the LLVM
project under our new license, so you will see that the license headers
include that license only. Some of our contributors have contributed
code under our old license, and accordingly, we have retained a copy of
our old license notice in the top-level files in each project and
repository.

llvm-svn: 351636
2019-01-19 08:50:56 +00:00
..
amdgcn/lib amdgcn: Consolidate atomic minmax helpers 2018-11-27 16:01:13 +00:00
amdgcn-amdhsa/lib amdgcn-amdhsa: Convert get_{global,local}_size to clc for all llvm versions 2018-11-04 00:39:30 +00:00
amdgpu/lib Remove redundant OVERRRIDES file 2018-11-04 00:54:46 +00:00
build configure.py: Make python3 friendly 2017-08-02 15:00:59 +00:00
cmake Add cmake build system 2018-11-27 16:07:19 +00:00
generic Update the file headers across all of the LLVM projects in the monorepo 2019-01-19 08:50:56 +00:00
ptx/lib ptx: Use __clc_nextafter to implement nextafter 2017-10-08 19:34:00 +00:00
ptx-nvidiacl/lib Implement mem_fence on ptx 2017-10-09 19:43:04 +00:00
r600/lib r600: Remove empty OVERRIDES file 2018-11-27 16:01:16 +00:00
test
utils utils: Adapt to llvm r325155 2018-02-23 07:37:03 +00:00
www Update page to list supported targets 2016-02-13 01:02:06 +00:00
.gitignore .gitignore: Ignore amdgcn-mesa object directory 2017-02-24 20:32:18 +00:00
.travis.yml travis: Add cmake build 2018-11-27 16:07:21 +00:00
CMakeLists.txt cmake: Install libraries to DATADIR from GNUInstallDirs 2019-01-07 20:20:37 +00:00
CREDITS.TXT
LICENSE.TXT Install new LLVM license structure and new developer policy. 2019-01-19 06:14:24 +00:00
README.TXT
amdgcn-mesa3d configure: Provide symlink for amdgcn-mesa3d instead of configure hack 2018-11-04 00:54:45 +00:00
check_external_calls.sh check_external_calls.sh: Print number of calls in tested file. 2017-10-08 20:07:56 +00:00
compile-test.sh
configure.py configure: Add target specific asm rule. 2018-11-27 16:01:10 +00:00
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
-------

http://www.pcc.me.uk/~peter/libclc/