diff options
author | Thomas G. Lockhart | 1999-08-08 15:21:50 +0000 |
---|---|---|
committer | Thomas G. Lockhart | 1999-08-08 15:21:50 +0000 |
commit | a76ad509fef621719abb95fedb526e9a0092a312 (patch) | |
tree | 1a5295dbdce9296f23f252898aea402f411e7d23 /src/man/createuser.1 | |
parent | d0a1919852b8c98f43f2795c23690024707fc1e5 (diff) |
Remove old man pages. All info is in new man pages or other docs.
Diffstat (limited to 'src/man/createuser.1')
-rw-r--r-- | src/man/createuser.1 | 151 |
1 files changed, 0 insertions, 151 deletions
diff --git a/src/man/createuser.1 b/src/man/createuser.1 deleted file mode 100644 index 4e24a796c52..00000000000 --- a/src/man/createuser.1 +++ /dev/null @@ -1,151 +0,0 @@ -.\" This is -*-nroff-*- -.\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/createuser.1,v 1.13 1998/10/14 02:54:31 momjian Exp $ -.TH CREATEUSER UNIX 11/05/95 PostgreSQL PostgreSQL -.SH NAME -createuser - create a Postgres user -.SH SYNOPSIS -.BR createuser -[\c -.BR -a -system] -[\c -.BR -d -] -[\c -.BR -D -] -[\c -.BR -h -host] -[\c -.BR -i -id] -[\c -.BR -p -port] -[\c -.BR -u -] -[\c -.BR -U -] -[username] -.SH DESCRIPTION -.IR Createuser -creates a new Postgres user. Only users with \*(lqusesuper\*(rq set in -the \*(lqpg_shadow\*(rq class can create new Postgres users. As shipped, -the user \*(lqpostgres\*(rq can create users. -.PP -.IR Createuser -is a shell script that invokes -.IR psql . -Hence, a -.IR postmaster -process must be running on the database server host before -.IR createuser -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 username -specifies the name of the Postgres user to be created. (The invoker will -be prompted for a name if none is specified on the command line.) -This name must be unique among all Postgres users. -.PP -.IR Createuser -understands the following command-line options: -.TP 5n -.BR "-a" " system" -Specifies an authentication system -.IR "system" -to use in connecting to the -.IR postmaster -process. This option no longer has any effect. -.TP -.BR "-d" -Allows the user to create databases. -.TP -.BR "-D" -Does not allow the user to create databases. -.TP -.BR "-h" " host" -Specifies the hostname of the machine on which the -.IR postmaster -is running. Defaults to using local Unix domain sockets. -.TP -.BR "-i" " id" -Use -.IR id -as the user id. -.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. Defaults to 5432, or the value of the -.SM PGPORT -environment variable (if set). -.TP -.BR "-u" -Allows the user to create other users. -.TP -.BR "-U" -Does not allow the user to create other users. -.SH "INTERACTIVE QUESTIONS" -Once invoked with the above options, -.IR createuser -will ask a series of questions. The new users's login name (if not -given on the command line) and user-id must be specified. (Note that -the Postgres user-id must be the same as the user's Unix user-id.) In -addition, you must describe the security capabilities of the new user. -Specifically, you will be asked whether the new user should be able to -act as Postgres super-user, create new databases and update the system -catalogs manually. -.SH "SEE ALSO" -create_user(l), -destroyuser(1), -psql(1), -postmaster(1). -.SH DIAGNOSTICS -.TP 5n -.BI "Error: Failed to connect to backend (host=" "xxx" ", port=" "xxx" ")" -.IR Createuser -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_shadow\*(rq" -You do not have a valid entry in the relation \*(lqpg_shadow\*(rq and -cannot do anything with Postgres at all; contact your Postgres site -administrator. -.TP -.IB "username" " cannot create users." -You do not have permission to create new users; contact your Postgres -site administrator. -.TP -.BI "user \*(lq" "username" "\*(rq already exists" -The user to be added already has an entry in the \*(lqpg_shadow\*(rq -class. -.TP -.BR "database access failed" -An internal error occurred in -.IR psql -or the backend server. Ensure that your Postgres site administrator has -properly installed Postgres and initialized the site with -.IR initdb . -.SH NOTE -The command internally runs \fIcreate user\fP from \fIpsql\fP -connected to the \fItemplate1\fP database to perform the operation. |