diff --git a/Makefile.in b/Makefile.in index dd116d5675..22bba8b90b 100644 --- a/Makefile.in +++ b/Makefile.in @@ -22,7 +22,8 @@ MANPAGES = isc-config.sh.1 HTMLPAGES = isc-config.sh.html -MANOBJS = README HISTORY OPTIONS CONTRIBUTING ${MANPAGES} ${HTMLPAGES} +MANOBJS = README HISTORY OPTIONS CONTRIBUTING PLATFORMS \ + ${MANPAGES} ${HTMLPAGES} @BIND9_MAKE_RULES@ @@ -114,6 +115,11 @@ CONTRIBUTING: CONTRIBUTING.md ${W3M} -dump -cols 75 -O ascii -T text/html | \ sed -e '$${/^$$/d;}' > $@ +PLATFORMS: PLATFORMS.md + ${PANDOC} --email-obfuscation=none -s -t html PLATFORMS.md | \ + ${W3M} -dump -cols 75 -O ascii -T text/html | \ + sed -e '$${/^$$/d;}' > $@ + unit:: sh ${top_builddir}/unit/unittest.sh diff --git a/PLATFORMS b/PLATFORMS new file mode 100644 index 0000000000..54c64b6253 --- /dev/null +++ b/PLATFORMS @@ -0,0 +1,56 @@ +Supported platforms + +In general, this version of BIND will build and run on any POSIX-compliant +system with a C99-compliant C compiler, BSD-style sockets, and the OpenSSL +cryptography library. To build with multiprocessing support, a +C11-compliant C compiler will be needed for standard atomics. + +ISC regularly tests BIND on many operating systems and architectures, but +lacks the resources to test all of them. Consequently, ISC is only able to +offer support on a "best effort" basis for some. + +Regularly tested platforms + +As of May 2018, BIND 9.13 is tested on the following systems: + + * Debian 8, 9 + * Ubuntu 16.04, 18.04 + * Fedora 27, 28 + * Red Hat/CentOS 6, 7 + * FreeBSD 10.x, 11.x + * OpenBSD 6.3 + +The amd64, i386, armhf and arm64 CPU architectures are all fully +supported. + +Best effort + +The following are platforms on which BIND is known to build and run, but +on which it is not routinely tested. ISC makes every effort to fix bugs on +these platforms, but may be unable to do so quickly due to lack of +hardware, less familiarity on the part of engineering staff, and other +constraints. + + * Windows 10 / x64 + * Windows Server 2012 R2, 2016 / x64 + * macOS 10.12+ + * Solaris 10 + * FreeBSD 12+ + * OpenBSD 6.2 + * NetBSD + * Older or less popular Linux distributions still supported by their + vendors, such as: + + Ubuntu 14.04, 18.10+ + + Gentoo + + ArchLinux + + Alpine Linux + * OpenWRT/LEDE 17.0 + * Other CPU architectures (mips, mipsel, sparc, ...) + +Unsupported platforms + +These are platforms on which BIND is known not to build or run: + + * Platforms without at least OpenSSL 1.0.2 + * Windows 10 / x86 + * Windows Server 2012 diff --git a/PLATFORMS.md b/PLATFORMS.md new file mode 100644 index 0000000000..4beba7a031 --- /dev/null +++ b/PLATFORMS.md @@ -0,0 +1,64 @@ + +## Supported platforms + +In general, this version of BIND will build and run on any POSIX-compliant +system with a C99-compliant C compiler, BSD-style sockets, and the OpenSSL +cryptography library. To build with multiprocessing support, a +C11-compliant C compiler will be needed for standard atomics. + +ISC regularly tests BIND on many operating systems and architectures, but +lacks the resources to test all of them. Consequently, ISC is only able to +offer support on a "best effort" basis for some. + +### Regularly tested platforms + +As of May 2018, BIND 9.13 is tested on the following systems: + +* Debian 8, 9 +* Ubuntu 16.04, 18.04 +* Fedora 27, 28 +* Red Hat/CentOS 6, 7 +* FreeBSD 10.x, 11.x +* OpenBSD 6.3 + +The amd64, i386, armhf and arm64 CPU architectures are all fully supported. + +### Best effort + +The following are platforms on which BIND is known to build and run, +but on which it is not routinely tested. ISC makes every effort to fix bugs +on these platforms, but may be unable to do so quickly due to lack of +hardware, less familiarity on the part of engineering staff, and other +constraints. + +* Windows 10 / x64 +* Windows Server 2012 R2, 2016 / x64 +* macOS 10.12+ +* Solaris 10 +* FreeBSD 12+ +* OpenBSD 6.2 +* NetBSD +* Older or less popular Linux distributions still supported by their vendors, such as: + * Ubuntu 14.04, 18.10+ + * Gentoo + * ArchLinux + * Alpine Linux +* OpenWRT/LEDE 17.0 +* Other CPU architectures (mips, mipsel, sparc, ...) + +## Unsupported platforms + +These are platforms on which BIND is known *not* to build or run: + +* Platforms without at least OpenSSL 1.0.2 +* Windows 10 / x86 +* Windows Server 2012 diff --git a/README b/README index 3399798f1d..702af86c0b 100644 --- a/README +++ b/README @@ -31,9 +31,9 @@ administrative tools, including the dig and delv DNS lookup tools, nsupdate for dynamic DNS zone updates, rndc for remote name server administration, and more. -BIND 9 is a complete re-write of the BIND architecture that was used in -versions 4 and 8. Internet Systems Consortium (https://www.isc.org), a 501 -(c)(3) public benefit corporation dedicated to providing software and +BIND 9 began as a complete re-write of the BIND architecture that was used +in versions 4 and 8. Internet Systems Consortium (https://www.isc.org), a +501(c)(3) public benefit corporation dedicated to providing software and services in support of the Internet infrastructure, developed BIND 9 and is responsible for its ongoing maintenance and improvement. BIND is open source software licenced under the terms of the Mozilla Public License, @@ -48,6 +48,8 @@ the file CHANGES. See below for details on the CHANGES file format. For up-to-date release notes and errata, see http://www.isc.org/software/ bind9/releasenotes +For information about supported platforms, see PLATFORMS. + Reporting bugs and getting help To report non-security-sensitive bugs or request new features, you may diff --git a/README.md b/README.md index 287dabacdf..58bd522a0a 100644 --- a/README.md +++ b/README.md @@ -41,8 +41,8 @@ administrative tools, including the `dig` and `delv` DNS lookup tools, `nsupdate` for dynamic DNS zone updates, `rndc` for remote name server administration, and more. -BIND 9 is a complete re-write of the BIND architecture that was used in -versions 4 and 8. Internet Systems Consortium +BIND 9 began as a complete re-write of the BIND architecture that was +used in versions 4 and 8. Internet Systems Consortium ([https://www.isc.org](https://www.isc.org)), a 501(c)(3) public benefit corporation dedicated to providing software and services in support of the Internet infrastructure, developed BIND 9 and is responsible for its @@ -59,6 +59,8 @@ CHANGES file format. For up-to-date release notes and errata, see [http://www.isc.org/software/bind9/releasenotes](http://www.isc.org/software/bind9/releasenotes) +For information about supported platforms, see [PLATFORMS](PLATFORMS.md). + ### Reporting bugs and getting help To report non-security-sensitive bugs or request new features, you may diff --git a/util/copyrights b/util/copyrights index 7ed2fa59f9..8588767d27 100644 --- a/util/copyrights +++ b/util/copyrights @@ -15,6 +15,8 @@ ./Makefile.in MAKE 1998,1999,2000,2001,2002,2004,2005,2006,2007,2008,2009,2011,2012,2013,2014,2015,2016,2017,2018 ./OPTIONS X 2017,2018 ./OPTIONS.md MKD 2017,2018 +./PLATFORMS X 2018 +./PLATFORMS.md MKD 2018 ./README X 1999,2000,2001,2002,2003,2004,2005,2006,2007,2008,2009,2010,2011,2012,2013,2014,2015,2016,2017,2018 ./README.md MKD 2017,2018 ./acconfig.h C 1999,2000,2001,2002,2003,2004,2005,2007,2008,2012,2014,2016,2018