aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAlvaro Herrera <alvherre@alvh.no-ip.org>2020-03-16 19:12:14 -0300
committerAlvaro Herrera <alvherre@alvh.no-ip.org>2020-03-16 19:12:14 -0300
commita6b5ddf64ce24532c69a24f1b3e13dbaa81ccbba (patch)
tree020774565728d1c547d1f1e489c6542e8f5798ce
parent55978e28cd50e7db02289e1dca93a9284c7c2b05 (diff)
downloadpostgresql-a6b5ddf64ce24532c69a24f1b3e13dbaa81ccbba.tar.gz
postgresql-a6b5ddf64ce24532c69a24f1b3e13dbaa81ccbba.zip
Document pg_ls_*dir hiding of directories and special files
It's strange that a directory-listing function does not list all entries in a directory, so let's at least document it. This involves pg_ls_logdir pg_ls_waldir pg_ls_archive_statusdir pg_ls_tmpdir Backpatch as far back as it applies cleanly (and as far as as each function exists). REL_10_STABLE uses different wording, but hopefully people are not reading docs so old to write new apps anyway. Author: Justin Pryzby <pryzby@telsasoft.com> Discussion: https://postgr.es/m/20200305161838.GJ684@telsasoft.com
-rw-r--r--doc/src/sgml/func.sgml2
1 files changed, 2 insertions, 0 deletions
diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index 3fd67e606f1..652580a8042 100644
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -20311,6 +20311,7 @@ postgres=# SELECT * FROM pg_walfile_name_offset(pg_stop_backup());
(mtime) of each file in the log directory. 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>.
+ Filenames beginning with a dot, directories, and other special files are not shown.
</para>
<indexterm>
@@ -20322,6 +20323,7 @@ postgres=# SELECT * FROM pg_walfile_name_offset(pg_stop_backup());
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>.
+ Filenames beginning with a dot, directories, and other special files are not shown.
</para>
<indexterm>