ascii-chat
Binary v0.16.50-198-g78f51665f
Library lib/v0.3.2-2240-g78f51665f
Video chat in your terminal
Loading...
Searching...
No Matches
consensus_integration.c File Reference

Integration helpers for session consensus in discovery mode. More...

Go to the source code of this file.

Macros

#define SESSION_CONSENSUS_INTEGRATION_HOST_ADDRESS_BUFFER_SIZE   64
#define SESSION_CONSENSUS_INTEGRATION_BACKUP_ADDRESS_BUFFER_SIZE   64

Functions

asciichat_error_t consensus_get_discovery_callbacks (void *context, session_consensus_callbacks_t *out_callbacks)
 Get callbacks configured for discovery mode integration.
asciichat_error_t consensus_create_for_discovery (const uint8_t session_id[SESSION_ID_SIZE], const uint8_t my_id[SESSION_ID_SIZE], const uint8_t participant_ids[MAX_SESSION_PARTICIPANTS][SESSION_ID_SIZE], int num_participants, void *discovery_context, session_consensus_t **out_consensus)
 Example: Create session consensus for discovery mode.
uint32_t consensus_suggest_timeout_ms (session_consensus_t *consensus, uint32_t current_timeout_ms)
 Calculate how long to wait until next consensus processing.

Detailed Description

Integration helpers for session consensus in discovery mode.

This file provides example integration code showing how modes (discovery, server, client, acds) can integrate the ring consensus abstraction.

Design Example for Discovery Mode:

  1. Create consensus when entering ACTIVE state
  2. Call consensus_process() in discovery_session_process() loop
  3. Hook up packet routing for RING_* consensus packets
  4. Update host info when election completes

Definition in file consensus_integration.c.

Macro Definition Documentation

◆ SESSION_CONSENSUS_INTEGRATION_BACKUP_ADDRESS_BUFFER_SIZE

#define SESSION_CONSENSUS_INTEGRATION_BACKUP_ADDRESS_BUFFER_SIZE   64

Definition at line 4 of file consensus_integration.c.

◆ SESSION_CONSENSUS_INTEGRATION_HOST_ADDRESS_BUFFER_SIZE

#define SESSION_CONSENSUS_INTEGRATION_HOST_ADDRESS_BUFFER_SIZE   64

Definition at line 3 of file consensus_integration.c.

Function Documentation

◆ consensus_create_for_discovery()

asciichat_error_t consensus_create_for_discovery ( const uint8_t session_id[SESSION_ID_SIZE],
const uint8_t my_id[SESSION_ID_SIZE],
const uint8_t participant_ids[MAX_SESSION_PARTICIPANTS][SESSION_ID_SIZE],
int num_participants,
void * discovery_context,
session_consensus_t ** out_consensus )

Example: Create session consensus for discovery mode.

Create session consensus for discovery mode.

Shows how a mode would create the consensus abstraction. This is a standalone example - real discovery session would call this when transitioning to ACTIVE state if participants found.

Parameters
session_idSession identifier (16 bytes)
my_idMy participant identifier (16 bytes)
participant_idsArray of all participant IDs (up to 128)
num_participantsCount of participants
discovery_contextMode-specific context (e.g., discovery_session_t)
out_consensusOutput: Created consensus handle
Returns
ASCIICHAT_OK on success

Definition at line 147 of file consensus_integration.c.

149 {
150 (void)session_id; // Informational only, not needed by consensus itself
151
152 if (!my_id || !participant_ids || !discovery_context || !out_consensus) {
153 return SET_ERRNO(ERROR_INVALID_PARAM, "Invalid parameters");
154 }
155
156 if (num_participants < 1 || num_participants > MAX_SESSION_PARTICIPANTS) {
157 return SET_ERRNO(ERROR_INVALID_PARAM, "Invalid participant count: %d", num_participants);
158 }
159
160 // Determine if we're the ring leader (for now, assume not - ACDS would manage this)
161 // In a real implementation, ACDS would tell us our position in the ring
162 bool is_leader = false; // This would be determined by ACDS
163
164 // Get callbacks configured for our mode
165 session_consensus_callbacks_t callbacks = {0};
166 asciichat_error_t err = consensus_get_discovery_callbacks(discovery_context, &callbacks);
167 if (err != ASCIICHAT_OK) {
168 return err;
169 }
170
171 // Create consensus with the callbacks
172 return session_consensus_create(my_id, is_leader, participant_ids, num_participants, &callbacks, out_consensus);
173}
#define SET_ERRNO(code,...)
asciichat_error_t session_consensus_create(const uint8_t my_id[SESSION_ID_SIZE], bool is_leader, const uint8_t participant_ids[MAX_SESSION_PARTICIPANTS][SESSION_ID_SIZE], int num_participants, const session_consensus_callbacks_t *callbacks, session_consensus_t **out_consensus)
Create a new session consensus instance.
Definition consensus.c:117
asciichat_error_t consensus_get_discovery_callbacks(void *context, session_consensus_callbacks_t *out_callbacks)
Get callbacks configured for discovery mode integration.
asciichat_error_t
Error and exit codes - unified status values (0-255).
Definition error_codes.h:48
@ ASCIICHAT_OK
Definition error_codes.h:50
@ ERROR_INVALID_PARAM
#define MAX_SESSION_PARTICIPANTS
uint8_t session_id[SESSION_ID_SIZE]
Mode-specific hooks used by the session consensus adapter.
Definition consensus.h:122

References ASCIICHAT_OK, consensus_get_discovery_callbacks(), ERROR_INVALID_PARAM, MAX_SESSION_PARTICIPANTS, session_consensus_create(), session_id, SESSION_ID_SIZE, and SET_ERRNO.

◆ consensus_get_discovery_callbacks()

asciichat_error_t consensus_get_discovery_callbacks ( void * context,
session_consensus_callbacks_t * out_callbacks )

Get callbacks configured for discovery mode integration.

Get consensus callbacks configured for discovery mode.

Returns a properly configured callback structure for session consensus. The returned callbacks encapsulate the discovery session's packet sending, election handling, and metrics measurement capabilities.

Parameters
contextDiscovery session pointer (void* for genericity)
out_callbacksOutput: Configured callbacks
Returns
ASCIICHAT_OK on success

Definition at line 117 of file consensus_integration.c.

117 {
118 if (!context || !out_callbacks) {
119 return SET_ERRNO(ERROR_INVALID_PARAM, "Invalid parameters: context=%p, out_callbacks=%p", context, out_callbacks);
120 }
121
122 // Configure callbacks for discovery mode
123 out_callbacks->send_packet = consensus_send_via_discovery;
124 out_callbacks->on_election = consensus_on_election_result;
125 out_callbacks->get_metrics = consensus_get_metrics;
126 out_callbacks->election = NULL; // Use default election algorithm
127 out_callbacks->context = context;
128
129 return ASCIICHAT_OK;
130}
void * context
Opaque context passed to all callbacks.
Definition consensus.h:127
session_consensus_election_fn election
Custom election callback (optional, NULL = use default).
Definition consensus.h:126
session_consensus_on_election_fn on_election
Election result callback.
Definition consensus.h:124
session_consensus_get_metrics_fn get_metrics
Measure metrics callback.
Definition consensus.h:125
session_consensus_send_packet_fn send_packet
Send packet callback.
Definition consensus.h:123

References ASCIICHAT_OK, session_consensus_callbacks_t::context, session_consensus_callbacks_t::election, ERROR_INVALID_PARAM, session_consensus_callbacks_t::get_metrics, session_consensus_callbacks_t::on_election, session_consensus_callbacks_t::send_packet, and SET_ERRNO.

Referenced by consensus_create_for_discovery().

◆ consensus_suggest_timeout_ms()

uint32_t consensus_suggest_timeout_ms ( session_consensus_t * consensus,
uint32_t current_timeout_ms )

Calculate how long to wait until next consensus processing.

Suggest next timeout for consensus processing.

Useful for modes to schedule when they should call consensus_process() next.

Parameters
consensusConsensus handle
current_timeout_msCurrent event loop timeout in milliseconds
Returns
Suggested next timeout in milliseconds

Definition at line 184 of file consensus_integration.c.

184 {
185 if (!consensus) {
186 return current_timeout_ms;
187 }
188
189 // Get time until next round in nanoseconds
190 uint64_t time_to_next_ns = session_consensus_time_until_next_round(consensus);
191
192 // Convert to milliseconds
193 uint64_t time_to_next_ms = time_ns_to_ms(time_to_next_ns);
194
195 // Return minimum of consensus deadline or current timeout
196 if (time_to_next_ms == 0) {
197 return 0; // Consensus needs immediate attention
198 }
199
200 if (time_to_next_ms < current_timeout_ms) {
201 return (uint32_t)time_to_next_ms;
202 }
203
204 return current_timeout_ms;
205}
uint64_t session_consensus_time_until_next_round(session_consensus_t *consensus)
Get time until next consensus round in nanoseconds.
Definition consensus.c:301
unsigned int uint32_t
unsigned long long uint64_t

References session_consensus_time_until_next_round().