docs/smbdotconf/misc/defaultservice.xml

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