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