1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
|
/*
* xlogrecovery.h
*
* Functions for WAL recovery and standby mode
*
* Portions Copyright (c) 1996-2023, PostgreSQL Global Development Group
* Portions Copyright (c) 1994, Regents of the University of California
*
* src/include/access/xlogrecovery.h
*/
#ifndef XLOGRECOVERY_H
#define XLOGRECOVERY_H
#include "access/xlogreader.h"
#include "catalog/pg_control.h"
#include "lib/stringinfo.h"
#include "utils/timestamp.h"
/*
* Recovery target type.
* Only set during a Point in Time recovery, not when in standby mode.
*/
typedef enum
{
RECOVERY_TARGET_UNSET,
RECOVERY_TARGET_XID,
RECOVERY_TARGET_TIME,
RECOVERY_TARGET_NAME,
RECOVERY_TARGET_LSN,
RECOVERY_TARGET_IMMEDIATE
} RecoveryTargetType;
/*
* Recovery target TimeLine goal
*/
typedef enum
{
RECOVERY_TARGET_TIMELINE_CONTROLFILE,
RECOVERY_TARGET_TIMELINE_LATEST,
RECOVERY_TARGET_TIMELINE_NUMERIC
} RecoveryTargetTimeLineGoal;
/* Recovery pause states */
typedef enum RecoveryPauseState
{
RECOVERY_NOT_PAUSED, /* pause not requested */
RECOVERY_PAUSE_REQUESTED, /* pause requested, but not yet paused */
RECOVERY_PAUSED /* recovery is paused */
} RecoveryPauseState;
/* User-settable GUC parameters */
extern __thread PGDLLIMPORT bool recoveryTargetInclusive;
extern __thread PGDLLIMPORT int recoveryTargetAction;
extern __thread PGDLLIMPORT int recovery_min_apply_delay;
extern __thread PGDLLIMPORT char *PrimaryConnInfo;
extern __thread PGDLLIMPORT char *PrimarySlotName;
extern __thread PGDLLIMPORT char *recoveryRestoreCommand;
extern __thread PGDLLIMPORT char *recoveryEndCommand;
extern __thread PGDLLIMPORT char *archiveCleanupCommand;
/* indirectly set via GUC system */
extern __thread PGDLLIMPORT TransactionId recoveryTargetXid;
extern __thread PGDLLIMPORT char *recovery_target_time_string;
extern __thread PGDLLIMPORT TimestampTz recoveryTargetTime;
extern __thread PGDLLIMPORT const char *recoveryTargetName;
extern __thread PGDLLIMPORT XLogRecPtr recoveryTargetLSN;
extern __thread PGDLLIMPORT RecoveryTargetType recoveryTarget;
extern __thread PGDLLIMPORT bool wal_receiver_create_temp_slot;
extern __thread PGDLLIMPORT RecoveryTargetTimeLineGoal recoveryTargetTimeLineGoal;
extern __thread PGDLLIMPORT TimeLineID recoveryTargetTLIRequested;
extern __thread PGDLLIMPORT TimeLineID recoveryTargetTLI;
/* Have we already reached a consistent database state? */
extern __thread PGDLLIMPORT bool reachedConsistency;
/* Are we currently in standby mode? */
extern __thread PGDLLIMPORT bool StandbyMode;
extern Size XLogRecoveryShmemSize(void);
extern void XLogRecoveryShmemInit(void);
extern void InitWalRecovery(ControlFileData *ControlFile,
bool *wasShutdown_ptr, bool *haveBackupLabel_ptr,
bool *haveTblspcMap_ptr);
extern void PerformWalRecovery(void);
/*
* FinishWalRecovery() returns this. It contains information about the point
* where recovery ended, and why it ended.
*/
typedef struct
{
/*
* Information about the last valid or applied record, after which new WAL
* can be appended. 'lastRec' is the position where the last record
* starts, and 'endOfLog' is its end. 'lastPage' is a copy of the last
* partial page that contains endOfLog (or NULL if endOfLog is exactly at
* page boundary). 'lastPageBeginPtr' is the position where the last page
* begins.
*
* endOfLogTLI is the TLI in the filename of the XLOG segment containing
* the last applied record. It could be different from lastRecTLI, if
* there was a timeline switch in that segment, and we were reading the
* old WAL from a segment belonging to a higher timeline.
*/
XLogRecPtr lastRec; /* start of last valid or applied record */
TimeLineID lastRecTLI;
XLogRecPtr endOfLog; /* end of last valid or applied record */
TimeLineID endOfLogTLI;
XLogRecPtr lastPageBeginPtr; /* LSN of page that contains endOfLog */
char *lastPage; /* copy of the last page, up to endOfLog */
/*
* abortedRecPtr is the start pointer of a broken record at end of WAL
* when recovery completes; missingContrecPtr is the location of the first
* contrecord that went missing. See CreateOverwriteContrecordRecord for
* details.
*/
XLogRecPtr abortedRecPtr;
XLogRecPtr missingContrecPtr;
/* short human-readable string describing why recovery ended */
char *recoveryStopReason;
/*
* If standby or recovery signal file was found, these flags are set
* accordingly.
*/
bool standby_signal_file_found;
bool recovery_signal_file_found;
} EndOfWalRecoveryInfo;
extern EndOfWalRecoveryInfo *FinishWalRecovery(void);
extern void ShutdownWalRecovery(void);
extern void RemovePromoteSignalFiles(void);
extern bool HotStandbyActive(void);
extern XLogRecPtr GetXLogReplayRecPtr(TimeLineID *replayTLI);
extern RecoveryPauseState GetRecoveryPauseState(void);
extern void SetRecoveryPause(bool recoveryPause);
extern void GetXLogReceiptTime(TimestampTz *rtime, bool *fromStream);
extern TimestampTz GetLatestXTime(void);
extern TimestampTz GetCurrentChunkReplayStartTime(void);
extern XLogRecPtr GetCurrentReplayRecPtr(TimeLineID *replayEndTLI);
extern bool PromoteIsTriggered(void);
extern bool CheckPromoteSignal(void);
extern void WakeupRecovery(void);
extern void StartupRequestWalReceiverRestart(void);
extern void XLogRequestWalReceiverReply(void);
extern void RecoveryRequiresIntParameter(const char *param_name, int currValue, int minValue);
extern void xlog_outdesc(StringInfo buf, XLogReaderState *record);
#endif /* XLOGRECOVERY_H */
|
