acds_handlers.h File Reference

ACIP Discovery Server (ACDS) packet handlers. More...

Go to the source code of this file.

Data Structures
struct	acip_acds_callbacks_t
	ACDS packet handler callbacks. More...

Functions
asciichat_error_t	acip_handle_acds_packet (acip_transport_t *transport, packet_type_t type, const void *payload, size_t payload_len, int client_socket, const char *client_ip, const acip_acds_callbacks_t *callbacks)
	Handle incoming ACDS packet with O(1) dispatch.

Detailed Description

ACIP Discovery Server (ACDS) packet handlers.

Provides O(1) array-based packet dispatching for ASCII Chat Discovery Server. Handles session management, WebRTC signaling, and discovery protocol packets.

Author

Zachary Fogg me@zf.nosp@m.o.gg

Date

January 2026

Definition in file acds_handlers.h.

Function Documentation

acip_handle_acds_packet()

asciichat_error_t acip_handle_acds_packet	(	acip_transport_t *	transport,
		packet_type_t	type,
		const void *	payload,
		size_t	payload_len,
		int	client_socket,
		const char *	client_ip,
		const acip_acds_callbacks_t *	callbacks
	)

Handle incoming ACDS packet with O(1) dispatch.

Dispatches packet to appropriate callback based on type. Uses array-based lookup for constant-time handler selection.

Parameters

transport	Transport instance (unused, for API consistency)
type	Packet type
payload	Packet payload
payload_len	Payload length
client_socket	Client socket file descriptor
client_ip	Client IP address string
callbacks	Application callbacks

Returns

ASCIICHAT_OK on success, error code on failure

Definition at line 71 of file acds_handlers.c.

                                                                                  {
  if (!callbacks) {
    return SET_ERRNO(ERROR_INVALID_PARAM, "Invalid callbacks");
  }
 
  // TODO: Implement transport abstraction for ACDS responses or future protocol features
  (void)transport;
 
  // O(1) array-based dispatch - bounds check packet type
  if (type >= 200) {
    log_warn("Invalid ACDS packet type: %d (out of range)", type);
    return ASCIICHAT_OK;
  }
 
  // Lookup handler in dispatch table
  acip_acds_handler_func_t handler = g_acds_packet_handlers[type];
  if (!handler) {
    log_warn("Unhandled ACDS packet type: %d from %s", type, client_ip);
    return ASCIICHAT_OK;
  }
 
  // Dispatch to handler
  return handler(payload, payload_len, client_socket, client_ip, callbacks);
}

References ASCIICHAT_OK, ERROR_INVALID_PARAM, log_warn, and SET_ERRNO.

Referenced by acds_client_handler().