summaryrefslogtreecommitdiff
path: root/docs-xml/manpages-3
diff options
context:
space:
mode:
authorMichael Adam <obnox@samba.org>2009-02-17 08:51:39 +0100
committerMichael Adam <obnox@samba.org>2009-02-17 18:21:54 +0100
commit74940606f715bfc9d99ded2fb1d1da02d037609a (patch)
treed7ed8caf84876f44f7caa78254ce27deda656796 /docs-xml/manpages-3
parent2feaaa885a485adb11096cdfc3db223f3b73e1a6 (diff)
downloadsamba-74940606f715bfc9d99ded2fb1d1da02d037609a.tar.gz
samba-74940606f715bfc9d99ded2fb1d1da02d037609a.tar.bz2
samba-74940606f715bfc9d99ded2fb1d1da02d037609a.zip
docs: extend the idmap_rid manpage
Michael
Diffstat (limited to 'docs-xml/manpages-3')
-rw-r--r--docs-xml/manpages-3/idmap_rid.8.xml29
1 files changed, 24 insertions, 5 deletions
diff --git a/docs-xml/manpages-3/idmap_rid.8.xml b/docs-xml/manpages-3/idmap_rid.8.xml
index 5eba356a7d..7e48c11c53 100644
--- a/docs-xml/manpages-3/idmap_rid.8.xml
+++ b/docs-xml/manpages-3/idmap_rid.8.xml
@@ -42,11 +42,13 @@
<varlistentry>
<term>base_rid = INTEGER</term>
<listitem><para>
- Defines the base integer used to build SIDs out of an UID or a GID,
- and to rebase the UID or GID to be obtained from a SID. User RIDs
- by default start at 1000 (512 hexadecimal), this means a good value
- for base_rid can be 1000 as the resulting ID is calculated this way:
- ID = RID - BASE_RID + LOW RANGE ID.
+ Defines the base integer used to build SIDs out of a UID or a GID,
+ and to rebase the UID or GID to be obtained from a SID.
+ This means SIDs with a RID less than the base rid are filtered.
+ The default is not to restrict the allowed rids at all,
+ i.e. a base_rid value of 0.
+ A good value for the base_rid can be 1000, since user
+ RIDs by default start at 1000 (512 hexadecimal).
</para>
<para>
Use of this parameter is deprecated.
@@ -56,6 +58,23 @@
</refsect1>
<refsect1>
+ <title>THE MAPPING FORMULAS</title>
+ <para>
+ The Unix ID for a RID is calculated this way:
+ <programlisting>
+ ID = RID - BASE_RID + LOW_RANGE_ID.
+ </programlisting>
+ </para>
+ <para>
+ Correspondingly, the formula for calculationg the RID for a
+ given Unix ID is this:
+ <programlisting>
+ RID = ID + BASE_RID - LOW_RANGE_ID.
+ </programlisting>
+ </para>
+</refsect1>
+
+<refsect1>
<title>EXAMPLES</title>
<para>This example shows how to configure a domain with idmap_rid</para>