mirror of
https://git.postgresql.org/git/postgresql.git
synced 2024-10-06 01:57:06 +02:00
135 lines
3.6 KiB
Groff
135 lines
3.6 KiB
Groff
|
.\" This is -*-nroff-*-
|
||
|
.\" XXX standard disclaimer belongs here....
|
||
|
.\" $Header: /cvsroot/pgsql/doc/man/Attic/destroydb.1,v 1.1.1.1 1996/08/18 22:14:23 scrappy Exp $
|
||
|
.TH DESTROYDB UNIX 11/05/95 Postgres95 Postgres95
|
||
|
.SH NAME
|
||
|
destroydb \(em destroy an existing database
|
||
|
.SH SYNOPSIS
|
||
|
.BR destroydb
|
||
|
[\c
|
||
|
.BR -a
|
||
|
system]
|
||
|
[\c
|
||
|
.BR -h
|
||
|
host]
|
||
|
[\c
|
||
|
.BR -p
|
||
|
port]
|
||
|
[dbname]
|
||
|
.SH DESCRIPTION
|
||
|
.IR Destroydb
|
||
|
destroys an existing database. To execute this command, the user must
|
||
|
be the database administrator, or DBA, for this database.
|
||
|
The program runs silently; no confirmation message will be displayed.
|
||
|
After the database is destroyed, a Unix shell prompt will reappear.
|
||
|
.PP
|
||
|
.IR Destroydb
|
||
|
is a shell script that invokes
|
||
|
.IR psql .
|
||
|
Hence, a
|
||
|
.IR postmaster
|
||
|
process must be running on the database server host before
|
||
|
.IR destroydb
|
||
|
is executed. In addition, the
|
||
|
.SM PGOPTION
|
||
|
and
|
||
|
.SM PGREALM
|
||
|
environment
|
||
|
variables will be passed on to
|
||
|
.IR psql
|
||
|
and processed as described in
|
||
|
.IR psql (1).
|
||
|
.PP
|
||
|
The optional argument
|
||
|
.IR dbname
|
||
|
specifies the name of the database to be destroyed. All references to
|
||
|
the database are removed, including the directory containing this
|
||
|
database and its associated files.
|
||
|
.IR Dbname
|
||
|
defaults to the value of the
|
||
|
.SM USER
|
||
|
environment variable.
|
||
|
.PP
|
||
|
.IR Destroydb
|
||
|
understands the following command-line options:
|
||
|
.TP 5n
|
||
|
.BR "-a" " system"
|
||
|
Specifies an authentication system
|
||
|
.IR "system"
|
||
|
(see
|
||
|
.IR introduction (1))
|
||
|
to use in connecting to the
|
||
|
.IR postmaster
|
||
|
process. The default is site-specific.
|
||
|
.TP
|
||
|
.BR "-h" " host"
|
||
|
Specifies the hostname of the machine on which the
|
||
|
.IR postmaster
|
||
|
is running. Defaults to the name of the local host, or the value of
|
||
|
the
|
||
|
.SM PGHOST
|
||
|
environment variable (if set).
|
||
|
.TP
|
||
|
.BR "-p" " port"
|
||
|
Specifies the Internet TCP port on which the
|
||
|
.IR postmaster
|
||
|
is listening for connections. Defaults to 5432, or the value of the
|
||
|
.SM PGPORT
|
||
|
environment variable (if set).
|
||
|
.SH EXAMPLES
|
||
|
.nf
|
||
|
# destroy the demo database
|
||
|
destroydb demo
|
||
|
.fi
|
||
|
.nf
|
||
|
# destroy 5432 demo database using the postmaster on host eden,
|
||
|
# port using the Kerberos authentication system.
|
||
|
destroydb -a kerberos -p 5432 -h eden demo
|
||
|
.fi
|
||
|
.SH FILES
|
||
|
.TP 5n
|
||
|
\&$PGDATA/base/\fIdbname\fP
|
||
|
The location of the files corresponding to the database
|
||
|
.IR dbname .
|
||
|
.SH "SEE ALSO"
|
||
|
destroydb(l),
|
||
|
createdb(1),
|
||
|
initdb(1),
|
||
|
psql(1).
|
||
|
postmaster(1).
|
||
|
.SH DIAGNOSTICS
|
||
|
.TP 5n
|
||
|
.BI "Error: Failed to connect to backend (host=" "xxx" ", port=" "xxx" ")"
|
||
|
.IR Destroydb
|
||
|
could not attach to the
|
||
|
.IR postmaster
|
||
|
process on the specified host and port. If you see this message,
|
||
|
ensure that the
|
||
|
.IR postmaster
|
||
|
is running on the proper host and that you have specified the proper
|
||
|
port. If your site uses an authentication system, ensure that you
|
||
|
have obtained the required authentication credentials.
|
||
|
.TP
|
||
|
.BI "user \*(lq" "username" "\*(rq is not in \*(lqpg_user\*(rq"
|
||
|
You do not have a valid entry in the relation \*(lqpg_user\*(rq and
|
||
|
cannot do anything with Postgres at all; contact your Postgres site
|
||
|
administrator.
|
||
|
.TP
|
||
|
.BI "user \*(lq" "username" "\*(rq is not allowed to create/destroy databases"
|
||
|
You do not have permission to destroy databases; contact your Postgres
|
||
|
site administrator.
|
||
|
.TP
|
||
|
.BR "database \*(lqdbname\*(rq does not exist"
|
||
|
The database to be removed does not have an entry in the
|
||
|
\*(lqpg_database\*(rq class.
|
||
|
.TP
|
||
|
.BI "database \*(lq" "dbname" "\*(rq is not owned by you"
|
||
|
You are not DBA for the specified database.
|
||
|
.TP
|
||
|
.BI "database destroy failed on" " dbname"
|
||
|
An internal error occurred in
|
||
|
.IR psql
|
||
|
or the backend server. Contact your Postgres site administrator to
|
||
|
ensure that ensure that the files and database entries associated with
|
||
|
the database are completely removed.
|