mdnsd.h

Go to the documentation of this file.

/*
 * Copyright (c) 2003  Jeremie Miller <jer@jabber.org>
 * Copyright (c) 2016-2026  Joachim Wiberg <troglobit@gmail.com>
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 *     * Redistributions of source code must retain the above copyright
 *       notice, this list of conditions and the following disclaimer.
 *     * 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.
 *     * Neither the name of the copyright holders nor the names of its
 *       contributors may be used to endorse or promote products derived from
 *       this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "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 COPYRIGHT HOLDERS OR CONTRIBUTORS 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.
 */
 
#ifndef LIB_MDNSD_H_
#define LIB_MDNSD_H_
 
#include "1035.h"
#include "inet.h"
#include <sys/time.h>
#include <stdbool.h>
#include <stdio.h>
#include <syslog.h>
 
#define QCLASS_IN (1)
#define DISCO_NAME "_services._dns-sd._udp.local."
 
#define DBG(fmt, args...)  mdnsd_log(LOG_DEBUG, "%s(): " fmt, __func__, ##args)
#define INFO(fmt, args...) mdnsd_log(LOG_INFO, "%s(): " fmt, __func__, ##args)
#define NOTE(fmt, args...) mdnsd_log(LOG_NOTICE, fmt, ##args)
#define WARN(fmt, args...) mdnsd_log(LOG_WARNING, fmt, ##args)
#define ERR(fmt, args...)  mdnsd_log(LOG_ERR, fmt, ##args)
 
/** Main daemon data */
typedef struct mdns_daemon mdns_daemon_t;
/** Record entry */
typedef struct mdns_record mdns_record_t;
 
/** Callback for received record. Data is passed from the register call */
typedef void (*mdnsd_record_received_callback)(const struct resource* r, void* data);
 
/** Answer data */
typedef struct mdns_answer {
    char *name;
    unsigned short int type;
    unsigned long int ttl;
    unsigned short int rdlen;
    unsigned char *rdata;
    struct in_addr ip;  /* A, network byte order */
    struct in6_addr ip6;    /* AAAA, network byte order */
    char *rdname;       /* NS/CNAME/PTR/SRV */
    struct {
        unsigned short int priority, weight, port;
    } srv;          /* SRV */
} mdns_answer_t;
 
 
 
 
void mdnsd_log_open(const char *ident);
 
 
int mdnsd_log_level(char *level);
 
 
void mdnsd_log_time(struct timeval *tv, char *buf, size_t len);
 
 
void mdnsd_log_hex(const char *msg, unsigned char *buffer, ssize_t len);
 
 
void mdnsd_log(int severity, const char *fmt, ...);
 
 
mdns_daemon_t *mdnsd_new(int class, int frame);
 
 
void mdnsd_set_family(mdns_daemon_t *d, sa_family_t family);
 
 
void mdnsd_set_local(mdns_daemon_t *d, int enable);
 
 
int mdnsd_get_local(mdns_daemon_t *d);
 
 
void mdnsd_set_address(mdns_daemon_t *d, struct in_addr addr);
 
 
struct in_addr mdnsd_get_address(mdns_daemon_t *d);
 
 
void mdnsd_set_ipv6_address(mdns_daemon_t *d, struct in6_addr addr);
 
 
struct in6_addr mdnsd_get_ipv6_address(mdns_daemon_t *d);
 
 
void mdnsd_shutdown(mdns_daemon_t *d);
 
 
void mdnsd_flush(mdns_daemon_t *d);
 
 
void mdnsd_free(mdns_daemon_t *d);
 
 
void mdnsd_register_receive_callback(mdns_daemon_t *d, mdnsd_record_received_callback cb, void *data);
 
 
 
 
int mdnsd_in(mdns_daemon_t *d, struct message *m, const inet_addr_t *from);
 
 
int mdnsd_out(mdns_daemon_t *d, struct message *m, inet_addr_t *to);
 
 
struct timeval *mdnsd_sleep(mdns_daemon_t *d);
 
 
 
 
void mdnsd_query(mdns_daemon_t *d, const char *host, int type, int (*answer)(mdns_answer_t *a, void *arg), void *arg);
 
 
mdns_answer_t *mdnsd_list(mdns_daemon_t *d, const char *host, int type, mdns_answer_t *last);
 
 
mdns_record_t *mdnsd_record_next(const mdns_record_t *r);
 
 
const mdns_answer_t *mdnsd_record_data(const mdns_record_t *r);
 
 
 
 
 
mdns_record_t *mdnsd_unique(mdns_daemon_t *d, const char *host, unsigned short type, unsigned long ttl, void (*conflict)(char *host, int type, void *arg), void *arg);
 
 
 
mdns_record_t *mdnsd_shared(mdns_daemon_t *d, const char *host, unsigned short type, unsigned long ttl);
 
 
mdns_record_t *mdnsd_get_published(mdns_daemon_t *d, const char *host);
 
 
int mdnsd_has_query(mdns_daemon_t *d, const char *host);
 
 
mdns_record_t *mdnsd_find(mdns_daemon_t *d, const char *name, unsigned short type);
 
 
void mdnsd_done(mdns_daemon_t *d, mdns_record_t *r);
 
 
void mdnsd_set_raw(mdns_daemon_t *d, mdns_record_t *r, const char *data, unsigned short len);
void mdnsd_set_host(mdns_daemon_t *d, mdns_record_t *r, const char *name);
void mdnsd_set_ip(mdns_daemon_t *d, mdns_record_t *r, struct in_addr ip);
void mdnsd_set_ipv6(mdns_daemon_t *d, mdns_record_t *r, struct in6_addr ip6);
void mdnsd_set_srv(mdns_daemon_t *d, mdns_record_t *r, unsigned short priority, unsigned short weight, unsigned short port, char *name);
 
 
int mdnsd_step(mdns_daemon_t *d, int mdns_socket, bool processIn, bool processOut, struct timeval *tv);
 
void records_clear(mdns_daemon_t *d);
 
 
int mdnsd_set_addresses_for_host(mdns_daemon_t *d, const char *host,
                                 const struct in_addr *addrs, size_t count);
 
 
int mdnsd_set_ipv6_addresses_for_host(mdns_daemon_t *d, const char *host,
                                      const struct in6_addr *addrs, size_t count);
 
 
int mdnsd_set_interface_addresses(mdns_daemon_t *d, const char *ifname);
#endif  /* LIB_MDNSD_H_ */