From 39627b1ae680cba44f6e56ca5facec4fdbfe9495 Mon Sep 17 00:00:00 2001
From: Bruce Momjian <bruce@momjian.us>
Date: Thu, 27 Mar 2008 17:24:16 +0000
Subject: Remove ipcclean utility command --- didn't work on all Unixes and on
 Windows.  Users should use their operating system tools instead.

---
 doc/src/sgml/ref/allfiles.sgml |  3 +-
 doc/src/sgml/ref/ipcclean.sgml | 70 ------------------------------------------
 doc/src/sgml/reference.sgml    |  3 +-
 3 files changed, 2 insertions(+), 74 deletions(-)
 delete mode 100644 doc/src/sgml/ref/ipcclean.sgml

(limited to 'doc/src')

diff --git a/doc/src/sgml/ref/allfiles.sgml b/doc/src/sgml/ref/allfiles.sgml
index 898c2c67910..b80a2cf8f04 100644
--- a/doc/src/sgml/ref/allfiles.sgml
+++ b/doc/src/sgml/ref/allfiles.sgml
@@ -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">
diff --git a/doc/src/sgml/ref/ipcclean.sgml b/doc/src/sgml/ref/ipcclean.sgml
deleted file mode 100644
index 97f0d881951..00000000000
--- a/doc/src/sgml/ref/ipcclean.sgml
+++ /dev/null
@@ -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>
diff --git a/doc/src/sgml/reference.sgml b/doc/src/sgml/reference.sgml
index 1e8e5465314..a0aed8edf53 100644
--- a/doc/src/sgml/reference.sgml
+++ b/doc/src/sgml/reference.sgml
@@ -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;
-- 
cgit v1.2.3