mirror of
				https://github.com/postgres/postgres.git
				synced 2025-10-29 22:49:41 +03:00 
			
		
		
		
	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
This commit is contained in:
		| @@ -2820,6 +2820,41 @@ include_dir 'conf.d' | |||||||
|       </listitem> |       </listitem> | ||||||
|      </varlistentry> |      </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"> |      <varlistentry id="guc-wal-buffers" xreflabel="wal_buffers"> | ||||||
|       <term><varname>wal_buffers</varname> (<type>integer</type>) |       <term><varname>wal_buffers</varname> (<type>integer</type>) | ||||||
|       <indexterm> |       <indexterm> | ||||||
| @@ -3752,41 +3787,6 @@ restore_command = 'copy "C:\\server\\archivedir\\%f" "%p"'  # Windows | |||||||
|        </listitem> |        </listitem> | ||||||
|       </varlistentry> |       </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"> |       <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>) |        <term><varname>max_slot_wal_keep_size</varname> (<type>integer</type>) | ||||||
|        <indexterm> |        <indexterm> | ||||||
|   | |||||||
		Reference in New Issue
	
	Block a user