acds_client_config_t Struct Reference

acds client config is intentionally a small, concrete record. Fields such as server_port, timeout_ms, security_policy, identity_key give callers the identity and current value they need. It is normally borrowed from, or owned by, the surrounding subsystem—not independently managed. More...

#include <include/ascii-chat/network/acip/acds_client.h>

Data Fields
char	server_address [256]
	ACDS server address (e.g., "discovery.ascii.chat" or "127.0.0.1").
uint16_t	server_port
	ACDS server port (default: 27225).
uint32_t	timeout_ms
	Connection timeout in milliseconds.
crypto_policy_t	security_policy
	Signaling policy, independent of peer media policy.
const char *	identity_key
	Optional private identity key path, borrowed during connect.
parallel_connect_should_exit_fn	should_exit_callback
void *	callback_data

Detailed Description

acds client config is intentionally a small, concrete record. Fields such as server_port, timeout_ms, security_policy, identity_key give callers the identity and current value they need. It is normally borrowed from, or owned by, the surrounding subsystem—not independently managed.

acds client keeps the values that move through the subsystem: Config Module, connected, transport, connection. Some members are pointers into caller- or subsystem-owned memory, so lifetime follows the API that populated them rather than the struct copy itself.

Session creation request parameters

Values returned after ACDS creates a session. The expiry timestamp tells the caller how long the discovery record remains valid; the identifier and endpoint details are copied into connection state before this temporary result is released.

Session join parameters

Outcome of an ACDS join request. success controls whether the session type, server port, and error fields are meaningful; callers inspect the response, copy endpoint details they need, and discard the temporary result.

Result returned by ACDS for a session-string lookup. found gates the remaining fields; capabilities, participant counts, password/verification requirements, and creation/expiry timestamps describe the session a client may join.

ACDS client connection configuration

Definition at line 147 of file acds_client.h.

Field Documentation

callback_data

void* acds_client_config_t::callback_data

Definition at line 156 of file acds_client.h.

Referenced by acds_client_connect().

identity_key

const char* acds_client_config_t::identity_key

Optional private identity key path, borrowed during connect.

Definition at line 152 of file acds_client.h.

Referenced by client_crypto_init().

security_policy

crypto_policy_t acds_client_config_t::security_policy

Signaling policy, independent of peer media policy.

Definition at line 151 of file acds_client.h.

server_address

char acds_client_config_t::server_address[256]

ACDS server address (e.g., "discovery.ascii.chat" or "127.0.0.1").

Definition at line 148 of file acds_client.h.

Referenced by acds_client_config_init_defaults(), acds_client_connect(), and client_crypto_init().

server_port

uint16_t acds_client_config_t::server_port

ACDS server port (default: 27225).

Definition at line 149 of file acds_client.h.

Referenced by acds_client_config_init_defaults(), acds_client_connect(), and client_crypto_init().

should_exit_callback

parallel_connect_should_exit_fn acds_client_config_t::should_exit_callback

Definition at line 155 of file acds_client.h.

Referenced by acds_client_connect().

timeout_ms

uint32_t acds_client_config_t::timeout_ms

Connection timeout in milliseconds.

Definition at line 150 of file acds_client.h.

Referenced by acds_client_config_init_defaults(), acds_client_connect(), and client_crypto_init().

---

The documentation for this struct was generated from the following file:

• acds_client.h