1
0
mirror of https://github.com/postgres/postgres.git synced 2025-07-28 23:42:10 +03:00

Remove ipcclean utility command --- didn't work on all Unixes and on

Windows.  Users should use their operating system tools instead.
This commit is contained in:
Bruce Momjian
2008-03-27 17:24:16 +00:00
parent fe11719c2e
commit 39627b1ae6
7 changed files with 6 additions and 227 deletions

View File

@ -1,5 +1,5 @@
<!--
$PostgreSQL: pgsql/doc/src/sgml/ref/allfiles.sgml,v 1.72 2007/08/21 21:08:47 tgl Exp $
$PostgreSQL: pgsql/doc/src/sgml/ref/allfiles.sgml,v 1.73 2008/03/27 17:24:16 momjian Exp $
PostgreSQL documentation
Complete list of usable sgml source files in this directory.
-->
@ -145,7 +145,6 @@ Complete list of usable sgml source files in this directory.
<!entity dropuser system "dropuser.sgml">
<!entity ecpgRef system "ecpg-ref.sgml">
<!entity initdb system "initdb.sgml">
<!entity ipcclean system "ipcclean.sgml">
<!entity pgConfig system "pg_config-ref.sgml">
<!entity pgControldata system "pg_controldata.sgml">
<!entity pgCtl system "pg_ctl-ref.sgml">

View File

@ -1,70 +0,0 @@
<!--
$PostgreSQL: pgsql/doc/src/sgml/ref/ipcclean.sgml,v 1.14 2007/01/31 23:26:04 momjian Exp $
PostgreSQL documentation
-->
<refentry id="APP-IPCCLEAN">
<refmeta>
<refentrytitle id="APP-IPCCLEAN-TITLE"><application>ipcclean</application></refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo>Application</refmiscinfo>
</refmeta>
<refnamediv>
<refname>ipcclean</refname>
<refpurpose>remove shared memory and semaphores from a failed <productname>PostgreSQL</productname> server</refpurpose>
</refnamediv>
<indexterm zone="app-ipcclean">
<primary>ipcclean</primary>
</indexterm>
<refsynopsisdiv>
<cmdsynopsis>
<command>ipcclean</command>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1 id="R1-APP-IPCCLEAN-1">
<title>Description</title>
<para>
<command>ipcclean</command> removes all shared memory segments and
semaphore sets owned by the current user. It is intended to be
used for cleaning up after a crashed
<productname>PostgreSQL</productname> server (<xref
linkend="app-postgres">). Note that immediately restarting the
server will also clean up shared memory and semaphores, so this
command is of little real utility.
</para>
<para>
Only the database administrator should execute this program as it
can cause bizarre behavior (i.e., crashes) if run during multiuser
execution. If this command is executed while a server is running,
the shared memory and semaphores allocated by that server will be
deleted, which would have rather severe consequences for that
server.
</para>
</refsect1>
<refsect1>
<title>Notes</title>
<para>
This script is a hack, but in the many years since it was written,
no one has come up with an equally effective and portable solution.
Since <command>postgres</command> can now clean up by
itself, it is unlikely that <command>ipcclean</command> will be
improved upon in the future.
</para>
<para>
The script makes assumptions about the output format of the
<command>ipcs</command>
utility which might not be true across different operating systems.
Therefore, it might not work on your particular OS. It's wise to
look at the script before trying it.
</para>
</refsect1>
</refentry>

View File

@ -1,4 +1,4 @@
<!-- $PostgreSQL: pgsql/doc/src/sgml/reference.sgml,v 1.65 2007/08/21 21:08:47 tgl Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/reference.sgml,v 1.66 2008/03/27 17:24:16 momjian Exp $ -->
<part id="reference">
<title>Reference</title>
@ -211,7 +211,6 @@
</partintro>
&initdb;
&ipcclean;
&pgControldata;
&pgCtl;
&pgResetxlog;