summaryrefslogtreecommitdiff
path: root/src/man
diff options
context:
space:
mode:
Diffstat (limited to 'src/man')
-rw-r--r--src/man/createdb.110
-rw-r--r--src/man/createuser.14
-rw-r--r--src/man/destroydb.19
-rw-r--r--src/man/destroyuser.14
-rw-r--r--src/man/libpq.38
-rw-r--r--src/man/pg_passwd.16
-rw-r--r--src/man/pgintro.123
-rw-r--r--src/man/postgres.19
-rw-r--r--src/man/postmaster.14
-rw-r--r--src/man/psql.110
10 files changed, 43 insertions, 44 deletions
diff --git a/src/man/createdb.1 b/src/man/createdb.1
index 07fc66a852..eece687004 100644
--- a/src/man/createdb.1
+++ b/src/man/createdb.1
@@ -1,6 +1,6 @@
.\" This is -*-nroff-*-
.\" XXX standard disclaimer belongs here....
-.\" $Header: /cvsroot/pgsql/src/man/Attic/createdb.1,v 1.6 1998/01/11 22:17:23 momjian Exp $
+.\" $Header: /cvsroot/pgsql/src/man/Attic/createdb.1,v 1.7 1998/01/26 01:42:42 scrappy Exp $
.TH CREATEDB UNIX 11/05/95 PostgreSQL PostgreSQL
.SH NAME
createdb - create a database
@@ -60,7 +60,7 @@ Specifies an authentication system
.IR pgintro (1))
to use in connecting to the
.IR postmaster
-process. The default is site-specific.
+process. This option no longer has any effect.
.TP
.BR "-D" " dbpath"
Specifies the alternate database location for this database.
@@ -79,13 +79,13 @@ is listening for connections. Defaults to 5432, or the value of the
environment variable (if set).
.SH EXAMPLES
.nf
-# create 5432 demo database
+# create the demo database using the postmaster on the local host, port 5432.
createdb demo
.fi
.nf
# create the demo database using the postmaster on host eden,
-# port using the Kerberos authentication system.
-createdb -a kerberos -p 5432 -h eden demo
+# port 5000.
+createdb -p 5000 -h eden demo
.fi
.SH FILES
.TP 5n
diff --git a/src/man/createuser.1 b/src/man/createuser.1
index 2453f0cb0e..30a4cbac62 100644
--- a/src/man/createuser.1
+++ b/src/man/createuser.1
@@ -1,6 +1,6 @@
.\" This is -*-nroff-*-
.\" XXX standard disclaimer belongs here....
-.\" $Header: /cvsroot/pgsql/src/man/Attic/createuser.1,v 1.5 1998/01/11 22:17:23 momjian Exp $
+.\" $Header: /cvsroot/pgsql/src/man/Attic/createuser.1,v 1.6 1998/01/26 01:42:44 scrappy Exp $
.TH CREATEUSER UNIX 11/05/95 PostgreSQL PostgreSQL
.SH NAME
createuser - create a Postgres user
@@ -55,7 +55,7 @@ Specifies an authentication system
.IR pgintro (1))
to use in connecting to the
.IR postmaster
-process. The default is site-specific.
+process. This option no longer has any effect.
.TP
.BR "-h" " host"
Specifies the hostname of the machine on which the
diff --git a/src/man/destroydb.1 b/src/man/destroydb.1
index a3c9ea3358..b451df6c51 100644
--- a/src/man/destroydb.1
+++ b/src/man/destroydb.1
@@ -1,6 +1,6 @@
.\" This is -*-nroff-*-
.\" XXX standard disclaimer belongs here....
-.\" $Header: /cvsroot/pgsql/src/man/Attic/destroydb.1,v 1.6 1998/01/11 22:17:25 momjian Exp $
+.\" $Header: /cvsroot/pgsql/src/man/Attic/destroydb.1,v 1.7 1998/01/26 01:42:45 scrappy Exp $
.TH DESTROYDB UNIX 11/05/95 PostgreSQL PostgreSQL
.SH NAME
destroydb - destroy an existing database
@@ -65,7 +65,7 @@ Specifies an authentication system
.IR pgintro (1))
to use in connecting to the
.IR postmaster
-process. The default is site-specific.
+process. This option no longer has any effect.
.TP
.BR "-h" " host"
Specifies the hostname of the machine on which the
@@ -85,9 +85,8 @@ environment variable (if set).
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
+# destroy the demo database using the postmaster on host eden, port 5000.
+destroydb -p 5000 -h eden demo
.fi
.SH FILES
.TP 5n
diff --git a/src/man/destroyuser.1 b/src/man/destroyuser.1
index 454cc77f09..a1a04baf44 100644
--- a/src/man/destroyuser.1
+++ b/src/man/destroyuser.1
@@ -1,6 +1,6 @@
.\" This is -*-nroff-*-
.\" XXX standard disclaimer belongs here....
-.\" $Header: /cvsroot/pgsql/src/man/Attic/destroyuser.1,v 1.5 1998/01/11 22:17:25 momjian Exp $
+.\" $Header: /cvsroot/pgsql/src/man/Attic/destroyuser.1,v 1.6 1998/01/26 01:42:46 scrappy Exp $
.TH DESTROYUSER UNIX 11/05/95 PostgreSQL PostgreSQL
.SH NAME
destroyuser - destroy a Postgres user and associated databases
@@ -55,7 +55,7 @@ Specifies an authentication system
.IR pgintro (1))
to use in connecting to the
.IR postmaster
-process. The default is site-specific.
+process. This option no longer has any effect.
.TP
.BR "-h" " host"
Specifies the hostname of the machine on which the
diff --git a/src/man/libpq.3 b/src/man/libpq.3
index 7adcd3c3de..10006001eb 100644
--- a/src/man/libpq.3
+++ b/src/man/libpq.3
@@ -1,6 +1,6 @@
.\" This is -*-nroff-*-
.\" XXX standard disclaimer belongs here....
-.\" $Header: /cvsroot/pgsql/src/man/Attic/libpq.3,v 1.11 1997/12/04 20:26:31 momjian Exp $
+.\" $Header: /cvsroot/pgsql/src/man/Attic/libpq.3,v 1.12 1998/01/26 01:42:47 scrappy Exp $
.TH LIBPQ INTRO 03/12/94 PostgreSQL PostgreSQL
.SH DESCRIPTION
Libpq is the programmer's interface to Postgres. Libpq is a set of
@@ -591,9 +591,9 @@ If the user has generated the appropriate authentication credentials
.I Kerberos
tickets), the frontend/backend authentication process is handled by
.I PQexec
-without any further intervention. The following routines may be
-called by Libpq programs to tailor the behavior of the authentication
-process.
+without any further intervention. The authentication method is now
+determined entirely by the DBA (see pga_hba.conf(5)). The following
+routines no longer have any effect and should not be used.
.PP
.B fe_getauthname
.IP
diff --git a/src/man/pg_passwd.1 b/src/man/pg_passwd.1
index 00caaf4d7a..69f2b95404 100644
--- a/src/man/pg_passwd.1
+++ b/src/man/pg_passwd.1
@@ -1,6 +1,6 @@
.\" This is -*-nroff-*-
.\" XXX standard disclaimer belongs here....
-.\" $Header: /cvsroot/pgsql/src/man/Attic/pg_passwd.1,v 1.2 1998/01/11 22:17:48 momjian Exp $
+.\" $Header: /cvsroot/pgsql/src/man/Attic/pg_passwd.1,v 1.3 1998/01/26 01:42:49 scrappy Exp $
.TH PG_PASSWD UNIX 11/05/95 PostgreSQL PostgreSQL
.SH NAME
pg_passwd - manipulate the flat password file
@@ -80,7 +80,7 @@ The following lines show the sample usage of the option:
uses the new style of the Pg.pm like this:
.nf
- $conn = Pg::connectdb("host=hyalos authtype=password dbname=unv
+ $conn = Pg::connectdb("host=hyalos dbname=unv
user=pg_guest password=xxxxxxx");
.fi
@@ -96,7 +96,7 @@ option thus:
.nf
% set conn [pg_connect -conninfo \\
- "host=hyalos authtype=password dbname=unv \\
+ "host=hyalos dbname=unv \\
user=pg_guest password=xxxxxxx "]
.fi
diff --git a/src/man/pgintro.1 b/src/man/pgintro.1
index 3a8becaf24..8801b6ed22 100644
--- a/src/man/pgintro.1
+++ b/src/man/pgintro.1
@@ -1,6 +1,6 @@
.\" This is -*-nroff-*-
.\" XXX standard disclaimer belongs here....
-.\" $Header: /cvsroot/pgsql/src/man/Attic/pgintro.1,v 1.2 1998/01/11 22:17:50 momjian Exp $
+.\" $Header: /cvsroot/pgsql/src/man/Attic/pgintro.1,v 1.3 1998/01/26 01:42:50 scrappy Exp $
.TH PGINTRO UNIX 11/05/95 PostgreSQL PostgreSQL
.SP INFORMATION UNIX 11/05/95
.BH "SECTION 2 - Unix COMMANDS (Unix)"
@@ -105,26 +105,15 @@ conducted.
If the Postgres system is built as distributed, access to the Internet
TCP port of the
.IR postmaster
-process is available to anyone. However, Postgres offers optional
-host-based authentication where only access from certain hosts are
-allowed. Of course, host-based authentication is not fool-proof in
+process is available to anyone. The DBA configures the pg_hba.conf file
+in the PGDATA directory to specify what authentication system is to be used
+according to the host making the connection and which database it is
+connecting to. See pg_hba.conf(5) for a description of the authentication
+systems available. Of course, host-based authentication is not fool-proof in
Unix, either. It is possible for determined intruders to also
masquerade the origination host. Those security issues are beyond the
scope of Postgres.
.PP
-If greater security is desired, Postgres and its clients may be
-modified to use a network authentication system. For example, the
-.IR postmaster ,
-.IR psql
-and the
-.IR libpq
-library have already been configured to use either Version 4 or Version 5 of
-the
-.IR Kerberos
-authentication system from the Massachusetts Institute of Technology.
-For more information on using
-.IR Kerberos
-with Postgres, see the appendix below.
.SH "ACCESS CONTROL"
Postgres provides mechanisms to allow users to limit the access to
their data that is provided to other users.
diff --git a/src/man/postgres.1 b/src/man/postgres.1
index 5a0fdb3210..24d1bf4c46 100644
--- a/src/man/postgres.1
+++ b/src/man/postgres.1
@@ -1,6 +1,6 @@
.\" This is -*-nroff-*-
.\" XXX standard disclaimer belongs here....
-.\" $Header: /cvsroot/pgsql/src/man/Attic/postgres.1,v 1.9 1998/01/11 22:17:51 momjian Exp $
+.\" $Header: /cvsroot/pgsql/src/man/Attic/postgres.1,v 1.10 1998/01/26 01:42:51 scrappy Exp $
.TH POSTGRESQL UNIX 12/08/96 PostgreSQL PostgreSQL
.SH NAME
postgres - the Postgres backend server
@@ -31,6 +31,9 @@ filedes]
[\c
.BR "-e"
]
+[\c
+.BR "-v protocol"
+]
.br
[\c
.BR "-d"
@@ -145,6 +148,10 @@ but debugging output is sent to the controlling tty of the
Print time information and other statistics at the end of each query.
This is useful for benchmarking or for use in tuning the number of
buffers.
+.TP
+.BR "-v" " protocol"
+Specifies the number of the frontend/backend protocol to be used for this
+particular session.
.SH "DEPRECATED COMMAND OPTIONS"
There are several other options that may be specified, used mainly
for debugging purposes. These are listed here only for the use by
diff --git a/src/man/postmaster.1 b/src/man/postmaster.1
index 36cb9bb04d..d11b9eeb73 100644
--- a/src/man/postmaster.1
+++ b/src/man/postmaster.1
@@ -1,6 +1,6 @@
.\" This is -*-nroff-*-
.\" XXX standard disclaimer belongs here....
-.\" $Header: /cvsroot/pgsql/src/man/Attic/postmaster.1,v 1.10 1998/01/11 22:17:53 momjian Exp $
+.\" $Header: /cvsroot/pgsql/src/man/Attic/postmaster.1,v 1.11 1998/01/26 01:42:52 scrappy Exp $
.TH POSTMASTER UNIX 11/05/95 PostgreSQL PostgreSQL
.SH "NAME"
postmaster - run the Postgres postmaster
@@ -105,7 +105,7 @@ authentication, use
to deny any unauthenticated
connections, use
.BR "-a nounauth .
-The default is site-specific.
+This option no longer has any effect.
.TP
.BR "-b" " backend_pathname"
.IR "backend_pathname"
diff --git a/src/man/psql.1 b/src/man/psql.1
index c867ab5777..2c5137b4c0 100644
--- a/src/man/psql.1
+++ b/src/man/psql.1
@@ -1,6 +1,6 @@
.\" This is -*-nroff-*-
.\" XXX standard disclaimer belongs here....
-.\" $Header: /cvsroot/pgsql/src/man/Attic/psql.1,v 1.22 1998/01/25 06:12:52 scrappy Exp $
+.\" $Header: /cvsroot/pgsql/src/man/Attic/psql.1,v 1.23 1998/01/26 01:42:53 scrappy Exp $
.TH PSQL UNIX 1/20/96 PostgreSQL PostgreSQL
.SH NAME
psql - run the interactive query front-end
@@ -125,7 +125,7 @@ Specifies an authentication system
.IR pgintro (1))
to use in connecting to the
.IR postmaster
-process. The default is site-specific.
+process. This option no longer has any effect.
.TP
.BR "-A"
Turn off fill justification when printing out table elements.
@@ -221,7 +221,11 @@ tabular output. For example
will give you tables with borders.
.TP
.BR "-u"
-Turns on username/password authentication.
+Asks the user for the user name and password before connecting to the database.
+If the database does not require password authentication then these are
+ignored. If the option i snot used (and the PGPASSWORD environment variable
+is not set) and the database requires password authentication, then the
+connection will fail. The user name is ignored anyway.
.TP
.BR "-x"
Turns on extended row format mode. When enabled each row will have its column