#include "postgres.h"
#include "access/htup_details.h"
#include "access/sysattr.h"
#include "catalog/indexing.h"
#include "catalog/pg_aggregate.h"
#include "catalog/pg_am.h"
#include "catalog/pg_amop.h"
#include "catalog/pg_amproc.h"
#include "catalog/pg_auth_members.h"
#include "catalog/pg_authid.h"
#include "catalog/pg_cast.h"
#include "catalog/pg_collation.h"
#include "catalog/pg_constraint.h"
#include "catalog/pg_conversion.h"
#include "catalog/pg_database.h"
#include "catalog/pg_db_role_setting.h"
#include "catalog/pg_default_acl.h"
#include "catalog/pg_depend.h"
#include "catalog/pg_description.h"
#include "catalog/pg_enum.h"
#include "catalog/pg_event_trigger.h"
#include "catalog/pg_foreign_data_wrapper.h"
#include "catalog/pg_foreign_server.h"
#include "catalog/pg_foreign_table.h"
#include "catalog/pg_language.h"
#include "catalog/pg_namespace.h"
#include "catalog/pg_opclass.h"
#include "catalog/pg_operator.h"
#include "catalog/pg_opfamily.h"
#include "catalog/pg_partitioned_table.h"
#include "catalog/pg_proc.h"
#include "catalog/pg_publication.h"
#include "catalog/pg_publication_rel.h"
#include "catalog/pg_range.h"
#include "catalog/pg_rewrite.h"
#include "catalog/pg_seclabel.h"
#include "catalog/pg_sequence.h"
#include "catalog/pg_shdepend.h"
#include "catalog/pg_shdescription.h"
#include "catalog/pg_shseclabel.h"
#include "catalog/pg_replication_origin.h"
#include "catalog/pg_statistic.h"
#include "catalog/pg_statistic_ext.h"
#include "catalog/pg_subscription.h"
#include "catalog/pg_subscription_rel.h"
#include "catalog/pg_tablespace.h"
#include "catalog/pg_transform.h"
#include "catalog/pg_ts_config.h"
#include "catalog/pg_ts_config_map.h"
#include "catalog/pg_ts_dict.h"
#include "catalog/pg_ts_parser.h"
#include "catalog/pg_ts_template.h"
#include "catalog/pg_type.h"
#include "catalog/pg_user_mapping.h"
#include "utils/rel.h"
#include "utils/catcache.h"
#include "utils/syscache.h"

Include dependency graph for syscache.c:

Data Structures
struct	cachedesc

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

void	InitCatalogCache (void)

void	InitCatalogCachePhase2 (void)

HeapTuple	SearchSysCache (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, 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)

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, Datum key4)

void	SysCacheInvalidate (int cacheId, uint32 hashValue)

bool	RelationInvalidatesSnapshotsOnly (Oid relid)

bool	RelationHasSysCache (Oid relid)

bool	RelationSupportsSysCache (Oid relid)

Variables
static const struct cachedesc	cacheinfo []

static CatCache *	SysCache [SysCacheSize]

static bool	CacheInitialized = false

static Oid	SysCacheRelationOid [SysCacheSize]

static int	SysCacheRelationOidSize

static Oid	SysCacheSupportingRelOid [SysCacheSize *2]

static int	SysCacheSupportingRelOidSize

Function Documentation

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

Definition at line 1314 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);
 }

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

Definition at line 1178 of file syscache.c.

References HeapTupleGetOid, HeapTupleIsValid, InvalidOid, ReleaseSysCache(), result, and SearchSysCache().

 {
     HeapTuple   tuple;
     Oid         result;
 
     tuple = SearchSysCache(cacheId, key1, key2, key3, key4);
     if (!HeapTupleIsValid(tuple))
         return InvalidOid;
     result = HeapTupleGetOid(tuple);
     ReleaseSysCache(tuple);
     return result;
 }

void InitCatalogCache ( void )

Definition at line 998 of file syscache.c.

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

Referenced by InitPostgres().

 {
     int         cacheId;
     int         i,
                 j;
 
     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);
     for (i = 1, j = 0; i < SysCacheRelationOidSize; i++)
     {
         if (SysCacheRelationOid[i] != SysCacheRelationOid[j])
             SysCacheRelationOid[++j] = SysCacheRelationOid[i];
     }
     SysCacheRelationOidSize = j + 1;
 
     pg_qsort(SysCacheSupportingRelOid, SysCacheSupportingRelOidSize,
              sizeof(Oid), oid_compare);
     for (i = 1, j = 0; i < SysCacheSupportingRelOidSize; i++)
     {
         if (SysCacheSupportingRelOid[i] != SysCacheSupportingRelOid[j])
             SysCacheSupportingRelOid[++j] = SysCacheSupportingRelOid[i];
     }
     SysCacheSupportingRelOidSize = j + 1;
 
     CacheInitialized = true;
 }

void InitCatalogCachePhase2 ( void )

Definition at line 1071 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);
 }

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

static

Definition at line 1448 of file syscache.c.

Referenced by InitCatalogCache().

 {
     Oid         oa = *((const Oid *) a);
     Oid         ob = *((const Oid *) b);
 
     if (oa == ob)
         return 0;
     return (oa > ob) ? 1 : -1;
 }

bool RelationHasSysCache ( Oid relid )

Definition at line 1398 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;
 }

bool RelationInvalidatesSnapshotsOnly ( Oid relid )

Definition at line 1375 of file syscache.c.

References DbRoleSettingRelationId, DependRelationId, DescriptionRelationId, SecLabelRelationId, SharedDependRelationId, SharedDescriptionRelationId, and SharedSecLabelRelationId.

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

bool RelationSupportsSysCache ( Oid relid )

Definition at line 1423 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;
 }

void ReleaseSysCache ( HeapTuple tuple )

Definition at line 1117 of file syscache.c.

References ReleaseCatCache().

Referenced by aclitemout(), AddEnumLabel(), AddRoleMems(), AggregateCreate(), AlterDomainValidateConstraint(), AlterEnum(), AlterObjectRename_internal(), AlterOpFamily(), AlterRole(), AlterRoleSet(), AlterSchemaOwner(), AlterSchemaOwner_oid(), AlterTSConfiguration(), AlterTSDictionary(), AlterTypeOwner(), AlterTypeOwner_oid(), amvalidate(), appendAggOrderBy(), appendFunctionName(), assignOperTypes(), assignProcTypes(), ATAddForeignKeyConstraint(), ATExecAddColumn(), ATExecAddOf(), ATExecAlterColumnGenericOptions(), ATExecAlterColumnType(), ATExecChangeOwner(), ATExecDropColumn(), ATExecDropNotNull(), ATExecSetOptions(), ATExecSetRelOptions(), ATPostAlterTypeCleanup(), ATPrepAlterColumnType(), blvalidate(), brincostestimate(), brinvalidate(), btcostestimate(), btvalidate(), build_coercion_expression(), BuildIndexValueDescription(), BuildTupleRemapInfo(), CacheInvalidateRelcacheByRelid(), call_pltcl_start_proc(), check_amop_signature(), check_amproc_signature(), check_enable_rls(), check_for_column_name_collision(), check_hash_func_signature(), check_role(), check_safe_enum_use(), check_session_authorization(), check_TSCurrentConfig(), CheckFunctionValidatorAccess(), CheckIndexCompatible(), CheckMyDatabase(), cluster(), cluster_rel(), coerce_type(), CollationIsVisible(), column_privilege_check(), compatible_oper(), compatible_oper_opid(), compile_plperl_function(), compile_pltcl_function(), compute_return_type(), ComputeIndexAttrs(), ComputePartitionAttrs(), ConstructTupleDescriptor(), ConversionIsVisible(), create_proc_lang(), CreateCast(), CreateFunction(), CreateRole(), CreateSchemaCommand(), CreateStatistics(), CreateTransform(), DefineCollation(), DefineDomain(), DefineIndex(), DefineOpClass(), DefineTSConfiguration(), DefineType(), DeleteRelationTuple(), DeleteSequenceTuple(), DelRoleMems(), deparseOpExpr(), deparseScalarArrayOpExpr(), do_autovacuum(), do_compile(), do_setval(), dropdb(), DropProceduralLanguageById(), DropRole(), DropSubscription(), enum_cmp_internal(), enum_in(), enum_out(), enum_recv(), enum_send(), errdatatype(), eval_const_expressions_mutator(), examine_simple_variable(), examine_variable(), ExecGrant_Attribute(), ExecGrant_Database(), ExecGrant_Fdw(), ExecGrant_ForeignServer(), ExecGrant_Function(), ExecGrant_Language(), ExecGrant_Namespace(), ExecGrant_Relation(), ExecGrant_Tablespace(), ExecGrant_Type(), ExecHashBuildSkewHash(), ExecInitAgg(), ExecuteDoStmt(), expand_all_col_privileges(), fetch_agg_sort_op(), fetch_fp_info(), 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(), format_operator_internal(), format_operator_parts(), format_procedure_internal(), format_procedure_parts(), format_type_internal(), func_get_detail(), func_parallel(), func_strict(), func_volatile(), FuncNameAsType(), FunctionIsVisible(), generate_collation_name(), generate_function_name(), generate_operator_name(), generate_partition_qual(), generate_qualified_relation_name(), generate_relation_name(), generateClonedIndexStmt(), get_agg_clause_costs_walker(), get_am_name(), get_am_type_oid(), get_array_type(), get_attavgwidth(), get_attidentity(), get_attname(), get_attnum(), get_attribute_options(), get_attstatsslot(), get_atttype(), get_atttypetypmodcoll(), get_atttypmod(), get_base_element_type(), get_collation(), get_collation_name(), get_commutator(), get_constraint_name(), get_database_name(), get_db_info(), get_default_acl_internal(), get_element_type(), get_func_cost(), get_func_leakproof(), get_func_name(), get_func_namespace(), get_func_nargs(), get_func_result_name(), get_func_retset(), get_func_rettype(), get_func_rows(), get_func_signature(), get_func_variadictype(), get_language_name(), 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_name(), get_opclass_oid(), get_opcode(), get_oper_expr(), get_opfamily_member(), get_opfamily_oid(), get_opfamily_proc(), get_opname(), get_oprjoin(), get_oprrest(), get_publication_name(), get_range_subtype(), get_rel_name(), get_rel_namespace(), get_rel_oids(), get_rel_persistence(), get_rel_relkind(), get_rel_tablespace(), get_rel_type_id(), get_relation_statistics(), get_rewrite_oid(), get_role_password(), get_rolespec_name(), get_rte_attribute_is_dropped(), get_rte_attribute_type(), 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_typtype(), getBaseTypeAndTypmod(), GetFdwRoutineByServerId(), GetForeignColumnOptions(), GetForeignDataWrapper(), GetForeignServer(), GetForeignServerIdByRelId(), GetForeignTable(), GetIndexAmRoutineByAmId(), getObjectDescription(), getObjectIdentityParts(), getOpFamilyDescription(), getOpFamilyIdentity(), getProcedureTypeDescription(), GetPublication(), getRelationDescription(), getRelationIdentity(), GetRelationPublicationActions(), getRelationTypeDescription(), GetSubscription(), GetSubscriptionRelState(), GetSysCacheOid(), getTypeBinaryInputInfo(), getTypeBinaryOutputInfo(), getTypeInputInfo(), getTypeOutputInfo(), GetUserMapping(), GetUserNameFromId(), ginvalidate(), gistproperty(), gistvalidate(), has_bypassrls_privilege(), has_createrole_privilege(), has_rolinherit(), has_rolreplication(), has_subclass(), hash_ok_operator(), hashvalidate(), have_createdb_privilege(), heap_drop_with_catalog(), inclusion_get_strategy_procinfo(), index_check_primary_key(), index_drop(), indexam_property(), IndexGetRelation(), IndexSupportsBackwardScan(), init_sql_fcache(), initialize_peragg(), InitializeSessionUserId(), inline_set_returning_function(), InsertRule(), internal_get_result_type(), interpret_function_parameter_list(), IsBinaryCoercible(), load_domaintype_info(), load_rangetype_info(), logicalrep_write_tuple(), logicalrep_write_typ(), lookup_collation(), lookup_collation_cache(), lookup_ts_config_cache(), lookup_ts_dictionary_cache(), lookup_ts_parser_cache(), lookup_type_cache(), LookupAggWithArgs(), LookupTypeNameOid(), make_new_heap(), make_op(), make_scalar_array_op(), map_sql_table_to_xmlschema(), map_sql_type_to_xml_name(), mark_index_clustered(), minmax_get_strategy_procinfo(), mv_GenerateOper(), nextval_internal(), op_hashjoinable(), op_input_types(), op_mergejoinable(), OpclassIsVisible(), OperatorGet(), OperatorIsVisible(), OpernameGetOprid(), OpfamilyIsVisible(), ParseFuncOrColumn(), parseTypeString(), pg_attribute_aclcheck_all(), pg_attribute_aclmask(), pg_class_aclmask(), pg_class_ownercheck(), pg_collation_actual_version(), pg_collation_ownercheck(), pg_conversion_ownercheck(), pg_database_aclmask(), pg_database_ownercheck(), pg_event_trigger_ownercheck(), pg_foreign_data_wrapper_aclmask(), pg_foreign_data_wrapper_ownercheck(), pg_foreign_server_aclmask(), pg_foreign_server_ownercheck(), pg_get_function_arg_default(), pg_get_function_arguments(), pg_get_function_identity_arguments(), pg_get_function_result(), pg_get_functiondef(), pg_get_indexdef_worker(), pg_get_partkeydef_worker(), pg_get_statisticsobj_worker(), pg_get_userbyid(), pg_language_aclmask(), pg_language_ownercheck(), pg_namespace_aclmask(), pg_namespace_ownercheck(), pg_newlocale_from_collation(), pg_opclass_ownercheck(), pg_oper_ownercheck(), pg_opfamily_ownercheck(), pg_proc_aclmask(), pg_proc_ownercheck(), pg_publication_ownercheck(), pg_relation_filenode(), pg_relation_filepath(), pg_relation_is_publishable(), pg_sequence_parameters(), pg_statistics_object_ownercheck(), pg_subscription_ownercheck(), pg_tablespace_aclmask(), pg_tablespace_ownercheck(), pg_ts_config_ownercheck(), pg_ts_dict_ownercheck(), pg_type_aclmask(), pg_type_ownercheck(), pgfdw_reject_incomplete_xact_state_change(), plperl_validator(), plpgsql_build_datatype(), plpgsql_compile(), plpgsql_parse_cwordtype(), plpgsql_parse_wordtype(), plpgsql_validator(), plpython_validator(), PLy_input_tuple_funcs(), PLy_output_tuple_funcs(), PLy_procedure_argument_valid(), PLy_procedure_create(), PLy_procedure_get(), PLy_spi_prepare(), PLyString_ToComposite(), prepare_column_cache(), print_function_arguments(), ProcedureCreate(), RangeVarCallbackForAlterRelation(), RangeVarCallbackForDropRelation(), RangeVarCallbackForPolicy(), RangeVarCallbackForRenameAttribute(), RangeVarCallbackForRenameRule(), RangeVarCallbackForRenameTrigger(), RangeVarCallbackOwnsRelation(), recomputeNamespacePath(), recordExtObjInitPriv(), regclassout(), regconfigout(), regdictionaryout(), regoperout(), regprocout(), regtypeout(), relation_mark_replica_identity(), RelationBuildPartitionDesc(), RelationBuildPartitionKey(), RelationCacheInitializePhase3(), relationHasPrimaryKey(), RelationHasUnloggedIndex(), RelationInitIndexAccessInfo(), RelationIsVisible(), RelationReloadIndexInfo(), RemoveAccessMethodById(), RemoveConstraintById(), RemoveEventTriggerById(), removeExtObjInitPriv(), RemoveForeignDataWrapperById(), RemoveForeignServerById(), RemoveFunctionById(), RemoveObjects(), RemoveOpClassById(), RemoveOperatorById(), RemoveOpFamilyById(), RemovePartitionKeyByRelId(), RemovePublicationById(), RemovePublicationRelById(), RemoveSchemaById(), RemoveStatisticsById(), RemoveTSConfigurationById(), RemoveTSDictionaryById(), RemoveTSParserById(), RemoveTSTemplateById(), RemoveTypeById(), RemoveUserMappingById(), rename_constraint_internal(), RenameConstraint(), RenameRole(), replorigin_by_name(), replorigin_by_oid(), replorigin_drop(), ResetSequence(), ResolveOpClass(), ri_add_cast_to(), ri_GenerateQual(), ri_GenerateQualCollation(), ri_LoadConstraintInfo(), SearchSysCacheAttName(), SearchSysCacheCopy(), SearchSysCacheCopyAttName(), SearchSysCacheExists(), SearchSysCacheExistsAttName(), sepgsql_proc_setattr(), sepgsql_relation_setattr(), sequence_options(), SetDefaultACL(), simplify_function(), spgvalidate(), SPI_gettype(), statext_dependencies_load(), statext_ndistinct_load(), statext_store(), StatisticsObjIsVisible(), superuser_arg(), test_indoption(), transformArrayType(), transformColumnDefinition(), transformColumnNameList(), transformColumnType(), transformFkeyCheckAttrs(), transformFkeyGetPrimaryKey(), transformOfType(), triggered_change_notification(), TryReuseForeignKey(), TSConfigIsVisible(), TSDictionaryIsVisible(), TSParserIsVisible(), TSTemplateIsVisible(), TupleDescInitEntry(), typeidTypeRelid(), typeIsOfTypedTable(), TypeIsVisible(), typenameTypeId(), typenameTypeIdAndMod(), update_attstats(), and verify_dictoptions().

 {
     ReleaseCatCache(tuple);
 }

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

Definition at line 1099 of file syscache.c.

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

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

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

HeapTuple SearchSysCacheAttName	(	Oid	relid,
		const char *	attname
	)

Definition at line 1205 of file syscache.c.

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

Referenced by ATExecAlterColumnGenericOptions(), ATExecDropColumn(), ATExecSetOptions(), ATPrepAlterColumnType(), ComputeIndexAttrs(), ComputePartitionAttrs(), CreateStatistics(), get_attnum(), plpgsql_parse_cwordtype(), SearchSysCacheCopyAttName(), SearchSysCacheExistsAttName(), 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;
 }

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

Definition at line 1131 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;
 }

HeapTuple SearchSysCacheCopyAttName	(	Oid	relid,
		const char *	attname
	)

Definition at line 1228 of file syscache.c.

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

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

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

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

Definition at line 1155 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;
 }

bool SearchSysCacheExistsAttName	(	Oid	relid,
		const char *	attname
	)

Definition at line 1247 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;
 }

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

Definition at line 1331 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, key4);
 }

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

Definition at line 1279 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(), ATExecDetachPartition(), ATExecGenericOptions(), ATExecSetOptions(), ATExecSetRelOptions(), build_function_result_tupdesc_t(), build_replindex_scan_key(), CheckIndexCompatible(), compile_plperl_function(), compile_pltcl_function(), DefineDomain(), do_compile(), DropSubscription(), ExecGrant_Attribute(), ExecGrant_Fdw(), ExecGrant_ForeignServer(), ExecGrant_Function(), ExecGrant_Language(), ExecGrant_Namespace(), ExecGrant_Relation(), ExecInitAgg(), 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(), func_get_detail(), generate_partition_qual(), generateClonedIndexStmt(), get_attribute_options(), get_attstatsslot(), get_default_acl_internal(), get_func_arg_info(), get_func_result_name(), get_func_trftypes(), get_object_namespace(), get_role_password(), get_tablespace(), get_typdefault(), GetForeignColumnOptions(), GetForeignDataWrapper(), GetForeignServer(), GetForeignTable(), GetSubscription(), GetSubscriptionRelState(), GetUserMapping(), gistproperty(), inclusion_get_strategy_procinfo(), init_sql_fcache(), initialize_peragg(), inline_function(), inline_set_returning_function(), lookup_ts_dictionary_cache(), make_new_heap(), MatchNamedCall(), minmax_get_strategy_procinfo(), pg_attribute_aclmask(), pg_class_aclmask(), pg_database_aclmask(), pg_foreign_data_wrapper_aclmask(), pg_foreign_server_aclmask(), pg_get_constraintdef_worker(), pg_get_function_arg_default(), pg_get_functiondef(), pg_get_indexdef_worker(), pg_get_partkeydef_worker(), pg_get_statisticsobj_worker(), pg_language_aclmask(), pg_namespace_aclmask(), pg_newlocale_from_collation(), pg_proc_aclmask(), pg_tablespace_aclmask(), pg_type_aclmask(), PLy_procedure_create(), prepare_sql_fn_parse_info(), print_function_arguments(), ProcedureCreate(), recordExtObjInitPriv(), RelationBuildPartitionDesc(), RelationBuildPartitionKey(), ri_LoadConstraintInfo(), SetDefaultACL(), statext_dependencies_load(), statext_ndistinct_load(), StorePartitionBound(), test_indoption(), transformFkeyCheckAttrs(), transformFkeyGetPrimaryKey(), transformIndexConstraint(), TryReuseForeignKey(), and validateCheckConstraint().

 {
     /*
      * 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);
 }

void SysCacheInvalidate	(	int	cacheId,
		uint32	hashValue
	)

Definition at line 1351 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);
 }