mdns_priv.h

Go to the documentation of this file.

 
 /*
 * Copyright (c) 2015 Verisure Innovation AB
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without modification,
 * are permitted provided that the following conditions are met:
 *
 * 1. Redistributions of source code must retain the above copyright notice,
 *    this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright notice,
 *    this list of conditions and the following disclaimer in the documentation
 *    and/or other materials provided with the distribution.
 * 3. The name of the author may not be used to endorse or promote products
 *    derived from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
 * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
 * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
 * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
 * OF SUCH DAMAGE.
 *
 * This file is part of the lwIP TCP/IP stack.
 *
 * Author: Erik Ekman <erik@kryo.se>
 * Author: Jasper Verschueren <jasper.verschueren@apart-audio.com>
 *
 */
#ifndef LWIP_HDR_MDNS_PRIV_H
#define LWIP_HDR_MDNS_PRIV_H
 
#include "lwip/apps/mdns.h"
#include "lwip/apps/mdns_opts.h"
#include "lwip/pbuf.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
#if LWIP_MDNS_RESPONDER
 
#define MDNS_READNAME_ERROR 0xFFFF
#define NUM_DOMAIN_OFFSETS 10
 
#define SRV_PRIORITY 0
#define SRV_WEIGHT   0
 
/* mDNS TTL: (RFC6762 section 10)
 *  - 120 seconds if the hostname appears somewhere in the RR
 *  - 75 minutes if not (4500 seconds)
 *  - 10 seconds if responding to a legacy query
 */
#define MDNS_TTL_10    10
#define MDNS_TTL_120   120
#define MDNS_TTL_4500  4500
 
/* RFC6762 section 8.1: If fifteen conflicts occur within any ten-second period,
 * then the host MUST wait at least five seconds before each successive
 * additional probe attempt.
 */
#define MDNS_PROBE_MAX_CONFLICTS_BEFORE_RATE_LIMIT  15
#define MDNS_PROBE_MAX_CONFLICTS_TIME_WINDOW        10000
#define MDNS_PROBE_MAX_CONFLICTS_TIMEOUT            5000
 
#if LWIP_MDNS_SEARCH
struct mdns_request {
  char name[MDNS_LABEL_MAXLEN + 1];
  struct mdns_domain service;
  search_result_fn_t result_fn;
  void *arg;
  u16_t proto;
  u8_t qtype;
  u16_t only_ptr;
};
#endif

struct mdns_service {
  struct mdns_domain txtdata;
  char name[MDNS_LABEL_MAXLEN + 1];
  char service[MDNS_LABEL_MAXLEN + 1];
  service_get_txt_fn_t txt_fn;
  void *txt_userdata;
  u16_t proto;
  u16_t port;
};

struct mdns_outpacket {
  struct pbuf *pbuf;
  u16_t write_offset;
  u16_t questions;
  u16_t answers;
  u16_t authoritative;
  u16_t additional;
  u16_t domain_offsets[NUM_DOMAIN_OFFSETS];
};

struct mdns_outmsg {
  u16_t tx_id;
  u8_t flags;
  ip_addr_t dest_addr;
  u16_t dest_port;
  u8_t cache_flush;
  u8_t unicast_reply_requested;
  u8_t legacy_query;
  u8_t probe_query_recv;
  /* Question bitmask for host information */
  u8_t host_questions;
  /* Questions bitmask per service */
  u8_t serv_questions[MDNS_MAX_SERVICES];
  /* Reply bitmask for host information */
  u8_t host_replies;
  /* Bitmask for which reverse IPv6 hosts to answer */
  u8_t host_reverse_v6_replies;
  /* Reply bitmask per service */
  u8_t serv_replies[MDNS_MAX_SERVICES];
#ifdef LWIP_MDNS_SEARCH
  struct mdns_request *query;
#endif
};

struct mdns_delayed_msg {
  u8_t multicast_msg_waiting;
  u8_t multicast_timeout;
  u8_t multicast_probe_timeout;
  struct mdns_outmsg delayed_msg_multicast;
  u8_t multicast_timeout_25TTL;
  u8_t unicast_msg_in_use;
  struct mdns_outmsg delayed_msg_unicast;
};
 
/* MDNS states */
typedef enum {
  /* MDNS module is off */
  MDNS_STATE_OFF,
  /* Waiting before probing can be started */
  MDNS_STATE_PROBE_WAIT,
  /* Probing the unique records */
  MDNS_STATE_PROBING,
  /* Waiting before announcing the probed unique records */
  MDNS_STATE_ANNOUNCE_WAIT,
  /* Announcing all records */
  MDNS_STATE_ANNOUNCING,
  /* Probing and announcing completed */
  MDNS_STATE_COMPLETE
} mdns_resp_state_enum_t;

struct mdns_host {
  char name[MDNS_LABEL_MAXLEN + 1];
  struct mdns_service *services[MDNS_MAX_SERVICES];
  u8_t sent_num;
  mdns_resp_state_enum_t state;
#if LWIP_IPV4
  struct mdns_delayed_msg ipv4;
#endif
#if LWIP_IPV6
  struct mdns_delayed_msg ipv6;
#endif
  u32_t conflict_time[MDNS_PROBE_MAX_CONFLICTS_BEFORE_RATE_LIMIT];
  u8_t rate_limit_activated;
  u8_t index;
  u8_t num_conflicts;
};
 
struct mdns_host* netif_mdns_data(struct netif *netif);
struct udp_pcb* get_mdns_pcb(void);
 
#endif /* LWIP_MDNS_RESPONDER */
 
#ifdef __cplusplus
}
#endif
 
#endif /* LWIP_HDR_MDNS_PRIV_H */