| Allegro CL version 6.2 Significant update since 6.2 release. | |||||||||
Arguments: name &key type nameserver repeat timeout queue decode
This function was modified by a patch release approximately April 4,
2003. There are two mdofications: one causes a fourth value to be
returned. That value is a list of the flags returned by the dns server
that replied to the query. The second modificaation allows the value
:any as a value for the type
keyword argument (see below for further information). You must have
installed the patch (with, e.g., sys:update-allegro) after April 4,
2003, in order for the function to work as now described. The change
is essentially backward compatible (unless you depend for some reason
on exactly three values being returned).
The arguments are:
| Name | Default | What |
|---|---|---|
| name | Depending on the value of the type argument, this is either a string or an integer IP address. | |
| type | :a |
The type of dns query to make.:a means determine
the ip address(es) for the given name. (name
should be a string.):ptr means determine the
hostname for a given IP address. (name
should be an integer IP address.):mx means determine if there is
another machine that email for name
should be directed. (name
should be a string.)
:any means return
all information about the first argument. decode
should be specified nil (its default is
t) when
type is :any.
You must have installed patches after April 4, 2003 for
:any to be accepted as a value for
type. See the note just below the argument
list above. |
| nameserver | nil |
If specified this can be an IP address or a list of IP addresses. This overrides the configured list of nameservers for just this query. |
| repeat | 5 | How many times to try to get an answer to this query before giving up. |
| timeout | 5 | How long to wait until we assume that a try has failed and we then try again or give up. The value should be an integer indicating a number of seconds. |
| queue | t |
If true then handle this request using the
background process that is
backed up by a cache of recent answers.
If this is nil then a
request will always be sent to the nameserver |
| decode | t |
The nameserver returns a structure of many fields.
If true then dns-query
will examine the returned structures and will return only the
information requested by the
query.
If this is nil then the result of
dns-query will
be the actual information returned by the nameserver.
This response is a dns-response object. See that
page for information on this raw object. Please specify
nil when you specify :any
as the value of type. |
If either nameserver is non nil or decode is nil, then queue will be set to nil regardless of the value of queue supplied. This ensures that a fresh query is sent to the nameserver.
Where an IP address is a valid argument, it can be specified as either an integer or as a string such as "192.132.95.1" or "127.1"
There are four return values from dns-query.
You must have installed patches after April 4, 2003 for the fourth value to be returned. See the note just below the argument list above.
There are examples of using dns-query in the subsections of The DNS API in dns.htm.
See dns.htm for information on the domain naming system utility in Allegro CL and see socket.htm for general information on sockets in Allegro CL.
Copyright (c) 1998-2002, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 6.2. This page was not revised from the 6.1 page.
Created 2002.2.26.
| Allegro CL version 6.2 Significant update since 6.2 release. | |||||||||