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

Requests a result-owned JSON report of executed passes. More...

#include <pass.h>

Data Fields

loomc_structure_type_t type
 Structure type. Must be LOOMC_STRUCTURE_TYPE_PASS_REPORT_OPTIONS.
loomc_host_size_t structure_size
 Size of this structure in bytes, or zero.
const void * next
 Next invocation option extension.
loomc_pass_report_flags_t flags
 Additional observations. Zero collects statistics and details only.
loomc_string_view_t identifier
 Result artifact identifier. Empty leaves the identifier empty.

Detailed Description

Requests a result-owned JSON report of executed passes.

Attach through loomc_pass_run_options_t::next, loomc_compile_options_t::next, or loomc_compile_artifact_options_t::next. Each attempted program produces one REPORT artifact with pass identity, status, change flags, statistics, and details. A diagnosed pass failure retains completed observations in its failed result. Rejection before the program starts produces no pass report; a non-OK infrastructure status returns no result and stops further report serialization.

Omitting this extension disables collection. Attaching it with zero flags collects deterministic statistics without timing. Reports neither select passes nor retain modules, programs, or target providers after returning. This extension and native pass report options are mutually exclusive.


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