xlogbackup.h File Reference

#include "access/xlogdefs.h"
#include "pgtime.h"

Include dependency graph for xlogbackup.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	BackupState

Typedefs
typedef struct BackupState	BackupState

Functions
char *	build_backup_content (BackupState *state, bool ishistoryfile)

Typedef Documentation

BackupState

typedef struct BackupState BackupState

Function Documentation

build_backup_content()

char * build_backup_content ( BackupState *  state, bool  ishistoryfile  )

extern

Definition at line 29 of file xlogbackup.c.

{
    char        startstrbuf[128];
    char        startxlogfile[MAXFNAMELEN]; /* backup start WAL file */
    XLogSegNo   startsegno;
    StringInfoData result;
 
    Assert(state != NULL);
 
    initStringInfo(&result);
 
    /* 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(XLogRecPtrIsValid(state->istartpoint) == (state->istarttli != 0));
    if (XLogRecPtrIsValid(state->istartpoint))
    {
        appendStringInfo(&result, "INCREMENTAL FROM LSN: %X/%08X\n",
                         LSN_FORMAT_ARGS(state->istartpoint));
        appendStringInfo(&result, "INCREMENTAL FROM TLI: %u\n",
                         state->istarttli);
    }
 
    return result.data;
}

References appendStringInfo(), appendStringInfoString(), Assert, StringInfoData::data, fb(), initStringInfo(), log_timezone, LSN_FORMAT_ARGS, MAXFNAMELEN, pg_localtime(), pg_strftime(), wal_segment_size, XLByteToSeg, XLogFileName(), and XLogRecPtrIsValid.

Referenced by do_pg_backup_stop(), perform_base_backup(), and pg_backup_stop().