fidius-guest::status
Rust
FFI status codes returned by plugin method shims.
These i32 values are the return type of every extern "C" function
in a plugin vtable. The host checks the status code before reading
the output buffer.
Constants
Section titled “Constants”| Name | Type | Value | Description |
|---|---|---|---|
STATUS_OK |
i32 |
0 |
Method executed successfully. Output buffer contains the serialized result. |
STATUS_BUFFER_TOO_SMALL |
i32 |
-1 |
Output buffer was too small (CallerAllocated/Arena strategies only). The out_len parameter contains the required size. Retry with a larger buffer. |
STATUS_SERIALIZATION_ERROR |
i32 |
-2 |
Serialization or deserialization failed at the FFI boundary. This indicates a bug in the generated shims or a type mismatch. |
STATUS_PLUGIN_ERROR |
i32 |
-3 |
The plugin method returned an error. The output buffer contains a serialized PluginError with details. |
STATUS_PANIC |
i32 |
-4 |
A panic was caught at the extern "C" boundary via catch_unwind. The output buffer may contain a panic message string, but this is not guaranteed. |
STATUS_STREAM_END |
i32 |
-5 |
Clean end of a server-stream: the streaming next() shim has no more items (FIDIUS-I-0026 / FIDIUS-T-0138). Distinct from STATUS_OK with out_len == 0, which is a real zero-byte item (e.g. a unit () item). |
STATUS_INVALID_INDEX |
i32 |
-6 |
The callee has no function at the requested dispatch index. Returned by a host-function table’s dispatch (plugin → host callback channel) for an out-of-range index. Cannot occur through generated clients once the bind-time version/hash gate has passed. |