summaryrefslogtreecommitdiffstats
path: root/doc/arm/platforms.inc.rst
diff options
context:
space:
mode:
Diffstat (limited to 'doc/arm/platforms.inc.rst')
-rw-r--r--doc/arm/platforms.inc.rst119
1 files changed, 119 insertions, 0 deletions
diff --git a/doc/arm/platforms.inc.rst b/doc/arm/platforms.inc.rst
new file mode 100644
index 0000000..c3f6242
--- /dev/null
+++ b/doc/arm/platforms.inc.rst
@@ -0,0 +1,119 @@
+.. Copyright (C) Internet Systems Consortium, Inc. ("ISC")
+..
+.. SPDX-License-Identifier: MPL-2.0
+..
+.. This Source Code Form is subject to the terms of the Mozilla Public
+.. License, v. 2.0. If a copy of the MPL was not distributed with this
+.. file, you can obtain one at https://mozilla.org/MPL/2.0/.
+..
+.. See the COPYRIGHT file distributed with this work for additional
+.. information regarding copyright ownership.
+
+.. _supported_os:
+
+Supported Platforms
+-------------------
+
+The current support status of BIND 9 versions across various platforms can be
+found in the ISC Knowledgebase:
+
+https://kb.isc.org/docs/supported-platforms
+
+In general, this version of BIND will build and run on any
+POSIX-compliant system with a C11-compliant C compiler, BSD-style
+sockets with RFC-compliant IPv6 support, POSIX-compliant threads, and
+the :ref:`required libraries <build_dependencies>`.
+
+The following C11 features are used in BIND 9:
+
+- Atomic operations support, either in the form of C11 atomics or
+ **__atomic** builtin operations.
+
+- Thread Local Storage support, either in the form of C11
+ **_Thread_local**/**thread_local**, or the **__thread** GCC
+ extension.
+
+The C11 variants are preferred.
+
+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
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Current versions of BIND 9 are fully supported and regularly tested on the
+following systems:
+
+- Debian 10, 11, 12
+- Ubuntu LTS 18.04, 20.04, 22.04
+- Fedora 38
+- Red Hat Enterprise Linux / CentOS / Oracle Linux 7, 8, 9
+- FreeBSD 12.4, 13.2
+- OpenBSD 7.3
+- Alpine Linux 3.18
+
+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. 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. None of these are tested
+regularly by ISC.
+
+- macOS 10.12+
+- Solaris 11
+- NetBSD
+- Other Linux distributions still supported by their vendors, such as:
+
+ - Ubuntu 20.10+
+ - Gentoo
+ - Arch Linux
+
+- OpenWRT/LEDE 17.01+
+- Other CPU architectures (mips, mipsel, sparc, …)
+
+Community-Maintained
+~~~~~~~~~~~~~~~~~~~~
+
+These systems may not all have the required dependencies for building
+BIND easily available, although it is 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, 16.04 (Ubuntu ESM releases are not supported)
+ - CentOS 6
+ - Debian 8 Jessie, 9 Stretch
+ - FreeBSD 10.x, 11.x
+
+Unsupported Platforms
+---------------------
+
+These are platforms on which current versions of BIND 9 are known *not* to build or run:
+
+- Platforms without at least OpenSSL 1.0.2
+- Windows
+- Solaris 10 and older
+- Platforms that do not support IPv6 Advanced Socket API (RFC 3542)
+- Platforms that do not support atomic operations (via compiler or
+ library)
+- Linux without NPTL (Native POSIX Thread Library)
+- Platforms on which **libuv** cannot be compiled
+
+Installing BIND 9
+-----------------
+
+:ref:`build_bind` contains complete instructions for how to build BIND 9.
+
+The ISC `Knowledgebase <https://kb.isc.org/>`_ contains many useful articles about installing
+BIND 9 on specific platforms.
+