fnet_dns.h

/**************************************************************************
*
* Copyright 2011-2020 by Andrej 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.
*
***************************************************************************
*
*  DNS Resolver API.
*
***************************************************************************/

#ifndef _FNET_DNS_H_

#define _FNET_DNS_H_

#if FNET_CFG_DNS || defined(__DOXYGEN__)

/**************************************************************************/ 
typedef struct
{
    struct fnet_sockaddr        resolved_addr;      
    fnet_uint32_t               resolved_addr_ttl;  
} fnet_dns_resolved_addr_t;

/**************************************************************************/ 
typedef void *fnet_dns_desc_t;

/**************************************************************************/ 
typedef void(*fnet_dns_callback_resolved_t)(const fnet_dns_resolved_addr_t *addr_list, fnet_size_t addr_list_size, const fnet_char_t *host_name, void *cookie);

/**************************************************************************/ 
struct fnet_dns_params
{
    struct fnet_sockaddr            dns_server_addr;    
    const fnet_char_t               *host_name;         
    fnet_address_family_t           addr_family;        
    fnet_dns_callback_resolved_t    callback;            
    void                            *cookie;            
};

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

/***************************************************************************/ 
fnet_dns_desc_t fnet_dns_init( struct fnet_dns_params *params );

/***************************************************************************/ 
void fnet_dns_release(fnet_dns_desc_t desc);

/***************************************************************************/ 
fnet_bool_t fnet_dns_is_enabled(fnet_dns_desc_t desc);

#if defined(__cplusplus)
}
#endif

#endif /* FNET_CFG_DNS */

#endif /* _FNET_DNS_H_ */