From f340977a4fab20f1898d4ac61ae1c36031e109cb 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 | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml index be586f17a1..4d43ba0584 100644 --- a/doc/src/sgml/func.sgml +++ b/doc/src/sgml/func.sgml @@ -21862,6 +21862,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. @@ -21873,6 +21874,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. @@ -21885,6 +21887,7 @@ postgres=# SELECT * FROM pg_walfile_name_offset(pg_stop_backup()); 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. @@ -21898,6 +21901,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.