mdns.c File Reference

mDNS service discovery UI wrapper for interactive server selection More...

Go to the source code of this file.

Functions
void	ui_mdns_log_init (void)
	Initialize log buffer for mDNS discovery UI.
void	ui_mdns_log_destroy (void)
	Destroy mDNS discovery log buffer.
void	ui_mdns_log_clear (void)
	Clear mDNS discovery log buffer.
void	ui_mdns_log_append (const char *message)
	Append message to mDNS discovery log buffer.
ui_mdns_server_t *	ui_mdns_query (const ui_mdns_config_t *config, int *out_count)
	TUI wrapper around core mDNS discovery.
void	ui_mdns_free_results (ui_mdns_server_t *servers)
	Free results from mDNS discovery.
int	ui_mdns_prompt_selection (const ui_mdns_server_t *servers, int count)
	Interactive server selection.
int	ui_mdns_select (const ui_mdns_server_t *servers, int count)
	TUI-based server selection with formatted display.
const char *	ui_mdns_get_best_address (const ui_mdns_server_t *server)
	Get best address for a server.

Detailed Description

mDNS service discovery UI wrapper for interactive server selection

Pure TUI wrapper that calls discovery_mdns_query() from discovery.c. Provides interactive terminal UI for server selection and address resolution.

Definition in file ui/mdns.c.

Function Documentation

ui_mdns_free_results()

void ui_mdns_free_results

(

ui_mdns_server_t *

servers

)

Free results from mDNS discovery.

Free results from TUI discovery query.

Definition at line 77 of file ui/mdns.c.

                                                     {
  discovery_mdns_destroy(servers);
}

References discovery_mdns_destroy().

ui_mdns_get_best_address()

const char * ui_mdns_get_best_address

(

const ui_mdns_server_t *

server

)

Get best address for a server.

Get best address representation for a discovered server.

Definition at line 233 of file ui/mdns.c.

                                                                     {
  if (!server) {
    return "";
  }
 
  // Prefer IPv4 > name > IPv6
  if (server->ipv4[0] != '\0') {
    return server->ipv4;
  }
  if (server->name[0] != '\0') {
    return server->name;
  }
  if (server->ipv6[0] != '\0') {
    return server->ipv6;
  }
 
  return server->address; // Fallback to address field
}

References ui_mdns_server_t::address, ui_mdns_server_t::ipv4, ui_mdns_server_t::ipv6, and ui_mdns_server_t::name.

Referenced by ui_mdns_prompt_selection(), and ui_mdns_select().

ui_mdns_log_append()

void ui_mdns_log_append

(

const char *

message

)

Append message to mDNS discovery log buffer.

Delegates to the logging system which automatically captures to session log buffer.

Parameters

message

Log message to append

Definition at line 46 of file ui/mdns.c.

                                             {
  if (message) {
    log_info("%s", message);
  }
}

References log_info.

ui_mdns_log_clear()

void ui_mdns_log_clear

(

void

)

Clear mDNS discovery log buffer.

Delegates to terminal_screen log clear. Useful when starting fresh mDNS discovery screen.

Definition at line 42 of file ui/mdns.c.

                             {
  terminal_screen_log_clear();
}

References terminal_screen_log_clear().

ui_mdns_log_destroy()

void ui_mdns_log_destroy

(

void

)

Destroy mDNS discovery log buffer.

Delegates to terminal_screen log cleanup.

Definition at line 37 of file ui/mdns.c.

                               {
  log_clear_session_log_buffer();
  terminal_screen_log_destroy();
}

References log_clear_session_log_buffer(), and terminal_screen_log_destroy().

ui_mdns_log_init()

void ui_mdns_log_init

(

void

)

Initialize log buffer for mDNS discovery UI.

Delegates to terminal_screen log initialization. Call once at startup before rendering mDNS discovery screen.

Definition at line 30 of file ui/mdns.c.

                            {
  session_log_buffer_t *buf = terminal_screen_log_init();
  if (buf) {
    log_set_session_log_buffer(buf);
  }
}

References log_set_session_log_buffer(), and terminal_screen_log_init().

ui_mdns_prompt_selection()

int ui_mdns_prompt_selection	(	const ui_mdns_server_t *	servers,
		int	count
	)

Interactive server selection.

Display discovered servers to user and prompt for selection.

Definition at line 84 of file ui/mdns.c.

                                                                         {
  if (!servers || count <= 0) {
    return -1;
  }
 
  // Display available servers
  printf("\nAvailable ascii-chat servers on LAN:\n");
  for (int i = 0; i < count; i++) {
    const ui_mdns_server_t *srv = &servers[i];
    const char *addr = ui_mdns_get_best_address(srv);
    printf("  %d. %s (%s:%u)\n", i + 1, srv->name, addr, srv->port);
  }
 
  // Prompt for selection
  printf("\nSelect server (1-%d) or press Enter to cancel: ", count);
  fflush(stdout);
 
  // Read user input
  char input[32];
  if (fgets(input, sizeof(input), stdin) == NULL) {
    printf("\n");
    return -1; // EOF or error
  }
 
  // Check for empty input (Enter pressed)
  if (input[0] == '\n' || input[0] == '\r' || input[0] == '\0') {
    return -1; // User cancelled
  }
 
  // Parse input as number
  char *endptr;
  long selection = strtol(input, &endptr, 10);
 
  // Validate input
  if (selection < 1 || selection > count) {
    printf("⚠️  Invalid selection. Please enter a number between 1 and %d\n", count);
    return ui_mdns_prompt_selection(servers, count); // Re-prompt
  }
 
  return (int)(selection - 1); // Convert to 0-based index
}

References ui_mdns_server_t::name, ui_mdns_server_t::port, ui_mdns_get_best_address(), and ui_mdns_prompt_selection().

Referenced by ui_mdns_prompt_selection().

ui_mdns_query()

ui_mdns_server_t * ui_mdns_query	(	const ui_mdns_config_t *	config,
		int *	out_count
	)

TUI wrapper around core mDNS discovery.

Discover ascii-chat servers on the local network via mDNS.

Calls discovery_mdns_query() from discovery.c with TUI-friendly configuration.

Definition at line 57 of file ui/mdns.c.

                                                                                {
  if (!out_count) {
    SET_ERRNO(ERROR_INVALID_PARAM, "out_count pointer is NULL");
    return NULL;
  }
 
  *out_count = 0;
 
  // Apply defaults if needed
  int timeout_ms = (config && config->timeout_ms > 0) ? config->timeout_ms : 2000;
  int max_servers = (config && config->max_servers > 0) ? config->max_servers : 20;
  bool quiet = (config && config->quiet);
 
  // Call the core mDNS discovery function from discovery.c
  return discovery_mdns_query(timeout_ms, max_servers, quiet, out_count);
}

References discovery_mdns_query(), ERROR_INVALID_PARAM, ui_mdns_config_t::max_servers, ui_mdns_config_t::quiet, SET_ERRNO, and ui_mdns_config_t::timeout_ms.

ui_mdns_select()

int ui_mdns_select	(	const ui_mdns_server_t *	servers,
		int	count
	)

TUI-based server selection with formatted display.

Displays discovered servers in a terminal UI with the following features:

• Clears terminal and displays formatted server list
• Shows "No results" message if no servers available
• Allows numeric input for selection
• Shows helpful prompts and icons

Parameters

servers	Array of discovered servers
count	Number of servers

Returns

0-based index of selected server, or -1 to cancel

Definition at line 139 of file ui/mdns.c.

                                                               {
  if (!servers || count <= 0) {
    // No servers found - return special code
    // Message will be printed at exit in client main
    return -1;
  }
 
  // Lock terminal to prevent concurrent logging from overwriting TUI
  bool prev_lock_state = log_lock_terminal();
 
  // Clear terminal
  log_plain("\033[2J\033[H");
 
  // Display header
  log_plain("\n");
  log_plain("\033[1m╭─ 🔍 ascii-chat Server Discovery ────────────╮\033[0m\n");
  log_plain("\033[1m│\033[0m\n");
  char found_buf[64];
  snprintf(found_buf, sizeof(found_buf), "Found %d server%s on your local network:", count, count == 1 ? "" : "s");
  log_plain("\033[1m│\033[0m %s\n", colored_string(LOG_COLOR_INFO, found_buf));
  log_plain("\033[1m│\033[0m\n");
 
  // Display server list with formatting
  for (int i = 0; i < count; i++) {
    const ui_mdns_server_t *srv = &servers[i];
    const char *addr = ui_mdns_get_best_address(srv);
 
    char idx_buf[8];
    snprintf(idx_buf, sizeof(idx_buf), "[%d]", i + 1);
    char addr_buf[128];
    snprintf(addr_buf, sizeof(addr_buf), "%s:%u", addr, srv->port);
 
    log_plain("\033[1m│\033[0m  %s %-30s %s\n", colored_string(LOG_COLOR_DEBUG, idx_buf), srv->name,
              colored_string(LOG_COLOR_WARN, addr_buf));
  }
 
  log_plain("\033[1m│\033[0m\n");
  log_plain("\033[1m╰────────────────────────────────────────────╯\033[0m\n");
 
  // Prompt for selection
  log_plain("\n");
  log_plain("Enter server number (1-%d) or press Enter to cancel: ", count);
  fflush(stdout);
 
  // Unlock before waiting for input (user might take time)
  log_unlock_terminal(prev_lock_state);
 
  // Read user input
  char input[32];
  if (fgets(input, sizeof(input), stdin) == NULL) {
    return -1;
  }
 
  // Check for empty input (Enter pressed)
  if (input[0] == '\n' || input[0] == '\r' || input[0] == '\0') {
    return -1;
  }
 
  // Parse input as number
  char *endptr;
  long selection = strtol(input, &endptr, 10);
 
  // Validate input
  if (selection < 1 || selection > count) {
    char err_buf[64];
    snprintf(err_buf, sizeof(err_buf), "Please enter a number between 1 and %d", count);
    printf("%s\n\n", colored_string(LOG_COLOR_WARN, err_buf));
    return ui_mdns_select(servers, count); // Re-prompt
  }
 
  // Lock terminal again for final output
  prev_lock_state = log_lock_terminal();
 
  // Clear screen and show connection status
  log_plain("\033[2J\033[H");
  log_plain("\n");
  char connect_buf[128];
  snprintf(connect_buf, sizeof(connect_buf), "🔗 Connecting to %s...", servers[selection - 1].name);
  log_plain("%s\n", colored_string(LOG_COLOR_INFO, connect_buf));
  log_plain("\n");
  fflush(stdout);
 
  // Brief delay so user can see the selection before logs overwrite it
  platform_sleep_ms(200);
 
  // Unlock terminal now that TUI is complete
  log_unlock_terminal(prev_lock_state);
 
  return (int)(selection - 1); // Convert to 0-based index
}

References colored_string(), LOG_COLOR_DEBUG, LOG_COLOR_INFO, LOG_COLOR_WARN, log_lock_terminal(), log_plain, log_unlock_terminal(), ui_mdns_server_t::name, platform_sleep_ms(), ui_mdns_server_t::port, ui_mdns_get_best_address(), and ui_mdns_select().

Referenced by ui_mdns_select().