cvs: phpdoc /en/reference/network/functions dns-get-record.xml

derick Sun Nov 24 14:22:56 2002 EDT Modified files: /phpdoc/en/reference/network/functions dns-get-record.xml Log: - Fix XML Index: phpdoc/en/reference/network/functions/dns-get-record.xml diff -u phpdoc/en/reference/network/functions/dns-get-record.xml:1.3 phpdoc/en/reference/network/functions/dns-get-record.xml:1.4 --- phpdoc/en/reference/network/functions/dns-get-record.xml:1.3 Sat Nov 23 15:17:19 2002 +++ phpdoc/en/reference/network/functions/dns-get-record.xml Sun Nov 24 14:22:56 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <refentry id="function.dns-get-record"> <refnamediv> <refname>dns_get_record</refname> @@ -16,18 +16,27 @@ <methodparam choice="opt"><type>array</type><parameter>&amp;authns</parameter></methodparam> <methodparam><type>array</type><parameter>&amp;addtl</parameter></methodparam> </methodsynopsis> - <note> - This function is not implemented on Windows platforms. - </note> + <para> + <note> + <simpara> + This function is not implemented on Windows platforms. + </simpara> + </note> + </para> <para> Returns an array of associative arrays. Each associative array contains <emphasis>at minimum</emphasis> the following keys: host, type, class, ttl. <note> + <para> 'class' key will always be "IN" indicating an IPv4 resource record. + </para> </note> <note> - 'ttl' key will contain the TTL <emphasis>remaining</emphasis> since the - last time the local nameserver queried the authoritative name server. + <para> + 'ttl' key will contain the TTL <emphasis>remaining</emphasis> since + the last time the local nameserver queried the authoritative name + server. + </para> </note> Depending on the value of type, the associate array will also contain one or more of the following keys: ip, pri, target, cpu, os, mname, rname, serial, refresh, @@ -51,10 +60,12 @@ <constant>DNS_ALL</constant> or <constant>DNS_ANY</constant>. The default is <emphasis>DNS_ANY</emphasis>. <note> + <para> Because of excentricities in the performance of libresolv between platforms, <constant>DNS_ANY</constant> will not always return every record, the slower <constant>DNS_ALL</constant> will collect all records more reliably. + </para> </note> </para> <simpara> @@ -72,10 +83,12 @@ zone. 'serial', 'refresh', 'retry', 'expire', and 'minimum-ttl' give the traditional SOA zone values one would expect. <note> - Per DNS standards, email addresses are given in user.host format (for - example: hostmaster.example.com as opposed to hostmaster@example.com), - be sure to check this value and modify if necessary before using it with - a functions such as <function>mail</function>. + <para> + Per DNS standards, email addresses are given in user.host format (for + example: hostmaster.example.com as opposed to hostmaster@example.com), + be sure to check this value and modify if necessary before using it + with a functions such as <function>mail</function>. + </para> </note> </para> <simpara>