nfs4acls: Introduce a helper variable
[Samba.git] / docs-xml / smbdotconf / protocol / profileacls.xml
blobade906c0285d96f558a57b657d9807b0636facf8
1 <samba:parameter name="profile acls"
2                  context="S"
3                  type="boolean"
4                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
5 <description>
6         <para>
7         This boolean parameter was added to fix the problems that people have been
8         having with storing user profiles on Samba shares from Windows 2000 or
9         Windows XP clients. New versions of Windows 2000 or Windows XP service
10         packs do security ACL checking on the owner and ability to write of the
11         profile directory stored on a local workstation when copied from a Samba
12         share.
13         </para>
15         <para>
16         When not in domain mode with winbindd then the security info copied
17         onto the local workstation has no meaning to the logged in user (SID) on
18         that workstation so the profile storing fails. Adding this parameter
19         onto a share used for profile storage changes two things about the
20         returned Windows ACL. Firstly it changes the owner and group owner
21         of all reported files and directories to be BUILTIN\\Administrators,
22         BUILTIN\\Users respectively (SIDs S-1-5-32-544, S-1-5-32-545). Secondly
23         it adds an ACE entry of "Full Control" to the SID BUILTIN\\Users to
24         every returned ACL. This will allow any Windows 2000 or XP workstation
25         user to access the profile.
26         </para>
28         <para>
29         Note that if you have multiple users logging
30         on to a workstation then in order to prevent them from being able to access
31         each others profiles you must remove the "Bypass traverse checking" advanced
32         user right. This will prevent access to other users profile directories as
33         the top level profile directory (named after the user) is created by the
34         workstation profile code and has an ACL restricting entry to the directory
35         tree to the owning user.
36         </para>
38         <para>
39         Note that this parameter should be set to yes on dedicated profile shares only.
40         On other shares, it might cause incorrect file ownerships.
41         </para>
43 </description>
45 <value type="default">no</value>
46 </samba:parameter>