Skip to content

aowlspt_live.h

Source: abi/aowlspt_live.h — 180 lines, 9 file-scope functions.

What this header owns

Reproduced verbatim from the header's own banner comment — these notes are frequently the only written record of why the subsystem is shaped the way it is.

text
 aowlspt_live.h — the revision-3 live-object entry points, for the one host
that has live objects.

`handle_pointer` and `handle_pin` turn a host handle into the address of the
managed object behind it. That only means anything where there *is* a managed
heap, which is the IL2CPP client host: the backend and the server host hand
out handles over their own objects and have no such address to give.

Hence a separate header rather than two more entries in `aowlspt_shim.h`.
Everything in the shim is compiled into every nimony binary that includes it,
and a `static` wrapper there would name two `aowlspt_nim_*` functions that
only the client host defines -- so the backend would stop linking on an entry
point that would answer "unsupported" if it existed. Keeping the pair here
means a host opts into them by including this file, and `aowl_hostapi_new`
reports the revision-2 size until `aowl_hostapi_arm_live` says otherwise.

Include *after* `aowlspt_shim.h`, or on its own -- it pulls the shim in
either way and the include guard sorts the rest out.

Constants

  • AOWLSPT_LIVE_H

Functions

SignatureLine
AowlStatus AOWLSPT_CALL aowl_host_handle_pointer(void* ctx, AowlHandle h, uint64_t* out)46
AowlStatus AOWLSPT_CALL aowl_host_handle_pin(void* ctx, AowlHandle h, AowlHandle* out)56
AowlStatus AOWLSPT_CALL aowl_host_patch_typed(void* ctx, AowlSlice target, int32_t kind, AowlTypedPatchFn h, void* user)66
int32_t aowl_invoke_typed_patch(void* cb, void* user, void* frame)82
void aowl_hostapi_arm_live(void* p)91
void aowl_hostapi_arm_typed(void* p)109
AowlStatus AOWLSPT_CALL aowl_host_invoke_render(void* ctx, AowlCallbackFn cb, void* user)128
AowlStatus AOWLSPT_CALL aowl_host_notify_unsupported(void* ctx, AowlSlice session, AowlSlice payload)134
void aowl_hostapi_arm_render(void* p)145

aoughwl — self-hosted platform for things n stuff. Contact / Support on Discord for access to the private backends.