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