From 486daa4ab5b2ca9fc037b4bda9e4ff6046e339d9 Mon Sep 17 00:00:00 2001 From: Fabio Perrella Date: Sun, 5 Oct 2025 22:27:21 +0200 Subject: [PATCH 1/9] pg_archivecleanup: add page --- pages/common/pg_archivecleanup.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 pages/common/pg_archivecleanup.md diff --git a/pages/common/pg_archivecleanup.md b/pages/common/pg_archivecleanup.md new file mode 100644 index 00000000000000..569caad8e0ce7e --- /dev/null +++ b/pages/common/pg_archivecleanup.md @@ -0,0 +1,24 @@ +# pg_archivecleanup + +> Remove old WAL archive files in PostgreSQL. +> More information: . + +- Clean an archive directory up to a given WAL file: + +`pg_archivecleanup {{archivelocation}} {{oldestkeptwalfile}}` + +- Perform a dry run (list files that would be removed): + +`pg_archivecleanup {{[-n|--dry-run]}} {{archivelocation}} {{oldestkeptwalfile}}` + +- Strip a file extension before deciding deletion (e.g., compressed files): + +`pg_archivecleanup {{[-x|--strip-extension]}} {{extension}} {{archivelocation}} {{oldestkeptwalfile}}` + +- Remove backup history files too (in addition to WAL): + +`pg_archivecleanup {{[-b|--clean-backup-history]}} {{archivelocation}} {{oldestkeptwalfile}}` + +- Enable debug logging output: + +`pg_archivecleanup {{[-d|--debug]}} {{archivelocation}} {{oldestkeptwalfile}}` From 7371711f7e01298305a80c7570a092f639364ae1 Mon Sep 17 00:00:00 2001 From: Fabio Perrella Date: Mon, 6 Oct 2025 09:18:25 +0200 Subject: [PATCH 2/9] Update pages/common/pg_archivecleanup.md Co-authored-by: Managor <42655600+Managor@users.noreply.github.com> --- pages/common/pg_archivecleanup.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/common/pg_archivecleanup.md b/pages/common/pg_archivecleanup.md index 569caad8e0ce7e..0d625198d27b8b 100644 --- a/pages/common/pg_archivecleanup.md +++ b/pages/common/pg_archivecleanup.md @@ -5,7 +5,7 @@ - Clean an archive directory up to a given WAL file: -`pg_archivecleanup {{archivelocation}} {{oldestkeptwalfile}}` +`pg_archivecleanup {{path/to/archive}} {{path/to/walfile}}` - Perform a dry run (list files that would be removed): From 710a12d01abe0ac5c9b86e2c4df1c0f67f0ec417 Mon Sep 17 00:00:00 2001 From: Fabio Perrella Date: Mon, 6 Oct 2025 09:18:36 +0200 Subject: [PATCH 3/9] Update pages/common/pg_archivecleanup.md Co-authored-by: Managor <42655600+Managor@users.noreply.github.com> --- pages/common/pg_archivecleanup.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/common/pg_archivecleanup.md b/pages/common/pg_archivecleanup.md index 0d625198d27b8b..bfd3dc441a1164 100644 --- a/pages/common/pg_archivecleanup.md +++ b/pages/common/pg_archivecleanup.md @@ -9,7 +9,7 @@ - Perform a dry run (list files that would be removed): -`pg_archivecleanup {{[-n|--dry-run]}} {{archivelocation}} {{oldestkeptwalfile}}` +`pg_archivecleanup {{[-n|--dry-run]}} {{path/to/archive}} {{path/to/walfile}}` - Strip a file extension before deciding deletion (e.g., compressed files): From 9785c656c0c5368be040eea9d88e2fb503d97ddc Mon Sep 17 00:00:00 2001 From: Fabio Perrella Date: Mon, 6 Oct 2025 09:18:42 +0200 Subject: [PATCH 4/9] Update pages/common/pg_archivecleanup.md Co-authored-by: Managor <42655600+Managor@users.noreply.github.com> --- pages/common/pg_archivecleanup.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/common/pg_archivecleanup.md b/pages/common/pg_archivecleanup.md index bfd3dc441a1164..e88975732c7ce3 100644 --- a/pages/common/pg_archivecleanup.md +++ b/pages/common/pg_archivecleanup.md @@ -11,7 +11,7 @@ `pg_archivecleanup {{[-n|--dry-run]}} {{path/to/archive}} {{path/to/walfile}}` -- Strip a file extension before deciding deletion (e.g., compressed files): +- Strip a file extension before deciding deletion: `pg_archivecleanup {{[-x|--strip-extension]}} {{extension}} {{archivelocation}} {{oldestkeptwalfile}}` From c5d4ff5331e1a3194119ce98baa7b962f1389db5 Mon Sep 17 00:00:00 2001 From: Fabio Perrella Date: Mon, 6 Oct 2025 09:18:48 +0200 Subject: [PATCH 5/9] Update pages/common/pg_archivecleanup.md Co-authored-by: Managor <42655600+Managor@users.noreply.github.com> --- pages/common/pg_archivecleanup.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/common/pg_archivecleanup.md b/pages/common/pg_archivecleanup.md index e88975732c7ce3..e6c378b36c396d 100644 --- a/pages/common/pg_archivecleanup.md +++ b/pages/common/pg_archivecleanup.md @@ -13,7 +13,7 @@ - Strip a file extension before deciding deletion: -`pg_archivecleanup {{[-x|--strip-extension]}} {{extension}} {{archivelocation}} {{oldestkeptwalfile}}` +`pg_archivecleanup {{[-x|--strip-extension]}} {{extension}} {{path/to/archive}} {{path/to/walfile}}` - Remove backup history files too (in addition to WAL): From 545d7300124dd5644deb4949f910aa5b06063c0a Mon Sep 17 00:00:00 2001 From: Fabio Perrella Date: Mon, 6 Oct 2025 09:18:56 +0200 Subject: [PATCH 6/9] Update pages/common/pg_archivecleanup.md Co-authored-by: Managor <42655600+Managor@users.noreply.github.com> --- pages/common/pg_archivecleanup.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/common/pg_archivecleanup.md b/pages/common/pg_archivecleanup.md index e6c378b36c396d..41cb9073272d15 100644 --- a/pages/common/pg_archivecleanup.md +++ b/pages/common/pg_archivecleanup.md @@ -15,7 +15,7 @@ `pg_archivecleanup {{[-x|--strip-extension]}} {{extension}} {{path/to/archive}} {{path/to/walfile}}` -- Remove backup history files too (in addition to WAL): +- Remove backup history files too: `pg_archivecleanup {{[-b|--clean-backup-history]}} {{archivelocation}} {{oldestkeptwalfile}}` From aa00ad88e615f01fe1706571525fff2b2f8f197f Mon Sep 17 00:00:00 2001 From: Fabio Perrella Date: Mon, 6 Oct 2025 09:19:02 +0200 Subject: [PATCH 7/9] Update pages/common/pg_archivecleanup.md Co-authored-by: Managor <42655600+Managor@users.noreply.github.com> --- pages/common/pg_archivecleanup.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/common/pg_archivecleanup.md b/pages/common/pg_archivecleanup.md index 41cb9073272d15..cc50e01e6002f1 100644 --- a/pages/common/pg_archivecleanup.md +++ b/pages/common/pg_archivecleanup.md @@ -17,7 +17,7 @@ - Remove backup history files too: -`pg_archivecleanup {{[-b|--clean-backup-history]}} {{archivelocation}} {{oldestkeptwalfile}}` +`pg_archivecleanup {{[-b|--clean-backup-history]}} {{path/to/archive}} {{path/to/walfile}}` - Enable debug logging output: From e7b3e00d842b0fe7013cf5891a9b6cb9899d19cb Mon Sep 17 00:00:00 2001 From: Fabio Perrella Date: Mon, 6 Oct 2025 09:19:08 +0200 Subject: [PATCH 8/9] Update pages/common/pg_archivecleanup.md Co-authored-by: Managor <42655600+Managor@users.noreply.github.com> --- pages/common/pg_archivecleanup.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/common/pg_archivecleanup.md b/pages/common/pg_archivecleanup.md index cc50e01e6002f1..5ed1950f673808 100644 --- a/pages/common/pg_archivecleanup.md +++ b/pages/common/pg_archivecleanup.md @@ -21,4 +21,4 @@ - Enable debug logging output: -`pg_archivecleanup {{[-d|--debug]}} {{archivelocation}} {{oldestkeptwalfile}}` +`pg_archivecleanup {{[-d|--debug]}} {{path/to/archive}} {{path/to/walfile}}` From e66a6b1995df399c36e677ab8ea394c964178c03 Mon Sep 17 00:00:00 2001 From: Fabio Perrella Date: Mon, 6 Oct 2025 17:52:26 +0200 Subject: [PATCH 9/9] Update pages/common/pg_archivecleanup.md Co-authored-by: Managor <42655600+Managor@users.noreply.github.com> --- pages/common/pg_archivecleanup.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/common/pg_archivecleanup.md b/pages/common/pg_archivecleanup.md index 5ed1950f673808..27a029457d1ae4 100644 --- a/pages/common/pg_archivecleanup.md +++ b/pages/common/pg_archivecleanup.md @@ -7,7 +7,7 @@ `pg_archivecleanup {{path/to/archive}} {{path/to/walfile}}` -- Perform a dry run (list files that would be removed): +- Perform a dry run (list files that would be removed without actually doing it): `pg_archivecleanup {{[-n|--dry-run]}} {{path/to/archive}} {{path/to/walfile}}`