mirror of https://github.com/postgres/postgres
Windows. Users should use their operating system tools instead.REL8_5_ALPHA1_BRANCH
Bruce Momjian
18 years ago
parent
fe11719c2e
commit
39627b1ae6
@ -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> |
||||
@ -1,32 +0,0 @@ |
||||
#-------------------------------------------------------------------------
|
||||
#
|
||||
# Makefile for src/bin/ipcclean
|
||||
#
|
||||
# Portions Copyright (c) 1996-2008, PostgreSQL Global Development Group
|
||||
# Portions Copyright (c) 1994, Regents of the University of California
|
||||
#
|
||||
# $PostgreSQL: pgsql/src/bin/ipcclean/Makefile,v 1.22 2008/01/01 19:45:55 momjian Exp $
|
||||
#
|
||||
#-------------------------------------------------------------------------
|
||||
|
||||
subdir = src/bin/ipcclean
|
||||
top_builddir = ../../..
|
||||
include $(top_builddir)/src/Makefile.global |
||||
|
||||
all: ipcclean |
||||
|
||||
ipcclean: ipcclean.sh |
||||
cp $< $@
|
||||
chmod a+x $@
|
||||
|
||||
install: all installdirs |
||||
$(INSTALL_SCRIPT) ipcclean '$(DESTDIR)$(bindir)/ipcclean'
|
||||
|
||||
installdirs: |
||||
$(mkinstalldirs) '$(DESTDIR)$(bindir)'
|
||||
|
||||
uninstall: |
||||
rm -f '$(DESTDIR)$(bindir)/ipcclean'
|
||||
|
||||
clean distclean maintainer-clean: |
||||
rm -f ipcclean
|
||||
@ -1,116 +0,0 @@ |
||||
#!/bin/sh |
||||
# |
||||
# $PostgreSQL: pgsql/src/bin/ipcclean/ipcclean.sh,v 1.18 2006/03/03 21:52:37 momjian Exp $ |
||||
# |
||||
|
||||
CMDNAME=`basename $0` |
||||
|
||||
if [ "$1" = '-?' -o "$1" = "--help" ]; then |
||||
echo "$CMDNAME cleans up shared memory and semaphores from aborted PostgreSQL" |
||||
echo "backends." |
||||
echo |
||||
echo "Usage:" |
||||
echo " $CMDNAME" |
||||
echo |
||||
echo "Note: Since the utilities underlying this script are very different" |
||||
echo "from platform to platform, chances are that it might not work on" |
||||
echo "yours. If that is the case, please write to <pgsql-bugs@postgresql.org>" |
||||
echo "so that your platform can be supported in the future." |
||||
exit 0 |
||||
fi |
||||
|
||||
# test for running as root |
||||
|
||||
ISROOT="N" |
||||
if id -u >/dev/null 2>&1 |
||||
then if [ `id -u` -eq 0 ] |
||||
then ISROOT="Y" |
||||
fi |
||||
elif # only check $LOGNAME if $USER is not set |
||||
[ "$USER" = 'root' -o \( ! "$USER" -a "$LOGNAME" = 'root' \) ] |
||||
then ISROOT="Y" |
||||
fi |
||||
|
||||
if [ "$ISROOT" = "Y" ] |
||||
then |
||||
( |
||||
echo "$CMDNAME: cannot be run as root" 1>&2 |
||||
echo "Please log in (using, e.g., \"su\") as the (unprivileged) user that" 1>&2 |
||||
echo "owned the server process." 1>&2 |
||||
) 1>&2 |
||||
exit 1 |
||||
fi |
||||
|
||||
EffectiveUser=`id -n -u 2>/dev/null || whoami 2>/dev/null` |
||||
|
||||
#----------------------------------- |
||||
# List of platform-specific hacks |
||||
# Feel free to add yours here. |
||||
#----------------------------------- |
||||
# |
||||
# This is based on RedHat 5.2. |
||||
# |
||||
if [ `uname` = 'Linux' ]; then |
||||
did_anything= |
||||
|
||||
if ps x | grep -s '[p]ostmaster' >/dev/null 2>&1 ; then |
||||
echo "$CMDNAME: a postmaster is still running" 1>&2 |
||||
exit 1 |
||||
fi |
||||
|
||||
# shared memory |
||||
for val in `ipcs -m -p | grep '^[0-9]' | awk '{printf "%s:%s:%s\n", $1, $3, $4}'` |
||||
do |
||||
save_IFS=$IFS |
||||
IFS=: |
||||
set X $val |
||||
shift |
||||
IFS=$save_IFS |
||||
ipcs_shmid=$1 |
||||
ipcs_cpid=$2 |
||||
ipcs_lpid=$3 |
||||
|
||||
# Note: We can do -n here, because we know the platform. |
||||
echo -n "Shared memory $ipcs_shmid ... " |
||||
|
||||
# Don't do anything if process still running. |
||||
# (This check is conceptually phony, but it's |
||||
# useful anyway in practice.) |
||||
ps hj $ipcs_cpid $ipcs_lpid >/dev/null 2>&1 |
||||
if [ "$?" -eq 0 ]; then |
||||
echo "skipped; process still exists (pid $ipcs_cpid or $ipcs_lpid)." |
||||
continue |
||||
fi |
||||
|
||||
# try remove |
||||
ipcrm shm $ipcs_shmid |
||||
if [ "$?" -eq 0 ]; then |
||||
did_anything=t |
||||
else |
||||
exit |
||||
fi |
||||
done |
||||
|
||||
# semaphores |
||||
for val in `ipcs -s -c | grep '^[0-9]' | awk '{printf "%s\n", $1}'`; do |
||||
echo -n "Semaphore $val ... " |
||||
# try remove |
||||
ipcrm sem $val |
||||
if [ "$?" -eq 0 ]; then |
||||
did_anything=t |
||||
else |
||||
exit |
||||
fi |
||||
done |
||||
|
||||
[ -z "$did_anything" ] && echo "$CMDNAME: nothing removed" && exit 1 |
||||
exit 0 |
||||
fi # end Linux |
||||
|
||||
|
||||
# This is the original implementation. It seems to work |
||||
# on FreeBSD, SunOS/Solaris, HP-UX, IRIX, and probably |
||||
# some others. |
||||
|
||||
ipcs | egrep '^m .*|^s .*' | egrep "$EffectiveUser" | \ |
||||
awk '{printf "ipcrm -%s %s\n", $1, $2}' '-' | sh |
||||
Loading…
Reference in new issue