summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorRobert Pluim <rpluim@gmail.com>2018-07-17 13:11:57 +0200
committerRobert Pluim <rpluim@gmail.com>2018-07-17 13:11:57 +0200
commit93638b0677f3c4c6e30b99b0ee63efc52cbadb88 (patch)
treef407631102413226847468736ac56d19661a26db /doc
parentf8d9d00b0e95a7a62cd4fe8483793c26c3b753db (diff)
downloademacs-93638b0677f3c4c6e30b99b0ee63efc52cbadb88.tar.gz
Add network-lookup-address-info description
* doc/lispref/processes.texi (Misc Network): Document network-lookup-address-info.
Diffstat (limited to 'doc')
-rw-r--r--doc/lispref/processes.texi15
1 files changed, 15 insertions, 0 deletions
diff --git a/doc/lispref/processes.texi b/doc/lispref/processes.texi
index 447644022c5..557cd4678a3 100644
--- a/doc/lispref/processes.texi
+++ b/doc/lispref/processes.texi
@@ -2923,6 +2923,21 @@ If the vector does not include the port number, @var{p}, or if
@code{:@var{p}} suffix.
@end defun
+@defun network-lookup-address-info name &optional family
+This function is used to perform hostname lookups on @var{name}, which
+is expected to be an ASCII-only string, otherwise an error is
+signaled. Call @code{puny-encode-domain} on @var{name}
+first if you wish to lookup internationalized hostnames.
+
+If successful it returns a list of Lisp representations of network
+addresses (without port numbers), otherwise it returns @code{nil}.
+
+By default both IPv4 and IPv6 lookups are attempted. The optional
+argument @var{family} controls this behavior, specifying the symbol
+@code{ipv4} or @code{ipv6} restricts lookups to IPv4 and IPv6
+respectively.
+@end defun
+
@node Serial Ports
@section Communicating with Serial Ports
@cindex @file{/dev/tty}