Skip to content
Snippets Groups Projects
  • Thomas G. Lockhart's avatar
    c05f29e8
    Augment the date/time examples in the User's Guide to reflect the newer · c05f29e8
    Thomas G. Lockhart authored
     capabilities of specifying time zones as intervals per SQL9x.
    Put refentrytitle contents on the same line as the tag.
     Otherwise, leading whitespace is propagated into the product, which
     (at least) messes up the ToC layout.
    Remove (some) docinfo tags containing dates. Best to omit if the dates
     are not accurate; maybe use CVS dates instead or leave them out.
    c05f29e8
    History
    Augment the date/time examples in the User's Guide to reflect the newer
    Thomas G. Lockhart authored
     capabilities of specifying time zones as intervals per SQL9x.
    Put refentrytitle contents on the same line as the tag.
     Otherwise, leading whitespace is propagated into the product, which
     (at least) messes up the ToC layout.
    Remove (some) docinfo tags containing dates. Best to omit if the dates
     are not accurate; maybe use CVS dates instead or leave them out.
ipcclean.sgml 2.58 KiB
<!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/Attic/ipcclean.sgml,v 1.7 2002/04/21 19:02:39 thomas 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 an aborted <productname>PostgreSQL</productname> server</refpurpose>
 </refnamediv>

 <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-postmaster">).  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
   <application>postmaster</application> is running, the shared memory
   and semaphores allocated by the
   <application>postmaster</application> will be deleted.  This will
   result in a general failure of the backend servers started by that
   <application>postmaster</application>.
  </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 the <application>postmaster</application> 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 assumption about the format of output of the
   <application>ipcs</application>
   utility which may not be true across different operating systems.
   Therefore, it may not work on your particular OS.
  </para>
 </refsect1>

</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:nil
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../reference.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:"/usr/lib/sgml/catalog"
sgml-local-ecat-files:nil
End:
-->