Обсуждение: Kernel settings shmall

Поиск
Список
Период
Сортировка

Kernel settings shmall

От
PG Doc comments form
Дата:
The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/13/kernel-resources.html
Description:

Hi.
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
Regards.
Patrick BUNINO

Re: Kernel settings shmall

От
"Euler Taveira"
Дата:
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.



--
Euler Taveira