docs/docbook/smbdotconf/misc/defaultservice.xml

   1 <samba:parameter xmlns:samba="http://samba.org/common">
   2                 <term><anchor id="DEFAULTSERVICE"/>default service (G)</term>
   3                 <listitem><para>This parameter specifies the name of a service
   4                 which will be connected to if the service actually requested cannot
   5                 be found. Note that the square brackets are <emphasis>NOT</emphasis>
   6                 given in the parameter value (see example below).</para>
   7
   8                 <para>There is no default value for this parameter. If this
   9                 parameter is not given, attempting to connect to a nonexistent
  10                 service results in an error.</para>
  11
  12                 <para>Typically the default service would be a <link linkend="GUESTOK">
  13                 <parameter moreinfo="none">guest ok</parameter></link>, <link linkend="READONLY">
  14                 <parameter moreinfo="none">read-only</parameter></link> service.</para>
  15
  16                 <para>Also note that the apparent service name will be changed
  17                 to equal that of the requested service, this is very useful as it
  18                 allows you to use macros like <parameter moreinfo="none">%S</parameter> to make
  19                 a wildcard service.</para>
  20
  21                 <para>Note also that any &quot;_&quot; characters in the name of the service
  22                 used in the default service will get mapped to a &quot;/&quot;. This allows for
  23                 interesting things.</para>
  24
  25
  26                 <para>Example:</para>
  27
  28 <para><programlisting format="linespecific">
  29 [global]
  30         default service = pub
  31
  32 [pub]
  33         path = /%S
  34 </programlisting></para>
  35                 </listitem>
  36                 </samba:parameter>