Docs For Class Net_DNS

$answerfrom =

[line 153]

The origin of the packet.

This contains a string containing the IP address of the name server from which the answer was given.

Access: public

Type:

string

[ Top ]

$answersize =

[line 163]

The size of the answer packet.

This contains a integer containing the size of the DNS packet the server responded with.

Access: public

Type:

string

[ Top ]

$confpath =

[line 198]

A array of directories to search for the user's resolver config

See: Net_DNS_Resolver::$dotfile

Type:

string

[ Top ]

$debug =

[line 208]

debugging flag

If set to TRUE (non-zero), debugging code will be displayed as the resolver makes the request.

Access: public

Type:

boolean

[ Top ]

$defnames =

[line 130]

Unknown

Type:

mixed

[ Top ]

$dnsrch =

[line 134]

Unknown

Type:

mixed

[ Top ]

$domain =

[line 62]

The domain in which the resolver client host resides.

Access: public

Type:

string

[ Top ]

$dotfile = '.resolv.conf'

[line 189]

The name of the user defined resolv.conf

The resolver will attempt to look in both the current directory as well as the user's home directory for a user defined resolver configuration file

See: Net_DNS_Resolver::$confpath

Type:

string

[ Top ]

$errorstring =

[line 143]

Contains the value of the last error returned by the resolver.

Access: public

Type:

string

[ Top ]

$igntc =

[line 115]

Ignore TC (truncated) bit

If the server responds with the TC bit set on a response, and $igntc is set to 0, the resolver will automatically retransmit the request using virtual circuits (TCP).

Access: public

Type:

boolean

[ Top ]

$nameservers =

[line 44]

An array of all nameservers to query

Access: public

Type:

array

[ Top ]

$port =

[line 53]

The UDP port to use for the query (default = 53)

Access: public

Type:

integer

[ Top ]

$recurse =

[line 126]

Recursion Desired

Sets the value of the RD (recursion desired) bit in the header. If the RD bit is set to 0, the server will not perform recursion on the request.

Access: public

Type:

boolean

[ Top ]

$resolv_conf = '/etc/resolv.conf'

[line 178]

The location of the system resolv.conf file.

Type:

string

[ Top ]

$retrans =

[line 81]

The number of seconds between retransmission of unaswered queries

Access: public

Type:

integer

[ Top ]

$retry =

[line 90]

The number of times unanswered requests should be retried

Access: public

Type:

integer

[ Top ]

$searchlist =

[line 72]

The searchlist to apply to unqualified hosts

An array of strings containg domains to apply to unqualified hosts passed to the resolver.

Access: public

Type:

array

[ Top ]

$stayopen =

[line 104]

Unknown

Type:

mixed

[ Top ]

$tcp_timeout =

[line 170]

The number of seconds after which a TCP connection should timeout

Access: public

Type:

integer

[ Top ]

$useEnhancedSockets = true

[line 218]

use the (currently) experimental PHP socket library

If set to TRUE (non-zero), the Resolver will attempt to use the much more effecient PHP sockets extension (if available).

Access: public

Type:

boolean

[ Top ]

$usevc =

[line 100]

Whether or not to use TCP (Virtual Circuits) instead of UDP

If set to 0, UDP will be used unless TCP is required. TCP is required for questions or responses greater than 512 bytes.

Access: public

Type:

boolean

[ Top ]

Net_DNS_Resolver (Constructor) [line 260]

Net_DNS_Resolver Net_DNS_Resolver(
[
$defaults = array()])

Initializes the Resolver Object

Parameters:

$defaults —

[ Top ]

axfr [line 1131]

object Net_DNS_Packet axfr(
string
$dname, [string
$class = 'IN'], [boolean
$old = FALSE])

Performs an AXFR query (zone transfer)

Requests a zone transfer from the nameservers. Note that zone transfers will ALWAYS use TCP regardless of the setting of the Net_DNS_Resolver::$usevc flag. If $old is set to TRUE, Net_DNS requires a nameserver that supports the many-answers style transfer format. Large zone transfers will not function properly. Setting $old to TRUE is _NOT_ recommended and should only be used for backwards compatibility.

Access: public

Parameters:

string	`$dname`	—	The domain (zone) to transfer
string	`$class`	—	The class in which to look for the zone.
boolean	`$old`	—	Requires 'old' style many-answer format to function. Used for backwards compatibility only.

[ Top ]

axfr_next [line 1251]

object Net_DNS_RR axfr_next(
)

Requests the next RR from a existing transfer started with axfr_start

Return: Returns a Net_DNS_RR object of the next RR from a zone transfer.
See: Net_DNS_Resolver::send_tcp()

[ Top ]

axfr_old [line 1109]

object Net_DNS_Packet axfr_old(
string
$dname, [string
$class = 'IN'])

Performs an AXFR query (zone transfer) (OLD BUGGY STYLE)

This is deprecated and should not be used!

Access: public

Parameters:

string	`$dname`	—	The domain (zone) to transfer
string	`$class`	—	The class in which to look for the zone.

[ Top ]

axfr_start [line 1174]

object Net_DNS_Packet axfr_start(

$dname, [
$class = 'IN'], string
$packet, string
$packet_data)

Sends a packet via TCP to the list of name servers.

Return: Returns an answer packet object
See: Net_DNS_Resolver::send_tcp()

Parameters:

string	`$packet`	—	A packet object to send to the NS list
string	`$packet_data`	—	The data in the packet as returned by the Net_DNS_Packet::data() method
	`$dname`	—
	`$class`	—

[ Top ]

cname_addr [line 493]

void cname_addr(

$names, 
$packet)

Parameters:

	`$names`	—
	`$packet`	—

[ Top ]

make_query_packet [line 1063]

void make_query_packet(

$packetORname, [
$type = ''], [
$class = ''])

Unknown

Parameters:

	`$packetORname`	—
	`$type`	—
	`$class`	—

[ Top ]

nameservers [line 452]

void nameservers(
[
$nsa = array()])

Gets or sets the nameservers to be queried.

Returns the current nameservers if an array of new nameservers is not given as the argument OR sets the nameservers to the given nameservers.

Nameservers not specified by ip address must be able to be resolved by your systems default resolver to be used.

Access: public

Parameters:

$nsa —

[ Top ]

nextid [line 432]

void nextid(
)

Returns the next request Id to be used for the DNS packet header

[ Top ]

printhex [line 700]

void printhex(

$data)

Sends a packet via TCP to the list of name servers.

Parameters:

$data —

[ Top ]

query [line 649]

mixed query(
string
$name, [string
$type = 'A'], [string
$class = 'IN'])

Queries nameservers for an answer

Queries the nameservers listed in the resolver configuration for an answer to a question packet.

Return: an object of type Net_DNS_Packet on success, or FALSE on failure.
See: Net_DNS::typesbyname(), Net_DNS::classesbyname()
Access: public

Parameters:

string	`$name`	—	The name (LHS) of a resource record to query.
string	`$type`	—	The type of record to query.
string	`$class`	—	The class of record to query.

[ Top ]

rawQuery [line 605]

mixed rawQuery(
string
$name, [string
$type = 'A'], [string
$class = 'IN'])

Queries nameservers for an answer

Queries the nameservers listed in the resolver configuration for an answer to a question packet.

Return: an object of type Net_DNS_Packet, regarless of whether the packet has an answer or not
See: Net_DNS::typesbyname(), Net_DNS::classesbyname()
Access: public

Parameters:

string	`$name`	—	The name (LHS) of a resource record to query.
string	`$type`	—	The type of record to query.
string	`$class`	—	The class of record to query.

[ Top ]

read_config [line 333]

void read_config(
string
$file)

Reads and parses a resolver configuration file

Parameters:

string $file — The name of the file to open and parse

[ Top ]

read_env [line 370]

void read_env(
)

Examines the environment for resolver config information

[ Top ]

read_tcp [line 1318]

void read_tcp(

$sock, 
$nbytes, [
$debug = 0])

Unknown - not ported yet

Parameters:

	`$sock`	—
	`$nbytes`	—
	`$debug`	—

[ Top ]

res_init [line 302]

void res_init(
)

Initalizes the resolver library

res_init() searches for resolver library configuration files an initializes the various properties of the resolver object.

See: Net_DNS_Resolver::$resolv_conf, Net_DNS_Resolver::$dotfile, Net_DNS_Resolver::$confpath, Net_DNS_Resolver::$searchlist, Net_DNS_Resolver::$domain, Net_DNS_Resolver::$nameservers
Access: public

[ Top ]

search [line 528]

mixed search(
string
$name, [string
$type = 'A'], [string
$class = 'IN'])

Searches nameservers for an answer

Goes through the search list and attempts to resolve name based on the information in the search list.

Return: an object of type Net_DNS_Packet on success, or FALSE on failure.
See: Net_DNS::typesbyname(), Net_DNS::classesbyname()
Access: public

Parameters:

string	`$name`	—	The name (LHS) of a resource record to query.
string	`$type`	—	The type of record to query.
string	`$class`	—	The class of record to query.

[ Top ]

send [line 675]

object Net_DNS_Packet send(
string
$packetORname, [string
$qtype = ''], [string
$qclass = ''])

Sends a packet to a nameserver

Determines the appropriate communication method (UDP or TCP) and send a DNS packet to a nameserver. Use of the this function directly is discouraged. $packetORname should always be a properly formatted binary DNS packet. However, it is possible to send a query here and bypass Net_DNS_Resolver::query()

Return: An answer packet object

Parameters:

string	`$packetORname`	—	A binary DNS packet stream or a hostname to query
string	`$qtype`	—	This should not be used
string	`$qclass`	—	This should not be used

[ Top ]

send_tcp [line 735]

object Net_DNS_Packet send_tcp(
string
$packet, string
$packet_data)

Sends a packet via TCP to the list of name servers.

Return: Returns an answer packet object
See: Net_DNS_Resolver::send_udp(), Net_DNS_Resolver::send()

Parameters:

string	`$packet`	—	A packet object to send to the NS list
string	`$packet_data`	—	The data in the packet as returned by the Net_DNS_Packet::data() method

[ Top ]

send_udp [line 1043]

object Net_DNS_Packet send_udp(
object Net_DNS_Packet
$packet, string
$packet_data)

Sends a packet via UDP to the list of name servers.

This function sends a packet to a nameserver. send_udp calls either Net_DNS_Resolver::send_udp_no_sock_lib() or Net_DNS_Resolver::send_udp_with_sock_lib() depending on whether or not the sockets extension is compiled into PHP. Note that using the sockets extension is MUCH more effecient.

Return: Returns an answer packet object
See: Net_DNS_Resolver::send_tcp(), Net_DNS_Resolver::send(), Net_DNS_Resolver::send_udp(), Net_DNS_Resolver::send_udp_no_sock_lib()

Parameters:

object Net_DNS_Packet	`$packet`	—	A packet object to send to the NS list
string	`$packet_data`	—	The data in the packet as returned by the Net_DNS_Packet::data() method

[ Top ]

send_udp_no_sock_lib [line 838]

object Net_DNS_Packet send_udp_no_sock_lib(
string
$packet, string
$packet_data)

Sends a packet via UDP to the list of name servers.

This function sends a packet to a nameserver. It is called by send_udp if the sockets PHP extension is not compiled into PHP.

Return: Returns an answer packet object
See: Net_DNS_Resolver::send_tcp(), Net_DNS_Resolver::send(), Net_DNS_Resolver::send_udp(), Net_DNS_Resolver::send_udp_with_sock_lib()

Parameters:

string	`$packet`	—	A packet object to send to the NS list
string	`$packet_data`	—	The data in the packet as returned by the Net_DNS_Packet::data() method

[ Top ]

send_udp_with_sock_lib [line 948]

object Net_DNS_Packet send_udp_with_sock_lib(
string
$packet, string
$packet_data)

Sends a packet via UDP to the list of name servers.

This function sends a packet to a nameserver. It is called by send_udp if the sockets PHP extension is compiled into PHP.

Return: Returns an answer packet object
See: Net_DNS_Resolver::send_tcp(), Net_DNS_Resolver::send(), Net_DNS_Resolver::send_udp(), Net_DNS_Resolver::send_udp_no_sock_lib()

Parameters:

string	`$packet`	—	A packet object to send to the NS list
string	`$packet_data`	—	The data in the packet as returned by the Net_DNS_Packet::data() method

[ Top ]

string [line 406]

void string(
)

Builds a string containing the current state of the resolver

Builds formatted string containing the state of the resolver library suited for display.

Access: public

[ Top ]

Class: Net_DNS_Resolver

Class Overview

Variables

Methods

Inherited Variables

Inherited Methods

Class Details

Class Variables

$answerfrom =

$answersize =

$confpath =

$debug =

$defnames =

$dnsrch =

$domain =

$dotfile = '.resolv.conf'

$errorstring =

$igntc =

$nameservers =

$port =

$recurse =

$resolv_conf = '/etc/resolv.conf'

$retrans =

$retry =

$searchlist =

$stayopen =

$tcp_timeout =

$useEnhancedSockets = true

$usevc =

Method Detail

Net_DNS_Resolver (Constructor) [line 260]

Parameters:

axfr [line 1131]

Parameters:

axfr_next [line 1251]

axfr_old [line 1109]

Parameters:

axfr_start [line 1174]

Parameters:

cname_addr [line 493]

Parameters:

make_query_packet [line 1063]

Parameters:

nameservers [line 452]

Parameters:

nextid [line 432]

printhex [line 700]

Parameters:

query [line 649]

Parameters:

rawQuery [line 605]

Parameters:

read_config [line 333]

Parameters:

read_env [line 370]

read_tcp [line 1318]

Parameters:

res_init [line 302]

search [line 528]

Parameters:

send [line 675]

Parameters:

send_tcp [line 735]

Parameters:

send_udp [line 1043]

Parameters:

send_udp_no_sock_lib [line 838]

Parameters:

send_udp_with_sock_lib [line 948]

Parameters:

string [line 406]