aboutsummaryrefslogtreecommitdiff
path: root/doc/src
diff options
context:
space:
mode:
authorFujii Masao <fujii@postgresql.org>2020-06-03 09:59:43 +0900
committerFujii Masao <fujii@postgresql.org>2020-06-03 10:05:30 +0900
commit43e592c706f8ce073d166f541687ad8f02dc22c0 (patch)
treeae0944570e02318cfb4e093595cb2c6215aa7612 /doc/src
parentcaa3c4242cf86322e2ed0c86199e6462a2c41565 (diff)
downloadpostgresql-43e592c706f8ce073d166f541687ad8f02dc22c0.tar.gz
postgresql-43e592c706f8ce073d166f541687ad8f02dc22c0.zip
doc: Move wal_init_zero and wal_recycle descriptions to proper section.
The group of wal_init_zero and wal_recycle is WAL_SETTINGS in guc.c, but previously their documents were located in "Replication"/"Sending Servers" section. This commit moves them to the proper section "Write Ahead Log"/"Settings". Back-patch to v12 where wal_init_zero and wal_recycle parameters were introduced. Author: Fujii Masao Discussion: https://postgr.es/m/b5190ab4-a169-6a42-0e49-aed0807c8976@oss.nttdata.com
Diffstat (limited to 'doc/src')
-rw-r--r--doc/src/sgml/config.sgml70
1 files changed, 35 insertions, 35 deletions
diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml
index 4eef970d416..31b46601609 100644
--- a/doc/src/sgml/config.sgml
+++ b/doc/src/sgml/config.sgml
@@ -2820,6 +2820,41 @@ include_dir 'conf.d'
</listitem>
</varlistentry>
+ <varlistentry id="guc-wal-init-zero" xreflabel="wal_init_zero">
+ <term><varname>wal_init_zero</varname> (<type>boolean</type>)
+ <indexterm>
+ <primary><varname>wal_init_zero</varname> configuration parameter</primary>
+ </indexterm>
+ </term>
+ <listitem>
+ <para>
+ If set to <literal>on</literal> (the default), this option causes new
+ WAL files to be filled with zeroes. On some file systems, this ensures
+ that space is allocated before we need to write WAL records. However,
+ <firstterm>Copy-On-Write</firstterm> (COW) file systems may not benefit
+ from this technique, so the option is given to skip the unnecessary
+ work. If set to <literal>off</literal>, only the final byte is written
+ when the file is created so that it has the expected size.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="guc-wal-recycle" xreflabel="wal_recycle">
+ <term><varname>wal_recycle</varname> (<type>boolean</type>)
+ <indexterm>
+ <primary><varname>wal_recycle</varname> configuration parameter</primary>
+ </indexterm>
+ </term>
+ <listitem>
+ <para>
+ If set to <literal>on</literal> (the default), this option causes WAL
+ files to be recycled by renaming them, avoiding the need to create new
+ ones. On COW file systems, it may be faster to create new ones, so the
+ option is given to disable this behavior.
+ </para>
+ </listitem>
+ </varlistentry>
+
<varlistentry id="guc-wal-buffers" xreflabel="wal_buffers">
<term><varname>wal_buffers</varname> (<type>integer</type>)
<indexterm>
@@ -3752,41 +3787,6 @@ restore_command = 'copy "C:\\server\\archivedir\\%f" "%p"' # Windows
</listitem>
</varlistentry>
- <varlistentry id="guc-wal-init-zero" xreflabel="wal_init_zero">
- <term><varname>wal_init_zero</varname> (<type>boolean</type>)
- <indexterm>
- <primary><varname>wal_init_zero</varname> configuration parameter</primary>
- </indexterm>
- </term>
- <listitem>
- <para>
- If set to <literal>on</literal> (the default), this option causes new
- WAL files to be filled with zeroes. On some file systems, this ensures
- that space is allocated before we need to write WAL records. However,
- <firstterm>Copy-On-Write</firstterm> (COW) file systems may not benefit
- from this technique, so the option is given to skip the unnecessary
- work. If set to <literal>off</literal>, only the final byte is written
- when the file is created so that it has the expected size.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="guc-wal-recycle" xreflabel="wal_recycle">
- <term><varname>wal_recycle</varname> (<type>boolean</type>)
- <indexterm>
- <primary><varname>wal_recycle</varname> configuration parameter</primary>
- </indexterm>
- </term>
- <listitem>
- <para>
- If set to <literal>on</literal> (the default), this option causes WAL
- files to be recycled by renaming them, avoiding the need to create new
- ones. On COW file systems, it may be faster to create new ones, so the
- option is given to disable this behavior.
- </para>
- </listitem>
- </varlistentry>
-
<varlistentry id="guc-max-slot-wal-keep-size" xreflabel="max_slot_wal_keep_size">
<term><varname>max_slot_wal_keep_size</varname> (<type>integer</type>)
<indexterm>