pgsql: doc: Improve postgres command for shared_memory_size_in_huge_pag

From: Michael Paquier <michael(at)paquier(dot)xyz>
To: pgsql-committers(at)lists(dot)postgresql(dot)org
Subject: pgsql: doc: Improve postgres command for shared_memory_size_in_huge_pag
Date: 2022-03-24 11:59:30
Message-ID: E1nXM7l-001AFT-FS@gemulon.postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-committers

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(-)

Browse pgsql-committers by date

  From Date Subject
Next Message Peter Eisentraut 2022-03-24 13:07:48 pgsql: Remove unnecessary translator comment
Previous Message Thomas Munro 2022-03-24 08:50:03 pgsql: Add additional filtering options to pg_waldump.