summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDoug Barton <dougb@FreeBSD.org>2008-07-12 08:46:21 +0000
committerDoug Barton <dougb@FreeBSD.org>2008-07-12 08:46:21 +0000
commit2c9d19ec6fc69356dc6c2cf65ba1e3ff662bf8be (patch)
tree12c26bcf6b7d7cc0b7ea24ce71288c303dfca0ed
parente9dc1cc6165db6cf0626167f8e30a23a159e79d2 (diff)
downloadsrc-test2-2c9d19ec6fc69356dc6c2cf65ba1e3ff662bf8be.tar.gz
src-test2-2c9d19ec6fc69356dc6c2cf65ba1e3ff662bf8be.zip
Notes
-rw-r--r--FREEBSD-Upgrade120
-rw-r--r--FREEBSD-Xlist67
2 files changed, 187 insertions, 0 deletions
diff --git a/FREEBSD-Upgrade b/FREEBSD-Upgrade
new file mode 100644
index 000000000000..75efb09f1e62
--- /dev/null
+++ b/FREEBSD-Upgrade
@@ -0,0 +1,120 @@
+
+
+ FreeBSD maintainer's guide to updating BIND 9
+ =============================================
+
+1) Obtain the latest source distribution from the ISC's FTP server
+ (ftp://ftp.isc.org/isc/bind9/)
+
+2) Unpack the tarball in a suitable directory, and cd into the new
+ source directory.
+
+3) Remove unwanted files and directories:
+
+ $ while read pattern ; do rm -rf $pattern ; done \
+ </usr/src/contrib/bind9/FREEBSD-Xlist
+
+ Make sure that took care of everything, and if it didn't, make sure
+ to update FREEBSD-Xlist so you won't miss it the next time. A good
+ way to do this is to run a test import and see if any new files
+ show up:
+
+ $ cvs -q -n import src/contrib/bind9 ISC x | grep \^N
+
+4) Import the sources:
+
+ $ cvs import -m "Vendor import of BIND 9.X.Y" \
+ src/contrib/bind9 ISC BIND_9_X_Y
+
+5) Resolve conflicts.
+
+ As of 2 June 2007, we have no local patches against BIND 9; thus
+ there are no conflicts to merge. This may change at a later date.
+
+5a) Remove any files that are no longer in the tarball from the vendor branch.
+
+6) Remove any references to the {bin,lib}/tests and docutil
+ directories from the configure and Makefile templates:
+
+ $ sed -i.orig -e '/\/tests/d; /docutil/d; /\/xsl/d;' \
+ configure.in Makefile.in */Makefile.in
+
+ Please do not commit this change, as it would unnecessarily take
+ files off the vendor branch. You only need this to generate
+ config.h.
+
+7) Generate and run configure:
+
+ $ aclocal
+ $ autoheader
+ $ autoconf
+ $ ./configure --prefix=/usr \
+ --infodir=/usr/share/info --mandir=/usr/share/man \
+ --enable-threads --enable-libbind --disable-ipv6 \
+ --enable-getifaddrs --disable-linux-caps \
+ --with-openssl=/usr --with-randomdev=/dev/random
+
+ Note that we intentionally disable IPv6 support on the configure
+ command line; src/lib/bind/config.mk will re-enable it at compile
+ time if WITHOUT_INET6 is not defined.
+
+8) Copy the following generated files to src/lib/bind and commit them:
+
+ Path in src/contrib/bind9 Path in src/lib/bind
+ ------------------------------------------------------------
+ s=/usr/src/lib/bind
+ cp config.h ${s}/config.h
+ cp lib/bind/config.h ${s}/bind/config.h
+ cp lib/bind/port_after.h ${s}/bind/port_after.h
+ cp lib/bind/port_before.h ${s}/bind/port_before.h
+ cp lib/isc/include/isc/platform.h ${s}/isc/isc/platform.h
+ cp lib/lwres/include/lwres/netdb.h ${s}/lwres/lwres/netdb.h
+ cp lib/lwres/include/lwres/platform.h ${s}/lwres/lwres/platform.h
+
+ Do not commit any other file that was modified or created in
+ steps 6) or 7).
+
+9) cd src/lib/bind/dns && make -DMAINTAINER_MODE generate && rm gen
+ Commit the new versions of the files generated.
+
+ The following directories contain Makefiles for bits and pieces of
+ BIND 9:
+
+ FreeBSD directory ISC directory
+ ========================================================
+ src/lib/bind bind9/lib
+ src/lib/bind/bind bind9/lib/bind
+ src/lib/bind/bind9 bind9/lib/bind9
+ src/lib/bind/dns bind9/lib/dns
+ src/lib/bind/isc bind9/lib/isc
+ src/lib/bind/isccc bind9/lib/isccc
+ src/lib/bind/isccfg bind9/lib/isccfg
+ src/lib/bind/lwres bind9/lib/lwres
+ src/share/doc/bind9 bind9/doc/{arm,misc}
+ src/usr.bin/dig bind9/bin/dig
+ src/usr.bin/host bind9/bin/dig
+ src/usr.bin/nslookup bind9/bin/dig
+ src/usr.bin/nsupdate bind9/bin/nsupdate
+ src/usr.sbin/dnssec-keygen bind9/bin/dnssec
+ src/usr.sbin/dnssec-signzone bind9/bin/dnssec
+ src/usr.sbin/named bind9/bin/named
+ src/usr.sbin/named-checkconf bind9/bin/check
+ src/usr.sbin/named-checkzone bind9/bin/check
+ src/usr.sbin/rndc bind9/bin/rndc
+ src/usr.sbin/rndc-confgen bind9/bin/rndc
+
+ Make sure that the lists of sources, headers and man pages in each
+ FreeBSD Makefile accurately reflects those in the corresponding ISC
+ Makefile. Please strive to keep those lists in the same order and
+ with line breaks in the same places to ease future comparisons.
+
+A) Build and test.
+
+B) Lather, rinse, repeat.
+
+C) Commit when everything builds cleanly and works properly.
+
+ -- des@FreeBSD.org
+ -- dougb@FreeBSD.org
+
+$FreeBSD$
diff --git a/FREEBSD-Xlist b/FREEBSD-Xlist
new file mode 100644
index 000000000000..f4239557b3ae
--- /dev/null
+++ b/FREEBSD-Xlist
@@ -0,0 +1,67 @@
+# $FreeBSD$
+
+# Misc. stuff
+.cvsignore
+aclocal.m4
+config.h.in
+configure
+contrib
+docutil
+
+# Tests
+bin/tests
+lib/tests
+
+# Doc stuff
+doc/arm/latex-fixup.pl
+doc/xsl
+
+# Windows directories
+bin/check/win32
+bin/dig/win32
+bin/dnssec/win32
+bin/named/win32
+bin/nsupdate/win32
+bin/rndc/win32
+bin/win32
+config.h.win32
+lib/bind9/win32
+lib/dns/gen-win32.h
+lib/dns/win32
+lib/isc/win32
+lib/isccc/win32
+lib/isccfg/win32
+lib/lwres/win32
+lib/win32
+win32utils
+
+# Various ports to other OSs
+lib/bind/port/aix*
+lib/bind/port/aux3
+lib/bind/port/bsdos
+lib/bind/port/bsdos2
+lib/bind/port/cygwin
+lib/bind/port/darwin
+lib/bind/port/decunix
+lib/bind/port/hpux
+lib/bind/port/hpux10
+lib/bind/port/hpux9
+lib/bind/port/irix
+lib/bind/port/linux
+lib/bind/port/lynxos
+lib/bind/port/mpe
+lib/bind/port/netbsd
+lib/bind/port/next
+lib/bind/port/openbsd
+lib/bind/port/prand_conf
+lib/bind/port/qnx
+lib/bind/port/rhapsody
+lib/bind/port/sco42
+lib/bind/port/sco50
+lib/bind/port/solaris
+lib/bind/port/sunos
+lib/bind/port/ultrix
+lib/bind/port/unixware20
+lib/bind/port/unixware212
+lib/bind/port/unixware7
+lib/bind/port/unknown