summaryrefslogtreecommitdiff
path: root/doc/src/sgml
diff options
context:
space:
mode:
authorTom Lane2019-01-26 02:14:31 +0000
committerTom Lane2019-01-26 02:14:31 +0000
commit0d5b2735122557417e24a73f92a518638d2a5a32 (patch)
treebfad53fb9157b59b0b2e3fbd92340ca56ccb167b /doc/src/sgml
parentadc2553b7069abb46ea72a663eb0208f98bca29e (diff)
Allow UNLISTEN in hot-standby mode.
Since LISTEN is (still) disallowed, UNLISTEN must be a no-op in a hot-standby session, and so there's no harm in allowing it. This change allows client code to not worry about whether it's connected to a primary or standby server when performing session-state-reset type activities. (Note that DISCARD ALL, which includes UNLISTEN, was already allowed, making it inconsistent to reject UNLISTEN.) Per discussion, back-patch to all supported versions. Shay Rojansky, reviewed by Mi Tar Discussion: https://postgr.es/m/CADT4RqCf2gA_TJtPAjnGzkC3ZiexfBZiLmA-mV66e4UyuVv8bA@mail.gmail.com
Diffstat (limited to 'doc/src/sgml')
-rw-r--r--doc/src/sgml/high-availability.sgml11
1 files changed, 8 insertions, 3 deletions
diff --git a/doc/src/sgml/high-availability.sgml b/doc/src/sgml/high-availability.sgml
index 2cd06cca197..aab6da457f8 100644
--- a/doc/src/sgml/high-availability.sgml
+++ b/doc/src/sgml/high-availability.sgml
@@ -1686,6 +1686,11 @@ if (!triggered)
Plugins and extensions - <command>LOAD</>
</para>
</listitem>
+ <listitem>
+ <para>
+ <command>UNLISTEN</command>
+ </para>
+ </listitem>
</itemizedlist>
</para>
@@ -1775,7 +1780,7 @@ if (!triggered)
</listitem>
<listitem>
<para>
- <command>LISTEN</>, <command>UNLISTEN</>, <command>NOTIFY</>
+ <command>LISTEN</>, <command>NOTIFY</>
</para>
</listitem>
</itemizedlist>
@@ -1783,8 +1788,8 @@ if (!triggered)
<para>
In normal operation, <quote>read-only</> transactions are allowed to
- use <command>LISTEN</>, <command>UNLISTEN</>, and
- <command>NOTIFY</>, so Hot Standby sessions operate under slightly tighter
+ use <command>LISTEN</command> and <command>NOTIFY</command>,
+ so Hot Standby sessions operate under slightly tighter
restrictions than ordinary read-only sessions. It is possible that some
of these restrictions might be loosened in a future release.
</para>