/usr/share/doc/lua-socket
NameSizeModeActions
dns.html47100644editdlrm
ftp.html95650644editdlrm
http.html114490644editdlrm
index.html75690644editdlrm
installation.html38830644editdlrm
introduction.html124330644editdlrm
ltn12.html109360644editdlrm
lua05.ppt3041280644editdlrm
luasocket.png117320644editdlrm
mime.html141600644editdlrm
README2370644editdlrm
reference.css9500644editdlrm
reference.html75830644editdlrm
smtp.html145030644editdlrm
socket.html138660644editdlrm
tcp.html214580644editdlrm
udp.html169210644editdlrm
url.html84300644editdlrm
Edit: /usr/share/doc/lua-socket/dns.html (4710B)
LuaSocket: DNS support

LuaSocket
Network support for the Lua language

home · download · installation · introduction · reference


DNS

IPv4 name resolution functions dns.toip and dns.tohostname return all information obtained from the resolver in a table of the form:

resolved4 = {
  name = canonic-name,
  alias = alias-list,
  ip = ip-address-list
}

Note that the alias list can be empty.

The more general name resolution function dns.getaddrinfo, which supports both IPv6 and IPv4, returns all information obtained from the resolver in a table of the form:

resolved6 = {
  [1] = {
    family = family-name-1,
    addr = address-1
  },
  ...
  [n] = {
    family = family-name-n,
    addr = address-n
  }
}

Here, family contains the string "inet" for IPv4 addresses, and "inet6" for IPv6 addresses.

socket.dns.getaddrinfo(address)

Converts from host name to address.

Address can be an IPv4 or IPv6 address or host name.

The function returns a table with all information returned by the resolver. In case of error, the function returns nil followed by an error message.

socket.dns.gethostname()

Returns the standard host name for the machine as a string.

socket.dns.tohostname(address)

Converts from IPv4 address to host name.

Address can be an IP address or host name.

The function returns a string with the canonic host name of the given address, followed by a table with all information returned by the resolver. In case of error, the function returns nil followed by an error message.

socket.dns.toip(address)

Converts from host name to IPv4 address.

Address can be an IP address or host name.

Returns a string with the first IP address found for address, followed by a table with all information returned by the resolver. In case of error, the function returns nil followed by an error message.