postgres.git / summary / log / commit / refs

commit    0ce8008386cabac026c27be86776f717f0bb229b
Author:   Tom Lane <tgl@sss.pgh.pa.us>
Date:     Fri Sep 20 19:56:34 2024 +0000
First released in: 18.0, 12.21, 13.17, 14.14, 15.9, 16.5, 17.0

    Doc: explain how to test ADMIN privilege with pg_has_role().
    
    This has always been possible, but the syntax is a bit obscure,
    and our user-facing docs were not very helpful.  Spell it out
    more clearly.
    
    Per complaint from Dominique Devienne.  Back-patch to
    all supported branches.
    
    Discussion: https://postgr.es/m/CAFCRh-8JNEy+dV4SXFOrWca50u+d=--TO4cq=+ac1oBtfJy4AA@mail.gmail.com


 doc/src/sgml/func.sgml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index c8e8d030457..487bb103637 100644
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -18335,6 +18335,10 @@ SELECT has_function_privilege('joeuser', 'myfunc(int, text)', 'execute');
     the role (that is, the right to do <command>SET ROLE</command>), while
     <literal>USAGE</literal> denotes whether the privileges of the role
     are immediately available without doing <command>SET ROLE</command>.
+    <literal>WITH ADMIN OPTION</literal> or <literal>WITH GRANT
+    OPTION</literal> can be added to either of these privilege types to
+    test whether the <literal>ADMIN</literal> privilege is held (all
+    four spellings test the same thing).
    </para>
 
    <para>


[parent: 940bcf80aa76]