tui/mdns.h

Go to the documentation of this file.

 
#pragma once
 
/* Storage capacities in elements; text buffers include the terminating NUL. */
#define TUI_MDNS_NAME_BUFFER_SIZE 256
#define TUI_MDNS_SESSION_STRING_BUFFER_SIZE 256
#define TUI_MDNS_ADDRESS_BUFFER_SIZE 256
#define TUI_MDNS_IPV4_BUFFER_SIZE 16
#define TUI_MDNS_IPV6_BUFFER_SIZE 46
 
#include <stdbool.h>
#include <stdint.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
/* ============================================================================
 * Log Management
 * ========================================================================== */

void ui_mdns_log_init(void);

void ui_mdns_log_destroy(void);

void ui_mdns_log_clear(void);

void ui_mdns_log_append(const char *message);

typedef struct {
  char name[TUI_MDNS_NAME_BUFFER_SIZE];                     
  char session_string[TUI_MDNS_SESSION_STRING_BUFFER_SIZE]; 
  char address[TUI_MDNS_ADDRESS_BUFFER_SIZE];               
  uint16_t port;                                            
  char ipv4[TUI_MDNS_IPV4_BUFFER_SIZE];                     
  char ipv6[TUI_MDNS_IPV6_BUFFER_SIZE];                     
  uint32_t ttl;                                             
} ui_mdns_server_t;

typedef struct {
  int timeout_ms;  
  int max_servers; 
  bool quiet;      
} ui_mdns_config_t;

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

void ui_mdns_free_results(ui_mdns_server_t *servers);

int ui_mdns_prompt_selection(const ui_mdns_server_t *servers, int count);

int ui_mdns_select(const ui_mdns_server_t *servers, int count);

int ui_mdns_select_until(const ui_mdns_server_t *servers, int count, uint64_t deadline);

int ui_mdns_select_live(const ui_mdns_server_t *servers, int count, uint64_t deadline, ui_mdns_server_t *chosen);

const char *ui_mdns_get_best_address(const ui_mdns_server_t *server);
 
#ifdef __cplusplus
}
#endif