name -> IP-string
This commit is contained in:
parent
e75388ad14
commit
35efb036af
|
@ -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:
|
||||||
|
|
Loading…
Reference in New Issue