emacs-diffs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Emacs-diffs] netsec 93638b0 3/4: Add network-lookup-address-info descri


From: Robert Pluim
Subject: [Emacs-diffs] netsec 93638b0 3/4: Add network-lookup-address-info description
Date: Tue, 17 Jul 2018 14:05:25 -0400 (EDT)

branch: netsec
commit 93638b0677f3c4c6e30b99b0ee63efc52cbadb88
Author: Robert Pluim <address@hidden>
Commit: Robert Pluim <address@hidden>

    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(+)

diff --git a/doc/lispref/processes.texi b/doc/lispref/processes.texi
index 4476440..557cd46 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
 
address@hidden 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
address@hidden or @code{ipv6} restricts lookups to IPv4 and IPv6
+respectively.
address@hidden defun
+
 @node Serial Ports
 @section Communicating with Serial Ports
 @cindex @file{/dev/tty}



reply via email to

[Prev in Thread] Current Thread [Next in Thread]