.\" XXX standard disclaimer belongs here....
.\" $Header: /private/postgres/ref/unix/RCS/createdb,v 1.15 1992/07/14 05:54:17 ptong Exp $
.SP CREATEDB UNIX 6/14/90
.XA 1 Createdb
.uh NAME
.lp
createdb \*- create a database
.uh SYNOPSIS
.lp
.(l
\fBcreatedb\fR [\fB-p\fR port] [\fB-h\fR host] username
.)l
.uh DESCRIPTION
.lp
.b Createdb
creates a new database.
The person who executes this command
becomes the database administrator
.r ( \c
.A DBA )
for this database.
The
.A DBA
has special powers
not granted to ordinary users. Namely, they can destroy
the database they created.
.lp
.i Dbname
is the name of the database
to be created.
The name must be unique
among all \*(PP databases.
.lp
The argument 
.i port
and
.i hostname
are the same as in the terminal monitor - they are used to connect to the
postmaster using the TCP/IP port
.i port
running on the database server
.i hostname.
The defaults are to the local machine (localhost) and to the default port
(4321).
.lp
.uh "SEE ALSO"
.lp
destroydb(unix), initdb(unix), createdb(commands).
.uh DIAGNOSTICS
.sp
.lp
\fBError: Failed to connect to backend (host=\fIxxx\fB, port=\fIxxx\fB)\fR
.lp
createdb 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
.lp
\fBYou are not a valid POSTGRES user\fR
.lp
You do not have a users file entry, and can
not do anything with \*(PP at all.
.sp
.lp
\fI<dbname>\fR \fBalready exists\fR
.lp
The database already exists.
