recovery_gen.h File Reference

#include "libpq-fe.h"
#include "pqexpbuffer.h"

Include dependency graph for recovery_gen.h:

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

Go to the source code of this file.

Macros
#define	MINIMUM_VERSION_FOR_RECOVERY_GUC   120000

Functions
PQExpBuffer	GenerateRecoveryConfig (PGconn *pgconn, const char *replication_slot, char *dbname)
void	WriteRecoveryConfig (PGconn *pgconn, const char *target_dir, PQExpBuffer contents)

Macro Definition Documentation

MINIMUM_VERSION_FOR_RECOVERY_GUC

#define MINIMUM_VERSION_FOR_RECOVERY_GUC   120000

Definition at line 21 of file recovery_gen.h.

Function Documentation

GenerateRecoveryConfig()

PQExpBuffer GenerateRecoveryConfig	(	PGconn *	pgconn,
		const char *	replication_slot,
		char *	dbname
	)

Definition at line 27 of file recovery_gen.c.

{
    PQconninfoOption *connOptions;
    PQExpBufferData conninfo_buf;
    char       *escaped;
    PQExpBuffer contents;
 
    Assert(pgconn != NULL);
 
    contents = createPQExpBuffer();
    if (!contents)
        pg_fatal("out of memory");
 
    /*
     * In PostgreSQL 12 and newer versions, standby_mode is gone, replaced by
     * standby.signal to trigger a standby state at recovery.
     */
    if (PQserverVersion(pgconn) < MINIMUM_VERSION_FOR_RECOVERY_GUC)
        appendPQExpBufferStr(contents, "standby_mode = 'on'\n");
 
    connOptions = PQconninfo(pgconn);
    if (connOptions == NULL)
        pg_fatal("out of memory");
 
    initPQExpBuffer(&conninfo_buf);
    for (PQconninfoOption *opt = connOptions; opt && opt->keyword; opt++)
    {
        /* Omit empty settings and those libpqwalreceiver overrides. */
        if (strcmp(opt->keyword, "replication") == 0 ||
            strcmp(opt->keyword, "dbname") == 0 ||
            strcmp(opt->keyword, "fallback_application_name") == 0 ||
            (opt->val == NULL) ||
            (opt->val != NULL && opt->val[0] == '\0'))
            continue;
 
        /* Separate key-value pairs with spaces */
        if (conninfo_buf.len != 0)
            appendPQExpBufferChar(&conninfo_buf, ' ');
 
        /*
         * Write "keyword=value" pieces, the value string is escaped and/or
         * quoted if necessary.
         */
        appendPQExpBuffer(&conninfo_buf, "%s=", opt->keyword);
        appendConnStrVal(&conninfo_buf, opt->val);
    }
 
    if (dbname)
    {
        /*
         * If dbname is specified in the connection, append the dbname. This
         * will be used later for logical replication slot synchronization.
         */
        if (conninfo_buf.len != 0)
            appendPQExpBufferChar(&conninfo_buf, ' ');
 
        appendPQExpBuffer(&conninfo_buf, "%s=", "dbname");
        appendConnStrVal(&conninfo_buf, dbname);
    }
 
    if (PQExpBufferDataBroken(conninfo_buf))
        pg_fatal("out of memory");
 
    /*
     * Escape the connection string, so that it can be put in the config file.
     * Note that this is different from the escaping of individual connection
     * options above!
     */
    escaped = escape_quotes(conninfo_buf.data);
    termPQExpBuffer(&conninfo_buf);
    appendPQExpBuffer(contents, "primary_conninfo = '%s'\n", escaped);
    free(escaped);
 
    if (replication_slot)
    {
        /* unescaped: ReplicationSlotValidateName allows [a-z0-9_] only */
        appendPQExpBuffer(contents, "primary_slot_name = '%s'\n",
                          replication_slot);
    }
 
    if (PQExpBufferBroken(contents))
        pg_fatal("out of memory");
 
    PQconninfoFree(connOptions);
 
    return contents;
}

References appendConnStrVal(), appendPQExpBuffer(), appendPQExpBufferChar(), appendPQExpBufferStr(), Assert, createPQExpBuffer(), PQExpBufferData::data, dbname, escape_quotes(), free, initPQExpBuffer(), _PQconninfoOption::keyword, PQExpBufferData::len, MINIMUM_VERSION_FOR_RECOVERY_GUC, pg_fatal, PQconninfo(), PQconninfoFree(), PQExpBufferBroken, PQExpBufferDataBroken, PQserverVersion(), replication_slot, and termPQExpBuffer().

Referenced by BaseBackup(), main(), and setup_recovery().

WriteRecoveryConfig()

void WriteRecoveryConfig	(	PGconn *	pgconn,
		const char *	target_dir,
		PQExpBuffer	contents
	)

Definition at line 124 of file recovery_gen.c.

{
    char        filename[MAXPGPATH];
    FILE       *cf;
    bool        use_recovery_conf;
 
    Assert(pgconn != NULL);
 
    use_recovery_conf =
        PQserverVersion(pgconn) < MINIMUM_VERSION_FOR_RECOVERY_GUC;
 
    snprintf(filename, MAXPGPATH, "%s/%s", target_dir,
             use_recovery_conf ? "recovery.conf" : "postgresql.auto.conf");
 
    cf = fopen(filename, use_recovery_conf ? "w" : "a");
    if (cf == NULL)
        pg_fatal("could not open file \"%s\": %m", filename);
 
    if (fwrite(contents->data, contents->len, 1, cf) != 1)
        pg_fatal("could not write to file \"%s\": %m", filename);
 
    fclose(cf);
 
    if (!use_recovery_conf)
    {
        snprintf(filename, MAXPGPATH, "%s/%s", target_dir, "standby.signal");
        cf = fopen(filename, "w");
        if (cf == NULL)
            pg_fatal("could not create file \"%s\": %m", filename);
 
        fclose(cf);
    }
}

References Assert, PQExpBufferData::data, filename, PQExpBufferData::len, MAXPGPATH, MINIMUM_VERSION_FOR_RECOVERY_GUC, pg_fatal, PQserverVersion(), and snprintf.

Referenced by main(), and setup_recovery().