doc: Fix descriptions of some PGC_POSTMASTER parameters.

The following parameters can only be set at server start because
their context is PGC_POSTMASTER, but this information was missing
or incorrectly documented. This commit adds or corrects
that information for the following parameters:

* debug_io_direct
* dynamic_shared_memory_type
* event_source
* huge_pages
* io_max_combine_limit
* max_notify_queue_pages
* shared_memory_type
* track_commit_timestamp
* wal_decode_buffer_size

Backpatched to all supported branches.

Author: Karina Litskevich <litskevichkarina@gmail.com>
Reviewed-by: Chao Li <lic@highgo.com>
Reviewed-by: Fujii Masao <masao.fujii@gmail.com>
Discussion: https://postgr.es/m/CAHGQGwGfPzcin-_6XwPgVbWTOUFVZgHF5g9ROrwLUdCTfjy=0A@mail.gmail.com
Backpatch-through: 13
REL_16_STABLE
Fujii Masao 1 month ago
parent 723cc84db5
commit 9a882a5dbf
  1. 16
      doc/src/sgml/config.sgml

@ -1727,7 +1727,8 @@ include_dir 'conf.d'
<para>
Controls whether huge pages are requested for the main shared memory
area. Valid values are <literal>try</literal> (the default),
<literal>on</literal>, and <literal>off</literal>. With
<literal>on</literal>, and <literal>off</literal>.
This parameter can only be set at server start. With
<varname>huge_pages</varname> set to <literal>try</literal>, the
server will try to request huge pages, but fall back to the default if
that fails. With <literal>on</literal>, failure to request huge pages
@ -2111,6 +2112,7 @@ include_dir 'conf.d'
platform, is generally discouraged because it typically requires
non-default kernel settings to allow for large allocations (see <xref
linkend="sysvipc"/>).
This parameter can only be set at server start.
</para>
</listitem>
</varlistentry>
@ -2138,6 +2140,7 @@ include_dir 'conf.d'
however, it may be useful for debugging, when the
<literal>pg_dynshmem</literal> directory is stored on a RAM disk, or when
other shared memory facilities are not available.
This parameter can only be set at server start.
</para>
</listitem>
</varlistentry>
@ -3824,6 +3827,7 @@ include_dir 'conf.d'
blocks to prefetch. If this value is specified without units, it is
taken as bytes.
The default is 512kB.
This parameter can only be set at server start.
</para>
</listitem>
</varlistentry>
@ -4447,9 +4451,9 @@ restore_command = 'copy "C:\\server\\archivedir\\%f" "%p"' # Windows
</term>
<listitem>
<para>
Record commit time of transactions. This parameter
can only be set in <filename>postgresql.conf</filename> file or on the server
command line. The default value is <literal>off</literal>.
Record commit time of transactions.
This parameter can only be set at server start.
The default value is <literal>off</literal>.
</para>
</listitem>
</varlistentry>
@ -6658,8 +6662,7 @@ local0.* /var/log/postgresql
determines the program name used to identify
<productname>PostgreSQL</productname> messages in
the log. The default is <literal>PostgreSQL</literal>.
This parameter can only be set in the <filename>postgresql.conf</filename>
file or on the server command line.
This parameter can only be set at server start.
</para>
</listitem>
</varlistentry>
@ -11170,6 +11173,7 @@ dynamic_library_path = 'C:\tools\postgresql;H:\my_project\lib;$libdir'
main data files, <literal>wal</literal> for WAL files, and
<literal>wal_init</literal> for WAL files when being initially
allocated.
This parameter can only be set at server start.
</para>
<para>
Some operating systems and file systems do not support direct I/O, so

Loading…
Cancel
Save