Blame SOURCES/0090-idmap_sss-improve-man-page.patch

71e593
From ea7ada6c0629df45348f699e30acc44194550801 Mon Sep 17 00:00:00 2001
71e593
From: Sumit Bose <sbose@redhat.com>
71e593
Date: Thu, 10 Jan 2019 18:12:35 +0100
71e593
Subject: [PATCH] idmap_sss: improve man page
71e593
71e593
The misleading in the idmap_sss man page is improved.
71e593
71e593
Related to https://pagure.io/SSSD/sssd/issue/3912
71e593
71e593
Reviewed-by: Jakub Hrozek <jhrozek@redhat.com>
71e593
---
71e593
 src/man/idmap_sss.8.xml | 24 ++++++++++++++++++++----
71e593
 1 file changed, 20 insertions(+), 4 deletions(-)
71e593
71e593
diff --git a/src/man/idmap_sss.8.xml b/src/man/idmap_sss.8.xml
71e593
index b819304fb..a316c32a3 100644
71e593
--- a/src/man/idmap_sss.8.xml
71e593
+++ b/src/man/idmap_sss.8.xml
71e593
@@ -48,12 +48,28 @@
71e593
 
71e593
         <programlisting format="linespecific">
71e593
 [global]
71e593
-security = domain
71e593
-workgroup = MAIN
71e593
+security = ads
71e593
+workgroup = <AD-DOMAIN-SHORTNAME>
71e593
 
71e593
-idmap config * : backend        = sss
71e593
-idmap config * : range          = 200000-2147483647
71e593
+idmap config <AD-DOMAIN-SHORTNAME> : backend        = sss
71e593
+idmap config <AD-DOMAIN-SHORTNAME> : range          = 200000-2147483647
71e593
+
71e593
+idmap config * : backend        = tdb
71e593
+idmap config * : range          = 100000-199999
71e593
         </programlisting>
71e593
+
71e593
+        <para>
71e593
+            Please replace <AD-DOMAIN-SHORTNAME> with the NetBIOS domain
71e593
+            name of the AD domain. If multiple AD domains should be used each
71e593
+            domain needs an <literal>idmap config</literal> line with
71e593
+            <literal>backend = sss</literal> and a line with a suitable
71e593
+            <literal>range</literal>.
71e593
+        </para>
71e593
+        <para>
71e593
+            Since Winbind requires a writeable default backend and idmap_sss is
71e593
+            read-only the example includes <literal>backend = tdb</literal> as
71e593
+            default.
71e593
+        </para>
71e593
     </refsect1>
71e593
 
71e593
     <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="include/seealso.xml" />
71e593
-- 
71e593
2.19.1
71e593