aboutsummaryrefslogtreecommitdiff
path: root/doc/src
diff options
context:
space:
mode:
authorNoah Misch <noah@leadboat.com>2024-05-16 14:11:00 -0700
committerNoah Misch <noah@leadboat.com>2024-05-16 14:11:00 -0700
commit372700cf3067254317e7e8060662f8fac11500d5 (patch)
tree4cb1af4322e066c1f19e3c1a2cbd819e44480f0b /doc/src
parenta3e6c6f929912f928fa405909d17bcbf0c1b03ee (diff)
downloadpostgresql-372700cf3067254317e7e8060662f8fac11500d5.tar.gz
postgresql-372700cf3067254317e7e8060662f8fac11500d5.zip
Fix documentation about DROP DATABASE FORCE process termination rights.
Specifically, it terminates a background worker even if the caller couldn't terminate the background worker with pg_terminate_backend(). Commit 3a9b18b3095366cd0c4305441d426d04572d88c1 neglected to update this. Back-patch to v13, which introduced DROP DATABASE FORCE. Reviewed by Amit Kapila. Reported by Kirill Reshke. Discussion: https://postgr.es/m/20240429212756.60.nmisch@google.com
Diffstat (limited to 'doc/src')
-rw-r--r--doc/src/sgml/ref/drop_database.sgml12
1 files changed, 7 insertions, 5 deletions
diff --git a/doc/src/sgml/ref/drop_database.sgml b/doc/src/sgml/ref/drop_database.sgml
index ff01450ba77..55c52ae93bc 100644
--- a/doc/src/sgml/ref/drop_database.sgml
+++ b/doc/src/sgml/ref/drop_database.sgml
@@ -79,12 +79,14 @@ DROP DATABASE [ IF EXISTS ] <replaceable class="parameter">name</replaceable> [
It doesn't terminate if prepared transactions, active logical replication
slots or subscriptions are present in the target database.
</para>
+ <!-- not mentioning exception for autovacuum workers, since those are an
+ implementation detail and the exception is not specific to FORCE -->
<para>
- This will fail if the current user has no permissions to terminate other
- connections. Required permissions are the same as with
- <literal>pg_terminate_backend</literal>, described in
- <xref linkend="functions-admin-signal"/>. This will also fail if we
- are not able to terminate connections.
+ This terminates background worker connections and connections that the
+ current user has permission to terminate
+ with <function>pg_terminate_backend</function>, described in
+ <xref linkend="functions-admin-signal"/>. If connections would remain,
+ this command will fail.
</para>
</listitem>
</varlistentry>