800d949bb3
Implement the complete initial version of the Offload API, to the extent that is usable for simple offloading programs. Tested with a basic SYCL program. As far as possible, these are simple wrappers over existing functionality in the plugins. * Allocating and freeing memory (host, device, shared). * Creating a program * Creating a queue (wrapper over asynchronous stream resource) * Enqueuing memcpy operations * Enqueuing kernel executions * Waiting on (optional) output events from the enqueue operations * Waiting on a queue to finish Objects created with the API have reference counting semantics to handle their lifetime. They are created with an initial reference count of 1, which can be incremented and decremented with retain and release functions. They are freed when their reference count reaches 0. Platform and device objects are not reference counted, as they are expected to persist as long as the library is in use, and it's not meaningful for users to create or destroy them. Tests have been added to `offload.unittests`, including device code for testing program and kernel related functionality. The API should still be considered unstable and it's very likely we will need to change the existing entry points.
69 lines
3.0 KiB
C++
69 lines
3.0 KiB
C++
//===- Auto-generated file, part of the LLVM/Offload project --------------===//
|
|
//
|
|
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
|
|
// See https://llvm.org/LICENSE.txt for license information.
|
|
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
ol_impl_result_t olInit_impl();
|
|
|
|
ol_impl_result_t olShutDown_impl();
|
|
|
|
ol_impl_result_t olGetPlatformInfo_impl(ol_platform_handle_t Platform,
|
|
ol_platform_info_t PropName,
|
|
size_t PropSize, void *PropValue);
|
|
|
|
ol_impl_result_t olGetPlatformInfoSize_impl(ol_platform_handle_t Platform,
|
|
ol_platform_info_t PropName,
|
|
size_t *PropSizeRet);
|
|
|
|
ol_impl_result_t olIterateDevices_impl(ol_device_iterate_cb_t Callback,
|
|
void *UserData);
|
|
|
|
ol_impl_result_t olGetDeviceInfo_impl(ol_device_handle_t Device,
|
|
ol_device_info_t PropName,
|
|
size_t PropSize, void *PropValue);
|
|
|
|
ol_impl_result_t olGetDeviceInfoSize_impl(ol_device_handle_t Device,
|
|
ol_device_info_t PropName,
|
|
size_t *PropSizeRet);
|
|
|
|
ol_impl_result_t olMemAlloc_impl(ol_device_handle_t Device,
|
|
ol_alloc_type_t Type, size_t Size,
|
|
void **AllocationOut);
|
|
|
|
ol_impl_result_t olMemFree_impl(void *Address);
|
|
|
|
ol_impl_result_t olMemcpy_impl(ol_queue_handle_t Queue, void *DstPtr,
|
|
ol_device_handle_t DstDevice, void *SrcPtr,
|
|
ol_device_handle_t SrcDevice, size_t Size,
|
|
ol_event_handle_t *EventOut);
|
|
|
|
ol_impl_result_t olCreateQueue_impl(ol_device_handle_t Device,
|
|
ol_queue_handle_t *Queue);
|
|
|
|
ol_impl_result_t olDestroyQueue_impl(ol_queue_handle_t Queue);
|
|
|
|
ol_impl_result_t olWaitQueue_impl(ol_queue_handle_t Queue);
|
|
|
|
ol_impl_result_t olDestroyEvent_impl(ol_event_handle_t Event);
|
|
|
|
ol_impl_result_t olWaitEvent_impl(ol_event_handle_t Event);
|
|
|
|
ol_impl_result_t olCreateProgram_impl(ol_device_handle_t Device,
|
|
const void *ProgData, size_t ProgDataSize,
|
|
ol_program_handle_t *Program);
|
|
|
|
ol_impl_result_t olDestroyProgram_impl(ol_program_handle_t Program);
|
|
|
|
ol_impl_result_t olGetKernel_impl(ol_program_handle_t Program,
|
|
const char *KernelName,
|
|
ol_kernel_handle_t *Kernel);
|
|
|
|
ol_impl_result_t
|
|
olLaunchKernel_impl(ol_queue_handle_t Queue, ol_device_handle_t Device,
|
|
ol_kernel_handle_t Kernel, const void *ArgumentsData,
|
|
size_t ArgumentsSize,
|
|
const ol_kernel_launch_size_args_t *LaunchSizeArgs,
|
|
ol_event_handle_t *EventOut);
|