pg_query 5.0.0 → 6.0.0

data/ext/pg_query/include/utils/relcache.h

@@ -1,158 +0,0 @@
-/*-------------------------------------------------------------------------
- *
- * relcache.h
- *	  Relation descriptor cache definitions.
- *
- *
- * Portions Copyright (c) 1996-2023, PostgreSQL Global Development Group
- * Portions Copyright (c) 1994, Regents of the University of California
- *
- * src/include/utils/relcache.h
- *
- *-------------------------------------------------------------------------
- */
-#ifndef RELCACHE_H
-#define RELCACHE_H
-
-#include "access/tupdesc.h"
-#include "common/relpath.h"
-#include "nodes/bitmapset.h"
-
-
-/*
- * Name of relcache init file(s), used to speed up backend startup
- */
-#define RELCACHE_INIT_FILENAME	"pg_internal.init"
-
-typedef struct RelationData *Relation;
-
-/* ----------------
- *		RelationPtr is used in the executor to support index scans
- *		where we have to keep track of several index relations in an
- *		array.  -cim 9/10/89
- * ----------------
- */
-typedef Relation *RelationPtr;
-
-/*
- * Routines to open (lookup) and close a relcache entry
- */
-extern Relation RelationIdGetRelation(Oid relationId);
-extern void RelationClose(Relation relation);
-
-/*
- * Routines to compute/retrieve additional cached information
- */
-extern List *RelationGetFKeyList(Relation relation);
-extern List *RelationGetIndexList(Relation relation);
-extern List *RelationGetStatExtList(Relation relation);
-extern Oid	RelationGetPrimaryKeyIndex(Relation relation);
-extern Oid	RelationGetReplicaIndex(Relation relation);
-extern List *RelationGetIndexExpressions(Relation relation);
-extern List *RelationGetDummyIndexExpressions(Relation relation);
-extern List *RelationGetIndexPredicate(Relation relation);
-extern Datum *RelationGetIndexRawAttOptions(Relation indexrel);
-extern bytea **RelationGetIndexAttOptions(Relation relation, bool copy);
-
-/*
- * Which set of columns to return by RelationGetIndexAttrBitmap.
- */
-typedef enum IndexAttrBitmapKind
-{
-	INDEX_ATTR_BITMAP_KEY,
-	INDEX_ATTR_BITMAP_PRIMARY_KEY,
-	INDEX_ATTR_BITMAP_IDENTITY_KEY,
-	INDEX_ATTR_BITMAP_HOT_BLOCKING,
-	INDEX_ATTR_BITMAP_SUMMARIZED
-} IndexAttrBitmapKind;
-
-extern Bitmapset *RelationGetIndexAttrBitmap(Relation relation,
-											 IndexAttrBitmapKind attrKind);
-
-extern Bitmapset *RelationGetIdentityKeyBitmap(Relation relation);
-
-extern void RelationGetExclusionInfo(Relation indexRelation,
-									 Oid **operators,
-									 Oid **procs,
-									 uint16 **strategies);
-
-extern void RelationInitIndexAccessInfo(Relation relation);
-
-/* caller must include pg_publication.h */
-struct PublicationDesc;
-extern void RelationBuildPublicationDesc(Relation relation,
-										 struct PublicationDesc *pubdesc);
-
-extern void RelationInitTableAccessMethod(Relation relation);
-
-/*
- * Routines to support ereport() reports of relation-related errors
- */
-extern int	errtable(Relation rel);
-extern int	errtablecol(Relation rel, int attnum);
-extern int	errtablecolname(Relation rel, const char *colname);
-extern int	errtableconstraint(Relation rel, const char *conname);
-
-/*
- * Routines for backend startup
- */
-extern void RelationCacheInitialize(void);
-extern void RelationCacheInitializePhase2(void);
-extern void RelationCacheInitializePhase3(void);
-
-/*
- * Routine to create a relcache entry for an about-to-be-created relation
- */
-extern Relation RelationBuildLocalRelation(const char *relname,
-										   Oid relnamespace,
-										   TupleDesc tupDesc,
-										   Oid relid,
-										   Oid accessmtd,
-										   RelFileNumber relfilenumber,
-										   Oid reltablespace,
-										   bool shared_relation,
-										   bool mapped_relation,
-										   char relpersistence,
-										   char relkind);
-
-/*
- * Routines to manage assignment of new relfilenumber to a relation
- */
-extern void RelationSetNewRelfilenumber(Relation relation, char persistence);
-extern void RelationAssumeNewRelfilelocator(Relation relation);
-
-/*
- * Routines for flushing/rebuilding relcache entries in various scenarios
- */
-extern void RelationForgetRelation(Oid rid);
-
-extern void RelationCacheInvalidateEntry(Oid relationId);
-
-extern void RelationCacheInvalidate(bool debug_discard);
-
-extern void RelationCloseSmgrByOid(Oid relationId);
-
-#ifdef USE_ASSERT_CHECKING
-extern void AssertPendingSyncs_RelationCache(void);
-#else
-#define AssertPendingSyncs_RelationCache() do {} while (0)
-#endif
-extern void AtEOXact_RelationCache(bool isCommit);
-extern void AtEOSubXact_RelationCache(bool isCommit, SubTransactionId mySubid,
-									  SubTransactionId parentSubid);
-
-/*
- * Routines to help manage rebuilding of relcache init files
- */
-extern bool RelationIdIsInInitFile(Oid relationId);
-extern void RelationCacheInitFilePreInvalidate(void);
-extern void RelationCacheInitFilePostInvalidate(void);
-extern void RelationCacheInitFileRemove(void);
-
-/* should be used only by relcache.c and catcache.c */
-extern PGDLLIMPORT bool criticalRelcachesBuilt;
-
-/* should be used only by relcache.c and postinit.c */
-extern PGDLLIMPORT bool criticalSharedRelcachesBuilt;
-
-#endif							/* RELCACHE_H */

data/ext/pg_query/include/utils/reltrigger.h

@@ -1,81 +0,0 @@
-/*-------------------------------------------------------------------------
- *
- * reltrigger.h
- *	  POSTGRES relation trigger definitions.
- *
- *
- * Portions Copyright (c) 1996-2023, PostgreSQL Global Development Group
- * Portions Copyright (c) 1994, Regents of the University of California
- *
- * src/include/utils/reltrigger.h
- *
- *-------------------------------------------------------------------------
- */
-#ifndef RELTRIGGER_H
-#define RELTRIGGER_H
-
-
-/*
- * These struct really belongs to trigger.h, but we put it separately so that
- * it can be cleanly included in rel.h and other places.
- */
-
-typedef struct Trigger
-{
-	Oid			tgoid;			/* OID of trigger (pg_trigger row) */
-	/* Remaining fields are copied from pg_trigger, see pg_trigger.h */
-	char	   *tgname;
-	Oid			tgfoid;
-	int16		tgtype;
-	char		tgenabled;
-	bool		tgisinternal;
-	bool		tgisclone;
-	Oid			tgconstrrelid;
-	Oid			tgconstrindid;
-	Oid			tgconstraint;
-	bool		tgdeferrable;
-	bool		tginitdeferred;
-	int16		tgnargs;
-	int16		tgnattr;
-	int16	   *tgattr;
-	char	  **tgargs;
-	char	   *tgqual;
-	char	   *tgoldtable;
-	char	   *tgnewtable;
-} Trigger;
-
-typedef struct TriggerDesc
-{
-	Trigger    *triggers;		/* array of Trigger structs */
-	int			numtriggers;	/* number of array entries */
-
-	/*
-	 * These flags indicate whether the array contains at least one of each
-	 * type of trigger.  We use these to skip searching the array if not.
-	 */
-	bool		trig_insert_before_row;
-	bool		trig_insert_after_row;
-	bool		trig_insert_instead_row;
-	bool		trig_insert_before_statement;
-	bool		trig_insert_after_statement;
-	bool		trig_update_before_row;
-	bool		trig_update_after_row;
-	bool		trig_update_instead_row;
-	bool		trig_update_before_statement;
-	bool		trig_update_after_statement;
-	bool		trig_delete_before_row;
-	bool		trig_delete_after_row;
-	bool		trig_delete_instead_row;
-	bool		trig_delete_before_statement;
-	bool		trig_delete_after_statement;
-	/* there are no row-level truncate triggers */
-	bool		trig_truncate_before_statement;
-	bool		trig_truncate_after_statement;
-	/* Is there at least one trigger specifying each transition relation? */
-	bool		trig_insert_new_table;
-	bool		trig_update_old_table;
-	bool		trig_update_new_table;
-	bool		trig_delete_old_table;
-} TriggerDesc;
-
-#endif							/* RELTRIGGER_H */

data/ext/pg_query/include/utils/resowner.h

@@ -1,86 +0,0 @@
-/*-------------------------------------------------------------------------
- *
- * resowner.h
- *	  POSTGRES resource owner definitions.
- *
- * Query-lifespan resources are tracked by associating them with
- * ResourceOwner objects.  This provides a simple mechanism for ensuring
- * that such resources are freed at the right time.
- * See utils/resowner/README for more info.
- *
- *
- * Portions Copyright (c) 1996-2023, PostgreSQL Global Development Group
- * Portions Copyright (c) 1994, Regents of the University of California
- *
- * src/include/utils/resowner.h
- *
- *-------------------------------------------------------------------------
- */
-#ifndef RESOWNER_H
-#define RESOWNER_H
-
-
-/*
- * ResourceOwner objects are an opaque data structure known only within
- * resowner.c.
- */
-typedef struct ResourceOwnerData *ResourceOwner;
-
-
-/*
- * Globally known ResourceOwners
- */
-extern PGDLLIMPORT ResourceOwner CurrentResourceOwner;
-extern PGDLLIMPORT ResourceOwner CurTransactionResourceOwner;
-extern PGDLLIMPORT ResourceOwner TopTransactionResourceOwner;
-extern PGDLLIMPORT ResourceOwner AuxProcessResourceOwner;
-
-/*
- * Resource releasing is done in three phases: pre-locks, locks, and
- * post-locks.  The pre-lock phase must release any resources that are
- * visible to other backends (such as pinned buffers); this ensures that
- * when we release a lock that another backend may be waiting on, it will
- * see us as being fully out of our transaction.  The post-lock phase
- * should be used for backend-internal cleanup.
- */
-typedef enum
-{
-	RESOURCE_RELEASE_BEFORE_LOCKS,
-	RESOURCE_RELEASE_LOCKS,
-	RESOURCE_RELEASE_AFTER_LOCKS
-} ResourceReleasePhase;
-
-/*
- *	Dynamically loaded modules can get control during ResourceOwnerRelease
- *	by providing a callback of this form.
- */
-typedef void (*ResourceReleaseCallback) (ResourceReleasePhase phase,
-										 bool isCommit,
-										 bool isTopLevel,
-										 void *arg);
-
-
-/*
- * Functions in resowner.c
- */
-
-/* generic routines */
-extern ResourceOwner ResourceOwnerCreate(ResourceOwner parent,
-										 const char *name);
-extern void ResourceOwnerRelease(ResourceOwner owner,
-								 ResourceReleasePhase phase,
-								 bool isCommit,
-								 bool isTopLevel);
-extern void ResourceOwnerReleaseAllPlanCacheRefs(ResourceOwner owner);
-extern void ResourceOwnerDelete(ResourceOwner owner);
-extern ResourceOwner ResourceOwnerGetParent(ResourceOwner owner);
-extern void ResourceOwnerNewParent(ResourceOwner owner,
-								   ResourceOwner newparent);
-extern void RegisterResourceReleaseCallback(ResourceReleaseCallback callback,
-											void *arg);
-extern void UnregisterResourceReleaseCallback(ResourceReleaseCallback callback,
-											  void *arg);
-extern void CreateAuxProcessResourceOwner(void);
-extern void ReleaseAuxProcessResources(bool isCommit);
-
-#endif							/* RESOWNER_H */

data/ext/pg_query/include/utils/ruleutils.h

@@ -1,52 +0,0 @@
-/*-------------------------------------------------------------------------
- *
- * ruleutils.h
- *		Declarations for ruleutils.c
- *
- * Portions Copyright (c) 1996-2023, PostgreSQL Global Development Group
- * Portions Copyright (c) 1994, Regents of the University of California
- *
- * src/include/utils/ruleutils.h
- *
- *-------------------------------------------------------------------------
- */
-#ifndef RULEUTILS_H
-#define RULEUTILS_H
-
-#include "nodes/nodes.h"
-#include "nodes/parsenodes.h"
-#include "nodes/pg_list.h"
-
-struct Plan;					/* avoid including plannodes.h here */
-struct PlannedStmt;
-
-/* Flags for pg_get_indexdef_columns_extended() */
-#define RULE_INDEXDEF_PRETTY		0x01
-#define RULE_INDEXDEF_KEYS_ONLY		0x02	/* ignore included attributes */
-
-extern char *pg_get_indexdef_string(Oid indexrelid);
-extern char *pg_get_indexdef_columns(Oid indexrelid, bool pretty);
-extern char *pg_get_indexdef_columns_extended(Oid indexrelid,
-											  bits16 flags);
-extern char *pg_get_querydef(Query *query, bool pretty);
-
-extern char *pg_get_partkeydef_columns(Oid relid, bool pretty);
-extern char *pg_get_partconstrdef_string(Oid partitionId, char *aliasname);
-
-extern char *pg_get_constraintdef_command(Oid constraintId);
-extern char *deparse_expression(Node *expr, List *dpcontext,
-								bool forceprefix, bool showimplicit);
-extern List *deparse_context_for(const char *aliasname, Oid relid);
-extern List *deparse_context_for_plan_tree(struct PlannedStmt *pstmt,
-										   List *rtable_names);
-extern List *set_deparse_context_plan(List *dpcontext,
-									  struct Plan *plan, List *ancestors);
-extern List *select_rtable_names_for_explain(List *rtable,
-											 Bitmapset *rels_used);
-extern char *generate_collation_name(Oid collid);
-extern char *generate_opclass_name(Oid opclass);
-extern char *get_range_partbound_string(List *bound_datums);
-
-extern char *pg_get_statisticsobjdef_string(Oid statextid);
-
-#endif							/* RULEUTILS_H */

data/ext/pg_query/include/utils/sharedtuplestore.h

@@ -1,61 +0,0 @@
-/*-------------------------------------------------------------------------
- *
- * sharedtuplestore.h
- *	  Simple mechanism for sharing tuples between backends.
- *
- * Portions Copyright (c) 1996-2023, PostgreSQL Global Development Group
- * Portions Copyright (c) 1994, Regents of the University of California
- *
- * src/include/utils/sharedtuplestore.h
- *
- *-------------------------------------------------------------------------
- */
-#ifndef SHAREDTUPLESTORE_H
-#define SHAREDTUPLESTORE_H
-
-#include "access/htup.h"
-#include "storage/fd.h"
-#include "storage/sharedfileset.h"
-
-struct SharedTuplestore;
-typedef struct SharedTuplestore SharedTuplestore;
-
-struct SharedTuplestoreAccessor;
-typedef struct SharedTuplestoreAccessor SharedTuplestoreAccessor;
-
-/*
- * A flag indicating that the tuplestore will only be scanned once, so backing
- * files can be unlinked early.
- */
-#define SHARED_TUPLESTORE_SINGLE_PASS 0x01
-
-extern size_t sts_estimate(int participants);
-
-extern SharedTuplestoreAccessor *sts_initialize(SharedTuplestore *sts,
-												int participants,
-												int my_participant_number,
-												size_t meta_data_size,
-												int flags,
-												SharedFileSet *fileset,
-												const char *name);
-
-extern SharedTuplestoreAccessor *sts_attach(SharedTuplestore *sts,
-											int my_participant_number,
-											SharedFileSet *fileset);
-
-extern void sts_end_write(SharedTuplestoreAccessor *accessor);
-
-extern void sts_reinitialize(SharedTuplestoreAccessor *accessor);
-
-extern void sts_begin_parallel_scan(SharedTuplestoreAccessor *accessor);
-
-extern void sts_end_parallel_scan(SharedTuplestoreAccessor *accessor);
-
-extern void sts_puttuple(SharedTuplestoreAccessor *accessor,
-						 void *meta_data,
-						 MinimalTuple tuple);
-
-extern MinimalTuple sts_parallel_scan_next(SharedTuplestoreAccessor *accessor,
-										   void *meta_data);
-
-#endif							/* SHAREDTUPLESTORE_H */

data/ext/pg_query/include/utils/snapmgr.h

@@ -1,181 +0,0 @@
-/*-------------------------------------------------------------------------
- *
- * snapmgr.h
- *	  POSTGRES snapshot manager
- *
- * Portions Copyright (c) 1996-2023, PostgreSQL Global Development Group
- * Portions Copyright (c) 1994, Regents of the University of California
- *
- * src/include/utils/snapmgr.h
- *
- *-------------------------------------------------------------------------
- */
-#ifndef SNAPMGR_H
-#define SNAPMGR_H
-
-#include "access/transam.h"
-#include "utils/relcache.h"
-#include "utils/resowner.h"
-#include "utils/snapshot.h"
-
-
-/*
- * The structure used to map times to TransactionId values for the "snapshot
- * too old" feature must have a few entries at the tail to hold old values;
- * otherwise the lookup will often fail and the expected early pruning or
- * vacuum will not usually occur.  It is best if this padding is for a number
- * of minutes greater than a thread would normally be stalled, but it's OK if
- * early vacuum opportunities are occasionally missed, so there's no need to
- * use an extreme value or get too fancy.  10 minutes seems plenty.
- */
-#define OLD_SNAPSHOT_PADDING_ENTRIES 10
-#define OLD_SNAPSHOT_TIME_MAP_ENTRIES (old_snapshot_threshold + OLD_SNAPSHOT_PADDING_ENTRIES)
-
-/*
- * Common definition of relation properties that allow early pruning/vacuuming
- * when old_snapshot_threshold >= 0.
- */
-#define RelationAllowsEarlyPruning(rel) \
-( \
-	 RelationIsPermanent(rel) && !IsCatalogRelation(rel) \
-  && !RelationIsAccessibleInLogicalDecoding(rel) \
-)
-
-#define EarlyPruningEnabled(rel) (old_snapshot_threshold >= 0 && RelationAllowsEarlyPruning(rel))
-
-/* GUC variables */
-extern PGDLLIMPORT int old_snapshot_threshold;
-
-
-extern Size SnapMgrShmemSize(void);
-extern void SnapMgrInit(void);
-extern TimestampTz GetSnapshotCurrentTimestamp(void);
-extern TimestampTz GetOldSnapshotThresholdTimestamp(void);
-extern void SnapshotTooOldMagicForTest(void);
-
-extern PGDLLIMPORT bool FirstSnapshotSet;
-
-extern PGDLLIMPORT TransactionId TransactionXmin;
-extern PGDLLIMPORT TransactionId RecentXmin;
-
-/* Variables representing various special snapshot semantics */
-extern PGDLLIMPORT SnapshotData SnapshotSelfData;
-extern PGDLLIMPORT SnapshotData SnapshotAnyData;
-extern PGDLLIMPORT SnapshotData CatalogSnapshotData;
-
-#define SnapshotSelf		(&SnapshotSelfData)
-#define SnapshotAny			(&SnapshotAnyData)
-
-/*
- * We don't provide a static SnapshotDirty variable because it would be
- * non-reentrant.  Instead, users of that snapshot type should declare a
- * local variable of type SnapshotData, and initialize it with this macro.
- */
-#define InitDirtySnapshot(snapshotdata)  \
-	((snapshotdata).snapshot_type = SNAPSHOT_DIRTY)
-
-/*
- * Similarly, some initialization is required for a NonVacuumable snapshot.
- * The caller must supply the visibility cutoff state to use (c.f.
- * GlobalVisTestFor()).
- */
-#define InitNonVacuumableSnapshot(snapshotdata, vistestp)  \
-	((snapshotdata).snapshot_type = SNAPSHOT_NON_VACUUMABLE, \
-	 (snapshotdata).vistest = (vistestp))
-
-/*
- * Similarly, some initialization is required for SnapshotToast.  We need
- * to set lsn and whenTaken correctly to support snapshot_too_old.
- */
-#define InitToastSnapshot(snapshotdata, l, w)  \
-	((snapshotdata).snapshot_type = SNAPSHOT_TOAST, \
-	 (snapshotdata).lsn = (l),					\
-	 (snapshotdata).whenTaken = (w))
-
-/* This macro encodes the knowledge of which snapshots are MVCC-safe */
-#define IsMVCCSnapshot(snapshot)  \
-	((snapshot)->snapshot_type == SNAPSHOT_MVCC || \
-	 (snapshot)->snapshot_type == SNAPSHOT_HISTORIC_MVCC)
-
-#ifndef FRONTEND
-static inline bool
-OldSnapshotThresholdActive(void)
-{
-	return old_snapshot_threshold >= 0;
-}
-#endif
-
-extern Snapshot GetTransactionSnapshot(void);
-extern Snapshot GetLatestSnapshot(void);
-extern void SnapshotSetCommandId(CommandId curcid);
-extern Snapshot GetOldestSnapshot(void);
-
-extern Snapshot GetCatalogSnapshot(Oid relid);
-extern Snapshot GetNonHistoricCatalogSnapshot(Oid relid);
-extern void InvalidateCatalogSnapshot(void);
-extern void InvalidateCatalogSnapshotConditionally(void);
-
-extern void PushActiveSnapshot(Snapshot snapshot);
-extern void PushActiveSnapshotWithLevel(Snapshot snapshot, int snap_level);
-extern void PushCopiedSnapshot(Snapshot snapshot);
-extern void UpdateActiveSnapshotCommandId(void);
-extern void PopActiveSnapshot(void);
-extern Snapshot GetActiveSnapshot(void);
-extern bool ActiveSnapshotSet(void);
-
-extern Snapshot RegisterSnapshot(Snapshot snapshot);
-extern void UnregisterSnapshot(Snapshot snapshot);
-extern Snapshot RegisterSnapshotOnOwner(Snapshot snapshot, ResourceOwner owner);
-extern void UnregisterSnapshotFromOwner(Snapshot snapshot, ResourceOwner owner);
-
-extern void AtSubCommit_Snapshot(int level);
-extern void AtSubAbort_Snapshot(int level);
-extern void AtEOXact_Snapshot(bool isCommit, bool resetXmin);
-
-extern void ImportSnapshot(const char *idstr);
-extern bool XactHasExportedSnapshots(void);
-extern void DeleteAllExportedSnapshotFiles(void);
-extern void WaitForOlderSnapshots(TransactionId limitXmin, bool progress);
-extern bool ThereAreNoPriorRegisteredSnapshots(void);
-extern bool HaveRegisteredOrActiveSnapshot(void);
-extern bool TransactionIdLimitedForOldSnapshots(TransactionId recentXmin,
-												Relation relation,
-												TransactionId *limit_xid,
-												TimestampTz *limit_ts);
-extern void SetOldSnapshotThresholdTimestamp(TimestampTz ts, TransactionId xlimit);
-extern void MaintainOldSnapshotTimeMapping(TimestampTz whenTaken,
-										   TransactionId xmin);
-
-extern char *ExportSnapshot(Snapshot snapshot);
-
-/*
- * These live in procarray.c because they're intimately linked to the
- * procarray contents, but thematically they better fit into snapmgr.h.
- */
-typedef struct GlobalVisState GlobalVisState;
-extern GlobalVisState *GlobalVisTestFor(Relation rel);
-extern bool GlobalVisTestIsRemovableXid(GlobalVisState *state, TransactionId xid);
-extern bool GlobalVisTestIsRemovableFullXid(GlobalVisState *state, FullTransactionId fxid);
-extern FullTransactionId GlobalVisTestNonRemovableFullHorizon(GlobalVisState *state);
-extern TransactionId GlobalVisTestNonRemovableHorizon(GlobalVisState *state);
-extern bool GlobalVisCheckRemovableXid(Relation rel, TransactionId xid);
-extern bool GlobalVisCheckRemovableFullXid(Relation rel, FullTransactionId fxid);
-
-/*
- * Utility functions for implementing visibility routines in table AMs.
- */
-extern bool XidInMVCCSnapshot(TransactionId xid, Snapshot snapshot);
-
-/* Support for catalog timetravel for logical decoding */
-struct HTAB;
-extern struct HTAB *HistoricSnapshotGetTupleCids(void);
-extern void SetupHistoricSnapshot(Snapshot historic_snapshot, struct HTAB *tuplecids);
-extern void TeardownHistoricSnapshot(bool is_error);
-extern bool HistoricSnapshotActive(void);
-
-extern Size EstimateSnapshotSpace(Snapshot snapshot);
-extern void SerializeSnapshot(Snapshot snapshot, char *start_address);
-extern Snapshot RestoreSnapshot(char *start_address);
-extern void RestoreTransactionSnapshot(Snapshot snapshot, void *source_pgproc);
-
-#endif							/* SNAPMGR_H */