granicus.if.org Git - postgresql/blob - doc/src/sgml/ref/ipcclean.sgml

   1 <!--
   2 $Header: /cvsroot/pgsql/doc/src/sgml/ref/Attic/ipcclean.sgml,v 1.2 2000/10/05 19:48:18 momjian Exp $
   3 Postgres documentation
   4 -->
   5
   6 <refentry id="APP-IPCCLEAN">
   7  <refmeta>
   8   <refentrytitle id="APP-IPCCLEAN-TITLE">
   9    <application>ipcclean</application>
  10   </refentrytitle>
  11   <refmiscinfo>Application</refmiscinfo>
  12  </refmeta>
  13  <refnamediv>
  14   <refname>
  15    <application>ipcclean</application>
  16   </refname>
  17   <refpurpose>
  18    Clean up shared memory and semaphores from aborted backends
  19   </refpurpose>
  20  </refnamediv>
  21  <refsynopsisdiv>
  22   <refsynopsisdivinfo>
  23    <date>1999-07-20</date>
  24   </refsynopsisdivinfo>
  25   <synopsis>
  26 ipcclean
  27   </synopsis>
  28
  29   <refsect2 id="R2-APP-IPCCLEAN-1">
  30    <refsect2info>
  31     <date>1999-07-20</date>
  32    </refsect2info>
  33    <title>
  34     Inputs
  35    </title>
  36    <para>
  37     None.
  38    </para>
  39   </refsect2>
  40
  41   <refsect2 id="R2-APP-IPCCLEAN-2">
  42    <refsect2info>
  43     <date>1999-07-30</date>
  44    </refsect2info>
  45    <title>
  46     Outputs
  47    </title>
  48    <para>
  49     None.
  50    </para>
  51   </refsect2>
  52  </refsynopsisdiv>
  53
  54  <refsect1 id="R1-APP-IPCCLEAN-1">
  55   <refsect1info>
  56    <date>1999-07-20</date>
  57   </refsect1info>
  58   <title>
  59    Description
  60   </title>
  61   <para>
  62    <application>ipcclean</application>
  63    cleans up shared memory and semaphore space from aborted backends by
  64    deleting all instances owned by user <literal>postgres</literal>.
  65    Only the DBA
  66    should execute this program as it can cause bizarre behavior (i.e.,
  67    crashes) if run during multi-user execution.  This program should be
  68    executed if messages such as
  69
  70    <computeroutput>
  71 semget: No space left on device
  72    </computeroutput>
  73
  74    are encountered when starting up the
  75    <application>postmaster</application> or the backend server.
  76   </para>
  77
  78   <para>
  79    If this command is executed while <application>postmaster</application>
  80    is running, the shared memory and semaphores allocated by the
  81    <application>postmaster</application>
  82    will be deleted.  This will result in a general failure of the
  83    backend servers started by that
  84    <application>postmaster</application>.
  85   </para>
  86
  87   <para>
  88    This script is a hack, but in the many years since it was written, no
  89    one has come up with an equally effective and portable solution.
  90    Suggestions are welcome.
  91   </para>
  92
  93   <para>
  94    The script makes assumption about the format of output of the
  95    <application>ipcs</application>
  96    utility which may not be true across different operating systems.
  97    Therefore, it may not work on your particular OS.
  98   </para>
  99  </refsect1>
 100 </refentry>
 101
 102 <!-- Keep this comment at the end of the file
 103 Local variables:
 104 mode: sgml
 105 sgml-omittag:nil
 106 sgml-shorttag:t
 107 sgml-minimize-attributes:nil
 108 sgml-always-quote-attributes:t
 109 sgml-indent-step:1
 110 sgml-indent-data:t
 111 sgml-parent-document:nil
 112 sgml-default-dtd-file:"../reference.ced"
 113 sgml-exposed-tags:nil
 114 sgml-local-catalogs:"/usr/lib/sgml/catalog"
 115 sgml-local-ecat-files:nil
 116 End:
 117 -->