mirror of
https://github.com/postgres/postgres.git
synced 2025-11-27 00:05:03 -05:00
2633dae2e4
This commit standardizes the output format for LSNs to ensure consistent representation across various tools and messages. Previously, LSNs were inconsistently printed as `%X/%X` in some contexts, while others used zero-padding. This often led to confusion when comparing. To address this, the LSN format is now uniformly set to `%X/%08X`, ensuring the lower 32-bit part is always zero-padded to eight hexadecimal digits. Author: Japin Li <japinli@hotmail.com> Reviewed-by: Masahiko Sawada <sawada.mshk@gmail.com> Reviewed-by: Álvaro Herrera <alvherre@kurilemu.de> Discussion: https://postgr.es/m/ME0P300MB0445CA53CA0E4B8C1879AF84B641A@ME0P300MB0445.AUSP300.PROD.OUTLOOK.COM
95 lines
3.1 KiB
C
95 lines
3.1 KiB
C
/*-------------------------------------------------------------------------
|
|
*
|
|
* xlogbackup.c
|
|
* Internal routines for base backups.
|
|
*
|
|
* Portions Copyright (c) 1996-2025, PostgreSQL Global Development Group
|
|
* Portions Copyright (c) 1994, Regents of the University of California
|
|
*
|
|
* IDENTIFICATION
|
|
* src/backend/access/transam/xlogbackup.c
|
|
*-------------------------------------------------------------------------
|
|
*/
|
|
|
|
#include "postgres.h"
|
|
|
|
#include "access/xlog.h"
|
|
#include "access/xlog_internal.h"
|
|
#include "access/xlogbackup.h"
|
|
|
|
/*
|
|
* Build contents for backup_label or backup history file.
|
|
*
|
|
* When ishistoryfile is true, it creates the contents for a backup history
|
|
* file, otherwise it creates contents for a backup_label file.
|
|
*
|
|
* Returns the result generated as a palloc'd string.
|
|
*/
|
|
char *
|
|
build_backup_content(BackupState *state, bool ishistoryfile)
|
|
{
|
|
char startstrbuf[128];
|
|
char startxlogfile[MAXFNAMELEN]; /* backup start WAL file */
|
|
XLogSegNo startsegno;
|
|
StringInfo result = makeStringInfo();
|
|
char *data;
|
|
|
|
Assert(state != NULL);
|
|
|
|
/* Use the log timezone here, not the session timezone */
|
|
pg_strftime(startstrbuf, sizeof(startstrbuf), "%Y-%m-%d %H:%M:%S %Z",
|
|
pg_localtime(&state->starttime, log_timezone));
|
|
|
|
XLByteToSeg(state->startpoint, startsegno, wal_segment_size);
|
|
XLogFileName(startxlogfile, state->starttli, startsegno, wal_segment_size);
|
|
appendStringInfo(result, "START WAL LOCATION: %X/%08X (file %s)\n",
|
|
LSN_FORMAT_ARGS(state->startpoint), startxlogfile);
|
|
|
|
if (ishistoryfile)
|
|
{
|
|
char stopxlogfile[MAXFNAMELEN]; /* backup stop WAL file */
|
|
XLogSegNo stopsegno;
|
|
|
|
XLByteToSeg(state->stoppoint, stopsegno, wal_segment_size);
|
|
XLogFileName(stopxlogfile, state->stoptli, stopsegno, wal_segment_size);
|
|
appendStringInfo(result, "STOP WAL LOCATION: %X/%08X (file %s)\n",
|
|
LSN_FORMAT_ARGS(state->stoppoint), stopxlogfile);
|
|
}
|
|
|
|
appendStringInfo(result, "CHECKPOINT LOCATION: %X/%08X\n",
|
|
LSN_FORMAT_ARGS(state->checkpointloc));
|
|
appendStringInfoString(result, "BACKUP METHOD: streamed\n");
|
|
appendStringInfo(result, "BACKUP FROM: %s\n",
|
|
state->started_in_recovery ? "standby" : "primary");
|
|
appendStringInfo(result, "START TIME: %s\n", startstrbuf);
|
|
appendStringInfo(result, "LABEL: %s\n", state->name);
|
|
appendStringInfo(result, "START TIMELINE: %u\n", state->starttli);
|
|
|
|
if (ishistoryfile)
|
|
{
|
|
char stopstrfbuf[128];
|
|
|
|
/* Use the log timezone here, not the session timezone */
|
|
pg_strftime(stopstrfbuf, sizeof(stopstrfbuf), "%Y-%m-%d %H:%M:%S %Z",
|
|
pg_localtime(&state->stoptime, log_timezone));
|
|
|
|
appendStringInfo(result, "STOP TIME: %s\n", stopstrfbuf);
|
|
appendStringInfo(result, "STOP TIMELINE: %u\n", state->stoptli);
|
|
}
|
|
|
|
/* either both istartpoint and istarttli should be set, or neither */
|
|
Assert(XLogRecPtrIsInvalid(state->istartpoint) == (state->istarttli == 0));
|
|
if (!XLogRecPtrIsInvalid(state->istartpoint))
|
|
{
|
|
appendStringInfo(result, "INCREMENTAL FROM LSN: %X/%08X\n",
|
|
LSN_FORMAT_ARGS(state->istartpoint));
|
|
appendStringInfo(result, "INCREMENTAL FROM TLI: %u\n",
|
|
state->istarttli);
|
|
}
|
|
|
|
data = result->data;
|
|
pfree(result);
|
|
|
|
return data;
|
|
}
|