docs:smbdotconf: make formatting of headers uniform.
[Samba.git] / docs-xml / smbdotconf / misc / homedirmap.xml
blob279b0b6e52e478edaaa0006d65903e1716f009da
1 <samba:parameter name="homedir map"
2                  context="G"
3                  type="string"
4                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
5  <description>
6         <para>
7         If <smbconfoption name="nis homedir"/> is <constant>yes</constant>, and <citerefentry><refentrytitle>smbd</refentrytitle>
8         <manvolnum>8</manvolnum></citerefentry> is also acting  as a Win95/98 <parameter moreinfo="none">logon server</parameter> 
9         then this parameter specifies the NIS (or YP) map from which the server for the user's  home directory should be extracted.  
10         At present, only the Sun auto.home map format is understood. The form of the map is:
11 <programlisting>
12 <command moreinfo="none">username server:/some/file/system</command>
13 </programlisting>
14         and the program will extract the servername from before the first ':'.  There should probably be a better parsing system 
15         that copes with different map formats and also Amd (another automounter) maps.
16         </para>
17                 
18         <note><para>
19         A working NIS client is required on the system for this option to work.
20         </para></note>
21 </description>
22 <related>nis homedir</related>
23 <related>domain logons</related>
25 <value type="default"></value>
26 <value type="example">amd.homedir</value>
27 </samba:parameter>