Javascript DNS

From Yate Documentation
(Difference between revisions)
Jump to: navigation, search
(Methods)
 
(One intermediate revision by one user not shown)
Line 49: 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