Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                
Skip to content

Commit 8b6d94c

Browse files
committed
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
1 parent b234b56 commit 8b6d94c

File tree

1 file changed

+4
-0
lines changed

1 file changed

+4
-0
lines changed

doc/src/sgml/func.sgml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21450,6 +21450,7 @@ postgres=# SELECT * FROM pg_walfile_name_offset(pg_stop_backup());
2145021450
(mtime) of each file in the log directory. By default, only superusers
2145121451
and members of the <literal>pg_monitor</literal> role can use this function.
2145221452
Access may be granted to others using <command>GRANT</command>.
21453+
Filenames beginning with a dot, directories, and other special files are not shown.
2145321454
</para>
2145421455

2145521456
<indexterm>
@@ -21461,6 +21462,7 @@ postgres=# SELECT * FROM pg_walfile_name_offset(pg_stop_backup());
2146121462
default only superusers and members of the <literal>pg_monitor</literal> role
2146221463
can use this function. Access may be granted to others using
2146321464
<command>GRANT</command>.
21465+
Filenames beginning with a dot, directories, and other special files are not shown.
2146421466
</para>
2146521467

2146621468
<indexterm>
@@ -21473,6 +21475,7 @@ postgres=# SELECT * FROM pg_walfile_name_offset(pg_stop_backup());
2147321475
superusers and members of the <literal>pg_monitor</literal> role can
2147421476
use this function. Access may be granted to others using
2147521477
<command>GRANT</command>.
21478+
Filenames beginning with a dot, directories, and other special files are not shown.
2147621479
</para>
2147721480

2147821481
<indexterm>
@@ -21486,6 +21489,7 @@ postgres=# SELECT * FROM pg_walfile_name_offset(pg_stop_backup());
2148621489
default only superusers and members of the <literal>pg_monitor</literal>
2148721490
role can use this function. Access may be granted to others using
2148821491
<command>GRANT</command>.
21492+
Filenames beginning with a dot, directories, and other special files are not shown.
2148921493
</para>
2149021494

2149121495
<indexterm>

0 commit comments

Comments
 (0)