syscache.c File Reference

#include "postgres.h"
#include "access/htup_details.h"
#include "catalog/pg_db_role_setting_d.h"
#include "catalog/pg_depend_d.h"
#include "catalog/pg_description_d.h"
#include "catalog/pg_seclabel_d.h"
#include "catalog/pg_shdepend_d.h"
#include "catalog/pg_shdescription_d.h"
#include "catalog/pg_shseclabel_d.h"
#include "common/int.h"
#include "lib/qunique.h"
#include "miscadmin.h"
#include "storage/lmgr.h"
#include "storage/lock.h"
#include "utils/catcache.h"
#include "utils/inval.h"
#include "utils/lsyscache.h"
#include "utils/rel.h"
#include "utils/syscache.h"
#include "catalog/syscache_info.h"

Include dependency graph for syscache.c:

Go to the source code of this file.

Data Structures
struct	cachedesc

Macros
#define	KEY(...)   VA_ARGS_NARGS(__VA_ARGS__), { __VA_ARGS__ }

Functions
	StaticAssertDecl (lengthof(cacheinfo)==SysCacheSize, "SysCacheSize does not match syscache.c's array")
static int	oid_compare (const void *a, const void *b)
void	InitCatalogCache (void)
void	InitCatalogCachePhase2 (void)
HeapTuple	SearchSysCache (SysCacheIdentifier cacheId, Datum key1, Datum key2, Datum key3, Datum key4)
HeapTuple	SearchSysCache1 (SysCacheIdentifier cacheId, Datum key1)
HeapTuple	SearchSysCache2 (SysCacheIdentifier cacheId, Datum key1, Datum key2)
HeapTuple	SearchSysCache3 (SysCacheIdentifier cacheId, Datum key1, Datum key2, Datum key3)
HeapTuple	SearchSysCache4 (SysCacheIdentifier cacheId, Datum key1, Datum key2, Datum key3, Datum key4)
void	ReleaseSysCache (HeapTuple tuple)
HeapTuple	SearchSysCacheLocked1 (SysCacheIdentifier cacheId, Datum key1)
HeapTuple	SearchSysCacheCopy (SysCacheIdentifier cacheId, Datum key1, Datum key2, Datum key3, Datum key4)
HeapTuple	SearchSysCacheLockedCopy1 (SysCacheIdentifier cacheId, Datum key1)
bool	SearchSysCacheExists (SysCacheIdentifier cacheId, Datum key1, Datum key2, Datum key3, Datum key4)
Oid	GetSysCacheOid (SysCacheIdentifier 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 (SysCacheIdentifier cacheId, HeapTuple tup, AttrNumber attributeNumber, bool *isNull)
Datum	SysCacheGetAttrNotNull (SysCacheIdentifier cacheId, HeapTuple tup, AttrNumber attributeNumber)
uint32	GetSysCacheHashValue (SysCacheIdentifier cacheId, Datum key1, Datum key2, Datum key3, Datum key4)
struct catclist *	SearchSysCacheList (SysCacheIdentifier cacheId, int nkeys, Datum key1, Datum key2, Datum key3)
void	SysCacheInvalidate (SysCacheIdentifier cacheId, uint32 hashValue)
bool	RelationInvalidatesSnapshotsOnly (Oid relid)
bool	RelationHasSysCache (Oid relid)
bool	RelationSupportsSysCache (Oid relid)

Variables
static CatCache *	SysCache [SysCacheSize]
static bool	CacheInitialized = false
static Oid	SysCacheRelationOid [SysCacheSize]
static int	SysCacheRelationOidSize
static Oid	SysCacheSupportingRelOid [SysCacheSize *2]
static int	SysCacheSupportingRelOidSize

Macro Definition Documentation

KEY

#define KEY

(

...

)

VA_ARGS_NARGS(__VA_ARGS__), { __VA_ARGS__ }

Definition at line 80 of file syscache.c.

Function Documentation

GetSysCacheHashValue()

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

Definition at line 656 of file syscache.c.

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

References elog, ERROR, fb(), GetCatCacheHashValue(), and SysCache.

GetSysCacheOid()

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

Definition at line 444 of file syscache.c.

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

References Assert, DatumGetObjectId(), fb(), heap_getattr(), HeapTupleIsValid, InvalidOid, ReleaseSysCache(), result, SearchSysCache(), and SysCache.

InitCatalogCache()

void InitCatalogCache

(

void

)

Definition at line 111 of file syscache.c.

{
    SysCacheIdentifier cacheId;
 
    Assert(!CacheInitialized);
 
    SysCacheRelationOidSize = SysCacheSupportingRelOidSize = 0;
 
    for (cacheId = 0; cacheId < SysCacheSize; cacheId++)
    {
        /*
         * Assert that every enumeration value defined in syscache.h has been
         * populated in the cacheinfo array.
         */
        Assert(OidIsValid(cacheinfo[cacheId].reloid));
        Assert(OidIsValid(cacheinfo[cacheId].indoid));
        /* .nbuckets and .key[] are checked by InitCatCache() */
 
        SysCache[cacheId] = InitCatCache(cacheId,
                                         cacheinfo[cacheId].reloid,
                                         cacheinfo[cacheId].indoid,
                                         cacheinfo[cacheId].nkeys,
                                         cacheinfo[cacheId].key,
                                         cacheinfo[cacheId].nbuckets);
        if (!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. */
    qsort(SysCacheRelationOid, SysCacheRelationOidSize,
          sizeof(Oid), oid_compare);
    SysCacheRelationOidSize =
        qunique(SysCacheRelationOid, SysCacheRelationOidSize, sizeof(Oid),
                oid_compare);
 
    qsort(SysCacheSupportingRelOid, SysCacheSupportingRelOidSize,
          sizeof(Oid), oid_compare);
    SysCacheSupportingRelOidSize =
        qunique(SysCacheSupportingRelOid, SysCacheSupportingRelOidSize,
                sizeof(Oid), oid_compare);
 
    CacheInitialized = true;
}

References Assert, CacheInitialized, elog, ERROR, fb(), InitCatCache(), lengthof, oid_compare(), OidIsValid, qsort, qunique(), RelationInvalidatesSnapshotsOnly(), SysCache, SysCacheRelationOid, SysCacheRelationOidSize, SysCacheSupportingRelOid, and SysCacheSupportingRelOidSize.

Referenced by InitPostgres().

InitCatalogCachePhase2()

void InitCatalogCachePhase2

(

void

)

Definition at line 181 of file syscache.c.

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

References Assert, CacheInitialized, fb(), InitCatCachePhase2(), and SysCache.

Referenced by RelationCacheInitializePhase3().

oid_compare()

static int oid_compare ( const void *  a, const void *  b  )

static

Definition at line 788 of file syscache.c.

{
    Oid         oa = *((const Oid *) a);
    Oid         ob = *((const Oid *) b);
 
    return pg_cmp_u32(oa, ob);
}

References a, b, fb(), and pg_cmp_u32().

Referenced by InitCatalogCache().

RelationHasSysCache()

bool RelationHasSysCache

(

Oid

relid

)

Definition at line 738 of file syscache.c.

{
    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;
}

References fb(), SysCacheRelationOid, and SysCacheRelationOidSize.

Referenced by GetNonHistoricCatalogSnapshot().

RelationInvalidatesSnapshotsOnly()

bool RelationInvalidatesSnapshotsOnly

(

Oid

relid

)

Definition at line 715 of file syscache.c.

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

References fb().

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

RelationSupportsSysCache()

bool RelationSupportsSysCache

(

Oid

relid

)

Definition at line 763 of file syscache.c.

{
    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;
}

References fb(), SysCacheSupportingRelOid, and SysCacheSupportingRelOidSize.

Referenced by heap_update(), and RelationIdIsInInitFile().

ReleaseSysCache()

void ReleaseSysCache

(

HeapTuple

tuple

)

Definition at line 265 of file syscache.c.

{
    ReleaseCatCache(tuple);
}

References ReleaseCatCache().

Referenced by aclitemout(), add_cast_to(), add_function_cost(), AddEnumLabel(), AddRoleMems(), agg_args_support_sendreceive(), AggregateCreate(), AlterDomainValidateConstraint(), AlterEnum(), AlterObjectRename_internal(), AlterOpFamily(), AlterPublicationOptions(), AlterPublicationSchemas(), AlterPublicationTables(), AlterRole(), AlterRoleSet(), AlterSchemaOwner(), AlterSchemaOwner_oid(), AlterStatistics(), AlterTSConfiguration(), AlterTSDictionary(), AlterType(), AlterTypeOwner(), AlterTypeOwner_oid(), AlterTypeRecurse(), amvalidate(), appendFunctionName(), appendOrderBySuffix(), assignOperTypes(), assignProcTypes(), ATAddForeignKeyConstraint(), ATDetachCheckNoForeignKeyRefs(), ATExecAddOf(), ATExecAlterColumnGenericOptions(), ATExecAlterColumnType(), ATExecAlterConstraint(), ATExecChangeOwner(), ATExecDropColumn(), ATExecSetExpression(), ATExecSetOptions(), ATExecSetRelOptions(), ATExecSetStatistics(), ATPostAlterTypeCleanup(), ATPrepAlterColumnType(), AttachPartitionForeignKey(), attribute_is_analyzable(), attribute_statistics_update(), blvalidate(), brincostestimate(), brinvalidate(), btvalidate(), build_coercion_expression(), build_edge_vertex_link_quals(), cached_function_compile(), CacheInvalidateRelcacheByRelid(), call_pltcl_start_proc(), CallStmtResultDesc(), check_amop_signature(), check_amproc_signature(), check_and_fetch_column_list(), check_default_text_search_config(), check_element_properties(), check_enable_rls(), check_for_column_name_collision(), check_object_ownership(), check_role(), check_session_authorization(), CheckFunctionValidatorAccess(), CheckIndexCompatible(), CheckMyDatabase(), CloneFkReferenced(), CloneFkReferencing(), coerce_type(), CollationIsVisibleExt(), compatible_oper(), compatible_oper_opid(), compile_plperl_function(), compile_pltcl_function(), compute_return_type(), ComputeIndexAttrs(), ComputePartitionAttrs(), ConstraintSetParentConstraint(), ConstructTupleDescriptor(), ConversionIsVisibleExt(), convert_column_name(), create_pe_for_element(), create_pg_locale(), create_pg_locale_builtin(), create_pg_locale_icu(), create_pg_locale_libc(), CreateCast(), CreateFunction(), CreateProceduralLanguage(), CreateRole(), CreateSchemaCommand(), CreateStatistics(), CreateTransform(), database_is_invalid_oid(), DefineCollation(), DefineDomain(), DefineIndex(), DefineOpClass(), DefineTSConfiguration(), DefineType(), delete_pg_statistic(), delete_pg_statistic_ext_data(), DeleteRelationTuple(), DeleteSequenceTuple(), deparseOpExpr(), deparseScalarArrayOpExpr(), DetachPartitionFinalize(), do_autovacuum(), DropObjectById(), DropRole(), DropSubscription(), enum_cmp_internal(), enum_in(), enum_out(), enum_recv(), enum_send(), errdatatype(), eval_const_expressions_mutator(), examine_indexcol_variable(), examine_simple_variable(), examine_variable(), ExecGrant_Attribute(), ExecGrant_common(), ExecGrant_Parameter(), ExecGrant_Relation(), ExecHashBuildSkewHash(), ExecInitAgg(), ExecuteCallStmt(), ExecuteDoStmt(), expand_all_col_privileges(), expand_vacuum_rel(), extended_statistics_update(), fetch_agg_sort_op(), fetch_fp_info(), fillTypeDesc(), find_coercion_pathway(), find_typmod_coercion_function(), fixup_whole_row_references(), flatten_reloptions(), fmgr_c_validator(), fmgr_info_cxt_security(), fmgr_info_other_lang(), fmgr_internal_validator(), fmgr_security_definer(), fmgr_sql_validator(), fmgr_symbol(), format_operator_extended(), format_operator_parts(), format_procedure_extended(), format_procedure_parts(), format_type_extended(), func_get_detail(), func_parallel(), func_strict(), func_volatile(), FuncNameAsType(), FunctionIsVisibleExt(), generate_collation_name(), generate_function_name(), generate_operator_clause(), generate_operator_name(), generate_partition_qual(), generate_qualified_relation_name(), generate_qualified_type_name(), generate_relation_name(), generateClonedExtStatsStmt(), generateClonedIndexStmt(), get_am_name(), get_am_type_oid(), get_and_validate_seq_info(), get_array_type(), get_attavgwidth(), get_attgenerated(), get_attname(), get_attnotnull(), get_attnum(), get_attoptions(), get_attribute_options(), get_attstatsslot(), get_atttype(), get_atttypetypmodcoll(), get_base_element_type(), get_collation(), get_collation_isdeterministic(), get_collation_name(), get_commutator(), get_constraint_index(), get_constraint_name(), get_constraint_type(), get_database_name(), get_db_info(), get_default_acl_internal(), get_default_partition_oid(), get_edge_oid(), get_element_property_expr(), get_element_relid(), get_element_type(), get_extension_name(), get_extension_schema(), get_func_leakproof(), get_func_name(), get_func_namespace(), get_func_nargs(), get_func_prokind(), get_func_result_name(), get_func_retset(), get_func_rettype(), get_func_signature(), get_func_support(), get_func_variadictype(), get_function_rows(), get_index_column_opclass(), get_index_isclustered(), get_index_isreplident(), get_index_isvalid(), get_language_name(), get_multirange_range(), get_namespace_name(), get_negator(), get_object_address_defacl(), get_object_address_opf_member(), get_object_address_type(), get_object_address_usermapping(), get_object_namespace(), get_op_opfamily_properties(), get_op_opfamily_sortfamily(), get_op_opfamily_strategy(), get_op_rettype(), get_opclass(), get_opclass_family(), get_opclass_input_type(), get_opclass_method(), get_opclass_name(), get_opclass_oid(), get_opclass_opfamily_and_input_type(), get_opcode(), get_opfamily_member(), get_opfamily_method(), get_opfamily_name(), get_opfamily_oid(), get_opfamily_proc(), get_opname(), get_oprjoin(), get_oprrest(), get_partition_bound_spec(), get_propgraph_label_name(), get_propgraph_property_name(), get_publication_name(), get_qual_for_range(), get_range_collation(), get_range_constructor2(), get_range_multirange(), get_range_subtype(), get_rel_name(), get_rel_namespace(), get_rel_persistence(), get_rel_relam(), get_rel_relispartition(), get_rel_relkind(), get_rel_tablespace(), get_rel_type_id(), get_relation_statistics(), get_relation_statistics_worker(), get_rewrite_oid(), get_ri_constraint_root(), get_role_password(), get_rolespec_name(), get_rte_attribute_is_dropped(), get_subscription_name(), get_tablespace(), get_transform_fromsql(), get_transform_tosql(), get_typ_typrelid(), get_typbyval(), get_typcollation(), get_typdefault(), get_type_category_preferred(), get_type_io_data(), get_typisdefined(), get_typlen(), get_typlenbyval(), get_typlenbyvalalign(), get_typmodin(), get_typstorage(), get_typsubscript(), get_typtype(), get_vertex_oid(), getBaseTypeAndTypmod(), getExtensionType(), GetFdwRoutineByServerId(), GetForeignColumnOptions(), GetForeignDataWrapperExtended(), GetForeignServerExtended(), GetForeignServerIdByRelId(), GetForeignTable(), GetIndexAmRoutineByAmId(), getObjectDescription(), getObjectIdentityParts(), getOpFamilyDescription(), getOpFamilyIdentity(), getProcedureTypeDescription(), GetPublication(), getPublicationSchemaInfo(), getRelationDescription(), getRelationIdentity(), getRelationTypeDescription(), GetSubscription(), GetSubscriptionRelState(), GetSysCacheOid(), getTypeBinaryInputInfo(), getTypeBinaryOutputInfo(), getTypeInputInfo(), getTypeOutputInfo(), GetUserMapping(), GetUserNameFromId(), ginvalidate(), gistvalidate(), has_bypassrls_privilege(), has_createrole_privilege(), has_rolreplication(), has_subclass(), hash_ok_operator(), hashvalidate(), have_createdb_privilege(), heap_drop_with_catalog(), inclusion_get_strategy_procinfo(), index_check_primary_key(), index_create(), index_create_copy(), index_drop(), index_get_partition(), indexam_property(), IndexGetRelation(), IndexSupportsBackwardScan(), init_database_collation(), initialize_peragg(), InitializeSessionUserId(), inline_function_in_from(), insert_property_record(), InsertRule(), internal_get_result_type(), interpret_function_parameter_list(), is_publishable_table(), IsBinaryCoercibleWithCast(), IsIndexUsableForFindingDeletedTuple(), load_domaintype_info(), load_rangetype_info(), logicalrep_write_tuple(), logicalrep_write_typ(), lookup_collation(), lookup_ts_config_cache(), lookup_ts_dictionary_cache(), lookup_ts_parser_cache(), lookup_type_cache(), LookupTypeNameOid(), make_callstmt_target(), make_inh_translation_list(), make_new_heap(), make_op(), make_propgraphdef_elements(), make_scalar_array_op(), map_sql_table_to_xmlschema(), map_sql_type_to_xml_name(), minmax_get_strategy_procinfo(), minmax_multi_get_strategy_procinfo(), nextval_internal(), object_aclmask_ext(), object_ownercheck(), op_hashjoinable(), op_input_types(), op_mergejoinable(), OpclassIsVisibleExt(), OperatorGet(), OperatorIsVisibleExt(), OpernameGetOprid(), OpfamilyIsVisibleExt(), ParseFuncOrColumn(), parseTypeString(), pg_attribute_aclcheck_all_ext(), pg_attribute_aclmask_ext(), pg_basetype(), pg_class_aclmask_ext(), pg_collation_actual_version(), pg_database_collation_actual_version(), pg_get_constraintdef_worker(), pg_get_database_ddl_internal(), pg_get_function_arg_default(), pg_get_function_arguments(), pg_get_function_identity_arguments(), pg_get_function_result(), pg_get_function_sqlbody(), pg_get_functiondef(), pg_get_indexdef_worker(), pg_get_partkeydef_worker(), pg_get_propgraphdef(), pg_get_role_ddl_internal(), pg_get_statisticsobj_worker(), pg_get_statisticsobjdef_expressions(), pg_get_tablespace_ddl_internal(), pg_get_userbyid(), pg_namespace_aclmask_ext(), pg_nextoid(), pg_parameter_acl_aclmask(), pg_parameter_aclmask(), pg_relation_filenode(), pg_relation_filepath(), pg_relation_is_publishable(), pg_sequence_parameters(), pg_type_aclmask_ext(), pgoutput_row_filter_init(), plperl_validator(), plpgsql_build_datatype(), plpgsql_compile_callback(), plpgsql_parse_cwordtype(), plpgsql_validator(), plpython3_validator(), plsample_func_handler(), plsample_trigger_handler(), PLy_procedure_create(), PLy_procedure_get(), postgres_fdw_get_connections_internal(), prepare_column_cache(), preprocess_aggref(), preprocessNamespacePath(), print_function_arguments(), ProcedureCreate(), pub_rf_contains_invalid_column(), RangeVarCallbackForAlterRelation(), RangeVarCallbackForAttachIndex(), RangeVarCallbackForDropRelation(), RangeVarCallbackForPolicy(), RangeVarCallbackForRenameAttribute(), RangeVarCallbackForRenameRule(), RangeVarCallbackForRenameTrigger(), RangeVarCallbackForStats(), RangeVarCallbackForTruncate(), RangeVarCallbackOwnsRelation(), recordExtObjInitPriv(), refresh_by_match_merge(), regclassout(), regcollationout(), regconfigout(), regdictionaryout(), regoperout(), regprocout(), regtypeout(), relation_statistics_update(), RelationBuildPartitionDesc(), RelationBuildPartitionKey(), RelationBuildPublicationDesc(), RelationCacheInitializePhase3(), RelationClearMissing(), relationHasPrimaryKey(), RelationInitIndexAccessInfo(), RelationInitTableAccessMethod(), RelationIsVisibleExt(), RelationReloadIndexInfo(), RemoveConstraintById(), removeExtObjInitPriv(), RemoveFunctionById(), RemoveOperatorById(), RemovePartitionKeyByRelId(), RemovePublicationById(), RemovePublicationRelById(), RemovePublicationSchemaById(), RemoveRoleFromInitPriv(), RemoveRoleFromObjectPolicy(), RemoveStatisticsById(), RemoveStatisticsDataById(), RemoveTSConfigurationById(), RemoveTypeById(), rename_constraint_internal(), RenameConstraint(), RenameRole(), replace_property_refs_mutator(), replorigin_by_name(), replorigin_by_oid(), replorigin_drop_by_name(), ResetSequence(), ResolveOpClass(), ri_GenerateQualCollation(), ri_LoadConstraintInfo(), roles_is_member_of(), SearchSysCacheAttName(), SearchSysCacheAttNum(), SearchSysCacheCopy(), SearchSysCacheCopyAttName(), SearchSysCacheCopyAttNum(), SearchSysCacheExists(), SearchSysCacheExistsAttName(), SearchSysCacheLocked1(), SearchSysCacheLockedCopy1(), sepgsql_proc_setattr(), sepgsql_relation_setattr(), sequence_options(), SetAttrMissing(), SetDefaultACL(), SetSequence(), simplify_function(), spgvalidate(), SPI_gettype(), statatt_get_type(), statext_dependencies_load(), statext_expressions_load(), statext_mcv_load(), statext_ndistinct_load(), StatisticsGetRelation(), StatisticsObjIsVisibleExt(), StoreAttrMissingVal(), superuser_arg(), transformCallStmt(), transformColumnDefinition(), transformColumnNameList(), transformColumnType(), transformFkeyCheckAttrs(), transformFkeyGetPrimaryKey(), transformGraphTablePropertyRef(), transformOfType(), triggered_change_notification(), tryAttachPartitionForeignKey(), TryReuseForeignKey(), TSConfigIsVisibleExt(), TSDictionaryIsVisibleExt(), TSParserIsVisibleExt(), TSTemplateIsVisibleExt(), TupleDescInitEntry(), typeidTypeRelid(), typeIsOfTypedTable(), TypeIsVisibleExt(), typenameTypeId(), typenameTypeIdAndMod(), typeOrDomainTypeRelid(), update_attstats(), upsert_pg_statistic_ext_data(), validatePartitionedIndex(), and verify_dictoptions().

SearchSysCache()

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

Definition at line 209 of file syscache.c.

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

References Assert, fb(), SearchCatCache(), and SysCache.

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

SearchSysCache1()

HeapTuple SearchSysCache1	(	SysCacheIdentifier	cacheId,
		Datum	key1
	)

Definition at line 221 of file syscache.c.

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

References Assert, fb(), SearchCatCache1(), and SysCache.

Referenced by aclitemout(), add_cast_to(), add_function_cost(), AddRoleMems(), agg_args_support_sendreceive(), AggregateCreate(), AlterDomainValidateConstraint(), AlterEnum(), AlterObjectRename_internal(), AlterOpFamily(), AlterSchemaOwner(), AlterSchemaOwner_oid(), AlterStatistics(), AlterTSDictionary(), AlterTypeOwner_oid(), AlterTypeRecurse(), amvalidate(), appendFunctionName(), appendOrderBySuffix(), assignOperTypes(), assignProcTypes(), ATAddForeignKeyConstraint(), ATDetachCheckNoForeignKeyRefs(), ATExecAlterColumnGenericOptions(), ATExecAlterConstraint(), ATExecChangeOwner(), ATExecSetRelOptions(), ATPostAlterTypeCleanup(), AttachPartitionForeignKey(), blvalidate(), brinvalidate(), btvalidate(), build_coercion_expression(), build_edge_vertex_link_quals(), cached_function_compile(), CacheInvalidateRelcacheByRelid(), call_pltcl_start_proc(), CallStmtResultDesc(), check_amop_signature(), check_amproc_signature(), check_default_text_search_config(), check_element_properties(), check_enable_rls(), check_object_ownership(), check_role(), check_session_authorization(), CheckFunctionValidatorAccess(), CheckIndexCompatible(), CheckMyDatabase(), CloneFkReferenced(), CloneFkReferencing(), CollationIsVisibleExt(), compile_plperl_function(), compile_pltcl_function(), ConstraintSetParentConstraint(), ConstructTupleDescriptor(), ConversionIsVisibleExt(), create_pe_for_element(), create_pg_locale(), create_pg_locale_builtin(), create_pg_locale_icu(), create_pg_locale_libc(), CreateCast(), CreateEventTrigger(), CreateFunction(), CreateProceduralLanguage(), CreateSchemaCommand(), CreateTransform(), database_is_invalid_oid(), DefineCollation(), DefineIndex(), DefineOpClass(), DefineTSConfiguration(), DeleteRelationTuple(), DeleteSequenceTuple(), deparseOpExpr(), deparseScalarArrayOpExpr(), DetachPartitionFinalize(), do_autovacuum(), DropObjectById(), DropRole(), enum_cmp_internal(), enum_out(), enum_send(), errdatatype(), eval_const_expressions_mutator(), ExecGrant_Parameter(), ExecInitAgg(), ExecuteCallStmt(), ExecuteDoStmt(), expand_vacuum_rel(), fetch_agg_sort_op(), fetch_fp_info(), fillTypeDesc(), fixup_whole_row_references(), flatten_reloptions(), fmgr_c_validator(), fmgr_info_cxt_security(), fmgr_info_other_lang(), fmgr_internal_validator(), fmgr_security_definer(), fmgr_sql_validator(), fmgr_symbol(), format_operator_extended(), format_operator_parts(), format_procedure_extended(), format_procedure_parts(), format_type_extended(), func_get_detail(), func_parallel(), func_strict(), func_volatile(), FunctionIsVisibleExt(), generate_collation_name(), generate_function_name(), generate_operator_clause(), generate_operator_name(), generate_partition_qual(), generate_qualified_relation_name(), generate_qualified_type_name(), generate_relation_name(), generateClonedExtStatsStmt(), generateClonedIndexStmt(), get_am_name(), get_am_type_oid(), get_and_validate_seq_info(), get_array_type(), get_attstatsslot(), get_base_element_type(), get_collation(), get_collation_isdeterministic(), get_collation_name(), get_commutator(), get_constraint_index(), get_constraint_name(), get_constraint_type(), get_database_name(), get_db_info(), get_default_partition_oid(), get_element_relid(), get_element_type(), get_extension_name(), get_extension_schema(), get_func_leakproof(), get_func_name(), get_func_namespace(), get_func_nargs(), get_func_prokind(), get_func_result_name(), get_func_retset(), get_func_rettype(), get_func_signature(), get_func_support(), get_func_variadictype(), get_function_rows(), get_index_column_opclass(), get_index_isclustered(), get_index_isreplident(), get_index_isvalid(), get_language_name(), get_multirange_range(), get_namespace_name(), get_negator(), get_object_address_defacl(), get_object_address_usermapping(), get_object_namespace(), get_op_rettype(), get_opclass(), get_opclass_family(), get_opclass_input_type(), get_opclass_method(), get_opclass_name(), get_opclass_opfamily_and_input_type(), get_opcode(), get_opfamily_method(), get_opfamily_name(), get_opname(), get_oprjoin(), get_oprrest(), get_partition_bound_spec(), get_propgraph_label_name(), get_propgraph_property_name(), get_publication_name(), get_qual_for_range(), get_range_collation(), get_range_constructor2(), get_range_multirange(), get_range_subtype(), get_rel_name(), get_rel_namespace(), get_rel_persistence(), get_rel_relam(), get_rel_relispartition(), get_rel_relkind(), get_rel_tablespace(), get_rel_type_id(), get_relation_statistics(), get_ri_constraint_root(), get_role_password(), get_rolespec_tuple(), get_subscription_name(), get_tablespace(), get_typ_typrelid(), get_typbyval(), get_typcollation(), get_typdefault(), get_type_category_preferred(), get_type_io_data(), get_typisdefined(), get_typlen(), get_typlenbyval(), get_typlenbyvalalign(), get_typmodin(), get_typstorage(), get_typsubscript(), get_typtype(), getBaseTypeAndTypmod(), getExtensionType(), GetFdwRoutineByServerId(), GetForeignDataWrapperExtended(), GetForeignServerExtended(), GetForeignServerIdByRelId(), GetForeignTable(), GetIndexAmRoutineByAmId(), getObjectDescription(), getObjectIdentityParts(), getOpFamilyDescription(), getOpFamilyIdentity(), getProcedureTypeDescription(), GetPublication(), getPublicationSchemaInfo(), getRelationDescription(), getRelationIdentity(), getRelationTypeDescription(), GetSubscription(), GetTSConfigTuple(), getTypeBinaryInputInfo(), getTypeBinaryOutputInfo(), getTypeInputInfo(), getTypeOutputInfo(), GetUserNameFromId(), ginvalidate(), gistvalidate(), has_bypassrls_privilege(), has_createrole_privilege(), has_rolreplication(), has_subclass(), hash_ok_operator(), hashvalidate(), have_createdb_privilege(), heap_drop_with_catalog(), index_create(), index_create_copy(), index_drop(), index_get_partition(), indexam_property(), IndexGetRelation(), IndexSupportsBackwardScan(), init_database_collation(), initialize_peragg(), InitializeSessionUserId(), inline_function_in_from(), insert_property_record(), internal_get_result_type(), is_publishable_table(), IsIndexUsableForFindingDeletedTuple(), left_oper(), load_domaintype_info(), load_rangetype_info(), logicalrep_write_tuple(), logicalrep_write_typ(), lookup_ts_config_cache(), lookup_ts_dictionary_cache(), lookup_ts_parser_cache(), lookup_type_cache(), LookupTypeNameExtended(), make_callstmt_target(), make_new_heap(), make_propgraphdef_elements(), map_sql_table_to_xmlschema(), map_sql_type_to_xml_name(), nextval_internal(), object_aclmask_ext(), object_ownercheck(), op_hashjoinable(), op_input_types(), op_mergejoinable(), OpClassCacheLookup(), OpclassIsVisibleExt(), oper(), OperatorIsVisibleExt(), OpFamilyCacheLookup(), OpfamilyIsVisibleExt(), ParseFuncOrColumn(), pg_attribute_aclcheck_all_ext(), pg_attribute_aclmask_ext(), pg_basetype(), pg_class_aclmask_ext(), pg_collation_actual_version(), pg_database_collation_actual_version(), pg_get_constraintdef_worker(), pg_get_database_ddl_internal(), pg_get_function_arg_default(), pg_get_function_arguments(), pg_get_function_identity_arguments(), pg_get_function_result(), pg_get_function_sqlbody(), pg_get_functiondef(), pg_get_indexdef_worker(), pg_get_partkeydef_worker(), pg_get_propgraphdef(), pg_get_role_ddl_internal(), pg_get_statisticsobj_worker(), pg_get_statisticsobjdef_expressions(), pg_get_tablespace_ddl_internal(), pg_get_userbyid(), pg_namespace_aclmask_ext(), pg_parameter_acl_aclmask(), pg_parameter_aclmask(), pg_relation_filenode(), pg_relation_filepath(), pg_relation_is_publishable(), pg_sequence_parameters(), pg_type_aclmask_ext(), plperl_validator(), plpgsql_build_datatype(), plpgsql_compile_callback(), plpgsql_parse_cwordtype(), plpgsql_validator(), plpython3_validator(), plsample_func_handler(), plsample_trigger_handler(), PLy_procedure_create(), PLy_procedure_get(), postgres_fdw_get_connections_internal(), prepare_column_cache(), preprocess_aggref(), preprocessNamespacePath(), print_function_arguments(), RangeVarCallbackForAlterRelation(), RangeVarCallbackForAttachIndex(), RangeVarCallbackForDropRelation(), RangeVarCallbackForPolicy(), RangeVarCallbackForRenameAttribute(), RangeVarCallbackForRenameRule(), RangeVarCallbackForRenameTrigger(), RangeVarCallbackForStats(), RangeVarCallbackForTruncate(), RangeVarCallbackOwnsRelation(), recordExtObjInitPriv(), refresh_by_match_merge(), regclassout(), regcollationout(), regconfigout(), regdictionaryout(), regoperout(), regprocout(), regtypeout(), relation_statistics_update(), RelationBuildPartitionDesc(), RelationBuildPartitionKey(), RelationBuildPublicationDesc(), RelationCacheInitializePhase3(), relationHasPrimaryKey(), RelationInitIndexAccessInfo(), RelationInitTableAccessMethod(), RelationIsVisibleExt(), RelationReloadIndexInfo(), RemoveConstraintById(), removeExtObjInitPriv(), RemoveFunctionById(), RemoveOperatorById(), RemovePartitionKeyByRelId(), RemovePublicationById(), RemovePublicationRelById(), RemovePublicationSchemaById(), RemoveRoleFromInitPriv(), RemoveRoleFromObjectPolicy(), RemoveStatisticsById(), RemoveTSConfigurationById(), RemoveTypeById(), rename_constraint_internal(), RenameConstraint(), RenameRole(), replorigin_by_name(), replorigin_by_oid(), replorigin_drop_by_name(), ResetSequence(), ResolveOpClass(), ri_GenerateQualCollation(), ri_LoadConstraintInfo(), roles_is_member_of(), SearchSysCacheLocked1(), sepgsql_proc_setattr(), sepgsql_relation_setattr(), sequence_options(), SetSequence(), simplify_function(), spgvalidate(), SPI_gettype(), StatisticsGetRelation(), StatisticsObjIsVisibleExt(), superuser_arg(), transformCallStmt(), transformFkeyCheckAttrs(), transformFkeyGetPrimaryKey(), triggered_change_notification(), tryAttachPartitionForeignKey(), TryReuseForeignKey(), TSConfigIsVisibleExt(), TSDictionaryIsVisibleExt(), TSParserIsVisibleExt(), TSTemplateIsVisibleExt(), TupleDescInitEntry(), typeidType(), typeidTypeRelid(), typeIsOfTypedTable(), TypeIsVisibleExt(), typeOrDomainTypeRelid(), validatePartitionedIndex(), and verify_dictoptions().

SearchSysCache2()

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

Definition at line 231 of file syscache.c.

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

References Assert, fb(), SearchCatCache2(), and SysCache.

Referenced by AddEnumLabel(), AlterPublicationOptions(), AlterPublicationSchemas(), AlterPublicationTables(), attribute_is_analyzable(), CastCreate(), check_and_fetch_column_list(), check_for_column_name_collision(), convert_column_name(), CreateTransform(), delete_pg_statistic_ext_data(), DropSubscription(), enum_in(), enum_recv(), ExecGrant_Attribute(), expand_all_col_privileges(), extended_statistics_update(), find_coercion_pathway(), find_typmod_coercion_function(), fixup_whole_row_references(), get_attgenerated(), get_attname(), get_attnotnull(), get_attoptions(), get_attribute_options(), get_atttype(), get_atttypetypmodcoll(), get_edge_oid(), get_element_property_expr(), get_object_address_usermapping(), get_relation_statistics_worker(), get_rewrite_oid(), get_rte_attribute_is_dropped(), get_transform_fromsql(), get_transform_tosql(), get_vertex_oid(), GetForeignColumnOptions(), GetSubscriptionRelState(), GetUserMapping(), index_check_primary_key(), index_create_copy(), InsertRule(), IsBinaryCoercibleWithCast(), pg_attribute_aclcheck_all_ext(), pg_attribute_aclmask_ext(), pgoutput_row_filter_init(), pub_rf_contains_invalid_column(), recordExtObjInitPriv(), RelationClearMissing(), removeExtObjInitPriv(), RemoveStatisticsDataById(), replace_property_refs_mutator(), SearchSysCacheAttName(), SearchSysCacheAttNum(), statatt_get_type(), statext_dependencies_load(), statext_expressions_load(), statext_mcv_load(), statext_ndistinct_load(), StoreAttrMissingVal(), transformGraphTablePropertyRef(), and upsert_pg_statistic_ext_data().

SearchSysCache3()

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

Definition at line 241 of file syscache.c.

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

References Assert, fb(), SearchCatCache3(), and SysCache.

Referenced by AddRoleMems(), attribute_statistics_update(), brincostestimate(), DefineOpClass(), delete_pg_statistic(), examine_indexcol_variable(), 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().

SearchSysCache4()

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

Definition at line 251 of file syscache.c.

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

References Assert, fb(), SearchCatCache4(), and SysCache.

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().

SearchSysCacheAttName()

HeapTuple SearchSysCacheAttName	(	Oid	relid,
		const char *	attname
	)

Definition at line 476 of file syscache.c.

{
    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;
}

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

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

SearchSysCacheAttNum()

HeapTuple SearchSysCacheAttNum	(	Oid	relid,
		int16	attnum
	)

Definition at line 539 of file syscache.c.

{
    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;
}

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

Referenced by ATExecSetStatistics(), and SearchSysCacheCopyAttNum().

SearchSysCacheCopy()

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

Definition at line 375 of file syscache.c.

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

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

SearchSysCacheCopyAttName()

HeapTuple SearchSysCacheCopyAttName	(	Oid	relid,
		const char *	attname
	)

Definition at line 499 of file syscache.c.

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

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

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

SearchSysCacheCopyAttNum()

HeapTuple SearchSysCacheCopyAttNum	(	Oid	relid,
		int16	attnum
	)

Definition at line 562 of file syscache.c.

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

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

Referenced by dropconstraint_internal(), pg_get_acl(), set_attnotnull(), and SetIndexStorageProperties().

SearchSysCacheExists()

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

Definition at line 421 of file syscache.c.

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

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

SearchSysCacheExistsAttName()

bool SearchSysCacheExistsAttName	(	Oid	relid,
		const char *	attname
	)

Definition at line 518 of file syscache.c.

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

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

Referenced by attribute_statistics_update(), and RemoveInheritance().

SearchSysCacheList()

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

Definition at line 672 of file syscache.c.

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

References elog, ERROR, fb(), catclist::nkeys, SearchCatCacheList(), and SysCache.

SearchSysCacheLocked1()

HeapTuple SearchSysCacheLocked1	(	SysCacheIdentifier	cacheId,
		Datum	key1
	)

Definition at line 283 of file syscache.c.

{
    CatCache   *cache = SysCache[cacheId];
    ItemPointerData tid;
    LOCKTAG     tag;
 
    /*----------
     * Since inplace updates may happen just before our LockTuple(), we must
     * return content acquired after LockTuple() of the TID we return.  If we
     * just fetched twice instead of looping, the following sequence would
     * defeat our locking:
     *
     * GRANT:   SearchSysCache1() = TID (1,5)
     * GRANT:   LockTuple(pg_class, (1,5))
     * [no more inplace update of (1,5) until we release the lock]
     * CLUSTER: SearchSysCache1() = TID (1,5)
     * CLUSTER: heap_update() = TID (1,8)
     * CLUSTER: COMMIT
     * GRANT:   SearchSysCache1() = TID (1,8)
     * GRANT:   return (1,8) from SearchSysCacheLocked1()
     * VACUUM:  SearchSysCache1() = TID (1,8)
     * VACUUM:  LockTuple(pg_class, (1,8))  # two TIDs now locked for one rel
     * VACUUM:  inplace update
     * GRANT:   heap_update() = (1,9)  # lose inplace update
     *
     * In the happy case, this takes two fetches, one to determine the TID to
     * lock and another to get the content and confirm the TID didn't change.
     *
     * This is valid even if the row gets updated to a new TID, the old TID
     * becomes LP_UNUSED, and the row gets updated back to its old TID.  We'd
     * still hold the right LOCKTAG_TUPLE and a copy of the row captured after
     * the LOCKTAG_TUPLE.
     */
    ItemPointerSetInvalid(&tid);
    for (;;)
    {
        HeapTuple   tuple;
        LOCKMODE    lockmode = InplaceUpdateTupleLock;
 
        tuple = SearchSysCache1(cacheId, key1);
        if (ItemPointerIsValid(&tid))
        {
            if (!HeapTupleIsValid(tuple))
            {
                LockRelease(&tag, lockmode, false);
                return tuple;
            }
            if (ItemPointerEquals(&tid, &tuple->t_self))
                return tuple;
            LockRelease(&tag, lockmode, false);
        }
        else if (!HeapTupleIsValid(tuple))
            return tuple;
 
        tid = tuple->t_self;
        ReleaseSysCache(tuple);
 
        /*
         * Do like LockTuple(rel, &tid, lockmode).  While cc_relisshared won't
         * change from one iteration to another, it may have been a temporary
         * "false" until our first SearchSysCache1().
         */
        SET_LOCKTAG_TUPLE(tag,
                          cache->cc_relisshared ? InvalidOid : MyDatabaseId,
                          cache->cc_reloid,
                          ItemPointerGetBlockNumber(&tid),
                          ItemPointerGetOffsetNumber(&tid));
        (void) LockAcquire(&tag, lockmode, false, false);
 
        /*
         * If an inplace update just finished, ensure we process the syscache
         * inval.
         *
         * If a heap_update() call just released its LOCKTAG_TUPLE, we'll
         * probably find the old tuple and reach "tuple concurrently updated".
         * If that heap_update() aborts, our LOCKTAG_TUPLE blocks inplace
         * updates while our caller works.
         */
        AcceptInvalidationMessages();
    }
}

References AcceptInvalidationMessages(), catcache::cc_relisshared, catcache::cc_reloid, fb(), HeapTupleIsValid, InplaceUpdateTupleLock, InvalidOid, ItemPointerEquals(), ItemPointerGetBlockNumber(), ItemPointerGetOffsetNumber(), ItemPointerIsValid(), ItemPointerSetInvalid(), LockAcquire(), LockRelease(), MyDatabaseId, ReleaseSysCache(), SearchSysCache1(), SET_LOCKTAG_TUPLE, SysCache, and HeapTupleData::t_self.

Referenced by ATExecSetRelOptions(), ExecGrant_common(), ExecGrant_Relation(), and SearchSysCacheLockedCopy1().

SearchSysCacheLockedCopy1()

HeapTuple SearchSysCacheLockedCopy1	(	SysCacheIdentifier	cacheId,
		Datum	key1
	)

Definition at line 400 of file syscache.c.

{
    HeapTuple   tuple,
                newtuple;
 
    tuple = SearchSysCacheLocked1(cacheId, key1);
    if (!HeapTupleIsValid(tuple))
        return tuple;
    newtuple = heap_copytuple(tuple);
    ReleaseSysCache(tuple);
    return newtuple;
}

References fb(), heap_copytuple(), HeapTupleIsValid, ReleaseSysCache(), and SearchSysCacheLocked1().

Referenced by AlterRelationNamespaceInternal(), get_catalog_object_by_oid_extended(), RelationSetNewRelfilenumber(), RenameDatabase(), RenameRelationInternal(), SetDatabaseHasLoginEventTriggers(), SetRelationTableSpace(), and update_relispartition().

StaticAssertDecl()

StaticAssertDecl	(	lengthof(cacheinfo)	= =SysCacheSize,
		"SysCacheSize does not match syscache.c's array"
	)

SysCacheGetAttr()

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

Definition at line 596 of file syscache.c.

{
    /*
     * 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 || !SysCache[cacheId])
        elog(ERROR, "invalid cache ID: %d", cacheId);
    if (!SysCache[cacheId]->cc_tupdesc)
    {
        InitCatCachePhase2(SysCache[cacheId], false);
        Assert(SysCache[cacheId]->cc_tupdesc);
    }
 
    return heap_getattr(tup, attributeNumber,
                        SysCache[cacheId]->cc_tupdesc,
                        isNull);
}

References Assert, elog, ERROR, fb(), heap_getattr(), InitCatCachePhase2(), and SysCache.

Referenced by AlterCollation(), AlterForeignDataWrapper(), AlterForeignServer(), AlterFunction(), AlterPublicationTables(), AlterRole(), AlterSchemaOwner_internal(), AlterTSDictionary(), AlterUserMapping(), ATExecAlterColumnGenericOptions(), ATExecChangeOwner(), ATExecGenericOptions(), ATExecSetOptions(), ATExecSetRelOptions(), attribute_is_analyzable(), build_function_result_tupdesc_t(), check_and_fetch_column_list(), CheckMyDatabase(), compile_plperl_function(), create_pg_locale(), create_pg_locale_icu(), DeconstructFkConstraintRow(), DefineCollation(), DefineDomain(), DropSubscription(), ExecGrant_Attribute(), ExecGrant_common(), ExecGrant_Parameter(), ExecGrant_Relation(), ExecInitAgg(), expand_function_arguments(), extended_statistics_update(), fetch_statentries_for_relation(), flatten_reloptions(), fmgr_security_definer(), fmgr_sql_validator(), FuncnameGetCandidates(), generate_partition_qual(), generateClonedExtStatsStmt(), generateClonedIndexStmt(), get_attoptions(), get_attribute_options(), get_db_info(), get_default_acl_internal(), get_func_arg_info(), get_func_trftypes(), get_partition_bound_spec(), get_relation_statistics(), get_role_password(), get_tablespace(), get_typdefault(), GetForeignColumnOptions(), GetForeignDataWrapperExtended(), GetForeignServerExtended(), GetForeignTable(), GetSubscription(), GetSubscriptionRelations(), GetSubscriptionRelState(), GetUserMapping(), index_create_copy(), initialize_peragg(), inline_function(), inline_sql_function_in_from(), lookup_ts_dictionary_cache(), make_new_heap(), MatchNamedCall(), object_aclmask_ext(), pg_attribute_aclcheck_all_ext(), pg_attribute_aclmask_ext(), pg_class_aclmask_ext(), pg_get_acl(), pg_get_constraintdef_worker(), pg_get_database_ddl_internal(), pg_get_function_arg_default(), pg_get_function_sqlbody(), pg_get_functiondef(), pg_get_publication_tables(), pg_get_role_ddl_internal(), pg_get_tablespace_ddl_internal(), pg_namespace_aclmask_ext(), pg_parameter_acl_aclmask(), pg_parameter_aclmask(), pg_type_aclmask_ext(), pgoutput_row_filter_init(), plsample_func_handler(), plsample_trigger_handler(), PLy_procedure_create(), prepare_sql_fn_parse_info(), preprocess_aggref(), print_function_arguments(), ProcedureCreate(), pub_rf_contains_invalid_column(), recordExtObjInitPriv(), RelationBuildPartitionDesc(), RelationBuildPartitionKey(), SetDefaultACL(), sql_compile_callback(), statext_dependencies_load(), statext_expressions_load(), statext_mcv_load(), statext_ndistinct_load(), StorePartitionBound(), SysCacheGetAttrNotNull(), and transformCallStmt().

SysCacheGetAttrNotNull()

Datum SysCacheGetAttrNotNull	(	SysCacheIdentifier	cacheId,
		HeapTuple	tup,
		AttrNumber	attributeNumber
	)

Definition at line 626 of file syscache.c.

{
    bool        isnull;
    Datum       attr;
 
    attr = SysCacheGetAttr(cacheId, tup, attributeNumber, &isnull);
 
    if (isnull)
    {
        elog(ERROR,
             "unexpected null value in cached tuple for catalog %s column %s",
             get_rel_name(cacheinfo[cacheId].reloid),
             NameStr(TupleDescAttr(SysCache[cacheId]->cc_tupdesc, attributeNumber - 1)->attname));
    }
 
    return attr;
}

References attname, elog, ERROR, fb(), get_rel_name(), NameStr, SysCache, SysCacheGetAttr(), and TupleDescAttr().

Referenced by AlterCollation(), AlterDomainValidateConstraint(), ATExecAlterCheckConstrEnforceability(), build_edge_vertex_link_quals(), build_function_result_tupdesc_t(), build_replindex_scan_key(), CheckIndexCompatible(), CheckMyDatabase(), compile_plperl_function(), compile_pltcl_function(), create_pg_locale(), create_pg_locale_builtin(), create_pg_locale_icu(), create_pg_locale_libc(), DeconstructFkConstraintRow(), DropSubscription(), ExecGrant_common(), ExecGrant_Parameter(), expand_stxkind(), extractNotNullColumn(), fetch_function_defaults(), fetch_statentries_for_relation(), fmgr_c_validator(), fmgr_info_C_lang(), fmgr_info_cxt_security(), fmgr_internal_validator(), fmgr_sql_validator(), fmgr_symbol(), func_get_detail(), generateClonedExtStatsStmt(), generateClonedIndexStmt(), get_attstatsslot(), get_db_info(), get_element_property_expr(), get_func_result_name(), get_index_column_opclass(), get_object_namespace(), get_qual_for_range(), getObjectDescription(), getObjectIdentityParts(), GetSubscription(), inclusion_get_strategy_procinfo(), index_create_copy(), index_opclass_options(), inline_function(), inline_function_in_from(), IsIndexUsableForReplicaIdentityFull(), minmax_get_strategy_procinfo(), minmax_multi_get_strategy_procinfo(), object_aclmask_ext(), object_ownercheck(), pg_collation_actual_version(), pg_database_collation_actual_version(), pg_get_constraintdef_worker(), pg_get_functiondef(), pg_get_indexdef_worker(), pg_get_partkeydef_worker(), pg_get_statisticsobj_worker(), pg_get_statisticsobjdef_expressions(), plpgsql_compile_callback(), PLy_procedure_create(), print_function_sqlbody(), ProcedureCreate(), QueueCheckConstraintValidation(), refresh_by_match_merge(), RelationBuildPartitionKey(), RemoveRoleFromInitPriv(), replace_property_refs_mutator(), sql_compile_callback(), test_indoption(), transformFkeyCheckAttrs(), transformFkeyGetPrimaryKey(), transformIndexConstraint(), and TryReuseForeignKey().

SysCacheInvalidate()

void SysCacheInvalidate	(	SysCacheIdentifier	cacheId,
		uint32	hashValue
	)

Definition at line 691 of file syscache.c.

{
    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 (!SysCache[cacheId])
        return;
 
    CatCacheInvalidate(SysCache[cacheId], hashValue);
}

References CatCacheInvalidate(), elog, ERROR, fb(), and SysCache.

Referenced by LocalExecuteInvalidationMessage().

Variable Documentation

CacheInitialized

bool CacheInitialized = false

static

Definition at line 89 of file syscache.c.

Referenced by InitCatalogCache(), and InitCatalogCachePhase2().

SysCache

CatCache* SysCache[SysCacheSize]

static

Definition at line 87 of file syscache.c.

Referenced by GetSysCacheHashValue(), GetSysCacheOid(), InitCatalogCache(), InitCatalogCachePhase2(), SearchSysCache(), SearchSysCache1(), SearchSysCache2(), SearchSysCache3(), SearchSysCache4(), SearchSysCacheList(), SearchSysCacheLocked1(), SysCacheGetAttr(), SysCacheGetAttrNotNull(), and SysCacheInvalidate().

SysCacheRelationOid

Oid SysCacheRelationOid[SysCacheSize]

static

Definition at line 92 of file syscache.c.

Referenced by InitCatalogCache(), and RelationHasSysCache().

SysCacheRelationOidSize

int SysCacheRelationOidSize

static

Definition at line 93 of file syscache.c.

Referenced by InitCatalogCache(), and RelationHasSysCache().

SysCacheSupportingRelOid

Oid SysCacheSupportingRelOid[SysCacheSize *2]

static

Definition at line 96 of file syscache.c.

Referenced by InitCatalogCache(), and RelationSupportsSysCache().

SysCacheSupportingRelOidSize

int SysCacheSupportingRelOidSize

static

Definition at line 97 of file syscache.c.

Referenced by InitCatalogCache(), and RelationSupportsSysCache().