aboutsummaryrefslogtreecommitdiff
path: root/doc/src
diff options
context:
space:
mode:
authorNoah Misch <noah@leadboat.com>2019-06-08 10:12:26 -0700
committerNoah Misch <noah@leadboat.com>2019-06-08 10:12:26 -0700
commita806b14a1139d3443a7c2c263abb9ff8e4a65694 (patch)
tree54fdfccb5e2c230699a6a0b855b64e60eb49c0da /doc/src
parentf2c71cb71fe186dcf8ebec967f98d1c7c4777943 (diff)
downloadpostgresql-a806b14a1139d3443a7c2c263abb9ff8e4a65694.tar.gz
postgresql-a806b14a1139d3443a7c2c263abb9ff8e4a65694.zip
Update documentation about SIGKILL of postmaster.
Removing shared memory and semaphores in response to server start failure often masks the real problem, a live process associated with the data directory; see commit 5a907404b52753c4d6c6a7c21765aeaa42fd6a3b. Since 9.6, it's rarely necessary to kill subprocesses manually. (When it is necessary, that commit's HINT will say as much, in all supported versions.)
Diffstat (limited to 'doc/src')
-rw-r--r--doc/src/sgml/runtime.sgml14
1 files changed, 6 insertions, 8 deletions
diff --git a/doc/src/sgml/runtime.sgml b/doc/src/sgml/runtime.sgml
index e053e2ee34b..18c11a2bed1 100644
--- a/doc/src/sgml/runtime.sgml
+++ b/doc/src/sgml/runtime.sgml
@@ -1685,14 +1685,12 @@ $ <userinput>kill -INT `head -1 /usr/local/pgsql/data/postmaster.pid`</userinput
<important>
<para>
- It is best not to use <systemitem>SIGKILL</systemitem> to shut down
- the server. Doing so will prevent the server from releasing
- shared memory and semaphores, which might then have to be done
- manually before a new server can be started. Furthermore,
- <systemitem>SIGKILL</systemitem> kills the <command>postgres</command>
- process without letting it relay the signal to its subprocesses,
- so it will be necessary to kill the individual subprocesses by hand as
- well.
+ It is best not to use <systemitem>SIGKILL</systemitem> to shut down the
+ server. Doing so will prevent the server from releasing shared memory and
+ semaphores. Furthermore, <systemitem>SIGKILL</systemitem> kills
+ the <command>postgres</command> process without letting it relay the
+ signal to its subprocesses, so it might be necessary to kill the
+ individual subprocesses by hand as well.
</para>
</important>