From: Robert Haas <rhaas@postgresql.org>
Date: Thu, 30 Jan 2014 01:27:37 +0000 (-0500)
Subject: Document hazards of --slot.
X-Git-Url: http://waps.l3s.uni-hannover.de/gitweb/?a=commitdiff_plain;h=cf9c45bc26e7a4332c7285a17ee9c4396dc8042d;p=users%2Frhaas%2Fpostgres.git

Document hazards of --slot.
---

diff --git a/doc/src/sgml/ref/pg_receivexlog.sgml b/doc/src/sgml/ref/pg_receivexlog.sgml
index e592699ac7..2a44af46c5 100644
--- a/doc/src/sgml/ref/pg_receivexlog.sgml
+++ b/doc/src/sgml/ref/pg_receivexlog.sgml
@@ -232,6 +232,14 @@ PostgreSQL documentation
         <para>
          Require <application>pg_receivexlog</application> to use an existing
          replication slot (see <xref linkend="streaming-replication-slots">).
+         When this option is used, <application>pg_receivexlog</> will report
+         a flush position to the server, indicating when each segment has been
+         synchronized to disk so that the server can remove that segment if it
+         is not otherwise needed.  When using this paramter, it is important
+         to make sure that <application>pg_receivexlog</> cannot become the
+         synchronous standby through an incautious setting of
+         <xref linkend="guc-synchronous-standby-names">; it does not flush
+         data frequently enough for this to work correctly.
         </para>
       </listitem>
      </varlistentry>