From a6b5ddf64ce24532c69a24f1b3e13dbaa81ccbba Mon Sep 17 00:00:00 2001 From: Alvaro Herrera Date: Mon, 16 Mar 2020 19:12:14 -0300 Subject: [PATCH] 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 Discussion: https://postgr.es/m/20200305161838.GJ684@telsasoft.com --- doc/src/sgml/func.sgml | 2 ++ 1 file changed, 2 insertions(+) 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 pg_monitor role can use this function. Access may be granted to others using GRANT. + Filenames beginning with a dot, directories, and other special files are not shown. @@ -20322,6 +20323,7 @@ postgres=# SELECT * FROM pg_walfile_name_offset(pg_stop_backup()); default only superusers and members of the pg_monitor role can use this function. Access may be granted to others using GRANT. + Filenames beginning with a dot, directories, and other special files are not shown.