doc/BIND-libraries

   1 Current ISC DHCP uses the BIND 9 libraries for some services.
   2 These libraries can be embedded in the bind directory or external using
   3 the configuration parameter --with-libbind=PATH with PATh pointing to
   4 the directory where can be found includes and libraries.
   5
   6 Using standard embedded libraries is safe but you can configure
   7 them with extra parameters (cf --with-bind-extra-config) or simply
   8 use external libraries with a different configuration.
   9
  10 Note if you want to share libraries between bind 9 and ISC DHCP
  11 BIND 9 must be built and installed before ISC DHCP build is configured.
  12
  13 Three cases are possible:
  14  - everything builds and works fine
  15
  16  - building requires extra parameters, for instance --enable-threads
  17   can require a link parameter to find  POSIX threads.
  18   In this case you should look at the config.status file of the bind
  19   libraries, take CC, CPPFLAGS, CFLAGS, LIBS or LDFLAGS related
  20   parameters, and add them to the call to make.
  21
  22  - even when the previous step succeeds ISC DHCP still does not work
  23   properly. We are trying to collect such cases (cf the list bellow)
  24   but unfortunately you have to forget the particular feature.
  25
  26 Below you have 3 kinds of don't use:
  27  - please don't use means it should likely break ISC DHCP
  28
  29  - don't use means unless you don't have a good reason to use it
  30
  31  - by default don't use it means you should not use it for embedded
  32   libraries but it doesn't lead to problems (other than possible
  33   new ISC DHCP build flags and bigger binaries) when used for
  34   external BIND 9 libraries
  35
  36 Possible bind9 configuration flags:
  37  -h, --help, -V, --version
  38     make configure to exit immediately so don't use
  39
  40  -q, --quiet, --silent, --cache-file, -C, --config-cache,
  41  --with-make-clean
  42     you have no reason to use them but they should not have bad effect
  43
  44  -n, --no-create
  45     make configure to exit too early so don't use
  46
  47  --prefix, --exec-prefix
  48     not used for embedded libraries but used by BIND 9
  49
  50  --bindir, --sbindir, --libexecdir, --sysconfdir, --sharedstatedir,
  51  --localstatedir, --oldincludedir,  --datarootdir, --datadir, --infodir,
  52  --localedir, --mandir, --docdir, --htmldir, --dvidir, --pdfdir, --psdir
  53     not used for embedded nor BIND 9 for its includes and libraries
  54
  55  --libdir, --includedir
  56     used for embedded libraries for the make install (cf the
  57     --enable-bind-install ISC DHCP configuration parameter)
  58
  59  --build, --host
  60     used for cross compiling and handled by ISC DHCP configure
  61
  62  --disable-option-checking
  63     this disables a sanity check so please don't use
  64
  65  --enable-shared, --enable-static, --enable-fast-install
  66     ignored by embedded or BIND 9 libraries configure
  67
  68  --disable-libtool-lock
  69     parallel builds don't work for embedded or BIND 9 libraries build
  70     so it should not have any effect
  71
  72   --enable-libbind
  73     this was deprecated so please don't use
  74
  75   --enable-warn-shadow
  76     for developers, should have no effect if compilers don't raise errors
  77     (vs warnings) on this (and a shadowing was left)
  78
  79   --enable-warn-error, --with-sysroot
  80     this likely breaks the build so please don't use
  81
  82   --enable-developer
  83     for developers, should have no direct effect but still recommend
  84     to not use it
  85
  86   --enable-afl
  87     for developers, useless for ISC DHCP so don't use
  88
  89   --enable-seccomp
  90     this should not have any effect for ISC DHCP?
  91
  92   --enable-kqueue, --enable-epoll, --enable-devpoll
  93     please use them at the ISC DHCP configure level, they should work
  94     but not yet fully tested so use at your own risk
  95
  96   --enable-threads
  97     this should work but not yet fully tested so use at your own risk.
  98     Note on many systems it requires an extra flag for ISC DHCP building
  99
 100   --enable-native-pkcs11
 101     You should not have a reason to use this and it likely won't work
 102     so please don't use
 103
 104   --enable-openssl-hash
 105     It likely requires a fix in ISC DHCP so please don't use
 106
 107   --enable-openssl-version-check
 108     You should never use an antic version of OpenSSL with known
 109     security bugs so please don't use
 110
 111   --enable-largefile
 112     Perhaps there is no systems today where this is required so
 113     by default don't use
 114
 115   --enable-backtrace, --enable-symtable
 116     this should have no effect for ISC DHCP?
 117
 118   --enable-ipv6, --enable-getifaddrs, --enable-atomic
 119     please leave embedded or BIND 9 libraries configure to do its job
 120     so please don't use
 121
 122   --disable-isc-spnego, --with-gssapi
 123     this should have no effect for ISC DHCP?
 124
 125   --disable-chroot, --disable-linux-caps, --enable-fixed-rrset,
 126   --disable-rpz-nsip, --disable-rpz-nsdname, --enable-filter-aaaa,
 127   --enable-querytrace, --enable-full-report, --with-python,
 128   --with-locktype, --with-pkcs11, --with-ecdsa, --with-gost,
 129   --with-aes, --with-cc-alg, --with-purify, --with-gperftools-profiler,
 130   --with-kame, --with-docbook-xsl, --with-dlopen
 131     this should have no effect for ISC DHCP
 132
 133   --enable-dnstap, --with-geoip, --with-lmdb, --with-libxml2,
 134   --with-libjson, --with-zlib, --with-readline, --with-protobuf-c,
 135   --with-libfstrm, --with-idn, --with-libiconv, --with-iconv,
 136   --with-idnlib, --with-dlz-*
 137     useless for ISC DHCP so by default don't use
 138
 139   --with-pic
 140     this should have no effect for ISC DHCP?
 141
 142   --with-gnu-ld
 143     this should have no effect for ISC DHCP?
 144
 145   --with-randomdev, --with-atf
 146     please use them at the ISC DHCP configure level
 147
 148   --with-libtool
 149     not yet supported so please don't use
 150
 151   --with-openssl
 152     useless for ISC DHCP by default don't use but remember it is
 153     required for DNSSEC
 154
 155   --with-tuning
 156     by default don't use
 157
 158