Merge branch 'master' of ctdb into 'master' of samba
[samba.git] / docs-xml / smbdotconf / security / guestaccount.xml
1 <samba:parameter name="guest account"
2                  context="G"
3                                  type="string"
4                  basic="1" advanced="1" developer="1"
5                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
6 <description>
7     <para>This is a username which will be used for access 
8     to services which are specified as <smbconfoption name="guest ok"/> (see below). Whatever privileges this 
9     user has will be available to any client connecting to the guest service. 
10     This user must exist in the password file, but does not require
11     a valid login. The user account &quot;ftp&quot; is often a good choice 
12     for this parameter. 
13     </para>
14
15     <para>On some systems the default guest account &quot;nobody&quot; may not 
16     be able to print. Use another account in this case. You should test 
17     this by trying to log in as your guest user (perhaps by using the 
18     <command moreinfo="none">su -</command> command) and trying to print using the 
19     system print command such as <command moreinfo="none">lpr(1)</command> or <command moreinfo="none">
20     lp(1)</command>.</para>
21
22     <para>This parameter does not accept % macros, because
23     many parts of the system require this value to be
24         constant for correct operation.</para>
25 </description>
26 <value type="default">nobody<comment>default can be changed at compile-time</comment></value>
27 <value type="example">ftp</value>
28 </samba:parameter>