Rename SLRU structures and associated LWLocks.
authorTom Lane <[email protected]>
Fri, 15 May 2020 18:28:19 +0000 (14:28 -0400)
committerTom Lane <[email protected]>
Fri, 15 May 2020 18:28:25 +0000 (14:28 -0400)
commit5da14938f7bfb96b648ee3c47e7ea2afca5bcc4a
treea637e548f3a39f0ebaef513f870964eb5dcecec9
parent756abe2bc7608b38c579c510eb66f2bd80d10785
Rename SLRU structures and associated LWLocks.

Originally, the names assigned to SLRUs had no purpose other than
being shmem lookup keys, so not a lot of thought went into them.
As of v13, though, we're exposing them in the pg_stat_slru view and
the pg_stat_reset_slru function, so it seems advisable to take a bit
more care.  Rename them to names based on the associated on-disk
storage directories (which fortunately we *did* think about, to some
extent; since those are also visible to DBAs, consistency seems like
a good thing).  Also rename the associated LWLocks, since those names
are likewise user-exposed now as wait event names.

For the most part I only touched symbols used in the respective modules'
SimpleLruInit() calls, not the names of other related objects.  This
renaming could have been taken further, and maybe someday we will do so.
But for now it seems undesirable to change the names of any globally
visible functions or structs, so some inconsistency is unavoidable.

(But I *did* terminate "oldserxid" with prejudice, as I found that
name both unreadable and not descriptive of the SLRU's contents.)

Table 27.12 needs re-alphabetization now, but I'll leave that till
after the other LWLock renamings I have in mind.

Discussion: https://postgr.es/m/28683.1589405363@sss.pgh.pa.us
20 files changed:
doc/src/sgml/monitoring.sgml
src/backend/access/transam/clog.c
src/backend/access/transam/commit_ts.c
src/backend/access/transam/multixact.c
src/backend/access/transam/slru.c
src/backend/access/transam/subtrans.c
src/backend/access/transam/varsup.c
src/backend/commands/async.c
src/backend/postmaster/pgstat.c
src/backend/replication/basebackup.c
src/backend/storage/lmgr/lwlock.c
src/backend/storage/lmgr/lwlocknames.txt
src/backend/storage/lmgr/predicate.c
src/backend/utils/adt/xid8funcs.c
src/bin/pg_rewind/filemap.c
src/include/access/multixact.h
src/include/access/transam.h
src/include/commands/async.h
src/include/storage/lwlock.h
src/include/storage/predicate.h