summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRobert Haas <rhaas@postgresql.org>2021-12-01 08:55:00 -0500
committerRobert Haas <rhaas@postgresql.org>2021-12-01 08:55:00 -0500
commit81fca310b38e7808dff9c01a26564e8f2db10893 (patch)
treee78d9fb5a5357289a041eeed0edfcbeaa4d84d2e
parent018b800245c5d4db30d204fa42fada05a64eb287 (diff)
Document that tar archives are now properly terminated.
Commit 5a1007a5088cd6ddf892f7422ea8dbaef362372f changed the server behavior, but I didn't notice that the existing behavior was documented, and therefore did not update the documentation. This commit does that. I chose to mention that the behavior has changed rather than just removing the reference to a deviation from a standard. It seemed like that might be helpful to tool authors. Discussion: http://postgr.es/m/CA+TgmoaYZbz0=Yk797aOJwkGJC-LK3iXn+wzzMx7KdwNpZhS5g@mail.gmail.com
-rw-r--r--doc/src/sgml/protocol.sgml6
1 files changed, 4 insertions, 2 deletions
diff --git a/doc/src/sgml/protocol.sgml b/doc/src/sgml/protocol.sgml
index e59216e7f2f..34a7034282a 100644
--- a/doc/src/sgml/protocol.sgml
+++ b/doc/src/sgml/protocol.sgml
@@ -2809,8 +2809,10 @@ The commands accepted in replication mode are:
than <literal>pg_default</literal> and <literal>pg_global</literal>. The data in
the CopyOutResponse results will be a tar format (following the
<quote>ustar interchange format</quote> specified in the POSIX 1003.1-2008
- standard) dump of the tablespace contents, except that the two trailing
- blocks of zeroes specified in the standard are omitted.
+ standard) dump of the tablespace contents. Prior to
+ <literal>PostgreSQL</literal> 15, the server omitted the two trailing
+ blocks of zeroes specified in the standard, but this is no longer the
+ case.
After the tar data is complete, and if a backup manifest was requested,
another CopyOutResponse result is sent, containing the manifest data for the
current base backup. In any case, a final ordinary result set will be