database/postgres
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2025-08-08 06:02:22 +03:00
Code Activity

Add pg_ls_archive_statusdir function

Browse Source 
This function lists the contents of the WAL archive status directory,
and is intended to be used by monitoring tools.  Unlike pg_ls_dir(),
access to it can be granted to non-superusers so that those monitoring
tools can observe the principle of least privilege.  Access is also
given by default to members of pg_monitor.

Author:  Christoph Moench-Tegeder
Reviewed-by: Aya Iwata
Discussion: https://postgr.es/m/20180930205920.GA64534@elch.exwg.net
This commit is contained in:
Michael Paquier
2018-10-09 22:29:09 +09:00
parent bfa6c5a0c9
commit c481016201
5 changed files with 41 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

24
doc/src/sgml/func.sgml
View File

@@ -20355,6 +20355,18 @@ postgres=# SELECT * FROM pg_walfile_name_offset(pg_stop_backup());
role and may be granted to other non-superuser roles.
</entry>
</row>
<row>
<entry>
<literal><function>pg_ls_archive_statusdir()</function></literal>
</entry>
<entry><type>setof record</type></entry>
<entry>
List the name, size, and last modification time of files in the WAL
archive status directory. Access is granted to members of the
<literal>pg_monitor</literal> role and may be granted to other
non-superuser roles.
</entry>
</row>
<row>
<entry>
<literal><function>pg_ls_tmpdir(<optional><parameter>tablespace</parameter> <type>oid</type></optional>)</function></literal>
@@ -20442,6 +20454,18 @@ postgres=# SELECT * FROM pg_walfile_name_offset(pg_stop_backup());
<command>GRANT</command>.
</para>
<indexterm>
<primary>pg_ls_archive_statusdir</primary>
</indexterm>
<para>
<function>pg_ls_archive_statusdir</function> returns the name, size, and
last modified time (mtime) of each file in the WAL archive status
directory <literal>pg_wal/archive_status</literal>. By default only
superusers and members of the <literal>pg_monitor</literal> role can
use this function. Access may be granted to others using
<command>GRANT</command>.
</para>
<indexterm>
<primary>pg_ls_tmpdir</primary>
</indexterm>