← Back to branch summary

~zulcss/samba/server-dailies-3.4

« back to all changes in this revision

Viewing changes to docs-xml/smbdotconf/logon/logonpath.xml

  • Committer: Chuck Short
  • Date: 2010-09-28 20:38:39 UTC
  • Revision ID: zulcss@ubuntu.com-20100928203839-pgjulytsi9ue63x1
Initial version

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs-xml/smbdotconf/logon/logonpath.xml
 
1
<samba:parameter name="logon path"
 
2
                 context="G"
 
3
                                 type="string"
 
4
                 advanced="1" developer="1"
 
5
                 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 
6
<description>
 
7
        <para>
 
8
        This parameter specifies the directory where roaming profiles (Desktop, NTuser.dat, etc) are 
 
9
        stored.  Contrary to previous versions of these manual pages, it has nothing to do with Win 9X roaming
 
10
        profiles.  To find out how to handle roaming profiles for Win 9X system, see the
 
11
        <smbconfoption name="logon home"/> parameter.
 
12
        </para>
 
13
 
 
14
        <para>
 
15
        This option takes the standard substitutions, allowing you to have separate logon scripts for each user or
 
16
        machine.  It also specifies the directory from which the &quot;Application Data&quot;, <filename
 
17
        moreinfo="none">desktop</filename>, <filename moreinfo="none">start menu</filename>, <filename
 
18
        moreinfo="none">network neighborhood</filename>, <filename moreinfo="none">programs</filename> and other
 
19
        folders, and their contents, are loaded and displayed on your Windows NT client.
 
20
        </para>
 
21
 
 
22
        <para>
 
23
        The share and the path must be readable by the user for the preferences and directories to be loaded onto the
 
24
        Windows NT client. The share must be writeable when the user logs in for the first time, in order that the
 
25
        Windows NT client can create the NTuser.dat and other directories.  
 
26
        Thereafter, the directories and any of the contents can, if required, be made read-only.  It is not advisable
 
27
        that the NTuser.dat file be made read-only - rename it to NTuser.man to achieve the desired effect (a
 
28
        <emphasis>MAN</emphasis>datory profile).
 
29
        </para>
 
30
 
 
31
        <para>
 
32
        Windows clients can sometimes maintain a connection to the [homes] share, even though there is no user logged
 
33
        in.  Therefore, it is vital that the logon path does not include a reference to the homes share (i.e. setting
 
34
        this parameter to \\%N\homes\profile_path will cause problems).
 
35
        </para>
 
36
 
 
37
        <para>
 
38
        This option takes the standard substitutions, allowing you to have separate logon scripts for each user or machine.
 
39
        </para>
 
40
 
 
41
        <warning><para>
 
42
        Do not quote the value. Setting this as <quote>\\%N\profile\%U</quote>
 
43
        will break profile handling. Where the tdbsam or ldapsam passdb backend
 
44
        is used, at the time the user account is created the value configured
 
45
        for this parameter is written to the passdb backend and that value will
 
46
        over-ride the parameter value present in the smb.conf file. Any error
 
47
        present in the passdb backend account record must be editted using the
 
48
        appropriate tool (pdbedit on the command-line, or any other locally
 
49
        provided system tool).
 
50
        </para></warning>
 
51
 
 
52
        <para>Note that this option is only useful if Samba is set up as a domain controller.</para>
 
53
 
 
54
        <para>
 
55
        Disable the use of roaming profiles by setting the value of this parameter to the empty string. For
 
56
        example, <smbconfoption name="logon path">""</smbconfoption>. Take note that even if the default setting
 
57
        in the smb.conf file is the empty string, any value specified in the user account settings in the passdb
 
58
        backend will over-ride the effect of setting this parameter to null. Disabling of all roaming profile use
 
59
        requires that the user account settings must also be blank.
 
60
        </para>
 
61
 
 
62
        <para>
 
63
        An example of use is:
 
64
<programlisting>
 
65
logon path = \\PROFILESERVER\PROFILE\%U
 
66
</programlisting>
 
67
        </para>
 
68
</description>
 
69
<value type="default">\\%N\%U\profile</value>
 
70
</samba:parameter>