docs/docbook/smbdotconf/security/guestaccount.xml

   1 <samba:parameter name="guest account"
   2                  context="G,S"
   3                  basic="1" advanced="1" developer="1"
   4                  xmlns:samba="http://samba.org/common">
   5 <listitem>
   6     <para>This is a username which will be used for access
   7     to services which are specified as <link linkend="GUESTOK"><parameter moreinfo="none">
   8     guest ok</parameter></link> (see below). Whatever privileges this
   9     user has will be available to any client connecting to the guest service.
  10     Typically this user will exist in the password file, but will not
  11     have a valid login. The user account &quot;ftp&quot; is often a good choice
  12     for this parameter. If a username is specified in a given service,
  13     the specified username overrides this one.
  14     </para>
  15
  16     <para>One 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
  27     <para>Default: <emphasis>specified at compile time, usually &quot;nobody&quot;</emphasis></para>
  28
  29     <para>Example: <command moreinfo="none">guest account = ftp</command></para>
  30 </listitem>
  31 </samba:parameter>