.\" XXX standard disclaimer belongs here....
.\" $Header: /private/postgres/ref/unix/RCS/createuser,v 1.7 1992/07/14 05:54:17 ptong Exp $
.SP CREATEUSER UNIX 6/14/90
.XA 1 Createuser
.uh NAME
.lp
createuser \*- create a \*(PP user
.uh SYNOPSIS
.lp
.(l
\fBcreateuser\fR [\fB-p\fR port] [\fB-h\fR host] username
.)l
.uh DESCRIPTION
.lp
.b Createuser
creates a new \*(PP user.
Only users with ``usesuper'' set in the pg_user class can create
new \*(PP users.  As shipped, the user ``postgres'' can create users.
.sp
.i Username
is the name of the \*(PP user to be created.
The name must be unique
among all \*(PP users.
.sp
The arguments 
.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).
.uh "INTERACTIVE QUESTIONS"
.lp
Once invoked with the above options
.b createuser
will guide the person adding the new \*(PP user through a series of questions.
These questions describe the security capabilities of the \*(PP user.
The new user's \*(PP userid must be the user's Unix userid.
.uh "SEE ALSO"
.lp
destroyuser(unix).
.uh DIAGNOSTICS
.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<user>\fR \fBalready exists\fR
.lp
The user already exists.
.uh BUGS
.lp
\*(PP userid's and usernames should not have anything to do with the
constraints of UNIX.
