docs-xml/smbdotconf/security/validusers.xml

   1 <samba:parameter name="valid users"
   2                  context="S"
   3                                  type="list"
   4                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
   5 <description>
   6     <para>
   7     This is a list of users that should be allowed to login to this service. Names starting with
   8     '@', '+' and  '&amp;' are interpreted using the same rules as described in the
   9     <parameter moreinfo="none">invalid users</parameter> parameter.
  10     </para>
  11
  12     <para>
  13     If this is empty (the default) then any user can login. If a username is in both this list
  14     and the <parameter moreinfo="none">invalid users</parameter> list then access is denied
  15     for that user.
  16     </para>
  17
  18     <para>
  19     The current servicename is substituted for <parameter moreinfo="none">%S</parameter>.
  20     This is useful in the [homes] section.
  21     </para>
  22
  23     <para><emphasis>Note: </emphasis>When used in the [global] section this
  24     parameter may have unwanted side effects. For example: If samba is configured as a MASTER BROWSER (see
  25     <parameter moreinfo="none">local master</parameter>,
  26     <parameter moreinfo="none">os level</parameter>,
  27     <parameter moreinfo="none">domain master</parameter>,
  28     <parameter moreinfo="none">preferred master</parameter>) this option
  29     will prevent workstations from being able to browse the network.
  30     </para>
  31
  32 </description>
  33
  34 <related>invalid users</related>
  35
  36 <value type="default"><comment>No valid users list (anyone can login) </comment></value>
  37 <value type="example">greg, @pcusers</value>
  38 </samba:parameter>