pg_query 5.0.0 → 6.0.0

data/ext/pg_query/include/replication/slot.h

@@ -1,249 +0,0 @@
-/*-------------------------------------------------------------------------
- * slot.h
- *	   Replication slot management.
- *
- * Copyright (c) 2012-2023, PostgreSQL Global Development Group
- *
- *-------------------------------------------------------------------------
- */
-#ifndef SLOT_H
-#define SLOT_H
-
-#include "access/xlog.h"
-#include "access/xlogreader.h"
-#include "storage/condition_variable.h"
-#include "storage/lwlock.h"
-#include "storage/shmem.h"
-#include "storage/spin.h"
-#include "replication/walreceiver.h"
-
-/*
- * Behaviour of replication slots, upon release or crash.
- *
- * Slots marked as PERSISTENT are crash-safe and will not be dropped when
- * released. Slots marked as EPHEMERAL will be dropped when released or after
- * restarts.  Slots marked TEMPORARY will be dropped at the end of a session
- * or on error.
- *
- * EPHEMERAL is used as a not-quite-ready state when creating persistent
- * slots.  EPHEMERAL slots can be made PERSISTENT by calling
- * ReplicationSlotPersist().  For a slot that goes away at the end of a
- * session, TEMPORARY is the appropriate choice.
- */
-typedef enum ReplicationSlotPersistency
-{
-	RS_PERSISTENT,
-	RS_EPHEMERAL,
-	RS_TEMPORARY
-} ReplicationSlotPersistency;
-
-/*
- * Slots can be invalidated, e.g. due to max_slot_wal_keep_size. If so, the
- * 'invalidated' field is set to a value other than _NONE.
- */
-typedef enum ReplicationSlotInvalidationCause
-{
-	RS_INVAL_NONE,
-	/* required WAL has been removed */
-	RS_INVAL_WAL_REMOVED,
-	/* required rows have been removed */
-	RS_INVAL_HORIZON,
-	/* wal_level insufficient for slot */
-	RS_INVAL_WAL_LEVEL,
-} ReplicationSlotInvalidationCause;
-
-/*
- * On-Disk data of a replication slot, preserved across restarts.
- */
-typedef struct ReplicationSlotPersistentData
-{
-	/* The slot's identifier */
-	NameData	name;
-
-	/* database the slot is active on */
-	Oid			database;
-
-	/*
-	 * The slot's behaviour when being dropped (or restored after a crash).
-	 */
-	ReplicationSlotPersistency persistency;
-
-	/*
-	 * xmin horizon for data
-	 *
-	 * NB: This may represent a value that hasn't been written to disk yet;
-	 * see notes for effective_xmin, below.
-	 */
-	TransactionId xmin;
-
-	/*
-	 * xmin horizon for catalog tuples
-	 *
-	 * NB: This may represent a value that hasn't been written to disk yet;
-	 * see notes for effective_xmin, below.
-	 */
-	TransactionId catalog_xmin;
-
-	/* oldest LSN that might be required by this replication slot */
-	XLogRecPtr	restart_lsn;
-
-	/* RS_INVAL_NONE if valid, or the reason for having been invalidated */
-	ReplicationSlotInvalidationCause invalidated;
-
-	/*
-	 * Oldest LSN that the client has acked receipt for.  This is used as the
-	 * start_lsn point in case the client doesn't specify one, and also as a
-	 * safety measure to jump forwards in case the client specifies a
-	 * start_lsn that's further in the past than this value.
-	 */
-	XLogRecPtr	confirmed_flush;
-
-	/*
-	 * LSN at which we enabled two_phase commit for this slot or LSN at which
-	 * we found a consistent point at the time of slot creation.
-	 */
-	XLogRecPtr	two_phase_at;
-
-	/*
-	 * Allow decoding of prepared transactions?
-	 */
-	bool		two_phase;
-
-	/* plugin name */
-	NameData	plugin;
-} ReplicationSlotPersistentData;
-
-/*
- * Shared memory state of a single replication slot.
- *
- * The in-memory data of replication slots follows a locking model based
- * on two linked concepts:
- * - A replication slot's in_use flag is switched when added or discarded using
- * the LWLock ReplicationSlotControlLock, which needs to be hold in exclusive
- * mode when updating the flag by the backend owning the slot and doing the
- * operation, while readers (concurrent backends not owning the slot) need
- * to hold it in shared mode when looking at replication slot data.
- * - Individual fields are protected by mutex where only the backend owning
- * the slot is authorized to update the fields from its own slot.  The
- * backend owning the slot does not need to take this lock when reading its
- * own fields, while concurrent backends not owning this slot should take the
- * lock when reading this slot's data.
- */
-typedef struct ReplicationSlot
-{
-	/* lock, on same cacheline as effective_xmin */
-	slock_t		mutex;
-
-	/* is this slot defined */
-	bool		in_use;
-
-	/* Who is streaming out changes for this slot? 0 in unused slots. */
-	pid_t		active_pid;
-
-	/* any outstanding modifications? */
-	bool		just_dirtied;
-	bool		dirty;
-
-	/*
-	 * For logical decoding, it's extremely important that we never remove any
-	 * data that's still needed for decoding purposes, even after a crash;
-	 * otherwise, decoding will produce wrong answers.  Ordinary streaming
-	 * replication also needs to prevent old row versions from being removed
-	 * too soon, but the worst consequence we might encounter there is
-	 * unwanted query cancellations on the standby.  Thus, for logical
-	 * decoding, this value represents the latest xmin that has actually been
-	 * written to disk, whereas for streaming replication, it's just the same
-	 * as the persistent value (data.xmin).
-	 */
-	TransactionId effective_xmin;
-	TransactionId effective_catalog_xmin;
-
-	/* data surviving shutdowns and crashes */
-	ReplicationSlotPersistentData data;
-
-	/* is somebody performing io on this slot? */
-	LWLock		io_in_progress_lock;
-
-	/* Condition variable signaled when active_pid changes */
-	ConditionVariable active_cv;
-
-	/* all the remaining data is only used for logical slots */
-
-	/*
-	 * When the client has confirmed flushes >= candidate_xmin_lsn we can
-	 * advance the catalog xmin.  When restart_valid has been passed,
-	 * restart_lsn can be increased.
-	 */
-	TransactionId candidate_catalog_xmin;
-	XLogRecPtr	candidate_xmin_lsn;
-	XLogRecPtr	candidate_restart_valid;
-	XLogRecPtr	candidate_restart_lsn;
-} ReplicationSlot;
-
-#define SlotIsPhysical(slot) ((slot)->data.database == InvalidOid)
-#define SlotIsLogical(slot) ((slot)->data.database != InvalidOid)
-
-/*
- * Shared memory control area for all of replication slots.
- */
-typedef struct ReplicationSlotCtlData
-{
-	/*
-	 * This array should be declared [FLEXIBLE_ARRAY_MEMBER], but for some
-	 * reason you can't do that in an otherwise-empty struct.
-	 */
-	ReplicationSlot replication_slots[1];
-} ReplicationSlotCtlData;
-
-/*
- * Pointers to shared memory
- */
-extern PGDLLIMPORT ReplicationSlotCtlData *ReplicationSlotCtl;
-extern PGDLLIMPORT ReplicationSlot *MyReplicationSlot;
-
-/* GUCs */
-extern PGDLLIMPORT int max_replication_slots;
-
-/* shmem initialization functions */
-extern Size ReplicationSlotsShmemSize(void);
-extern void ReplicationSlotsShmemInit(void);
-
-/* management of individual slots */
-extern void ReplicationSlotCreate(const char *name, bool db_specific,
-								  ReplicationSlotPersistency persistency,
-								  bool two_phase);
-extern void ReplicationSlotPersist(void);
-extern void ReplicationSlotDrop(const char *name, bool nowait);
-
-extern void ReplicationSlotAcquire(const char *name, bool nowait);
-extern void ReplicationSlotRelease(void);
-extern void ReplicationSlotCleanup(void);
-extern void ReplicationSlotSave(void);
-extern void ReplicationSlotMarkDirty(void);
-
-/* misc stuff */
-extern void ReplicationSlotInitialize(void);
-extern bool ReplicationSlotValidateName(const char *name, int elevel);
-extern void ReplicationSlotReserveWal(void);
-extern void ReplicationSlotsComputeRequiredXmin(bool already_locked);
-extern void ReplicationSlotsComputeRequiredLSN(void);
-extern XLogRecPtr ReplicationSlotsComputeLogicalRestartLSN(void);
-extern bool ReplicationSlotsCountDBSlots(Oid dboid, int *nslots, int *nactive);
-extern void ReplicationSlotsDropDBSlots(Oid dboid);
-extern bool InvalidateObsoleteReplicationSlots(ReplicationSlotInvalidationCause cause,
-											   XLogSegNo oldestSegno,
-											   Oid dboid,
-											   TransactionId snapshotConflictHorizon);
-extern ReplicationSlot *SearchNamedReplicationSlot(const char *name, bool need_lock);
-extern int	ReplicationSlotIndex(ReplicationSlot *slot);
-extern bool ReplicationSlotName(int index, Name name);
-extern void ReplicationSlotNameForTablesync(Oid suboid, Oid relid, char *syncslotname, Size szslot);
-extern void ReplicationSlotDropAtPubNode(WalReceiverConn *wrconn, char *slotname, bool missing_ok);
-
-extern void StartupReplicationSlots(void);
-extern void CheckPointReplicationSlots(void);
-
-extern void CheckSlotRequirements(void);
-extern void CheckSlotPermissions(void);
-
-#endif							/* SLOT_H */

data/ext/pg_query/include/replication/syncrep.h

@@ -1,109 +0,0 @@
-/*-------------------------------------------------------------------------
- *
- * syncrep.h
- *	  Exports from replication/syncrep.c.
- *
- * Portions Copyright (c) 2010-2023, PostgreSQL Global Development Group
- *
- * IDENTIFICATION
- *		src/include/replication/syncrep.h
- *
- *-------------------------------------------------------------------------
- */
-#ifndef _SYNCREP_H
-#define _SYNCREP_H
-
-#include "access/xlogdefs.h"
-
-#define SyncRepRequested() \
-	(max_wal_senders > 0 && synchronous_commit > SYNCHRONOUS_COMMIT_LOCAL_FLUSH)
-
-/* SyncRepWaitMode */
-#define SYNC_REP_NO_WAIT		(-1)
-#define SYNC_REP_WAIT_WRITE		0
-#define SYNC_REP_WAIT_FLUSH		1
-#define SYNC_REP_WAIT_APPLY		2
-
-#define NUM_SYNC_REP_WAIT_MODE	3
-
-/* syncRepState */
-#define SYNC_REP_NOT_WAITING		0
-#define SYNC_REP_WAITING			1
-#define SYNC_REP_WAIT_COMPLETE		2
-
-/* syncrep_method of SyncRepConfigData */
-#define SYNC_REP_PRIORITY		0
-#define SYNC_REP_QUORUM		1
-
-/*
- * SyncRepGetCandidateStandbys returns an array of these structs,
- * one per candidate synchronous walsender.
- */
-typedef struct SyncRepStandbyData
-{
-	/* Copies of relevant fields from WalSnd shared-memory struct */
-	pid_t		pid;
-	XLogRecPtr	write;
-	XLogRecPtr	flush;
-	XLogRecPtr	apply;
-	int			sync_standby_priority;
-	/* Index of this walsender in the WalSnd shared-memory array */
-	int			walsnd_index;
-	/* This flag indicates whether this struct is about our own process */
-	bool		is_me;
-} SyncRepStandbyData;
-
-/*
- * Struct for the configuration of synchronous replication.
- *
- * Note: this must be a flat representation that can be held in a single
- * chunk of malloc'd memory, so that it can be stored as the "extra" data
- * for the synchronous_standby_names GUC.
- */
-typedef struct SyncRepConfigData
-{
-	int			config_size;	/* total size of this struct, in bytes */
-	int			num_sync;		/* number of sync standbys that we need to
-								 * wait for */
-	uint8		syncrep_method; /* method to choose sync standbys */
-	int			nmembers;		/* number of members in the following list */
-	/* member_names contains nmembers consecutive nul-terminated C strings */
-	char		member_names[FLEXIBLE_ARRAY_MEMBER];
-} SyncRepConfigData;
-
-extern PGDLLIMPORT SyncRepConfigData *SyncRepConfig;
-
-/* communication variables for parsing synchronous_standby_names GUC */
-extern PGDLLIMPORT SyncRepConfigData *syncrep_parse_result;
-extern PGDLLIMPORT char *syncrep_parse_error_msg;
-
-/* user-settable parameters for synchronous replication */
-extern PGDLLIMPORT char *SyncRepStandbyNames;
-
-/* called by user backend */
-extern void SyncRepWaitForLSN(XLogRecPtr lsn, bool commit);
-
-/* called at backend exit */
-extern void SyncRepCleanupAtProcExit(void);
-
-/* called by wal sender */
-extern void SyncRepInitConfig(void);
-extern void SyncRepReleaseWaiters(void);
-
-/* called by wal sender and user backend */
-extern int	SyncRepGetCandidateStandbys(SyncRepStandbyData **standbys);
-
-/* called by checkpointer */
-extern void SyncRepUpdateSyncStandbysDefined(void);
-
-/*
- * Internal functions for parsing synchronous_standby_names grammar,
- * in syncrep_gram.y and syncrep_scanner.l
- */
-extern int	syncrep_yyparse(void);
-extern int	syncrep_yylex(void);
-extern void syncrep_yyerror(const char *str);
-extern void syncrep_scanner_init(const char *str);
-extern void syncrep_scanner_finish(void);
-
-#endif							/* _SYNCREP_H */