Skip to content

Commit 9a882a5

Browse files
committed
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
1 parent 723cc84 commit 9a882a5

File tree

1 file changed

+10
-6
lines changed

1 file changed

+10
-6
lines changed

doc/src/sgml/config.sgml

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1727,7 +1727,8 @@ include_dir 'conf.d'
17271727
<para>
17281728
Controls whether huge pages are requested for the main shared memory
17291729
area. Valid values are <literal>try</literal> (the default),
1730-
<literal>on</literal>, and <literal>off</literal>. With
1730+
<literal>on</literal>, and <literal>off</literal>.
1731+
This parameter can only be set at server start. With
17311732
<varname>huge_pages</varname> set to <literal>try</literal>, the
17321733
server will try to request huge pages, but fall back to the default if
17331734
that fails. With <literal>on</literal>, failure to request huge pages
@@ -2111,6 +2112,7 @@ include_dir 'conf.d'
21112112
platform, is generally discouraged because it typically requires
21122113
non-default kernel settings to allow for large allocations (see <xref
21132114
linkend="sysvipc"/>).
2115+
This parameter can only be set at server start.
21142116
</para>
21152117
</listitem>
21162118
</varlistentry>
@@ -2138,6 +2140,7 @@ include_dir 'conf.d'
21382140
however, it may be useful for debugging, when the
21392141
<literal>pg_dynshmem</literal> directory is stored on a RAM disk, or when
21402142
other shared memory facilities are not available.
2143+
This parameter can only be set at server start.
21412144
</para>
21422145
</listitem>
21432146
</varlistentry>
@@ -3824,6 +3827,7 @@ include_dir 'conf.d'
38243827
blocks to prefetch. If this value is specified without units, it is
38253828
taken as bytes.
38263829
The default is 512kB.
3830+
This parameter can only be set at server start.
38273831
</para>
38283832
</listitem>
38293833
</varlistentry>
@@ -4447,9 +4451,9 @@ restore_command = 'copy "C:\\server\\archivedir\\%f" "%p"' # Windows
44474451
</term>
44484452
<listitem>
44494453
<para>
4450-
Record commit time of transactions. This parameter
4451-
can only be set in <filename>postgresql.conf</filename> file or on the server
4452-
command line. The default value is <literal>off</literal>.
4454+
Record commit time of transactions.
4455+
This parameter can only be set at server start.
4456+
The default value is <literal>off</literal>.
44534457
</para>
44544458
</listitem>
44554459
</varlistentry>
@@ -6658,8 +6662,7 @@ local0.* /var/log/postgresql
66586662
determines the program name used to identify
66596663
<productname>PostgreSQL</productname> messages in
66606664
the log. The default is <literal>PostgreSQL</literal>.
6661-
This parameter can only be set in the <filename>postgresql.conf</filename>
6662-
file or on the server command line.
6665+
This parameter can only be set at server start.
66636666
</para>
66646667
</listitem>
66656668
</varlistentry>
@@ -11170,6 +11173,7 @@ dynamic_library_path = 'C:\tools\postgresql;H:\my_project\lib;$libdir'
1117011173
main data files, <literal>wal</literal> for WAL files, and
1117111174
<literal>wal_init</literal> for WAL files when being initially
1117211175
allocated.
11176+
This parameter can only be set at server start.
1117311177
</para>
1117411178
<para>
1117511179
Some operating systems and file systems do not support direct I/O, so

0 commit comments

Comments
 (0)