Add new framework for smb.conf(5). Please read README before trying to compile.
[Samba/gebeck_regimport.git] / docs / docbook / smbdotconf / logon / logonpath.xml
blob04a2777862b9090f2302f7576190d0efdbc1aa87
1 <samba:parameter xmlns:samba="http://samba.org/common">
2                 <term><anchor id="LOGONPATH"/>logon path (G)</term>
3                 <listitem><para>This parameter specifies the home directory 
4                 where roaming profiles (NTuser.dat etc files for Windows NT) are 
5                 stored.  Contrary to previous versions of these manual pages, it has 
6                 nothing to do with Win 9X roaming profiles.  To find out how to 
7                 handle roaming profiles for Win 9X system, see the <link linkend="LOGONHOME">
8                 <parameter moreinfo="none">logon home</parameter></link> parameter.</para>
10                 <para>This option takes the standard substitutions, allowing you 
11                 to have separate logon scripts for each user or machine.  It also 
12                 specifies the directory from which the &quot;Application Data&quot;, 
13                 (<filename moreinfo="none">desktop</filename>, <filename moreinfo="none">start menu</filename>,
14                 <filename moreinfo="none">network neighborhood</filename>, <filename moreinfo="none">programs</filename> 
15                 and other folders, and their contents, are loaded and displayed on 
16                 your Windows NT client.</para>
17                 
18                 <para>The share and the path must be readable by the user for 
19                 the preferences and directories to be loaded onto the Windows NT
20                 client.  The share must be writeable when the user logs in for the first
21                 time, in order that the Windows NT client can create the NTuser.dat
22                 and other directories.</para>
24                 <para>Thereafter, the directories and any of the contents can, 
25                 if required, be made read-only.  It is not advisable that the 
26                 NTuser.dat file be made read-only - rename it to NTuser.man to 
27                 achieve the desired effect (a <emphasis>MAN</emphasis>datory 
28                 profile). </para>
30                 <para>Windows clients can sometimes maintain a connection to 
31                 the [homes] share, even though there is no user logged in.  
32                 Therefore, it is vital that the logon path does not include a 
33                 reference to the homes share (i.e. setting this parameter to
34                 \%N\%U\profile_path will cause problems).</para>
36                 <para>This option takes the standard substitutions, allowing 
37                 you to have separate logon scripts for each user or machine.</para>
39                 <para>Note that this option is only useful if Samba is set up 
40                 as a logon server.</para>
42                 <para>Default: <command moreinfo="none">logon path = \\%N\%U\profile</command></para>
43                 <para>Example: <command moreinfo="none">logon path = \\PROFILESERVER\PROFILE\%U</command></para>
44                 </listitem>
45                 </samba:parameter>