From 43e592c706f8ce073d166f541687ad8f02dc22c0 Mon Sep 17 00:00:00 2001 From: Fujii Masao Date: Wed, 3 Jun 2020 09:59:43 +0900 Subject: [PATCH] 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 --- doc/src/sgml/config.sgml | 70 ++++++++++++++++++++-------------------- 1 file changed, 35 insertions(+), 35 deletions(-) diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml index 4eef970d41..31b4660160 100644 --- a/doc/src/sgml/config.sgml +++ b/doc/src/sgml/config.sgml @@ -2820,6 +2820,41 @@ include_dir 'conf.d' + + wal_init_zero (boolean) + + wal_init_zero configuration parameter + + + + + If set to on (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, + Copy-On-Write (COW) file systems may not benefit + from this technique, so the option is given to skip the unnecessary + work. If set to off, only the final byte is written + when the file is created so that it has the expected size. + + + + + + wal_recycle (boolean) + + wal_recycle configuration parameter + + + + + If set to on (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. + + + + wal_buffers (integer) @@ -3752,41 +3787,6 @@ restore_command = 'copy "C:\\server\\archivedir\\%f" "%p"' # Windows - - wal_init_zero (boolean) - - wal_init_zero configuration parameter - - - - - If set to on (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, - Copy-On-Write (COW) file systems may not benefit - from this technique, so the option is given to skip the unnecessary - work. If set to off, only the final byte is written - when the file is created so that it has the expected size. - - - - - - wal_recycle (boolean) - - wal_recycle configuration parameter - - - - - If set to on (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. - - - - max_slot_wal_keep_size (integer)