1
0
mirror of https://github.com/postgres/postgres.git synced 2025-05-31 03:21:24 +03:00

Adjust documentation for configuring Linux huge pages.

The present wording about viewing shared_memory_size_in_huge_pages
seems to suggest that the parameter cannot be viewed after startup
at all, whereas the intent is to make it clear that you can't use
"postgres -C" to view this parameter while the server is running.
This commit rephrases this section to remove the ambiguity.

Author: Seino Yuki
Reviewed-by: Michael Paquier, David G. Johnston, Fujii Masao
Discussion: https://postgr.es/m/420584fd274f9ec4f337da55ffb3b790%40oss.nttdata.com
Backpatch-through: 15
This commit is contained in:
Nathan Bossart 2024-10-18 10:20:15 -05:00
parent b8d08aafc0
commit 053b6daeb9

View File

@ -1422,11 +1422,10 @@ export PG_OOM_ADJUST_VALUE=0
with <varname>CONFIG_HUGETLBFS=y</varname> and with <varname>CONFIG_HUGETLBFS=y</varname> and
<varname>CONFIG_HUGETLB_PAGE=y</varname>. You will also have to configure <varname>CONFIG_HUGETLB_PAGE=y</varname>. You will also have to configure
the operating system to provide enough huge pages of the desired size. the operating system to provide enough huge pages of the desired size.
To determine the number of huge pages needed, use the The runtime-computed parameter
<command>postgres</command> command to see the value of <xref linkend="guc-shared-memory-size-in-huge-pages"/> reports the number
<xref linkend="guc-shared-memory-size-in-huge-pages"/>. Note that the of huge pages required. This parameter can be viewed before starting the
server must be shut down to view this runtime-computed parameter. server with a <command>postgres</command> command like:
This might look like:
<programlisting> <programlisting>
$ <userinput>postgres -D $PGDATA -C shared_memory_size_in_huge_pages</userinput> $ <userinput>postgres -D $PGDATA -C shared_memory_size_in_huge_pages</userinput>
3170 3170