Add documentation for privs with functions and procedures (ansible-collections#169)

GhostLyrics · web-flow · commit 6bce48e77120 · 2021-05-18T07:57:07.000+02:00
diff --git a/plugins/modules/mysql_user.py b/plugins/modules/mysql_user.py
@@ -53,6 +53,7 @@
         the module will always report changes. It includes grouping columns
         by permission (C(SELECT(col1,col2)) instead of C(SELECT(col1),SELECT(col2))).
       - Can be passed as a dictionary (see the examples).
+      - Supports GRANTs for procedures and functions (see the examples).
     type: raw
   append_privs:
     description:
@@ -188,6 +189,15 @@
       'db1.*': 'ALL,GRANT'
       'db2.*': 'ALL,GRANT'
 
+# Use 'PROCEDURE' instead of 'FUNCTION' to apply GRANTs for a MySQL procedure instead.
+- name: Grant a user the right to execute a function
+  community.mysql.mysql_user:
+    name: readonly
+    password: 12345
+    priv:
+      FUNCTION my_db.my_function: EXECUTE
+    state: present
+
 # Note that REQUIRESSL is a special privilege that should only apply to *.* by itself.
 # Setting this privilege in this manner is deprecated.
 # Use 'tls_requires' instead.
