derek.holloway
7502bf64a4
CodeQL / Analyze (actions) (push) Canceled after 0s
CodeQL / Analyze (python) (push) Canceled after 0s
pre-commit / pre-commit (push) Canceled after 0s
Multi-Arch CI / setup (push) Canceled after 0s
Publish build_manylinux_x86_64 images / publish_build_manylinux_x86_64 (push) Canceled after 0s
Setup (Multi-Arch) / setup (push) Canceled after 0s
Multi-Arch CI / Linux::${{ fromJSON(needs.setup.outputs.linux_build_config || '{}').build_variant_label || 'skip' }} (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish no_rocm_image_ubi10 image / publish_no_rocm_image_ubi10 (push) Canceled after 0s
Multi-Arch CI / Windows::${{ fromJSON(needs.setup.outputs.windows_build_config || '{}').build_variant_label || 'skip' }} (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Multi-Arch CI / Manifest Diff (push) Canceled after 0s
TheRock Manifest Diff Report / Generate Manifest Diff Report (push) Canceled after 0s
Multi-Arch CI / CI Summary (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04 (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04_ocl_rt images / publish_no_rocm_image_ubuntu24_04_ocl_rt (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_rocgdb (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04_rocgdb images / publish_no_rocm_image_ubuntu24_04_rocgdb (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_ocl_rt (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Unit Tests / Unit Tests :: ubuntu-24.04 (push) Canceled after 0s
Unit Tests / Unit Tests :: windows-2022 (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_media (push) Canceled after 0s
Unit Tests / Unit Tests Summary (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_openmpi (push) Canceled after 0s
35 lines
1.1 KiB
Markdown
35 lines
1.1 KiB
Markdown
# Liboffload
|
|
|
|
This directory contains the implementation of the work-in-progress new API for
|
|
Offload. It builds on top of the existing plugin implementations but provides a
|
|
single level of abstraction suitable for implementation of many offloading
|
|
language runtimes, rather than just OpenMP.
|
|
|
|
## Testing liboffload
|
|
|
|
The main test suite for liboffload can be run with the `check-offload-unit`
|
|
target, which runs the `offload.unittests` executable. The test suite will
|
|
automatically run on every available device, but can be restricted to a single
|
|
platform (CUDA, AMDGPU) with a command line argument:
|
|
|
|
```sh
|
|
$ ./offload.unittests --platform=CUDA
|
|
```
|
|
|
|
Tracing of Offload API calls can be enabled by setting the `OFFLOAD_TRACE`
|
|
environment variable. This works with any program that uses liboffload.
|
|
|
|
```sh
|
|
$ OFFLOAD_TRACE=1 ./offload.unittests
|
|
---> olInit(nullptr)-> OL_SUCCESS
|
|
# etc
|
|
```
|
|
|
|
The host plugin is not currently supported.
|
|
|
|
## Modifying liboffload
|
|
|
|
The main header (`OffloadAPI.h`) and some implementation details are
|
|
autogenerated with tablegen. See the [API definition README](API/README.md)
|
|
for implementation details.
|