/opencl-intercept-layer

Intercept Layer for Debugging and Analyzing OpenCL Applications

Primary LanguageC++MIT LicenseMIT

Intercept Layer for OpenCLTM Applications

GitHub Actions: GitHub Actions Build Status

The Intercept Layer for OpenCL Applications is a tool that can intercept and modify OpenCL calls for debugging and performance analysis. Using the Intercept Layer for OpenCL Applications requires no application or driver modifications.

To operate, the Intercept Layer for OpenCL Applications masquerades as the OpenCL ICD loader (usually) or as an OpenCL implementation (rarely) and is loaded when the application intends to load the real OpenCL ICD loader. As part of the Intercept Layer for OpenCL Application's initialization, it loads the real OpenCL ICD loader and gets function pointers to the real OpenCL entry points. Then, whenever the application makes an OpenCL call, the call is intercepted and can be passed through to the real OpenCL with or without changes.

Intercept Layer Architecture

This project adheres to the Intercept Layer for OpenCL Application's code of conduct. By participating, you are expected to uphold this code.

Documentation

All controls are documented here.

Instructions to build the Intercept Layer for OpenCL Applications can be found here.

Instructions to use the Intercept Layer for OpenCL Applications Loader (cliloader) can be found here.

Instructions for the old loader (cliprof) can still be found here.

Instructions to install the Intercept Layer for OpenCL Applications can be found here.

Troubleshooting steps and answers to frequently asked questions can be found here.

Detailed instructions:

Tutorial

A tutorial demonstrating common usages of the Intercept Layer for OpenCL Applications can be found here.

License

The Intercept Layer for OpenCL Applications is licensed under the MIT License.

Notes:

Attached Licenses

The Intercept Layer for OpenCL Applications uses third-party code licensed under the following licenses:

Support

Please file a GitHub issue to report an issue or ask questions. Private or sensitive issues may be submitted via email to this project's maintainer (Ben Ashbaugh - ben 'dot' ashbaugh 'at' intel 'dot' com), or to any other Intel GitHub maintainer (see profile for email address).

How to Contribute

Contributions to the Intercept Layer for OpenCL Applications are welcomed and encouraged. Please see CONTRIBUTING for details how to contribute to the project.


OpenCL and the OpenCL logo are trademarks of Apple Inc. used by permission by Khronos.

* Other names and brands may be claimed as the property of others.

Copyright (c) 2018-2024, Intel(R) Corporation