docs:smbdotconf: make formatting of headers uniform.
[Samba.git] / docs-xml / smbdotconf / winbind / winbindexpandgroups.xml
blob941ba046311d66563ee58280fbb96b0e02e311a2
1 <samba:parameter name="winbind expand groups"
2                  context="G"
3                  type="integer"
4                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
5 <description>
6         <para>This option controls the maximum depth that winbindd
7               will traverse when flattening nested group memberships
8               of Windows domain groups.  This is different from the
9               <smbconfoption name="winbind nested groups"/> option
10               which implements the Windows NT4 model of local group 
11               nesting.  The &quot;winbind expand groups&quot;
12               parameter specifically applies to the membership of 
13               domain groups.</para>
15          <para>Be aware that a high value for this parameter can
16          result in system slowdown as the main parent winbindd daemon
17          must perform the group unrolling and will be unable to answer
18          incoming NSS or authentication requests during this time.</para>
20         <para>The default value was changed from 1 to 0 with Samba 4.2.
21         Some broken applications calculate the group memberships of
22         users by traversing groups, such applications will require
23         "winbind expand groups = 1". But the new default makes winbindd more reliable
24         as it doesn't require SAMR access to domain controllers of trusted domains.</para>
25 </description>
27 <value type="default">0</value>
28 </samba:parameter>