2014-09-09 13:42:30 +00:00
|
|
|
|
cdist-type__postgres_extension(7)
|
|
|
|
|
=================================
|
|
|
|
|
|
|
|
|
|
NAME
|
|
|
|
|
----
|
2021-04-16 17:22:58 +00:00
|
|
|
|
cdist-type__postgres_extension - Manage PostgreSQL extensions
|
2014-09-09 13:42:30 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
|
-----------
|
2021-04-16 17:22:58 +00:00
|
|
|
|
This cdist type allows you to manage PostgreSQL extensions.
|
2014-09-09 13:42:30 +00:00
|
|
|
|
|
2021-04-16 17:22:58 +00:00
|
|
|
|
The ``__object_id`` to pass to ``__postgres_extension`` is of the form
|
|
|
|
|
``dbname:extension``, e.g.:
|
2014-09-09 13:42:30 +00:00
|
|
|
|
|
2017-03-08 18:16:23 +00:00
|
|
|
|
.. code-block:: sh
|
2016-12-01 08:27:56 +00:00
|
|
|
|
|
2021-04-16 17:22:58 +00:00
|
|
|
|
rails_test:unaccent
|
2014-09-09 13:42:30 +00:00
|
|
|
|
|
|
|
|
|
|
2021-04-16 17:22:58 +00:00
|
|
|
|
**CAUTION!** Be careful when installing extensions from (untrusted) third-party
|
|
|
|
|
sources:
|
2016-12-01 08:27:56 +00:00
|
|
|
|
|
2021-04-16 17:22:58 +00:00
|
|
|
|
| Installing an extension as superuser requires trusting that the extension's
|
|
|
|
|
author wrote the extension installation script in a secure fashion. It is
|
|
|
|
|
not terribly difficult for a malicious user to create trojan-horse objects
|
|
|
|
|
that will compromise later execution of a carelessly-written extension
|
|
|
|
|
script, allowing that user to acquire superuser privileges.
|
|
|
|
|
| – `<https://www.postgresql.org/docs/13/sql-createextension.html#id-1.9.3.64.7>`_
|
2014-09-09 13:42:30 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
OPTIONAL PARAMETERS
|
|
|
|
|
-------------------
|
2016-12-01 08:27:56 +00:00
|
|
|
|
state
|
2021-04-16 17:22:58 +00:00
|
|
|
|
either ``present`` or ``absent``, defaults to ``present``.
|
2014-09-09 13:42:30 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
EXAMPLES
|
|
|
|
|
--------
|
|
|
|
|
|
2016-12-01 08:27:56 +00:00
|
|
|
|
.. code-block:: sh
|
|
|
|
|
|
2021-04-16 17:22:58 +00:00
|
|
|
|
# Install extension unaccent into database rails_test
|
|
|
|
|
__postgres_extension rails_test:unaccent
|
|
|
|
|
|
|
|
|
|
# Drop extension unaccent from database fails_test
|
|
|
|
|
__postgres_extension rails_test:unaccent --state absent
|
2014-09-09 13:42:30 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
SEE ALSO
|
|
|
|
|
--------
|
2021-04-16 17:22:58 +00:00
|
|
|
|
- :strong:`cdist-type__postgres_database`\ (7)
|
|
|
|
|
- PostgreSQL "CREATE EXTENSION" documentation at:
|
|
|
|
|
`<http://www.postgresql.org/docs/current/static/sql-createextension.html>`_.
|
2016-12-01 08:27:56 +00:00
|
|
|
|
|
2014-09-09 13:42:30 +00:00
|
|
|
|
|
2021-04-16 17:22:58 +00:00
|
|
|
|
AUTHORS
|
2016-12-01 08:27:56 +00:00
|
|
|
|
-------
|
2021-04-16 17:22:58 +00:00
|
|
|
|
| Tomas Pospisek <tpo_deb--@--sourcepole.ch>
|
|
|
|
|
| Dennis Camera <dennis.camera--@--ssrq-sds-fds.ch>
|
|
|
|
|
|
2014-09-09 13:42:30 +00:00
|
|
|
|
|
|
|
|
|
COPYING
|
|
|
|
|
-------
|
2021-04-16 17:22:58 +00:00
|
|
|
|
Copyright \(C) 2014 Tomas Pospisek, 2021 Dennis Camera.
|
|
|
|
|
You can redistribute it and/or modify it under the terms of the GNU General
|
|
|
|
|
Public License as published by the Free Software Foundation, either version 3 of
|
|
|
|
|
the License, or (at your option) any later version.
|