-INSTALLATION INSTRUCTIONS for ADNS
+INSTALLATION INSTRUCTIONS for GNU ADNS
1. Read the security note below.
2. Standard GNU package build process:
- $ ./configure
+ $ ./configure [--disable-dynamic] [--prefix=... ...]
$ make
# make install
-Unfortunately, since this is a beta, there is no good documentation
-yet. For now, use the comments in the public header file adns.h.
+Unfortunately, there is no comprehensive documentation yet. For now,
+use the comments in the public header file adns.h, and for the C
+programs their usage messages. If you find this information
+ambiguous, incomplete or wrong, please report it as a bug.
-You will find that adns requires a reasonably standard and up to date
-system.
+TESTED PLATFORMS
The following platforms have been tested at at least some point and
should work - please report if they don't:
[adns] OS
- 1.0 Linux glibc 2.1 (actually tested on Debian 2.2).
-
- 1.0 Solaris 2.6, 2.7, 2.8
+ 1.0 Linux glibc 2.1 (actually tested on Debian 2.2)
+ 1.0 Solaris 2.6, 2.7, 2.8 [3]
1.0 FreeBSD 3.2, 4.0 (no poll(2), so no adnsresfilter)
-These appear to work, but only with --disable-dynamic:
+The following work, but only with --disable-dynamic:
1.0 IRIX 6.5 *not* with GCC [1], [2]
1.0 AIX 4.1.5
1.0 HP-UX 10.20, 11.00
-
Later versions of the same OS should work too. [adns] is the latest
version of adns that has been tested. Usually entries in this table
mean they pass adns's own regression test, when compiled with GCC,
-and appear to install and run correctly. Notes/known problems:
- [1] IRIX 6.5 inet_ntoa seems to break with GCC.
- [2] Many spurious warnings from this platform's native compiler.
+and appear to install and run correctly.
+
+Notes/known problems:
+ [1] IRIX 6.5 inet_ntoa seems to break with GCC.
+ [2] The SGI IRIX compiler produces many spurious warnings.
+ [3] Dynamically linked, needs some help to find libadns.so.0.1.
The following platforms are known to be deficient and will not work:
- Solaris 2.5 Lacks vsnprintf - install glibc ?
- TruUnix64 (DEC UNIX 4.0f) Lacks vsnprintf - install glibc ?
+ Solaris 2.5 Lacks vsnprintf - install glibc ?
+ TruUnix64 (DEC UNIX 4.0f) Lacks vsnprintf - install glibc ?
Please don't report these problems unless you have a nice,
-straightforward solution or workaround for them.
+straightforward solution or workaround for them. (I don't consider
+including a `vsnprintf' implementation nice, so don't send me one.)
+
+
+PORTABILITY INFORMATION
+
+You will find that adns requires a reasonably standard and up to date
+system. Non-GNU, non-UNIX systems are not supported.
-In particular, the build system assumes that you have ELF shared
-libraries. If you don't then please don't send me patches to support
-your kind of shared libraries, and don't send me patches to use
-libtool. I'm not interested in supporting non-ELF shared libraries,
-and I dislike libtool. If you do not have ELF shared libraries then
-please use the --disable-shared configure option.
+The build system assumes by default that you have ELF shared
+libraries, and that the directory in which libadns.so.1 will be
+installed is on your dynamic library search path. If your system
+doesn't have ELF shared libraries then dynamic linking is not
+supported by adns. Use the --disable-shared configure option.
+Please don't send me patches to use libtool (which I dislike).
The adnsresfilter utility uses `tsearch' from the C library (a la SVID
-and X/Open). If your C library doesn't have tsearch you will find
-that configure arranges for adnsresfilter not to be built. To rectify
-this, install a C library containing tsearch, such as the GNU C
-library. It is best if tsearch uses an automatically-balancing tree
-algorithm, like the glibc version does. Simple binary trees may
-perform badly.
+and X/Open). If you don't have tsearch configure will arranges for
+adnsresfilter not to be built. To fix this, install a C library
+containing tsearch, such as the GNU C library. It is best if tsearch
+uses an automatically-balancing tree algorithm, like the glibc version
+does. Simple binary trees may perform badly.
You will probably find that GNU Make is required.
+Please do not report this as a bug; install GNU Make instead.
SECURITY AND PERFORMANCE - AN IMPORTANT NOTE
adns is
Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
- Copyright (C) 1999 Tony Finch <dot@dotat.at> [1]
+ Copyright (C) 1999-2000 Tony Finch <dot@dotat.at> [1]
Copyright (C) 1991 Massachusetts Institute of Technology [2]
adns is free software; you can redistribute it and/or modify it under
above or write to the Free Software Foundation, 59 Temple Place -
Suite 330, Boston, MA 02111-1307, USA.
-[1] Tony Finch holds the original copyright on
- client/adnslogres.c and client/fanftest.c.
+[1] Tony Finch holds the original copyright on client/adnslogres.c and
+ client/fanftest.c, and some modifications to those files.
[2] MIT hold the original copyright on the included install-sh,
which came via GNU autoconf.
#
# It is part of adns, which is
# Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
-# Copyright (C) 1999 Tony Finch <dot@dotat.at>
+# Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
check: all
$(MAKE) -C regress check
-README README-update:
- lynx -dump -number_links -cfg=/dev/null \
- http://www.chiark.greenend.org.uk/~ian/adns/ >README.tmp
+README: README.html
+ lynx -dump -number_links -cfg=/dev/null ./README.html >README.tmp
mv -f README.tmp README
TAGS info dvi:
* `fake' forward queries (allow nnn.nnn.nnn.nnn -> A)
* DNSSEC compatibility - be able to retreive KEY and SIG RRs
* DNSSEC minimum functionality - ignore Additional when AD set.
-* DNSSEC functionality - provide security ?
-* Test cancellation in regression tests.
* IPv6 name<->address translation - but which version ??
* IPv6 transport.
+* Threadsafe version/mode.
+* Caching in the library.
+* SRV RRs.
*
* It is part of adns, which is
* Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
- * Copyright (C) 1999 Tony Finch <dot@dotat.at>
+ * Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
#
# It is part of adns, which is
# Copyright (C) 1997-1999 Ian Jackson <ian@davenant.greenend.org.uk>
-# Copyright (C) 1999 Tony Finch <dot@dotat.at>
+# Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
#
# This file is part of adns, which is Copyright (C) 1997-1999 Ian Jackson
#
* Actually compile shared libraries by default !
* Fix adnsresfilter usage message to include correct default timeout.
- General Improvements:
+ General improvements:
* adnshost, adnslogres, adnsresfilter have options for config override.
* adnsresfilter has --debug option.
* Improvements to adnslogres (incl. new -c option) from Tony Finch.
- * Regression tests now include adnshost, adnslogres, adnsresfilter.
+
+ Regression test improvements:
+ * Tests now include adnshost, adnslogres and adnsresfilter.
* Test cancellation both before and after query completion.
Portability fixes and cleanups:
#
# It is part of adns, which is
# Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
-# Copyright (C) 1999 Tony Finch <dot@dotat.at>
+# Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
*
* It is part of adns, which is
* Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
- * Copyright (C) 1999 Tony Finch <dot@dotat.at>
+ * Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
*
* It is part of adns, which is
* Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
- * Copyright (C) 1999 Tony Finch <dot@dotat.at>
+ * Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
*
* It is part of adns, which is
* Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
- * Copyright (C) 1999 Tony Finch <dot@dotat.at>
+ * Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
*
* It is part of adns, which is
* Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
- * Copyright (C) 1999 Tony Finch <dot@dotat.at>
+ * Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
*/
/*
* This file is
- * Copyright (C) 1999 Tony Finch <dot@dotat.at>
+ * Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
* Copyright (C) 1999-2000 Ian Jackson <ian@davenant.greenend.org.uk>
*
* It is part of adns, which is
* Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
- * Copyright (C) 1999 Tony Finch <dot@dotat.at>
+ * Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
*
* It is part of adns, which is
* Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
- * Copyright (C) 1999 Tony Finch <dot@dotat.at>
+ * Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
*
* It is part of adns, which is
* Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
- * Copyright (C) 1999 Tony Finch <dot@dotat.at>
+ * Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
*
* It is part of adns, which is
* Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
- * Copyright (C) 1999 Tony Finch <dot@dotat.at>
+ * Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
#
# It is part of adns, which is
# Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
-# Copyright (C) 1999 Tony Finch <dot@dotat.at>
+# Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
#
# It is part of adns, which is
# Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
-# Copyright (C) 1999 Tony Finch <dot@dotat.at>
+# Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
#
# It is part of adns, which is
# Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
-# Copyright (C) 1999 Tony Finch <dot@dotat.at>
+# Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
#
# It is part of adns, which is
# Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
-# Copyright (C) 1999 Tony Finch <dot@dotat.at>
+# Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
#
# It is part of adns, which is
# Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
-# Copyright (C) 1999 Tony Finch <dot@dotat.at>
+# Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
m4_dnl
m4_dnl It is part of adns, which is
m4_dnl Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
-m4_dnl Copyright (C) 1999 Tony Finch <dot@dotat.at>
+m4_dnl Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
m4_dnl
m4_dnl This program is free software; you can redistribute it and/or modify
m4_dnl it under the terms of the GNU General Public License as published by
m4_dnl
m4_dnl It is part of adns, which is
m4_dnl Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
-m4_dnl Copyright (C) 1999 Tony Finch <dot@dotat.at>
+m4_dnl Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
m4_dnl
m4_dnl This program is free software; you can redistribute it and/or modify
m4_dnl it under the terms of the GNU General Public License as published by
m4_dnl
m4_dnl It is part of adns, which is
m4_dnl Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
-m4_dnl Copyright (C) 1999 Tony Finch <dot@dotat.at>
+m4_dnl Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
m4_dnl
m4_dnl This program is free software; you can redistribute it and/or modify
m4_dnl it under the terms of the GNU General Public License as published by
m4_dnl
m4_dnl It is part of adns, which is
m4_dnl Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
-m4_dnl Copyright (C) 1999 Tony Finch <dot@dotat.at>
+m4_dnl Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
m4_dnl
m4_dnl This program is free software; you can redistribute it and/or modify
m4_dnl it under the terms of the GNU General Public License as published by
m4_dnl
m4_dnl It is part of adns, which is
m4_dnl Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
-m4_dnl Copyright (C) 1999 Tony Finch <dot@dotat.at>
+m4_dnl Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
m4_dnl
m4_dnl This program is free software; you can redistribute it and/or modify
m4_dnl it under the terms of the GNU General Public License as published by
m4_dnl
m4_dnl It is part of adns, which is
m4_dnl Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
-m4_dnl Copyright (C) 1999 Tony Finch <dot@dotat.at>
+m4_dnl Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
m4_dnl
m4_dnl This program is free software; you can redistribute it and/or modify
m4_dnl it under the terms of the GNU General Public License as published by
m4_dnl
m4_dnl It is part of adns, which is
m4_dnl Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
-m4_dnl Copyright (C) 1999 Tony Finch <dot@dotat.at>
+m4_dnl Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
m4_dnl
m4_dnl This program is free software; you can redistribute it and/or modify
m4_dnl it under the terms of the GNU General Public License as published by
#
# It is part of adns, which is
# Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
-# Copyright (C) 1999 Tony Finch <dot@dotat.at>
+# Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
#
# It is part of adns, which is
# Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
-# Copyright (C) 1999 Tony Finch <dot@dotat.at>
+# Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
#
# It is part of adns, which is
# Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
-# Copyright (C) 1999 Tony Finch <dot@dotat.at>
+# Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
#
# It is part of adns, which is
# Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
-# Copyright (C) 1999 Tony Finch <dot@dotat.at>
+# Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
*
* It is part of adns, which is
* Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
- * Copyright (C) 1999 Tony Finch <dot@dotat.at>
+ * Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* GNU General Public License for more details.
*
*
- * For the benefit of certain LGPL'd `omnibus' software which provides
- * a uniform interface to various things including adns, I make the
- * following additional licence. I do this because the GPL would
- * otherwise force either the omnibus software to be GPL'd or for the
- * adns-using part to be distributed separately.
+ * For the benefit of certain LGPL'd `omnibus' software which
+ * provides a uniform interface to various things including adns, I
+ * make the following additional licence. I do this because the GPL
+ * would otherwise force either the omnibus software to be GPL'd or
+ * the adns-using part to be distributed separately.
*
- * So, you may also redistribute and/or modify adns.h (but only the
+ * So: you may also redistribute and/or modify adns.h (but only the
* public header file adns.h and not any other part of adns) under the
* terms of the GNU Library General Public License as published by the
* Free Software Foundation; either version 2 of the License, or (at
* applications where the whole distribution is not GPL'd, are still
* likely to be in violation of the GPL. Anyone who wants to do this
* should contact Ian Jackson. Please note that to avoid encouraging
- * people to infringe the GPL as it applies the body of adns, Ian thinks
- * that if you take advantage of the special exception to redistribute
- * just adns.h under the LGPL, you should retain this paragraph in its
- * place in the appropriate copyright statements.
+ * people to infringe the GPL as it applies to the body of adns, Ian
+ * thinks that if you take advantage of the special exception to
+ * redistribute just adns.h under the LGPL, you should retain this
+ * paragraph in its place in the appropriate copyright statements.
*
*
* You should have received a copy of the GNU General Public License,
#
# It is part of adns, which is
# Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
-# Copyright (C) 1999 Tony Finch <dot@dotat.at>
+# Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
*
* It is part of adns, which is
* Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
- * Copyright (C) 1999 Tony Finch <dot@dotat.at>
+ * Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
*
* It is part of adns, which is
* Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
- * Copyright (C) 1999 Tony Finch <dot@dotat.at>
+ * Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
*
* It is part of adns, which is
* Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
- * Copyright (C) 1999 Tony Finch <dot@dotat.at>
+ * Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
*
* It is part of adns, which is
* Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
- * Copyright (C) 1999 Tony Finch <dot@dotat.at>
+ * Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
*
* It is part of adns, which is
* Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
- * Copyright (C) 1999 Tony Finch <dot@dotat.at>
+ * Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
*
* It is part of adns, which is
* Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
- * Copyright (C) 1999 Tony Finch <dot@dotat.at>
+ * Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
*
* It is part of adns, which is
* Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
- * Copyright (C) 1999 Tony Finch <dot@dotat.at>
+ * Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
*
* It is part of adns, which is
* Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
- * Copyright (C) 1999 Tony Finch <dot@dotat.at>
+ * Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
*
* It is part of adns, which is
* Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
- * Copyright (C) 1999 Tony Finch <dot@dotat.at>
+ * Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
*
* It is part of adns, which is
* Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
- * Copyright (C) 1999 Tony Finch <dot@dotat.at>
+ * Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
*
* It is part of adns, which is
* Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
- * Copyright (C) 1999 Tony Finch <dot@dotat.at>
+ * Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
*
* It is part of adns, which is
* Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
- * Copyright (C) 1999 Tony Finch <dot@dotat.at>
+ * Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by