The run's lifecycle and its typed failure. More...

#include <native_c_api.h>

Data Fields
uint32_t	struct_size
	sizeof(pf_native_state_v1).

uint32_t	version
	PF_NATIVE_API_VERSION.

uint32_t	lifecycle
	pf_native_lifecycle_t.

uint32_t	failure_code
	pf_native_failure_code_t; PF_NATIVE_FAILURE_CALLBACK_EXCEPTION for a callback that returned non-zero.

uint32_t	failure_operation
	pf_native_failure_operation_t.

uint32_t	failure_discriminator
	The kernel's own word beside the code, as C++ `NativeFailure::discriminator` holds it: the request core's `native_order::CoreFailure` for a refused preparation (CONTRACT or SETTLEMENT_FAILURE; 7 is `UnrepresentableReservation`), its `InstallError` for a refused install (CONTRACT), the settlement's `execution::Status` for a failed inspection or commit (SETTLEMENT_FAILURE), a staged FX curve's `NativeFxCurveError` (INVALID_SPECIFICATION); 0 when the failure carries none, as every completed run does.

uint64_t	failure_ordinal
	The point the failure was latched at, 0 when absent.

uint64_t	consumed_high_water

int64_t	decision_floor_ms

uint32_t	phase
	pf_native_run_phase_t while Running.

uint32_t	completion
	pf_native_completion_t once Completed.

Detailed Description

The run's lifecycle and its typed failure.

Definition at line 1803 of file native_c_api.h.

Field Documentation

◆ struct_size

uint32_t pf_native_state_v1::struct_size

sizeof(pf_native_state_v1).

Definition at line 1804 of file native_c_api.h.

◆ version

uint32_t pf_native_state_v1::version

PF_NATIVE_API_VERSION.

Definition at line 1805 of file native_c_api.h.

◆ lifecycle

uint32_t pf_native_state_v1::lifecycle

pf_native_lifecycle_t.

Definition at line 1806 of file native_c_api.h.

◆ failure_code

uint32_t pf_native_state_v1::failure_code

pf_native_failure_code_t; PF_NATIVE_FAILURE_CALLBACK_EXCEPTION for a callback that returned non-zero.

Definition at line 1807 of file native_c_api.h.

◆ failure_operation

uint32_t pf_native_state_v1::failure_operation

pf_native_failure_operation_t.

Definition at line 1810 of file native_c_api.h.

◆ failure_discriminator

uint32_t pf_native_state_v1::failure_discriminator

The kernel's own word beside the code, as C++ NativeFailure::discriminator holds it: the request core's native_order::CoreFailure for a refused preparation (CONTRACT or SETTLEMENT_FAILURE; 7 is UnrepresentableReservation), its InstallError for a refused install (CONTRACT), the settlement's execution::Status for a failed inspection or commit (SETTLEMENT_FAILURE), a staged FX curve's NativeFxCurveError (INVALID_SPECIFICATION); 0 when the failure carries none, as every completed run does.

Definition at line 1811 of file native_c_api.h.

◆ failure_ordinal

uint64_t pf_native_state_v1::failure_ordinal

The point the failure was latched at, 0 when absent.

Definition at line 1823 of file native_c_api.h.

◆ consumed_high_water

uint64_t pf_native_state_v1::consumed_high_water

Definition at line 1824 of file native_c_api.h.

◆ decision_floor_ms

int64_t pf_native_state_v1::decision_floor_ms

Definition at line 1825 of file native_c_api.h.

◆ phase

uint32_t pf_native_state_v1::phase

pf_native_run_phase_t while Running.

Definition at line 1826 of file native_c_api.h.

◆ completion

uint32_t pf_native_state_v1::completion

pf_native_completion_t once Completed.

Definition at line 1827 of file native_c_api.h.

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

native_c_api.h

Data Fields