From 0b07cced29ef034107d81c3d4e4560f5a4819c98 Mon Sep 17 00:00:00 2001 From: Bharath Rupireddy Date: Wed, 2 Mar 2022 06:08:08 +0000 Subject: [PATCH v3] Replace log record with WAL record in docs --- doc/src/sgml/backup.sgml | 4 ++-- doc/src/sgml/ref/pg_waldump.sgml | 4 ++-- doc/src/sgml/wal.sgml | 6 +++--- 3 files changed, 7 insertions(+), 7 deletions(-) diff --git a/doc/src/sgml/backup.sgml b/doc/src/sgml/backup.sgml index 0d69851bb1..dd8640b092 100644 --- a/doc/src/sgml/backup.sgml +++ b/doc/src/sgml/backup.sgml @@ -482,8 +482,8 @@ tar -cf backup.tar /usr/local/pgsql/data At all times, PostgreSQL maintains a write ahead log (WAL) in the pg_wal/ - subdirectory of the cluster's data directory. The log records - every change made to the database's data files. This log exists + subdirectory of the cluster's data directory. The WAL records + capture every change made to the database's data files. This log exists primarily for crash-safety purposes: if the system crashes, the database can be restored to consistency by replaying the log entries made since the last checkpoint. However, the existence diff --git a/doc/src/sgml/ref/pg_waldump.sgml b/doc/src/sgml/ref/pg_waldump.sgml index 5735a161ce..8136244502 100644 --- a/doc/src/sgml/ref/pg_waldump.sgml +++ b/doc/src/sgml/ref/pg_waldump.sgml @@ -156,7 +156,7 @@ PostgreSQL documentation WAL location at which to start reading. The default is to start reading - the first valid log record found in the earliest file found. + the first valid WAL record found in the earliest file found. @@ -166,7 +166,7 @@ PostgreSQL documentation - Timeline from which to read log records. The default is to use the + Timeline from which to read WAL records. The default is to use the value in startseg, if that is specified; otherwise, the default is 1. diff --git a/doc/src/sgml/wal.sgml b/doc/src/sgml/wal.sgml index 2bb27a8468..2677996f2a 100644 --- a/doc/src/sgml/wal.sgml +++ b/doc/src/sgml/wal.sgml @@ -296,12 +296,12 @@ transaction processing. Briefly, WAL's central concept is that changes to data files (where tables and indexes reside) must be written only after those changes have been logged, - that is, after log records describing the changes have been flushed + that is, after WAL records describing the changes have been flushed to permanent storage. If we follow this procedure, we do not need to flush data pages to disk on every transaction commit, because we know that in the event of a crash we will be able to recover the database using the log: any changes that have not been applied to - the data pages can be redone from the log records. (This is + the data pages can be redone from the WAL records. (This is roll-forward recovery, also known as REDO.) @@ -838,7 +838,7 @@ segment files, normally each 16 MB in size (but the size can be changed by altering the initdb option). Each segment is divided into pages, normally 8 kB each (this size can be changed via the - configure option). The log record headers + configure option). The WAL record headers are described in access/xlogrecord.h; the record content is dependent on the type of event that is being logged. Segment files are given ever-increasing numbers as names, starting at -- 2.25.1