sync packagaing with SAMBA_3_0
[kai/samba.git] / docs / docbook / smbdotconf / misc / homedirmap.xml
1 <samba:parameter xmlns:samba="http://samba.org/common">
2                 <term><anchor id="HOMEDIRMAP"/>homedir map (G)</term>
3                 <listitem><para>If<link linkend="NISHOMEDIR"><parameter moreinfo="none">nis homedir
4                 </parameter></link> is <constant>yes</constant>, and <citerefentry><refentrytitle>smbd</refentrytitle>
5                 <manvolnum>8</manvolnum></citerefentry> is also acting 
6                 as a Win95/98 <parameter moreinfo="none">logon server</parameter> then this parameter 
7                 specifies the NIS (or YP) map from which the server for the user's 
8                 home directory should be extracted.  At present, only the Sun 
9                 auto.home map format is understood. The form of the map is:</para>
10
11                 <para><command moreinfo="none">username server:/some/file/system</command></para>
12
13                 <para>and the program will extract the servername from before 
14                 the first ':'.  There should probably be a better parsing system 
15                 that copes with different map formats and also Amd (another 
16                 automounter) maps.</para>
17                 
18                 <para><emphasis>NOTE :</emphasis>A working NIS client is required on 
19                 the system for this option to work.</para>
20
21                 <para>See also <link linkend="NISHOMEDIR"><parameter moreinfo="none">nis homedir</parameter>
22                 </link>, <link linkend="DOMAINLOGONS"><parameter moreinfo="none">domain logons</parameter>
23                 </link>.</para>
24
25                 <para>Default: <command moreinfo="none">homedir map = &lt;empty string&gt;</command></para>
26                 <para>Example: <command moreinfo="none">homedir map = amd.homedir</command></para>
27                 </listitem>
28                 </samba:parameter>