Difference between revisions of "Unit DNS"

From Ultibo.org
Jump to: navigation, search
Line 20: Line 20:
 
{| class="wikitable" style="font-size: 14px; background: white;"
 
{| class="wikitable" style="font-size: 14px; background: white;"
 
|-
 
|-
| <code>DNS_TIMEOUT = 5000;</code>
+
| <code>DNS_TIMEOUT = 2000;</code>
| We wait for 5 seconds for a DNS reply
+
| We wait for 2 seconds for a DNS reply
 
|-
 
|-
| <code>DNS_RETRIES = 4;</code>
+
| <code>DNS_RETRIES = 2;</code>
| Try the request 4 times
+
| Try the request 2 times
 
|-
 
|-
 
|colspan="2"|&nbsp;
 
|colspan="2"|&nbsp;
Line 77: Line 77:
 
<br />  
 
<br />  
 
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
 
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
<div style="font-size: 14px; padding-left: 12px;">'''DNS field masks''' <code> DNS_OPCODE_* </code></div>
+
<div style="font-size: 14px; padding-left: 12px;">'''DNS field mask''' <code> DNS_OPCODE_* </code></div>
 
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 
{| class="wikitable" style="font-size: 14px; background: white;"
 
{| class="wikitable" style="font-size: 14px; background: white;"
Line 91: Line 91:
 
<br />  
 
<br />  
 
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
 
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
<div style="font-size: 14px; padding-left: 12px;">'''DNS query code''' <code> DNS_QUERY* </code></div>
+
<div style="font-size: 14px; padding-left: 12px;">'''DNS opcode''' <code> DNS_OPCODE* </code></div>
 
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 
{| class="wikitable" style="font-size: 14px; background: white;"
 
{| class="wikitable" style="font-size: 14px; background: white;"
 
|-
 
|-
| <code>DNS_QUERY = 0;</code>
+
| <code>DNS_OPCODE_QUERY = 0;</code>
 
| A standard query
 
| A standard query
 
|-
 
|-
| <code>DNS_INV_QUERY = 1;</code>
+
| <code>DNS_OPCODE_IQUERY = 1;</code>
 
| An inverse query
 
| An inverse query
 
|-
 
|-
| <code>DNS_COMP_QUERY_MULTI = 2;</code>
+
| <code>DNS_OPCODE_SERVER_STATUS = 2;</code>
| A completion query, multiple reply (Obsolete)
+
| &nbsp;
 
|-
 
|-
| <code>DNS_COMP_QUERY_SINGLE = 3;</code>
+
| <code>DNS_OPCODE_UNKNOWN = 3;</code>
| A completion query, single reply (Obsolete)
+
| &nbsp;)
 +
|-
 +
| <code>DNS_OPCODE_NOTIFY = 4;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_OPCODE_UPDATE = 5;</code>
 +
| &nbsp;
 
|-
 
|-
 
|}
 
|}
Line 111: Line 117:
 
<br />  
 
<br />  
 
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
 
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
<div style="font-size: 14px; padding-left: 12px;">'''DNS response code''' <code> DNS_NO_* </code></div>
+
<div style="font-size: 14px; padding-left: 12px;">'''DNS response code''' <code> DNS_RESPONSE_* </code></div>
 
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 
{| class="wikitable" style="font-size: 14px; background: white;"
 
{| class="wikitable" style="font-size: 14px; background: white;"
 
|-
 
|-
| <code>DNS_NO_ERROR = 0;</code>
+
| <code>DNS_RESPONSE_NO_ERROR = 0;</code>
 
| style="width: 50%;"|&nbsp;
 
| style="width: 50%;"|&nbsp;
 
|-
 
|-
| <code>DNS_FORMAT_ERROR = 1;</code>
+
| <code>DNS_RESPONSE_FORMAT_ERROR = 1;</code>
 
| &nbsp;
 
| &nbsp;
 
|-
 
|-
| <code>DNS_SERVER_FAILURE = 2;</code>
+
| <code>DNS_RESPONSE_SERVER_FAILURE = 2;</code>
 
| &nbsp;
 
| &nbsp;
 
|-
 
|-
| <code>DNS_NAME_ERROR = 3;</code>
+
| <code>DNS_RESPONSE_NAME_ERROR = 3;</code>
 
| &nbsp;
 
| &nbsp;
 
|-
 
|-
| <code>DNS_NOT_IMPLEMENTED = 4;</code>
+
| <code>DNS_RESPONSE_NOT_IMPLEMENTED = 4;</code>
 
| &nbsp;
 
| &nbsp;
 
|-
 
|-
| <code>DNS_REFUSED = 5;</code>
+
| <code>DNS_RESPONSE_REFUSED = 5;</code>
 
| &nbsp;
 
| &nbsp;
 
|-
 
|-
Line 141: Line 147:
 
{| class="wikitable" style="font-size: 14px; background: white;"
 
{| class="wikitable" style="font-size: 14px; background: white;"
 
|-
 
|-
| <code>DNS_TYPE_A = 1;</code>
+
| <code>DNS_TYPE_A = $0001;</code>
 
| Host address resource record (RR)
 
| Host address resource record (RR)
 
|-
 
|-
| <code>DNS_TYPE_NS = 2;</code>
+
| <code>DNS_TYPE_NS = $0002;</code>
 
| &nbsp;
 
| &nbsp;
 
|-
 
|-
| <code>DNS_TYPE_MD = 3;</code>
+
| <code>DNS_TYPE_MD = $0003;</code>
 
| &nbsp;
 
| &nbsp;
 
|-
 
|-
| <code>DNS_TYPE_MF = 4;</code>
+
| <code>DNS_TYPE_MF = $0004;</code>
 
| &nbsp;
 
| &nbsp;
 
|-
 
|-
| <code>DNS_TYPE_CNAME = 5;</code>
+
| <code>DNS_TYPE_CNAME = $0005;</code>
 
| &nbsp;
 
| &nbsp;
 
|-
 
|-
| <code>DNS_TYPE_SOA = 6;</code>
+
| <code>DNS_TYPE_SOA = $0006;</code>
 
| &nbsp;
 
| &nbsp;
 
|-
 
|-
| <code>DNS_TYPE_MB = 7;</code>
+
| <code>DNS_TYPE_MB = $0007;</code>
 
| &nbsp;
 
| &nbsp;
 
|-
 
|-
| <code>DNS_TYPE_MG = 8;</code>
+
| <code>DNS_TYPE_MG = $0008;</code>
 
| &nbsp;
 
| &nbsp;
 
|-
 
|-
| <code>DNS_TYPE_MR = 9;</code>
+
| <code>DNS_TYPE_MR = $0009;</code>
 
| &nbsp;
 
| &nbsp;
 
|-
 
|-
| <code>DNS_TYPE_RT_NULL = 10;</code>
+
| <code>DNS_TYPE_NULL = $000a;</code>
 
| &nbsp;
 
| &nbsp;
 
|-
 
|-
| <code>DNS_TYPE_WKS = 11;</code>
+
| <code>DNS_TYPE_WKS = $000b;</code>
 
| &nbsp;
 
| &nbsp;
 
|-
 
|-
| <code>DNS_TYPE_PTR = 12;</code>
+
| <code>DNS_TYPE_PTR = $000c;</code>
 
| A domain name ptr
 
| A domain name ptr
 
|-
 
|-
| <code>DNS_TYPE_HINFO = 13;</code>
+
| <code>DNS_TYPE_HINFO = $000d;</code>
 
| &nbsp;
 
| &nbsp;
 
|-
 
|-
| <code>DNS_TYPE_MINFO = 14;</code>
+
| <code>DNS_TYPE_MINFO = $000e;</code>
 
| &nbsp;
 
| &nbsp;
 
|-
 
|-
| <code>DNS_TYPE_MX = 15;</code>
+
| <code>DNS_TYPE_MX = $000f;</code>
 
| Mail exchange
 
| Mail exchange
 +
|-
 +
| <code>DNS_TYPE_TEXT = $0010;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_RP = $0011;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_AFSDB = $0012;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_X25 = $0013;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_ISDN = $0014;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_RT = $0015;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_NSAP = $0016;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_NSAPPTR = $0017;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_SIG = $0018;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_KEY = $0019;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_PX = $001a;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_GPOS = $001b;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_AAAA = $001c;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_LOC = $001d;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_NXT = $001e;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_EID = $001f;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_NIMLOC = $0020;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_SRV = $0021;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_ATMA = $0022;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_NAPTR = $0023;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_KX = $0024;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_CERT = $0025;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_A6 = $0026;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_DNAME = $0027;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_SINK = $0028;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_OPT = $0029;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_DS = $002B;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_RRSIG = $002E;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_NSEC = $002F;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_DNSKEY = $0030;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_DHCID = $0031;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_UINFO = $0064;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_UID = $0065;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_GID = $0066;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_UNSPEC = $0067;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_ADDRS = $00f8;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_TKEY = $00f9;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_TSIG = $00fa;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_IXFR = $00fb;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_AXFR = $00fc;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_MAILB = $00fd;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_MAILA = $00fe;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_ALL = $00ff;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_ANY = $00ff;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_WINS = $ff01;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_WINSR = $ff02;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_TYPE_NBSTAT = DNS_TYPE_WINSR;</code>
 +
| &nbsp;
 
|-
 
|-
 
|}
 
|}
Line 194: Line 341:
 
{| class="wikitable" style="font-size: 14px; background: white;"
 
{| class="wikitable" style="font-size: 14px; background: white;"
 
|-
 
|-
| <code>DNS_CLASS_IN = 1;</code>
+
| <code>DNS_CLASS_INTERNET = $0001;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_CLASS_CSNET = $0002;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_CLASS_CHAOS = $0003;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_CLASS_HESIOD = $0004;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_CLASS_NONE = $00fe;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_CLASS_ALL = $00ff;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_CLASS_ANY = $00ff;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DNS_CLASS_IN = DNS_CLASS_INTERNET;</code>
 
| ARPA internet class
 
| ARPA internet class
 
|-
 
|-
| <code>DNS_CLASS_CS = 2;</code>
+
| <code>DNS_CLASS_CS = DNS_CLASS_CSNET;</code>
 
| &nbsp;
 
| &nbsp;
 
|-
 
|-
| <code>DNS_CLASS_WILD = 255;</code>
+
| <code>DNS_CLASS_WILD = DNS_CLASS_ANY;</code>
 
| Wildcard for several of the classifications
 
| Wildcard for several of the classifications
 
|-
 
|-
 
|}
 
|}
 
</div></div>
 
</div></div>
<br />  
+
<br />
 
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
 
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
 
<div style="font-size: 14px; padding-left: 12px;">'''DNS message compression''' <code> DNS_POINTER_* </code></div>
 
<div style="font-size: 14px; padding-left: 12px;">'''DNS message compression''' <code> DNS_POINTER_* </code></div>

Revision as of 02:15, 6 March 2025

Return to Unit Reference


Description


Ultibo DNS Client unit

Note: DNS Client is IPv4 based, for IPv6 see new Winsock2 functions

See RFC 1035 Section 4 for details

Constants



[Expand]
DNS specific constants DNS_*


[Expand]
DNS flag DNS_FLAG_*


[Expand]
DNS field mask DNS_OPCODE_*


[Expand]
DNS opcode DNS_OPCODE*


[Expand]
DNS response code DNS_RESPONSE_*


[Expand]
DNS record type DNS_TYPE_*


[Expand]
DNS address class DNS_CLASS_*


[Expand]
DNS message compression DNS_POINTER_*


Type definitions



DNS specific types

[Expand]

PDNSHeader = ^TDNSHeader;

TDNSHeader = packed record

DNS message

[Expand]

PDNSMessage = ^TDNSMessage;

TDNSMessage = packed record

DNS name

[Expand]

PDNSName = ^TDNSName;

TDNSName = array[0..MAX_DNS_NAME - 1] of Char;

DNS question

[Expand]

PDNSQuestion = ^TDNSQuestion;

TDNSQuestion = packed record

DNS resource

[Expand]

PDNSResource = ^TDNSResource;

TDNSResource = packed record

DNS client data

[Expand]

PDNSClientData = ^TDNSClientData;

TDNSClientData = record


Class definitions



DNS specific classes

TDNSClient = class(TNetworkClient)


Public variables


None defined

Function declarations



Initialization functions

[Expand]
procedure DNSInit;
Description: To be documented


[Expand]
function DNSStart:LongWord;
Description: To be documented


[Expand]
function DNSStop:LongWord;
Description: To be documented


Return to Unit Reference