From 07f727ba018f12ae903d281f028de50af441c075 Mon Sep 17 00:00:00 2001 From: Evan Hunt Date: Wed, 27 Nov 2019 13:06:13 -0800 Subject: [PATCH] update "supported platforms" in release notes also added more information about library dependencies in PLATFORMS.md, and cleaned up the grammar. --- PLATFORMS.md | 31 ++++++++++++++++++------------- doc/arm/notes-platforms.xml | 11 ++++++----- 2 files changed, 24 insertions(+), 18 deletions(-) diff --git a/PLATFORMS.md b/PLATFORMS.md index ef80009dd7..52041d07a7 100644 --- a/PLATFORMS.md +++ b/PLATFORMS.md @@ -17,10 +17,16 @@ and the OpenSSL cryptography library. Atomic operations support from the compiler is needed, either in the form of builtin operations, C11 atomics, or the `Interlocked` family of functions on Windows. -BIND 9.15 requires fairly recent version of libuv library to run (>= 1.x). For -some of the older systems listed below, you will have to install updated libuv -package from sources such as EPEL, PPA and other native sources for updated -packages. The other option is to install libuv from sources. +BIND 9.15 requires a fairly recent version of `libuv` (at least 1.x). For +some of the older systems listed below, you will have to install an updated +`libuv` package from sources such as EPEL, PPA, or other native sources for +updated packages. The other option is to build and install `libuv` from +source. + +Certain optional BIND features have additional library dependencies. +These include `libxml2` and `libjson-c` for statistics, `libmaxminddb` for +geolocation, `libfstrm` and `libprotobuf-c` for DNSTAP, and `libidn2` for +internationalized domain name conversion. 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 @@ -63,12 +69,13 @@ Server 2012 R2, none of these are tested regularly by ISC. ### Community maintained -These systems may not all have easily available the required dependencies for -building BIND although it will be possible in many cases to compile those -directly from source. The community and interested parties may wish to help with -maintenance and we welcome patch contributions, although we cannot guarantee -that we will accept them. All contributions will be assessed against the risk -of adverse effect on officially supported platforms. +These systems may not all have the required dependencies for building BIND +easily available, although it will be possible in many cases to compile +those directly from source. The community and interested parties may wish +to help with maintenance, and we welcome patch contributions, although we +cannot guarantee that we will accept them. All contributions will be +assessed against the risk of adverse effect on officially supported +platforms. * Platforms past or close to their respective EOL dates, such as: * Ubuntu 14.04, 18.10 @@ -87,6 +94,4 @@ These are platforms on which BIND 9.15 is known *not* to build or run: * Platforms that don't support IPv6 Advanced Socket API (RFC 3542) * Platforms that don't support atomic operations (via compiler or library) * Linux without NPTL (Native POSIX Thread Library) -* Platforms where libuv cannot be compiled - -## Platform quirks +* Platforms on which `libuv` cannot be compiled diff --git a/doc/arm/notes-platforms.xml b/doc/arm/notes-platforms.xml index 94d9cf0ac2..907a5ac76d 100644 --- a/doc/arm/notes-platforms.xml +++ b/doc/arm/notes-platforms.xml @@ -17,11 +17,12 @@ C compiler. - The OpenSSL cryptography library must be available for the target - platform. A PKCS#11 provider can be used instead for Public Key - cryptography (i.e., DNSSEC signing and validation), but OpenSSL is - still required for general cryptography operations such as hashing - and random number generation. + The libuv asynchronous I/O library and the + OpenSSL cryptography library must be available for the target + platform. A PKCS#11 provider can be used instead of OpenSSL for + Public Key cryptography (i.e., DNSSEC signing and validation), + but OpenSSL is still required for general cryptography operations + such as hashing and random number generation. More information can be found in the PLATFORMS.md