32#define BLOCKS_PER_READ 512
40#define MAX_CHUNK (128 * 1024)
63#define SH_PREFIX backup_file
64#define SH_ELEMENT_TYPE backup_file_entry
65#define SH_KEY_TYPE const char *
67#define SH_HASH_KEY(tb, key) hash_string_pointer(key)
68#define SH_EQUAL(tb, a, b) (strcmp(a, b) == 0)
69#define SH_SCOPE static inline
129 int manifest_version);
131 uint64 manifest_system_identifier);
133 const char *pathname,
137 uint8 *checksum_payload);
269 *required_wslist =
NIL;
274 bool found_backup_start_tli =
false;
289 if (num_wal_ranges == 0)
291 (
errcode(ERRCODE_OBJECT_NOT_IN_PREREQUISITE_STATE),
292 errmsg(
"manifest contains no required WAL ranges")));
315 for (
i = 0;
i < num_wal_ranges; ++
i)
318 bool saw_earliest_wal_range_tli =
false;
319 bool saw_latest_wal_range_tli =
false;
332 if (tle->
tli == earliest_wal_range_tli)
333 saw_earliest_wal_range_tli =
true;
334 if (tle->
tli == latest_wal_range_tli)
335 saw_latest_wal_range_tli =
true;
346 (
errcode(ERRCODE_OBJECT_NOT_IN_PREREQUISITE_STATE),
347 errmsg(
"timeline %u found in manifest, but not in this server's history",
363 if (!saw_latest_wal_range_tli)
364 latest_wal_range_tli =
range->tli;
365 if (earliest_wal_range_tli == 0 || saw_earliest_wal_range_tli)
367 earliest_wal_range_tli =
range->tli;
368 earliest_wal_range_start_lsn =
range->start_lsn;
403 for (
i = 0;
i < num_wal_ranges; ++
i)
407 if (
range->tli == earliest_wal_range_tli)
411 (
errcode(ERRCODE_OBJECT_NOT_IN_PREREQUISITE_STATE),
412 errmsg(
"manifest requires WAL from initial timeline %u starting at %X/%X, but that timeline begins at %X/%X",
421 (
errcode(ERRCODE_OBJECT_NOT_IN_PREREQUISITE_STATE),
422 errmsg(
"manifest requires WAL from continuation timeline %u starting at %X/%X, but that timeline begins at %X/%X",
428 if (
range->tli == latest_wal_range_tli)
432 (
errcode(ERRCODE_OBJECT_NOT_IN_PREREQUISITE_STATE),
433 errmsg(
"manifest requires WAL from final timeline %u ending at %X/%X, but this backup starts at %X/%X",
437 errhint(
"This can happen for incremental backups on a standby if there was little activity since the previous backup.")));
443 (
errcode(ERRCODE_OBJECT_NOT_IN_PREREQUISITE_STATE),
444 errmsg(
"manifest requires WAL from non-final timeline %u ending at %X/%X, but this server switched timelines at %X/%X",
493 found_backup_start_tli =
true;
496 else if (!found_backup_start_tli)
508 if (tle->
tli == earliest_wal_range_tli)
509 tli_start_lsn = earliest_wal_range_start_lsn;
511 tli_start_lsn, tli_end_lsn);
524 (
errcode(ERRCODE_OBJECT_NOT_IN_PREREQUISITE_STATE),
525 errmsg(
"WAL summaries are required on timeline %u from %X/%X to %X/%X, but no summaries for that timeline and LSN range exist",
531 (
errcode(ERRCODE_OBJECT_NOT_IN_PREREQUISITE_STATE),
532 errmsg(
"WAL summaries are required on timeline %u from %X/%X to %X/%X, but the summaries for that timeline and LSN range are incomplete",
536 errdetail(
"The first unsummarized LSN in this range is %X/%X.",
554 required_wslist =
list_concat(required_wslist, tli_wslist);
560 if (tle->
tli == earliest_wal_range_tli)
572 foreach(lc, required_wslist)
594 forknum, limit_block);
606 for (
i = 0;
i < nblocks; ++
i)
635 lastslash = strrchr(path.
str,
'/');
636 Assert(lastslash != NULL);
640 ipath =
psprintf(
"%s/INCREMENTAL.%s.%u", path.
str, lastslash + 1, segno);
642 ipath =
psprintf(
"%s/INCREMENTAL.%s", path.
str, lastslash + 1);
666 unsigned segno,
size_t size,
667 unsigned *num_blocks_required,
669 unsigned *truncation_block_length)
693 if ((size % BLCKSZ) != 0 || size / BLCKSZ > RELSEG_SIZE)
740 rlocator.
dbOid = dboid;
743 &limit_block) != NULL)
768 if (brtentry == NULL)
772 *num_blocks_required = 0;
773 *truncation_block_length = size / BLCKSZ;
781 if (limit_block <= segno * RELSEG_SIZE)
790 start_blkno = segno * RELSEG_SIZE;
791 stop_blkno = start_blkno + (size / BLCKSZ);
792 if (start_blkno / RELSEG_SIZE != segno || stop_blkno < start_blkno)
794 errcode(ERRCODE_INTERNAL_ERROR),
795 errmsg_internal(
"overflow computing block number bounds for segment %u with size %zu",
803 relative_block_numbers, RELSEG_SIZE);
804 Assert(nblocks <= RELSEG_SIZE);
818 if (nblocks * BLCKSZ > size * 0.9)
833 if (start_blkno != 0)
835 for (
i = 0;
i < nblocks; ++
i)
836 relative_block_numbers[
i] -= start_blkno;
838 *num_blocks_required = nblocks;
848 *truncation_block_length = size / BLCKSZ;
851 unsigned relative_limit = limit_block - segno * RELSEG_SIZE;
853 if (*truncation_block_length < relative_limit)
854 *truncation_block_length = relative_limit;
872 Assert(num_blocks_required <= RELSEG_SIZE);
885 if ((num_blocks_required > 0) && (result % BLCKSZ != 0))
886 result += BLCKSZ - (result % BLCKSZ);
900 Assert(num_blocks_required <= RELSEG_SIZE);
908 result += BLCKSZ * num_blocks_required;
919 unsigned char *ss = (
unsigned char *) s;
929 int manifest_version)
932 if (manifest_version == 1)
934 "backup manifest version 1 does not support incremental backup");
943 uint64 manifest_system_identifier)
950 if (manifest_system_identifier != system_identifier)
952 "system identifier in backup manifest is %llu, but database system identifier is %llu",
953 (
unsigned long long) manifest_system_identifier,
954 (
unsigned long long) system_identifier);
965 const char *pathname,
uint64 size,
968 uint8 *checksum_payload)
999 range->start_lsn = start_lsn;
1000 range->end_lsn = end_lsn;
List * readTimeLineHistory(TimeLineID targetTLI)
void AppendIncrementalManifestData(IncrementalBackupInfo *ib, const char *data, int len)
static void manifest_process_version(JsonManifestParseContext *context, int manifest_version)
static pg_noreturn void static int compare_block_numbers(const void *a, const void *b)
static uint32 hash_string_pointer(const char *s)
size_t GetIncrementalHeaderSize(unsigned num_blocks_required)
static void manifest_process_system_identifier(JsonManifestParseContext *context, uint64 manifest_system_identifier)
size_t GetIncrementalFileSize(unsigned num_blocks_required)
static void manifest_process_file(JsonManifestParseContext *context, const char *pathname, uint64 size, pg_checksum_type checksum_type, int checksum_length, uint8 *checksum_payload)
IncrementalBackupInfo * CreateIncrementalBackupInfo(MemoryContext mcxt)
FileBackupMethod GetFileBackupMethod(IncrementalBackupInfo *ib, const char *path, Oid dboid, Oid spcoid, RelFileNumber relfilenumber, ForkNumber forknum, unsigned segno, size_t size, unsigned *num_blocks_required, BlockNumber *relative_block_numbers, unsigned *truncation_block_length)
static pg_noreturn void manifest_report_error(JsonManifestParseContext *context, const char *fmt,...) pg_attribute_printf(2
char * GetIncrementalFilePath(Oid dboid, Oid spcoid, RelFileNumber relfilenumber, ForkNumber forknum, unsigned segno)
static void manifest_process_wal_range(JsonManifestParseContext *context, TimeLineID tli, XLogRecPtr start_lsn, XLogRecPtr end_lsn)
void PrepareForIncrementalBackup(IncrementalBackupInfo *ib, BackupState *backup_state)
void FinalizeIncrementalManifest(IncrementalBackupInfo *ib)
@ BACK_UP_FILE_INCREMENTALLY
BlockRefTableEntry * BlockRefTableGetEntry(BlockRefTable *brtab, const RelFileLocator *rlocator, ForkNumber forknum, BlockNumber *limit_block)
bool BlockRefTableReaderNextRelation(BlockRefTableReader *reader, RelFileLocator *rlocator, ForkNumber *forknum, BlockNumber *limit_block)
int BlockRefTableEntryGetBlocks(BlockRefTableEntry *entry, BlockNumber start_blkno, BlockNumber stop_blkno, BlockNumber *blocks, int nblocks)
void BlockRefTableMarkBlockModified(BlockRefTable *brtab, const RelFileLocator *rlocator, ForkNumber forknum, BlockNumber blknum)
BlockRefTableReader * CreateBlockRefTableReader(io_callback_fn read_callback, void *read_callback_arg, char *error_filename, report_error_fn error_callback, void *error_callback_arg)
unsigned BlockRefTableReaderGetBlocks(BlockRefTableReader *reader, BlockNumber *blocks, int nblocks)
void BlockRefTableSetLimitBlock(BlockRefTable *brtab, const RelFileLocator *rlocator, ForkNumber forknum, BlockNumber limit_block)
void DestroyBlockRefTableReader(BlockRefTableReader *reader)
void(*) BlockRefTable CreateEmptyBlockRefTable)(void)
static bool BlockNumberIsValid(BlockNumber blockNumber)
#define pg_attribute_printf(f, a)
#define OidIsValid(objectId)
int errmsg_internal(const char *fmt,...)
int errdetail(const char *fmt,...)
int errhint(const char *fmt,...)
int errcode(int sqlerrcode)
int errmsg(const char *fmt,...)
#define ereport(elevel,...)
char * FilePathName(File file)
void FileClose(File file)
uint32 hash_bytes(const unsigned char *k, int keylen)
Assert(PointerIsAligned(start, uint64))
static int pg_cmp_u32(uint32 a, uint32 b)
List * lappend(List *list, void *datum)
List * list_concat(List *list1, const List *list2)
char * MemoryContextStrdup(MemoryContext context, const char *string)
void pfree(void *pointer)
void * palloc0(Size size)
static MemoryContext MemoryContextSwitchTo(MemoryContext context)
JsonManifestParseIncrementalState * json_parse_manifest_incremental_init(JsonManifestParseContext *context)
void json_parse_manifest_incremental_shutdown(JsonManifestParseIncrementalState *incstate)
void json_parse_manifest_incremental_chunk(JsonManifestParseIncrementalState *incstate, const char *chunk, size_t size, bool is_last)
static int list_length(const List *l)
static void * list_nth(const List *list, int n)
#define qsort(a, b, c, d)
#define INVALID_PROC_NUMBER
char * psprintf(const char *fmt,...)
static struct cvec * range(struct vars *v, chr a, chr b, int cases)
RelPathStr GetRelationPath(Oid dbOid, Oid spcOid, RelFileNumber relNumber, int procNumber, ForkNumber forkNumber)
#define RelFileNumberIsValid(relnumber)
int appendStringInfoVA(StringInfo str, const char *fmt, va_list args)
void enlargeStringInfo(StringInfo str, int needed)
void appendBinaryStringInfo(StringInfo str, const void *data, int datalen)
void initStringInfo(StringInfo str)
List * manifest_wal_ranges
backup_file_hash * manifest_files
JsonManifestParseIncrementalState * inc_state
json_manifest_per_wal_range_callback per_wal_range_cb
json_manifest_system_identifier_callback system_identifier_cb
json_manifest_error_callback error_cb
json_manifest_per_file_callback per_file_cb
json_manifest_version_callback version_cb
char str[REL_PATH_STR_MAXLEN+1]
void WaitForWalSummarization(XLogRecPtr lsn)
File OpenWalSummaryFile(WalSummaryFile *ws, bool missing_ok)
bool WalSummariesAreComplete(List *wslist, XLogRecPtr start_lsn, XLogRecPtr end_lsn, XLogRecPtr *missing_lsn)
int ReadWalSummary(void *wal_summary_io, void *data, int length)
List * GetWalSummaries(TimeLineID tli, XLogRecPtr start_lsn, XLogRecPtr end_lsn)
void ReportWalSummaryError(void *callback_arg, char *fmt,...)
List * FilterWalSummaries(List *wslist, TimeLineID tli, XLogRecPtr start_lsn, XLogRecPtr end_lsn)
uint64 GetSystemIdentifier(void)
#define LSN_FORMAT_ARGS(lsn)
#define XLogRecPtrIsInvalid(r)
#define InvalidXLogRecPtr
static BackupState * backup_state
static List * expectedTLEs