network/mdns/mdns.h

Go to the documentation of this file.

#pragma once
 
/* Storage capacities in elements; text buffers include the terminating NUL. */
#define NETWORK_MDNS_NAME_BUFFER_SIZE 256
#define NETWORK_MDNS_TYPE_BUFFER_SIZE 256
#define NETWORK_MDNS_IPV4_BUFFER_SIZE 16
#define NETWORK_MDNS_IPV6_BUFFER_SIZE 46
#define NETWORK_MDNS_TXT_BUFFER_SIZE 512
 
#include <ascii-chat/common/limits.h>

 
#include <stdint.h>
#include <stdlib.h>
#include <stdbool.h>
#include "../../common.h"
 
#ifdef __cplusplus
extern "C" {
#endif

typedef struct asciichat_mdns_t asciichat_mdns_t;

typedef struct {
  const char *name;
  uint16_t port;
  const char *type;
  const char *host;
  const char **txt_records;
  size_t txt_count;
} asciichat_mdns_service_t;

typedef struct {
  char name[NETWORK_MDNS_NAME_BUFFER_SIZE];
  char type[NETWORK_MDNS_TYPE_BUFFER_SIZE];
  char host[HOSTNAME_BUFFER_SIZE];
  uint16_t port;
  char ipv4[NETWORK_MDNS_IPV4_BUFFER_SIZE];
  char ipv6[NETWORK_MDNS_IPV6_BUFFER_SIZE];
  char txt[NETWORK_MDNS_TXT_BUFFER_SIZE];
  uint32_t ttl;
} asciichat_mdns_discovery_t;

typedef void (*asciichat_mdns_discovery_callback_fn)(const asciichat_mdns_discovery_t *service, void *user_data);

asciichat_mdns_t *asciichat_mdns_init(void);

void asciichat_mdns_destroy(asciichat_mdns_t *mdns);

asciichat_error_t asciichat_mdns_advertise(asciichat_mdns_t *mdns, const asciichat_mdns_service_t *service);

asciichat_error_t asciichat_mdns_unadvertise(asciichat_mdns_t *mdns, const char *service_name);

asciichat_error_t asciichat_mdns_query(asciichat_mdns_t *mdns, const char *service_type,
                                       asciichat_mdns_discovery_callback_fn callback, void *user_data);

asciichat_error_t asciichat_mdns_update(asciichat_mdns_t *mdns, int timeout_ms);

int asciichat_mdns_get_socket(asciichat_mdns_t *mdns);
 
#ifdef __cplusplus
}
#endif