Re: Doc: shared_memory_size_in_huge_pages with the "SHOW" command.

From: Michael Paquier <michael(at)paquier(dot)xyz>
To: Seino Yuki <seinoyu(at)oss(dot)nttdata(dot)com>
Cc: pgsql-hackers(at)postgresql(dot)org
Subject: Re: Doc: shared_memory_size_in_huge_pages with the "SHOW" command.
Date: 2024-10-16 00:31:49
Message-ID: Zw8JdU_LzvuFZ-AG@paquier.xyz
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On Fri, Oct 11, 2024 at 05:25:04PM +0900, Seino Yuki wrote:
> Alternatively, the "SHOW" command can be used, though the documentation
> states,
> "Note that the server must be shut down to view this runtime-computed
> parameter.[1]"
> This wording could be misunderstood to imply that the parameter cannot be
> accessed
> while the server is running.

I am not sure that neither mentioning nor recommending SHOW for this
area is a good idea, the point being to encourage its use before the
server is running as we don't want to allocate anything when tuning
it.

Point taken that the current wording can be confusing because of the
"*must* be shut down". How about doing a simpler s/must/should/ for a
softer wording?
--
Michael

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Michael Paquier 2024-10-16 00:43:48 Re: BF mamba failure
Previous Message Michael Paquier 2024-10-16 00:12:31 Re: Large expressions in indexes can't be stored (non-TOASTable)