docs-xml/smbdotconf/misc/defaultservice.xml

   1 <samba:parameter name="default service"
   2                  context="G"
   3                  type="string"
   4                  function="defaultservice"
   5                  substitution="1"
   6                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
   7 <synonym>default</synonym>
   8 <description>
   9         <para>This parameter specifies the name of a service
  10         which will be connected to if the service actually requested cannot
  11         be found. Note that the square brackets are <emphasis>NOT</emphasis>
  12         given in the parameter value (see example below).</para>
  13
  14         <para>There is no default value for this parameter. If this
  15         parameter is not given, attempting to connect to a nonexistent
  16         service results in an error.</para>
  17
  18         <para>
  19         Typically the default service would be a <smbconfoption name="guest ok"/>, <smbconfoption
  20         name="read only"/> service.</para> <para>Also note that the apparent service name will be changed to equal
  21         that of the requested service, this is very useful as it allows you to use macros like <parameter
  22         moreinfo="none">%S</parameter> to make a wildcard service.
  23         </para>
  24
  25         <para>Note also that any &quot;_&quot; characters in the name of the service
  26         used in the default service will get mapped to a &quot;/&quot;. This allows for
  27         interesting things.</para>
  28 </description>
  29 <value type="default"></value>
  30 <value type="example">pub</value>
  31 </samba:parameter>