]> git.ipfire.org Git - thirdparty/postgresql.git/commit
Add GetNamedDSA() and GetNamedDSHash().
authorNathan Bossart <nathan@postgresql.org>
Wed, 2 Jul 2025 16:50:52 +0000 (11:50 -0500)
committerNathan Bossart <nathan@postgresql.org>
Wed, 2 Jul 2025 16:50:52 +0000 (11:50 -0500)
commitfe07100e82b096d3c848cace790d4b4daf0c4131
tree5684591e3eb04ea7234f9868d344587d0e2c942d
parent9ca30a0b04d751c58d4efa0a2b3073cb285b1bd2
Add GetNamedDSA() and GetNamedDSHash().

Presently, the dynamic shared memory (DSM) registry only provides
GetNamedDSMSegment(), which allocates a fixed-size segment.  To use
the DSM registry for more sophisticated things like dynamic shared
memory areas (DSAs) or a hash table backed by a DSA (dshash), users
need to create a DSM segment that stores various handles and LWLock
tranche IDs and to write fairly complicated initialization code.
Furthermore, there is likely little variation in this
initialization code between libraries.

This commit introduces functions that simplify allocating a DSA or
dshash within the DSM registry.  These functions are very similar
to GetNamedDSMSegment().  Notable differences include the lack of
an initialization callback parameter and the prohibition of calling
the functions more than once for a given entry in each backend
(which should be trivially avoidable in most circumstances).  While
at it, this commit bumps the maximum DSM registry entry name length
from 63 bytes to 127 bytes.

Also note that even though one could presumably detach/destroy the
DSAs and dshashes created in the registry, such use-cases are not
yet well-supported, if for no other reason than the associated DSM
registry entries cannot be removed.  Adding such support is left as
a future exercise.

The test_dsm_registry test module contains tests for the new
functions and also serves as a complete usage example.

Reviewed-by: Dagfinn Ilmari Mannsåker <ilmari@ilmari.org>
Reviewed-by: Sami Imseih <samimseih@gmail.com>
Reviewed-by: Florents Tselai <florents.tselai@gmail.com>
Reviewed-by: Rahila Syed <rahilasyed90@gmail.com>
Discussion: https://postgr.es/m/aEC8HGy2tRQjZg_8%40nathan
src/backend/storage/ipc/dsm_registry.c
src/backend/utils/mmgr/dsa.c
src/include/storage/dsm_registry.h
src/include/utils/dsa.h
src/test/modules/test_dsm_registry/expected/test_dsm_registry.out
src/test/modules/test_dsm_registry/sql/test_dsm_registry.sql
src/test/modules/test_dsm_registry/test_dsm_registry--1.0.sql
src/test/modules/test_dsm_registry/test_dsm_registry.c
src/tools/pgindent/typedefs.list