Rename some shared memory initialization routines
authorHeikki Linnakangas <[email protected]>
Thu, 29 Aug 2024 06:46:21 +0000 (09:46 +0300)
committerHeikki Linnakangas <[email protected]>
Thu, 29 Aug 2024 06:46:21 +0000 (09:46 +0300)
To make them follow the usual naming convention where
FoobarShmemSize() calculates the amount of shared memory needed by
Foobar subsystem, and FoobarShmemInit() performs the initialization.

I didn't rename CreateLWLocks() and InitShmmeIndex(), because they are
a little special. They need to be called before any of the other
ShmemInit() functions, because they set up the shared memory
bookkeeping itself. I also didn't rename InitProcGlobal(), because
unlike other Shmeminit functions, it's not called by individual
backends.

Reviewed-by: Andreas Karlsson
Discussion: https://www.postgresql.org/message-id/c09694ff-2453-47e5-b26c-32a16cd75ce6@iki.fi

14 files changed:
src/backend/storage/buffer/buf_init.c
src/backend/storage/buffer/bufmgr.c
src/backend/storage/buffer/freelist.c
src/backend/storage/ipc/ipci.c
src/backend/storage/ipc/procarray.c
src/backend/storage/ipc/sinvaladt.c
src/backend/storage/lmgr/predicate.c
src/backend/utils/activity/backend_status.c
src/backend/utils/init/postinit.c
src/include/storage/bufmgr.h
src/include/storage/predicate.h
src/include/storage/procarray.h
src/include/storage/sinvaladt.h
src/include/utils/backend_status.h

index 46116a1f64be10d98f71fa7912f84258dc5dcd54..09bec6449b6d920ed5cd87991f4e6b3332bce9c0 100644 (file)
@@ -65,7 +65,7 @@ CkptSortItem *CkptBufferIds;
  * postmaster, or in a standalone backend).
  */
 void
-InitBufferPool(void)
+BufferManagerShmemInit(void)
 {
    bool        foundBufs,
                foundDescs,
@@ -151,13 +151,13 @@ InitBufferPool(void)
 }
 
 /*
- * BufferShmemSize
+ * BufferManagerShmemSize
  *
  * compute the size of shared memory for the buffer pool including
  * data pages, buffer descriptors, hash tables, etc.
  */
 Size
-BufferShmemSize(void)
+BufferManagerShmemSize(void)
 {
    Size        size = 0;
 
index fb38c7bdd4577fac265595d1e8b0d9bd007a4ade..5cdd2f10fc8aade7e8f6a490216a1d1efffe9003 100644 (file)
@@ -3582,7 +3582,7 @@ AtEOXact_Buffers(bool isCommit)
  * buffer pool.
  */
 void
-InitBufferPoolAccess(void)
+InitBufferManagerAccess(void)
 {
    HASHCTL     hash_ctl;
 
index 19797de31a9c82c5d0bebd9919c93f62b6e39145..dffdd57e9b52daa725d02bdf70ad8fccdf035b76 100644 (file)
@@ -506,7 +506,7 @@ StrategyInitialize(bool init)
 
        /*
         * Grab the whole linked list of free buffers for our strategy. We
-        * assume it was previously set up by InitBufferPool().
+        * assume it was previously set up by BufferManagerShmemInit().
         */
        StrategyControl->firstFreeBuffer = 0;
        StrategyControl->lastFreeBuffer = NBuffers - 1;
index 8f8a89124e84f174629a9d8e16578a45dd921ddb..6caeca3a8e6f8091254dd005efa9dc0065643c86 100644 (file)
@@ -115,7 +115,7 @@ CalculateShmemSize(int *num_semaphores)
                                             sizeof(ShmemIndexEnt)));
    size = add_size(size, dsm_estimate_size());
    size = add_size(size, DSMRegistryShmemSize());
-   size = add_size(size, BufferShmemSize());
+   size = add_size(size, BufferManagerShmemSize());
    size = add_size(size, LockManagerShmemSize());
    size = add_size(size, PredicateLockShmemSize());
    size = add_size(size, ProcGlobalShmemSize());
@@ -132,7 +132,7 @@ CalculateShmemSize(int *num_semaphores)
    size = add_size(size, LWLockShmemSize());
    size = add_size(size, ProcArrayShmemSize());
    size = add_size(size, BackendStatusShmemSize());
-   size = add_size(size, SInvalShmemSize());
+   size = add_size(size, SharedInvalShmemSize());
    size = add_size(size, PMSignalShmemSize());
    size = add_size(size, ProcSignalShmemSize());
    size = add_size(size, CheckpointerShmemSize());
@@ -286,7 +286,7 @@ CreateOrAttachShmemStructs(void)
    CommitTsShmemInit();
    SUBTRANSShmemInit();
    MultiXactShmemInit();
-   InitBufferPool();
+   BufferManagerShmemInit();
 
    /*
     * Set up lock manager
@@ -296,22 +296,22 @@ CreateOrAttachShmemStructs(void)
    /*
     * Set up predicate lock manager
     */
-   InitPredicateLocks();
+   PredicateLockShmemInit();
 
    /*
     * Set up process table
     */
    if (!IsUnderPostmaster)
        InitProcGlobal();
-   CreateSharedProcArray();
-   CreateSharedBackendStatus();
+   ProcArrayShmemInit();
+   BackendStatusShmemInit();
    TwoPhaseShmemInit();
    BackgroundWorkerShmemInit();
 
    /*
     * Set up shared-inval messaging
     */
-   CreateSharedInvalidationState();
+   SharedInvalShmemInit();
 
    /*
     * Set up interprocess signaling mechanisms
index af3b15e93dfffb0b1b34d5a00881416ae28c5b02..36610a1c7e7f51faed76dca908e9e1f721eb5dac 100644 (file)
@@ -370,7 +370,7 @@ static inline FullTransactionId FullXidRelativeTo(FullTransactionId rel,
 static void GlobalVisUpdateApply(ComputeXidHorizonsResult *horizons);
 
 /*
- * Report shared-memory space needed by CreateSharedProcArray.
+ * Report shared-memory space needed by ProcArrayShmemInit
  */
 Size
 ProcArrayShmemSize(void)
@@ -415,7 +415,7 @@ ProcArrayShmemSize(void)
  * Initialize the shared PGPROC array during postmaster startup.
  */
 void
-CreateSharedProcArray(void)
+ProcArrayShmemInit(void)
 {
    bool        found;
 
index b486d8ddd1df64b226f2ff6403f471f88e1176b9..db59637c4387c4f541b4e4e056a09612a3acac9a 100644 (file)
@@ -212,10 +212,10 @@ static void CleanupInvalidationState(int status, Datum arg);
 
 
 /*
- * SInvalShmemSize --- return shared-memory space needed
+ * SharedInvalShmemSize --- return shared-memory space needed
  */
 Size
-SInvalShmemSize(void)
+SharedInvalShmemSize(void)
 {
    Size        size;
 
@@ -227,18 +227,18 @@ SInvalShmemSize(void)
 }
 
 /*
- * CreateSharedInvalidationState
+ * SharedInvalShmemInit
  *     Create and initialize the SI message buffer
  */
 void
-CreateSharedInvalidationState(void)
+SharedInvalShmemInit(void)
 {
    int         i;
    bool        found;
 
    /* Allocate space in shared memory */
    shmInvalBuffer = (SISeg *)
-       ShmemInitStruct("shmInvalBuffer", SInvalShmemSize(), &found);
+       ShmemInitStruct("shmInvalBuffer", SharedInvalShmemSize(), &found);
    if (found)
        return;
 
index b455b78f9f70607b53b33f4ced58528c46a97f3c..e24a0f2fdbd206a1454cbf5a54e70dc306a6292c 100644 (file)
  * INTERFACE ROUTINES
  *
  * housekeeping for setting up shared memory predicate lock structures
- *     InitPredicateLocks(void)
+ *     PredicateLockShmemInit(void)
  *     PredicateLockShmemSize(void)
  *
  * predicate lock reporting
@@ -1127,7 +1127,7 @@ CheckPointPredicate(void)
 /*------------------------------------------------------------------------*/
 
 /*
- * InitPredicateLocks -- Initialize the predicate locking data structures.
+ * PredicateLockShmemInit -- Initialize the predicate locking data structures.
  *
  * This is called from CreateSharedMemoryAndSemaphores(), which see for
  * more comments.  In the normal postmaster case, the shared hash tables
@@ -1137,7 +1137,7 @@ CheckPointPredicate(void)
  * shared hash tables.
  */
 void
-InitPredicateLocks(void)
+PredicateLockShmemInit(void)
 {
    HASHCTL     info;
    long        max_table_size;
index 1ccf4c6d839e1503c9ba8fef6ba09521a685fd13..34a55e2177d767b8f827a5ad90d0b0875d3727c0 100644 (file)
@@ -77,7 +77,7 @@ static void pgstat_setup_backend_status_context(void);
 
 
 /*
- * Report shared-memory space needed by CreateSharedBackendStatus.
+ * Report shared-memory space needed by BackendStatusShmemInit.
  */
 Size
 BackendStatusShmemSize(void)
@@ -113,7 +113,7 @@ BackendStatusShmemSize(void)
  * during postmaster startup.
  */
 void
-CreateSharedBackendStatus(void)
+BackendStatusShmemInit(void)
 {
    Size        size;
    bool        found;
index 04a47d6e704d6ccc6420cb31f4474572e7a150ab..3b50ce19a2ca8404802b0c2c022fb86397b2647a 100644 (file)
@@ -592,7 +592,7 @@ BaseInit(void)
    /* Do local initialization of storage and buffer managers */
    InitSync();
    smgrinit();
-   InitBufferPoolAccess();
+   InitBufferManagerAccess();
 
    /*
     * Initialize temporary file access after pgstat, so that the temporary
index c8422571b7f9454b53e93fa368af86721ce77716..eb0fba4230b2d19d17dcb188732662e1917a9dfd 100644 (file)
@@ -249,7 +249,7 @@ extern Buffer ExtendBufferedRelTo(BufferManagerRelation bmr,
                                  BlockNumber extend_to,
                                  ReadBufferMode mode);
 
-extern void InitBufferPoolAccess(void);
+extern void InitBufferManagerAccess(void);
 extern void AtEOXact_Buffers(bool isCommit);
 extern char *DebugPrintBufferRefcount(Buffer buffer);
 extern void CheckPointBuffers(int flags);
@@ -300,8 +300,8 @@ extern void LimitAdditionalLocalPins(uint32 *additional_pins);
 extern bool EvictUnpinnedBuffer(Buffer buf);
 
 /* in buf_init.c */
-extern void InitBufferPool(void);
-extern Size BufferShmemSize(void);
+extern void BufferManagerShmemInit(void);
+extern Size BufferManagerShmemSize(void);
 
 /* in localbuf.c */
 extern void AtProcExit_LocalBuffers(void);
index 14ee9b94a2ff64834b2d3169058da43e86687205..d5c14986e246ac27505c1f1612791f2d4abe593a 100644 (file)
@@ -37,7 +37,7 @@ typedef void *SerializableXactHandle;
  */
 
 /* housekeeping for shared memory predicate lock structures */
-extern void InitPredicateLocks(void);
+extern void PredicateLockShmemInit(void);
 extern Size PredicateLockShmemSize(void);
 
 extern void CheckPointPredicate(void);
index 8ca6050462252d5936258fb2d664e11d868c1760..56af0b40b326ceaec31276d219050303cc86795e 100644 (file)
@@ -21,7 +21,7 @@
 
 
 extern Size ProcArrayShmemSize(void);
-extern void CreateSharedProcArray(void);
+extern void ProcArrayShmemInit(void);
 extern void ProcArrayAdd(PGPROC *proc);
 extern void ProcArrayRemove(PGPROC *proc, TransactionId latestXid);
 
index c3c97b3f8b7ed6883817261773e53ef20d63a6eb..c9d175b634d112ed063a0c5439f2922f0dc5d09e 100644 (file)
@@ -28,8 +28,8 @@
 /*
  * prototypes for functions in sinvaladt.c
  */
-extern Size SInvalShmemSize(void);
-extern void CreateSharedInvalidationState(void);
+extern Size SharedInvalShmemSize(void);
+extern void SharedInvalShmemInit(void);
 extern void SharedInvalBackendInit(bool sendOnly);
 
 extern void SIInsertDataEntries(const SharedInvalidationMessage *data, int n);
index 7b7f6f59d07a815e65777e3ab386d82caa500f52..97874300c31de894a6a423e7e04ba6c904446d4f 100644 (file)
@@ -299,7 +299,7 @@ extern PGDLLIMPORT PgBackendStatus *MyBEEntry;
  * ----------
  */
 extern Size BackendStatusShmemSize(void);
-extern void CreateSharedBackendStatus(void);
+extern void BackendStatusShmemInit(void);
 
 
 /* ----------