mirror of
https://github.com/intel/llvm.git
synced 2026-01-13 11:02:04 +08:00
51e3c3d51b
Summary: This exposes the 'isDeviceCompatible' routine for checking if a binary *can* be loaded. This is useful if people don't want to consume errors everywhere when figuring out which image to put to what device. I don't know if this is a good name, I was thining like `olIsCompatible` or whatever. Let me know what you think. Long term I'd like to be able to do something similar to what OpenMP does where we can conditionally only initialize devices if we need them. That's going to be support needed if we want this to be more generic.
47 lines
2.0 KiB
TableGen
47 lines
2.0 KiB
TableGen
//===-- Program.td - Program definitions for Offload -------*- tablegen -*-===//
|
|
//
|
|
// 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
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
//
|
|
// This file contains Offload API definitions related to the program handle
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
def olCreateProgram : Function {
|
|
let desc = "Create a program for the device from the binary image pointed to by `ProgData`.";
|
|
let details = [
|
|
"The provided `ProgData` will be copied and need not outlive the returned handle",
|
|
];
|
|
let params = [
|
|
Param<"ol_device_handle_t", "Device", "handle of the device", PARAM_IN>,
|
|
Param<"const void*", "ProgData", "pointer to the program binary data", PARAM_IN>,
|
|
Param<"size_t", "ProgDataSize", "size of the program binary in bytes", PARAM_IN>,
|
|
Param<"ol_program_handle_t*", "Program", "output pointer for the created program", PARAM_OUT>
|
|
];
|
|
let returns = [];
|
|
}
|
|
|
|
def olIsValidBinary : Function {
|
|
let desc = "Validate if the binary image pointed to by `ProgData` is compatible with the device.";
|
|
let details = ["The provided `ProgData` will not be loaded onto the device"];
|
|
let params = [
|
|
Param<"ol_device_handle_t", "Device", "handle of the device", PARAM_IN>,
|
|
Param<"const void*", "ProgData", "pointer to the program binary data", PARAM_IN>,
|
|
Param<"size_t", "ProgDataSize", "size of the program binary in bytes", PARAM_IN>,
|
|
Param<"bool*", "Valid", "output is true if the image is compatible", PARAM_OUT>
|
|
];
|
|
let returns = [];
|
|
}
|
|
|
|
def olDestroyProgram : Function {
|
|
let desc = "Destroy the program and free all underlying resources.";
|
|
let details = [];
|
|
let params = [
|
|
Param<"ol_program_handle_t", "Program", "handle of the program", PARAM_IN>
|
|
];
|
|
let returns = [];
|
|
}
|