← Back to branch summary

~zulcss/samba/server-dailies-3.4

« back to all changes in this revision

Viewing changes to docs-xml/smbdotconf/winbind/idmapconfig.xml

  • Committer: Chuck Short
  • Date: 2010-09-28 20:38:39 UTC
  • Revision ID: zulcss@ubuntu.com-20100928203839-pgjulytsi9ue63x1
Initial version

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs-xml/smbdotconf/winbind/idmapconfig.xml
 
1
<samba:parameter name="idmap config"
 
2
                 context="G"
 
3
                 type="string"
 
4
                 advanced="1" developer="1" hide="1"
 
5
                 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 
6
<description>
 
7
 
 
8
        <para>
 
9
        The idmap config prefix provides a means of managing each trusted
 
10
        domain separately. The idmap config prefix should be followed by the
 
11
        name of the domain, a colon, and a setting specific to the chosen
 
12
        backend. There are three options available for all domains:
 
13
        </para>
 
14
 
 
15
        <variablelist>  
 
16
                <varlistentry>
 
17
                <term>backend = backend_name</term>
 
18
                <listitem><para>
 
19
                        Specifies the name of the idmap plugin to use as the 
 
20
                        SID/uid/gid backend for this domain.
 
21
                </para></listitem>
 
22
                </varlistentry>
 
23
 
 
24
                <varlistentry>
 
25
                <term>range = low - high</term>
 
26
                <listitem><para>
 
27
                Defines the available matching uid and gid range for which the
 
28
                backend is authoritative.  Note that the range commonly
 
29
                matches the allocation range due to the fact that the same
 
30
                backend will store and retrieve SID/uid/gid mapping entries.
 
31
                </para>
 
32
                <para>
 
33
                winbind uses this parameter to find the backend that is
 
34
                authoritative for a unix ID to SID mapping, so it must be set
 
35
                for each individually configured domain, and it must be
 
36
                disjoint from the ranges set via <smbconfoption name="idmap
 
37
                uid"/> and <smbconfoption name="idmap gid"/>.
 
38
                </para></listitem>
 
39
 
 
40
                </varlistentry>
 
41
        </variablelist>
 
42
 
 
43
        <para>
 
44
        The following example illustrates how to configure the <citerefentry>
 
45
        <refentrytitle>idmap_ad</refentrytitle> <manvolnum>8</manvolnum>
 
46
        </citerefentry> for the CORP domain and the
 
47
        <citerefentry><refentrytitle>idmap_tdb</refentrytitle>
 
48
        <manvolnum>8</manvolnum></citerefentry> backend for all other
 
49
        domains. This configuration assumes that the admin of CORP assigns
 
50
        unix ids below 1000000 via the SFU extensions, and winbind is supposed
 
51
        to use the next million entries for its own mappings from trusted
 
52
        domains and for local groups for example.
 
53
        </para>
 
54
 
 
55
        <programlisting>
 
56
        idmap backend = tdb
 
57
        idmap uid = 1000000-1999999
 
58
        idmap gid = 1000000-1999999
 
59
 
 
60
        idmap config CORP : backend  = ad
 
61
        idmap config CORP : range = 1000-999999
 
62
        </programlisting>
 
63
        
 
64
</description>
 
65
</samba:parameter>