.\" This is -*-nroff-*-
.\" XXX standard disclaimer belongs here....
.\" $Header: /usr/local/cvsroot/pgsql/src/man/destroydb.1,v 1.7 1998/01/26 01:42:45 scrappy Exp $
.\" Translated by Mitsuhiro Maeda (mitsu@cni.co.jp)
.TH DESTROYDB UNIX 11/05/95 日本語PostgreSQL 日本語PostgreSQL
.SH 名称
.\" destroydb - destroy an existing database
destroydb - 既存のデータベースを削除します
.SH 形式
.BR destroydb
[\c
.BR "-i"]
[\c
.BR -a
system]
[\c
.BR -h
host]
[\c
.BR -p
port]
[dbname]
.SH 説明
.\" .IR Destroydb
.\" destroys an existing database.
.IR destroydb
は既存のデータベースを削除します。
.\"   To execute this command, the user must
.\" be the database administrator, or DBA, for this database.
このコマンドを実行するには、
そのユーザはデータベース管理者、
あるいはこのデータベースの DBA でなくてはなりません。
.\" The program runs silently; no confirmation message will be displayed.
プログラムは静かに実行します。
つまり、何の確認メッセージも表示されません。
.\" After the database is destroyed, a Unix shell prompt will reappear.
データベースが削除された後には、
Unix のシェルプロンプトが戻ります。
.PP
.\" .IR Destroydb
.\" is a shell script that invokes
.\" .IR psql .
.IR destroydb
は
.IR psql
を呼び出すシェルスクリプトです。
.\" Hence, a
.\" .IR postmaster
.\" process must be running on the database server host before
.\" .IR destroydb 
.\" is executed.
ですから、
.IR createdb 
が実行される前に、
.IR postmaster
プロセスがデータベースサーバのホストで走っていなくてはなりません。
.\"  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).
加えて環境変数
.SM PGOPTION
と
.SM PGREALM
が
.IR psql
に渡され、
.IR psql (1)
で説明されるように処理されます。
.PP
.\" The optional argument
.\" .IR dbname
.\" specifies the name of the database to be destroyed.
オプション引数の
.IR dbname
は削除されるデータベースの名前を指定します。
.\"   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.
.IR dbname
はデフォルトでは環境変数
.SM USER
の値となります。
.PP
.\" .IR Destroydb
.\" understands the following command-line options:
.IR destroydb
は次のコマンドラインオプションを取ることができます:
.TP 5n
.BR "-i"
.\" Prompts before destroying a database (interactive).
データベースを削除する前にプロンプトを出します。(対話的)
.TP
.BR "-a" " system"
.\" Specifies an authentication system
.\" .IR "system"
.\" (see 
.\" .IR pgintro (1))
.\" to use in connecting to the 
.\" .IR postmaster
.\" process.
.IR postmaster
プロセスへの接続に使われる認証システム
.IR "system"
(
.IR pgintro (1)
を見てください)を指定します。
.\"   This option no longer has any effect.
このオプションはもう何の効果もありません。
.TP
.BR "-h" " host"
.\" Specifies the hostname of the machine on which the 
.\" .IR postmaster
.\" is running.  Defaults to using local Unix domain sockets.
.IR postmaster
が走っているマシンのホスト名を指定します。
デフォルトではローカルの Unix ドメインソケットを使用します。
.TP
.BR "-p" " port"
.\" Specifies the TCP/IP port or local Unix domain socket file extension
.\" on which the
.\" .IR postmaster
.\" is listening for connections.
.IR postmaster
が接続を待っているインターネット TCP/IP ポートまたは
ローカルの Unix ドメインソケットファイルの拡張子を指定します。
.\"  Defaults to 5432, or the value of the
.\" .SM PGPORT
.\" environment variable (if set).
デフォルトでは 5432 もしくは、環境変数
.SM PGPORT
の値になります(もしセットされていれば)。
.SH 例
.nf
.\" # destroy the demo database
# demo データベースを削除します
destroydb demo
.fi
.nf
.\" # destroy the demo database using the postmaster on host eden, port 5000.
# ホスト eden のポート 5000 番の postmaster を使って
# demo データベースを削除します
destroydb -p 5000 -h eden demo
.fi
.SH ファイル
.TP 5n
\&$PGDATA/base/\fIdbname\fP
.\" The location of the files corresponding to the database 
.\" .IR dbname .
データベース
.IR dbname
に対応するファイルの場所です。
.SH 参照
destroydb(l),
createdb(1),
initdb(1),
psql(1).
postmaster(1).
.\" .SH DIAGNOSTICS
.SH 診断
.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.
.IR createdb
は指定されたホストとポートで
.IR postmaster 
プロセスと接続することができませんでした。
.\"   If you see this message,
.\" ensure that the
.\" .IR postmaster
.\" is running on the proper host and that you have specified the proper
.\" port.
このメッセージを見たら、
.IR postmaster
が指定した適当なホストとポートで走っているかどうか確認してください。
.\"   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.
あなたは \*(lqpg_user\*(rq リレーションに有効なエントリがありませんので、
Postgres で何もすることができません。
Postgres のサイト管理者に連絡をしてください。
.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.
データベースを削除する権利がありません。
Postgres のサイト管理者に連絡をしてください。
.TP
.BR "database \*(lqdbname\*(rq does not exist"
.\" The database to be removed does not have an entry in the
.\" \*(lqpg_database\*(rq class.
削除するデータベースは\*(lqpg_database\*(rqクラスにエントリがありません。
.TP
.BI "database \*(lq" "dbname" "\*(rq is not owned by you"
.\" You are not DBA for the specified database.
あなたは指定されたデータベースの DBA ではありません。
.TP
.BI "database destroy failed on" " dbname"
.\" An internal error occurred in 
.\" .IR psql
.\" or the backend server.
内部エラーが
.IR psql
またはバックエンドサーバに起こりました。
.\"   Contact your Postgres site administrator to
.\" ensure that ensure that the files and database entries associated with
.\" the database are completely removed.
Postgres のサイト管理者に連絡をして、
そのデータベースに関連するファイルとデータベースのエントリが
完全に削除されたかどうか確認したください。