mirror of
https://github.com/postgres/postgres.git
synced 2025-08-28 18:48:04 +03:00
A manifest is a JSON document which includes (1) the file name, size, last modification time, and an optional checksum for each file backed up, (2) timelines and LSNs for whatever WAL will need to be replayed to make the backup consistent, and (3) a checksum for the manifest itself. By default, we use CRC-32C when checksumming data files, because we are trying to detect corruption and user error, not foil an adversary. However, pg_basebackup and the server-side BASE_BACKUP command now have options to select a different algorithm, so users wanting a cryptographic hash function can select SHA-224, SHA-256, SHA-384, or SHA-512. Users not wanting file checksums at all can disable them, or disable generating of the backup manifest altogether. Using a cryptographic hash function in place of CRC-32C consumes significantly more CPU cycles, which may slow down backups in some cases. A new tool called pg_validatebackup can validate a backup against the manifest. If no checksums are present, it can still check that the right files exist and that they have the expected sizes. If checksums are present, it can also verify that each file has the expected checksum. Additionally, it calls pg_waldump to verify that the expected WAL files are present and parseable. Only plain format backups can be validated directly, but tar format backups can be validated after extracting them. Robert Haas, with help, ideas, review, and testing from David Steele, Stephen Frost, Andrew Dunstan, Rushabh Lathia, Suraj Kharage, Tushar Ahuja, Rajkumar Raghuwanshi, Mark Dilger, Davinder Singh, Jeevan Chalke, Amit Kapila, Andres Freund, and Noah Misch. Discussion: http://postgr.es/m/CA+TgmoZV8dw1H2bzZ9xkKwdrk8+XYa+DC9H=F7heO2zna5T6qg@mail.gmail.com
256 lines
5.0 KiB
Plaintext
256 lines
5.0 KiB
Plaintext
%{
|
|
/*-------------------------------------------------------------------------
|
|
*
|
|
* repl_scanner.l
|
|
* a lexical scanner for the replication commands
|
|
*
|
|
* Portions Copyright (c) 1996-2020, PostgreSQL Global Development Group
|
|
* Portions Copyright (c) 1994, Regents of the University of California
|
|
*
|
|
*
|
|
* IDENTIFICATION
|
|
* src/backend/replication/repl_scanner.l
|
|
*
|
|
*-------------------------------------------------------------------------
|
|
*/
|
|
#include "postgres.h"
|
|
|
|
#include "utils/builtins.h"
|
|
#include "parser/scansup.h"
|
|
|
|
/* Avoid exit() on fatal scanner errors (a bit ugly -- see yy_fatal_error) */
|
|
#undef fprintf
|
|
#define fprintf(file, fmt, msg) fprintf_to_ereport(fmt, msg)
|
|
|
|
static void
|
|
fprintf_to_ereport(const char *fmt, const char *msg)
|
|
{
|
|
ereport(ERROR, (errmsg_internal("%s", msg)));
|
|
}
|
|
|
|
/* Handle to the buffer that the lexer uses internally */
|
|
static YY_BUFFER_STATE scanbufhandle;
|
|
|
|
static StringInfoData litbuf;
|
|
|
|
static void startlit(void);
|
|
static char *litbufdup(void);
|
|
static void addlit(char *ytext, int yleng);
|
|
static void addlitchar(unsigned char ychar);
|
|
|
|
/* LCOV_EXCL_START */
|
|
|
|
%}
|
|
|
|
%option 8bit
|
|
%option never-interactive
|
|
%option nodefault
|
|
%option noinput
|
|
%option nounput
|
|
%option noyywrap
|
|
%option warn
|
|
%option prefix="replication_yy"
|
|
|
|
%x xq xd
|
|
|
|
/* Extended quote
|
|
* xqdouble implements embedded quote, ''''
|
|
*/
|
|
xqstart {quote}
|
|
xqdouble {quote}{quote}
|
|
xqinside [^']+
|
|
|
|
/* Double quote
|
|
* Allows embedded spaces and other special characters into identifiers.
|
|
*/
|
|
dquote \"
|
|
xdstart {dquote}
|
|
xdstop {dquote}
|
|
xddouble {dquote}{dquote}
|
|
xdinside [^"]+
|
|
|
|
digit [0-9]+
|
|
hexdigit [0-9A-Za-z]+
|
|
|
|
quote '
|
|
quotestop {quote}
|
|
|
|
ident_start [A-Za-z\200-\377_]
|
|
ident_cont [A-Za-z\200-\377_0-9\$]
|
|
|
|
identifier {ident_start}{ident_cont}*
|
|
|
|
%%
|
|
|
|
BASE_BACKUP { return K_BASE_BACKUP; }
|
|
FAST { return K_FAST; }
|
|
IDENTIFY_SYSTEM { return K_IDENTIFY_SYSTEM; }
|
|
SHOW { return K_SHOW; }
|
|
LABEL { return K_LABEL; }
|
|
NOWAIT { return K_NOWAIT; }
|
|
PROGRESS { return K_PROGRESS; }
|
|
MAX_RATE { return K_MAX_RATE; }
|
|
WAL { return K_WAL; }
|
|
TABLESPACE_MAP { return K_TABLESPACE_MAP; }
|
|
NOVERIFY_CHECKSUMS { return K_NOVERIFY_CHECKSUMS; }
|
|
TIMELINE { return K_TIMELINE; }
|
|
START_REPLICATION { return K_START_REPLICATION; }
|
|
CREATE_REPLICATION_SLOT { return K_CREATE_REPLICATION_SLOT; }
|
|
DROP_REPLICATION_SLOT { return K_DROP_REPLICATION_SLOT; }
|
|
TIMELINE_HISTORY { return K_TIMELINE_HISTORY; }
|
|
PHYSICAL { return K_PHYSICAL; }
|
|
RESERVE_WAL { return K_RESERVE_WAL; }
|
|
LOGICAL { return K_LOGICAL; }
|
|
SLOT { return K_SLOT; }
|
|
TEMPORARY { return K_TEMPORARY; }
|
|
EXPORT_SNAPSHOT { return K_EXPORT_SNAPSHOT; }
|
|
NOEXPORT_SNAPSHOT { return K_NOEXPORT_SNAPSHOT; }
|
|
USE_SNAPSHOT { return K_USE_SNAPSHOT; }
|
|
WAIT { return K_WAIT; }
|
|
MANIFEST { return K_MANIFEST; }
|
|
MANIFEST_CHECKSUMS { return K_MANIFEST_CHECKSUMS; }
|
|
|
|
"," { return ','; }
|
|
";" { return ';'; }
|
|
"(" { return '('; }
|
|
")" { return ')'; }
|
|
|
|
[\n] ;
|
|
[\t] ;
|
|
" " ;
|
|
|
|
{digit}+ {
|
|
yylval.uintval = strtoul(yytext, NULL, 10);
|
|
return UCONST;
|
|
}
|
|
|
|
{hexdigit}+\/{hexdigit}+ {
|
|
uint32 hi,
|
|
lo;
|
|
if (sscanf(yytext, "%X/%X", &hi, &lo) != 2)
|
|
yyerror("invalid streaming start location");
|
|
yylval.recptr = ((uint64) hi) << 32 | lo;
|
|
return RECPTR;
|
|
}
|
|
|
|
{xqstart} {
|
|
BEGIN(xq);
|
|
startlit();
|
|
}
|
|
|
|
<xq>{quotestop} {
|
|
yyless(1);
|
|
BEGIN(INITIAL);
|
|
yylval.str = litbufdup();
|
|
return SCONST;
|
|
}
|
|
|
|
<xq>{xqdouble} {
|
|
addlitchar('\'');
|
|
}
|
|
|
|
<xq>{xqinside} {
|
|
addlit(yytext, yyleng);
|
|
}
|
|
|
|
{xdstart} {
|
|
BEGIN(xd);
|
|
startlit();
|
|
}
|
|
|
|
<xd>{xdstop} {
|
|
int len;
|
|
yyless(1);
|
|
BEGIN(INITIAL);
|
|
yylval.str = litbufdup();
|
|
len = strlen(yylval.str);
|
|
truncate_identifier(yylval.str, len, true);
|
|
return IDENT;
|
|
}
|
|
|
|
<xd>{xdinside} {
|
|
addlit(yytext, yyleng);
|
|
}
|
|
|
|
{identifier} {
|
|
int len = strlen(yytext);
|
|
|
|
yylval.str = downcase_truncate_identifier(yytext, len, true);
|
|
return IDENT;
|
|
}
|
|
|
|
<xq,xd><<EOF>> { yyerror("unterminated quoted string"); }
|
|
|
|
|
|
<<EOF>> {
|
|
yyterminate();
|
|
}
|
|
|
|
. {
|
|
return T_WORD;
|
|
}
|
|
%%
|
|
|
|
/* LCOV_EXCL_STOP */
|
|
|
|
static void
|
|
startlit(void)
|
|
{
|
|
initStringInfo(&litbuf);
|
|
}
|
|
|
|
static char *
|
|
litbufdup(void)
|
|
{
|
|
return litbuf.data;
|
|
}
|
|
|
|
static void
|
|
addlit(char *ytext, int yleng)
|
|
{
|
|
appendBinaryStringInfo(&litbuf, ytext, yleng);
|
|
}
|
|
|
|
static void
|
|
addlitchar(unsigned char ychar)
|
|
{
|
|
appendStringInfoChar(&litbuf, ychar);
|
|
}
|
|
|
|
void
|
|
yyerror(const char *message)
|
|
{
|
|
ereport(ERROR,
|
|
(errcode(ERRCODE_SYNTAX_ERROR),
|
|
errmsg_internal("%s", message)));
|
|
}
|
|
|
|
|
|
void
|
|
replication_scanner_init(const char *str)
|
|
{
|
|
Size slen = strlen(str);
|
|
char *scanbuf;
|
|
|
|
/*
|
|
* Might be left over after ereport()
|
|
*/
|
|
if (YY_CURRENT_BUFFER)
|
|
yy_delete_buffer(YY_CURRENT_BUFFER);
|
|
|
|
/*
|
|
* Make a scan buffer with special termination needed by flex.
|
|
*/
|
|
scanbuf = (char *) palloc(slen + 2);
|
|
memcpy(scanbuf, str, slen);
|
|
scanbuf[slen] = scanbuf[slen + 1] = YY_END_OF_BUFFER_CHAR;
|
|
scanbufhandle = yy_scan_buffer(scanbuf, slen + 2);
|
|
}
|
|
|
|
void
|
|
replication_scanner_finish(void)
|
|
{
|
|
yy_delete_buffer(scanbufhandle);
|
|
scanbufhandle = NULL;
|
|
}
|