From 93638b0677f3c4c6e30b99b0ee63efc52cbadb88 Mon Sep 17 00:00:00 2001 From: Robert Pluim Date: Tue, 17 Jul 2018 13:11:57 +0200 Subject: Add network-lookup-address-info description * doc/lispref/processes.texi (Misc Network): Document network-lookup-address-info. --- doc/lispref/processes.texi | 15 +++++++++++++++ 1 file changed, 15 insertions(+) (limited to 'doc') 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} -- cgit v1.2.1