Home | History | Annotate | Line # | Download | only in doc
      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 (list built from bind 9.11 and bind 9.12
     37 various branches even ISC DHCP uses only the git v9_11 branch):
     38  -h, --help, -V, --version
     39     make configure to exit immediately so don't use
     40 
     41  -q, --quiet, --silent, --cache-file, -C, --config-cache,
     42  --with-make-clean
     43     you have no reason to use them but they should not have bad effect
     44 
     45  -n, --no-create
     46     make configure to exit too early so don't use
     47 
     48  --prefix, --exec-prefix
     49     not used for embedded libraries but used by BIND 9
     50 
     51  --bindir, --sbindir, --libexecdir, --sysconfdir, --sharedstatedir,
     52  --localstatedir, --oldincludedir,  --datarootdir, --datadir, --infodir,
     53  --localedir, --mandir, --docdir, --htmldir, --dvidir, --pdfdir, --psdir
     54     not used for embedded nor BIND 9 for its includes and libraries
     55 
     56  --libdir, --includedir
     57     used for embedded libraries for the make install (cf the
     58     --enable-bind-install ISC DHCP configuration parameter)
     59 
     60  --build, --host
     61     used for cross compiling and handled by ISC DHCP configure
     62 
     63  --disable-option-checking
     64     this disables a sanity check so please don't use
     65 
     66  --enable-shared, --enable-static, --enable-fast-install
     67     ignored by embedded or BIND 9 libraries configure
     68 
     69  --disable-libtool-lock
     70     parallel builds don't work for embedded or BIND 9 libraries build
     71     so it should not have any effect
     72 
     73   --enable-libbind
     74     this was deprecated so please don't use
     75 
     76   --enable-warn-shadow
     77     for developers, should have no effect if compilers don't raise errors
     78     (vs warnings) on this (and a shadowing was left)
     79 
     80   --enable-warn-error, --with-sysroot
     81     this likely breaks the build so please don't use
     82 
     83   --enable-developer
     84     for developers, should have no direct effect but still recommend
     85     to not use it
     86 
     87   --enable-afl
     88     for developers, useless for ISC DHCP so don't use
     89 
     90   --enable-seccomp
     91     this should not have any effect for ISC DHCP?
     92 
     93   --enable-kqueue, --enable-epoll, --enable-devpoll
     94     please use them at the ISC DHCP configure level, they should work
     95     but not yet fully tested so use at your own risk
     96 
     97   --enable-threads
     98     this should work but not yet fully tested so use at your own risk.
     99     Note on many systems it requires an extra flag for ISC DHCP building
    100     and some experiments showed a large slow down when this is enabled
    101 
    102   --enable-native-pkcs11
    103     You should not have a reason to use this and it likely won't work
    104     so please don't use
    105 
    106   --enable-openssl-version-check
    107     You should never use an antic version of OpenSSL with known
    108     security bugs so please don't use
    109 
    110   --enable-openssl-hash
    111     Comes with --with-openssl so if OpenSSL raises some problems with
    112     hash or HMAC you can try to disable this
    113 
    114   --enable-crypto-rand
    115     Comes with --with-openssl so if OpenSSL raises some problems with
    116     random number generation you can try to disable this
    117 
    118   --enable-largefile
    119     Perhaps there is no systems today where this is required so
    120     by default don't use
    121 
    122   --enable-backtrace, --enable-symtable
    123     this should have no effect for ISC DHCP?
    124 
    125   --enable-ipv6, --disable-tcp-fastopen, --enable-getifaddrs, --enable-atomic
    126     please leave embedded or BIND 9 libraries configure to do its job
    127     so please don't use
    128 
    129   --disable-isc-spnego, --with-gssapi
    130     this should have no effect for ISC DHCP?
    131 
    132   --enable-full-report
    133     this should have no effect for ISC DHCP but is still useful
    134     to get more information about bind configuration so use it
    135     if you believe it can be useful
    136 
    137   --disable-chroot, --disable-linux-caps, --enable-fixed-rrset,
    138   --disable-rpz-nsip, --disable-rpz-nsdname, --enable-filter-aaaa,
    139   --enable-querytrace, --with-python, --with-python-install-dir,
    140   --with-locktype, --with-pkcs11, --with-ecdsa, --with-gost,
    141   --with-eddsa, --with-aes, --with-cc-alg, --with-purify,
    142   --with-gperftools-profiler, --with-kame, --with-docbook-xsl,
    143   --with-dlopen
    144     this should have no effect for ISC DHCP
    145 
    146   --enable-dnsrps-dl, --enable-dnsrps, --enable-dnstap, --with-geoip,
    147   --with-lmdb, --with-libxml2, --with-libjson, --with-zlib,
    148   --with-readline, --with-dnsrps-libname, --with-dnsrps-dir,
    149   --with-protobuf-c, --with-libfstrm, --with-idn, --with-libiconv,
    150   --with-iconv, --with-idnlib, --with-dlz-*
    151     useless for ISC DHCP so by default don't use
    152 
    153   --with-pic
    154     this should have no effect for ISC DHCP?
    155 
    156   --with-gnu-ld
    157     this should have no effect for ISC DHCP?
    158 
    159   --with-randomdev, --with-atf
    160     please use them at the ISC DHCP configure level
    161 
    162   --with-libtool
    163     please leave the ISC DHCP configure manage this
    164 
    165   --with-openssl
    166     useless for ISC DHCP by default don't use but remember it is
    167     required for DNSSEC
    168 
    169   --with-tuning
    170     by default don't use
    171