iree_hal.h File Reference

SPIR-V compiler-and-loader targets from IREE HAL devices. More...

Go to the source code of this file.

Data Structures
struct	loomc_spirv_iree_hal_target_options_t
	SPIR-V target options for an IREE HAL Vulkan device. More...

Functions
loomc_status_t	loomc_target_select_spirv_iree_hal (loomc_target_environment_t *target_environment, const loomc_spirv_iree_hal_target_options_t *options, loomc_allocator_t allocator, loomc_iree_hal_target_selection_t *out_selection, loomc_result_t **out_result)
	Selects a SPIR-V compiler-and-loader target from an IREE HAL Vulkan device.
const loomc_iree_hal_target_provider_t *	loomc_spirv_iree_hal_target_provider (void)
	Returns the generic IREE HAL router provider for SPIR-V/Vulkan devices.

Detailed Description

SPIR-V compiler-and-loader targets from IREE HAL devices.

This optional leaf adapts an IREE HAL Vulkan device into the public SPIR-V target profile fact model. It does not expose Vulkan headers or driver private types. The adapter uses stable HAL device queries such as vulkan.device :: api_version and vulkan.feature :: buffer_device_address, then creates an ordinary loomc_target_profile_t with SPIR-V facts and diagnostics.

The initial execution profile targets IREE HAL's raw Vulkan BDA SPIR-V executable target. Devices that cannot support that execution mode return a failed result with structured diagnostics instead of forcing callers to infer support from status codes.

Example

Select a SPIR-V target directly from an IREE HAL Vulkan device:

loomc_spirv_iree_hal_target_options_t options = {
    .type = LOOMC_STRUCTURE_TYPE_SPIRV_IREE_HAL_TARGET_OPTIONS,
    .structure_size = sizeof(loomc_spirv_iree_hal_target_options_t),
    .identifier = loomc_make_cstring_view("jit-vulkan"),
    .device = device,
    .physical_device_affinity = 0,
};
loomc_iree_hal_target_selection_t selection = {0};
loomc_result_t* result = NULL;
loomc_status_t status = loomc_target_select_spirv_iree_hal(
    target_environment, &options, loomc_allocator_system(), &selection,
    &result);
if (!loomc_status_is_ok(status)) return status;
if (!loomc_result_succeeded(result)) {
  // Inspect diagnostics before deciding whether to fall back or skip.
}
loomc_target_profile_release(selection.target_profile);
loomc_result_release(result);

Function Documentation

loomc_spirv_iree_hal_target_provider()

const loomc_iree_hal_target_provider_t * loomc_spirv_iree_hal_target_provider

(

void

)

Returns the generic IREE HAL router provider for SPIR-V/Vulkan devices.

Returns

Process-lifetime provider descriptor. The returned pointer is immutable and may be placed directly in a loomc_iree_hal_target_options_t::providers array.

loomc_target_select_spirv_iree_hal()

loomc_status_t loomc_target_select_spirv_iree_hal	(	loomc_target_environment_t *	target_environment,
		const loomc_spirv_iree_hal_target_options_t *	options,
		loomc_allocator_t	allocator,
		loomc_iree_hal_target_selection_t *	out_selection,
		loomc_result_t **	out_result )

Selects a SPIR-V compiler-and-loader target from an IREE HAL Vulkan device.

Parameters

target_environment	SPIR-V target environment that will own the profile.
options	SPIR-V IREE HAL target options.
allocator	Host allocator used for result and profile storage.
out_selection	Receives one complete target selection when the result succeeds. Receives zero on failed result.
out_result	Receives a retained result containing adapter or SPIR-V profile diagnostics.

Returns

OK when target selection completed far enough to report a result. Non-OK statuses represent API misuse or infrastructure failures before a result could be produced.

Ownership

The caller owns out_result on an OK return and releases it with loomc_result_release. When a profile is produced, the caller owns the returned profile reference with loomc_target_profile_release. The executable target remains borrowed from the device.

Thread safety

The adapter holds no mutable process-global state. It may be called concurrently for different invocations. The supplied HAL device must satisfy its own thread-safety contract.