summaryrefslogtreecommitdiff
path: root/doc/src
diff options
context:
space:
mode:
Diffstat (limited to 'doc/src')
-rw-r--r--doc/src/sgml/ref/initdb.sgml22
1 files changed, 14 insertions, 8 deletions
diff --git a/doc/src/sgml/ref/initdb.sgml b/doc/src/sgml/ref/initdb.sgml
index 585665f1611..949b5a220f5 100644
--- a/doc/src/sgml/ref/initdb.sgml
+++ b/doc/src/sgml/ref/initdb.sgml
@@ -316,16 +316,22 @@ PostgreSQL documentation
</varlistentry>
<varlistentry>
- <term><option>--wal-segsize=<replaceable>SEGSIZE</replaceable></option></term>
+ <term><option>--wal-segsize=<replaceable>size</replaceable></option></term>
<listitem>
<para>
- Set the <firstterm>WAL segment size</firstterm>, in megabytes. This is
- the size of each individual file in the WAL log. It may be useful
- to adjust this size to control the granularity of WAL log shipping.
- This option can only be set during initialization, and cannot be
- changed later.
- The default size is 16 megabytes.
- The value must be a power of 2 between 1 and 1024 (megabytes).
+ Set the <firstterm>WAL segment size</firstterm>, in megabytes. This
+ is the size of each individual file in the WAL log. The default size
+ is 16 megabytes. The value must be a power of 2 between 1 and 1024
+ (megabytes). This option can only be set during initialization, and
+ cannot be changed later.
+ </para>
+
+ <para>
+ It may be useful to adjust this size to control the granularity of
+ WAL log shipping or archiving. Also, in databases with a high volume
+ of WAL, the sheer number of WAL files per directory can become a
+ performance and management problem. Increasing the WAL file size
+ will reduce the number of WAL files.
</para>
</listitem>
</varlistentry>