head	1.9;
access;
symbols;
locks; strict;
comment	@# @;


1.9
date	92.07.14.05.54.17;	author ptong;	state Exp;
branches;
next	1.8;

1.8
date	92.07.13.03.45.59;	author ptong;	state Exp;
branches;
next	1.7;

1.7
date	92.06.17.22.05.36;	author mer;	state Exp;
branches;
next	1.6;

1.6
date	91.08.16.02.38.01;	author kemnitz;	state Exp;
branches;
next	1.5;

1.5
date	91.08.16.02.20.46;	author kemnitz;	state Exp;
branches;
next	1.4;

1.4
date	91.08.11.19.06.42;	author mao;	state Exp;
branches;
next	1.3;

1.3
date	90.08.10.13.04.01;	author cimarron;	state Exp;
branches;
next	1.2;

1.2
date	90.07.19.15.44.02;	author claire;	state Exp;
branches;
next	1.1;

1.1
date	90.07.18.16.23.28;	author mao;	state Exp;
branches;
next	;


desc
@man page for shell-level 'destroydb' command
@


1.9
log
@reformated
@
text
@.\" XXX standard disclaimer belongs here....
.\" $Header: /home/postgres/mer/refs/unix/RCS/destroydb,v 1.8 1992/07/13 03:45:59 ptong Exp ptong $
.SP DESTROYDB UNIX 6/14/90
.XA 1 Destroydb
.uh NAME
.lp
destroydb \*- destroy an existing database
.uh SYNOPSIS
.lp
.(l
\fBdestroydb\fR [\fB-p\fR port] [\fB-h\fR host] username
.)l
.uh DESCRIPTION
.lp
.b Destroydb
removes all reference to an existing database named
.i dbname.
The directory containing this database and all associated files
are removed.
.lp
To execute this command, the user must be the
.A DBA
for this database.
After the database is destroyed, a \*(UU shell prompt will reappear;
no confirmation message will be displayed.
.lp
.b Destroydb
needs to connect to a running postmaster to accomplish
its tasks.  If no postmaster is running then one must be started
before destroydb is run.
.lp
.uh "COMMAND OPTIONS"
.lp
\fI-p port\fR indicates that destroydb should attempt to connect to a
postmaster listening to the specified port.
.lp
\fI-h hostname\fR indicates that destroydb should attempt to connect to a
postmaster running on the specified host machine.
.sp
.uh EXAMPLE
.lp
.ft C
/* destroy the demo database */
.ft
.nf
.ft C
destroydb demo
.ft
.fi
.lp
.ft C
/* destroy the demo database using the postmaster on host eden, port 1234 */
.ft
.nf
.ft C
destroydb -p 1234 -h eden demo
.ft
.fi
.uh DIAGNOSTICS
.sp
.lp
\fBError: Failed to connect to backend (host=\fIxxx\fB, port=\fIxxx\fB)\fR
.lp
destroydb could not attach to the postmaster on the specified host and
port.  If you see this message, check that the postmaster is running on
the proper host and that the proper port is specified.
.sp
.uh FILES
.lp
.ft C
\&.../data/base/*
.ft
.uh "SEE ALSO"
.lp
createdb(unix),
postmaster(unix),
destroydb(commands).
@


1.8
log
@Fixed up formating
@
text
@d2 1
a2 1
.\" $Header: /home/postgres/mer/refs/unix/RCS/destroydb,v 1.7 1992/06/17 22:05:36 mer Exp ptong $
d42 1
d44 1
d46 1
d48 1
d51 1
d53 1
d55 1
d57 1
d70 1
d72 1
d77 1
a77 1
destroydb(postquel).
@


1.7
log
@fix options
@
text
@d2 1
a2 1
.\" $Header: /home/postgres/mer/refs/unix/RCS/destroydb,v 1.6 1991/08/16 02:38:01 kemnitz Exp mer $
d10 3
a12 3
.b destroydb
[-p port][-h host]
dbname
@


1.6
log
@got rid of spurious paragraph
@
text
@d2 1
a2 1
.\" $Header: unix/RCS/destroydb,v 1.5 91/08/16 02:20:46 kemnitz Exp Locker: kemnitz $
d11 1
a11 1
[-p port] [-h hostname]
@


1.5
log
@*** empty log message ***
@
text
@d2 1
a2 1
.\" $Header: RCS/destroydb,v 1.4 91/08/11 19:06:42 mao Exp Locker: kemnitz $
d55 1
a55 1
.pp
@


1.4
log
@update for 3.0
@
text
@d2 1
a2 1
.\" $Header: /local/mao/postgres/ref/unix/RCS/destroydb,v 1.3 1990/08/10 13:04:01 cimarron Exp mao $
d17 2
a18 4
.i dbname
and turns off the vacuum demon if running on this database.
Normally, the directory containing this database
and all associated files
a19 5
But when the database is placed elsewhere via the
use of a
.q "reference file,"
only the files contained in the referenced directory
will be removed.
a31 5
As of release 3.0 of POSTGRES,
this is a shell script that executes the Postquel query
.i destroydb
from inside the template database.
See the Postquel reference manual for details.
@


1.3
log
@added documentation on -p and -h options.
@
text
@d2 1
a2 1
.\" $Header: RCS/destroydb,v 1.2 90/07/19 15:44:02 claire Exp Locker: cimarron $
d34 2
a35 1
destroydb needs to connect to a running postmaster to accomplish
d38 6
d77 3
a79 1
createdb(unix), postmaster(unix).
@


1.2
log
@*** empty log message ***
@
text
@d2 1
a2 1
.\" $Header: RCS/destroydb,v 1.1 90/07/18 16:23:28 mao Exp Locker: claire $
d11 1
d33 12
d51 14
d70 1
a70 1
createdb(unix).
@


1.1
log
@Initial revision
@
text
@d2 1
a2 1
.\" $Header: destroydb,v 1.4 89/02/25 16:08:08 wensel Exp $
@