summaryrefslogtreecommitdiff
path: root/README
blob: 58f8eeb128433faaf5655f3dc5760c3521d23451 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214

BIND 9

	BIND version 9 is a major rewrite of nearly all aspects of the
	underlying BIND architecture.  Some of the important features of
	BIND 9 are:

		- DNS Security
			DNSSEC (signed zones)
			TSIG (signed DNS requests)

		- IP version 6
			Answers DNS queries on IPv6 sockets
			IPv6 resource records (A6, DNAME, etc.)
			Bitstring Labels
			Experimental IPv6 Resolver Library

		- DNS Protocol Enhancements
			IXFR, DDNS, Notify, EDNS0
			Improved standards conformance

		- Views
			One server process can provide multiple "views" of
			the DNS namespace, e.g. an "inside" view to certain
			clients, and an "outside" view to others.

		- Multiprocessor Support

		- Improved Portability Architecture


	BIND version 9 development has been underwritten by the following
	organizations:

		Sun Microsystems, Inc.
		Hewlett Packard
		Compaq Computer Corporation
		IBM
		Process Software Corporation
		Silicon Graphics, Inc.
		Network Associates, Inc.
		U.S. Defense Information Systems Agency
		USENIX Association
		Stichting NLnet - NLnet Foundation


BIND 9.0.1

	BIND 9.0.1 is a maintenance release, containing fixes for a 
	number of bugs in BIND 9.0.0 but no new features (with the 
	exception of a few minor features added to dig, host, and 
	nslookup).

	Like BIND 9.0.0, BIND 9.0.1 is primarily a name server software
	distribution.  In addition to the name server, it also includes 
	a new lightweight stub resolver library and associated resolver
	daemon that fully support forward and reverse lookups of both
	IPv4 and IPv6 addresses.  This library is still considered
	experimental and is not a complete replacement for the BIND 8
	resolver library.  In particular, applications that use the
	BIND 8 res_* functions to perform DNS queries or dynamic
	updates still need to be linked against the BIND 8 libraries.

	BIND 9.0.1 is capable of acting as an authoritative server
	for DNSSEC secured zones.  This functionality is believed to
	be stable and complete except for lacking support for wildcard
	records in secure zones.

	When acting as a caching server, BIND 9.0.1 can be configured
	to perform DNSSEC secure resolution on behalf of its clients.
	This part of the DNSSEC implementation is still considered
	experimental.  For detailed information about the state of the
	DNSSEC implementation, see the file doc/misc/dnssec.

	There are a few known bugs:

		The option "query-source * port 53;" will not work as
		expected.  Instead of the wildcard address "*", you need 
		to use an explicit source IP address.

		On some systems, IPv6 and IPv4 sockets interact in
		unexpected ways.  For details, see doc/misc/ipv6.
		To reduce the impact of these problems, the server
		no longer listens for requests on IPv6 addresses
		by default.  If you need to accept DNS queries over
		IPv6, you must specify "listen-on-v6 { any; };"
		in the named.conf options statement.

		There are known problems with thread signal handling 
		under Solaris 2.6.

		The "isc_timer_reset" test sometimes fails on HP-UX 11
		for unknown reasons, but the server itself seems to
		run fine.

		On FreeBSD systems, the server logs error messages
		like "fcntl(8, F_SETFL, 4): Inappropriate ioctl for
		device".  This is due to a bug in the FreeBSD
		/dev/random device.  The bug has been reported
		to the FreeBSD maintainers.  Versions of OpenBSD
		prior to 2.8 have a similar problem.

		The configure option --disable-ipv6 is not functional.

		--with-libtool does not work on AIX.

		Due to bugs in the dnssafe library, RSA keys longer
		than 2000 bits are not supported.

Building

	BIND 9 currently requires a UNIX system with an ANSI C compiler,
	basic POSIX support, and a good pthreads implementation.

	We've had successful builds and tests on the following systems:

		AIX 4.3
		COMPAQ Tru64 UNIX 4.0D
		COMPAQ Tru64 UNIX 5 (with IPv6 EAK)
		FreeBSD 3.4-STABLE
		HP-UX 11
		IRIX64 6.5
		NetBSD-current (with unproven-pthreads-0.17)
		Red Hat Linux 6.0, 6.1, 6.2
		Solaris 2.6, 7, 8

	Additionally, we have unverified reports of success from users
	of the following systems:

		Slackware Linux 7.0 with 2.4.0-test6 kernel and glibc 2.1.3
		OpenBSD 2.6, 2.8, -current

	To build, just

		./configure
		make

	Several environment variables that can be set before running
	configure will affect compilation:

	    CC
		The C compiler to use.	configure tries to figure
		out the right one for supported systems.

	    CFLAGS
		C compiler flags.  Defaults to include -g and/or -O2
		as supported by the compiler.

	    STD_CINCLUDES
		System header file directories.	 Can be used to specify
		where add-on thread or IPv6 support is, for example.
		Defaults to empty string.

	    STD_CDEFINES
		Any additional preprocessor symbols you want defined.
		Defaults to empty string.

	To build shared libraries, specify "--with-libtool" on the
	configure command line.

	If your operating system has integrated support for IPv6, it
	will be used automatically.  If you have installed KAME IPv6
	separately, use "--with-kame[=PATH]" to specify its location.
	
	To see additional configure options, run "configure --help".

	"make install" will install "named" and the various BIND 9 libraries.
	By default, installation is into /usr/local, but this can be changed
	with the "--prefix" option when running "configure".

	If you're planning on making changes to the BIND 9 source, you
	should also "make depend".  If you're using Emacs, you might find
	"make tags" helpful.

	Building with gcc is not supported, unless gcc is the vendor's usual
	compiler (e.g. the various BSD systems, Linux).

	Parts of the library can be tested by running "make test" from the
	bin/tests subdirectory.


Documentation

	The BIND 9 Administrator Reference Manual is included with the
	source distribution in DocBook XML and HTML format, in the
	doc/arm directory.

	Some of the programs in the BIND 9 distribution have man pages
	under the doc/man directory.  In particular, the command line
	options of "named" are documented in doc/man/bind/named.8.

	The man pages are currently not installed automatically by
	"make install".

	If you are upgrading from BIND 8, please read the migration
	notes in doc/misc/migration.


Bug Reports and Mailing Lists

	Bugs reports should be sent to

		bind9-bugs@isc.org

	To join the BIND 9 Users mailing list, send mail to

		bind9-users-request@isc.org

	If you're planning on making changes to the BIND 9 source
	code, you might want to join the BIND 9 Workers mailing list.
	Send mail to

		bind9-workers-request@isc.org