Documenation fixups for replication protocol.
authorJeff Davis
Sat, 16 Jan 2021 22:40:12 +0000 (14:40 -0800)
committerJeff Davis
Sat, 16 Jan 2021 22:40:12 +0000 (14:40 -0800)
There is no CopyResponse message; it should be CopyOutResponse.

Also, if there is no WAL to stream, the server does not immediately
send a CommandComplete; it's a historical timeline, so it will send a
response tuple first.

Discussion: https://postgr.es/m/0a2c985ebcaa1acd385350aeba561b6509187394[email protected]

doc/src/sgml/protocol.sgml

index 24f7b21ecbd45cf761a19ac0b21b805893fefbe6..3763b4b995ff52709592790e3eae23ff29e859de 100644 (file)
@@ -2065,8 +2065,8 @@ The commands accepted in replication mode are:
       the history of the server, the server will stream all the WAL on that
       timeline starting from the requested start point up to the point where
       the server switched to another timeline. If the client requests
-      streaming at exactly the end of an old timeline, the server responds
-      immediately with CommandComplete without entering COPY mode.
+      streaming at exactly the end of an old timeline, the server skips COPY
+      mode entirely.
      
 
      
@@ -2638,7 +2638,7 @@ The commands accepted in replication mode are:
      
      
       When the backup is started, the server will first send two
-      ordinary result sets, followed by one or more CopyResponse
+      ordinary result sets, followed by one or more CopyOutResponse
       results.
      
      
@@ -2681,15 +2681,15 @@ The commands accepted in replication mode are:
       
      
      
-      After the second regular result set, one or more CopyResponse results
+      After the second regular result set, one or more CopyOutResponse results
       will be sent, one for the main data directory and one for each additional tablespace other
       than pg_default and pg_global. The data in
-      the CopyResponse results will be a tar format (following the
+      the CopyOutResponse results will be a tar format (following the
       ustar interchange format 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.
       After the tar data is complete, and if a backup manifest was requested,
-      another CopyResponse result is sent, containing the manifest data for the
+      another CopyOutResponse result is sent, containing the manifest data for the
       current base backup. In any case, a final ordinary result set will be
       sent, containing the WAL end position of the backup, in the same format as
       the start position.