pgsql: doc: Add new section describing fast-path locking

From: Michael Paquier <michael(at)paquier(dot)xyz>
To: pgsql-committers(at)lists(dot)postgresql(dot)org
Subject: pgsql: doc: Add new section describing fast-path locking
Date: 2026-07-01 01:08:50
Message-ID: E1wejRa-000qKl-1p@gemulon.postgresql.org
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-committers

doc: Add new section describing fast-path locking

Fast-path locking is referenced by pg_stat_lock.fastpath_exceeded, by
pg_locks.fastpath, and in the GUC max_locks_per_transaction. However,
the documentation has never described in details how this works; one
would need to look at the internals of lock.c, mostly around
EligibleForRelationFastPath().

This commit adds a new subsection called "Fast-Path Locking" to the area
dedicated to locks, with the three places mentioned above linking to it.

Author: Tatsuya Kawata <kawatatatsuya0913(at)gmail(dot)com>
Reviewed-by: Bertrand Drouvot <bertranddrouvot(dot)pg(at)gmail(dot)com>
Reviewed-by: Michael Paquier <michael(at)paquier(dot)xyz>
Discussion: https://postgr.es/m/CAHza6qdKo9dcPy70QBi88vpqhS2gYWViS8=Uj=-+QQbR=ONgSQ@mail.gmail.com

Branch
------
master

Details
-------
https://git.postgresql.org/pg/commitdiff/2d31da527169fb54916d7435629c04a7b7bbda1d

Modified Files
--------------
doc/src/sgml/config.sgml | 6 ++++++
doc/src/sgml/monitoring.sgml | 3 +++
doc/src/sgml/mvcc.sgml | 38 ++++++++++++++++++++++++++++++++++++++
doc/src/sgml/system-views.sgml | 5 +++--
4 files changed, 50 insertions(+), 2 deletions(-)

Browse pgsql-committers by date

  From Date Subject
Next Message John Naylor 2026-07-01 02:17:02 pgsql: Document wal_compression=on
Previous Message Thomas Munro 2026-06-30 23:47:43 pgsql: Remove radius from initdb authentication methods.