1
0
mirror of https://github.com/postgres/postgres.git synced 2025-11-25 12:03:53 +03:00

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
This commit is contained in:
Fujii Masao
2025-11-07 14:58:53 +09:00
parent d2965f627f
commit 9326cf9ce9

View File

@@ -1658,7 +1658,8 @@ include_dir 'conf.d'
<para> <para>
Controls whether huge pages are requested for the main shared memory Controls whether huge pages are requested for the main shared memory
area. Valid values are <literal>try</literal> (the default), 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 <varname>huge_pages</varname> set to <literal>try</literal>, the
server will try to request huge pages, but fall back to the default if 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 that fails. With <literal>on</literal>, failure to request huge pages
@@ -2012,6 +2013,7 @@ include_dir 'conf.d'
platform, is generally discouraged because it typically requires platform, is generally discouraged because it typically requires
non-default kernel settings to allow for large allocations (see <xref non-default kernel settings to allow for large allocations (see <xref
linkend="sysvipc"/>). linkend="sysvipc"/>).
This parameter can only be set at server start.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@@ -2039,6 +2041,7 @@ include_dir 'conf.d'
however, it may be useful for debugging, when the however, it may be useful for debugging, when the
<literal>pg_dynshmem</literal> directory is stored on a RAM disk, or when <literal>pg_dynshmem</literal> directory is stored on a RAM disk, or when
other shared memory facilities are not available. other shared memory facilities are not available.
This parameter can only be set at server start.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@@ -4221,9 +4224,9 @@ restore_command = 'copy "C:\\server\\archivedir\\%f" "%p"' # Windows
</term> </term>
<listitem> <listitem>
<para> <para>
Record commit time of transactions. This parameter Record commit time of transactions.
can only be set in <filename>postgresql.conf</filename> file or on the server This parameter can only be set at server start.
command line. The default value is <literal>off</literal>. The default value is <literal>off</literal>.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@@ -6363,8 +6366,7 @@ local0.* /var/log/postgresql
determines the program name used to identify determines the program name used to identify
<productname>PostgreSQL</productname> messages in <productname>PostgreSQL</productname> messages in
the log. The default is <literal>PostgreSQL</literal>. the log. The default is <literal>PostgreSQL</literal>.
This parameter can only be set in the <filename>postgresql.conf</filename> This parameter can only be set at server start.
file or on the server command line.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>