diff --git a/doc/src/sgml/protocol.sgml b/doc/src/sgml/protocol.sgml index 34da8592c08..1a596cd0edf 100644 --- a/doc/src/sgml/protocol.sgml +++ b/doc/src/sgml/protocol.sgml @@ -1320,16 +1320,16 @@ the connection to be used for logical replication from that database. psql "dbname=postgres replication=database" -c "IDENTIFY_SYSTEM;" - However it is often more useful to use - pg_receivexlog (for physical replication) or - pg_recvlogical (for logical replication). + However, it is often more useful to use + (for physical replication) or + (for logical replication). The commands accepted in walsender mode are: - IDENTIFY_SYSTEM + IDENTIFY_SYSTEM IDENTIFY_SYSTEM @@ -1342,7 +1342,7 @@ The commands accepted in walsender mode are: - systemid + systemid (text) @@ -1355,11 +1355,11 @@ The commands accepted in walsender mode are: - timeline + timeline (int4) - Current TimelineID. Also useful to check that the standby is + Current timeline ID. Also useful to check that the standby is consistent with the master. @@ -1367,7 +1367,7 @@ The commands accepted in walsender mode are: - xlogpos + xlogpos (text) @@ -1379,11 +1379,11 @@ The commands accepted in walsender mode are: - dbname + dbname (text) - Database connected to or NULL. + Database connected to or null. @@ -1394,7 +1394,7 @@ The commands accepted in walsender mode are: - TIMELINE_HISTORY tli + TIMELINE_HISTORY tli TIMELINE_HISTORY @@ -1408,18 +1408,18 @@ The commands accepted in walsender mode are: - filename + filename (text) - Filename of the timeline history file, e.g 00000002.history. + File name of the timeline history file, e.g., 00000002.history. - content + content (bytea) @@ -1434,7 +1434,7 @@ The commands accepted in walsender mode are: - CREATE_REPLICATION_SLOT slot_name { PHYSICAL [ RESERVE_WAL ] | LOGICAL output_plugin } + CREATE_REPLICATION_SLOT slot_name { PHYSICAL [ RESERVE_WAL ] | LOGICAL output_plugin } CREATE_REPLICATION_SLOT @@ -1469,7 +1469,7 @@ The commands accepted in walsender mode are: Specify that this physical replication reserves WAL - immediately; otherwise WAL is only reserved upon + immediately. Otherwise, WAL is only reserved upon connection from a streaming replication client. @@ -1479,7 +1479,7 @@ The commands accepted in walsender mode are: - START_REPLICATION [SLOT slot_name] [PHYSICAL] XXX/XXX [TIMELINE tli] + START_REPLICATION [ SLOT slot_name ] [ PHYSICAL ] XXX/XXX [ TIMELINE tli ] START_REPLICATION @@ -1489,7 +1489,7 @@ The commands accepted in walsender mode are: If TIMELINE option is specified, streaming starts on timeline tli; otherwise, the server's current timeline is selected. The server can - reply with an error, e.g. if the requested section of WAL has already + reply with an error, for example if the requested section of WAL has already been recycled. On success, server responds with a CopyBothResponse message, and then starts to stream WAL to the frontend. @@ -1503,9 +1503,9 @@ The commands accepted in walsender mode are: - If the client requests a timeline that's not the latest, but is part of + If the client requests a timeline that's not the latest but is part of the history of the server, the server will stream all the WAL on that - timeline starting from the requested startpoint, up to the point where + 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. @@ -1516,8 +1516,8 @@ The commands accepted in walsender mode are: the server will end streaming by exiting the COPY mode. When the client acknowledges this by also exiting COPY mode, the server sends a result set with one row and two columns, indicating the next timeline in this - server's history. The first column is the next timeline's ID, and the - second column is the XLOG position where the switch happened. Usually, + server's history. The first column is the next timeline's ID (type int8), and the + second column is the WAL position where the switch happened (type text). Usually, the switch position is the end of the WAL that was streamed, but there are corner cases where the server can send some WAL from the old timeline that it has not itself replayed before promoting. Finally, the @@ -1809,12 +1809,12 @@ The commands accepted in walsender mode are: - START_REPLICATION SLOT slot_name LOGICAL XXX/XXX [ ( option_name [option_value] [, ... ] ) ] + START_REPLICATION SLOT slot_name LOGICAL XXX/XXX [ ( option_name [ option_value ] [, ...] ) ] Instructs server to start streaming WAL for logical replication, starting at WAL position XXX/XXX. The server can - reply with an error, e.g. if the requested section of WAL has already + reply with an error, for example if the requested section of WAL has already been recycled. On success, server responds with a CopyBothResponse message, and then starts to stream WAL to the frontend. @@ -1871,7 +1871,7 @@ The commands accepted in walsender mode are: - DROP_REPLICATION_SLOT slot_name + DROP_REPLICATION_SLOT slot_name DROP_REPLICATION_SLOT @@ -1893,7 +1893,7 @@ The commands accepted in walsender mode are: - BASE_BACKUP [LABEL 'label'] [PROGRESS] [FAST] [WAL] [NOWAIT] [MAX_RATE rate] [TABLESPACE_MAP] + BASE_BACKUP [ LABEL 'label' ] [ PROGRESS ] [ FAST ] [ WAL ] [ NOWAIT ] [ MAX_RATE rate ] [ TABLESPACE_MAP ] BASE_BACKUP @@ -1923,10 +1923,10 @@ The commands accepted in walsender mode are: send back an approximate size in the header of each tablespace, which can be used to calculate how far along the stream is done. This is calculated by enumerating all the file sizes once before the transfer - is even started, and may as such have a negative impact on the - performance - in particular it may take longer before the first data + is even started, and might as such have a negative impact on the + performance. In particular, it might take longer before the first data is streamed. Since the database files can change during the backup, - the size is only approximate and may both grow and shrink between + the size is only approximate and might both grow and shrink between the time of approximation and the sending of the actual files. @@ -1957,7 +1957,7 @@ The commands accepted in walsender mode are: NOWAIT - By default, the backup will wait until the last required xlog + By default, the backup will wait until the last required WAL segment has been archived, or emit a warning if log archiving is not enabled. Specifying NOWAIT disables both the waiting and the warning, leaving the client responsible for @@ -2010,29 +2010,29 @@ The commands accepted in walsender mode are: The fields in this row are: - spcoid + spcoid (oid) - The oid of the tablespace, or NULL if it's the base + The OID of the tablespace, or null if it's the base directory. - spclocation + spclocation (text) - The full path of the tablespace directory, or NULL + The full path of the tablespace directory, or null if it's the base directory. - size + size (int8) The approximate size of the tablespace, if progress report has - been requested; otherwise it's NULL. + been requested; otherwise it's null. @@ -2040,7 +2040,7 @@ The commands accepted in walsender mode are: After the second regular result set, one or more CopyResponse results - will be sent, one for PGDATA and one for each additional tablespace other + 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 ustar interchange format specified in the POSIX 1003.1-2008 @@ -2093,14 +2093,9 @@ The commands accepted in walsender mode are: - Owner, group and file mode are set if the underlying file system on + Owner, group, and file mode are set if the underlying file system on the server supports it. - - Once all tablespaces have been sent, a final regular result set will - be sent. This result set contains the end position of the - backup, given in XLogRecPtr format as a single column in a single row. -