pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feedKernel settings shmall
2+ messages / 2 participants
[nested] [flat]
* Kernel settings shmall
@ 2023-09-07 21:02 PG Doc comments form <noreply@postgresql.org>
2023-09-12 14:57 ` Re: Kernel settings shmall Euler Taveira <euler@eulerto.com>
0 siblings, 1 reply; 2+ messages in thread
From: PG Doc comments form @ 2023-09-07 21:02 UTC (permalink / raw)
To: pgsql-docs@lists.postgresql.org; +Cc: patribuni@gmail.com
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
^ permalink raw reply [nested|flat] 2+ messages in thread
* Re: Kernel settings shmall
2023-09-07 21:02 Kernel settings shmall PG Doc comments form <noreply@postgresql.org>
@ 2023-09-12 14:57 ` Euler Taveira <euler@eulerto.com>
0 siblings, 0 replies; 2+ messages in thread
From: Euler Taveira @ 2023-09-12 14:57 UTC (permalink / raw)
To: patribuni@gmail.com; pgsql-docs@lists.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/
^ permalink raw reply [nested|flat] 2+ messages in thread
end of thread, other threads:[~2023-09-12 14:57 UTC | newest]
Thread overview: 2+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2023-09-07 21:02 Kernel settings shmall PG Doc comments form <noreply@postgresql.org>
2023-09-12 14:57 ` Euler Taveira <euler@eulerto.com>
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