Doc updates from John + some minor fixes by me
[samba.git] / docs / docbook / smbdotconf / security / forceuser.xml
1 <samba:parameter xmlns:samba="http://samba.org/common">
2                 <term><anchor id="FORCEUSER"/>force user (S)</term>
3                 <listitem><para>This specifies a UNIX user name that will be 
4                 assigned as the default user for all users connecting to this service. 
5                 This is useful for sharing files. You should also use it carefully 
6                 as using it incorrectly can cause security problems.</para>
7
8                 <para>This user name only gets used once a connection is established. 
9                 Thus clients still need to connect as a valid user and supply a 
10                 valid password. Once connected, all file operations will be performed 
11                 as the &quot;forced user&quot;, no matter what username the client connected 
12                 as.  This can be very useful.</para>
13
14                 <para>In Samba 2.0.5 and above this parameter also causes the 
15                 primary group of the forced user to be used as the primary group 
16                 for all file activity. Prior to 2.0.5 the primary group was left 
17                 as the primary group of the connecting user (this was a bug).</para>
18
19                 <para>See also <link linkend="FORCEGROUP"><parameter moreinfo="none">force group
20                 </parameter></link></para>
21
22                 <para>Default: <emphasis>no forced user</emphasis></para>
23                 <para>Example: <command moreinfo="none">force user = auser</command></para>
24                 </listitem>
25                 </samba:parameter>