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