PostgreSQL Source Code  git master
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros
timeline.h
Go to the documentation of this file.
1 /*
2  * timeline.h
3  *
4  * Functions for reading and writing timeline history files.
5  *
6  * Portions Copyright (c) 1996-2017, PostgreSQL Global Development Group
7  * Portions Copyright (c) 1994, Regents of the University of California
8  *
9  * src/include/access/timeline.h
10  */
11 #ifndef TIMELINE_H
12 #define TIMELINE_H
13 
14 #include "access/xlogdefs.h"
15 #include "nodes/pg_list.h"
16 
17 /*
18  * A list of these structs describes the timeline history of the server. Each
19  * TimeLineHistoryEntry represents a piece of WAL belonging to the history,
20  * from newest to oldest. All WAL positions between 'begin' and 'end' belong to
21  * the timeline represented by the entry. Together the 'begin' and 'end'
22  * pointers of all the entries form a contiguous line from beginning of time
23  * to infinity.
24  */
25 typedef struct
26 {
28  XLogRecPtr begin; /* inclusive */
29  XLogRecPtr end; /* exclusive, InvalidXLogRecPtr means infinity */
31 
32 extern List *readTimeLineHistory(TimeLineID targetTLI);
33 extern bool existsTimeLineHistory(TimeLineID probeTLI);
35 extern void writeTimeLineHistory(TimeLineID newTLI, TimeLineID parentTLI,
36  XLogRecPtr switchpoint, char *reason);
37 extern void writeTimeLineHistoryFile(TimeLineID tli, char *content, int size);
38 extern void restoreTimeLineHistoryFiles(TimeLineID begin, TimeLineID end);
39 extern bool tliInHistory(TimeLineID tli, List *expectedTLIs);
40 extern TimeLineID tliOfPointInHistory(XLogRecPtr ptr, List *history);
41 extern XLogRecPtr tliSwitchPoint(TimeLineID tli, List *history,
42  TimeLineID *nextTLI);
43 
44 #endif /* TIMELINE_H */
bool tliInHistory(TimeLineID tli, List *expectedTLIs)
Definition: timeline.c:517
uint32 TimeLineID
Definition: xlogdefs.h:45
TimeLineID tli
Definition: timeline.h:27
List * readTimeLineHistory(TimeLineID targetTLI)
Definition: timeline.c:75
XLogRecPtr tliSwitchPoint(TimeLineID tli, List *history, TimeLineID *nextTLI)
Definition: timeline.c:563
void restoreTimeLineHistoryFiles(TimeLineID begin, TimeLineID end)
Definition: timeline.c:49
bool existsTimeLineHistory(TimeLineID probeTLI)
Definition: timeline.c:207
void writeTimeLineHistoryFile(TimeLineID tli, char *content, int size)
Definition: timeline.c:448
TimeLineID tliOfPointInHistory(XLogRecPtr ptr, List *history)
Definition: timeline.c:535
XLogRecPtr end
Definition: timeline.h:29
uint64 XLogRecPtr
Definition: xlogdefs.h:21
TimeLineID findNewestTimeLine(TimeLineID startTLI)
Definition: timeline.c:249
void writeTimeLineHistory(TimeLineID newTLI, TimeLineID parentTLI, XLogRecPtr switchpoint, char *reason)
Definition: timeline.c:289
XLogRecPtr begin
Definition: timeline.h:28
Definition: pg_list.h:45