diff options
author | Fujii Masao <fujii@postgresql.org> | 2020-06-03 09:59:43 +0900 |
---|---|---|
committer | Fujii Masao <fujii@postgresql.org> | 2020-06-03 10:05:30 +0900 |
commit | 43e592c706f8ce073d166f541687ad8f02dc22c0 (patch) | |
tree | ae0944570e02318cfb4e093595cb2c6215aa7612 /doc/src | |
parent | caa3c4242cf86322e2ed0c86199e6462a2c41565 (diff) | |
download | postgresql-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.sgml | 70 |
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> |