diff --git a/doc/src/sgml/adminpack.sgml b/doc/src/sgml/adminpack.sgml
index 1150b7f5bb..184e96d7a0 100644
--- a/doc/src/sgml/adminpack.sgml
+++ b/doc/src/sgml/adminpack.sgml
@@ -12,7 +12,7 @@
pgAdmin and other administration and management tools can
use to provide additional functionality, such as remote management
of server log files.
- Use of all these functions is only allowed to the superuser by default but may be
+ Use of all these functions is only allowed to database superusers by default, but may be
allowed to other users by using the GRANT command.
diff --git a/doc/src/sgml/glossary.sgml b/doc/src/sgml/glossary.sgml
index d6d0a3a814..93fb149d9a 100644
--- a/doc/src/sgml/glossary.sgml
+++ b/doc/src/sgml/glossary.sgml
@@ -233,6 +233,25 @@
+
+ Bootstrap superuser
+
+
+ The first user initialized in a
+ database cluster.
+
+
+ This user owns all system catalog tables in each database. It is also the role
+ from which all granted permissions originate. Because of these things, this
+ role may not be dropped.
+
+
+ This role also behaves as a normal
+ database superuser.
+
+
+
+
Cast
@@ -342,6 +361,23 @@
+
+ Cluster owner
+
+
+ The operating system user that owns the
+ data directory
+ and under which the postgres process is run.
+ It is required that this user exist prior to creating a new
+ database cluster.
+
+
+ On operating systems with a root user,
+ said user is not allowed to be the cluster owner.
+
+
+
+
Column
@@ -475,12 +511,20 @@
and their common static and dynamic metadata.
Sometimes referred to as a
cluster.
+ A database cluster is created using the
+ program.
In PostgreSQL, the term
cluster is also sometimes used to refer to an instance.
(Don't confuse this term with the SQL command CLUSTER.)
+
+ See also cluster owner,
+ the operating-system owner of a cluster,
+ and bootstrap superuser,
+ the PostgreSQL owner of a cluster.
+
@@ -489,6 +533,19 @@
+
+ Database superuser
+
+
+ A role having superuser status
+ (see ).
+
+
+ Frequently referred to as superuser.
+
+
+
+
Data directory
@@ -1577,6 +1634,16 @@
+
+ Superuser
+
+
+ As used in this documentation, it is a synonym for
+ database superuser.
+
+
+
+
System catalog
@@ -1827,7 +1894,8 @@
A role that has the
- LOGIN privilege.
+ login privilege
+ (see ).
diff --git a/doc/src/sgml/ref/initdb.sgml b/doc/src/sgml/ref/initdb.sgml
index 8158896298..2410330cd6 100644
--- a/doc/src/sgml/ref/initdb.sgml
+++ b/doc/src/sgml/ref/initdb.sgml
@@ -37,14 +37,13 @@ PostgreSQL documentation
Descriptioninitdb creates a new
- PostgreSQL database cluster. A database
- cluster is a collection of databases that are managed by a single
- server instance.
+ PostgreSQLdatabase cluster.
- Creating a database cluster consists of creating the directories in
- which the database data will live, generating the shared catalog
+ Creating a database cluster consists of creating the
+ directories in
+ which the cluster data will live, generating the shared catalog
tables (tables that belong to the whole cluster rather than to any
particular database), and creating the postgres,
template1, and template0 databases.
@@ -196,7 +195,7 @@ PostgreSQL documentation
initdb, but you can avoid writing it by
setting the PGDATA environment variable, which
can be convenient since the database server
- (postgres) can find the database
+ (postgres) can find the data
directory later by the same variable.
@@ -338,7 +337,7 @@ PostgreSQL documentation
- Makes initdb read the database superuser's password
+ Makes initdb read the bootstrap superuser's password
from a file. The first line of the file is taken as the password.
@@ -374,12 +373,10 @@ PostgreSQL documentation
- Selects the user name of the database superuser. This defaults
- to the name of the effective user running
- initdb. It is really not important what the
- superuser's name is, but one might choose to keep the
- customary name postgres, even if the operating
- system user's name is different.
+ Selects the user name of the
+ boostrap superuser.
+ This defaults to the name of the
+ cluster owner.
@@ -390,7 +387,7 @@ PostgreSQL documentation
Makes initdb prompt for a password
- to give the database superuser. If you don't plan on using password
+ to give the bootstrap superuser. If you don't plan on using password
authentication, this is not important. Otherwise you won't be
able to use password authentication until you have a password
set up.