Skip to content

Commit 0d447ba

Browse files
bmomjianbmomjian
committed
docs: replace "stable storage" with "durable" in descriptions
For PG, "durable storage" has a clear meaning, while "stable storage" does not, so use the former. Discussion: https://postgr.es/m/20200817165222.GA31806@momjian.us Backpatch-through: 9.5
1 parent 2f8ea91 commit 0d447ba

File tree

2 files changed

+25
-25
lines changed

2 files changed

+25
-25
lines changed

‎doc/src/sgml/config.sgml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2610,7 +2610,7 @@ include_dir 'conf.d'
26102610
ensure data preservation even if a standby instance of
26112611
<productname>PostgreSQL</productname> were to crash, but not if the standby
26122612
suffers an operating-system-level crash, since the data has not
2613-
necessarily reached stable storage on the standby.
2613+
necessarily reached durable storage on the standby.
26142614
Finally, the setting <literal>local</literal> causes commits to wait for
26152615
local flush to disk, but not for replication. This is not usually
26162616
desirable when synchronous replication is in use, but is provided for

‎doc/src/sgml/monitoring.sgml

Lines changed: 24 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -1510,11 +1510,11 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser
15101510
</row>
15111511
<row>
15121512
<entry><literal>ControlFileSync</literal></entry>
1513-
<entry>Waiting for the control file to reach stable storage.</entry>
1513+
<entry>Waiting for the control file to reach durable storage.</entry>
15141514
</row>
15151515
<row>
15161516
<entry><literal>ControlFileSyncUpdate</literal></entry>
1517-
<entry>Waiting for an update to the control file to reach stable storage.</entry>
1517+
<entry>Waiting for an update to the control file to reach durable storage.</entry>
15181518
</row>
15191519
<row>
15201520
<entry><literal>ControlFileWrite</literal></entry>
@@ -1538,11 +1538,11 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser
15381538
</row>
15391539
<row>
15401540
<entry><literal>DataFileFlush</literal></entry>
1541-
<entry>Waiting for a relation data file to reach stable storage.</entry>
1541+
<entry>Waiting for a relation data file to reach durable storage.</entry>
15421542
</row>
15431543
<row>
15441544
<entry><literal>DataFileImmediateSync</literal></entry>
1545-
<entry>Waiting for an immediate synchronization of a relation data file to stable storage.</entry>
1545+
<entry>Waiting for an immediate synchronization of a relation data file to durable storage.</entry>
15461546
</row>
15471547
<row>
15481548
<entry><literal>DataFilePrefetch</literal></entry>
@@ -1554,7 +1554,7 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser
15541554
</row>
15551555
<row>
15561556
<entry><literal>DataFileSync</literal></entry>
1557-
<entry>Waiting for changes to a relation data file to reach stable storage.</entry>
1557+
<entry>Waiting for changes to a relation data file to reach durable storage.</entry>
15581558
</row>
15591559
<row>
15601560
<entry><literal>DataFileTruncate</literal></entry>
@@ -1574,7 +1574,7 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser
15741574
</row>
15751575
<row>
15761576
<entry><literal>LockFileAddToDataDirSync</literal></entry>
1577-
<entry>Waiting for data to reach stable storage while adding a line to the data directory lock file.</entry>
1577+
<entry>Waiting for data to reach durable storage while adding a line to the data directory lock file.</entry>
15781578
</row>
15791579
<row>
15801580
<entry><literal>LockFileAddToDataDirWrite</literal></entry>
@@ -1586,7 +1586,7 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser
15861586
</row>
15871587
<row>
15881588
<entry><literal>LockFileCreateSync</literal></entry>
1589-
<entry>Waiting for data to reach stable storage while creating the data directory lock file.</entry>
1589+
<entry>Waiting for data to reach durable storage while creating the data directory lock file.</entry>
15901590
</row>
15911591
<row>
15921592
<entry><literal>LockFileCreateWrite</literal></entry>
@@ -1598,19 +1598,19 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser
15981598
</row>
15991599
<row>
16001600
<entry><literal>LogicalRewriteCheckpointSync</literal></entry>
1601-
<entry>Waiting for logical rewrite mappings to reach stable storage during a checkpoint.</entry>
1601+
<entry>Waiting for logical rewrite mappings to reach durable storage during a checkpoint.</entry>
16021602
</row>
16031603
<row>
16041604
<entry><literal>LogicalRewriteMappingSync</literal></entry>
1605-
<entry>Waiting for mapping data to reach stable storage during a logical rewrite.</entry>
1605+
<entry>Waiting for mapping data to reach durable storage during a logical rewrite.</entry>
16061606
</row>
16071607
<row>
16081608
<entry><literal>LogicalRewriteMappingWrite</literal></entry>
16091609
<entry>Waiting for a write of mapping data during a logical rewrite.</entry>
16101610
</row>
16111611
<row>
16121612
<entry><literal>LogicalRewriteSync</literal></entry>
1613-
<entry>Waiting for logical rewrite mappings to reach stable storage.</entry>
1613+
<entry>Waiting for logical rewrite mappings to reach durable storage.</entry>
16141614
</row>
16151615
<row>
16161616
<entry><literal>LogicalRewriteTruncate</literal></entry>
@@ -1626,7 +1626,7 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser
16261626
</row>
16271627
<row>
16281628
<entry><literal>RelationMapSync</literal></entry>
1629-
<entry>Waiting for the relation map file to reach stable storage.</entry>
1629+
<entry>Waiting for the relation map file to reach durable storage.</entry>
16301630
</row>
16311631
<row>
16321632
<entry><literal>RelationMapWrite</literal></entry>
@@ -1650,27 +1650,27 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser
16501650
</row>
16511651
<row>
16521652
<entry><literal>ReplicationSlotRestoreSync</literal></entry>
1653-
<entry>Waiting for a replication slot control file to reach stable storage while restoring it to memory.</entry>
1653+
<entry>Waiting for a replication slot control file to reach durable storage while restoring it to memory.</entry>
16541654
</row>
16551655
<row>
16561656
<entry><literal>ReplicationSlotSync</literal></entry>
1657-
<entry>Waiting for a replication slot control file to reach stable storage.</entry>
1657+
<entry>Waiting for a replication slot control file to reach durable storage.</entry>
16581658
</row>
16591659
<row>
16601660
<entry><literal>ReplicationSlotWrite</literal></entry>
16611661
<entry>Waiting for a write to a replication slot control file.</entry>
16621662
</row>
16631663
<row>
16641664
<entry><literal>SLRUFlushSync</literal></entry>
1665-
<entry>Waiting for SLRU data to reach stable storage during a checkpoint or database shutdown.</entry>
1665+
<entry>Waiting for SLRU data to reach durable storage during a checkpoint or database shutdown.</entry>
16661666
</row>
16671667
<row>
16681668
<entry><literal>SLRURead</literal></entry>
16691669
<entry>Waiting for a read of an SLRU page.</entry>
16701670
</row>
16711671
<row>
16721672
<entry><literal>SLRUSync</literal></entry>
1673-
<entry>Waiting for SLRU data to reach stable storage following a page write.</entry>
1673+
<entry>Waiting for SLRU data to reach durable storage following a page write.</entry>
16741674
</row>
16751675
<row>
16761676
<entry><literal>SLRUWrite</literal></entry>
@@ -1682,15 +1682,15 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser
16821682
</row>
16831683
<row>
16841684
<entry><literal>SnapbuildSync</literal></entry>
1685-
<entry>Waiting for a serialized historical catalog snapshot to reach stable storage.</entry>
1685+
<entry>Waiting for a serialized historical catalog snapshot to reach durable storage.</entry>
16861686
</row>
16871687
<row>
16881688
<entry><literal>SnapbuildWrite</literal></entry>
16891689
<entry>Waiting for a write of a serialized historical catalog snapshot.</entry>
16901690
</row>
16911691
<row>
16921692
<entry><literal>TimelineHistoryFileSync</literal></entry>
1693-
<entry>Waiting for a timeline history file received via streaming replication to reach stable storage.</entry>
1693+
<entry>Waiting for a timeline history file received via streaming replication to reach durable storage.</entry>
16941694
</row>
16951695
<row>
16961696
<entry><literal>TimelineHistoryFileWrite</literal></entry>
@@ -1702,7 +1702,7 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser
17021702
</row>
17031703
<row>
17041704
<entry><literal>TimelineHistorySync</literal></entry>
1705-
<entry>Waiting for a newly created timeline history file to reach stable storage.</entry>
1705+
<entry>Waiting for a newly created timeline history file to reach durable storage.</entry>
17061706
</row>
17071707
<row>
17081708
<entry><literal>TimelineHistoryWrite</literal></entry>
@@ -1714,15 +1714,15 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser
17141714
</row>
17151715
<row>
17161716
<entry><literal>TwophaseFileSync</literal></entry>
1717-
<entry>Waiting for a two phase state file to reach stable storage.</entry>
1717+
<entry>Waiting for a two phase state file to reach durable storage.</entry>
17181718
</row>
17191719
<row>
17201720
<entry><literal>TwophaseFileWrite</literal></entry>
17211721
<entry>Waiting for a write of a two phase state file.</entry>
17221722
</row>
17231723
<row>
17241724
<entry><literal>WALBootstrapSync</literal></entry>
1725-
<entry>Waiting for WAL to reach stable storage during bootstrapping.</entry>
1725+
<entry>Waiting for WAL to reach durable storage during bootstrapping.</entry>
17261726
</row>
17271727
<row>
17281728
<entry><literal>WALBootstrapWrite</literal></entry>
@@ -1734,15 +1734,15 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser
17341734
</row>
17351735
<row>
17361736
<entry><literal>WALCopySync</literal></entry>
1737-
<entry>Waiting a new WAL segment created by copying an existing one to reach stable storage.</entry>
1737+
<entry>Waiting a new WAL segment created by copying an existing one to reach durable storage.</entry>
17381738
</row>
17391739
<row>
17401740
<entry><literal>WALCopyWrite</literal></entry>
17411741
<entry>Waiting for a write when creating a new WAL segment by copying an existing one.</entry>
17421742
</row>
17431743
<row>
17441744
<entry><literal>WALInitSync</literal></entry>
1745-
<entry>Waiting for a newly initialized WAL file to reach stable storage.</entry>
1745+
<entry>Waiting for a newly initialized WAL file to reach durable storage.</entry>
17461746
</row>
17471747
<row>
17481748
<entry><literal>WALInitWrite</literal></entry>
@@ -1758,11 +1758,11 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser
17581758
</row>
17591759
<row>
17601760
<entry><literal>WALSync</literal></entry>
1761-
<entry>Waiting for a WAL file to reach stable storage.</entry>
1761+
<entry>Waiting for a WAL file to reach durable storage.</entry>
17621762
</row>
17631763
<row>
17641764
<entry><literal>WALSyncMethodAssign</literal></entry>
1765-
<entry>Waiting for data to reach stable storage while assigning WAL sync method.</entry>
1765+
<entry>Waiting for data to reach durable storage while assigning WAL sync method.</entry>
17661766
</row>
17671767
<row>
17681768
<entry><literal>WALWrite</literal></entry>

0 commit comments

Comments
 (0)