docs/docbook/smbdotconf/security/guestaccount.xml

   1 <samba:parameter xmlns:samba="http://samba.org/common">
   2                 <term><anchor id="GUESTACCOUNT"/>guest account (S)</term>
   3                 <listitem><para>This is a username which will be used for access
   4                 to services which are specified as <link linkend="GUESTOK"><parameter moreinfo="none">
   5                 guest ok</parameter></link> (see below). Whatever privileges this
   6                 user has will be available to any client connecting to the guest service.
   7                 Typically this user will exist in the password file, but will not
   8                 have a valid login. The user account &quot;ftp&quot; is often a good choice
   9                 for this parameter. If a username is specified in a given service,
  10                 the specified username overrides this one.</para>
  11
  12                 <para>One some systems the default guest account &quot;nobody&quot; may not
  13                 be able to print. Use another account in this case. You should test
  14                 this by trying to log in as your guest user (perhaps by using the
  15                 <command moreinfo="none">su -</command> command) and trying to print using the
  16                 system print command such as <command moreinfo="none">lpr(1)</command> or <command moreinfo="none">
  17                 lp(1)</command>.</para>
  18
  19                 <para>This parameter does not accept % macros, because
  20                 many parts of the system require this value to be
  21                 constant for correct operation.</para>
  22
  23                 <para>Default: <emphasis>specified at compile time, usually
  24                 &quot;nobody&quot;</emphasis></para>
  25
  26                 <para>Example: <command moreinfo="none">guest account = ftp</command></para></listitem>
  27                 </samba:parameter>