summaryrefslogtreecommitdiff
path: root/doc/src
diff options
context:
space:
mode:
authorRobert Haas2012-06-26 20:16:52 +0000
committerRobert Haas2012-06-26 20:16:52 +0000
commitc60ca19de9ad777c51243605571d1d7606000f08 (patch)
treed56bf6bd275ec79df90e9f216153b621ff4f8f31 /doc/src
parentb79ab00144e64217d418fde884bca8ea58fbd4a4 (diff)
Allow pg_terminate_backend() to be used on backends with matching role.
A similar change was made previously for pg_cancel_backend, so now it all matches again. Dan Farina, reviewed by Fujii Masao, Noah Misch, and Jeff Davis, with slight kibitzing on the doc changes by me.
Diffstat (limited to 'doc/src')
-rw-r--r--doc/src/sgml/func.sgml11
-rw-r--r--doc/src/sgml/high-availability.sgml16
2 files changed, 16 insertions, 11 deletions
diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index 595523e3eba..4f539428e28 100644
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -14393,7 +14393,11 @@ SELECT set_config('log_statement_stats', 'off', false);
<literal><function>pg_terminate_backend(<parameter>pid</parameter> <type>int</>)</function></literal>
</entry>
<entry><type>boolean</type></entry>
- <entry>Terminate a backend</entry>
+ <entry>Terminate a backend. You can execute this against
+ another backend that has exactly the same role as the user
+ calling the function. In all other cases, you must be a
+ superuser.
+ </entry>
</row>
</tbody>
</tgroup>
@@ -14414,9 +14418,8 @@ SELECT set_config('log_statement_stats', 'off', false);
<command>postgres</command> processes on the server (using
<application>ps</> on Unix or the <application>Task
Manager</> on <productname>Windows</>).
- For the less restrictive <function>pg_cancel_backend</>, the role of an
- active backend can be found from
- the <structfield>usename</structfield> column of the
+ The role of an active backend can be found from the
+ <structfield>usename</structfield> column of the
<structname>pg_stat_activity</structname> view.
</para>
diff --git a/doc/src/sgml/high-availability.sgml b/doc/src/sgml/high-availability.sgml
index c268bfb8d3f..4eb37d24610 100644
--- a/doc/src/sgml/high-availability.sgml
+++ b/doc/src/sgml/high-availability.sgml
@@ -1969,13 +1969,15 @@ LOG: database system is ready to accept read only connections
</para>
<para>
- <function>pg_cancel_backend()</> will work on user backends, but not the
- Startup process, which performs recovery. <structname>pg_stat_activity</structname> does not
- show an entry for the Startup process, nor do recovering transactions
- show as active. As a result, <structname>pg_prepared_xacts</structname> is always empty during
- recovery. If you wish to resolve in-doubt prepared transactions,
- view <literal>pg_prepared_xacts</> on the primary and issue commands to
- resolve transactions there.
+ <function>pg_cancel_backend()</>
+ and <function>pg_terminate_backend()</> will work on user backends,
+ but not the Startup process, which performs
+ recovery. <structname>pg_stat_activity</structname> does not show an
+ entry for the Startup process, nor do recovering transactions show
+ as active. As a result, <structname>pg_prepared_xacts</structname>
+ is always empty during recovery. If you wish to resolve in-doubt
+ prepared transactions, view <literal>pg_prepared_xacts</> on the
+ primary and issue commands to resolve transactions there.
</para>
<para>