postmaster.pid also contains shared memory key
The following documentation comment has been logged on the website:
Page: https://www.postgresql.org/docs/18/storage-file-layout.html
Description:
On this page, postmaster.pid is said to contain "shared memory segment ID".
It would be better to say "shared memory segment key and ID". The second
last line has two numbers, which are the shared memory segment key (in
decimal instead of hex) and ID, respectively. This can be verified with
`ipcs -m'. If you only say "ID", readers may ask, Which one is the ID?
On Tue, Oct 27, 2026 at 08:56:24PM +0000, PG Doc comments form wrote:
On this page, postmaster.pid is said to contain "shared memory segment ID".
It would be better to say "shared memory segment key and ID". The second
last line has two numbers, which are the shared memory segment key (in
decimal instead of hex) and ID, respectively. This can be verified with
`ipcs -m'. If you only say "ID", readers may ask, Which one is the ID?
Would you like to write a patch?
--
Michael
Hi Michael,
The proposed change is too trivial. I just want to inform the documentation team. Most readers won't care anyway. Thank you!
Yong Huang
On Friday, October 30, 2026 at 07:21:41 PM CDT, Michael Paquier <michael@paquier.xyz> wrote:
On Tue, Oct 27, 2026 at 08:56:24PM +0000, PG Doc comments form wrote:
On this page, postmaster.pid is said to contain "shared memory segment ID".
It would be better to say "shared memory segment key and ID". The second
last line has two numbers, which are the shared memory segment key (in
decimal instead of hex) and ID, respectively. This can be verified with
`ipcs -m'. If you only say "ID", readers may ask, Which one is the ID?
Would you like to write a patch?
--
Michael
On Sun, 2026-11-01 at 01:56 +0000, Yong Huang wrote:
On Friday, October 30, 2026 at 07:21:41 PM CDT, Michael Paquier <michael@paquier.xyz> wrote:
On Tue, Oct 27, 2026 at 08:56:24PM +0000, PG Doc comments form wrote:
On this page, postmaster.pid is said to contain "shared memory segment ID".
It would be better to say "shared memory segment key and ID". The second
last line has two numbers, which are the shared memory segment key (in
decimal instead of hex) and ID, respectively. This can be verified with
`ipcs -m'. If you only say "ID", readers may ask, Which one is the ID?Would you like to write a patch?
The proposed change is too trivial. I just want to inform the documentation team.
Most readers won't care anyway. Thank you!
Nothing is too trivial. I do care - here is a patch.
Yours,
Laurenz Albe
On 1 Nov 2026, at 13:44, Laurenz Albe <laurenz.albe@cybertec.at> wrote:
On Sun, 2026-11-01 at 01:56 +0000, Yong Huang wrote:
On Friday, October 30, 2026 at 07:21:41 PM CDT, Michael Paquier <michael@paquier.xyz> wrote:
On Tue, Oct 27, 2026 at 08:56:24PM +0000, PG Doc comments form wrote:
On this page, postmaster.pid is said to contain "shared memory segment ID".
It would be better to say "shared memory segment key and ID". The second
last line has two numbers, which are the shared memory segment key (in
decimal instead of hex) and ID, respectively. This can be verified with
`ipcs -m'. If you only say "ID", readers may ask, Which one is the ID?Would you like to write a patch?
The proposed change is too trivial. I just want to inform the documentation team.
Most readers won't care anyway. Thank you!Nothing is too trivial. I do care - here is a patch.
Pushed, thanks.
--
Daniel Gustafsson
On Mon, Nov 2, 2026 at 4:16 AM Daniel Gustafsson <daniel@yesql.se> wrote:
Pushed, thanks.
Thanks for working on this!
I think it's better to also clarify the postmaster status and note that
the shared memory field is empty on Windows. Attached is a follow-up
patch documenting both and adding the segment ID to the pidfile.h comment.
Thought?
Regards,
--
Fujii Masao
On Mon, 2026-11-02 at 09:21 +0900, Fujii Masao wrote:
On Mon, Nov 2, 2026 at 4:16 AM Daniel Gustafsson <daniel@yesql.se> wrote:
Pushed, thanks.
Thanks for working on this!
I think it's better to also clarify the postmaster status and note that
the shared memory field is empty on Windows. Attached is a follow-up
patch documenting both and adding the segment ID to the pidfile.h comment.
Thought?
I think that your patch is a clear improvement.
Yours,
Laurenz Albe