acds_server.h File Reference

ACIP server-side protocol library and ACDS server utilities. More...

Go to the source code of this file.

Functions
ACIP Packet Validation
asciichat_error_t	acip_server_validate_session_create (const acip_session_create_t *req)
	Validate ACIP session create request.
asciichat_error_t	acip_server_validate_session_join (const acip_session_join_t *req)
	Validate ACIP session join request.
ACIP Error Response Helpers
asciichat_error_t	acip_server_send_error (socket_t sockfd, acip_error_code_t error_code, const char *error_message)
	Send ACIP error response to client.

Detailed Description

ACIP server-side protocol library and ACDS server utilities.

Definition in file acds_server.h.

Function Documentation

acip_server_send_error()

asciichat_error_t acip_server_send_error	(	socket_t	sockfd,
		acip_error_code_t	error_code,
		const char *	error_message )

Send ACIP error response to client.

Parameters

sockfd	Client socket
error_code	ACIP error code
error_message	Human-readable error message (max 255 chars)

Returns

ASCIICHAT_OK on success, error code on failure

Sends PACKET_TYPE_ACIP_ERROR response to client with specified error code and message. Message will be truncated if longer than 255 characters.

Definition at line 79 of file acds_server.c.

                                                                                                                   {
  if (sockfd == INVALID_SOCKET_VALUE) {
    return SET_ERRNO(ERROR_INVALID_PARAM, "Invalid socket");
  }
 
  if (!error_message) {
    error_message = "Unknown error";
  }
 
  acip_error_t error_packet;
  memset(&error_packet, 0, sizeof(error_packet));
  error_packet.error_code = (uint8_t)error_code;
 
  // Safely copy error message (truncate if needed)
  size_t msg_len = strlen(error_message);
  if (msg_len >= sizeof(error_packet.error_message)) {
    msg_len = sizeof(error_packet.error_message) - 1;
  }
  memcpy(error_packet.error_message, error_message, msg_len);
  error_packet.error_message[msg_len] = '\0';
 
  // Send ACIP_ERROR packet
  int result = send_packet(sockfd, PACKET_TYPE_ACIP_ERROR, &error_packet, sizeof(error_packet));
  if (result < 0) {
    return SET_ERRNO(ERROR_NETWORK, "Failed to send ACIP error packet");
  }
 
  return ASCIICHAT_OK;
}

References acip_error_t, ASCIICHAT_OK, ERROR_INVALID_PARAM, ERROR_NETWORK, PACKET_TYPE_ACIP_ERROR, send_packet(), and SET_ERRNO.

acip_server_validate_session_create()

asciichat_error_t acip_server_validate_session_create

(

const acip_session_create_t *

req

)

Validate ACIP session create request.

Parameters

req	Session create request packet

Returns

ASCIICHAT_OK if valid, error code if invalid

Validates that a SESSION_CREATE request has all required fields populated correctly (identity, signature, capabilities, etc.).

Definition at line 28 of file acds_server.c.

                                                                                        {
  if (!req) {
    return SET_ERRNO(ERROR_INVALID_PARAM, "Session create request is NULL");
  }
 
  if (req->total_keys > MAX_SESSION_KEYS || req->key_index >= (req->total_keys ? req->total_keys : 1)) {
    return SET_ERRNO(ERROR_INVALID_PARAM, "Invalid session key count/index");
  }
 
  // Validate capabilities (only bits 0-1 should be set)
  if (req->capabilities & ~0x03) {
    return SET_ERRNO(ERROR_INVALID_PARAM, "Invalid capabilities bits (only 0-1 allowed)");
  }
 
  // Validate max_participants (1-128)
  if (req->max_participants < 1 || req->max_participants > MAX_SESSION_PARTICIPANTS) {
    return SET_ERRNO(ERROR_INVALID_PARAM, "Invalid max_participants (must be 1-%d)", MAX_SESSION_PARTICIPANTS);
  }
 
  // Server address can be empty - ACDS will auto-detect from connection source IP
 
  // Validate server port is non-zero
  if (req->server_port == 0) {
    return SET_ERRNO(ERROR_INVALID_PARAM, "Server port is zero");
  }
 
  return ASCIICHAT_OK;
}

References acip_session_create_t, ASCIICHAT_OK, ERROR_INVALID_PARAM, MAX_SESSION_KEYS, MAX_SESSION_PARTICIPANTS, and SET_ERRNO.

acip_server_validate_session_join()

asciichat_error_t acip_server_validate_session_join

(

const acip_session_join_t *

req

)

Validate ACIP session join request.

Parameters

req	Session join request packet

Returns

ASCIICHAT_OK if valid, error code if invalid

Validates that a SESSION_JOIN request has all required fields populated correctly (session string, identity, signature, etc.).

Definition at line 57 of file acds_server.c.

                                                                                    {
  if (!req) {
    return SET_ERRNO(ERROR_INVALID_PARAM, "Session join request is NULL");
  }
 
  // Validate session string length
  if (req->session_string_len == 0 || req->session_string_len > ACIP_MAX_SESSION_STRING_LEN) {
    return SET_ERRNO(ERROR_INVALID_PARAM, "Invalid session string length");
  }
 
  // Validate session string is not empty
  if (req->session_string[0] == '\0') {
    return SET_ERRNO(ERROR_INVALID_PARAM, "Session string is empty");
  }
 
  return ASCIICHAT_OK;
}

References ACIP_MAX_SESSION_STRING_LEN, acip_session_join_t, ASCIICHAT_OK, ERROR_INVALID_PARAM, and SET_ERRNO.