Javascript DNS

From Yate Documentation
(Difference between revisions)
Jump to: navigation, search
(Created page with "DNS resolver global object. == Methods == * '''query(type,name,async)''' Make a DNS query<br/> Parameters:<br/> '''type''' Type of DNS Record to query<br/> '''name''' Domai...")
 
 
(3 intermediate revisions by one user not shown)
Line 19: Line 19:
 
** replacement
 
** replacement
 
** name
 
** name
 +
** order
 +
** priority
 +
** ttl
 
* For SRV records are objects with fields:
 
* For SRV records are objects with fields:
 
** port
 
** port
 
** name
 
** name
 +
** order
 +
** priority
 +
** ttl
 
If ''async'' is boolean true the execution context is unlocked during the DNS operation.
 
If ''async'' is boolean true the execution context is unlocked during the DNS operation.
  
Line 30: Line 36:
  
 
* '''queryAaaa(name,async)'''
 
* '''queryAaaa(name,async)'''
Shortcut for ''query("AAAAA",name,async)''
+
Shortcut for ''query("AAAA",name,async)''
  
  
Line 43: Line 49:
 
* '''querySrv(name,async)'''
 
* '''querySrv(name,async)'''
 
Shortcut for ''query("SRV",name,async)''
 
Shortcut for ''query("SRV",name,async)''
 +
 +
 +
* '''resolve(name)'''
 +
Resolves the ''name'' using the system routines. This returns at most one address and takes into account the hosts file.
 +
 +
 +
* '''local(address)'''
 +
Returns the local IP address that is used by default as route to remote ''address''. Remote address can be specified by DNS name in which case it is resolved first.
 +
 +
 +
* '''pack(address,separator)'''
 +
Returns a hexadecimal string representing the packed representation of the IP address. Address can be specified by DNS name in which case it is resolved first.<br/>
 +
Returns ''undefined'' on error.
 +
 +
Parameters:<br/>
 +
'''address''' IP address to pack<br/>
 +
'''separator''' Optional hexadecimal octets separator<br/>
 +
 +
 +
* '''unpack(hexstr)'''
 +
Returns the canonical text form of the packed IP adress provided.
 +
 +
Parameters:<br/>
 +
'''hexstr''' Hexadecimal representation of the packed IP address, must be 4, 8 or 16 octets long. An 8 octets address is interpreted as a /64 IPv6 prefix.<br/>
 +
Returns ''undefined'' on error.

Latest revision as of 18:18, 18 December 2014

DNS resolver global object.

[edit] Methods

  • query(type,name,async)

Make a DNS query


Parameters:
type Type of DNS Record to query
name Domain Name to query
async Optional non-blocking flag
Return:
Array of records of uniform type.

  • For A, AAAA, TXT records are strings
  • For NAPTR records are objects with fields:
    • flags
    • service
    • regexp
    • replacement
    • name
    • order
    • priority
    • ttl
  • For SRV records are objects with fields:
    • port
    • name
    • order
    • priority
    • ttl

If async is boolean true the execution context is unlocked during the DNS operation.


  • queryA(name,async)

Shortcut for query("A",name,async)


  • queryAaaa(name,async)

Shortcut for query("AAAA",name,async)


  • queryTxt(name,async)

Shortcut for query("TXT",name,async)


  • queryNaptr(name,async)

Shortcut for query("NAPTR",name,async)


  • querySrv(name,async)

Shortcut for query("SRV",name,async)


  • resolve(name)

Resolves the name using the system routines. This returns at most one address and takes into account the hosts file.


  • local(address)

Returns the local IP address that is used by default as route to remote address. Remote address can be specified by DNS name in which case it is resolved first.


  • pack(address,separator)

Returns a hexadecimal string representing the packed representation of the IP address. Address can be specified by DNS name in which case it is resolved first.
Returns undefined on error.

Parameters:
address IP address to pack
separator Optional hexadecimal octets separator


  • unpack(hexstr)

Returns the canonical text form of the packed IP adress provided.

Parameters:
hexstr Hexadecimal representation of the packed IP address, must be 4, 8 or 16 octets long. An 8 octets address is interpreted as a /64 IPv6 prefix.
Returns undefined on error.

Personal tools
Namespaces

Variants
Actions
Preface
Configuration
Administrators
Developers