pg_query 5.0.0 → 6.0.0

data/ext/pg_query/include/access/amapi.h

@@ -1,292 +0,0 @@
-/*-------------------------------------------------------------------------
- *
- * amapi.h
- *	  API for Postgres index access methods.
- *
- * Copyright (c) 2015-2023, PostgreSQL Global Development Group
- *
- * src/include/access/amapi.h
- *
- *-------------------------------------------------------------------------
- */
-#ifndef AMAPI_H
-#define AMAPI_H
-
-#include "access/genam.h"
-
-/*
- * We don't wish to include planner header files here, since most of an index
- * AM's implementation isn't concerned with those data structures.  To allow
- * declaring amcostestimate_function here, use forward struct references.
- */
-struct PlannerInfo;
-struct IndexPath;
-
-/* Likewise, this file shouldn't depend on execnodes.h. */
-struct IndexInfo;
-
-
-/*
- * Properties for amproperty API.  This list covers properties known to the
- * core code, but an index AM can define its own properties, by matching the
- * string property name.
- */
-typedef enum IndexAMProperty
-{
-	AMPROP_UNKNOWN = 0,			/* anything not known to core code */
-	AMPROP_ASC,					/* column properties */
-	AMPROP_DESC,
-	AMPROP_NULLS_FIRST,
-	AMPROP_NULLS_LAST,
-	AMPROP_ORDERABLE,
-	AMPROP_DISTANCE_ORDERABLE,
-	AMPROP_RETURNABLE,
-	AMPROP_SEARCH_ARRAY,
-	AMPROP_SEARCH_NULLS,
-	AMPROP_CLUSTERABLE,			/* index properties */
-	AMPROP_INDEX_SCAN,
-	AMPROP_BITMAP_SCAN,
-	AMPROP_BACKWARD_SCAN,
-	AMPROP_CAN_ORDER,			/* AM properties */
-	AMPROP_CAN_UNIQUE,
-	AMPROP_CAN_MULTI_COL,
-	AMPROP_CAN_EXCLUDE,
-	AMPROP_CAN_INCLUDE
-} IndexAMProperty;
-
-/*
- * We use lists of this struct type to keep track of both operators and
- * support functions while building or adding to an opclass or opfamily.
- * amadjustmembers functions receive lists of these structs, and are allowed
- * to alter their "ref" fields.
- *
- * The "ref" fields define how the pg_amop or pg_amproc entry should depend
- * on the associated objects (that is, which dependency type to use, and
- * which opclass or opfamily it should depend on).
- *
- * If ref_is_hard is true, the entry will have a NORMAL dependency on the
- * operator or support func, and an INTERNAL dependency on the opclass or
- * opfamily.  This forces the opclass or opfamily to be dropped if the
- * operator or support func is dropped, and requires the CASCADE option
- * to do so.  Nor will ALTER OPERATOR FAMILY DROP be allowed.  This is
- * the right behavior for objects that are essential to an opclass.
- *
- * If ref_is_hard is false, the entry will have an AUTO dependency on the
- * operator or support func, and also an AUTO dependency on the opclass or
- * opfamily.  This allows ALTER OPERATOR FAMILY DROP, and causes that to
- * happen automatically if the operator or support func is dropped.  This
- * is the right behavior for inessential ("loose") objects.
- */
-typedef struct OpFamilyMember
-{
-	bool		is_func;		/* is this an operator, or support func? */
-	Oid			object;			/* operator or support func's OID */
-	int			number;			/* strategy or support func number */
-	Oid			lefttype;		/* lefttype */
-	Oid			righttype;		/* righttype */
-	Oid			sortfamily;		/* ordering operator's sort opfamily, or 0 */
-	bool		ref_is_hard;	/* hard or soft dependency? */
-	bool		ref_is_family;	/* is dependency on opclass or opfamily? */
-	Oid			refobjid;		/* OID of opclass or opfamily */
-} OpFamilyMember;
-
-
-/*
- * Callback function signatures --- see indexam.sgml for more info.
- */
-
-/* build new index */
-typedef IndexBuildResult *(*ambuild_function) (Relation heapRelation,
-											   Relation indexRelation,
-											   struct IndexInfo *indexInfo);
-
-/* build empty index */
-typedef void (*ambuildempty_function) (Relation indexRelation);
-
-/* insert this tuple */
-typedef bool (*aminsert_function) (Relation indexRelation,
-								   Datum *values,
-								   bool *isnull,
-								   ItemPointer heap_tid,
-								   Relation heapRelation,
-								   IndexUniqueCheck checkUnique,
-								   bool indexUnchanged,
-								   struct IndexInfo *indexInfo);
-
-/* bulk delete */
-typedef IndexBulkDeleteResult *(*ambulkdelete_function) (IndexVacuumInfo *info,
-														 IndexBulkDeleteResult *stats,
-														 IndexBulkDeleteCallback callback,
-														 void *callback_state);
-
-/* post-VACUUM cleanup */
-typedef IndexBulkDeleteResult *(*amvacuumcleanup_function) (IndexVacuumInfo *info,
-															IndexBulkDeleteResult *stats);
-
-/* can indexscan return IndexTuples? */
-typedef bool (*amcanreturn_function) (Relation indexRelation, int attno);
-
-/* estimate cost of an indexscan */
-typedef void (*amcostestimate_function) (struct PlannerInfo *root,
-										 struct IndexPath *path,
-										 double loop_count,
-										 Cost *indexStartupCost,
-										 Cost *indexTotalCost,
-										 Selectivity *indexSelectivity,
-										 double *indexCorrelation,
-										 double *indexPages);
-
-/* parse index reloptions */
-typedef bytea *(*amoptions_function) (Datum reloptions,
-									  bool validate);
-
-/* report AM, index, or index column property */
-typedef bool (*amproperty_function) (Oid index_oid, int attno,
-									 IndexAMProperty prop, const char *propname,
-									 bool *res, bool *isnull);
-
-/* name of phase as used in progress reporting */
-typedef char *(*ambuildphasename_function) (int64 phasenum);
-
-/* validate definition of an opclass for this AM */
-typedef bool (*amvalidate_function) (Oid opclassoid);
-
-/* validate operators and support functions to be added to an opclass/family */
-typedef void (*amadjustmembers_function) (Oid opfamilyoid,
-										  Oid opclassoid,
-										  List *operators,
-										  List *functions);
-
-/* prepare for index scan */
-typedef IndexScanDesc (*ambeginscan_function) (Relation indexRelation,
-											   int nkeys,
-											   int norderbys);
-
-/* (re)start index scan */
-typedef void (*amrescan_function) (IndexScanDesc scan,
-								   ScanKey keys,
-								   int nkeys,
-								   ScanKey orderbys,
-								   int norderbys);
-
-/* next valid tuple */
-typedef bool (*amgettuple_function) (IndexScanDesc scan,
-									 ScanDirection direction);
-
-/* fetch all valid tuples */
-typedef int64 (*amgetbitmap_function) (IndexScanDesc scan,
-									   TIDBitmap *tbm);
-
-/* end index scan */
-typedef void (*amendscan_function) (IndexScanDesc scan);
-
-/* mark current scan position */
-typedef void (*ammarkpos_function) (IndexScanDesc scan);
-
-/* restore marked scan position */
-typedef void (*amrestrpos_function) (IndexScanDesc scan);
-
-/*
- * Callback function signatures - for parallel index scans.
- */
-
-/* estimate size of parallel scan descriptor */
-typedef Size (*amestimateparallelscan_function) (void);
-
-/* prepare for parallel index scan */
-typedef void (*aminitparallelscan_function) (void *target);
-
-/* (re)start parallel index scan */
-typedef void (*amparallelrescan_function) (IndexScanDesc scan);
-
-/*
- * API struct for an index AM.  Note this must be stored in a single palloc'd
- * chunk of memory.
- */
-typedef struct IndexAmRoutine
-{
-	NodeTag		type;
-
-	/*
-	 * Total number of strategies (operators) by which we can traverse/search
-	 * this AM.  Zero if AM does not have a fixed set of strategy assignments.
-	 */
-	uint16		amstrategies;
-	/* total number of support functions that this AM uses */
-	uint16		amsupport;
-	/* opclass options support function number or 0 */
-	uint16		amoptsprocnum;
-	/* does AM support ORDER BY indexed column's value? */
-	bool		amcanorder;
-	/* does AM support ORDER BY result of an operator on indexed column? */
-	bool		amcanorderbyop;
-	/* does AM support backward scanning? */
-	bool		amcanbackward;
-	/* does AM support UNIQUE indexes? */
-	bool		amcanunique;
-	/* does AM support multi-column indexes? */
-	bool		amcanmulticol;
-	/* does AM require scans to have a constraint on the first index column? */
-	bool		amoptionalkey;
-	/* does AM handle ScalarArrayOpExpr quals? */
-	bool		amsearcharray;
-	/* does AM handle IS NULL/IS NOT NULL quals? */
-	bool		amsearchnulls;
-	/* can index storage data type differ from column data type? */
-	bool		amstorage;
-	/* can an index of this type be clustered on? */
-	bool		amclusterable;
-	/* does AM handle predicate locks? */
-	bool		ampredlocks;
-	/* does AM support parallel scan? */
-	bool		amcanparallel;
-	/* does AM support columns included with clause INCLUDE? */
-	bool		amcaninclude;
-	/* does AM use maintenance_work_mem? */
-	bool		amusemaintenanceworkmem;
-	/* does AM store tuple information only at block granularity? */
-	bool		amsummarizing;
-	/* OR of parallel vacuum flags.  See vacuum.h for flags. */
-	uint8		amparallelvacuumoptions;
-	/* type of data stored in index, or InvalidOid if variable */
-	Oid			amkeytype;
-
-	/*
-	 * If you add new properties to either the above or the below lists, then
-	 * they should also (usually) be exposed via the property API (see
-	 * IndexAMProperty at the top of the file, and utils/adt/amutils.c).
-	 */
-
-	/* interface functions */
-	ambuild_function ambuild;
-	ambuildempty_function ambuildempty;
-	aminsert_function aminsert;
-	ambulkdelete_function ambulkdelete;
-	amvacuumcleanup_function amvacuumcleanup;
-	amcanreturn_function amcanreturn;	/* can be NULL */
-	amcostestimate_function amcostestimate;
-	amoptions_function amoptions;
-	amproperty_function amproperty; /* can be NULL */
-	ambuildphasename_function ambuildphasename; /* can be NULL */
-	amvalidate_function amvalidate;
-	amadjustmembers_function amadjustmembers;	/* can be NULL */
-	ambeginscan_function ambeginscan;
-	amrescan_function amrescan;
-	amgettuple_function amgettuple; /* can be NULL */
-	amgetbitmap_function amgetbitmap;	/* can be NULL */
-	amendscan_function amendscan;
-	ammarkpos_function ammarkpos;	/* can be NULL */
-	amrestrpos_function amrestrpos; /* can be NULL */
-
-	/* interface functions to support parallel index scans */
-	amestimateparallelscan_function amestimateparallelscan; /* can be NULL */
-	aminitparallelscan_function aminitparallelscan; /* can be NULL */
-	amparallelrescan_function amparallelrescan; /* can be NULL */
-} IndexAmRoutine;
-
-
-/* Functions in access/index/amapi.c */
-extern IndexAmRoutine *GetIndexAmRoutine(Oid amhandler);
-extern IndexAmRoutine *GetIndexAmRoutineByAmId(Oid amoid, bool noerror);
-
-#endif							/* AMAPI_H */

data/ext/pg_query/include/access/attmap.h

@@ -1,54 +0,0 @@
-/*-------------------------------------------------------------------------
- *
- * attmap.h
- *	  Definitions for PostgreSQL attribute mappings
- *
- *
- * Portions Copyright (c) 1996-2023, PostgreSQL Global Development Group
- * Portions Copyright (c) 1994, Regents of the University of California
- *
- * src/include/access/attmap.h
- *
- *-------------------------------------------------------------------------
- */
-#ifndef ATTMAP_H
-#define ATTMAP_H
-
-#include "access/attnum.h"
-#include "access/tupdesc.h"
-
-/*
- * Attribute mapping structure
- *
- * This maps attribute numbers between a pair of relations, designated
- * 'input' and 'output' (most typically inheritance parent and child
- * relations), whose common columns may have different attribute numbers.
- * Such difference may arise due to the columns being ordered differently
- * in the two relations or the two relations having dropped columns at
- * different positions.
- *
- * 'maplen' is set to the number of attributes of the 'output' relation,
- * taking into account any of its dropped attributes, with the corresponding
- * elements of the 'attnums' array set to 0.
- */
-typedef struct AttrMap
-{
-	AttrNumber *attnums;
-	int			maplen;
-} AttrMap;
-
-extern AttrMap *make_attrmap(int maplen);
-extern void free_attrmap(AttrMap *map);
-
-/* Conversion routines to build mappings */
-extern AttrMap *build_attrmap_by_name(TupleDesc indesc,
-									  TupleDesc outdesc,
-									  bool missing_ok);
-extern AttrMap *build_attrmap_by_name_if_req(TupleDesc indesc,
-											 TupleDesc outdesc,
-											 bool missing_ok);
-extern AttrMap *build_attrmap_by_position(TupleDesc indesc,
-										  TupleDesc outdesc,
-										  const char *msg);
-
-#endif							/* ATTMAP_H */

data/ext/pg_query/include/access/attnum.h

@@ -1,64 +0,0 @@
-/*-------------------------------------------------------------------------
- *
- * attnum.h
- *	  POSTGRES attribute number definitions.
- *
- *
- * Portions Copyright (c) 1996-2023, PostgreSQL Global Development Group
- * Portions Copyright (c) 1994, Regents of the University of California
- *
- * src/include/access/attnum.h
- *
- *-------------------------------------------------------------------------
- */
-#ifndef ATTNUM_H
-#define ATTNUM_H
-
-
-/*
- * user defined attribute numbers start at 1.   -ay 2/95
- */
-typedef int16 AttrNumber;
-
-#define InvalidAttrNumber		0
-#define MaxAttrNumber			32767
-
-/* ----------------
- *		support macros
- * ----------------
- */
-/*
- * AttributeNumberIsValid
- *		True iff the attribute number is valid.
- */
-#define AttributeNumberIsValid(attributeNumber) \
-	((bool) ((attributeNumber) != InvalidAttrNumber))
-
-/*
- * AttrNumberIsForUserDefinedAttr
- *		True iff the attribute number corresponds to a user defined attribute.
- */
-#define AttrNumberIsForUserDefinedAttr(attributeNumber) \
-	((bool) ((attributeNumber) > 0))
-
-/*
- * AttrNumberGetAttrOffset
- *		Returns the attribute offset for an attribute number.
- *
- * Note:
- *		Assumes the attribute number is for a user defined attribute.
- */
-#define AttrNumberGetAttrOffset(attNum) \
-( \
-	AssertMacro(AttrNumberIsForUserDefinedAttr(attNum)), \
-	((attNum) - 1) \
-)
-
-/*
- * AttrOffsetGetAttrNumber
- *		Returns the attribute number for an attribute offset.
- */
-#define AttrOffsetGetAttrNumber(attributeOffset) \
-	 ((AttrNumber) (1 + (attributeOffset)))
-
-#endif							/* ATTNUM_H */

data/ext/pg_query/include/access/clog.h

@@ -1,63 +0,0 @@
-/*
- * clog.h
- *
- * PostgreSQL transaction-commit-log manager
- *
- * Portions Copyright (c) 1996-2023, PostgreSQL Global Development Group
- * Portions Copyright (c) 1994, Regents of the University of California
- *
- * src/include/access/clog.h
- */
-#ifndef CLOG_H
-#define CLOG_H
-
-#include "access/xlogreader.h"
-#include "storage/sync.h"
-#include "lib/stringinfo.h"
-
-/*
- * Possible transaction statuses --- note that all-zeroes is the initial
- * state.
- *
- * A "subcommitted" transaction is a committed subtransaction whose parent
- * hasn't committed or aborted yet.
- */
-typedef int XidStatus;
-
-#define TRANSACTION_STATUS_IN_PROGRESS		0x00
-#define TRANSACTION_STATUS_COMMITTED		0x01
-#define TRANSACTION_STATUS_ABORTED			0x02
-#define TRANSACTION_STATUS_SUB_COMMITTED	0x03
-
-typedef struct xl_clog_truncate
-{
-	int			pageno;
-	TransactionId oldestXact;
-	Oid			oldestXactDb;
-} xl_clog_truncate;
-
-extern void TransactionIdSetTreeStatus(TransactionId xid, int nsubxids,
-									   TransactionId *subxids, XidStatus status, XLogRecPtr lsn);
-extern XidStatus TransactionIdGetStatus(TransactionId xid, XLogRecPtr *lsn);
-
-extern Size CLOGShmemBuffers(void);
-extern Size CLOGShmemSize(void);
-extern void CLOGShmemInit(void);
-extern void BootStrapCLOG(void);
-extern void StartupCLOG(void);
-extern void TrimCLOG(void);
-extern void CheckPointCLOG(void);
-extern void ExtendCLOG(TransactionId newestXact);
-extern void TruncateCLOG(TransactionId oldestXact, Oid oldestxid_datoid);
-
-extern int	clogsyncfiletag(const FileTag *ftag, char *path);
-
-/* XLOG stuff */
-#define CLOG_ZEROPAGE		0x00
-#define CLOG_TRUNCATE		0x10
-
-extern void clog_redo(XLogReaderState *record);
-extern void clog_desc(StringInfo buf, XLogReaderState *record);
-extern const char *clog_identify(uint8 info);
-
-#endif							/* CLOG_H */

data/ext/pg_query/include/access/commit_ts.h

@@ -1,74 +0,0 @@
-/*
- * commit_ts.h
- *
- * PostgreSQL commit timestamp manager
- *
- * Portions Copyright (c) 1996-2023, PostgreSQL Global Development Group
- * Portions Copyright (c) 1994, Regents of the University of California
- *
- * src/include/access/commit_ts.h
- */
-#ifndef COMMIT_TS_H
-#define COMMIT_TS_H
-
-#include "access/xlog.h"
-#include "datatype/timestamp.h"
-#include "replication/origin.h"
-#include "storage/sync.h"
-
-
-extern PGDLLIMPORT bool track_commit_timestamp;
-
-extern void TransactionTreeSetCommitTsData(TransactionId xid, int nsubxids,
-										   TransactionId *subxids, TimestampTz timestamp,
-										   RepOriginId nodeid);
-extern bool TransactionIdGetCommitTsData(TransactionId xid,
-										 TimestampTz *ts, RepOriginId *nodeid);
-extern TransactionId GetLatestCommitTsData(TimestampTz *ts,
-										   RepOriginId *nodeid);
-
-extern Size CommitTsShmemBuffers(void);
-extern Size CommitTsShmemSize(void);
-extern void CommitTsShmemInit(void);
-extern void BootStrapCommitTs(void);
-extern void StartupCommitTs(void);
-extern void CommitTsParameterChange(bool newvalue, bool oldvalue);
-extern void CompleteCommitTsInitialization(void);
-extern void CheckPointCommitTs(void);
-extern void ExtendCommitTs(TransactionId newestXact);
-extern void TruncateCommitTs(TransactionId oldestXact);
-extern void SetCommitTsLimit(TransactionId oldestXact,
-							 TransactionId newestXact);
-extern void AdvanceOldestCommitTsXid(TransactionId oldestXact);
-
-extern int	committssyncfiletag(const FileTag *ftag, char *path);
-
-/* XLOG stuff */
-#define COMMIT_TS_ZEROPAGE		0x00
-#define COMMIT_TS_TRUNCATE		0x10
-
-typedef struct xl_commit_ts_set
-{
-	TimestampTz timestamp;
-	RepOriginId nodeid;
-	TransactionId mainxid;
-	/* subxact Xids follow */
-}			xl_commit_ts_set;
-
-#define SizeOfCommitTsSet	(offsetof(xl_commit_ts_set, mainxid) + \
-							 sizeof(TransactionId))
-
-typedef struct xl_commit_ts_truncate
-{
-	int			pageno;
-	TransactionId oldestXid;
-} xl_commit_ts_truncate;
-
-#define SizeOfCommitTsTruncate	(offsetof(xl_commit_ts_truncate, oldestXid) + \
-								 sizeof(TransactionId))
-
-extern void commit_ts_redo(XLogReaderState *record);
-extern void commit_ts_desc(StringInfo buf, XLogReaderState *record);
-extern const char *commit_ts_identify(uint8 info);
-
-#endif							/* COMMIT_TS_H */

data/ext/pg_query/include/access/detoast.h

@@ -1,82 +0,0 @@
-/*-------------------------------------------------------------------------
- *
- * detoast.h
- *	  Access to compressed and external varlena values.
- *
- * Copyright (c) 2000-2023, PostgreSQL Global Development Group
- *
- * src/include/access/detoast.h
- *
- *-------------------------------------------------------------------------
- */
-#ifndef DETOAST_H
-#define DETOAST_H
-
-/*
- * Macro to fetch the possibly-unaligned contents of an EXTERNAL datum
- * into a local "struct varatt_external" toast pointer.  This should be
- * just a memcpy, but some versions of gcc seem to produce broken code
- * that assumes the datum contents are aligned.  Introducing an explicit
- * intermediate "varattrib_1b_e *" variable seems to fix it.
- */
-#define VARATT_EXTERNAL_GET_POINTER(toast_pointer, attr) \
-do { \
-	varattrib_1b_e *attre = (varattrib_1b_e *) (attr); \
-	Assert(VARATT_IS_EXTERNAL(attre)); \
-	Assert(VARSIZE_EXTERNAL(attre) == sizeof(toast_pointer) + VARHDRSZ_EXTERNAL); \
-	memcpy(&(toast_pointer), VARDATA_EXTERNAL(attre), sizeof(toast_pointer)); \
-} while (0)
-
-/* Size of an EXTERNAL datum that contains a standard TOAST pointer */
-#define TOAST_POINTER_SIZE (VARHDRSZ_EXTERNAL + sizeof(varatt_external))
-
-/* Size of an EXTERNAL datum that contains an indirection pointer */
-#define INDIRECT_POINTER_SIZE (VARHDRSZ_EXTERNAL + sizeof(varatt_indirect))
-
-/* ----------
- * detoast_external_attr() -
- *
- *		Fetches an external stored attribute from the toast
- *		relation. Does NOT decompress it, if stored external
- *		in compressed format.
- * ----------
- */
-extern struct varlena *detoast_external_attr(struct varlena *attr);
-
-/* ----------
- * detoast_attr() -
- *
- *		Fully detoasts one attribute, fetching and/or decompressing
- *		it as needed.
- * ----------
- */
-extern struct varlena *detoast_attr(struct varlena *attr);
-
-/* ----------
- * detoast_attr_slice() -
- *
- *		Fetches only the specified portion of an attribute.
- *		(Handles all cases for attribute storage)
- * ----------
- */
-extern struct varlena *detoast_attr_slice(struct varlena *attr,
-										  int32 sliceoffset,
-										  int32 slicelength);
-
-/* ----------
- * toast_raw_datum_size -
- *
- *	Return the raw (detoasted) size of a varlena datum
- * ----------
- */
-extern Size toast_raw_datum_size(Datum value);
-
-/* ----------
- * toast_datum_size -
- *
- *	Return the storage size of a varlena datum
- * ----------
- */
-extern Size toast_datum_size(Datum value);
-
-#endif							/* DETOAST_H */