Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                
Skip to content

Commit b5dc761

Browse files
committed
Properly document that SIGTERM is OK for users to use on a postgres
session, now that pg_terminate_backend() uses it. Josh Kupershmidt
1 parent 39d0653 commit b5dc761

File tree

1 file changed

+9
-5
lines changed

1 file changed

+9
-5
lines changed

doc/src/sgml/ref/postgres-ref.sgml

+9-5
Original file line numberDiff line numberDiff line change
@@ -732,14 +732,18 @@ PostgreSQL documentation
732732

733733
<para>
734734
To cancel a running query, send the <literal>SIGINT</literal> signal
735-
to the process running that command.
735+
to the process running that command. To terminate a backend process
736+
cleanly, send <literal>SIGTERM</literal> to that process. See
737+
also <function>pg_cancel_backend</> and <function>pg_terminate_backend</>
738+
in <xref linkend="functions-admin-signal"> for the SQL-callable equivalents
739+
of these two actions.
736740
</para>
737741

738742
<para>
739-
The <command>postgres</command> server uses <literal>SIGTERM</literal>
740-
to tell subordinate server processes to quit normally and
741-
<literal>SIGQUIT</literal> to terminate without the normal cleanup.
742-
These signals <emphasis>should not</emphasis> be used by users. It
743+
The <command>postgres</command> server uses <literal>SIGQUIT</literal>
744+
to tell subordinate server processes to terminate without normal
745+
cleanup.
746+
This signal <emphasis>should not</emphasis> be used by users. It
743747
is also unwise to send <literal>SIGKILL</literal> to a server
744748
process &mdash; the main <command>postgres</command> process will
745749
interpret this as a crash and will force all the sibling processes

0 commit comments

Comments
 (0)