X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=adns.git;a=blobdiff_plain;f=INSTALL;h=4c0ae67dfa772c7d9179075db63a2e66dbca9f7b;hp=2d64e61c6ae76beed22e3786c2f8379d02d76686;hb=239d2e4dfb6fcfc26fe3f740efae8f6944b99799;hpb=f9476535903f0225fba0733203580c88b30ad6a1 diff --git a/INSTALL b/INSTALL index 2d64e61..4c0ae67 100644 --- a/INSTALL +++ b/INSTALL @@ -1,55 +1,69 @@ -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 - pre-1.0 Linux glibc 2.1 (actually tested on Debian 2.2). - pre-1.0 FreeBSD 3.2 - pre-1.0 Solaris 2.6, 2.7, 2.8 - pre-1.0 HP-UX 10.20, 11.00 - pre-1.0 IRIX 6.5 *not* with GCC [1], --disable-dynamic + 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) +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. +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. + [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 @@ -81,7 +95,7 @@ details for adns. It is adns is Copyright (C) 1997-2000 Ian Jackson - Copyright (C) 1999 Tony Finch [1] + Copyright (C) 1999-2000 Tony Finch [1] Copyright (C) 1991 Massachusetts Institute of Technology [2] adns is free software; you can redistribute it and/or modify it under @@ -99,8 +113,8 @@ along with adns as the file COPYING; if not, email me at the address 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.