Expand description
Exposed C APIs for arti-rpc-client-core.
See top-level documentation in header file for C conventions that affect the safety of these functions. (These include things like “all input pointers must be valid” and so on.)
Modules§
- err
- Error handling logic for our ffi code.
Structs§
- Arti
RpcConn Builder - A builder object used to configure and construct a connection to Arti over the RPC protocol.
- Arti
RpcRaw Socket - The type of a data stream socket.
(This is always
int
on Unix-like platforms, and SOCKET on Windows.)
Constants§
- ARTI_
RPC_ BUILDER_ ENTRY_ EXPANDABLE_ PATH - Constant to denote a path in which Arti configuration variables are expanded.
- ARTI_
RPC_ BUILDER_ ENTRY_ LITERAL_ CONNECT_ POINT - Constant to denote a literal connect point.
- ARTI_
RPC_ BUILDER_ ENTRY_ LITERAL_ PATH - Constant to denote a literal path that is not expanded.
- ARTI_
RPC_ RESPONSE_ TYPE_ ERROR - A constant indicating that a message is a final error.
- ARTI_
RPC_ RESPONSE_ TYPE_ RESULT - A constant indicating that a message is a final result.
- ARTI_
RPC_ RESPONSE_ TYPE_ UPDATE - A constant indicating that a message is a non-final update.
Functions§
- arti_
rpc_ ⚠conn_ builder_ connect - Use
builder
to open a new RPC connection to Arti. - arti_
rpc_ ⚠conn_ builder_ free - Release storage held by an
ArtiRpcConnBuilder
. - arti_
rpc_ ⚠conn_ builder_ new - Try to create a new
ArtiRpcConnBuilder
, with default settings. - arti_
rpc_ ⚠conn_ builder_ prepend_ entry - Prepend a single entry to the connection point path in
builder
. - arti_
rpc_ ⚠conn_ cancel_ handle - Attempt to cancel the request on
rpc_conn
with the providedhandle
. - arti_
rpc_ ⚠conn_ execute - Run an RPC request over
rpc_conn
and wait for a successful response. - arti_
rpc_ ⚠conn_ execute_ with_ handle - Send an RPC request over
rpc_conn
, and return a handle that can wait for a successful response. - arti_
rpc_ ⚠conn_ free - Close and free an open Arti RPC connection.
- arti_
rpc_ ⚠conn_ get_ session_ id - Given a pointer to an RPC connection, return the object ID for its negotiated session.
- arti_
rpc_ ⚠conn_ open_ stream - Try to open an anonymized data stream over Arti.
- arti_
rpc_ ⚠handle_ free - Release storage held by an
ArtiRpcHandle
. - arti_
rpc_ ⚠handle_ wait - Wait until some response arrives on an arti_rpc_handle, or until an error occurs.
- arti_
rpc_ ⚠str_ free - Free a string returned by the Arti RPC API.
- arti_
rpc_ ⚠str_ get - Return a const pointer to the underlying nul-terminated string from an
ArtiRpcStr
.
Type Aliases§
- Arti
RpcBuilder Entry Type - The type of an entry prepended to a connect point search path.
- Arti
RpcConn - An open connection to Arti over an a RPC protocol.
- Arti
RpcHandle - A handle to an in-progress RPC request.
- Arti
RpcResponse Type - The type of a message returned by an RPC request.
- Arti
RpcStatus - A status code returned by an Arti RPC function.
- Arti
RpcStr - An owned string, returned by this library.