ascii-chat
Binary v0.16.50-198-g78f51665f
Library lib/v0.3.2-2240-g78f51665f
Video chat in your terminal
Loading...
Searching...
No Matches
Client Handler

📡 Client-side packet processing and data reception thread

📡 Client-side packet processing and data reception thread

Client Protocol README

Overview

The protocol handler manages the data reception thread, processes incoming packets from the server, and dispatches them to appropriate handlers based on packet type.

Implementation: src/client/protocol.c, src/client/protocol.h

Data Reception Thread

static void *data_reception_thread(void *arg)
{
(void)arg;
socket_t sockfd = server_connection_get_socket();
const crypto_context_t *crypto_ctx = crypto_client_get_context();
void *payload = NULL;
size_t payload_len = 0;
// Receive and decrypt packet
int result = receive_packet(sockfd, crypto_ctx, &header, &payload, &payload_len);
if (result < 0) {
log_debug("receive_packet failed - connection lost");
break;
}
// Dispatch based on packet type
handle_packet(&header, payload, payload_len);
if (payload) {
free(payload);
payload = NULL;
}
}
atomic_store(&g_data_thread_exited, true);
return NULL;
}
#define log_debug(...)
Log a DEBUG message.
Definition log/log.h:589
int receive_packet(socket_t sockfd, packet_type_t *type, void **data, size_t *len)
Receive a basic packet without encryption.
Definition packet.c:594
int socket_t
bool should_exit(void)
Definition main.c:248
bool server_connection_is_active(client_connection_t *connection)
Establish connection to ascii-chat server.
void server_connection_lost(client_connection_t *connection)
Signal that connection has been lost.
Endpoint cryptographic state for handshake, packet protection, authentication, and rekeying.
Fixed prefix shared by every ACIP packet on the wire.
Definition packet.h:641

Packet Handlers

ASCII Frame Handler

static void handle_ascii_frame(const void *payload, size_t payload_len)
{
// Render ASCII frame to terminal
display_render_frame((const char *)payload, opt_snapshot);
// Snapshot mode: exit after displaying frame
if (opt_snapshot) {
}
}
void display_render_frame(client_connection_t *connection, const char *frame_data)
Render ASCII frame to display.
void signal_exit(void)
Definition main.c:252

Audio Batch Handler

static void handle_audio_batch(const void *payload, size_t payload_len)
{
const float *samples = (const float *)payload;
int num_samples = payload_len / sizeof(float);
// Process received audio samples
audio_process_received_samples(samples, num_samples);
}
void audio_process_received_samples(client_connection_t *connection, const float *samples, int num_samples)
Process received audio samples from server.

Pong Handler

static void handle_pong(void)
{
// Update last pong time for keepalive timeout tracking
keepalive_record_pong();
}

Clear Console Handler

static void handle_clear_console(void)
{
// Server requests terminal clear
}
void display_full_reset()
Perform full display reset.

Server State Handler

static void handle_server_state(const void *payload, size_t payload_len)
{
// Log server state information
log_debug("Received server state update");
}

Connection Loss Detection

Loss triggers in protocol thread:

  • receive_packet() returns error
  • Socket read error (connection closed by server)
  • Decryption failure (corrupted stream)
  • Invalid packet magic number
if (receive_packet(...) < 0) {
server_connection_lost(); // Signal connection loss
break; // Exit thread
}
See also
src/client/protocol.c
src/client/protocol.h
Client Overview