diff --git a/examples/1_minimal/reowolf.h b/examples/1_minimal/reowolf.h deleted file mode 100644 index 6e3265959b91d5f09b2b26c6c11cd9484eacfd07..0000000000000000000000000000000000000000 --- a/examples/1_minimal/reowolf.h +++ /dev/null @@ -1,146 +0,0 @@ -/* CBindgen generated */ - -#ifndef REOWOLF_HEADER_DEFINED -#define REOWOLF_HEADER_DEFINED - -#include -#include -#include -#include - -typedef enum { - Active, - Passive, -} EndpointPolarity; - -typedef enum { - Putter, - Getter, -} Polarity; - -typedef struct Arc_ProtocolDescription Arc_ProtocolDescription; - -typedef struct Connector Connector; - -typedef struct Payload Payload; - -typedef int32_t ErrorCode; - -typedef uint32_t ConnectorId; - -typedef uint32_t PortSuffix; - -typedef struct { - ConnectorId connector_id; - PortSuffix u32_suffix; -} PortId; - -/** - * Given - * - an initialized connector in setup or connecting state, - * - a string slice for the component's identifier in the connector's configured protocol description, - * - a set of ports (represented as a slice; duplicates are ignored) in the native component's interface, - * the connector creates a new (internal) protocol component C, such that the set of native ports are moved to C. - * Usable in {setup, communication} states. - */ -ErrorCode connector_add_component(Connector *connector, - const uint8_t *ident_ptr, - uintptr_t ident_len, - const PortId *ports_ptr, - uintptr_t ports_len); - -/** - * Given - * - an initialized connector in setup or connecting state, - * - a utf-8 encoded socket address, - * - the logical polarity of P, - * - the "physical" polarity in {Active, Passive} of the endpoint through which P's peer will be discovered, - * returns P, a port newly added to the native interface. - */ -ErrorCode connector_add_net_port(Connector *connector, - const uint8_t *addr_str_ptr, - uintptr_t addr_str_len, - Polarity port_polarity, - EndpointPolarity endpoint_polarity, - PortId *port); - -/** - * Given an initialized connector in setup or connecting state, - * - Creates a new directed port pair with logical channel putter->getter, - * - adds the ports to the native component's interface, - * - and returns them using the given out pointers. - * Usable in {setup, communication} states. - */ -void connector_add_port_pair(Connector *connector, PortId *out_putter, PortId *out_getter); - -/** - * Connects this connector to the distributed system of connectors reachable through endpoints, - * Usable in setup state, and changes the state to communication. - */ -ErrorCode connector_connect(Connector *connector, int64_t timeout_millis); - -/** - * Destroys the given a pointer to the connector on the heap, freeing its resources. - * Usable in {setup, communication} states. - */ -void connector_destroy(Connector *connector); - -ErrorCode connector_get(Connector *connector, PortId port); - -const uint8_t *connector_gotten_bytes(Connector *connector, PortId port, uintptr_t *len); - -/** - * Allocates a new connector on the heap and returning a pointer, - * given an initialized protocol description. - */ -Connector *connector_new(const Arc_ProtocolDescription *pd); - -/** - * Initializes `out` with a new connector using the given protocol description as its configuration. - * The connector uses the given (internal) connector ID. - */ -Connector *connector_new_with_id(const Arc_ProtocolDescription *pd, ConnectorId cid); - -intptr_t connector_next_batch(Connector *connector); - -/** - * Convenience function combining the functionalities of - * "payload_new" with "connector_put_payload". - */ -ErrorCode connector_put_bytes(Connector *connector, - PortId port, - const uint8_t *bytes_ptr, - uintptr_t bytes_len); - -ErrorCode connector_put_payload(Connector *connector, PortId port, Payload *payload); - -ErrorCode connector_put_payload_cloning(Connector *connector, PortId port, const Payload *payload); - -intptr_t connector_sync(Connector *connector, int64_t timeout_millis); - -/** - * Given an initialized protocol description, initializes `out` with a clone which can be independently created or destroyed. - */ -Arc_ProtocolDescription *protocol_description_clone(const Arc_ProtocolDescription *pd); - -/** - * Destroys the given initialized protocol description and frees its resources. - */ -void protocol_description_destroy(Arc_ProtocolDescription *pd); - -/** - * Parses the utf8-encoded string slice to initialize a new protocol description object. - * - On success, initializes `out` and returns 0 - * - On failure, stores an error string (see `reowolf_error_peek`) and returns -1 - */ -Arc_ProtocolDescription *protocol_description_parse(const uint8_t *pdl, uintptr_t pdl_len); - -/** - * Returns length (via out pointer) and pointer (via return value) of the last Reowolf error. - * - pointer is NULL iff there was no last error - * - data at pointer is null-delimited - * - len does NOT include the length of the null-delimiter - */ -const uint8_t *reowolf_error_peek(uintptr_t *len); - -#endif /* REOWOLF_HEADER_DEFINED */