archive.c

Go to the documentation of this file.

/*-------------------------------------------------------------------------
 *
 * archive.c
 *    Common WAL archive routines
 *
 * Portions Copyright (c) 1996-2025, PostgreSQL Global Development Group
 * Portions Copyright (c) 1994, Regents of the University of California
 *
 *
 * IDENTIFICATION
 *    src/common/archive.c
 *
 *-------------------------------------------------------------------------
 */
 
#ifndef FRONTEND
#include "postgres.h"
#else
#include "postgres_fe.h"
#endif
 
#include "common/archive.h"
#include "common/percentrepl.h"
 
/*
 * BuildRestoreCommand
 *
 * Builds a restore command to retrieve a file from WAL archives, replacing
 * the supported aliases with values supplied by the caller as defined by
 * the GUC parameter restore_command: xlogpath for %p, xlogfname for %f and
 * lastRestartPointFname for %r.
 *
 * The result is a palloc'd string for the restore command built.  The
 * caller is responsible for freeing it.  If any of the required arguments
 * is NULL and that the corresponding alias is found in the command given
 * by the caller, then an error is thrown.
 */
char *
BuildRestoreCommand(const char *restoreCommand,
                    const char *xlogpath,
                    const char *xlogfname,
                    const char *lastRestartPointFname)
{
    char       *nativePath = NULL;
    char       *result;
 
    if (xlogpath)
    {
        nativePath = pstrdup(xlogpath);
        make_native_path(nativePath);
    }
 
    result = replace_percent_placeholders(restoreCommand, "restore_command", "frp",
                                          xlogfname, lastRestartPointFname, nativePath);
 
    if (nativePath)
        pfree(nativePath);
 
    return result;
}