pg.ddx.io  pgsql-committers@postgresql.org mailing list archive  
help / color / mirror / Atom feed
From: Robert Haas <rhaas@postgresql.org>
To: pgsql-committers@lists.postgresql.org
Subject: pgsql: Improve documentation of the CREATEROLE attibute.
Date: Tue, 03 Jan 2023 20:09:51 +0000
Message-ID: <E1pCnbb-001tDp-8j@gemulon.postgresql.org> (raw)

Improve documentation of the CREATEROLE attibute.

In user-manag.sgml, document precisely what privileges are conveyed
by CREATEROLE. Make particular note of the fact that it allows
changing passwords and granting access to high-privilege roles.
Also remove the suggestion of using a user with CREATEROLE and
CREATEDB instead of a superuser, as there is no real security
advantage to this approach.

Elsewhere in the documentation, adjust text that suggests that
<literal>CREATEROLE</literal> only allows for role creation, and
refer to the documentation in user-manag.sgml as appropriate.

Patch by me, reviewed by Álvaro Herrera

Discussion: http://postgr.es/m/CA+TgmoZBsPL8nPhvYecx7iGo5qpDRqa9k_AcaW1SbOjugAY1Ag@mail.gmail.com

Branch
------
REL_15_STABLE

Details
-------
https://git.postgresql.org/pg/commitdiff/aa26980ca0813200c25b06e3ad0f54d449cce8b2

Modified Files
--------------
doc/src/sgml/ref/alter_role.sgml  |  2 +-
doc/src/sgml/ref/create_role.sgml | 10 ++++-----
doc/src/sgml/ref/createuser.sgml  | 18 ++++++++++-----
doc/src/sgml/user-manag.sgml      | 47 +++++++++++++++++++++++++++------------
4 files changed, 52 insertions(+), 25 deletions(-)



view thread (6+ messages)  latest in thread

Message-ID: <E1pCnbb-001tDp-8j@gemulon.postgresql.org>
Permalink:  ../E1pCnbb-001tDp-8j@gemulon.postgresql.org/
Also on:    postgresql.org/message-id/E1pCnbb-001tDp-8j@gemulon.postgresql.org

 · 

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients from your mail client; the link fills in
  the headers below: reply via email
  Some clients, webmail especially, drop In-Reply-To and References from
  a link, and the reply then starts a new thread: use the mbox below.

  To: pgsql-committers@postgresql.org
  Cc: rhaas@postgresql.org
  Subject: Re: pgsql: Improve documentation of the CREATEROLE attibute.
  In-Reply-To: <E1pCnbb-001tDp-8j@gemulon.postgresql.org>
  References: <E1pCnbb-001tDp-8j@gemulon.postgresql.org>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox