PostgreSQL Source Code  git master
procarray.h
Go to the documentation of this file.
1 /*-------------------------------------------------------------------------
2  *
3  * procarray.h
4  * POSTGRES process array definitions.
5  *
6  *
7  * Portions Copyright (c) 1996-2024, PostgreSQL Global Development Group
8  * Portions Copyright (c) 1994, Regents of the University of California
9  *
10  * src/include/storage/procarray.h
11  *
12  *-------------------------------------------------------------------------
13  */
14 #ifndef PROCARRAY_H
15 #define PROCARRAY_H
16 
17 #include "storage/lock.h"
18 #include "storage/standby.h"
19 #include "utils/relcache.h"
20 #include "utils/snapshot.h"
21 
22 
23 extern Size ProcArrayShmemSize(void);
24 extern void CreateSharedProcArray(void);
25 extern void ProcArrayAdd(PGPROC *proc);
26 extern void ProcArrayRemove(PGPROC *proc, TransactionId latestXid);
27 
28 extern void ProcArrayEndTransaction(PGPROC *proc, TransactionId latestXid);
29 extern void ProcArrayClearTransaction(PGPROC *proc);
30 
31 extern void ProcArrayInitRecovery(TransactionId initializedUptoXID);
34  int nsubxids, TransactionId *subxids);
35 
38  int nsubxids, TransactionId *subxids,
39  TransactionId max_xid);
40 extern void ExpireAllKnownAssignedTransactionIds(void);
43 
44 extern int GetMaxSnapshotXidCount(void);
45 extern int GetMaxSnapshotSubxidCount(void);
46 
47 extern Snapshot GetSnapshotData(Snapshot snapshot);
48 
50  VirtualTransactionId *sourcevxid);
51 extern bool ProcArrayInstallRestoredXmin(TransactionId xmin, PGPROC *proc);
52 
54 
56 extern bool TransactionIdIsActive(TransactionId xid);
60 extern TransactionId GetOldestSafeDecodingTransactionId(bool catalogOnly);
61 extern void GetReplicationHorizons(TransactionId *xmin, TransactionId *catalog_xmin);
62 
63 extern VirtualTransactionId *GetVirtualXIDsDelayingChkpt(int *nvxids, int type);
65  int nvxids, int type);
66 
67 extern PGPROC *ProcNumberGetProc(int procNumber);
68 extern void ProcNumberGetTransactionIds(int procNumber, TransactionId *xid,
69  TransactionId *xmin, int *nsubxid,
70  bool *overflowed);
71 extern PGPROC *BackendPidGetProc(int pid);
72 extern PGPROC *BackendPidGetProcWithLock(int pid);
73 extern int BackendXidGetPid(TransactionId xid);
74 extern bool IsBackendPid(int pid);
75 
77  bool excludeXmin0, bool allDbs, int excludeVacuum,
78  int *nvxids);
82  bool conflictPending);
83 
84 extern bool MinimumActiveBackends(int min);
85 extern int CountDBBackends(Oid databaseid);
86 extern int CountDBConnections(Oid databaseid);
87 extern void CancelDBBackends(Oid databaseid, ProcSignalReason sigmode, bool conflictPending);
88 extern int CountUserBackends(Oid roleid);
89 extern bool CountOtherDBBackends(Oid databaseId,
90  int *nbackends, int *nprepared);
91 extern void TerminateOtherDBBackends(Oid databaseId);
92 
94  int nxids, const TransactionId *xids,
95  TransactionId latestXid);
96 
98  TransactionId catalog_xmin, bool already_locked);
99 
101  TransactionId *catalog_xmin);
102 
103 #endif /* PROCARRAY_H */
uint32 TransactionId
Definition: c.h:652
size_t Size
Definition: c.h:605
unsigned int Oid
Definition: postgres_ext.h:31
TransactionId GetOldestNonRemovableTransactionId(Relation rel)
Definition: procarray.c:1993
VirtualTransactionId * GetVirtualXIDsDelayingChkpt(int *nvxids, int type)
Definition: procarray.c:3030
void ProcArrayGetReplicationSlotXmin(TransactionId *xmin, TransactionId *catalog_xmin)
Definition: procarray.c:3955
pid_t SignalVirtualTransaction(VirtualTransactionId vxid, ProcSignalReason sigmode, bool conflictPending)
Definition: procarray.c:3484
Size ProcArrayShmemSize(void)
Definition: procarray.c:376
TransactionId GetOldestSafeDecodingTransactionId(bool catalogOnly)
Definition: procarray.c:2932
void XidCacheRemoveRunningXids(TransactionId xid, int nxids, const TransactionId *xids, TransactionId latestXid)
Definition: procarray.c:3978
bool TransactionIdIsActive(TransactionId xid)
Definition: procarray.c:1622
bool MinimumActiveBackends(int min)
Definition: procarray.c:3533
void TerminateOtherDBBackends(Oid databaseId)
Definition: procarray.c:3815
void ExpireAllKnownAssignedTransactionIds(void)
Definition: procarray.c:4485
VirtualTransactionId * GetConflictingVirtualXIDs(TransactionId limitXmin, Oid dbOid)
Definition: procarray.c:3404
RunningTransactions GetRunningTransactionData(void)
Definition: procarray.c:2681
TransactionId GetOldestActiveTransactionId(void)
Definition: procarray.c:2867
void ProcArrayEndTransaction(PGPROC *proc, TransactionId latestXid)
Definition: procarray.c:667
PGPROC * ProcNumberGetProc(int procNumber)
Definition: procarray.c:3125
void RecordKnownAssignedTransactionIds(TransactionId xid)
Definition: procarray.c:4390
TransactionId GetOldestTransactionIdConsideredRunning(void)
Definition: procarray.c:2022
int GetMaxSnapshotSubxidCount(void)
Definition: procarray.c:2068
int CountDBConnections(Oid databaseid)
Definition: procarray.c:3616
void CancelDBBackends(Oid databaseid, ProcSignalReason sigmode, bool conflictPending)
Definition: procarray.c:3647
void GetReplicationHorizons(TransactionId *xmin, TransactionId *catalog_xmin)
Definition: procarray.c:2035
void ProcArrayAdd(PGPROC *proc)
Definition: procarray.c:468
pid_t CancelVirtualTransaction(VirtualTransactionId vxid, ProcSignalReason sigmode)
Definition: procarray.c:3478
Snapshot GetSnapshotData(Snapshot snapshot)
Definition: procarray.c:2165
bool HaveVirtualXIDsDelayingChkpt(VirtualTransactionId *vxids, int nvxids, int type)
Definition: procarray.c:3076
void KnownAssignedTransactionIdsIdleMaintenance(void)
Definition: procarray.c:4527
int GetMaxSnapshotXidCount(void)
Definition: procarray.c:2057
int CountDBBackends(Oid databaseid)
Definition: procarray.c:3586
bool ProcArrayInstallRestoredXmin(TransactionId xmin, PGPROC *proc)
Definition: procarray.c:2608
void CreateSharedProcArray(void)
Definition: procarray.c:418
void ProcArrayApplyRecoveryInfo(RunningTransactions running)
Definition: procarray.c:1054
void ProcArrayClearTransaction(PGPROC *proc)
Definition: procarray.c:907
void ProcNumberGetTransactionIds(int procNumber, TransactionId *xid, TransactionId *xmin, int *nsubxid, bool *overflowed)
Definition: procarray.c:3147
VirtualTransactionId * GetCurrentVirtualXIDs(TransactionId limitXmin, bool excludeXmin0, bool allDbs, int excludeVacuum, int *nvxids)
Definition: procarray.c:3311
int CountUserBackends(Oid roleid)
Definition: procarray.c:3687
PGPROC * BackendPidGetProc(int pid)
Definition: procarray.c:3183
PGPROC * BackendPidGetProcWithLock(int pid)
Definition: procarray.c:3206
void ProcArrayApplyXidAssignment(TransactionId topxid, int nsubxids, TransactionId *subxids)
Definition: procarray.c:1306
bool CountOtherDBBackends(Oid databaseId, int *nbackends, int *nprepared)
Definition: procarray.c:3737
int BackendXidGetPid(TransactionId xid)
Definition: procarray.c:3243
bool IsBackendPid(int pid)
Definition: procarray.c:3278
void ProcArraySetReplicationSlotXmin(TransactionId xmin, TransactionId catalog_xmin, bool already_locked)
Definition: procarray.c:3930
void ProcArrayInitRecovery(TransactionId initializedUptoXID)
Definition: procarray.c:1023
void ProcArrayRemove(PGPROC *proc, TransactionId latestXid)
Definition: procarray.c:565
void ExpireTreeKnownAssignedTransactionIds(TransactionId xid, int nsubxids, TransactionId *subxids, TransactionId max_xid)
Definition: procarray.c:4459
bool ProcArrayInstallImportedXmin(TransactionId xmin, VirtualTransactionId *sourcevxid)
Definition: procarray.c:2524
bool TransactionIdIsInProgress(TransactionId xid)
Definition: procarray.c:1390
void ExpireOldKnownAssignedTransactionIds(TransactionId xid)
Definition: procarray.c:4505
ProcSignalReason
Definition: procsignal.h:31
Definition: proc.h:157
const char * type