Properly document that SIGTERM is OK for users to use on a postgres

session, now that pg_terminate_backend() uses it.

Josh Kupershmidt
This commit is contained in:
Bruce Momjian 2012-08-30 17:58:36 -04:00
parent 39d0653d05
commit b5dc7612a5

View File

@ -732,14 +732,18 @@ PostgreSQL documentation
<para> <para>
To cancel a running query, send the <literal>SIGINT</literal> signal To cancel a running query, send the <literal>SIGINT</literal> signal
to the process running that command. to the process running that command. To terminate a backend process
cleanly, send <literal>SIGTERM</literal> to that process. See
also <function>pg_cancel_backend</> and <function>pg_terminate_backend</>
in <xref linkend="functions-admin-signal"> for the SQL-callable equivalents
of these two actions.
</para> </para>
<para> <para>
The <command>postgres</command> server uses <literal>SIGTERM</literal> The <command>postgres</command> server uses <literal>SIGQUIT</literal>
to tell subordinate server processes to quit normally and to tell subordinate server processes to terminate without normal
<literal>SIGQUIT</literal> to terminate without the normal cleanup. cleanup.
These signals <emphasis>should not</emphasis> be used by users. It This signal <emphasis>should not</emphasis> be used by users. It
is also unwise to send <literal>SIGKILL</literal> to a server is also unwise to send <literal>SIGKILL</literal> to a server
process &mdash; the main <command>postgres</command> process will process &mdash; the main <command>postgres</command> process will
interpret this as a crash and will force all the sibling processes interpret this as a crash and will force all the sibling processes