summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMichael Adam <obnox@samba.org>2010-12-07 17:30:27 +0100
committerMichael Adam <obnox@samba.org>2010-12-07 19:07:57 +0100
commita52a587783e058f75815fa8add1f46b1c1d6f2d3 (patch)
treec964d0d508eaedaa82f792f7d05026dbfb8686dd
parent91d9cb48a5224c7dc443747505f9dd1071f822ed (diff)
downloadsamba-a52a587783e058f75815fa8add1f46b1c1d6f2d3.tar.gz
samba-a52a587783e058f75815fa8add1f46b1c1d6f2d3.tar.bz2
samba-a52a587783e058f75815fa8add1f46b1c1d6f2d3.zip
docs: clarify the idmap_rid manpage (bug #7788)
The idmap_rid module should not be used as a default backend. Also mention that the old snytax "idmap backend = rid:domain=range ..." is not supported any more. Autobuild-User: Michael Adam <obnox@samba.org> Autobuild-Date: Tue Dec 7 19:07:57 CET 2010 on sn-devel-104
-rw-r--r--docs-xml/manpages-3/idmap_rid.8.xml18
1 files changed, 18 insertions, 0 deletions
diff --git a/docs-xml/manpages-3/idmap_rid.8.xml b/docs-xml/manpages-3/idmap_rid.8.xml
index 33200b8e13..a2a1c58a6f 100644
--- a/docs-xml/manpages-3/idmap_rid.8.xml
+++ b/docs-xml/manpages-3/idmap_rid.8.xml
@@ -21,6 +21,24 @@
<para>The idmap_rid backend provides a way to use an algorithmic
mapping scheme to map UIDs/GIDs and SIDs. No database is required
in this case as the mapping is deterministic.</para>
+
+ <para>
+ Note that the idmap_rid module has changed considerably since Samba
+ versions 3.0. and 3.2.
+ Currently, there should to be an explicit idmap configuration for each
+ domain that should use the idmap_rid backend, using disjoint ranges.
+ One usually needs to define a writeable default idmap range, using
+ a backent like <parameter>tdb</parameter> or <parameter>ldap</parameter>
+ that can create unix ids, in order to be able to map the BUILTIN sids
+ and other domains, and also in order to be able to create group mappings.
+ See the example below.
+ </para>
+
+ <para>
+ Note that the old syntax
+ <parameter>idmap backend = rid:"DOM1=range DOM2=range2 ..."</parameter>
+ is not supported any more since Samba version 3.0.25.
+ </para>
</refsynopsisdiv>
<refsect1>