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