dns_client.h File Reference

DNS client (Domain Name System) More...

#include "core/net.h"
#include "core/socket.h"
#include "core/udp.h"
#include "dns/dns_cache.h"

Go to the source code of this file.

Macros

#define DNS_CLIENT_SUPPORT   ENABLED
 
#define DNS_CLIENT_MAX_RETRIES   3
 
#define DNS_CLIENT_INIT_TIMEOUT   1000
 
#define DNS_CLIENT_MAX_TIMEOUT   5000
 
#define DNS_MIN_LIFETIME   1000
 
#define DNS_MAX_LIFETIME   3600000
 

Functions

error_t dnsResolve (NetInterface *interface, const char_t *name, HostType type, IpAddr *ipAddr)
 Resolve a host name using DNS. More...
 
error_t dnsSendQuery (DnsCacheEntry *entry)
 Send a DNS query message. More...
 
void dnsProcessResponse (NetInterface *interface, const IpPseudoHeader *pseudoHeader, const UdpHeader *udpHeader, const NetBuffer *buffer, size_t offset, void *param)
 Process incoming DNS response message. More...
 

Detailed Description

DNS client (Domain Name System)

License

Copyright (C) 2010-2018 Oryx Embedded SARL. All rights reserved.

This file is part of CycloneTCP Open.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Author
Oryx Embedded SARL (www.oryx-embedded.com)
Version
1.9.0

Definition in file dns_client.h.

Macro Definition Documentation

◆ DNS_CLIENT_INIT_TIMEOUT

#define DNS_CLIENT_INIT_TIMEOUT   1000

Definition at line 54 of file dns_client.h.

◆ DNS_CLIENT_MAX_RETRIES

#define DNS_CLIENT_MAX_RETRIES   3

Definition at line 47 of file dns_client.h.

◆ DNS_CLIENT_MAX_TIMEOUT

#define DNS_CLIENT_MAX_TIMEOUT   5000

Definition at line 61 of file dns_client.h.

◆ DNS_CLIENT_SUPPORT

#define DNS_CLIENT_SUPPORT   ENABLED

Definition at line 40 of file dns_client.h.

◆ DNS_MAX_LIFETIME

#define DNS_MAX_LIFETIME   3600000

Definition at line 75 of file dns_client.h.

◆ DNS_MIN_LIFETIME

#define DNS_MIN_LIFETIME   1000

Definition at line 68 of file dns_client.h.

Function Documentation

◆ dnsProcessResponse()

void dnsProcessResponse ( NetInterface interface,
const IpPseudoHeader pseudoHeader,
const UdpHeader udpHeader,
const NetBuffer buffer,
size_t  offset,
void *  param 
)

Process incoming DNS response message.

Parameters
[in]interfaceUnderlying network interface
[in]pseudoHeaderUDP pseudo header
[in]udpHeaderUDP header
[in]bufferMulti-part buffer containing the incoming DNS message
[in]offsetOffset to the first byte of the DNS message
[in]paramCallback function parameter (not used)

Definition at line 357 of file dns_client.c.

◆ dnsResolve()

error_t dnsResolve ( NetInterface interface,
const char_t name,
HostType  type,
IpAddr ipAddr 
)

Resolve a host name using DNS.

Parameters
[in]interfaceUnderlying network interface
[in]nameName of the host to be resolved
[in]typeHost type (IPv4 or IPv6)
[out]ipAddrIP address corresponding to the specified host name

Definition at line 52 of file dns_client.c.

◆ dnsSendQuery()

error_t dnsSendQuery ( DnsCacheEntry entry)

Send a DNS query message.

Parameters
[in]entryPointer to a valid DNS cache entry
Returns
Error code

Definition at line 213 of file dns_client.c.