Fix documentation for System V semaphores.
authorNathan Bossart <[email protected]>
Mon, 3 Jun 2024 17:10:43 +0000 (12:10 -0500)
committerNathan Bossart <[email protected]>
Mon, 3 Jun 2024 17:10:43 +0000 (12:10 -0500)
The formulas for SEMMNI and SEMMNS do not include the archiver
process, which was converted to an auxiliary process in v14, and
the WAL summarizer process, which was introduced in v17.  This
commit corrects these formulas and adds a missing reference to
max_wal_senders nearby.  Since this section of the documentation
tends to be incorrect quite often, we should likely give up on
documenting the exact formulas in favor of something less fragile,
but that is left as a future exercise.

Reported-by: Sami Imseih
Reviewed-by: Sami Imseih
Discussion: https://postgr.es/m/20240517164452.GA1914161%40nathanxps13
Backpatch-through: 12

doc/src/sgml/runtime.sgml

index ac4934608c3fcc6bd76b984d26a9ff86319d4cf7..2f660e288e0f258309bfa3df5729ed6c69767243 100644 (file)
@@ -812,7 +812,8 @@ psql: could not connect to server: No such file or directory
     When using System V semaphores,
     <productname>PostgreSQL</productname> uses one semaphore per allowed connection
     (<xref linkend="guc-max-connections"/>), allowed autovacuum worker process
-    (<xref linkend="guc-autovacuum-max-workers"/>) and allowed background
+    (<xref linkend="guc-autovacuum-max-workers"/>), allowed WAL sender process
+    (<xref linkend="guc-max-wal-senders"/>), and allowed background
     process (<xref linkend="guc-max-worker-processes"/>), in sets of 16.
     Each such set will
     also contain a 17th semaphore which contains a <quote>magic