fnet_mdns.h

/**************************************************************************
*
* Copyright 2016-2018 by Andrey Butok. FNET Community.
*
***************************************************************************
*
*  Licensed under the Apache License, Version 2.0 (the "License"); you may
*  not use this file except in compliance with the License.
*  You may obtain a copy of the License at
*
*  http://www.apache.org/licenses/LICENSE-2.0
*
*  Unless required by applicable law or agreed to in writing, software
*  distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
*  WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
*  See the License for the specific language governing permissions and
*  limitations under the License.
*
***************************************************************************
*
*  mDNS (Bonjour) Server/Responder API.
*
***************************************************************************/

#ifndef _FNET_MDNS_H_

#define _FNET_MDNS_H_

#if FNET_CFG_MDNS || defined(__DOXYGEN__)

/**************************************************************************/ 
typedef struct
{
    fnet_netif_desc_t           netif_desc;     
    fnet_address_family_t       addr_family;    
    fnet_uint32_t               rr_ttl;         
    const fnet_char_t           *name;          
} fnet_mdns_params_t;

/**************************************************************************/ 
typedef struct
{
    fnet_char_t       *key_name;      
    fnet_char_t       *key_value;     
} fnet_mdns_txt_key_t;

/**************************************************************************/ 
typedef struct
{
    const char                  *service_type;             
    fnet_uint16_t               service_port;              
    const fnet_mdns_txt_key_t   *(*service_get_txt)(void); 
} fnet_mdns_service_t;

/**************************************************************************/ 
typedef void *fnet_mdns_desc_t;

/**************************************************************************/ 
typedef void *fnet_mdns_service_desc_t;

#if defined(__cplusplus)
extern "C" {
#endif

/***************************************************************************/ 
fnet_mdns_desc_t fnet_mdns_init( fnet_mdns_params_t *params );

/***************************************************************************/ 
void fnet_mdns_release(fnet_mdns_desc_t mdns_desc);

/***************************************************************************/ 
fnet_mdns_service_desc_t fnet_mdns_service_register(fnet_mdns_desc_t mdns_desc, const fnet_mdns_service_t *service);

/***************************************************************************/ 
void fnet_mdns_service_unregister(fnet_mdns_service_desc_t service_desc);

/***************************************************************************/ 
fnet_mdns_service_desc_t fnet_mdns_service_get_by_type(fnet_mdns_desc_t mdns_desc, const char  *service_type);

/***************************************************************************/ 
void fnet_mdns_announce(fnet_mdns_desc_t mdns_desc);

/***************************************************************************/ 
void fnet_mdns_probe(fnet_mdns_desc_t mdns_desc);

/***************************************************************************/ 
fnet_bool_t fnet_mdns_is_enabled(fnet_mdns_desc_t desc);

/***************************************************************************/ 
fnet_mdns_desc_t fnet_mdns_get_by_netif(fnet_netif_desc_t netif);

#if defined(__cplusplus)
}
#endif

#endif /* FNET_CFG_MDNS */

#endif /* _FNET_MDNS_H_ */