Line data    Source code

       1             : /*-------------------------------------------------------------------------
       2             :  *
       3             :  * xlogbackup.c
       4             :  *      Internal routines for base backups.
       5             :  *
       6             :  * Portions Copyright (c) 1996-2024, PostgreSQL Global Development Group
       7             :  * Portions Copyright (c) 1994, Regents of the University of California
       8             :  *
       9             :  * IDENTIFICATION
      10             :  *      src/backend/access/transam/xlogbackup.c
      11             :  *-------------------------------------------------------------------------
      12             :  */
      13             : 
      14             : #include "postgres.h"
      15             : 
      16             : #include "access/xlog.h"
      17             : #include "access/xlog_internal.h"
      18             : #include "access/xlogbackup.h"
      19             : 
      20             : /*
      21             :  * Build contents for backup_label or backup history file.
      22             :  *
      23             :  * When ishistoryfile is true, it creates the contents for a backup history
      24             :  * file, otherwise it creates contents for a backup_label file.
      25             :  *
      26             :  * Returns the result generated as a palloc'd string.
      27             :  */
      28             : char *
      29         542 : build_backup_content(BackupState *state, bool ishistoryfile)
      30             : {
      31             :     char        startstrbuf[128];
      32             :     char        startxlogfile[MAXFNAMELEN]; /* backup start WAL file */
      33             :     XLogSegNo   startsegno;
      34         542 :     StringInfo  result = makeStringInfo();
      35             :     char       *data;
      36             : 
      37             :     Assert(state != NULL);
      38             : 
      39             :     /* Use the log timezone here, not the session timezone */
      40         542 :     pg_strftime(startstrbuf, sizeof(startstrbuf), "%Y-%m-%d %H:%M:%S %Z",
      41         542 :                 pg_localtime(&state->starttime, log_timezone));
      42             : 
      43         542 :     XLByteToSeg(state->startpoint, startsegno, wal_segment_size);
      44         542 :     XLogFileName(startxlogfile, state->starttli, startsegno, wal_segment_size);
      45         542 :     appendStringInfo(result, "START WAL LOCATION: %X/%X (file %s)\n",
      46         542 :                      LSN_FORMAT_ARGS(state->startpoint), startxlogfile);
      47             : 
      48         542 :     if (ishistoryfile)
      49             :     {
      50             :         char        stopxlogfile[MAXFNAMELEN];  /* backup stop WAL file */
      51             :         XLogSegNo   stopsegno;
      52             : 
      53         258 :         XLByteToSeg(state->stoppoint, stopsegno, wal_segment_size);
      54         258 :         XLogFileName(stopxlogfile, state->stoptli, stopsegno, wal_segment_size);
      55         258 :         appendStringInfo(result, "STOP WAL LOCATION: %X/%X (file %s)\n",
      56         258 :                          LSN_FORMAT_ARGS(state->stoppoint), stopxlogfile);
      57             :     }
      58             : 
      59         542 :     appendStringInfo(result, "CHECKPOINT LOCATION: %X/%X\n",
      60         542 :                      LSN_FORMAT_ARGS(state->checkpointloc));
      61         542 :     appendStringInfoString(result, "BACKUP METHOD: streamed\n");
      62         542 :     appendStringInfo(result, "BACKUP FROM: %s\n",
      63         542 :                      state->started_in_recovery ? "standby" : "primary");
      64         542 :     appendStringInfo(result, "START TIME: %s\n", startstrbuf);
      65         542 :     appendStringInfo(result, "LABEL: %s\n", state->name);
      66         542 :     appendStringInfo(result, "START TIMELINE: %u\n", state->starttli);
      67             : 
      68         542 :     if (ishistoryfile)
      69             :     {
      70             :         char        stopstrfbuf[128];
      71             : 
      72             :         /* Use the log timezone here, not the session timezone */
      73         258 :         pg_strftime(stopstrfbuf, sizeof(stopstrfbuf), "%Y-%m-%d %H:%M:%S %Z",
      74         258 :                     pg_localtime(&state->stoptime, log_timezone));
      75             : 
      76         258 :         appendStringInfo(result, "STOP TIME: %s\n", stopstrfbuf);
      77         258 :         appendStringInfo(result, "STOP TIMELINE: %u\n", state->stoptli);
      78             :     }
      79             : 
      80             :     /* either both istartpoint and istarttli should be set, or neither */
      81             :     Assert(XLogRecPtrIsInvalid(state->istartpoint) == (state->istarttli == 0));
      82         542 :     if (!XLogRecPtrIsInvalid(state->istartpoint))
      83             :     {
      84          28 :         appendStringInfo(result, "INCREMENTAL FROM LSN: %X/%X\n",
      85          28 :                          LSN_FORMAT_ARGS(state->istartpoint));
      86          28 :         appendStringInfo(result, "INCREMENTAL FROM TLI: %u\n",
      87             :                          state->istarttli);
      88             :     }
      89             : 
      90         542 :     data = result->data;
      91         542 :     pfree(result);
      92             : 
      93         542 :     return data;
      94             : }