diff options
Diffstat (limited to 'Build/source/texk/web2c/luatexdir/luasocket/doc/dns.html')
-rw-r--r-- | Build/source/texk/web2c/luatexdir/luasocket/doc/dns.html | 69 |
1 files changed, 60 insertions, 9 deletions
diff --git a/Build/source/texk/web2c/luatexdir/luasocket/doc/dns.html b/Build/source/texk/web2c/luatexdir/luasocket/doc/dns.html index f4c3b07d2b7..c4a0472e23e 100644 --- a/Build/source/texk/web2c/luatexdir/luasocket/doc/dns.html +++ b/Build/source/texk/web2c/luatexdir/luasocket/doc/dns.html @@ -24,8 +24,8 @@ </td></tr> </table> <p class=bar> -<a href="home.html">home</a> · -<a href="home.html#download">download</a> · +<a href="index.html">home</a> · +<a href="index.html#download">download</a> · <a href="installation.html">installation</a> · <a href="introduction.html">introduction</a> · <a href="reference.html">reference</a> @@ -39,12 +39,16 @@ <h2 id=dns>DNS</h2> <p> -Name resolution functions return <em>all</em> information obtained from the -resolver in a table of the form: +IPv4 name resolution functions +<a href=#toip><tt>dns.toip</tt></a> +and +<a href=#tohostname><tt>dns.tohostname</tt></a> +return <em>all</em> information obtained from +the resolver in a table of the form: </p> <blockquote><tt> -resolved = {<br> +resolved4 = {<br> name = <i>canonic-name</i>,<br> alias = <i>alias-list</i>,<br> ip = <i>ip-address-list</i><br> @@ -55,6 +59,53 @@ resolved = {<br> Note that the <tt>alias</tt> list can be empty. </p> +<p> +The more general name resolution function +<a href=#getaddrinfo><tt>dns.getaddrinfo</tt></a>, which +supports both IPv6 and IPv4, +returns <em>all</em> information obtained from +the resolver in a table of the form: +</p> + +<blockquote><tt> +resolved6 = {<br> + [1] = {<br> + family = <i>family-name-1</i>,<br> + addr = <i>address-1</i><br> + },<br> + ...<br> + [n] = {<br> + family = <i>family-name-n</i>,<br> + addr = <i>address-n</i><br> + }<br> +} +</tt> </blockquote> + +<p> +Here, <tt>family</tt> contains the string <tt>"inet"</tt> for IPv4 +addresses, and <tt>"inet6"</tt> for IPv6 addresses. +</p> + +<!-- getaddrinfo ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ --> + +<p class=name id=getaddrinfo> +socket.dns.<b>getaddrinfo(</b>address<b>)</b> +</p> + +<p class=description> +Converts from host name to address. +</p> + +<p class=parameters> +<tt>Address</tt> can be an IPv4 or IPv6 address or host name. +</p> + +<p class=return> +The function returns a table with all information returned by +the resolver. In case of error, the function returns <b><tt>nil</tt></b> +followed by an error message. +</p> + <!-- gethostname ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ --> <p class=name id=gethostname> @@ -72,7 +123,7 @@ socket.dns.<b>tohostname(</b>address<b>)</b> </p> <p class=description> -Converts from IP address to host name. +Converts from IPv4 address to host name. </p> <p class=parameters> @@ -93,7 +144,7 @@ socket.dns.<b>toip(</b>address<b>)</b> </p> <p class=description> -Converts from host name to IP address. +Converts from host name to IPv4 address. </p> <p class=parameters> @@ -113,8 +164,8 @@ message. <hr> <center> <p class=bar> -<a href="home.html">home</a> · -<a href="home.html#down">download</a> · +<a href="index.html">home</a> · +<a href="index.html#down">download</a> · <a href="installation.html">installation</a> · <a href="introduction.html">introduction</a> · <a href="reference.html">reference</a> |