Enum anira_status#

enum anira_status#

Return status of every fallible entry point: 0 is success, positive values are informational successes, negative values are failures.

Values:

enumerator ANIRA_OK#

Success.

enumerator ANIRA_SUCCESS_UPGRADED#

Success; a version 2 JSON document was auto-upgraded (section 8.4).

enumerator ANIRA_INCOMPLETE#

Success; the enumeration buffer was too short and holds what fit.

enumerator ANIRA_TIMEOUT#

A wait ran out of time. Not what a Hard _wait entry returns at its timeout: a block not completed by then is a missed block, ANIRA_MISSED.

enumerator ANIRA_PENDING#

Not yet complete.

enumerator ANIRA_MISSED#

Success; a Hard entry found the block’s inference incomplete and delivered what the contract’s miss policy says (section 3): the output buffers are valid and the stream stays time-aligned. Also what a _wait entry returns when its timeout ran out (not ANIRA_TIMEOUT). Not recorded in anira_handler_rt_error.

enumerator ANIRA_ERROR_UNKNOWN#

Unclassified failure.

enumerator ANIRA_ERROR_INVALID_ARGUMENT#

A single argument is out of range or NULL where a value is required.

enumerator ANIRA_ERROR_INVALID_STATE#

The object is not in a state that allows the call.

enumerator ANIRA_ERROR_OUT_OF_MEMORY#

An allocation failed.

enumerator ANIRA_ERROR_NOT_SUPPORTED#

Engine, provider, domain or extension kind not available here (not in this build, or not served by the engine on this machine).

enumerator ANIRA_ERROR_NO_SUCH_FILE#

A path does not resolve to a readable file.

enumerator ANIRA_ERROR_MODEL_LOAD#

The engine refused the model.

enumerator ANIRA_ERROR_ENGINE#

The engine failed at run time.

enumerator ANIRA_ERROR_CONFIG#

Prepare-time legality (section 2), and the real-time refusals recorded in anira_handler_rt_error, among them a Hard entry’s host tensor whose dtype differs from its slot’s, a Static tensor whose dtype differs from its spec’s, anira_handler_set_plan with a plan out of range, a processor phase that moved other than its hop on a ring, and a ring or tensor accessor’s, or a default body’s, dtype or size.

enumerator ANIRA_ERROR_EXTENSION_UNCONSUMED#

An extension was set that nothing in the pipeline consumes (section 1b).

enumerator ANIRA_ERROR_EXTENSION_UNKNOWN#

The extension kind is not registered in this build.

enumerator ANIRA_ERROR_EDGE_UNREACHABLE#

No edge connects the tensor’s domain with the selected backend (section 7).

enumerator ANIRA_ERROR_BUDGET#

Reserved for the Async contract’s deadlines (a deadline the measured time cannot meet). A Hard prepare never returns it: a model too slow for the stream prepares, sized as an infeasible explicit budget is (for one host block’s burst), and its plan rows carry what the warm-up pass measured.

enumerator ANIRA_ERROR_CAPACITY#

Real-time: no free ticket slot, or a ring is full.

enumerator ANIRA_ERROR_TICKET_STALE#

The ticket names a recycled slot.

enumerator ANIRA_ERROR_WRONG_CONTRACT#

A Hard entry under an Async contract or vice versa.

enumerator ANIRA_ERROR_NOT_PREPARED#

The handler has not been prepared.

enumerator ANIRA_ERROR_JSON#

A JSON document is malformed or names an unknown value; the message carries the key path.

enumerator ANIRA_ERROR_ABI_VERSION#

anira_check_abi: the header and the library disagree.

enumerator ANIRA_ERROR_BUFFER_TOO_SMALL#

A (buf, cap, out_len) text buffer is too small; out_len holds the required size.

enumerator ANIRA_ERROR_DEVICE#

A device descriptor was refused or a device call failed.

enumerator ANIRA_ERROR_EXTENSION_VERSION#

The extension kind is known but not at that version.

enumerator ANIRA_ERROR_NOT_FOUND#

The lookup found nothing that matches (anira_plan_report_find: no plan has every property the query names).

enumerator ANIRA_ERROR_INTERNAL#

An exception the firewall could not classify; a bug in anira.

enumerator ANIRA_STATUS_FORCE32#