</p>
<hr />
<h1><a name="version">VERSION</a></h1>
-<p>This document describes version 5.0.0 of bucardo</p>
+<p>This document describes version 4.99.8 of bucardo</p>
<p>
</p>
<hr />
<p>The service name to use for a Postgres database. Optional.</p>
</dd>
</dl>
+<p><strong>Note:</strong> As a convenience, if the <a href="#dbuser"><code>dbuser</code></a> value is its default value,
+"bucardo", in the event that Bucardo cannot connect to the database, it will
+try connecting as "postgres" and create a superuser named "bucardo". This is
+to make things easier for folks getting started with Bucardo, but will not
+work if it cannot connect as "postgres", or if it the connection failed due to
+an authentication failure.</p>
<p>
</p>
<h3><a name="add_dbgroup">add dbgroup</a></h3>
for this table. Value can also be "on" to enable makedelta for all databases.
Defaults to "off".</p>
</dd>
+<dt><strong><a name="strict_check" class="item"><code>strict_check</code></a></strong></dt>
+
+<dd>
+<p>Boolean indicating whether or not to be strict when comparing the table
+between syncs. If the columns have different names or data types, the
+validation will fail. But perhaps the columns are allowed to have different
+names or data types. If so, disable <a href="#strict_check"><code>strict_check</code></a> and column diffrences will
+result in warnings rather than failing the validation. Defaults to true.</p>
+</dd>
</dl>
<p>
</p>
<p>Boolean indicating whether or not to rebuild indexes after every sync. Off by
default. Optional.</p>
</dd>
+<dt><strong><code>strict_check</code></strong></dt>
+
+<dd>
+<p>Boolean indicating whether or not to be strict when comparing tables in the
+sync. If the columns have different names or data types, the validation will
+fail. But perhaps the columns are allowed to have different names or data
+types. If so, disable <a href="#strict_check"><code>strict_check</code></a> and column diffrences will result in
+warnings rather than failing the validation. Defaults to true.</p>
+</dd>
</dl>
<p>
</p>
are higher priority. Useful for subroutines that set <a href="#lastcode"><code>lastcode</code></a> in order to
cancel the execution of subsequent custom codes for the same <a href="#when_run"><code>when_run</code></a>.</p>
</dd>
-</dl>
-<dl>
<dt><strong><code>status</code></strong></dt>
<dd>
<dd>
<p>Indicates whether or not the sync is active. Must be either "active" or
-"inactive".</p>
+"inactive". Note that this will not change the current run status of the sync,
+just mark whether it should be active or inactive on the next reload. Use the
+<code>activate sync</code> and <deactivate sync> commands to actually activate or
+deactivate a sync.</p>
</dd>
<dt><strong><code>rebuild_index</code></strong></dt>
<dd>
<p>Boolean indicating whether or not to rebuild indexes after every sync.</p>
</dd>
+<dt><strong><code>strict_check</code></strong></dt>
+
+<dd>
+<p>Boolean indicating whether or not to be strict when comparing tables in the
+sync. If the columns have different names or data types, the validation will
+fail. But perhaps the columns are allowed to have different names or data
+types. If so, disable <a href="#strict_check"><code>strict_check</code></a> and column diffrences will result in
+warnings rather than failing the validation. Defaults to true.</p>
+</dd>
</dl>
<p>
</p>
<dd>
<p>Specifies which databases need makedelta enabled for this table.</p>
</dd>
+<dt><strong><code>strict_check</code></strong></dt>
+
+<dd>
+<p>Boolean indicating whether or not to be strict when comparing the table
+between syncs. If the columns have different names or data types, the
+validation will fail. But perhaps the columns are allowed to have different
+names or data types. If so, disable <a href="#strict_check"><code>strict_check</code></a> and column diffrences will
+result in warnings rather than failing the validation. Defaults to true.</p>
+</dd>
</dl>
<p>
</p>
<dt><strong><a name="bucardo_current_version" class="item"><code>bucardo_current_version</code></a></strong></dt>
<dd>
-<p>Current version of Bucardo. Default: <code>5.0.0</code>.</p>
+<p>Current version of Bucardo. Default: <code>4.99.8</code>.</p>
</dd>
<dt><strong><a name="bucardo_vac" class="item"><code>bucardo_vac</code></a></strong></dt>
<dt><strong><a name="bucardo_version" class="item"><code>bucardo_version</code></a></strong></dt>
<dd>
-<p>Bucardo version this schema was created with. Default: <code>5.0.0</code>.</p>
+<p>Bucardo version this schema was created with. Default: <code>4.99.8</code>.</p>
</dd>
<dt><strong><a name="ctl_checkonkids_time" class="item"><code>ctl_checkonkids_time</code></a></strong></dt>
<dd>
<p>File to hold reasons for stopping and starting. Default: <code>bucardo.restart.reason.txt</code>.</p>
</dd>
+<dt><strong><a name="reload_config_timeout" class="item"><code>reload_config_timeout</code></a></strong></dt>
+
+<dd>
+<p>Number of seconds the <a href="#reload_config"><code>reload_config</code></a> command should wait for the reload to complete.
+Default: <code>30</code>.</p>
+</dd>
<dt><strong><a name="semaphore_table" class="item"><code>semaphore_table</code></a></strong></dt>
<dd>
</li>
<li><strong><a name="state" class="item"><strong>State</strong></a></strong>
-<p>The state of the sync. Can be 'Good', 'Bad', 'Empty', or 'No records found'</p>
+<p>The state of the sync. Can be 'Good', 'Bad', 'Empty', 'No records found',
+'Unknown', or the run state for a currently-running sync.</p>
</li>
<li><strong><a name="last_good" class="item"><strong>Last good</strong></a></strong>
bucardo validate all|<sync> [<sync>...]</pre>
<p>Validates one or more syncs. Use the keyword "all" to validate all syncs, or
specify one or more syncs to validate.</p>
+<p>Note that this command executes a subset of all the validation done when a
+sync is started or activated.</p>
<p>
</p>
<h2><a name="purge">purge</a></h2>