Skip to content

Commit d496a65

Browse files
committed
Standardize "WAL location" terminology
Other previously used terms were "WAL position" or "log position".
1 parent c1a7f64 commit d496a65

File tree

19 files changed

+62
-62
lines changed

19 files changed

+62
-62
lines changed

doc/src/sgml/config.sgml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3312,7 +3312,7 @@ ANY <replaceable class="parameter">num_sync</replaceable> ( <replaceable class="
33123312
to the primary or upstream standby, where it can be seen using the
33133313
<link linkend="monitoring-stats-views-table">
33143314
<literal>pg_stat_replication</></link> view. The standby will report
3315-
the last write-ahead log position it has written, the last position it
3315+
the last write-ahead log location it has written, the last position it
33163316
has flushed to disk, and the last position it has applied.
33173317
This parameter's
33183318
value is the maximum interval, in seconds, between reports. Updates are

doc/src/sgml/datatype.sgml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4635,7 +4635,7 @@ SELECT * FROM pg_attribute
46354635
standard comparison operators, like <literal>=</literal> and
46364636
<literal>&gt;</literal>. Two LSNs can be subtracted using the
46374637
<literal>-</literal> operator; the result is the number of bytes separating
4638-
those write-ahead log positions.
4638+
those write-ahead log locations.
46394639
</para>
46404640
</sect1>
46414641

doc/src/sgml/logicaldecoding.sgml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -632,7 +632,7 @@ typedef void (*LogicalDecodeMessageCB) (struct LogicalDecodingContext *ctx,
632632
its XID. Note however that it can be NULL when the message is
633633
non-transactional and the XID was not assigned yet in the transaction
634634
which logged the message. The <parameter>lsn</parameter> has WAL
635-
position of the message. The <parameter>transactional</parameter> says
635+
location of the message. The <parameter>transactional</parameter> says
636636
if the message was sent as transactional or not.
637637
The <parameter>prefix</parameter> is arbitrary null-terminated prefix
638638
which can be used for identifying interesting messages for the current

doc/src/sgml/monitoring.sgml

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1829,7 +1829,7 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i
18291829
being generated, but would differ when the sender becomes idle. In
18301830
particular, when the standby has caught up completely,
18311831
<structname>pg_stat_replication</structname> shows the time taken to
1832-
write, flush and replay the most recent reported WAL position rather than
1832+
write, flush and replay the most recent reported WAL location rather than
18331833
zero as some users might expect. This is consistent with the goal of
18341834
measuring synchronous commit and transaction visibility delays for
18351835
recent write transactions.
@@ -1865,7 +1865,7 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i
18651865
<row>
18661866
<entry><structfield>receive_start_lsn</></entry>
18671867
<entry><type>pg_lsn</></entry>
1868-
<entry>First write-ahead log position used when WAL receiver is
1868+
<entry>First write-ahead log location used when WAL receiver is
18691869
started</entry>
18701870
</row>
18711871
<row>
@@ -1876,16 +1876,16 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i
18761876
<row>
18771877
<entry><structfield>received_lsn</></entry>
18781878
<entry><type>pg_lsn</></entry>
1879-
<entry>Last write-ahead log position already received and flushed to
1880-
disk, the initial value of this field being the first log position used
1879+
<entry>Last write-ahead log location already received and flushed to
1880+
disk, the initial value of this field being the first log location used
18811881
when WAL receiver is started</entry>
18821882
</row>
18831883
<row>
18841884
<entry><structfield>received_tli</></entry>
18851885
<entry><type>integer</></entry>
1886-
<entry>Timeline number of last write-ahead log position received and
1886+
<entry>Timeline number of last write-ahead log location received and
18871887
flushed to disk, the initial value of this field being the timeline
1888-
number of the first log position used when WAL receiver is started
1888+
number of the first log location used when WAL receiver is started
18891889
</entry>
18901890
</row>
18911891
<row>
@@ -1901,12 +1901,12 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i
19011901
<row>
19021902
<entry><structfield>latest_end_lsn</></entry>
19031903
<entry><type>pg_lsn</></entry>
1904-
<entry>Last write-ahead log position reported to origin WAL sender</entry>
1904+
<entry>Last write-ahead log location reported to origin WAL sender</entry>
19051905
</row>
19061906
<row>
19071907
<entry><structfield>latest_end_time</></entry>
19081908
<entry><type>timestamp with time zone</></entry>
1909-
<entry>Time of last write-ahead log position reported to origin WAL sender</entry>
1909+
<entry>Time of last write-ahead log location reported to origin WAL sender</entry>
19101910
</row>
19111911
<row>
19121912
<entry><structfield>slot_name</></entry>
@@ -1967,7 +1967,7 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i
19671967
<row>
19681968
<entry><structfield>received_lsn</></entry>
19691969
<entry><type>pg_lsn</></entry>
1970-
<entry>Last write-ahead log position received, the initial value of
1970+
<entry>Last write-ahead log location received, the initial value of
19711971
this field being 0</entry>
19721972
</row>
19731973
<row>
@@ -1984,13 +1984,13 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i
19841984
<row>
19851985
<entry><structfield>latest_end_lsn</></entry>
19861986
<entry><type>pg_lsn</></entry>
1987-
<entry>Last write-ahead log position reported to origin WAL sender
1987+
<entry>Last write-ahead log location reported to origin WAL sender
19881988
</entry>
19891989
</row>
19901990
<row>
19911991
<entry><structfield>latest_end_time</></entry>
19921992
<entry><type>timestamp with time zone</></entry>
1993-
<entry>Time of last write-ahead log position reported to origin WAL
1993+
<entry>Time of last write-ahead log location reported to origin WAL
19941994
sender</entry>
19951995
</row>
19961996
</tbody>

doc/src/sgml/protocol.sgml

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1724,7 +1724,7 @@ The commands accepted in walsender mode are:
17241724
<term><literal>consistent_point</literal> (<type>text</type>)</term>
17251725
<listitem>
17261726
<para>
1727-
The WAL position at which the slot became consistent. This is the
1727+
The WAL location at which the slot became consistent. This is the
17281728
earliest location from which streaming can start on this replication
17291729
slot.
17301730
</para>
@@ -1764,7 +1764,7 @@ The commands accepted in walsender mode are:
17641764
<listitem>
17651765
<para>
17661766
Instructs server to start streaming WAL, starting at
1767-
WAL position <replaceable class="parameter">XXX/XXX</>.
1767+
WAL location <replaceable class="parameter">XXX/XXX</>.
17681768
If <literal>TIMELINE</literal> option is specified,
17691769
streaming starts on timeline <replaceable class="parameter">tli</>;
17701770
otherwise, the server's current timeline is selected. The server can
@@ -1796,7 +1796,7 @@ The commands accepted in walsender mode are:
17961796
acknowledges this by also exiting COPY mode, the server sends a result
17971797
set with one row and two columns, indicating the next timeline in this
17981798
server's history. The first column is the next timeline's ID (type <type>int8</type>), and the
1799-
second column is the WAL position where the switch happened (type <type>text</type>). Usually,
1799+
second column is the WAL location where the switch happened (type <type>text</type>). Usually,
18001800
the switch position is the end of the WAL that was streamed, but there
18011801
are corner cases where the server can send some WAL from the old
18021802
timeline that it has not itself replayed before promoting. Finally, the
@@ -2115,7 +2115,7 @@ The commands accepted in walsender mode are:
21152115
<listitem>
21162116
<para>
21172117
Instructs server to start streaming WAL for logical replication, starting
2118-
at WAL position <replaceable class="parameter">XXX/XXX</>. The server can
2118+
at WAL location <replaceable class="parameter">XXX/XXX</>. The server can
21192119
reply with an error, for example if the requested section of WAL has already
21202120
been recycled. On success, server responds with a CopyBothResponse
21212121
message, and then starts to stream WAL to the frontend.
@@ -2147,7 +2147,7 @@ The commands accepted in walsender mode are:
21472147
<term><replaceable class="parameter">XXX/XXX</></term>
21482148
<listitem>
21492149
<para>
2150-
The WAL position to begin streaming at.
2150+
The WAL location to begin streaming at.
21512151
</para>
21522152
</listitem>
21532153
</varlistentry>

doc/src/sgml/ref/pg_waldump.sgml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -85,7 +85,7 @@ PostgreSQL documentation
8585
<term><option>--end=<replaceable>end</replaceable></option></term>
8686
<listitem>
8787
<para>
88-
Stop reading at the specified log position, instead of reading to the
88+
Stop reading at the specified WAL location, instead of reading to the
8989
end of the log stream.
9090
</para>
9191
</listitem>
@@ -144,7 +144,7 @@ PostgreSQL documentation
144144
<term><option>--start=<replaceable>start</replaceable></option></term>
145145
<listitem>
146146
<para>
147-
Log position at which to start reading. The default is to start reading
147+
WAL location at which to start reading. The default is to start reading
148148
the first valid log record found in the earliest file found.
149149
</para>
150150
</listitem>

doc/src/sgml/wal.sgml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -791,7 +791,7 @@
791791
<filename>pg_control</filename>. Therefore, at the start of recovery,
792792
the server first reads <filename>pg_control</filename> and
793793
then the checkpoint record; then it performs the REDO operation by
794-
scanning forward from the log position indicated in the checkpoint
794+
scanning forward from the log location indicated in the checkpoint
795795
record. Because the entire content of data pages is saved in the
796796
log on the first page modification after a checkpoint (assuming
797797
<xref linkend="guc-full-page-writes"> is not disabled), all pages

src/backend/access/transam/recovery.conf.sample

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,7 @@
6767
# must set a recovery target.
6868
#
6969
# You may set a recovery target either by transactionId, by name,
70-
# by timestamp or by WAL position (LSN). Recovery may either include or
70+
# by timestamp or by WAL location (LSN). Recovery may either include or
7171
# exclude the transaction(s) with the recovery target value (ie, stop either
7272
# just after or just before the given target, respectively).
7373
#

src/backend/access/transam/timeline.c

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@
1515
* <parentTLI> <switchpoint> <reason>
1616
*
1717
* parentTLI ID of the parent timeline
18-
* switchpoint XLogRecPtr of the WAL position where the switch happened
18+
* switchpoint XLogRecPtr of the WAL location where the switch happened
1919
* reason human-readable explanation of why the timeline was changed
2020
*
2121
* The fields are separated by tabs. Lines beginning with # are comments, and
@@ -278,7 +278,7 @@ findNewestTimeLine(TimeLineID startTLI)
278278
*
279279
* newTLI: ID of the new timeline
280280
* parentTLI: ID of its immediate parent
281-
* switchpoint: XLOG position where the system switched to the new timeline
281+
* switchpoint: WAL location where the system switched to the new timeline
282282
* reason: human-readable explanation of why the timeline was switched
283283
*
284284
* Currently this is only used at the end recovery, and so there are no locking

src/backend/access/transam/twophase.c

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2294,7 +2294,7 @@ RecordTransactionAbortPrepared(TransactionId xid,
22942294
*
22952295
* Store pointers to the start/end of the WAL record along with the xid in
22962296
* a gxact entry in shared memory TwoPhaseState structure. If caller
2297-
* specifies InvalidXLogRecPtr as WAL position to fetch the two-phase
2297+
* specifies InvalidXLogRecPtr as WAL location to fetch the two-phase
22982298
* data, the entry is marked as located on disk.
22992299
*/
23002300
void

0 commit comments

Comments
 (0)