(docs): add missing info about ShareLocks

From: Alpha Shuro <alphashuro(at)gmail(dot)com>
To: pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: (docs): add missing info about ShareLocks
Date: 2025-11-22 08:07:01
Message-ID: 4274DCF3-177F-43D8-8547-90B8540B6619@gmail.com
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Hello

I had a production incident a few weeks ago while using deferred indexes, where the Postgres docs lead me down the wrong path of investigation due to missing details. Specifically, the docs implied that a `ShareLock` was only acquired when creating indexes, but only after looking at the code did I learn that this lock is also acquired when transactions are waiting for other transactions to complete. I think this would be helpful to someone who might find themselves on the same path in the future, and as I understand it this mailing list is the way to submit patches to the docs?

Attachment Content-Type Size
0001-document-ShareLock-behaviour-when-using-a-deferred-u.patch application/octet-stream 1.2 KB

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Laurenz Albe 2025-11-22 12:07:57 Re: (docs): add missing info about ShareLocks
Previous Message Daniel Gustafsson 2025-11-19 14:14:05 Re: Documentation improvement patch