Loom C API
Public Loom compiler C API
Loading...
Searching...
No Matches
loomc_cmd_program_request_options_t Struct Reference

Command-product options for an ordinary bytecode request. More...

#include <program.h>

Data Fields

loomc_structure_type_t type
 Structure type.
loomc_host_size_t structure_size
 Size of this structure in bytes.
const void * next
 Optional invocation extensions such as loomc_target_specialization_options_t.
const loomc_link_index_t * library_index
 Optional frozen library-only index used to resolve request declarations.
loomc_config_options_t config
 Per-invocation config bindings applied during selective materialization.
const loomc_target_profile_t * target_profile
 Optional execution profile for all selected kernel entries and their launch configurations.
loomc_request_sink_t request_sink
 Optional sink enabling source-backed kernel request publication.

Detailed Description

Command-product options for an ordinary bytecode request.

The request source is appended to an invocation-local module-index overlay as its only INPUT provider. An optional frozen library supplies dependencies without being traversed or copied. Request roots select command programs by exact bytecode-local identity and preserve their order and duplicates in the returned product.

Field Documentation

◆ library_index

const loomc_link_index_t* loomc_cmd_program_request_options_t::library_index

Optional frozen library-only index used to resolve request declarations.

Passing NULL plans against the request source alone.

◆ request_sink

loomc_request_sink_t loomc_cmd_program_request_options_t::request_sink

Optional sink enabling source-backed kernel request publication.

A NULL callback leaves kernel implementation bodies unopened and returns only executable-entry requirements.

◆ target_profile

const loomc_target_profile_t* loomc_cmd_program_request_options_t::target_profile

Optional execution profile for all selected kernel entries and their launch configurations.

Every materialized command program also uses the profile when its authored target still resolves to target.decl. Targetless command programs remain target-neutral, and programs with concrete targets retain their authored context.

Borrowed synchronously from a compatible context target environment. Published requests own their concrete target definitions. NULL preserves source target selection and explicit invocation specializations. A non-NULL profile cannot be combined with nonempty per-function specializations or target-declaration bindings in next.

◆ type

loomc_structure_type_t loomc_cmd_program_request_options_t::type

Structure type.

Must be LOOMC_STRUCTURE_TYPE_CMD_PROGRAM_REQUEST_OPTIONS when nonzero.


The documentation for this struct was generated from the following file: