From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001 From: Andrew Dunstan Date: Tue, 3 Mar 2026 00:00:00 +0000 Subject: [PATCH] Fix documentation for pg_waldump tar archive support Two documentation issues with the tar archive reading feature: - pg_waldump.sgml: When reading WAL from a tar archive with out-of-order segments, pg_waldump spills to temporary files. TMPDIR controls where those files are created, but this was not documented in the Environment section. - pg_verifybackup.sgml: The --wal-path option description still only said "directory" even though it now also accepts tar archives. --- doc/src/sgml/ref/pg_verifybackup.sgml | 7 ++++--- doc/src/sgml/ref/pg_waldump.sgml | 11 +++++++++++ 2 files changed, 15 insertions(+), 3 deletions(-) diff --git a/doc/src/sgml/ref/pg_verifybackup.sgml b/doc/src/sgml/ref/pg_verifybackup.sgml index 16b50b5a4df..1695cfe91c8 100644 --- a/doc/src/sgml/ref/pg_verifybackup.sgml +++ b/doc/src/sgml/ref/pg_verifybackup.sgml @@ -261,9 +261,10 @@ PostgreSQL documentation - Try to parse WAL files stored in the specified directory, rather than - in pg_wal. This may be useful if the backup is - stored in a separate location from the WAL archive. + Try to parse WAL files stored in the specified directory or tar + archive, rather than in pg_wal. This may be + useful if the backup is stored in a separate location from the WAL + archive. diff --git a/doc/src/sgml/ref/pg_waldump.sgml b/doc/src/sgml/ref/pg_waldump.sgml index b36323dde92..9bbb4bd5772 100644 --- a/doc/src/sgml/ref/pg_waldump.sgml +++ b/doc/src/sgml/ref/pg_waldump.sgml @@ -391,6 +391,17 @@ PostgreSQL documentation + + + TMPDIR + + + Directory in which to create temporary files when reading WAL from a + tar archive with out-of-order segment files. If not set, the temporary + directory is created within the same directory as the tar archive. + + +