README 2.91 KB
Newer Older
Jeremy C. Reed's avatar
Jeremy C. Reed committed
1

2
This is the source for the BIND 10 suite.
Jeremy C. Reed's avatar
Jeremy C. Reed committed
3 4

BIND is the popular implementation of a DNS server, developer
5 6 7
interfaces, and DNS tools. BIND 10 is a rewrite of BIND 9 and ISC
DHCP. BIND 10 is written in C++ and Python and provides a modular
environment for serving, maintaining, and developing DNS and DHCP.
Jeremy C. Reed's avatar
Jeremy C. Reed committed
8

9
This release includes the bind10 master process, b10-msgq message
10 11 12 13 14
bus, b10-cmdctl remote control daemon, b10-cfgmgr configuration
manager, b10-stats statistics collection and reporting daemon, and
b10-stats-httpd for HTTP access to XML-formatted stats.

For DNS services, it provides the b10-auth authoritative DNS server
15 16 17 18 19
(with SQLite3 and in-memory backends), b10-xfrin IXFR/AXFR inbound
service, b10-xfrout outgoing IXFR/AXFR service, b10-zonemgr secondary
manager, libdns++ library for C++ with a python wrapper, and many
tests and example programs. (It also includes an experimental proof
of concept recursive or forwarding DNS server, b10-resolver.)
20 21

BIND 10 also provides experimental DHCPv4 and DHCPv6 servers,
22 23 24 25 26
b10-dhcp4 and b10-dhcp6, a dynamic DNS update module, b10-dhcp-ddns,
a portable DHCP library, libdhcp++, and a DHCP benchmarking tool,
perfdhcp.  In this release of BIND 10, the DHCPv4 and DHCPv6 servers
must be considered experimental.  Limitations and known issues with
this DHCP release can be found at http://bind10.isc.org/wiki/KeaKnownIssues
Jeremy C. Reed's avatar
Jeremy C. Reed committed
27

28 29 30 31 32 33
NOTE: The API/ABI provided by libraries in BIND 10 may change in future
point releases. So please do not assume currently that any code that you
compile for a particular version of a BIND 10 library will work in
future versions of the library. We aim to stabilize the public API/ABI
interface of BIND 10 libraries in future releases.

Jeremy C. Reed's avatar
Jeremy C. Reed committed
34 35 36 37
Documentation is included with the source. See doc/guide/bind10-guide.txt
(or bind10-guide.html) for installation instructions.  The
documentation is also available via the BIND 10 website at
http://bind10.isc.org/
Jeremy C. Reed's avatar
Jeremy C. Reed committed
38

Jeremy C. Reed's avatar
Jeremy C. Reed committed
39
The latest released source tar file may be downloaded from:
Jeremy C. Reed's avatar
Jeremy C. Reed committed
40 41 42 43 44 45 46 47 48 49 50 51

        ftp://ftp.isc.org/isc/bind10/

Users and developers are encouraged to participate on the BIND 10
mailing lists:

        https://lists.isc.org/mailman/listinfo/bind10-users
        https://lists.isc.org/mailman/listinfo/bind10-dev

Bugs may be reported as tickets via the developers website:

        http://bind10.isc.org/
52

Jeremy C. Reed's avatar
Jeremy C. Reed committed
53
Simple build and installation instructions:
54

55 56
  ./configure
  make
Jeremy C. Reed's avatar
Jeremy C. Reed committed
57
  make install
58

59
If building from Git repository, run:
Jeremy C. Reed's avatar
Jeremy C. Reed committed
60 61 62 63 64

  autoreconf --install

before running ./configure

Jeremy C. Reed's avatar
Jeremy C. Reed committed
65 66
See the Guide for detailed installation directions at
doc/guide/bind10-guide.txt.
67

Jeremy C. Reed's avatar
Jeremy C. Reed committed
68
For operating system specific tips see the wiki at:
69

Jeremy C. Reed's avatar
Jeremy C. Reed committed
70
       http://bind10.isc.org/wiki/SystemSpecificNotes
71

Jeremy C. Reed's avatar
Jeremy C. Reed committed
72
Please see the wiki and the doc/ directory for various documentation.
73

74 75 76 77
The BIND 10 suite is started by running "bind10". Note that the default
configuration does not start any DNS or DHCP services.  Please see the
Guide for information on how to configure these services to be started
automatically.