Merge branch 'master' of ssh://git.samba.org/data/git/samba into regsrv
[ab/samba.git/.git] / docs-xml / smbdotconf / winbind / winbindnormalizenames.xml
1 <samba:parameter name="winbind normalize names"
2                  context="G"
3                  type="boolean"
4                  advanced="1" developer="1"
5                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
6 <description>
7         <para>This parameter controls whether winbindd will replace
8           whitespace in user and group names with an underscore (_) character.
9           For example, whether the name &quot;Space Kadet&quot; should be
10           replaced with the string &quot;space_kadet&quot;.
11           Frequently Unix shell scripts will have difficulty with usernames
12           contains whitespace due to the default field separator in the shell.
13           If your domain possesses names containing the underscore character,
14           this option may cause problems unless the name aliasing feature
15           is supported by your nss_info plugin.
16         </para>
17
18         <para>This feature also enables the name aliasing API which can
19           be used to make domain user and group names to a non-qlaified
20           version.  Please refer to the manpage for the configured
21           idmap and nss_info plugin for the specifics on how to configure
22           name aliasing for a specific configuration.  Name aliasing takes
23           precendence (and is mutually exclusive) over the whitespace
24           replacement mechanism discussed previsouly.
25           </para>
26
27 </description>
28
29 <value type="default">no</value>
30 <value type="example">yes</value>
31 </samba:parameter>