Author: kseeger Date: 2008-01-18 10:19:31 +0000 (Fri, 18 Jan 2008) New Revision: 1226
WebSVN: http://websvn.samba.org/cgi-bin/viewcvs.cgi?view=rev&root=samba-docs&rev=1226 Log: -fix some typos -add missing whitespaces -fix example for 'registry shares' still missing: Description of 'config backend' Karolin Modified: trunk/manpages-3/smb.conf.5.xml trunk/smbdotconf/misc/registryshares.xml Changeset: Modified: trunk/manpages-3/smb.conf.5.xml =================================================================== --- trunk/manpages-3/smb.conf.5.xml 2008-01-16 17:26:57 UTC (rev 1225) +++ trunk/manpages-3/smb.conf.5.xml 2008-01-18 10:19:31 UTC (rev 1226) @@ -717,14 +717,14 @@ <para> Starting with Samba version 3.2.0, the capability to store Samba configuration in the registry is available. - There are two levels of registry configuration. + There are two levels of registry configuration: </para> <orderedlist continuation="restarts" inheritnum="ignore" numeration="arabic"> <listitem><para>Share definitions stored in registry are used. - This is triggered by setting the global parameter - <parameter>registry shares</parameter> to - <quote>yes</quote> in <emphasis>smb.conf</emphasis>. + This is triggered by setting the global + parameter <parameter>registry shares</parameter> to <quote>yes</quote> + in <emphasis>smb.conf</emphasis>. </para> <para>Note: Shares defined in <emphasis>smb.conf</emphasis> @@ -733,15 +733,14 @@ </para></listitem> <listitem><para>Global <emphasis>smb.conf</emphasis> options stored in - registry are used. This - is triggered by a new parameter - <smbconfoption name="config backend">registry</smbconfoption> in + registry are used. This is triggered by the + parameter <smbconfoption name="config backend">registry</smbconfoption> in the [global] section of <emphasis>smb.conf</emphasis>. - This this removes everything that has been red from config files - to this poing and reads the content of the global configuration - section from the regsitry + This removes everything that has been read from config files + to this point and reads the content of the global configuration + section from the registry. Activation of global registry options automatically - activates registry shares. In this case, no share definition + activates registry shares. In this case, no share definitions from smb.conf are read: This is a registry only configuration with the advantage that share definitions are not read in a bulk at startup time but on demand when a share is @@ -750,13 +749,13 @@ </orderedlist> <para> - Caveat: To make registry-based configurations foolprof at least to a - certain extent, the use of - <parameter>lock directory</parameter>, - <parameter>config backend</parameter>, - and <parameter>include</parameter> inside the registry + Caveat: To make registry-based configurations foolproof at least to a + certain extent, the use + of <parameter>lock directory</parameter>, + <parameter>config backend</parameter>, and + <parameter>include</parameter> inside the registry configuration has been disabled. Especially, by changing the - <parameter>lock directory</parameter> inside the registry + <parameter>lock directory</parameter> inside the registry configuration, one would create a broken setup where the daemons do not see the configuration they loaded once it is active. </para> @@ -765,10 +764,10 @@ The registry configuration can be accessed with tools like <emphasis>regedit</emphasis> or <emphasis>net rpc registry</emphasis> in the key - <emphasis><literal>HKLM\Software\Samba\smbconf</literal></emphasis>. + <emphasis><literal>HKLM\Software\Samba\smbconf</literal></emphasis>. More conveniently, the <emphasis>conf</emphasis> subcommand of the - <citerefentry><refentrytitle>net</refentrytitle> + <citerefentry><refentrytitle>net</refentrytitle> <manvolnum>8</manvolnum></citerefentry> utility offers a dedicated interface to read and write the registry based configuration locally, i.e. directly Modified: trunk/smbdotconf/misc/registryshares.xml =================================================================== --- trunk/smbdotconf/misc/registryshares.xml 2008-01-16 17:26:57 UTC (rev 1225) +++ trunk/smbdotconf/misc/registryshares.xml 2008-01-18 10:19:31 UTC (rev 1226) @@ -6,11 +6,11 @@ <description> <para> This turns on or off support for share definitions read from - registry. Shares in defined in <emphasis>smb.conf</emphasis> take + registry. Shares defined in <emphasis>smb.conf</emphasis> take precedence over shares with the same name defined in registry. See the section on registry-based configuration for details. </para> </description> -<value type="example">/usr/local/samba/lib/smb.conf.%m</value> +<value type="example">yes</value> </samba:parameter>
