diff --git a/doc/latex/dns.tex b/doc/latex/dns.tex index e1f0106..229469d 100644 --- a/doc/latex/dns.tex +++ b/doc/latex/dns.tex @@ -79,6 +79,7 @@ the library. The supertype of these conditions is \exi{dns-error}. \section{High-level Interface} \def\ipaddr{IP-address\xspace} +\def\ipstring{IP-string\xspace} \def\fqdn{FQDN\xspace} The library uses an internal store to cache data obtained from DNS @@ -104,20 +105,20 @@ accept. \var{Nameserver} is either a \ipaddr or a dotted IP string. to the ones found in \texttt{/etc/resolv.conf}. \end{desc} -\defun{dns-lookup-ip}{\ipaddr [nameserver list][use-cache?]}{\fqdn} +\defun{dns-lookup-ip}{\ipstring/\ipaddr [nameserver list][use-cache?]}{\fqdn} \begin{desc} Looks up the FQDN for the given IP address. The optional argument specifes the name servers to query, it defaults to the ones found in \texttt{/etc/resolv.conf}. \end{desc} -\defun{dns-lookup-nameserver}{name/\ipaddr [nameserver list][use-cache?]}{\ipaddr list} +\defun{dns-lookup-nameserver}{\ipstring/\ipaddr [nameserver list][use-cache?]}{\ipaddr list} \begin{desc} Looks up an authoritative name server for a hostname, returns a list of name servers. \end{desc} -\defun{dns-lookup-mail-exchanger}{name/\ipaddr [nameserver list][use-cache?]}{\fqdn list} +\defun{dns-lookup-mail-exchanger}{\ipstring/\ipaddr [nameserver list][use-cache?]}{\fqdn list} \begin{desc} Looks up mail-exchangers for a hostname und returns them in a list sorted by preference. @@ -129,8 +130,8 @@ accept. \var{Nameserver} is either a \ipaddr or a dotted IP string. obtain the information. \end{desc} -\defun{maybe-dns-lookup-name}{name [nameserver list][use-cache?]}{\ipaddr or \sharpf} -\defunx{maybe-dns-lookup-ip}{\ipaddr [nameserver list][use-cache?]}{\fqdn{} or \sharpf} +\defun{maybe-dns-lookup-name}{\fqdn [nameserver list][use-cache?]}{\ipaddr or \sharpf} +\defunx{maybe-dns-lookup-ip}{\ipstring/\ipaddr [nameserver list][use-cache?]}{\fqdn{} or \sharpf} \begin{desc} These procedures provide the same functionality as \ex{dns-lookup-name} and \ex{dns-lookup-ip} but return \sharpf{} in @@ -181,7 +182,7 @@ generating the \var{dns-message}. \ex{network-protocol} with the possible protocol names \ex{tcp} and \ex{udp}. \end{desc} -\defun{dns-lookup}{\fqdn{}/\ipaddr type [nameserver list][use-cache?]}{dns-message} +\defun{dns-lookup}{\ipstring/\ipaddr type [nameserver list][use-cache?]}{dns-message} \begin{desc} Convenient shortcut to submit a DNS query. The return value is a \ex{dns-message} structure: