name -> IP-string

This commit is contained in:
mainzelm 2003-02-10 12:46:21 +00:00
parent e75388ad14
commit 35efb036af
1 changed files with 7 additions and 6 deletions

View File

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