summaryrefslogtreecommitdiff
path: root/docs/rabbitmqctl.1.xml
diff options
context:
space:
mode:
authorSimon MacMullen <simon@rabbitmq.com>2012-12-06 16:52:13 +0000
committerSimon MacMullen <simon@rabbitmq.com>2012-12-06 16:52:13 +0000
commit01c21a1fac5b5b44f5dd1ee66bcd05ee1f8155c8 (patch)
tree6719bec734b8ba01c1fb4f7a30abbdb124f23e74 /docs/rabbitmqctl.1.xml
parent29890303973a75f5afc86e902ff55dd138412577 (diff)
downloadrabbitmq-server-git-01c21a1fac5b5b44f5dd1ee66bcd05ee1f8155c8.tar.gz
Add rabbitmqctl sync_queue, and make it synchronous. Also fix the fact that we were treating "no queues to sync" as a 'normal' crash of the syncer, which... no.
Diffstat (limited to 'docs/rabbitmqctl.1.xml')
-rw-r--r--docs/rabbitmqctl.1.xml31
1 files changed, 31 insertions, 0 deletions
diff --git a/docs/rabbitmqctl.1.xml b/docs/rabbitmqctl.1.xml
index 34947b66e8..1583ab98a8 100644
--- a/docs/rabbitmqctl.1.xml
+++ b/docs/rabbitmqctl.1.xml
@@ -446,6 +446,37 @@
</para>
</listitem>
</varlistentry>
+ <varlistentry>
+ <term><cmdsynopsis><command>sync_queue</command> <arg choice="req">queue</arg></cmdsynopsis>
+ </term>
+ <listitem>
+ <variablelist>
+ <varlistentry>
+ <term>queue</term>
+ <listitem>
+ <para>
+ The name of the queue to synchronise.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <para>
+ Instructs a mirrored queue with unsynchronised slaves to
+ synchronise itself. The queue will block while
+ synchronisation takes place (all publishers to and
+ consumers from the queue will block). The queue must be
+ mirrored, must have unsynchronised slaves, and must not
+ have any pending unacknowledged messages for this
+ command to succeed.
+ </para>
+ <para>
+ Note that unsynchronised queues from which messages are
+ being drained will become synchronised eventually. This
+ command is primarily useful for queues which are not
+ being drained.
+ </para>
+ </listitem>
+ </varlistentry>
</variablelist>
</refsect2>