943bc6
From facdbb0f2a266c6a3a1fa823afaa09cbd3fc38a5 Mon Sep 17 00:00:00 2001
943bc6
From: Petr Mensik <pemensik@redhat.com>
943bc6
Date: Thu, 26 Nov 2020 12:13:10 +0100
943bc6
Subject: [PATCH] Note specific Red Hat changes in manual page
943bc6
943bc6
Change docbook template instead of generated manual page. Remove
943bc6
system-config-bind reference, package were discontinued.
943bc6
---
943bc6
 bin/named/named.docbook | 73 +++++++++++++++++++++++++++++++++++++++++
943bc6
 1 file changed, 73 insertions(+)
943bc6
943bc6
diff --git a/bin/named/named.docbook b/bin/named/named.docbook
943bc6
index 7e743a9..802bec3 100644
943bc6
--- a/bin/named/named.docbook
943bc6
+++ b/bin/named/named.docbook
943bc6
@@ -516,6 +516,79 @@
943bc6
 
943bc6
   </refsection>
943bc6
 
943bc6
+  <refsection><info><title>NOTES</title></info>
943bc6
+    <refsection><info><title>Red Hat SELinux BIND Security Profile</title></info>
943bc6
+
943bc6
+    <para>
943bc6
+    By default, Red Hat ships BIND with the most secure SELinux policy
943bc6
+    that will not prevent normal BIND operation and will prevent exploitation
943bc6
+    of all known BIND security vulnerabilities . See the selinux(8) man page
943bc6
+    for information about SElinux.
943bc6
+    </para>
943bc6
+
943bc6
+    <para>
943bc6
+    It is not necessary to run named in a chroot environment if the Red Hat
943bc6
+    SELinux policy for named is enabled. When enabled, this policy is far
943bc6
+    more secure than a chroot environment. Users are recommended to enable
943bc6
+    SELinux and remove the bind-chroot package.
943bc6
+    </para>
943bc6
+
943bc6
+    <para>
943bc6
+    With this extra security comes some restrictions:
943bc6
+    </para>
943bc6
+
943bc6
+    <para>
943bc6
+    By default, the SELinux policy allows named to write any master
943bc6
+    zone database files. Only the root user may create files in the $ROOTDIR/var/named
943bc6
+    zone database file directory (the options { "directory" } option), where
943bc6
+    $ROOTDIR is set in /etc/sysconfig/named.
943bc6
+    </para>
943bc6
+
943bc6
+    <para>
943bc6
+    The "named" group must be granted read privelege to
943bc6
+    these files in order for named to be enabled to read them.
943bc6
+    </para>
943bc6
+
943bc6
+    <para>
943bc6
+    Any file created in the zone database file directory is automatically assigned
943bc6
+    the SELinux file context named_zone_t .
943bc6
+    </para>
943bc6
+
943bc6
+    <para>
943bc6
+    By default, SELinux prevents any role from modifying named_zone_t files; this
943bc6
+    means that files in the zone database directory cannot be modified by dynamic
943bc6
+    DNS (DDNS) updates or zone transfers.
943bc6
+    </para>
943bc6
+
943bc6
+    <para>
943bc6
+    The Red Hat BIND distribution and SELinux policy creates three directories where
943bc6
+    named is allowed to create and modify files: /var/named/slaves, /var/named/dynamic
943bc6
+    /var/named/data. By placing files you want named to modify, such as
943bc6
+    slave or DDNS updateable zone files and database / statistics dump files in
943bc6
+    these directories, named will work normally and no further operator action is
943bc6
+    required. Files in these directories are automatically assigned the 'named_cache_t'
943bc6
+    file context, which SELinux allows named to write.
943bc6
+    </para>
943bc6
+    </refsection>
943bc6
+
943bc6
+    <refsection><info><title>Red Hat BIND SDB support</title></info>
943bc6
+
943bc6
+    <para>
943bc6
+    Red Hat ships named with compiled in Simplified Database Backend modules that ISC
943bc6
+    provides in the "contrib/sdb" directory. Install bind-sdb package if you want use them.
943bc6
+    </para>
943bc6
+
943bc6
+    <para>
943bc6
+    The SDB modules for LDAP, PostGreSQL, DirDB and SQLite are compiled into <command>named-sdb</command>.
943bc6
+    </para>
943bc6
+
943bc6
+    <para>
943bc6
+    See the documentation for the various SDB modules in /usr/share/doc/bind-sdb-*/ .
943bc6
+    </para>
943bc6
+    </refsection>
943bc6
+
943bc6
+  </refsection>
943bc6
+
943bc6
   <refsection><info><title>SEE ALSO</title></info>
943bc6
 
943bc6
     <para><citetitle>RFC 1033</citetitle>,
943bc6
-- 
943bc6
2.26.2
943bc6