pg_waldump: Add support for reading WAL from tar archives

pg_waldump can now accept the path to a tar archive (optionally
compressed with gzip, lz4, or zstd) containing WAL files and decode
them.  This was added primarily for pg_verifybackup, which previously
had to skip WAL parsing for tar-format backups.

The implementation uses the existing archive streamer infrastructure
with a hash table to track WAL segments read from the archive.  If WAL
files within the archive are not in sequential order, out-of-order
segments are written to a temporary directory (created via mkdtemp under
$TMPDIR or the archive's directory) and read back when needed.  An
atexit callback ensures the temporary directory is cleaned up.

The --follow option is not supported when reading from a tar archive.

Author: Amul Sul <[email protected]>
Reviewed-by: Robert Haas <[email protected]>
Reviewed-by: Jakub Wartak <[email protected]>
Reviewed-by: Chao Li <[email protected]>
Reviewed-by: Euler Taveira <[email protected]>
Reviewed-by: Andrew Dunstan <[email protected]>
Reviewed-by: Zsolt Parragi <[email protected]>
discussion: 
https://postgr.es/m/CAAJ_b94bqdWN3h2J-PzzzQ2Npbwct5ZQHggn_QoYGhC2rn-=w...@mail.gmail.com

Branch
------
master

Details
-------
https://git.postgresql.org/pg/commitdiff/b15c1513984e6eafd264bf6e84a08549905621f1

Modified Files
--------------
doc/src/sgml/ref/pg_waldump.sgml     |  23 +-
src/bin/pg_waldump/Makefile          |   7 +-
src/bin/pg_waldump/archive_waldump.c | 860 +++++++++++++++++++++++++++++++++++
src/bin/pg_waldump/meson.build       |   4 +-
src/bin/pg_waldump/pg_waldump.c      | 288 +++++++++---
src/bin/pg_waldump/pg_waldump.h      |  51 +++
src/bin/pg_waldump/t/001_basic.pl    | 264 ++++++++---
src/tools/pgindent/typedefs.list     |   4 +
8 files changed, 1364 insertions(+), 137 deletions(-)

Reply via email to