aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorNathan Bossart <nathan@postgresql.org>2024-03-24 15:24:09 -0500
committerNathan Bossart <nathan@postgresql.org>2024-03-24 15:24:09 -0500
commitd82dc79ba03c783fa41be768c1bf13cb8200a340 (patch)
treea67a815aad7399037e6d7a00168f9869787035af
parent3676b846b129b975034927cdf5f57297211d6f15 (diff)
downloadpostgresql-d82dc79ba03c783fa41be768c1bf13cb8200a340.tar.gz
postgresql-d82dc79ba03c783fa41be768c1bf13cb8200a340.zip
doc: Clarify requirements for SET ROLE.
Since commit 3d14e171e9, SET ROLE has required the current session user to have membership with the SET option in the target role, but the SET ROLE documentation only mentions the membership requirement. This commit adds this important detail to the SET ROLE page. Reviewed-by: Robert Haas Discussion: https://postgr.es/m/CA%2BRLCQysHtME0znk2KUMJN343ksboSRQSU-hCnOjesX6VK300Q%40mail.gmail.com Backpatch-through: 16
-rw-r--r--doc/src/sgml/ref/set_role.sgml6
1 files changed, 4 insertions, 2 deletions
diff --git a/doc/src/sgml/ref/set_role.sgml b/doc/src/sgml/ref/set_role.sgml
index 13bad1bf66e..083e6dc6ea9 100644
--- a/doc/src/sgml/ref/set_role.sgml
+++ b/doc/src/sgml/ref/set_role.sgml
@@ -41,8 +41,10 @@ RESET ROLE
</para>
<para>
- The specified <replaceable class="parameter">role_name</replaceable>
- must be a role that the current session user is a member of.
+ The current session user must have the <literal>SET</literal> option for the
+ specified <replaceable class="parameter">role_name</replaceable>, either
+ directly or indirectly via a chain of memberships with the
+ <literal>SET</literal> option.
(If the session user is a superuser, any role can be selected.)
</para>