PostgreSQL Source Code  git master
xlog_internal.h File Reference
#include "access/xlogdefs.h"
#include "access/xlogreader.h"
#include "datatype/timestamp.h"
#include "lib/stringinfo.h"
#include "pgtime.h"
#include "storage/block.h"
#include "storage/relfilenode.h"
Include dependency graph for xlog_internal.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures

struct  XLogPageHeaderData
 
struct  XLogLongPageHeaderData
 
struct  xl_parameter_change
 
struct  xl_restore_point
 
struct  xl_end_of_recovery
 
struct  XLogRecData
 
struct  RmgrData
 

Macros

#define XLOG_PAGE_MAGIC   0xD097 /* can be used as WAL version indicator */
 
#define SizeOfXLogShortPHD   MAXALIGN(sizeof(XLogPageHeaderData))
 
#define SizeOfXLogLongPHD   MAXALIGN(sizeof(XLogLongPageHeaderData))
 
#define XLP_FIRST_IS_CONTRECORD   0x0001
 
#define XLP_LONG_HEADER   0x0002
 
#define XLP_BKP_REMOVABLE   0x0004
 
#define XLP_ALL_FLAGS   0x0007
 
#define XLogPageHeaderSize(hdr)   (((hdr)->xlp_info & XLP_LONG_HEADER) ? SizeOfXLogLongPHD : SizeOfXLogShortPHD)
 
#define WalSegMinSize   1024 * 1024
 
#define WalSegMaxSize   1024 * 1024 * 1024
 
#define DEFAULT_MIN_WAL_SEGS   5
 
#define DEFAULT_MAX_WAL_SEGS   64
 
#define IsPowerOf2(x)   (x > 0 && ((x) & ((x)-1)) == 0)
 
#define IsValidWalSegSize(size)
 
#define XLogSegmentsPerXLogId(wal_segsz_bytes)   (UINT64CONST(0x100000000) / (wal_segsz_bytes))
 
#define XLogSegNoOffsetToRecPtr(segno, offset, dest, wal_segsz_bytes)   (dest) = (segno) * (wal_segsz_bytes) + (offset)
 
#define XLogSegmentOffset(xlogptr, wal_segsz_bytes)   ((xlogptr) & ((wal_segsz_bytes) - 1))
 
#define XLByteToSeg(xlrp, logSegNo, wal_segsz_bytes)   logSegNo = (xlrp) / (wal_segsz_bytes)
 
#define XLByteToPrevSeg(xlrp, logSegNo, wal_segsz_bytes)   logSegNo = ((xlrp) - 1) / (wal_segsz_bytes)
 
#define XLByteInSeg(xlrp, logSegNo, wal_segsz_bytes)   (((xlrp) / (wal_segsz_bytes)) == (logSegNo))
 
#define XLByteInPrevSeg(xlrp, logSegNo, wal_segsz_bytes)   ((((xlrp) - 1) / (wal_segsz_bytes)) == (logSegNo))
 
#define XRecOffIsValid(xlrp)   ((xlrp) % XLOG_BLCKSZ >= SizeOfXLogShortPHD)
 
#define XLOGDIR   "pg_wal"
 
#define XLOG_CONTROL_FILE   "global/pg_control"
 
#define MAXFNAMELEN   64
 
#define XLOG_FNAME_LEN   24
 
#define XLogFileName(fname, tli, logSegNo, wal_segsz_bytes)
 
#define XLogFileNameById(fname, tli, log, seg)   snprintf(fname, MAXFNAMELEN, "%08X%08X%08X", tli, log, seg)
 
#define IsXLogFileName(fname)
 
#define IsPartialXLogFileName(fname)
 
#define XLogFromFileName(fname, tli, logSegNo, wal_segsz_bytes)
 
#define XLogFilePath(path, tli, logSegNo, wal_segsz_bytes)
 
#define TLHistoryFileName(fname, tli)   snprintf(fname, MAXFNAMELEN, "%08X.history", tli)
 
#define IsTLHistoryFileName(fname)
 
#define TLHistoryFilePath(path, tli)   snprintf(path, MAXPGPATH, XLOGDIR "/%08X.history", tli)
 
#define StatusFilePath(path, xlog, suffix)   snprintf(path, MAXPGPATH, XLOGDIR "/archive_status/%s%s", xlog, suffix)
 
#define BackupHistoryFileName(fname, tli, logSegNo, startpoint, wal_segsz_bytes)
 
#define IsBackupHistoryFileName(fname)
 
#define BackupHistoryFilePath(path, tli, logSegNo, startpoint, wal_segsz_bytes)
 

Typedefs

typedef struct XLogPageHeaderData XLogPageHeaderData
 
typedef XLogPageHeaderDataXLogPageHeader
 
typedef struct XLogLongPageHeaderData XLogLongPageHeaderData
 
typedef XLogLongPageHeaderDataXLogLongPageHeader
 
typedef struct xl_parameter_change xl_parameter_change
 
typedef struct xl_restore_point xl_restore_point
 
typedef struct xl_end_of_recovery xl_end_of_recovery
 
typedef struct XLogRecData XLogRecData
 
typedef struct RmgrData RmgrData
 

Enumerations

enum  RecoveryTargetAction { RECOVERY_TARGET_ACTION_PAUSE, RECOVERY_TARGET_ACTION_PROMOTE, RECOVERY_TARGET_ACTION_SHUTDOWN }
 

Functions

pg_time_t GetLastSegSwitchData (XLogRecPtr *lastSwitchLSN)
 
XLogRecPtr RequestXLogSwitch (bool mark_unimportant)
 
void GetOldestRestartPoint (XLogRecPtr *oldrecptr, TimeLineID *oldtli)
 
bool RestoreArchivedFile (char *path, const char *xlogfname, const char *recovername, off_t expectedSize, bool cleanupEnabled)
 
void ExecuteRecoveryCommand (const char *command, const char *commandName, bool failOnerror)
 
void KeepFileRestoredFromArchive (const char *path, const char *xlogfname)
 
void XLogArchiveNotify (const char *xlog)
 
void XLogArchiveNotifySeg (XLogSegNo segno)
 
void XLogArchiveForceDone (const char *xlog)
 
bool XLogArchiveCheckDone (const char *xlog)
 
bool XLogArchiveIsBusy (const char *xlog)
 
bool XLogArchiveIsReady (const char *xlog)
 
bool XLogArchiveIsReadyOrDone (const char *xlog)
 
void XLogArchiveCleanup (const char *xlog)
 

Variables

const RmgrData RmgrTable []
 
bool ArchiveRecoveryRequested
 
bool InArchiveRecovery
 
bool StandbyMode
 
char * recoveryRestoreCommand
 

Macro Definition Documentation

◆ BackupHistoryFileName

#define BackupHistoryFileName (   fname,
  tli,
  logSegNo,
  startpoint,
  wal_segsz_bytes 
)
Value:
snprintf(fname, MAXFNAMELEN, "%08X%08X%08X.%08X.backup", tli, \
(uint32) ((logSegNo) / XLogSegmentsPerXLogId(wal_segsz_bytes)), \
(uint32) ((logSegNo) % XLogSegmentsPerXLogId(wal_segsz_bytes)), \
(uint32) (XLogSegmentOffset(startpoint, wal_segsz_bytes)))
#define XLogSegmentsPerXLogId(wal_segsz_bytes)
int snprintf(char *str, size_t count, const char *fmt,...) pg_attribute_printf(3
unsigned int uint32
Definition: c.h:296
#define MAXFNAMELEN
#define XLogSegmentOffset(xlogptr, wal_segsz_bytes)

Definition at line 204 of file xlog_internal.h.

Referenced by do_pg_stop_backup().

◆ BackupHistoryFilePath

#define BackupHistoryFilePath (   path,
  tli,
  logSegNo,
  startpoint,
  wal_segsz_bytes 
)
Value:
snprintf(path, MAXPGPATH, XLOGDIR "/%08X%08X%08X.%08X.backup", tli, \
(uint32) ((logSegNo) / XLogSegmentsPerXLogId(wal_segsz_bytes)), \
(uint32) ((logSegNo) % XLogSegmentsPerXLogId(wal_segsz_bytes)), \
(uint32) (XLogSegmentOffset((startpoint), wal_segsz_bytes)))
#define XLogSegmentsPerXLogId(wal_segsz_bytes)
int snprintf(char *str, size_t count, const char *fmt,...) pg_attribute_printf(3
#define MAXPGPATH
unsigned int uint32
Definition: c.h:296
#define XLOGDIR
#define XLogSegmentOffset(xlogptr, wal_segsz_bytes)

Definition at line 215 of file xlog_internal.h.

Referenced by do_pg_stop_backup().

◆ DEFAULT_MAX_WAL_SEGS

#define DEFAULT_MAX_WAL_SEGS   64

Definition at line 93 of file xlog_internal.h.

Referenced by setup_config().

◆ DEFAULT_MIN_WAL_SEGS

#define DEFAULT_MIN_WAL_SEGS   5

Definition at line 92 of file xlog_internal.h.

Referenced by setup_config().

◆ IsBackupHistoryFileName

#define IsBackupHistoryFileName (   fname)
Value:
(strlen(fname) > XLOG_FNAME_LEN && \
strspn(fname, "0123456789ABCDEF") == XLOG_FNAME_LEN && \
strcmp((fname) + strlen(fname) - strlen(".backup"), ".backup") == 0)
#define XLOG_FNAME_LEN

Definition at line 210 of file xlog_internal.h.

Referenced by CleanupBackupHistory(), CustomizableNextWALFileReady(), and SetWALFileNameForCleanup().

◆ IsPartialXLogFileName

#define IsPartialXLogFileName (   fname)
Value:
(strlen(fname) == XLOG_FNAME_LEN + strlen(".partial") && \
strspn(fname, "0123456789ABCDEF") == XLOG_FNAME_LEN && \
strcmp((fname) + XLOG_FNAME_LEN, ".partial") == 0)
#define XLOG_FNAME_LEN

Definition at line 172 of file xlog_internal.h.

Referenced by CleanupPriorWALFiles(), FindEndOfXLOG(), FindStreamingStart(), KillExistingXLOG(), RemoveOldXlogFiles(), and SetWALFileNameForCleanup().

◆ IsPowerOf2

#define IsPowerOf2 (   x)    (x > 0 && ((x) & ((x)-1)) == 0)

Definition at line 96 of file xlog_internal.h.

◆ IsTLHistoryFileName

#define IsTLHistoryFileName (   fname)
Value:
(strlen(fname) == 8 + strlen(".history") && \
strspn(fname, "0123456789ABCDEF") == 8 && \
strcmp((fname) + 8, ".history") == 0)

Definition at line 193 of file xlog_internal.h.

Referenced by main(), and perform_base_backup().

◆ IsValidWalSegSize

#define IsValidWalSegSize (   size)
Value:
(IsPowerOf2(size) && \
((size) >= WalSegMinSize && (size) <= WalSegMaxSize))
#define WalSegMinSize
Definition: xlog_internal.h:89
#define IsPowerOf2(x)
Definition: xlog_internal.h:96
#define WalSegMaxSize
Definition: xlog_internal.h:90

Definition at line 97 of file xlog_internal.h.

Referenced by AuxiliaryProcessMain(), digestControlFile(), main(), ReadControlFile(), RetrieveWalSegSize(), search_directory(), and SetWALSegSize().

◆ IsXLogFileName

◆ MAXFNAMELEN

◆ SizeOfXLogLongPHD

◆ SizeOfXLogShortPHD

◆ StatusFilePath

#define StatusFilePath (   path,
  xlog,
  suffix 
)    snprintf(path, MAXPGPATH, XLOGDIR "/archive_status/%s%s", xlog, suffix)

◆ TLHistoryFileName

◆ TLHistoryFilePath

#define TLHistoryFilePath (   path,
  tli 
)    snprintf(path, MAXPGPATH, XLOGDIR "/%08X.history", tli)

◆ WalSegMaxSize

#define WalSegMaxSize   1024 * 1024 * 1024

Definition at line 90 of file xlog_internal.h.

◆ WalSegMinSize

#define WalSegMinSize   1024 * 1024

Definition at line 89 of file xlog_internal.h.

◆ XLByteInPrevSeg

#define XLByteInPrevSeg (   xlrp,
  logSegNo,
  wal_segsz_bytes 
)    ((((xlrp) - 1) / (wal_segsz_bytes)) == (logSegNo))

Definition at line 133 of file xlog_internal.h.

Referenced by XLogBackgroundFlush(), and XLogWrite().

◆ XLByteInSeg

#define XLByteInSeg (   xlrp,
  logSegNo,
  wal_segsz_bytes 
)    (((xlrp) / (wal_segsz_bytes)) == (logSegNo))

◆ XLByteToPrevSeg

#define XLByteToPrevSeg (   xlrp,
  logSegNo,
  wal_segsz_bytes 
)    logSegNo = ((xlrp) - 1) / (wal_segsz_bytes)

◆ XLByteToSeg

◆ XLOG_CONTROL_FILE

#define XLOG_CONTROL_FILE   "global/pg_control"

◆ XLOG_FNAME_LEN

#define XLOG_FNAME_LEN   24

Definition at line 153 of file xlog_internal.h.

Referenced by KillExistingArchiveStatus(), and main().

◆ XLOG_PAGE_MAGIC

#define XLOG_PAGE_MAGIC   0xD097 /* can be used as WAL version indicator */

◆ XLOGDIR

◆ XLogFileName

#define XLogFileName (   fname,
  tli,
  logSegNo,
  wal_segsz_bytes 
)

◆ XLogFileNameById

#define XLogFileNameById (   fname,
  tli,
  log,
  seg 
)    snprintf(fname, MAXFNAMELEN, "%08X%08X%08X", tli, log, seg)

Definition at line 160 of file xlog_internal.h.

Referenced by SetWALFileNameForCleanup().

◆ XLogFilePath

#define XLogFilePath (   path,
  tli,
  logSegNo,
  wal_segsz_bytes 
)
Value:
snprintf(path, MAXPGPATH, XLOGDIR "/%08X%08X%08X", tli, \
(uint32) ((logSegNo) / XLogSegmentsPerXLogId(wal_segsz_bytes)), \
(uint32) ((logSegNo) % XLogSegmentsPerXLogId(wal_segsz_bytes)))
#define XLogSegmentsPerXLogId(wal_segsz_bytes)
int snprintf(char *str, size_t count, const char *fmt,...) pg_attribute_printf(3
#define MAXPGPATH
unsigned int uint32
Definition: c.h:296
#define XLOGDIR

Definition at line 185 of file xlog_internal.h.

Referenced by InstallXLogFileSegment(), StartupXLOG(), WriteEmptyXLOG(), XLogFileCopy(), XLogFileInit(), XLogFileOpen(), XLogFileRead(), XLogFileReadAnyTLI(), and XLogRead().

◆ XLogFromFileName

#define XLogFromFileName (   fname,
  tli,
  logSegNo,
  wal_segsz_bytes 
)
Value:
do { \
uint32 log; \
uint32 seg; \
sscanf(fname, "%08X%08X%08X", tli, &log, &seg); \
*logSegNo = (uint64) log * XLogSegmentsPerXLogId(wal_segsz_bytes) + seg; \
} while (0)
#define XLogSegmentsPerXLogId(wal_segsz_bytes)

Definition at line 177 of file xlog_internal.h.

Referenced by FindStreamingStart(), main(), perform_base_backup(), and UpdateLastRemovedPtr().

◆ XLogPageHeaderSize

#define XLogPageHeaderSize (   hdr)    (((hdr)->xlp_info & XLP_LONG_HEADER) ? SizeOfXLogLongPHD : SizeOfXLogShortPHD)

Definition at line 85 of file xlog_internal.h.

Referenced by ReadPageInternal(), ValidXLogPageHeader(), and XLogReadRecord().

◆ XLogSegmentOffset

◆ XLogSegmentsPerXLogId

#define XLogSegmentsPerXLogId (   wal_segsz_bytes)    (UINT64CONST(0x100000000) / (wal_segsz_bytes))

Definition at line 101 of file xlog_internal.h.

◆ XLogSegNoOffsetToRecPtr

#define XLogSegNoOffsetToRecPtr (   segno,
  offset,
  dest,
  wal_segsz_bytes 
)    (dest) = (segno) * (wal_segsz_bytes) + (offset)

◆ XLP_ALL_FLAGS

#define XLP_ALL_FLAGS   0x0007

Definition at line 83 of file xlog_internal.h.

Referenced by ValidXLogPageHeader().

◆ XLP_BKP_REMOVABLE

#define XLP_BKP_REMOVABLE   0x0004

Definition at line 81 of file xlog_internal.h.

Referenced by AdvanceXLInsertBuffer().

◆ XLP_FIRST_IS_CONTRECORD

#define XLP_FIRST_IS_CONTRECORD   0x0001

Definition at line 77 of file xlog_internal.h.

Referenced by CopyXLogRecordToWAL(), ValidXLogPageHeader(), and XLogReadRecord().

◆ XLP_LONG_HEADER

#define XLP_LONG_HEADER   0x0002

◆ XRecOffIsValid

#define XRecOffIsValid (   xlrp)    ((xlrp) % XLOG_BLCKSZ >= SizeOfXLogShortPHD)

Definition at line 137 of file xlog_internal.h.

Referenced by ReadCheckpointRecord(), StartupXLOG(), and XLogReadRecord().

Typedef Documentation

◆ RmgrData

◆ xl_end_of_recovery

◆ xl_parameter_change

◆ xl_restore_point

◆ XLogLongPageHeader

◆ XLogLongPageHeaderData

◆ XLogPageHeader

◆ XLogPageHeaderData

◆ XLogRecData

Enumeration Type Documentation

◆ RecoveryTargetAction

Enumerator
RECOVERY_TARGET_ACTION_PAUSE 
RECOVERY_TARGET_ACTION_PROMOTE 
RECOVERY_TARGET_ACTION_SHUTDOWN 

Definition at line 265 of file xlog_internal.h.

Function Documentation

◆ ExecuteRecoveryCommand()

void ExecuteRecoveryCommand ( const char *  command,
const char *  commandName,
bool  failOnerror 
)

Definition at line 330 of file xlogarchive.c.

References Assert, DEBUG3, ereport, errmsg(), errmsg_internal(), FATAL, GetOldestRestartPoint(), MAXPGPATH, signaled, StrNCpy, wait_result_to_str(), wal_segment_size, WARNING, WEXITSTATUS, WIFSIGNALED, XLByteToSeg, and XLogFileName.

Referenced by CreateRestartPoint(), and StartupXLOG().

331 {
332  char xlogRecoveryCmd[MAXPGPATH];
333  char lastRestartPointFname[MAXPGPATH];
334  char *dp;
335  char *endp;
336  const char *sp;
337  int rc;
338  bool signaled;
339  XLogSegNo restartSegNo;
340  XLogRecPtr restartRedoPtr;
341  TimeLineID restartTli;
342 
343  Assert(command && commandName);
344 
345  /*
346  * Calculate the archive file cutoff point for use during log shipping
347  * replication. All files earlier than this point can be deleted from the
348  * archive, though there is no requirement to do so.
349  */
350  GetOldestRestartPoint(&restartRedoPtr, &restartTli);
351  XLByteToSeg(restartRedoPtr, restartSegNo, wal_segment_size);
352  XLogFileName(lastRestartPointFname, restartTli, restartSegNo,
354 
355  /*
356  * construct the command to be executed
357  */
358  dp = xlogRecoveryCmd;
359  endp = xlogRecoveryCmd + MAXPGPATH - 1;
360  *endp = '\0';
361 
362  for (sp = command; *sp; sp++)
363  {
364  if (*sp == '%')
365  {
366  switch (sp[1])
367  {
368  case 'r':
369  /* %r: filename of last restartpoint */
370  sp++;
371  StrNCpy(dp, lastRestartPointFname, endp - dp);
372  dp += strlen(dp);
373  break;
374  case '%':
375  /* convert %% to a single % */
376  sp++;
377  if (dp < endp)
378  *dp++ = *sp;
379  break;
380  default:
381  /* otherwise treat the % as not special */
382  if (dp < endp)
383  *dp++ = *sp;
384  break;
385  }
386  }
387  else
388  {
389  if (dp < endp)
390  *dp++ = *sp;
391  }
392  }
393  *dp = '\0';
394 
395  ereport(DEBUG3,
396  (errmsg_internal("executing %s \"%s\"", commandName, command)));
397 
398  /*
399  * execute the constructed command
400  */
401  rc = system(xlogRecoveryCmd);
402  if (rc != 0)
403  {
404  /*
405  * If the failure was due to any sort of signal, it's best to punt and
406  * abort recovery. See also detailed comments on signals in
407  * RestoreArchivedFile().
408  */
409  signaled = WIFSIGNALED(rc) || WEXITSTATUS(rc) > 125;
410 
411  ereport((signaled && failOnSignal) ? FATAL : WARNING,
412  /*------
413  translator: First %s represents a recovery.conf parameter name like
414  "recovery_end_command", the 2nd is the value of that parameter, the
415  third an already translated error message. */
416  (errmsg("%s \"%s\": %s", commandName,
417  command, wait_result_to_str(rc))));
418  }
419 }
uint32 TimeLineID
Definition: xlogdefs.h:45
int wal_segment_size
Definition: xlog.c:113
#define DEBUG3
Definition: elog.h:23
void GetOldestRestartPoint(XLogRecPtr *oldrecptr, TimeLineID *oldtli)
Definition: xlog.c:11174
char * wait_result_to_str(int exitstatus)
Definition: wait_error.c:32
#define FATAL
Definition: elog.h:52
#define MAXPGPATH
uint64 XLogSegNo
Definition: xlogdefs.h:34
#define ereport(elevel, rest)
Definition: elog.h:122
#define WARNING
Definition: elog.h:40
int errmsg_internal(const char *fmt,...)
Definition: elog.c:827
uint64 XLogRecPtr
Definition: xlogdefs.h:21
#define Assert(condition)
Definition: c.h:670
#define StrNCpy(dst, src, len)
Definition: c.h:826
#define XLogFileName(fname, tli, logSegNo, wal_segsz_bytes)
int errmsg(const char *fmt,...)
Definition: elog.c:797
#define WIFSIGNALED(w)
Definition: win32_port.h:148
static volatile sig_atomic_t signaled
Definition: pg_standby.c:53
#define WEXITSTATUS(w)
Definition: win32_port.h:149
#define XLByteToSeg(xlrp, logSegNo, wal_segsz_bytes)

◆ GetLastSegSwitchData()

pg_time_t GetLastSegSwitchData ( XLogRecPtr lastSwitchLSN)

Definition at line 8301 of file xlog.c.

References XLogCtlData::lastSegSwitchLSN, XLogCtlData::lastSegSwitchTime, LW_SHARED, LWLockAcquire(), and LWLockRelease().

Referenced by CheckArchiveTimeout().

8302 {
8303  pg_time_t result;
8304 
8305  /* Need WALWriteLock, but shared lock is sufficient */
8306  LWLockAcquire(WALWriteLock, LW_SHARED);
8307  result = XLogCtl->lastSegSwitchTime;
8308  *lastSwitchLSN = XLogCtl->lastSegSwitchLSN;
8309  LWLockRelease(WALWriteLock);
8310 
8311  return result;
8312 }
int64 pg_time_t
Definition: pgtime.h:23
XLogRecPtr lastSegSwitchLSN
Definition: xlog.c:595
void LWLockRelease(LWLock *lock)
Definition: lwlock.c:1722
pg_time_t lastSegSwitchTime
Definition: xlog.c:594
static XLogCtlData * XLogCtl
Definition: xlog.c:707
bool LWLockAcquire(LWLock *lock, LWLockMode mode)
Definition: lwlock.c:1118

◆ GetOldestRestartPoint()

void GetOldestRestartPoint ( XLogRecPtr oldrecptr,
TimeLineID oldtli 
)

Definition at line 11174 of file xlog.c.

References ControlFileData::checkPointCopy, LW_SHARED, LWLockAcquire(), LWLockRelease(), CheckPoint::redo, and CheckPoint::ThisTimeLineID.

Referenced by ExecuteRecoveryCommand(), and RestoreArchivedFile().

11175 {
11176  LWLockAcquire(ControlFileLock, LW_SHARED);
11177  *oldrecptr = ControlFile->checkPointCopy.redo;
11179  LWLockRelease(ControlFileLock);
11180 }
CheckPoint checkPointCopy
Definition: pg_control.h:131
void LWLockRelease(LWLock *lock)
Definition: lwlock.c:1722
static ControlFileData * ControlFile
Definition: xlog.c:715
bool LWLockAcquire(LWLock *lock, LWLockMode mode)
Definition: lwlock.c:1118
TimeLineID ThisTimeLineID
Definition: pg_control.h:38
XLogRecPtr redo
Definition: pg_control.h:36

◆ KeepFileRestoredFromArchive()

void KeepFileRestoredFromArchive ( const char *  path,
const char *  xlogfname 
)

Definition at line 428 of file xlogarchive.c.

References ARCHIVE_MODE_ALWAYS, durable_rename(), ereport, errcode_for_file_access(), errmsg(), ERROR, FATAL, MAXPGPATH, snprintf(), stat, strlcpy(), WalSndRqstFileReload(), WalSndWakeup(), XLogArchiveForceDone(), XLogArchiveMode, XLogArchiveNotify(), XLOGDIR, and xlogfpath.

Referenced by readTimeLineHistory(), restoreTimeLineHistoryFiles(), and XLogFileRead().

429 {
430  char xlogfpath[MAXPGPATH];
431  bool reload = false;
432  struct stat statbuf;
433 
434  snprintf(xlogfpath, MAXPGPATH, XLOGDIR "/%s", xlogfname);
435 
436  if (stat(xlogfpath, &statbuf) == 0)
437  {
438  char oldpath[MAXPGPATH];
439 
440 #ifdef WIN32
441  static unsigned int deletedcounter = 1;
442 
443  /*
444  * On Windows, if another process (e.g a walsender process) holds the
445  * file open in FILE_SHARE_DELETE mode, unlink will succeed, but the
446  * file will still show up in directory listing until the last handle
447  * is closed, and we cannot rename the new file in its place until
448  * that. To avoid that problem, rename the old file to a temporary
449  * name first. Use a counter to create a unique filename, because the
450  * same file might be restored from the archive multiple times, and a
451  * walsender could still be holding onto an old deleted version of it.
452  */
453  snprintf(oldpath, MAXPGPATH, "%s.deleted%u",
454  xlogfpath, deletedcounter++);
455  if (rename(xlogfpath, oldpath) != 0)
456  {
457  ereport(ERROR,
459  errmsg("could not rename file \"%s\" to \"%s\": %m",
460  xlogfpath, oldpath)));
461  }
462 #else
463  /* same-size buffers, so this never truncates */
464  strlcpy(oldpath, xlogfpath, MAXPGPATH);
465 #endif
466  if (unlink(oldpath) != 0)
467  ereport(FATAL,
469  errmsg("could not remove file \"%s\": %m",
470  xlogfpath)));
471  reload = true;
472  }
473 
474  durable_rename(path, xlogfpath, ERROR);
475 
476  /*
477  * Create .done file forcibly to prevent the restored segment from being
478  * archived again later.
479  */
481  XLogArchiveForceDone(xlogfname);
482  else
483  XLogArchiveNotify(xlogfname);
484 
485  /*
486  * If the existing file was replaced, since walsenders might have it open,
487  * request them to reload a currently-open segment. This is only required
488  * for WAL segments, walsenders don't hold other files open, but there's
489  * no harm in doing this too often, and we don't know what kind of a file
490  * we're dealing with here.
491  */
492  if (reload)
494 
495  /*
496  * Signal walsender that new WAL has arrived. Again, this isn't necessary
497  * if we restored something other than a WAL segment, but it does no harm
498  * either.
499  */
500  WalSndWakeup();
501 }
int snprintf(char *str, size_t count, const char *fmt,...) pg_attribute_printf(3
void XLogArchiveNotify(const char *xlog)
Definition: xlogarchive.c:514
void WalSndRqstFileReload(void)
Definition: walsender.c:2879
#define ERROR
Definition: elog.h:43
#define FATAL
Definition: elog.h:52
#define MAXPGPATH
int XLogArchiveMode
Definition: xlog.c:94
int errcode_for_file_access(void)
Definition: elog.c:598
#define ereport(elevel, rest)
Definition: elog.h:122
int durable_rename(const char *oldfile, const char *newfile, int elevel)
Definition: fd.c:607
#define stat(a, b)
Definition: win32_port.h:266
void XLogArchiveForceDone(const char *xlog)
Definition: xlogarchive.c:564
#define XLOGDIR
static char xlogfpath[MAXPGPATH]
Definition: parsexlog.c:43
size_t strlcpy(char *dst, const char *src, size_t siz)
Definition: strlcpy.c:45
int errmsg(const char *fmt,...)
Definition: elog.c:797
void WalSndWakeup(void)
Definition: walsender.c:3004

◆ RequestXLogSwitch()

XLogRecPtr RequestXLogSwitch ( bool  mark_unimportant)

Definition at line 9436 of file xlog.c.

References XLOG_MARK_UNIMPORTANT, XLOG_SWITCH, XLogBeginInsert(), XLogInsert(), and XLogSetRecordFlags().

Referenced by CheckArchiveTimeout(), do_pg_start_backup(), do_pg_stop_backup(), pg_switch_wal(), and ShutdownXLOG().

9437 {
9438  XLogRecPtr RecPtr;
9439 
9440  /* XLOG SWITCH has no data */
9441  XLogBeginInsert();
9442 
9443  if (mark_unimportant)
9445  RecPtr = XLogInsert(RM_XLOG_ID, XLOG_SWITCH);
9446 
9447  return RecPtr;
9448 }
void XLogSetRecordFlags(uint8 flags)
Definition: xloginsert.c:397
XLogRecPtr XLogInsert(RmgrId rmid, uint8 info)
Definition: xloginsert.c:415
uint64 XLogRecPtr
Definition: xlogdefs.h:21
#define XLOG_MARK_UNIMPORTANT
Definition: xlog.h:193
#define XLOG_SWITCH
Definition: pg_control.h:71
void XLogBeginInsert(void)
Definition: xloginsert.c:120

◆ RestoreArchivedFile()

bool RestoreArchivedFile ( char *  path,
const char *  xlogfname,
const char *  recovername,
off_t  expectedSize,
bool  cleanupEnabled 
)

Definition at line 51 of file xlogarchive.c.

References Assert, DEBUG1, DEBUG2, DEBUG3, elevel, ereport, errcode_for_file_access(), errmsg(), errmsg_internal(), FATAL, GetOldestRestartPoint(), LOG, make_native_path(), MAXPGPATH, PostRestoreCommand(), PreRestoreCommand(), proc_exit(), recoveryRestoreCommand, signaled, snprintf(), StandbyMode, stat, StrNCpy, wait_result_to_str(), wal_segment_size, WEXITSTATUS, WIFSIGNALED, WTERMSIG, XLByteToSeg, XLOGDIR, and XLogFileName.

Referenced by existsTimeLineHistory(), readTimeLineHistory(), restoreTimeLineHistoryFiles(), writeTimeLineHistory(), and XLogFileRead().

54 {
55  char xlogpath[MAXPGPATH];
56  char xlogRestoreCmd[MAXPGPATH];
57  char lastRestartPointFname[MAXPGPATH];
58  char *dp;
59  char *endp;
60  const char *sp;
61  int rc;
62  bool signaled;
63  struct stat stat_buf;
64  XLogSegNo restartSegNo;
65  XLogRecPtr restartRedoPtr;
66  TimeLineID restartTli;
67 
68  /* In standby mode, restore_command might not be supplied */
69  if (recoveryRestoreCommand == NULL)
70  goto not_available;
71 
72  /*
73  * When doing archive recovery, we always prefer an archived log file even
74  * if a file of the same name exists in XLOGDIR. The reason is that the
75  * file in XLOGDIR could be an old, un-filled or partly-filled version
76  * that was copied and restored as part of backing up $PGDATA.
77  *
78  * We could try to optimize this slightly by checking the local copy
79  * lastchange timestamp against the archived copy, but we have no API to
80  * do this, nor can we guarantee that the lastchange timestamp was
81  * preserved correctly when we copied to archive. Our aim is robustness,
82  * so we elect not to do this.
83  *
84  * If we cannot obtain the log file from the archive, however, we will try
85  * to use the XLOGDIR file if it exists. This is so that we can make use
86  * of log segments that weren't yet transferred to the archive.
87  *
88  * Notice that we don't actually overwrite any files when we copy back
89  * from archive because the restore_command may inadvertently restore
90  * inappropriate xlogs, or they may be corrupt, so we may wish to fallback
91  * to the segments remaining in current XLOGDIR later. The
92  * copy-from-archive filename is always the same, ensuring that we don't
93  * run out of disk space on long recoveries.
94  */
95  snprintf(xlogpath, MAXPGPATH, XLOGDIR "/%s", recovername);
96 
97  /*
98  * Make sure there is no existing file named recovername.
99  */
100  if (stat(xlogpath, &stat_buf) != 0)
101  {
102  if (errno != ENOENT)
103  ereport(FATAL,
105  errmsg("could not stat file \"%s\": %m",
106  xlogpath)));
107  }
108  else
109  {
110  if (unlink(xlogpath) != 0)
111  ereport(FATAL,
113  errmsg("could not remove file \"%s\": %m",
114  xlogpath)));
115  }
116 
117  /*
118  * Calculate the archive file cutoff point for use during log shipping
119  * replication. All files earlier than this point can be deleted from the
120  * archive, though there is no requirement to do so.
121  *
122  * If cleanup is not enabled, initialise this with the filename of
123  * InvalidXLogRecPtr, which will prevent the deletion of any WAL files
124  * from the archive because of the alphabetic sorting property of WAL
125  * filenames.
126  *
127  * Once we have successfully located the redo pointer of the checkpoint
128  * from which we start recovery we never request a file prior to the redo
129  * pointer of the last restartpoint. When redo begins we know that we have
130  * successfully located it, so there is no need for additional status
131  * flags to signify the point when we can begin deleting WAL files from
132  * the archive.
133  */
134  if (cleanupEnabled)
135  {
136  GetOldestRestartPoint(&restartRedoPtr, &restartTli);
137  XLByteToSeg(restartRedoPtr, restartSegNo, wal_segment_size);
138  XLogFileName(lastRestartPointFname, restartTli, restartSegNo,
140  /* we shouldn't need anything earlier than last restart point */
141  Assert(strcmp(lastRestartPointFname, xlogfname) <= 0);
142  }
143  else
144  XLogFileName(lastRestartPointFname, 0, 0L, wal_segment_size);
145 
146  /*
147  * construct the command to be executed
148  */
149  dp = xlogRestoreCmd;
150  endp = xlogRestoreCmd + MAXPGPATH - 1;
151  *endp = '\0';
152 
153  for (sp = recoveryRestoreCommand; *sp; sp++)
154  {
155  if (*sp == '%')
156  {
157  switch (sp[1])
158  {
159  case 'p':
160  /* %p: relative path of target file */
161  sp++;
162  StrNCpy(dp, xlogpath, endp - dp);
163  make_native_path(dp);
164  dp += strlen(dp);
165  break;
166  case 'f':
167  /* %f: filename of desired file */
168  sp++;
169  StrNCpy(dp, xlogfname, endp - dp);
170  dp += strlen(dp);
171  break;
172  case 'r':
173  /* %r: filename of last restartpoint */
174  sp++;
175  StrNCpy(dp, lastRestartPointFname, endp - dp);
176  dp += strlen(dp);
177  break;
178  case '%':
179  /* convert %% to a single % */
180  sp++;
181  if (dp < endp)
182  *dp++ = *sp;
183  break;
184  default:
185  /* otherwise treat the % as not special */
186  if (dp < endp)
187  *dp++ = *sp;
188  break;
189  }
190  }
191  else
192  {
193  if (dp < endp)
194  *dp++ = *sp;
195  }
196  }
197  *dp = '\0';
198 
199  ereport(DEBUG3,
200  (errmsg_internal("executing restore command \"%s\"",
201  xlogRestoreCmd)));
202 
203  /*
204  * Check signals before restore command and reset afterwards.
205  */
207 
208  /*
209  * Copy xlog from archival storage to XLOGDIR
210  */
211  rc = system(xlogRestoreCmd);
212 
214 
215  if (rc == 0)
216  {
217  /*
218  * command apparently succeeded, but let's make sure the file is
219  * really there now and has the correct size.
220  */
221  if (stat(xlogpath, &stat_buf) == 0)
222  {
223  if (expectedSize > 0 && stat_buf.st_size != expectedSize)
224  {
225  int elevel;
226 
227  /*
228  * If we find a partial file in standby mode, we assume it's
229  * because it's just being copied to the archive, and keep
230  * trying.
231  *
232  * Otherwise treat a wrong-sized file as FATAL to ensure the
233  * DBA would notice it, but is that too strong? We could try
234  * to plow ahead with a local copy of the file ... but the
235  * problem is that there probably isn't one, and we'd
236  * incorrectly conclude we've reached the end of WAL and we're
237  * done recovering ...
238  */
239  if (StandbyMode && stat_buf.st_size < expectedSize)
240  elevel = DEBUG1;
241  else
242  elevel = FATAL;
243  ereport(elevel,
244  (errmsg("archive file \"%s\" has wrong size: %lu instead of %lu",
245  xlogfname,
246  (unsigned long) stat_buf.st_size,
247  (unsigned long) expectedSize)));
248  return false;
249  }
250  else
251  {
252  ereport(LOG,
253  (errmsg("restored log file \"%s\" from archive",
254  xlogfname)));
255  strcpy(path, xlogpath);
256  return true;
257  }
258  }
259  else
260  {
261  /* stat failed */
262  if (errno != ENOENT)
263  ereport(FATAL,
265  errmsg("could not stat file \"%s\": %m",
266  xlogpath)));
267  }
268  }
269 
270  /*
271  * Remember, we rollforward UNTIL the restore fails so failure here is
272  * just part of the process... that makes it difficult to determine
273  * whether the restore failed because there isn't an archive to restore,
274  * or because the administrator has specified the restore program
275  * incorrectly. We have to assume the former.
276  *
277  * However, if the failure was due to any sort of signal, it's best to
278  * punt and abort recovery. (If we "return false" here, upper levels will
279  * assume that recovery is complete and start up the database!) It's
280  * essential to abort on child SIGINT and SIGQUIT, because per spec
281  * system() ignores SIGINT and SIGQUIT while waiting; if we see one of
282  * those it's a good bet we should have gotten it too.
283  *
284  * On SIGTERM, assume we have received a fast shutdown request, and exit
285  * cleanly. It's pure chance whether we receive the SIGTERM first, or the
286  * child process. If we receive it first, the signal handler will call
287  * proc_exit, otherwise we do it here. If we or the child process received
288  * SIGTERM for any other reason than a fast shutdown request, postmaster
289  * will perform an immediate shutdown when it sees us exiting
290  * unexpectedly.
291  *
292  * Per the Single Unix Spec, shells report exit status > 128 when a called
293  * command died on a signal. Also, 126 and 127 are used to report
294  * problems such as an unfindable command; treat those as fatal errors
295  * too.
296  */
297  if (WIFSIGNALED(rc) && WTERMSIG(rc) == SIGTERM)
298  proc_exit(1);
299 
300  signaled = WIFSIGNALED(rc) || WEXITSTATUS(rc) > 125;
301 
302  ereport(signaled ? FATAL : DEBUG2,
303  (errmsg("could not restore file \"%s\" from archive: %s",
304  xlogfname, wait_result_to_str(rc))));
305 
306 not_available:
307 
308  /*
309  * if an archived file is not available, there might still be a version of
310  * this file in XLOGDIR, so return that as the filename to open.
311  *
312  * In many recovery scenarios we expect this to fail also, but if so that
313  * just means we've reached the end of WAL.
314  */
315  snprintf(path, MAXPGPATH, XLOGDIR "/%s", xlogfname);
316  return false;
317 }
bool StandbyMode
Definition: xlog.c:279
#define DEBUG1
Definition: elog.h:25
uint32 TimeLineID
Definition: xlogdefs.h:45
#define WTERMSIG(w)
Definition: win32_port.h:150
int wal_segment_size
Definition: xlog.c:113
#define DEBUG3
Definition: elog.h:23
void make_native_path(char *path)
Definition: path.c:166
void GetOldestRestartPoint(XLogRecPtr *oldrecptr, TimeLineID *oldtli)
Definition: xlog.c:11174
void proc_exit(int code)
Definition: ipc.c:99
int snprintf(char *str, size_t count, const char *fmt,...) pg_attribute_printf(3
#define LOG
Definition: elog.h:26
char * wait_result_to_str(int exitstatus)
Definition: wait_error.c:32
void PostRestoreCommand(void)
Definition: startup.c:241
struct stat stat_buf
Definition: pg_standby.c:103
#define FATAL
Definition: elog.h:52
#define MAXPGPATH
char * recoveryRestoreCommand
Definition: xlog.c:259
#define DEBUG2
Definition: elog.h:24
uint64 XLogSegNo
Definition: xlogdefs.h:34
int errcode_for_file_access(void)
Definition: elog.c:598
#define ereport(elevel, rest)
Definition: elog.h:122
#define stat(a, b)
Definition: win32_port.h:266
static int elevel
Definition: vacuumlazy.c:136
#define XLOGDIR
int errmsg_internal(const char *fmt,...)
Definition: elog.c:827
uint64 XLogRecPtr
Definition: xlogdefs.h:21
#define Assert(condition)
Definition: c.h:670
#define StrNCpy(dst, src, len)
Definition: c.h:826
#define XLogFileName(fname, tli, logSegNo, wal_segsz_bytes)
void PreRestoreCommand(void)
Definition: startup.c:227
int errmsg(const char *fmt,...)
Definition: elog.c:797
#define WIFSIGNALED(w)
Definition: win32_port.h:148
static volatile sig_atomic_t signaled
Definition: pg_standby.c:53
#define WEXITSTATUS(w)
Definition: win32_port.h:149
#define XLByteToSeg(xlrp, logSegNo, wal_segsz_bytes)

◆ XLogArchiveCheckDone()

bool XLogArchiveCheckDone ( const char *  xlog)

Definition at line 619 of file xlogarchive.c.

References MAXPGPATH, stat, StatusFilePath, XLogArchiveNotify(), and XLogArchivingActive.

Referenced by CleanupBackupHistory(), and RemoveOldXlogFiles().

620 {
621  char archiveStatusPath[MAXPGPATH];
622  struct stat stat_buf;
623 
624  /* Always deletable if archiving is off */
625  if (!XLogArchivingActive())
626  return true;
627 
628  /* First check for .done --- this means archiver is done with it */
629  StatusFilePath(archiveStatusPath, xlog, ".done");
630  if (stat(archiveStatusPath, &stat_buf) == 0)
631  return true;
632 
633  /* check for .ready --- this means archiver is still busy with it */
634  StatusFilePath(archiveStatusPath, xlog, ".ready");
635  if (stat(archiveStatusPath, &stat_buf) == 0)
636  return false;
637 
638  /* Race condition --- maybe archiver just finished, so recheck */
639  StatusFilePath(archiveStatusPath, xlog, ".done");
640  if (stat(archiveStatusPath, &stat_buf) == 0)
641  return true;
642 
643  /* Retry creation of the .ready file */
644  XLogArchiveNotify(xlog);
645  return false;
646 }
#define StatusFilePath(path, xlog, suffix)
void XLogArchiveNotify(const char *xlog)
Definition: xlogarchive.c:514
struct stat stat_buf
Definition: pg_standby.c:103
#define MAXPGPATH
#define stat(a, b)
Definition: win32_port.h:266
#define XLogArchivingActive()
Definition: xlog.h:135

◆ XLogArchiveCleanup()

void XLogArchiveCleanup ( const char *  xlog)

Definition at line 752 of file xlogarchive.c.

References MAXPGPATH, and StatusFilePath.

Referenced by CleanupBackupHistory(), exitArchiveRecovery(), RemoveXlogFile(), and StartupXLOG().

753 {
754  char archiveStatusPath[MAXPGPATH];
755 
756  /* Remove the .done file */
757  StatusFilePath(archiveStatusPath, xlog, ".done");
758  unlink(archiveStatusPath);
759  /* should we complain about failure? */
760 
761  /* Remove the .ready file if present --- normally it shouldn't be */
762  StatusFilePath(archiveStatusPath, xlog, ".ready");
763  unlink(archiveStatusPath);
764  /* should we complain about failure? */
765 }
#define StatusFilePath(path, xlog, suffix)
#define MAXPGPATH

◆ XLogArchiveForceDone()

void XLogArchiveForceDone ( const char *  xlog)

Definition at line 564 of file xlogarchive.c.

References AllocateFile(), durable_rename(), ereport, errcode_for_file_access(), errmsg(), fd(), FreeFile(), LOG, MAXPGPATH, stat, StatusFilePath, and WARNING.

Referenced by KeepFileRestoredFromArchive(), WalReceiverMain(), and XLogWalRcvWrite().

565 {
566  char archiveReady[MAXPGPATH];
567  char archiveDone[MAXPGPATH];
568  struct stat stat_buf;
569  FILE *fd;
570 
571  /* Exit if already known done */
572  StatusFilePath(archiveDone, xlog, ".done");
573  if (stat(archiveDone, &stat_buf) == 0)
574  return;
575 
576  /* If .ready exists, rename it to .done */
577  StatusFilePath(archiveReady, xlog, ".ready");
578  if (stat(archiveReady, &stat_buf) == 0)
579  {
580  (void) durable_rename(archiveReady, archiveDone, WARNING);
581  return;
582  }
583 
584  /* insert an otherwise empty file called <XLOG>.done */
585  fd = AllocateFile(archiveDone, "w");
586  if (fd == NULL)
587  {
588  ereport(LOG,
590  errmsg("could not create archive status file \"%s\": %m",
591  archiveDone)));
592  return;
593  }
594  if (FreeFile(fd))
595  {
596  ereport(LOG,
598  errmsg("could not write archive status file \"%s\": %m",
599  archiveDone)));
600  return;
601  }
602 }
#define StatusFilePath(path, xlog, suffix)
#define LOG
Definition: elog.h:26
static int fd(const char *x, int i)
Definition: preproc-init.c:105
struct stat stat_buf
Definition: pg_standby.c:103
#define MAXPGPATH
int errcode_for_file_access(void)
Definition: elog.c:598
FILE * AllocateFile(const char *name, const char *mode)
Definition: fd.c:2342
#define ereport(elevel, rest)
Definition: elog.h:122
int durable_rename(const char *oldfile, const char *newfile, int elevel)
Definition: fd.c:607
#define WARNING
Definition: elog.h:40
#define stat(a, b)
Definition: win32_port.h:266
int FreeFile(FILE *file)
Definition: fd.c:2534
int errmsg(const char *fmt,...)
Definition: elog.c:797

◆ XLogArchiveIsBusy()

bool XLogArchiveIsBusy ( const char *  xlog)

Definition at line 659 of file xlogarchive.c.

References MAXPGPATH, snprintf(), stat, StatusFilePath, and XLOGDIR.

Referenced by do_pg_stop_backup().

660 {
661  char archiveStatusPath[MAXPGPATH];
662  struct stat stat_buf;
663 
664  /* First check for .done --- this means archiver is done with it */
665  StatusFilePath(archiveStatusPath, xlog, ".done");
666  if (stat(archiveStatusPath, &stat_buf) == 0)
667  return false;
668 
669  /* check for .ready --- this means archiver is still busy with it */
670  StatusFilePath(archiveStatusPath, xlog, ".ready");
671  if (stat(archiveStatusPath, &stat_buf) == 0)
672  return true;
673 
674  /* Race condition --- maybe archiver just finished, so recheck */
675  StatusFilePath(archiveStatusPath, xlog, ".done");
676  if (stat(archiveStatusPath, &stat_buf) == 0)
677  return false;
678 
679  /*
680  * Check to see if the WAL file has been removed by checkpoint, which
681  * implies it has already been archived, and explains why we can't see a
682  * status file for it.
683  */
684  snprintf(archiveStatusPath, MAXPGPATH, XLOGDIR "/%s", xlog);
685  if (stat(archiveStatusPath, &stat_buf) != 0 &&
686  errno == ENOENT)
687  return false;
688 
689  return true;
690 }
#define StatusFilePath(path, xlog, suffix)
int snprintf(char *str, size_t count, const char *fmt,...) pg_attribute_printf(3
struct stat stat_buf
Definition: pg_standby.c:103
#define MAXPGPATH
#define stat(a, b)
Definition: win32_port.h:266
#define XLOGDIR

◆ XLogArchiveIsReady()

bool XLogArchiveIsReady ( const char *  xlog)

Definition at line 734 of file xlogarchive.c.

References MAXPGPATH, stat, and StatusFilePath.

Referenced by RemoveNonParentXlogFiles().

735 {
736  char archiveStatusPath[MAXPGPATH];
737  struct stat stat_buf;
738 
739  StatusFilePath(archiveStatusPath, xlog, ".ready");
740  if (stat(archiveStatusPath, &stat_buf) == 0)
741  return true;
742 
743  return false;
744 }
#define StatusFilePath(path, xlog, suffix)
struct stat stat_buf
Definition: pg_standby.c:103
#define MAXPGPATH
#define stat(a, b)
Definition: win32_port.h:266

◆ XLogArchiveIsReadyOrDone()

bool XLogArchiveIsReadyOrDone ( const char *  xlog)

Definition at line 704 of file xlogarchive.c.

References MAXPGPATH, stat, and StatusFilePath.

Referenced by StartupXLOG().

705 {
706  char archiveStatusPath[MAXPGPATH];
707  struct stat stat_buf;
708 
709  /* First check for .done --- this means archiver is done with it */
710  StatusFilePath(archiveStatusPath, xlog, ".done");
711  if (stat(archiveStatusPath, &stat_buf) == 0)
712  return true;
713 
714  /* check for .ready --- this means archiver is still busy with it */
715  StatusFilePath(archiveStatusPath, xlog, ".ready");
716  if (stat(archiveStatusPath, &stat_buf) == 0)
717  return true;
718 
719  /* Race condition --- maybe archiver just finished, so recheck */
720  StatusFilePath(archiveStatusPath, xlog, ".done");
721  if (stat(archiveStatusPath, &stat_buf) == 0)
722  return true;
723 
724  return false;
725 }
#define StatusFilePath(path, xlog, suffix)
struct stat stat_buf
Definition: pg_standby.c:103
#define MAXPGPATH
#define stat(a, b)
Definition: win32_port.h:266

◆ XLogArchiveNotify()

void XLogArchiveNotify ( const char *  xlog)

Definition at line 514 of file xlogarchive.c.

References AllocateFile(), ereport, errcode_for_file_access(), errmsg(), fd(), FreeFile(), IsUnderPostmaster, LOG, MAXPGPATH, PMSIGNAL_WAKEN_ARCHIVER, SendPostmasterSignal(), and StatusFilePath.

Referenced by KeepFileRestoredFromArchive(), StartupXLOG(), WalReceiverMain(), writeTimeLineHistory(), XLogArchiveCheckDone(), XLogArchiveNotifySeg(), and XLogWalRcvWrite().

515 {
516  char archiveStatusPath[MAXPGPATH];
517  FILE *fd;
518 
519  /* insert an otherwise empty file called <XLOG>.ready */
520  StatusFilePath(archiveStatusPath, xlog, ".ready");
521  fd = AllocateFile(archiveStatusPath, "w");
522  if (fd == NULL)
523  {
524  ereport(LOG,
526  errmsg("could not create archive status file \"%s\": %m",
527  archiveStatusPath)));
528  return;
529  }
530  if (FreeFile(fd))
531  {
532  ereport(LOG,
534  errmsg("could not write archive status file \"%s\": %m",
535  archiveStatusPath)));
536  return;
537  }
538 
539  /* Notify archiver that it's got something to do */
540  if (IsUnderPostmaster)
542 }
#define StatusFilePath(path, xlog, suffix)
#define LOG
Definition: elog.h:26
static int fd(const char *x, int i)
Definition: preproc-init.c:105
#define MAXPGPATH
bool IsUnderPostmaster
Definition: globals.c:101
int errcode_for_file_access(void)
Definition: elog.c:598
FILE * AllocateFile(const char *name, const char *mode)
Definition: fd.c:2342
#define ereport(elevel, rest)
Definition: elog.h:122
int FreeFile(FILE *file)
Definition: fd.c:2534
int errmsg(const char *fmt,...)
Definition: elog.c:797
void SendPostmasterSignal(PMSignalReason reason)
Definition: pmsignal.c:113

◆ XLogArchiveNotifySeg()

void XLogArchiveNotifySeg ( XLogSegNo  segno)

Definition at line 548 of file xlogarchive.c.

References MAXFNAMELEN, ThisTimeLineID, wal_segment_size, XLogArchiveNotify(), and XLogFileName.

Referenced by XLogWrite().

549 {
550  char xlog[MAXFNAMELEN];
551 
553  XLogArchiveNotify(xlog);
554 }
int wal_segment_size
Definition: xlog.c:113
void XLogArchiveNotify(const char *xlog)
Definition: xlogarchive.c:514
#define MAXFNAMELEN
TimeLineID ThisTimeLineID
Definition: xlog.c:181
#define XLogFileName(fname, tli, logSegNo, wal_segsz_bytes)

Variable Documentation

◆ ArchiveRecoveryRequested

◆ InArchiveRecovery

bool InArchiveRecovery

Definition at line 249 of file xlog.c.

Referenced by exitArchiveRecovery(), ReadRecord(), StartupXLOG(), and WaitForWALToBecomeAvailable().

◆ recoveryRestoreCommand

char* recoveryRestoreCommand

Definition at line 259 of file xlog.c.

Referenced by readRecoveryCommandFile(), and RestoreArchivedFile().

◆ RmgrTable

const RmgrData RmgrTable[]

◆ StandbyMode

bool StandbyMode