Javascript DNS

From Yate Documentation
(Difference between revisions)
Jump to: navigation, search
(Added resolve() and local())
 
Line 57: Line 57:
 
* '''local(address)'''
 
* '''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.
 
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