From: Alvaro Herrera Date: Mon, 16 Mar 2020 22:12:14 +0000 (-0300) Subject: Document pg_ls_*dir hiding of directories and special files X-Git-Tag: REL_11_8~90 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=a6b5ddf64ce24532c69a24f1b3e13dbaa81ccbba;p=thirdparty%2Fpostgresql.git 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 --- 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.