pg.ddx.io  pgsql-committers@postgresql.org mailing list archive  
help / color / mirror / Atom feed
From: Michael Paquier <michael@paquier.xyz>
To: pgsql-committers@lists.postgresql.org
Subject: pgsql: doc: Improve postgres command for shared_memory_size_in_huge_pag
Date: Thu, 24 Mar 2022 11:59:30 +0000
Message-ID: <E1nXM7l-001AFT-FS@gemulon.postgresql.org> (raw)

doc: Improve postgres command for shared_memory_size_in_huge_pages

The command used in the documentation to retrieve the value of the
runtime-computed GUC shared_memory_size_in_huge_pages would also show to
the user all the log messages generated by the postmaster before and
after printing the wanted value.  This can be confusing, as the wanted
result could be masked with a lot of noise.

One way to avoid those log messages is to use something like "-c
log_min_messages=fatal" in the command (my idea, but that's not common
knowledge).  Rather than mentioning this option, suffix the command with
a redirection of stderr to /dev/null, which is the stream location where
the logs show up.  This is enough to show only the GUC value to the
user when copy-pasting the command.

Reported-by: Magnus Hagander
Author: Nathan Bossart
Discussion: https://postgr.es/m/20220314173417.GA1020555@nathanxps13

Branch
------
master

Details
-------
https://git.postgresql.org/pg/commitdiff/bbd4951b73ec5ba4356133140da19cf378a796fd

Modified Files
--------------
doc/src/sgml/runtime.sgml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)



Message-ID: <E1nXM7l-001AFT-FS@gemulon.postgresql.org>
Permalink:  ../E1nXM7l-001AFT-FS@gemulon.postgresql.org/
Also on:    postgresql.org/message-id/E1nXM7l-001AFT-FS@gemulon.postgresql.org

 · 

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients from your mail client; the link fills in
  the headers below: reply via email
  Some clients, webmail especially, drop In-Reply-To and References from
  a link, and the reply then starts a new thread: use the mbox below.

  To: pgsql-committers@postgresql.org
  Cc: michael@paquier.xyz
  Subject: Re: pgsql: doc: Improve postgres command for shared_memory_size_in_huge_pag
  In-Reply-To: <E1nXM7l-001AFT-FS@gemulon.postgresql.org>
  References: <E1nXM7l-001AFT-FS@gemulon.postgresql.org>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox