agora inbox for pgsql-committers@postgresql.org  
help / color / mirror / Atom feed
From: Michael Paquier <michael@paquier.xyz>
To: pgsql-committers@lists.postgresql.org
Subject: pgsql: doc: Add new section describing fast-path locking
Date: Wed, 01 Jul 2026 01:08:50 +0000
Message-ID: <E1wejRa-000qKl-1p@gemulon.postgresql.org> (raw)

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@gmail.com>
Reviewed-by: Bertrand Drouvot <bertranddrouvot.pg@gmail.com>
Reviewed-by: Michael Paquier <michael@paquier.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(-)



Message-ID: <E1wejRa-000qKl-1p@gemulon.postgresql.org>
Permalink:  ../E1wejRa-000qKl-1p@gemulon.postgresql.org/
Also on:    postgresql.org/message-id/E1wejRa-000qKl-1p@gemulon.postgresql.org

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: pgsql-committers@postgresql.org
  Cc: michael@paquier.xyz, pgsql-committers@lists.postgresql.org
  Subject: Re: pgsql: doc: Add new section describing fast-path locking
  In-Reply-To: <E1wejRa-000qKl-1p@gemulon.postgresql.org>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox