Next update of VFS modules development guide
[kai/samba.git] / docs / smbdotconf / security / forceuser.xml
1 <samba:parameter name="force user"
2                                  type="string"
3                  context="S"
4                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
5 <description>
6     <para>This specifies a UNIX user name that will be 
7     assigned as the default user for all users connecting to this service. 
8     This is useful for sharing files. You should also use it carefully 
9     as using it incorrectly can cause security problems.</para>
10
11     <para>This user name only gets used once a connection is established. 
12     Thus clients still need to connect as a valid user and supply a 
13     valid password. Once connected, all file operations will be performed 
14     as the &quot;forced user&quot;, no matter what username the client connected 
15     as.  This can be very useful.</para>
16
17     <para>In Samba 2.0.5 and above this parameter also causes the 
18     primary group of the forced user to be used as the primary group 
19     for all file activity. Prior to 2.0.5 the primary group was left 
20     as the primary group of the connecting user (this was a bug).</para>
21
22 </description>
23
24 <related>force group</related>
25 <value type="default"/>
26 <value type="example">auser</value>
27 </samba:parameter>