From 59e53cedcb7cf95fd1f66111c15be714f7d6b1f1 Mon Sep 17 00:00:00 2001
From: Volker Lendecke <vl@samba.org>
Date: Thu, 17 Jul 2008 14:05:57 +0200
Subject: Document idmap rewrite (This used to be commit
 4b9132e8bd1b2bc397b657ef07796f44d55f33da)

---
 docs-xml/smbdotconf/winbind/idmapallocbackend.xml | 28 +++++++++++++++--------
 1 file changed, 18 insertions(+), 10 deletions(-)

(limited to 'docs-xml/smbdotconf/winbind/idmapallocbackend.xml')

diff --git a/docs-xml/smbdotconf/winbind/idmapallocbackend.xml b/docs-xml/smbdotconf/winbind/idmapallocbackend.xml
index 60e20b82d5..e06bcd43a8 100644
--- a/docs-xml/smbdotconf/winbind/idmapallocbackend.xml
+++ b/docs-xml/smbdotconf/winbind/idmapallocbackend.xml
@@ -6,18 +6,26 @@
 <description>
 	<para>
 	The idmap alloc backend provides a plugin interface for Winbind to use
-	when allocating Unix uids/gids for Windows SIDs.  This option is
-	to be used in conjunction with the <smbconfoption name="idmap domains"/> 
-	parameter and refers to the name of the idmap module which will provide
-	the id allocation functionality.  Please refer to the man page 
-	for each idmap plugin to determine whether or not the module implements
-	the allocation feature.  The most common plugins are the tdb (<citerefentry>
-        <refentrytitle>idmap_tdb</refentrytitle><manvolnum>8</manvolnum></citerefentry>)
-        and ldap (<citerefentry><refentrytitle>idmap_ldap</refentrytitle>
-        <manvolnum>8</manvolnum></citerefentry>) libraries.
+	when allocating Unix uids/gids for Windows SIDs. This option refers
+	to the name of the idmap module which will provide the id allocation
+	functionality. Please refer to the man page for each idmap plugin to
+	determine whether or not the module implements the allocation feature.
+	The most common plugins are the tdb (<citerefentry>
+	<refentrytitle>idmap_tdb</refentrytitle><manvolnum>8</manvolnum></citerefentry>)
+	and ldap (<citerefentry><refentrytitle>idmap_ldap</refentrytitle>
+	<manvolnum>8</manvolnum></citerefentry>) libraries.
 	</para>
 
-	<para>Also refer to the <smbconfoption name="idmap alloc config"/> option.
+	<para>
+	This parameter defaults to the value <smbconfoption name="idmap
+	backend"/> was set to, so by default winbind will allocate Unix IDs
+	from the default backend. You will only need to set this parameter
+	explicitly if you have an external source for Unix IDs, like a central
+	database service somewhere in your company.
+	</para>
+
+	<para>
+	Also refer to the <smbconfoption name="idmap alloc config"/> option.
 	</para>
 </description>
 
-- 
cgit