From 28e6683d67a47bc602602eb7748751a5decd26a9 Mon Sep 17 00:00:00 2001
From: Fujii Masao <fujii@postgresql.org>
Date: Mon, 2 Nov 2026 08:54:39 +0900
Subject: [PATCH v1] doc: Clarify the description of postmaster.pid fields

Document the postmaster status and note that the shared memory field
is empty on Windows. Also mention the shared memory segment ID in
the pidfile.h comment.

Author: Fujii Masao <masao.fujii@gmail.com>
---
 doc/src/sgml/storage.sgml   | 4 +++-
 src/include/utils/pidfile.h | 2 +-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/doc/src/sgml/storage.sgml b/doc/src/sgml/storage.sgml
index 5612e9868a6..58f997d5da0 100644
--- a/doc/src/sgml/storage.sgml
+++ b/doc/src/sgml/storage.sgml
@@ -174,7 +174,9 @@ last started with</entry>
   Unix-domain socket directory path (could be empty),
   first valid listen_address (IP address or <literal>*</literal>, or empty if
   not listening on TCP),
-  and shared memory segment key and ID
+  shared memory segment key and ID (empty on Windows),
+  and postmaster status (<literal>starting</literal>, <literal>ready</literal>,
+  <literal>standby</literal>, or <literal>stopping</literal>)
   (this file is not present after server shutdown)</entry>
 </row>
 
diff --git a/src/include/utils/pidfile.h b/src/include/utils/pidfile.h
index 82b4c1990c9..825e51adb74 100644
--- a/src/include/utils/pidfile.h
+++ b/src/include/utils/pidfile.h
@@ -23,7 +23,7 @@
  *		4	port number
  *		5	first Unix socket directory path (empty if none)
  *		6	first listen_address (IP address or "*"; empty if no TCP port)
- *		7	shared memory key (empty on Windows)
+ *		7	shared memory key and ID (empty on Windows)
  *		8	postmaster status (see values below)
  *
  * Lines 6 and up are added via AddToDataDirLockFile() after initial file
-- 
2.56.0