#include "access/attnum.h"
#include "access/htup.h"

Include dependency graph for syscache.h:

This graph shows which files directly or indirectly include this file:

Macros
#define	SysCacheSize (USERMAPPINGUSERSERVER + 1)

#define	SearchSysCacheCopy1(cacheId, key1) SearchSysCacheCopy(cacheId, key1, 0, 0, 0)

#define	SearchSysCacheCopy2(cacheId, key1, key2) SearchSysCacheCopy(cacheId, key1, key2, 0, 0)

#define	SearchSysCacheCopy3(cacheId, key1, key2, key3) SearchSysCacheCopy(cacheId, key1, key2, key3, 0)

#define	SearchSysCacheCopy4(cacheId, key1, key2, key3, key4) SearchSysCacheCopy(cacheId, key1, key2, key3, key4)

#define	SearchSysCacheExists1(cacheId, key1) SearchSysCacheExists(cacheId, key1, 0, 0, 0)

#define	SearchSysCacheExists2(cacheId, key1, key2) SearchSysCacheExists(cacheId, key1, key2, 0, 0)

#define	SearchSysCacheExists3(cacheId, key1, key2, key3) SearchSysCacheExists(cacheId, key1, key2, key3, 0)

#define	SearchSysCacheExists4(cacheId, key1, key2, key3, key4) SearchSysCacheExists(cacheId, key1, key2, key3, key4)

#define	GetSysCacheOid1(cacheId, oidcol, key1) GetSysCacheOid(cacheId, oidcol, key1, 0, 0, 0)

#define	GetSysCacheOid2(cacheId, oidcol, key1, key2) GetSysCacheOid(cacheId, oidcol, key1, key2, 0, 0)

#define	GetSysCacheOid3(cacheId, oidcol, key1, key2, key3) GetSysCacheOid(cacheId, oidcol, key1, key2, key3, 0)

#define	GetSysCacheOid4(cacheId, oidcol, key1, key2, key3, key4) GetSysCacheOid(cacheId, oidcol, key1, key2, key3, key4)

#define	GetSysCacheHashValue1(cacheId, key1) GetSysCacheHashValue(cacheId, key1, 0, 0, 0)

#define	GetSysCacheHashValue2(cacheId, key1, key2) GetSysCacheHashValue(cacheId, key1, key2, 0, 0)

#define	GetSysCacheHashValue3(cacheId, key1, key2, key3) GetSysCacheHashValue(cacheId, key1, key2, key3, 0)

#define	GetSysCacheHashValue4(cacheId, key1, key2, key3, key4) GetSysCacheHashValue(cacheId, key1, key2, key3, key4)

#define	SearchSysCacheList1(cacheId, key1) SearchSysCacheList(cacheId, 1, key1, 0, 0)

#define	SearchSysCacheList2(cacheId, key1, key2) SearchSysCacheList(cacheId, 2, key1, key2, 0)

#define	SearchSysCacheList3(cacheId, key1, key2, key3) SearchSysCacheList(cacheId, 3, key1, key2, key3)

#define	ReleaseSysCacheList(x) ReleaseCatCacheList(x)

Enumerations
enum	SysCacheIdentifier { AGGFNOID = 0, AMNAME, AMOID, AMOPOPID, AMOPSTRATEGY, AMPROCNUM, ATTNAME, ATTNUM, AUTHMEMMEMROLE, AUTHMEMROLEMEM, AUTHNAME, AUTHOID, CASTSOURCETARGET, CLAAMNAMENSP, CLAOID, COLLNAMEENCNSP, COLLOID, CONDEFAULT, CONNAMENSP, CONSTROID, CONVOID, DATABASEOID, DEFACLROLENSPOBJ, ENUMOID, ENUMTYPOIDNAME, EVENTTRIGGERNAME, EVENTTRIGGEROID, FOREIGNDATAWRAPPERNAME, FOREIGNDATAWRAPPEROID, FOREIGNSERVERNAME, FOREIGNSERVEROID, FOREIGNTABLEREL, INDEXRELID, LANGNAME, LANGOID, NAMESPACENAME, NAMESPACEOID, OPERNAMENSP, OPEROID, OPFAMILYAMNAMENSP, OPFAMILYOID, PARTRELID, PROCNAMEARGSNSP, PROCOID, PUBLICATIONNAME, PUBLICATIONOID, PUBLICATIONREL, PUBLICATIONRELMAP, RANGEMULTIRANGE, RANGETYPE, RELNAMENSP, RELOID, REPLORIGIDENT, REPLORIGNAME, RULERELNAME, SEQRELID, STATEXTDATASTXOID, STATEXTNAMENSP, STATEXTOID, STATRELATTINH, SUBSCRIPTIONNAME, SUBSCRIPTIONOID, SUBSCRIPTIONRELMAP, TABLESPACEOID, TRFOID, TRFTYPELANG, TSCONFIGMAP, TSCONFIGNAMENSP, TSCONFIGOID, TSDICTNAMENSP, TSDICTOID, TSPARSERNAMENSP, TSPARSEROID, TSTEMPLATENAMENSP, TSTEMPLATEOID, TYPENAMENSP, TYPEOID, USERMAPPINGOID }

Functions
void	InitCatalogCache (void)

void	InitCatalogCachePhase2 (void)

HeapTuple	SearchSysCache (int cacheId, Datum key1, Datum key2, Datum key3, Datum key4)

HeapTuple	SearchSysCache1 (int cacheId, Datum key1)

HeapTuple	SearchSysCache2 (int cacheId, Datum key1, Datum key2)

HeapTuple	SearchSysCache3 (int cacheId, Datum key1, Datum key2, Datum key3)

HeapTuple	SearchSysCache4 (int cacheId, Datum key1, Datum key2, Datum key3, Datum key4)

void	ReleaseSysCache (HeapTuple tuple)

HeapTuple	SearchSysCacheCopy (int cacheId, Datum key1, Datum key2, Datum key3, Datum key4)

bool	SearchSysCacheExists (int cacheId, Datum key1, Datum key2, Datum key3, Datum key4)

Oid	GetSysCacheOid (int cacheId, AttrNumber oidcol, Datum key1, Datum key2, Datum key3, Datum key4)

HeapTuple	SearchSysCacheAttName (Oid relid, const char *attname)

HeapTuple	SearchSysCacheCopyAttName (Oid relid, const char *attname)

bool	SearchSysCacheExistsAttName (Oid relid, const char *attname)

HeapTuple	SearchSysCacheAttNum (Oid relid, int16 attnum)

HeapTuple	SearchSysCacheCopyAttNum (Oid relid, int16 attnum)

Datum	SysCacheGetAttr (int cacheId, HeapTuple tup, AttrNumber attributeNumber, bool *isNull)

uint32	GetSysCacheHashValue (int cacheId, Datum key1, Datum key2, Datum key3, Datum key4)

struct catclist *	SearchSysCacheList (int cacheId, int nkeys, Datum key1, Datum key2, Datum key3)

void	SysCacheInvalidate (int cacheId, uint32 hashValue)

bool	RelationInvalidatesSnapshotsOnly (Oid relid)

bool	RelationHasSysCache (Oid relid)

bool	RelationSupportsSysCache (Oid relid)

Macro Definition Documentation

◆ GetSysCacheHashValue1

#define GetSysCacheHashValue1	(	cacheId,
		key1
	)	GetSysCacheHashValue(cacheId, key1, 0, 0, 0)

Definition at line 202 of file syscache.h.

Referenced by initialize_acl(), lookup_type_cache(), make_new_connection(), record_plan_function_dependency(), record_plan_type_dependency(), and ri_LoadConstraintInfo().

◆ GetSysCacheHashValue2

#define GetSysCacheHashValue2	(	cacheId,
		key1,
		key2
	)	GetSysCacheHashValue(cacheId, key1, key2, 0, 0)

Definition at line 204 of file syscache.h.

◆ GetSysCacheHashValue3

#define GetSysCacheHashValue3	(	cacheId,
		key1,
		key2,
		key3
	)	GetSysCacheHashValue(cacheId, key1, key2, key3, 0)

Definition at line 206 of file syscache.h.

◆ GetSysCacheHashValue4

#define GetSysCacheHashValue4	(	cacheId,
		key1,
		key2,
		key3,
		key4
	)	GetSysCacheHashValue(cacheId, key1, key2, key3, key4)

Definition at line 208 of file syscache.h.

◆ GetSysCacheOid1

#define GetSysCacheOid1	(	cacheId,
		oidcol,
		key1
	)	GetSysCacheOid(cacheId, oidcol, key1, 0, 0, 0)

Definition at line 193 of file syscache.h.

Referenced by CreateAccessMethod(), CreatePublication(), get_event_trigger_oid(), get_foreign_data_wrapper_oid(), get_foreign_server_oid(), get_language_oid(), get_namespace_oid(), get_publication_oid(), and get_role_oid().

◆ GetSysCacheOid2

#define GetSysCacheOid2	(	cacheId,
		oidcol,
		key1,
		key2
	)	GetSysCacheOid(cacheId, oidcol, key1, key2, 0, 0)

◆ GetSysCacheOid3

#define GetSysCacheOid3	(	cacheId,
		oidcol,
		key1,
		key2,
		key3
	)	GetSysCacheOid(cacheId, oidcol, key1, key2, key3, 0)

Definition at line 197 of file syscache.h.

Referenced by lookup_collation(), OpclassnameGetOpcid(), and OpfamilynameGetOpfid().

◆ GetSysCacheOid4

#define GetSysCacheOid4	(	cacheId,
		oidcol,
		key1,
		key2,
		key3,
		key4
	)	GetSysCacheOid(cacheId, oidcol, key1, key2, key3, key4)

Definition at line 199 of file syscache.h.

Referenced by dropOperators(), and dropProcedures().

◆ ReleaseSysCacheList

#define ReleaseSysCacheList ( x ) ReleaseCatCacheList(x)

Definition at line 218 of file syscache.h.

Referenced by comparison_ops_are_compatible(), equality_ops_are_compatible(), FindDefaultConversion(), FuncnameGetCandidates(), get_compatible_hash_operators(), get_mergejoin_opfamilies(), get_op_btree_interpretation(), get_op_hash_functions(), get_ordering_op_for_equality_op(), get_ordering_op_properties(), GetRelationPublications(), OpernameGetCandidates(), OpernameGetOprid(), roles_is_member_of(), and spgproperty().

◆ SearchSysCacheCopy1

#define SearchSysCacheCopy1	(	cacheId,
		key1
	)	SearchSysCacheCopy(cacheId, key1, 0, 0, 0)

Definition at line 175 of file syscache.h.

Referenced by AlterCollation(), AlterDomainAddConstraint(), AlterDomainDefault(), AlterDomainDropConstraint(), AlterDomainNotNull(), AlterEventTrigger(), AlterEventTriggerOwner(), AlterEventTriggerOwner_oid(), AlterForeignDataWrapper(), AlterForeignDataWrapperOwner(), AlterForeignDataWrapperOwner_oid(), AlterForeignServer(), AlterForeignServerOwner(), AlterForeignServerOwner_oid(), AlterFunction(), AlterObjectNamespace_internal(), AlterOperator(), AlterPublication(), AlterPublicationOwner(), AlterPublicationOwner_oid(), AlterRelationNamespaceInternal(), AlterSequence(), AlterSubscriptionOwner_oid(), AlterTypeNamespaceInternal(), AlterTypeOwnerInternal(), AlterUserMapping(), ATExecAddColumn(), ATExecAddOf(), ATExecDropOf(), ATExecForceNoForceRowSecurity(), ATExecGenericOptions(), ATExecSetRowSecurity(), copy_table_data(), create_toast_table(), CreateTriggerFiringOn(), DefineQueryRewrite(), DetachPartitionFinalize(), do_autovacuum(), examine_attribute(), examine_expression(), finish_heap_swap(), get_catalog_object_by_oid(), index_build(), index_concurrently_swap(), index_constraint_create(), index_set_state_flags(), index_update_stats(), mark_index_clustered(), OperatorCreate(), OperatorUpd(), reindex_index(), relation_mark_replica_identity(), RelationSetNewRelfilenode(), RemoveConstraintById(), RenameConstraintById(), RenameDatabase(), RenameRelationInternal(), RenameSchema(), RenameType(), RenameTypeInternal(), SetMatViewPopulatedState(), SetRelationHasSubclass(), SetRelationNumChecks(), SetRelationRuleStatus(), SetRelationTableSpace(), StorePartitionBound(), swap_relation_files(), table_recheck_autovac(), truncate_update_partedrel_stats(), update_default_partition_oid(), update_relispartition(), UpdateTwoPhaseState(), and vac_update_relstats().

◆ SearchSysCacheCopy2

#define SearchSysCacheCopy2	(	cacheId,
		key1,
		key2
	)	SearchSysCacheCopy(cacheId, key1, key2, 0, 0)

Definition at line 177 of file syscache.h.

Referenced by AddSubscriptionRelState(), AlterSubscription(), AlterSubscriptionOwner(), EnableDisableRule(), RemoveAttrDefaultById(), RemoveAttributeById(), RenameRewriteRule(), StoreAttrDefault(), TypeCreate(), and UpdateSubscriptionRelState().

◆ SearchSysCacheCopy3

#define SearchSysCacheCopy3	(	cacheId,
		key1,
		key2,
		key3
	)	SearchSysCacheCopy(cacheId, key1, key2, key3, 0)

Definition at line 179 of file syscache.h.

◆ SearchSysCacheCopy4

#define SearchSysCacheCopy4	(	cacheId,
		key1,
		key2,
		key3,
		key4
	)	SearchSysCacheCopy(cacheId, key1, key2, key3, key4)

Definition at line 181 of file syscache.h.

◆ SearchSysCacheExists1

#define SearchSysCacheExists1	(	cacheId,
		key1
	)	SearchSysCacheExists(cacheId, key1, 0, 0, 0)

Definition at line 184 of file syscache.h.

◆ SearchSysCacheExists2

#define SearchSysCacheExists2	(	cacheId,
		key1,
		key2
	)	SearchSysCacheExists(cacheId, key1, key2, 0, 0)

Definition at line 186 of file syscache.h.

Referenced by AlterObjectNamespace_internal(), AlterObjectRename_internal(), AlterTypeNamespaceInternal(), ATExecAttachPartition(), ConversionCreate(), CreateStatistics(), IsDefinedRewriteRule(), makeMultirangeTypeName(), makeUniqueTypeName(), publication_add_relation(), scanRTEForColumn(), StatisticsObjIsVisible(), TSConfigIsVisible(), TSDictionaryIsVisible(), TSParserIsVisible(), TSTemplateIsVisible(), and TypeIsVisible().

◆ SearchSysCacheExists3

#define SearchSysCacheExists3	(	cacheId,
		key1,
		key2,
		key3
	)	SearchSysCacheExists(cacheId, key1, key2, key3, 0)

Definition at line 188 of file syscache.h.

Referenced by CollationCreate(), CreateOpFamily(), DefineOpClass(), IsThereCollationInNamespace(), IsThereFunctionInNamespace(), IsThereOpClassInNamespace(), IsThereOpFamilyInNamespace(), and op_in_opfamily().

◆ SearchSysCacheExists4

#define SearchSysCacheExists4	(	cacheId,
		key1,
		key2,
		key3,
		key4
	)	SearchSysCacheExists(cacheId, key1, key2, key3, key4)

Definition at line 190 of file syscache.h.

Referenced by gistproperty(), storeOperators(), and storeProcedures().

◆ SearchSysCacheList1

#define SearchSysCacheList1	(	cacheId,
		key1
	)	SearchSysCacheList(cacheId, 1, key1, 0, 0)

◆ SearchSysCacheList2

#define SearchSysCacheList2	(	cacheId,
		key1,
		key2
	)	SearchSysCacheList(cacheId, 2, key1, key2, 0)

Definition at line 213 of file syscache.h.

Referenced by transformFrameOffset().

◆ SearchSysCacheList3

#define SearchSysCacheList3	(	cacheId,
		key1,
		key2,
		key3
	)	SearchSysCacheList(cacheId, 3, key1, key2, key3)

Definition at line 215 of file syscache.h.

Referenced by FindDefaultConversion(), and OpernameGetOprid().

◆ SysCacheSize

#define SysCacheSize (USERMAPPINGUSERSERVER + 1)

Definition at line 114 of file syscache.h.

Referenced by CacheRegisterSyscacheCallback(), CallSyscacheCallbacks(), GetSysCacheHashValue(), InitCatalogCache(), InitCatalogCachePhase2(), SearchSysCache(), SearchSysCache1(), SearchSysCache2(), SearchSysCache3(), SearchSysCache4(), SearchSysCacheList(), SysCacheGetAttr(), and SysCacheInvalidate().

Enumeration Type Documentation

◆ SysCacheIdentifier

enum SysCacheIdentifier

Enumerator
AGGFNOID
AMNAME
AMOID
AMOPOPID
AMOPSTRATEGY
AMPROCNUM
ATTNAME
ATTNUM
AUTHMEMMEMROLE
AUTHMEMROLEMEM
AUTHNAME
AUTHOID
CASTSOURCETARGET
CLAAMNAMENSP
CLAOID
COLLNAMEENCNSP
COLLOID
CONDEFAULT
CONNAMENSP
CONSTROID
CONVOID
DATABASEOID
DEFACLROLENSPOBJ
ENUMOID
ENUMTYPOIDNAME
EVENTTRIGGERNAME
EVENTTRIGGEROID
FOREIGNDATAWRAPPERNAME
FOREIGNDATAWRAPPEROID
FOREIGNSERVERNAME
FOREIGNSERVEROID
FOREIGNTABLEREL
INDEXRELID
LANGNAME
LANGOID
NAMESPACENAME
NAMESPACEOID
OPERNAMENSP
OPEROID
OPFAMILYAMNAMENSP
OPFAMILYOID
PARTRELID
PROCNAMEARGSNSP
PROCOID
PUBLICATIONNAME
PUBLICATIONOID
PUBLICATIONREL
PUBLICATIONRELMAP
RANGEMULTIRANGE
RANGETYPE
RELNAMENSP
RELOID
REPLORIGIDENT
REPLORIGNAME
RULERELNAME
SEQRELID
STATEXTDATASTXOID
STATEXTNAMENSP
STATEXTOID
STATRELATTINH
SUBSCRIPTIONNAME
SUBSCRIPTIONOID
SUBSCRIPTIONRELMAP
TABLESPACEOID
TRFOID
TRFTYPELANG
TSCONFIGMAP
TSCONFIGNAMENSP
TSCONFIGOID
TSDICTNAMENSP
TSDICTOID
TSPARSERNAMENSP
TSPARSEROID
TSTEMPLATENAMENSP
TSTEMPLATEOID
TYPENAMENSP
TYPEOID
USERMAPPINGOID

Definition at line 32 of file syscache.h.

 {
     AGGFNOID = 0,
     AMNAME,
     AMOID,
     AMOPOPID,
     AMOPSTRATEGY,
     AMPROCNUM,
     ATTNAME,
     ATTNUM,
     AUTHMEMMEMROLE,
     AUTHMEMROLEMEM,
     AUTHNAME,
     AUTHOID,
     CASTSOURCETARGET,
     CLAAMNAMENSP,
     CLAOID,
     COLLNAMEENCNSP,
     COLLOID,
     CONDEFAULT,
     CONNAMENSP,
     CONSTROID,
     CONVOID,
     DATABASEOID,
     DEFACLROLENSPOBJ,
     ENUMOID,
     ENUMTYPOIDNAME,
     EVENTTRIGGERNAME,
     EVENTTRIGGEROID,
     FOREIGNDATAWRAPPERNAME,
     FOREIGNDATAWRAPPEROID,
     FOREIGNSERVERNAME,
     FOREIGNSERVEROID,
     FOREIGNTABLEREL,
     INDEXRELID,
     LANGNAME,
     LANGOID,
     NAMESPACENAME,
     NAMESPACEOID,
     OPERNAMENSP,
     OPEROID,
     OPFAMILYAMNAMENSP,
     OPFAMILYOID,
     PARTRELID,
     PROCNAMEARGSNSP,
     PROCOID,
     PUBLICATIONNAME,
     PUBLICATIONOID,
     PUBLICATIONREL,
     PUBLICATIONRELMAP,
     RANGEMULTIRANGE,
     RANGETYPE,
     RELNAMENSP,
     RELOID,
     REPLORIGIDENT,
     REPLORIGNAME,
     RULERELNAME,
     SEQRELID,
     STATEXTDATASTXOID,
     STATEXTNAMENSP,
     STATEXTOID,
     STATRELATTINH,
     SUBSCRIPTIONNAME,
     SUBSCRIPTIONOID,
     SUBSCRIPTIONRELMAP,
     TABLESPACEOID,
     TRFOID,
     TRFTYPELANG,
     TSCONFIGMAP,
     TSCONFIGNAMENSP,
     TSCONFIGOID,
     TSDICTNAMENSP,
     TSDICTOID,
     TSPARSERNAMENSP,
     TSPARSEROID,
     TSTEMPLATENAMENSP,
     TSTEMPLATEOID,
     TYPENAMENSP,
     TYPEOID,
     USERMAPPINGOID,
     USERMAPPINGUSERSERVER
 
 #define SysCacheSize (USERMAPPINGUSERSERVER + 1)
 };

Function Documentation

◆ GetSysCacheHashValue()

uint32 GetSysCacheHashValue	(	int	cacheId,
		Datum	key1,
		Datum	key2,
		Datum	key3,
		Datum	key4
	)

Definition at line 1423 of file syscache.c.

References elog, ERROR, GetCatCacheHashValue(), PointerIsValid, and SysCacheSize.

 {
     if (cacheId < 0 || cacheId >= SysCacheSize ||
         !PointerIsValid(SysCache[cacheId]))
         elog(ERROR, "invalid cache ID: %d", cacheId);
 
     return GetCatCacheHashValue(SysCache[cacheId], key1, key2, key3, key4);
 }

◆ GetSysCacheOid()

Oid GetSysCacheOid	(	int	cacheId,
		AttrNumber	oidcol,
		Datum	key1,
		Datum	key2,
		Datum	key3,
		Datum	key4
	)

Definition at line 1236 of file syscache.c.

References Assert, heap_getattr, HeapTupleIsValid, InvalidOid, ReleaseSysCache(), and SearchSysCache().

 {
     HeapTuple   tuple;
     bool        isNull;
     Oid         result;
 
     tuple = SearchSysCache(cacheId, key1, key2, key3, key4);
     if (!HeapTupleIsValid(tuple))
         return InvalidOid;
     result = heap_getattr(tuple, oidcol,
                           SysCache[cacheId]->cc_tupdesc,
                           &isNull);
     Assert(!isNull);            /* columns used as oids should never be NULL */
     ReleaseSysCache(tuple);
     return result;
 }

◆ InitCatalogCache()

void InitCatalogCache ( void )

Definition at line 1021 of file syscache.c.

References Assert, CacheInitialized, elog, ERROR, cachedesc::indoid, InitCatCache(), cachedesc::key, lengthof, cachedesc::nbuckets, cachedesc::nkeys, oid_compare(), pg_qsort(), PointerIsValid, qunique(), RelationInvalidatesSnapshotsOnly(), cachedesc::reloid, StaticAssertStmt, SysCacheRelationOid, SysCacheRelationOidSize, SysCacheSize, SysCacheSupportingRelOid, and SysCacheSupportingRelOidSize.

Referenced by InitPostgres().

 {
     int         cacheId;
 
     StaticAssertStmt(SysCacheSize == (int) lengthof(cacheinfo),
                      "SysCacheSize does not match syscache.c's array");
 
     Assert(!CacheInitialized);
 
     SysCacheRelationOidSize = SysCacheSupportingRelOidSize = 0;
 
     for (cacheId = 0; cacheId < SysCacheSize; cacheId++)
     {
         SysCache[cacheId] = InitCatCache(cacheId,
                                          cacheinfo[cacheId].reloid,
                                          cacheinfo[cacheId].indoid,
                                          cacheinfo[cacheId].nkeys,
                                          cacheinfo[cacheId].key,
                                          cacheinfo[cacheId].nbuckets);
         if (!PointerIsValid(SysCache[cacheId]))
             elog(ERROR, "could not initialize cache %u (%d)",
                  cacheinfo[cacheId].reloid, cacheId);
         /* Accumulate data for OID lists, too */
         SysCacheRelationOid[SysCacheRelationOidSize++] =
             cacheinfo[cacheId].reloid;
         SysCacheSupportingRelOid[SysCacheSupportingRelOidSize++] =
             cacheinfo[cacheId].reloid;
         SysCacheSupportingRelOid[SysCacheSupportingRelOidSize++] =
             cacheinfo[cacheId].indoid;
         /* see comments for RelationInvalidatesSnapshotsOnly */
         Assert(!RelationInvalidatesSnapshotsOnly(cacheinfo[cacheId].reloid));
     }
 
     Assert(SysCacheRelationOidSize <= lengthof(SysCacheRelationOid));
     Assert(SysCacheSupportingRelOidSize <= lengthof(SysCacheSupportingRelOid));
 
     /* Sort and de-dup OID arrays, so we can use binary search. */
     pg_qsort(SysCacheRelationOid, SysCacheRelationOidSize,
              sizeof(Oid), oid_compare);
     SysCacheRelationOidSize =
         qunique(SysCacheRelationOid, SysCacheRelationOidSize, sizeof(Oid),
                 oid_compare);
 
     pg_qsort(SysCacheSupportingRelOid, SysCacheSupportingRelOidSize,
              sizeof(Oid), oid_compare);
     SysCacheSupportingRelOidSize =
         qunique(SysCacheSupportingRelOid, SysCacheSupportingRelOidSize,
                 sizeof(Oid), oid_compare);
 
     CacheInitialized = true;
 }

◆ InitCatalogCachePhase2()

void InitCatalogCachePhase2 ( void )

Definition at line 1086 of file syscache.c.

References Assert, CacheInitialized, InitCatCachePhase2(), and SysCacheSize.

Referenced by RelationCacheInitializePhase3().

 {
     int         cacheId;
 
     Assert(CacheInitialized);
 
     for (cacheId = 0; cacheId < SysCacheSize; cacheId++)
         InitCatCachePhase2(SysCache[cacheId], true);
 }

◆ RelationHasSysCache()

bool RelationHasSysCache ( Oid relid )

Definition at line 1507 of file syscache.c.

References SysCacheRelationOid, and SysCacheRelationOidSize.

Referenced by GetNonHistoricCatalogSnapshot().

 {
     int         low = 0,
                 high = SysCacheRelationOidSize - 1;
 
     while (low <= high)
     {
         int         middle = low + (high - low) / 2;
 
         if (SysCacheRelationOid[middle] == relid)
             return true;
         if (SysCacheRelationOid[middle] < relid)
             low = middle + 1;
         else
             high = middle - 1;
     }
 
     return false;
 }

◆ RelationInvalidatesSnapshotsOnly()

bool RelationInvalidatesSnapshotsOnly ( Oid relid )

Definition at line 1484 of file syscache.c.

Referenced by CacheInvalidateHeapTuple(), GetNonHistoricCatalogSnapshot(), and InitCatalogCache().

 {
     switch (relid)
     {
         case DbRoleSettingRelationId:
         case DependRelationId:
         case SharedDependRelationId:
         case DescriptionRelationId:
         case SharedDescriptionRelationId:
         case SecLabelRelationId:
         case SharedSecLabelRelationId:
             return true;
         default:
             break;
     }
 
     return false;
 }

◆ RelationSupportsSysCache()

bool RelationSupportsSysCache ( Oid relid )

Definition at line 1532 of file syscache.c.

References SysCacheSupportingRelOid, and SysCacheSupportingRelOidSize.

Referenced by RelationIdIsInInitFile().

 {
     int         low = 0,
                 high = SysCacheSupportingRelOidSize - 1;
 
     while (low <= high)
     {
         int         middle = low + (high - low) / 2;
 
         if (SysCacheSupportingRelOid[middle] == relid)
             return true;
         if (SysCacheSupportingRelOid[middle] < relid)
             low = middle + 1;
         else
             high = middle - 1;
     }
 
     return false;
 }

◆ ReleaseSysCache()

void ReleaseSysCache ( HeapTuple tuple )

Definition at line 1175 of file syscache.c.

References ReleaseCatCache().

 {
     ReleaseCatCache(tuple);
 }

◆ SearchSysCache()

HeapTuple SearchSysCache	(	int	cacheId,
		Datum	key1,
		Datum	key2,
		Datum	key3,
		Datum	key4
	)

Definition at line 1114 of file syscache.c.

References Assert, PointerIsValid, SearchCatCache(), and SysCacheSize.

Referenced by GetSysCacheOid(), plsample_func_handler(), SearchSysCacheCopy(), and SearchSysCacheExists().

 {
     Assert(cacheId >= 0 && cacheId < SysCacheSize &&
            PointerIsValid(SysCache[cacheId]));
 
     return SearchCatCache(SysCache[cacheId], key1, key2, key3, key4);
 }

◆ SearchSysCache1()

HeapTuple SearchSysCache1	(	int	cacheId,
		Datum	key1
	)

Definition at line 1127 of file syscache.c.

References Assert, PointerIsValid, SearchCatCache1(), and SysCacheSize.

 {
     Assert(cacheId >= 0 && cacheId < SysCacheSize &&
            PointerIsValid(SysCache[cacheId]));
     Assert(SysCache[cacheId]->cc_nkeys == 1);
 
     return SearchCatCache1(SysCache[cacheId], key1);
 }

◆ SearchSysCache2()

HeapTuple SearchSysCache2	(	int	cacheId,
		Datum	key1,
		Datum	key2
	)

Definition at line 1138 of file syscache.c.

References Assert, PointerIsValid, SearchCatCache2(), and SysCacheSize.

Referenced by AddEnumLabel(), AddRoleMems(), CastCreate(), check_for_column_name_collision(), convert_column_name(), CreateTransform(), DelRoleMems(), DropSubscription(), enum_in(), enum_recv(), ExecGrant_Attribute(), expand_all_col_privileges(), find_coercion_pathway(), find_typmod_coercion_function(), fixup_whole_row_references(), get_attgenerated(), get_attname(), get_attoptions(), get_attribute_options(), get_attstattarget(), get_atttype(), get_atttypetypmodcoll(), get_object_address_usermapping(), get_rewrite_oid(), get_rte_attribute_is_dropped(), get_transform_fromsql(), get_transform_tosql(), GetForeignColumnOptions(), GetSubscriptionRelState(), GetUserMapping(), index_check_primary_key(), InsertRule(), IsBinaryCoercible(), pg_attribute_aclcheck_all(), pg_attribute_aclmask_ext(), recordExtObjInitPriv(), RelationClearMissing(), removeExtObjInitPriv(), SearchSysCacheAttName(), and SearchSysCacheAttNum().

 {
     Assert(cacheId >= 0 && cacheId < SysCacheSize &&
            PointerIsValid(SysCache[cacheId]));
     Assert(SysCache[cacheId]->cc_nkeys == 2);
 
     return SearchCatCache2(SysCache[cacheId], key1, key2);
 }

◆ SearchSysCache3()

HeapTuple SearchSysCache3	(	int	cacheId,
		Datum	key1,
		Datum	key2,
		Datum	key3
	)

Definition at line 1149 of file syscache.c.

References Assert, PointerIsValid, SearchCatCache3(), and SysCacheSize.

Referenced by brincostestimate(), btcostestimate(), DefineOpClass(), examine_simple_variable(), examine_variable(), ExecHashBuildSkewHash(), get_attavgwidth(), get_default_acl_internal(), get_object_address_defacl(), get_op_opfamily_properties(), get_op_opfamily_sortfamily(), get_op_opfamily_strategy(), lookup_collation(), OpClassCacheLookup(), OpFamilyCacheLookup(), ProcedureCreate(), ResolveOpClass(), SetDefaultACL(), and update_attstats().

 {
     Assert(cacheId >= 0 && cacheId < SysCacheSize &&
            PointerIsValid(SysCache[cacheId]));
     Assert(SysCache[cacheId]->cc_nkeys == 3);
 
     return SearchCatCache3(SysCache[cacheId], key1, key2, key3);
 }

◆ SearchSysCache4()

HeapTuple SearchSysCache4	(	int	cacheId,
		Datum	key1,
		Datum	key2,
		Datum	key3,
		Datum	key4
	)

Definition at line 1160 of file syscache.c.

References Assert, PointerIsValid, SearchCatCache4(), and SysCacheSize.

Referenced by get_object_address_opf_member(), get_opfamily_member(), get_opfamily_proc(), inclusion_get_strategy_procinfo(), minmax_get_strategy_procinfo(), minmax_multi_get_strategy_procinfo(), OperatorGet(), and OpernameGetOprid().

 {
     Assert(cacheId >= 0 && cacheId < SysCacheSize &&
            PointerIsValid(SysCache[cacheId]));
     Assert(SysCache[cacheId]->cc_nkeys == 4);
 
     return SearchCatCache4(SysCache[cacheId], key1, key2, key3, key4);
 }

◆ SearchSysCacheAttName()

HeapTuple SearchSysCacheAttName	(	Oid	relid,
		const char *	attname
	)

Definition at line 1268 of file syscache.c.

References ATTNAME, CStringGetDatum, GETSTRUCT, HeapTupleIsValid, ObjectIdGetDatum, ReleaseSysCache(), and SearchSysCache2().

Referenced by ATExecAlterColumnGenericOptions(), ATExecCheckNotNull(), ATExecDropColumn(), ATExecSetOptions(), ATPrepAlterColumnType(), ATPrepSetNotNull(), ComputeIndexAttrs(), ComputePartitionAttrs(), CreateStatistics(), get_attnum(), make_inh_translation_list(), pg_nextoid(), plpgsql_parse_cwordtype(), SearchSysCacheCopyAttName(), SearchSysCacheExistsAttName(), SetAttrMissing(), and transformColumnNameList().

 {
     HeapTuple   tuple;
 
     tuple = SearchSysCache2(ATTNAME,
                             ObjectIdGetDatum(relid),
                             CStringGetDatum(attname));
     if (!HeapTupleIsValid(tuple))
         return NULL;
     if (((Form_pg_attribute) GETSTRUCT(tuple))->attisdropped)
     {
         ReleaseSysCache(tuple);
         return NULL;
     }
     return tuple;
 }

◆ SearchSysCacheAttNum()

HeapTuple SearchSysCacheAttNum	(	Oid	relid,
		int16	attnum
	)

Definition at line 1331 of file syscache.c.

References ATTNUM, GETSTRUCT, HeapTupleIsValid, Int16GetDatum, ObjectIdGetDatum, ReleaseSysCache(), and SearchSysCache2().

Referenced by SearchSysCacheCopyAttNum().

 {
     HeapTuple   tuple;
 
     tuple = SearchSysCache2(ATTNUM,
                             ObjectIdGetDatum(relid),
                             Int16GetDatum(attnum));
     if (!HeapTupleIsValid(tuple))
         return NULL;
     if (((Form_pg_attribute) GETSTRUCT(tuple))->attisdropped)
     {
         ReleaseSysCache(tuple);
         return NULL;
     }
     return tuple;
 }

◆ SearchSysCacheCopy()

HeapTuple SearchSysCacheCopy	(	int	cacheId,
		Datum	key1,
		Datum	key2,
		Datum	key3,
		Datum	key4
	)

Definition at line 1189 of file syscache.c.

References heap_copytuple(), HeapTupleIsValid, ReleaseSysCache(), and SearchSysCache().

 {
     HeapTuple   tuple,
                 newtuple;
 
     tuple = SearchSysCache(cacheId, key1, key2, key3, key4);
     if (!HeapTupleIsValid(tuple))
         return tuple;
     newtuple = heap_copytuple(tuple);
     ReleaseSysCache(tuple);
     return newtuple;
 }

◆ SearchSysCacheCopyAttName()

HeapTuple SearchSysCacheCopyAttName	(	Oid	relid,
		const char *	attname
	)

Definition at line 1291 of file syscache.c.

References heap_copytuple(), HeapTupleIsValid, ReleaseSysCache(), and SearchSysCacheAttName().

Referenced by ATExecAddColumn(), ATExecAddIdentity(), ATExecAlterColumnType(), ATExecDropColumn(), ATExecDropExpression(), ATExecDropIdentity(), ATExecDropNotNull(), ATExecSetCompression(), ATExecSetIdentity(), ATExecSetNotNull(), ATExecSetStatistics(), ATExecSetStorage(), ATPrepDropExpression(), MergeAttributesIntoExisting(), and renameatt_internal().

 {
     HeapTuple   tuple,
                 newtuple;
 
     tuple = SearchSysCacheAttName(relid, attname);
     if (!HeapTupleIsValid(tuple))
         return tuple;
     newtuple = heap_copytuple(tuple);
     ReleaseSysCache(tuple);
     return newtuple;
 }

◆ SearchSysCacheCopyAttNum()

HeapTuple SearchSysCacheCopyAttNum	(	Oid	relid,
		int16	attnum
	)

Definition at line 1354 of file syscache.c.

References heap_copytuple(), HeapTupleIsValid, ReleaseSysCache(), and SearchSysCacheAttNum().

Referenced by ATExecSetStatistics(), and SetIndexStorageProperties().

 {
     HeapTuple   tuple,
                 newtuple;
 
     tuple = SearchSysCacheAttNum(relid, attnum);
     if (!HeapTupleIsValid(tuple))
         return NULL;
     newtuple = heap_copytuple(tuple);
     ReleaseSysCache(tuple);
     return newtuple;
 }

◆ SearchSysCacheExists()

bool SearchSysCacheExists	(	int	cacheId,
		Datum	key1,
		Datum	key2,
		Datum	key3,
		Datum	key4
	)

Definition at line 1213 of file syscache.c.

References HeapTupleIsValid, ReleaseSysCache(), and SearchSysCache().

 {
     HeapTuple   tuple;
 
     tuple = SearchSysCache(cacheId, key1, key2, key3, key4);
     if (!HeapTupleIsValid(tuple))
         return false;
     ReleaseSysCache(tuple);
     return true;
 }

◆ SearchSysCacheExistsAttName()

bool SearchSysCacheExistsAttName	(	Oid	relid,
		const char *	attname
	)

Definition at line 1310 of file syscache.c.

References HeapTupleIsValid, ReleaseSysCache(), and SearchSysCacheAttName().

Referenced by RemoveInheritance().

 {
     HeapTuple   tuple;
 
     tuple = SearchSysCacheAttName(relid, attname);
     if (!HeapTupleIsValid(tuple))
         return false;
     ReleaseSysCache(tuple);
     return true;
 }

◆ SearchSysCacheList()

struct catclist* SearchSysCacheList	(	int	cacheId,
		int	nkeys,
		Datum	key1,
		Datum	key2,
		Datum	key3
	)

Definition at line 1440 of file syscache.c.

References elog, ERROR, PointerIsValid, SearchCatCacheList(), and SysCacheSize.

 {
     if (cacheId < 0 || cacheId >= SysCacheSize ||
         !PointerIsValid(SysCache[cacheId]))
         elog(ERROR, "invalid cache ID: %d", cacheId);
 
     return SearchCatCacheList(SysCache[cacheId], nkeys,
                               key1, key2, key3);
 }

◆ SysCacheGetAttr()

Datum SysCacheGetAttr	(	int	cacheId,
		HeapTuple	tup,
		AttrNumber	attributeNumber,
		bool *	isNull
	)

Definition at line 1388 of file syscache.c.

References Assert, elog, ERROR, heap_getattr, InitCatCachePhase2(), PointerIsValid, and SysCacheSize.

Referenced by AlterCollation(), AlterDomainValidateConstraint(), AlterForeignDataWrapper(), AlterForeignServer(), AlterFunction(), AlterRole(), AlterSchemaOwner_internal(), AlterTSDictionary(), AlterUserMapping(), ATExecAlterColumnGenericOptions(), ATExecChangeOwner(), ATExecGenericOptions(), ATExecSetOptions(), ATExecSetRelOptions(), ATExecValidateConstraint(), build_function_result_tupdesc_t(), build_replindex_scan_key(), CheckIndexCompatible(), compile_plperl_function(), compile_pltcl_function(), DeconstructFkConstraintRow(), DefineDomain(), do_compile(), DropSubscription(), ExecGrant_Attribute(), ExecGrant_Fdw(), ExecGrant_ForeignServer(), ExecGrant_Function(), ExecGrant_Language(), ExecGrant_Namespace(), ExecGrant_Relation(), ExecInitAgg(), expand_function_arguments(), fetch_function_defaults(), fetch_statentries_for_relation(), flatten_reloptions(), fmgr_c_validator(), fmgr_info_C_lang(), fmgr_info_cxt_security(), fmgr_internal_validator(), fmgr_security_definer(), fmgr_sql_validator(), fmgr_symbol(), func_get_detail(), FuncnameGetCandidates(), generate_partition_qual(), generateClonedExtStatsStmt(), generateClonedIndexStmt(), get_attoptions(), get_attribute_options(), get_attstatsslot(), get_default_acl_internal(), get_func_arg_info(), get_func_result_name(), get_func_trftypes(), get_index_column_opclass(), get_object_namespace(), get_qual_for_range(), get_relation_statistics(), get_role_password(), get_tablespace(), get_typdefault(), GetForeignColumnOptions(), GetForeignDataWrapperExtended(), GetForeignServerExtended(), GetForeignTable(), GetSubscription(), GetSubscriptionNotReadyRelations(), GetSubscriptionRelations(), GetSubscriptionRelState(), GetUserMapping(), inclusion_get_strategy_procinfo(), index_concurrently_create_copy(), index_opclass_options(), init_sql_fcache(), initialize_peragg(), inline_function(), inline_set_returning_function(), lookup_ts_dictionary_cache(), make_new_heap(), MatchNamedCall(), minmax_get_strategy_procinfo(), minmax_multi_get_strategy_procinfo(), pg_attribute_aclmask_ext(), pg_class_aclmask_ext(), pg_database_aclmask(), pg_foreign_data_wrapper_aclmask(), pg_foreign_server_aclmask(), pg_get_constraintdef_worker(), pg_get_function_arg_default(), pg_get_function_sqlbody(), pg_get_functiondef(), pg_get_indexdef_worker(), pg_get_partkeydef_worker(), pg_get_statisticsobj_worker(), pg_get_statisticsobjdef_expressions(), pg_language_aclmask(), pg_namespace_aclmask(), pg_newlocale_from_collation(), pg_proc_aclmask(), pg_tablespace_aclmask(), pg_type_aclmask(), plsample_func_handler(), PLy_procedure_create(), prepare_sql_fn_parse_info(), preprocess_aggref(), print_function_arguments(), print_function_sqlbody(), ProcedureCreate(), recordExtObjInitPriv(), refresh_by_match_merge(), RelationBuildPartitionDesc(), RelationBuildPartitionKey(), SetDefaultACL(), statext_dependencies_load(), statext_expressions_load(), statext_mcv_load(), statext_ndistinct_load(), StorePartitionBound(), test_indoption(), transformCallStmt(), transformFkeyCheckAttrs(), transformFkeyGetPrimaryKey(), transformIndexConstraint(), and TryReuseForeignKey().

 {
     /*
      * We just need to get the TupleDesc out of the cache entry, and then we
      * can apply heap_getattr().  Normally the cache control data is already
      * valid (because the caller recently fetched the tuple via this same
      * cache), but there are cases where we have to initialize the cache here.
      */
     if (cacheId < 0 || cacheId >= SysCacheSize ||
         !PointerIsValid(SysCache[cacheId]))
         elog(ERROR, "invalid cache ID: %d", cacheId);
     if (!PointerIsValid(SysCache[cacheId]->cc_tupdesc))
     {
         InitCatCachePhase2(SysCache[cacheId], false);
         Assert(PointerIsValid(SysCache[cacheId]->cc_tupdesc));
     }
 
     return heap_getattr(tup, attributeNumber,
                         SysCache[cacheId]->cc_tupdesc,
                         isNull);
 }

◆ SysCacheInvalidate()

void SysCacheInvalidate	(	int	cacheId,
		uint32	hashValue
	)

Definition at line 1460 of file syscache.c.

References CatCacheInvalidate(), elog, ERROR, PointerIsValid, and SysCacheSize.

Referenced by LocalExecuteInvalidationMessage().

 {
     if (cacheId < 0 || cacheId >= SysCacheSize)
         elog(ERROR, "invalid cache ID: %d", cacheId);
 
     /* if this cache isn't initialized yet, no need to do anything */
     if (!PointerIsValid(SysCache[cacheId]))
         return;
 
     CatCacheInvalidate(SysCache[cacheId], hashValue);
 }

Macros

Enumerations

Functions