1
0
mirror of https://github.com/samba-team/samba.git synced 2025-01-07 17:18:11 +03:00
samba-mirror/docs-xml/smbdotconf/logon/logonhome.xml
Michael Adam 718007b223 docs:smbdotconf: fix tabs/space mixup in logon parameter metadata
Signed-off-by: Michael Adam <obnox@samba.org>
Reviewed-by: Jeremy Allison <jra@samba.org>
2016-01-22 01:55:09 +01:00

58 lines
2.0 KiB
XML

<samba:parameter name="logon home"
context="G"
type="string"
constant="1"
xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
<description>
<para>
This parameter specifies the home directory location when a Win95/98 or NT Workstation logs into a Samba PDC.
It allows you to do
</para>
<para>
<prompt moreinfo="none">C:\&gt;</prompt><userinput moreinfo="none">NET USE H: /HOME</userinput>
</para>
<para>
from a command prompt, for example.
</para>
<para>
This option takes the standard substitutions, allowing you to have separate logon scripts for each user or machine.
</para>
<para>
This parameter can be used with Win9X workstations to ensure that roaming profiles are stored in a
subdirectory of the user's home directory. This is done in the following way:
</para>
<para>
<command moreinfo="none">logon home = \\%N\%U\profile</command>
</para>
<para>
This tells Samba to return the above string, with substitutions made when a client requests the info, generally
in a NetUserGetInfo request. Win9X clients truncate the info to \\server\share when a user does
<command moreinfo="none">net use /home</command> but use the whole string when dealing with profiles.
</para>
<para>
Note that in prior versions of Samba, the <smbconfoption name="logon path"/> was returned rather than
<parameter moreinfo="none">logon home</parameter>. This broke <command moreinfo="none">net use /home</command>
but allowed profiles outside the home directory. The current implementation is correct, and can be used for
profiles if you use the above trick.
</para>
<para>
Disable this feature by setting <smbconfoption name="logon home">""</smbconfoption> - using the empty string.
</para>
<para>
This option is only useful if Samba is set up as a logon server.
</para>
</description>
<value type="default">\\%N\%U</value>
<value type="example">\\remote_smb_server\%U</value>
</samba:parameter>