pgsql: doc: Improve postgres command for shared_memory_size_in_huge_pag - Mailing list pgsql-committers

From Michael Paquier
Subject pgsql: doc: Improve postgres command for shared_memory_size_in_huge_pag
Date
Msg-id E1nXM7l-001AFT-FS@gemulon.postgresql.org
Whole thread Raw
List 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(-)


pgsql-committers by date:

Previous
From: Thomas Munro
Date:
Subject: pgsql: Add additional filtering options to pg_waldump.
Next
From: Peter Eisentraut
Date:
Subject: pgsql: Remove unnecessary translator comment