Add new framework for smb.conf(5). Please read README before trying to compile.

I will commit more meta-information updates during week-end.
(This used to be commit 8d684dffab6a90b3d612a1aa2b2c457a2bc2e6ac)

1 files changed, 36 insertions, 0 deletions

diff --git a/docs/docbook/smbdotconf/misc/defaultservice.xml b/docs/docbook/smbdotconf/misc/defaultservice.xml
new file mode 100644
index 0000000000..7aeedb177a
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/defaultservice.xml
@@ -0,0 +1,36 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+		<term><anchor id="DEFAULTSERVICE"/>default service (G)</term>
+		<listitem><para>This parameter specifies the name of a service
+		which will be connected to if the service actually requested cannot
+		be found. Note that the square brackets are <emphasis>NOT</emphasis>
+		given in the parameter value (see example below).</para>
+
+		<para>There is no default value for this parameter. If this 
+		parameter is not given, attempting to connect to a nonexistent 
+		service results in an error.</para>
+
+		<para>Typically the default service would be a <link linkend="GUESTOK">
+		<parameter moreinfo="none">guest ok</parameter></link>, <link linkend="READONLY">
+		<parameter moreinfo="none">read-only</parameter></link> service.</para>
+
+		<para>Also note that the apparent service name will be changed 
+		to equal that of the requested service, this is very useful as it 
+		allows you to use macros like <parameter moreinfo="none">%S</parameter> to make 
+		a wildcard service.</para>
+
+		<para>Note also that any &quot;_&quot; characters in the name of the service 
+		used in the default service will get mapped to a &quot;/&quot;. This allows for
+		interesting things.</para>
+
+
+		<para>Example:</para>
+		
+<para><programlisting format="linespecific">
+[global]
+	default service = pub
+        
+[pub]
+	path = /%S
+</programlisting></para>
+		</listitem>
+		</samba:parameter>