From: Euler Taveira <euler@eulerto.com>
To: patribuni@gmail.com
To: pgsql-docs@lists.postgresql.org
Subject: Re: Kernel settings shmall
Date: Tue, 12 Sep 2023 11:57:49 -0300
Message-ID: <a4619fac-fdce-47f3-813e-5194e0d4c6d2@app.fastmail.com> (raw)
In-Reply-To: <169412055867.2433965.4920921275706057547@wrigleys.postgresql.org>
References: <169412055867.2433965.4920921275706057547@wrigleys.postgresql.org>
On Thu, Sep 7, 2023, at 6:02 PM, PG Doc comments form wrote:
> The kernel parameter shmall is only in pages in Linux but your documentation
> says it can also be in bytes. Maybe it's in bytes with some OS other than
> Linux but the way it is presented in table 18.1 is quite misleading.. Could
> you add "depending on the OS" or something similar ? Many colleagues using
> Linux think it can be in bytes with Linux. Could you rewrite that part ?
> Table 18.1 in chapter 18.4.1
>
The information is accurate. It says
same as SHMMAX *if* bytes, or ceil(SHMMAX/PAGE_SIZE) *if* pages
and the Linux documentation [1] says its unit is *pages*.
You can claim that you always need to check if it is pages or bytes because you
don't remember. I'm not sure if changing the order would be better because most
of the supported operating systems use pages as unit. Is there any supported OS
that still uses bytes as unit? Linux, FreeBSD, OpenBSD and macOS use pages; I'm
not sure if any of the currently supported operating system [2] uses bytes. If
not, my suggestion is to remove the "bytes" part.
[1] https://www.kernel.org/doc/Documentation/sysctl/kernel.txt
[2] https://www.postgresql.org/docs/current/supported-platforms.html
--
Euler Taveira
EDB https://www.enterprisedb.com/
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 using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: euler@eulerto.com, patribuni@gmail.com, pgsql-docs@lists.postgresql.org
Subject: Re: Kernel settings shmall
In-Reply-To: <a4619fac-fdce-47f3-813e-5194e0d4c6d2@app.fastmail.com>
* 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