.\\" auto-generated by docbook2man-spec $Revision: 1.25 $
.TH "IPCCLEAN" "1" "2002-11-22" "Application" "PostgreSQL Server Applications"
.SH NAME
ipcclean \- remove shared memory and semaphores from an aborted PostgreSQL server
.SH SYNOPSIS
.sp
\fBipcclean\fR
.SH "DESCRIPTION"
.PP
\fBipcclean\fR 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
PostgreSQL server (\fBpostmaster\fR(1)). Note that immediately restarting the
server will also clean up shared memory and semaphores, so this
command is of little real utility.
.PP
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
\fBpostmaster\fR is running, the shared memory
and semaphores allocated by the
\fBpostmaster\fR will be deleted. This will
result in a general failure of the backend servers started by that
\fBpostmaster\fR.
.SH "NOTES"
.PP
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 \fBpostmaster\fR can now clean up by
itself, it is unlikely that \fBipcclean\fR will be
improved upon in the future.
.PP
The script makes assumption about the format of output of the
\fBipcs\fR
utility which may not be true across different operating systems.
Therefore, it may not work on your particular OS.