ascii-chat
Binary v0.16.50-198-g78f51665f
Library lib/v0.3.2-2240-g78f51665f
Video chat in your terminal
Loading...
Searching...
No Matches
acds_handlers.c
Go to the documentation of this file.
1
11
18#include <ascii-chat/log/log.h>
20#include <ascii-chat/common.h>
22#include <string.h>
24
25// =============================================================================
26// ACDS Handler Function Types and Hash Table
27// =============================================================================
28
29// ACDS handler function signature
30typedef asciichat_error_t (*acip_acds_handler_func_t)(const void *payload, size_t payload_len, acip_transport_t *transport, const char *client_ip, const acip_acds_callbacks_t *callbacks);
31
32// Hash table for O(1) packet dispatch
33#define ACDS_HASH_SIZE 32
34#define ACDS_HANDLER_COUNT 11
35
44
45#define ACDS_HASH(type) ((type) % ACDS_HASH_SIZE)
46
47static inline int acds_handler_hash_lookup(const acds_hash_entry_t *table, packet_type_t type) {
48 uint32_t h = ACDS_HASH(type);
49 for (int i = 0; i < ACDS_HASH_SIZE; i++) {
50 uint32_t slot = (h + i) % ACDS_HASH_SIZE;
51 if (table[slot].key == 0)
52 return -1;
53 if (table[slot].key == type)
54 return table[slot].handler_idx;
55 }
56 return -1;
57}
58
59// =============================================================================
60// Forward Declarations
61// =============================================================================
62
63static asciichat_error_t handle_acds_session_create(const void *payload, size_t payload_len, acip_transport_t *transport, const char *client_ip, const acip_acds_callbacks_t *callbacks);
64static asciichat_error_t handle_acds_session_lookup(const void *payload, size_t payload_len, acip_transport_t *transport, const char *client_ip, const acip_acds_callbacks_t *callbacks);
65static asciichat_error_t handle_acds_session_join(const void *payload, size_t payload_len, acip_transport_t *transport, const char *client_ip, const acip_acds_callbacks_t *callbacks);
66static asciichat_error_t handle_acds_session_leave(const void *payload, size_t payload_len, acip_transport_t *transport, const char *client_ip, const acip_acds_callbacks_t *callbacks);
67static asciichat_error_t handle_acds_webrtc_sdp(const void *payload, size_t payload_len, acip_transport_t *transport, const char *client_ip, const acip_acds_callbacks_t *callbacks);
68static asciichat_error_t handle_acds_webrtc_ice(const void *payload, size_t payload_len, acip_transport_t *transport, const char *client_ip, const acip_acds_callbacks_t *callbacks);
69static asciichat_error_t handle_acds_ping(const void *payload, size_t payload_len, acip_transport_t *transport, const char *client_ip, const acip_acds_callbacks_t *callbacks);
70static asciichat_error_t handle_acds_pong(const void *payload, size_t payload_len, acip_transport_t *transport, const char *client_ip, const acip_acds_callbacks_t *callbacks);
71static asciichat_error_t handle_acds_host_announcement(const void *payload, size_t payload_len, acip_transport_t *transport, const char *client_ip, const acip_acds_callbacks_t *callbacks);
72static asciichat_error_t handle_acds_host_lost(const void *payload, size_t payload_len, acip_transport_t *transport, const char *client_ip, const acip_acds_callbacks_t *callbacks);
73static asciichat_error_t handle_acds_network_quality(const void *payload, size_t payload_len, acip_transport_t *transport, const char *client_ip, const acip_acds_callbacks_t *callbacks);
74
75// ACDS handler dispatch table
76static const acip_acds_handler_func_t g_acds_handlers[ACDS_HANDLER_COUNT] = {
77 handle_acds_ping, // 0
78 handle_acds_pong, // 1
79 handle_acds_session_create, // 2
80 handle_acds_session_lookup, // 3
81 handle_acds_session_join, // 4
82 handle_acds_session_leave, // 5
83 handle_acds_webrtc_sdp, // 6
84 handle_acds_webrtc_ice, // 7
85 handle_acds_host_announcement, // 8
86 handle_acds_host_lost, // 9
87 handle_acds_network_quality, // 10
88};
89
90// ACDS packet type -> handler index hash table
91// clang-format off
92static const acds_hash_entry_t g_acds_handler_hash[ACDS_HASH_SIZE] = {
93 [9] = {PACKET_TYPE_PING, 0}, // hash(5001)=9
94 [10] = {PACKET_TYPE_PONG, 1}, // hash(5002)=10
95 [13] = {PACKET_TYPE_ACIP_HOST_ANNOUNCEMENT, 8}, // hash(6061)=13
96 [16] = {PACKET_TYPE_ACIP_SESSION_CREATE, 2}, // hash(6000)=16
97 [17] = {PACKET_TYPE_ACIP_HOST_LOST, 9}, // hash(6065)=17
98 [18] = {PACKET_TYPE_ACIP_SESSION_LOOKUP, 3}, // hash(6002)=18
99 [20] = {PACKET_TYPE_ACIP_SESSION_JOIN, 4}, // hash(6004)=20
100 [22] = {PACKET_TYPE_ACIP_SESSION_LEAVE, 5}, // hash(6006)=22
101 [25] = {PACKET_TYPE_ACIP_WEBRTC_SDP, 6}, // hash(6009)=25
102 [26] = {PACKET_TYPE_ACIP_WEBRTC_ICE, 7}, // hash(6010)=26
103 [28] = {PACKET_TYPE_ACIP_NETWORK_QUALITY, 10}, // hash(6060)=28
104};
105// clang-format on
106
107// =============================================================================
108// Public API
109// =============================================================================
110
111asciichat_error_t acip_handle_acds_packet(acip_transport_t *transport, packet_type_t type, const void *payload, size_t payload_len, const char *client_ip, const acip_acds_callbacks_t *callbacks) {
112 stats_runtime_packet(transport ? transport->stats_peer : NULL, type, payload_len, false, true);
113 if (!callbacks) {
114 return SET_ERRNO(ERROR_INVALID_PARAM, "Invalid callbacks");
115 }
116
118 log_debug_every(US_PER_SEC_INT, "★ ACIP_HANDLE_ACDS_PACKET: Dispatching type=%u (NETWORK_QUALITY) from %s, payload_len=%zu", type, client_ip, payload_len);
119 }
120
121 if ((unsigned)type == CONSENSUS_HANDOFF_PACKET) {
122 if (!callbacks->on_handoff)
123 return SET_ERRNO(ERROR_INVALID_STATE, "Handoff unsupported");
124 return callbacks->on_handoff(payload, payload_len, transport, callbacks->app_ctx);
125 }
126
127 // O(1) dispatch via hash table lookup
128 int idx = acds_handler_hash_lookup(g_acds_handler_hash, type);
129 if (idx < 0) {
130 return SET_ERRNO(ERROR_INVALID_PARAM, "Unhandled ACDS packet type: %d from %s", type, client_ip);
131 }
132
134 log_debug_every(US_PER_SEC_INT, "★ ACIP_HANDLE_ACDS_PACKET: Found handler at index=%d", idx);
135 }
136
137 uint64_t stats_start = time_get_ns();
138 asciichat_error_t result = g_acds_handlers[idx](payload, payload_len, transport, client_ip, callbacks);
140 if (result != ASCIICHAT_OK)
142 return result;
143}
144
145// =============================================================================
146// ACDS Handler Implementations
147// =============================================================================
148
149static asciichat_error_t handle_acds_session_create(const void *payload, size_t payload_len, acip_transport_t *transport, const char *client_ip, const acip_acds_callbacks_t *callbacks) {
150 if (!callbacks->on_session_create) {
151 return ASCIICHAT_OK;
152 }
153
154 if (payload_len < sizeof(acip_session_create_t)) {
155 return SET_ERRNO(ERROR_INVALID_PARAM, "SESSION_CREATE payload too small from %s", client_ip);
156 }
157
158 const acip_session_create_t *req = (const acip_session_create_t *)payload;
159
160 if (req->reserved_string_len >= ACIP_MAX_SESSION_STRING_LEN || payload_len < sizeof(*req) + req->reserved_string_len || !memchr(req->server_address, '\0', sizeof(req->server_address)) ||
161 (req->has_password && !memchr(req->password_hash, '\0', sizeof(req->password_hash))))
162 return SET_ERRNO(ERROR_INVALID_PARAM, "Malformed SESSION_CREATE payload");
163
164 if (req->total_keys > MAX_SESSION_KEYS || req->key_index >= (req->total_keys ? req->total_keys : 1))
165 return SET_ERRNO(ERROR_INVALID_PARAM, "Invalid session key count/index");
166
167 // Multi-key protocol: validate parameters only for first key (key_index == 0)
168 // total_keys > 0 indicates multi-key mode; skip validation for subsequent keys
169 if (req->key_index == 0 || req->total_keys == 0) {
170 // Validate session parameters for first key or single-key mode
171 if (req->max_participants == 0 || req->max_participants > MAX_SESSION_PARTICIPANTS) {
172 return SET_ERRNO(ERROR_INVALID_PARAM, "Invalid max_participants: %u from %s (expected: 1-%d)", req->max_participants, client_ip, MAX_SESSION_PARTICIPANTS);
173 }
174
175 if (req->session_type > 1) {
176 return SET_ERRNO(ERROR_INVALID_PARAM, "Invalid session_type: %u from %s (expected: 0=DIRECT_TCP or 1=WEBRTC)", req->session_type, client_ip);
177 }
178
179 // Validate server port (0 = system assigned, 1-65535 = valid)
180 // Allow 0 for auto-assignment during WEBRTC mode
181 if (req->session_type == 0 && req->server_port == 0) {
182 return SET_ERRNO(ERROR_INVALID_PARAM, "DIRECT_TCP session requires valid server_port from %s", client_ip);
183 }
184 }
185
186 size_t base_length = sizeof(*req) + req->reserved_string_len;
187 const uint8_t *extension = (const uint8_t *)payload + base_length;
188 size_t extension_length = payload_len - base_length;
189 if (extension_length) {
190 if (extension_length < 10 || memcmp(extension, "ACQT", sizeof("ACQT") - 1) || extension[4] != 1 || extension[5])
191 return SET_ERRNO(ERROR_INVALID_PARAM, "Invalid discovery transport extension");
192 size_t url_length = ((size_t)extension[8] << 8) | extension[9];
193 if (url_length >= 512 || extension_length != 10 + url_length ||
194 (url_length && (url_length < 9 || memcmp(extension + 10, "https://", sizeof("https://") - 1) || memchr(extension + 10, 0, url_length))))
195 return SET_ERRNO(ERROR_INVALID_PARAM, "Invalid discovery WebTransport endpoint");
196 }
197 callbacks->on_session_create(req, transport, client_ip, extension, extension_length, callbacks->app_ctx);
198 return ASCIICHAT_OK;
199}
200
201static asciichat_error_t handle_acds_session_lookup(const void *payload, size_t payload_len, acip_transport_t *transport, const char *client_ip, const acip_acds_callbacks_t *callbacks) {
202 if (!callbacks->on_session_lookup) {
203 return ASCIICHAT_OK;
204 }
205
206 if (payload_len < sizeof(acip_session_lookup_t)) {
207 return SET_ERRNO(ERROR_INVALID_PARAM, "SESSION_LOOKUP payload too small from %s", client_ip);
208 }
209
210 const acip_session_lookup_t *req = (const acip_session_lookup_t *)payload;
211 callbacks->on_session_lookup(req, transport, client_ip, callbacks->app_ctx);
212 return ASCIICHAT_OK;
213}
214
215static asciichat_error_t handle_acds_session_join(const void *payload, size_t payload_len, acip_transport_t *transport, const char *client_ip, const acip_acds_callbacks_t *callbacks) {
216 if (!callbacks->on_session_join) {
217 return ASCIICHAT_OK;
218 }
219
220 if (payload_len < sizeof(acip_session_join_t)) {
221 return SET_ERRNO(ERROR_INVALID_PARAM, "SESSION_JOIN payload too small from %s", client_ip);
222 }
223
224 const acip_session_join_t *req = (const acip_session_join_t *)payload;
225 callbacks->on_session_join(req, transport, client_ip, callbacks->app_ctx);
226 return ASCIICHAT_OK;
227}
228
229static asciichat_error_t handle_acds_session_leave(const void *payload, size_t payload_len, acip_transport_t *transport, const char *client_ip, const acip_acds_callbacks_t *callbacks) {
230 if (!callbacks->on_session_leave) {
231 return ASCIICHAT_OK;
232 }
233
234 if (payload_len < sizeof(acip_session_leave_t)) {
235 return SET_ERRNO(ERROR_INVALID_PARAM, "SESSION_LEAVE payload too small from %s", client_ip);
236 }
237
238 const acip_session_leave_t *req = (const acip_session_leave_t *)payload;
239 callbacks->on_session_leave(req, transport, client_ip, callbacks->app_ctx);
240 return ASCIICHAT_OK;
241}
242
243static asciichat_error_t handle_acds_webrtc_sdp(const void *payload, size_t payload_len, acip_transport_t *transport, const char *client_ip, const acip_acds_callbacks_t *callbacks) {
244 if (!callbacks->on_webrtc_sdp) {
245 return ASCIICHAT_OK;
246 }
247
248 if (payload_len < sizeof(acip_webrtc_sdp_t)) {
249 return SET_ERRNO(ERROR_INVALID_PARAM, "WEBRTC_SDP payload too small from %s", client_ip);
250 }
251
252 const acip_webrtc_sdp_t *sdp = (const acip_webrtc_sdp_t *)payload;
253
254 // Validate sdp_len against actual payload size (convert from network byte order)
255 uint16_t sdp_len_host = NET_TO_HOST_U16(sdp->sdp_len);
256 size_t expected_size = sizeof(acip_webrtc_sdp_t) + sdp_len_host;
257 if (expected_size > payload_len) {
258 return SET_ERRNO(ERROR_INVALID_PARAM, "WEBRTC_SDP size mismatch from %s: claims %u bytes but payload is %zu", client_ip, sdp_len_host, payload_len);
259 }
260
261 callbacks->on_webrtc_sdp(sdp, payload_len, transport, client_ip, callbacks->app_ctx);
262 return ASCIICHAT_OK;
263}
264
265static asciichat_error_t handle_acds_webrtc_ice(const void *payload, size_t payload_len, acip_transport_t *transport, const char *client_ip, const acip_acds_callbacks_t *callbacks) {
266 if (!callbacks->on_webrtc_ice) {
267 return ASCIICHAT_OK;
268 }
269
270 if (payload_len < sizeof(acip_webrtc_ice_t)) {
271 return SET_ERRNO(ERROR_INVALID_PARAM, "WEBRTC_ICE payload too small from %s", client_ip);
272 }
273
274 const acip_webrtc_ice_t *ice = (const acip_webrtc_ice_t *)payload;
275
276 // Validate candidate_len against actual payload size (convert from network byte order)
277 uint16_t candidate_len_host = NET_TO_HOST_U16(ice->candidate_len);
278 size_t expected_size = sizeof(acip_webrtc_ice_t) + candidate_len_host;
279 if (expected_size > payload_len) {
280 return SET_ERRNO(ERROR_INVALID_PARAM, "WEBRTC_ICE size mismatch from %s: claims %u bytes but payload is %zu", client_ip, candidate_len_host, payload_len);
281 }
282
283 callbacks->on_webrtc_ice(ice, payload_len, transport, client_ip, callbacks->app_ctx);
284 return ASCIICHAT_OK;
285}
286
287// Keepalive handlers for PING/PONG packets
288static asciichat_error_t handle_acds_ping(const void *payload, size_t payload_len, acip_transport_t *transport, const char *client_ip, const acip_acds_callbacks_t *callbacks) {
289 (void)payload;
290 (void)payload_len;
291 (void)transport;
292 (void)callbacks;
293
294 log_debug("★ PING received from %s", client_ip);
295 // Simply acknowledge (log only) - client expects us to respond naturally
296 return ASCIICHAT_OK;
297}
298
299static asciichat_error_t handle_acds_pong(const void *payload, size_t payload_len, acip_transport_t *transport, const char *client_ip, const acip_acds_callbacks_t *callbacks) {
300 (void)payload;
301 (void)payload_len;
302 (void)transport;
303 (void)callbacks;
304
305 log_debug("★ PONG received from %s (heartbeat OK)", client_ip);
306 // Simply acknowledge (log only) - used for timeout/heartbeat detection
307 return ASCIICHAT_OK;
308}
309
310static asciichat_error_t handle_acds_host_announcement(const void *payload, size_t payload_len, acip_transport_t *transport, const char *client_ip, const acip_acds_callbacks_t *callbacks) {
311 if (!callbacks->on_host_announcement && !callbacks->on_host_announcement_ex)
312 return ASCIICHAT_OK;
313 if (payload_len < sizeof(acip_host_announcement_t))
314 return SET_ERRNO(ERROR_INVALID_PARAM, "HOST_ANNOUNCEMENT payload size mismatch from %s", client_ip);
315 const acip_host_announcement_t *announcement = payload;
316 const uint8_t *metadata = (const uint8_t *)payload + sizeof(*announcement);
317 size_t metadata_length = payload_len - sizeof(*announcement);
318 uint16_t port;
319 char url[512];
320 if (acds_transport_metadata_decode(metadata, metadata_length, &port, url, sizeof(url)) != ASCIICHAT_OK)
321 return SET_ERRNO(ERROR_INVALID_PARAM, "Invalid host transport metadata from %s", client_ip);
322 if (callbacks->on_host_announcement_ex)
323 callbacks->on_host_announcement_ex(announcement, metadata, metadata_length, transport, client_ip, callbacks->app_ctx);
324 else
325 callbacks->on_host_announcement(announcement, transport, client_ip, callbacks->app_ctx);
326 return ASCIICHAT_OK;
327}
328
329static asciichat_error_t handle_acds_host_lost(const void *payload, size_t payload_len, acip_transport_t *transport, const char *client_ip, const acip_acds_callbacks_t *callbacks) {
330 if (!callbacks->on_host_lost) {
331 return ASCIICHAT_OK;
332 }
333
334 if (payload_len < sizeof(acip_host_lost_t)) {
335 return SET_ERRNO(ERROR_INVALID_PARAM, "HOST_LOST payload too small from %s", client_ip);
336 }
337
338 const acip_host_lost_t *host_lost = (const acip_host_lost_t *)payload;
339 callbacks->on_host_lost(host_lost, transport, client_ip, callbacks->app_ctx);
340 return ASCIICHAT_OK;
341}
342
343static asciichat_error_t handle_acds_network_quality(const void *payload, size_t payload_len, acip_transport_t *transport, const char *client_ip, const acip_acds_callbacks_t *callbacks) {
344 if (!callbacks->on_network_quality) {
345 return ASCIICHAT_OK;
346 }
347
348 if (payload_len < sizeof(acip_nat_quality_t)) {
349 return SET_ERRNO(ERROR_INVALID_PARAM, "NETWORK_QUALITY payload too small from %s", client_ip);
350 }
351
352 callbacks->on_network_quality(payload, payload_len, transport, client_ip, callbacks->app_ctx);
353 return ASCIICHAT_OK;
354}
asciichat_error_t acds_transport_metadata_decode(const void *data, size_t length, uint16_t *port, char *url, size_t capacity)
ACIP client-side protocol library and ACDS client connection API.
asciichat_error_t acip_handle_acds_packet(acip_transport_t *transport, packet_type_t type, const void *payload, size_t payload_len, const char *client_ip, const acip_acds_callbacks_t *callbacks)
ACDS packet handler callbacks.
#define ACDS_HANDLER_COUNT
#define ACDS_HASH_SIZE
#define ACDS_HASH(type)
asciichat_error_t(* acip_acds_handler_func_t)(const void *payload, size_t payload_len, acip_transport_t *transport, const char *client_ip, const acip_acds_callbacks_t *callbacks)
ACIP Discovery Server (ACDS) packet handlers.
#define ACIP_MAX_SESSION_STRING_LEN
Definition acds_sizes.h:10
Synchronized per-thread pending error stacks and value snapshots. SET_ERRNO pushes,...
#define SET_ERRNO(code,...)
🔄 Network byte order conversion helpers
#define NET_TO_HOST_U16(val)
Definition endian.h:115
unsigned short uint16_t
unsigned int uint32_t
unsigned long long uint64_t
unsigned char uint8_t
asciichat_error_t
Error and exit codes - unified status values (0-255).
Definition error_codes.h:48
@ ERROR_INVALID_STATE
@ ASCIICHAT_OK
Definition error_codes.h:50
@ ERROR_INVALID_PARAM
#define MAX_SESSION_PARTICIPANTS
#define MAX_SESSION_KEYS
#define log_debug(...)
Log a DEBUG message.
Definition log/log.h:589
acip_session_join_t
Definition acds.h:408
acip_session_lookup_t
Definition acds.h:309
acip_webrtc_ice_t
Definition acds.h:655
acip_host_lost_t
Definition acds.h:961
acip_host_announcement_t
Definition acds.h:917
acip_webrtc_sdp_t
Definition acds.h:609
acip_session_create_t
Definition acds.h:226
acip_session_leave_t
Definition acds.h:529
acip_nat_quality_t
Definition acds.h:896
#define US_PER_SEC_INT
Definition time.h:177
packet_type_t
Network protocol packet type enumeration.
Definition packet.h:315
@ PACKET_TYPE_ACIP_WEBRTC_ICE
WebRTC ICE candidate (bidirectional).
Definition packet.h:466
@ PACKET_TYPE_PONG
Keepalive pong response.
Definition packet.h:423
@ PACKET_TYPE_ACIP_NETWORK_QUALITY
NETWORK_QUALITY exchange (unified packet for all quality metrics).
Definition packet.h:493
@ PACKET_TYPE_ACIP_HOST_LOST
Host lost notification - lightweight (Participant -> ACDS).
Definition packet.h:503
@ PACKET_TYPE_ACIP_HOST_ANNOUNCEMENT
Host announcement (Participant -> ACDS, "I won negotiation").
Definition packet.h:495
@ PACKET_TYPE_ACIP_SESSION_CREATE
Create new session (Client -> Discovery Server).
Definition packet.h:445
@ PACKET_TYPE_ACIP_SESSION_LOOKUP
Lookup session by string (Client -> Discovery Server).
Definition packet.h:449
@ PACKET_TYPE_ACIP_SESSION_LEAVE
Leave session (Client -> Discovery Server).
Definition packet.h:457
@ PACKET_TYPE_ACIP_WEBRTC_SDP
WebRTC SDP offer/answer (bidirectional).
Definition packet.h:464
@ PACKET_TYPE_ACIP_SESSION_JOIN
Join existing session (Client -> Discovery Server).
Definition packet.h:453
@ PACKET_TYPE_PING
Keepalive ping packet.
Definition packet.h:421
struct acip_transport acip_transport_t
Forward declaration of ACIP transport.
Definition host.h:508
#define CONSENSUS_HANDOFF_PACKET
Definition handoff.h:13
⚙️ Common definitions, error codes, macros, and types shared throughout the application
Transport abstraction layer for ACIP protocol.
void stats_counter_add(stats_scope_t *scope, stats_counter_id_t id, uint64_t amount)
void stats_duration_record(stats_scope_t *scope, stats_duration_id_t id, uint64_t elapsed_ns)
📝 Logging API with multiple log levels and terminal output control
#define log_debug_every(interval_us, fmt,...)
Rate-limited DEBUG logging.
Definition log/log.h:743
ACIP protocol message structures and helpers.
void stats_runtime_packet(stats_peer_t *peer, unsigned type, size_t payload_bytes, bool sent, bool success)
Definition runtime.c:192
stats_scope_t * stats_runtime_scope(void)
Definition runtime.c:78
ACIP shared/bidirectional packet sending functions.
🔤 String Manipulation and Shell Escaping Utilities
Hash table entry for ACDS packet type to handler mapping.
packet_type_t key
Packet type (0 = empty slot).
uint8_t handler_idx
Handler index (0-based).
ACDS packet handler callbacks.
void(* on_webrtc_sdp)(const acip_webrtc_sdp_t *sdp, size_t payload_len, acip_transport_t *transport, const char *client_ip, void *app_ctx)
Called when client sends WebRTC SDP offer/answer.
void(* on_webrtc_ice)(const acip_webrtc_ice_t *ice, size_t payload_len, acip_transport_t *transport, const char *client_ip, void *app_ctx)
Called when client sends WebRTC ICE candidate.
void(* on_session_join)(const acip_session_join_t *req, acip_transport_t *transport, const char *client_ip, void *app_ctx)
Called when client joins a session.
void(* on_network_quality)(const void *payload, size_t payload_len, acip_transport_t *transport, const char *client_ip, void *app_ctx)
Called when client sends NAT network quality for negotiation (discovery mode).
void(* on_host_announcement)(const acip_host_announcement_t *announcement, acip_transport_t *transport, const char *client_ip, void *app_ctx)
Called when client announces they are hosting (discovery mode).
void(* on_session_lookup)(const acip_session_lookup_t *req, acip_transport_t *transport, const char *client_ip, void *app_ctx)
Called when client looks up session info.
void * app_ctx
Application context (passed to all callbacks).
asciichat_error_t(* on_handoff)(const void *, size_t, acip_transport_t *, void *)
void(* on_host_announcement_ex)(const acip_host_announcement_t *announcement, const void *metadata, size_t metadata_length, acip_transport_t *transport, const char *client_ip, void *app_ctx)
void(* on_session_leave)(const acip_session_leave_t *req, acip_transport_t *transport, const char *client_ip, void *app_ctx)
Called when client leaves a session.
void(* on_host_lost)(const acip_host_lost_t *host_lost, acip_transport_t *transport, const char *client_ip, void *app_ctx)
Called when participant reports host has disconnected (discovery mode).
void(* on_session_create)(const acip_session_create_t *req, acip_transport_t *transport, const char *client_ip, const uint8_t *extension, size_t extension_length, void *app_ctx)
Called when client requests session creation.
stats_peer_t * stats_peer
Owned statistics handle, destroyed with transport.