]> git.ipfire.org Git - thirdparty/postgresql.git/commitdiff
Clean up quoting of variable strings within replication commands.
authorTom Lane <tgl@sss.pgh.pa.us>
Mon, 15 Jun 2026 19:35:37 +0000 (15:35 -0400)
committerTom Lane <tgl@sss.pgh.pa.us>
Mon, 15 Jun 2026 19:35:37 +0000 (15:35 -0400)
Our handling of quoting within replication commands was pretty
sloppy, typically looking like
        appendStringInfo(&cmd, " SLOT \"%s\"", options->slotname);
This is fine as long as options->slotname doesn't contain a double
quote mark, but what if it does?  In principle this'd allow injection
of harmful options into replication commands, in the probably-unlikely
case that a slot name comes from untrustworthy input.  We ought to
clean that up.

Moreover, even the places that were trying to be more careful
generally got it wrong, because they used quoting subroutines
intended for SQL commands rather than something that will work
with the replication-command scanner repl_scanner.l.  For example,
several places naively use PQescapeLiteral() to quote option values
for replication commands.  If the string contains a backslash,
PQescapeLiteral() will produce E'...' literal syntax, which
repl_scanner.l doesn't recognize.  Another near miss was to use
quote_identifier() to quote identifiers.  That function won't quote
valid lowercase identifiers unless they match SQL keywords ... but in
this context, replication keywords are what matter.  Neither of these
errors seem to risk string injection, but they definitely can cause
syntax errors in replication commands that ought to be valid.

We can clean all this up by using simple quoting logic that just
doubles single or double quotes respectively.

Or at least, we could if repl_scanner.l handled doubled double quotes
in identifiers, but for some reason it doesn't!  So the first step in
this fix has to be to fix that.  (The fact that we'll later reject
slot names containing double quotes is very far short of justifying
this omission.)

Having done that, this patch runs around and applies correct
quoting in all places that generate replication commands containing
strings coming from outside the immediate context.  Probably some
of these places are safe because of restrictions elsewhere, but it
seems best to just quote all the time.

This was originally reported as a security bug, which it could be
if replication slot names or parameters were to originate from
untrustworthy sources.  But the security team concluded that that
was a very improbable situation, so we're just going to fix this
as a regular bug.

Reported-by: Team Dhiutsa
Author: Tom Lane <tgl@sss.pgh.pa.us>
Reviewed-by: Ayush Tiwari <ayushtiwari.slg01@gmail.com>
Discussion: https://postgr.es/m/1648659.1781287310@sss.pgh.pa.us
Backpatch-through: 14

src/backend/commands/subscriptioncmds.c
src/backend/replication/libpqwalreceiver/libpqwalreceiver.c
src/backend/replication/repl_scanner.l
src/bin/pg_basebackup/pg_recvlogical.c
src/bin/pg_basebackup/receivelog.c
src/bin/pg_basebackup/streamutil.c
src/bin/pg_basebackup/streamutil.h

index 27cbb5870770236b9e76a35d4dc1da177e3e3dfd..75d03c63d2b0c28fa882562a409c601ff7dd999a 100644 (file)
@@ -405,6 +405,32 @@ get_publications_str(List *publications, StringInfo dest, bool quote_literal)
        }
 }
 
+/*
+ * Append a suitably-quoted identifier or string literal to buf.
+ * "quote" should be either a double-quote or single-quote character.
+ *
+ * Caution: this quoting logic is sufficient for identifiers and literals
+ * in the replication grammar, but not always in regular SQL.  Specifically,
+ * it'd fail for a string literal if standard_conforming_strings is off.
+ */
+static void
+appendQuotedString(StringInfo buf, const char *str, char quote)
+{
+       appendStringInfoChar(buf, quote);
+       while (*str)
+       {
+               char            c = *str++;
+
+               if (c == quote)
+                       appendStringInfoChar(buf, c);
+               appendStringInfoChar(buf, c);
+       }
+       appendStringInfoChar(buf, quote);
+}
+
+#define appendQuotedIdentifier(b, s)   appendQuotedString(b, s, '"')
+#define appendQuotedLiteral(b, s)              appendQuotedString(b, s, '\'')
+
 /*
  * Check that the specified publications are present on the publisher.
  */
@@ -1608,7 +1634,9 @@ ReplicationSlotDropAtPubNode(WalReceiverConn *wrconn, char *slotname, bool missi
        load_file("libpqwalreceiver", false);
 
        initStringInfo(&cmd);
-       appendStringInfo(&cmd, "DROP_REPLICATION_SLOT %s WAIT", quote_identifier(slotname));
+       appendStringInfoString(&cmd, "DROP_REPLICATION_SLOT ");
+       appendQuotedIdentifier(&cmd, slotname);
+       appendStringInfoString(&cmd, " WAIT");
 
        PG_TRY();
        {
index 347002329c5aa36a41f6a4831222eaa31ad2c26b..32168ea5bd9f2a430f137fa9458a3bea17a66750 100644 (file)
@@ -106,7 +106,7 @@ static WalReceiverFunctionsType PQWalReceiverFunctions = {
 /* Prototypes for private functions */
 static PGresult *libpqrcv_PQexec(PGconn *streamConn, const char *query);
 static PGresult *libpqrcv_PQgetResult(PGconn *streamConn);
-static char *stringlist_to_identifierstr(PGconn *conn, List *strings);
+static char *stringlist_to_identifierstr(List *strings);
 
 /*
  * Module initialization function
@@ -464,6 +464,32 @@ libpqrcv_get_option_from_conninfo(const char *connInfo, const char *keyword)
        return option;
 }
 
+/*
+ * Append a suitably-quoted identifier or string literal to buf.
+ * "quote" should be either a double-quote or single-quote character.
+ *
+ * Caution: this quoting logic is sufficient for identifiers and literals
+ * in the replication grammar, but not always in regular SQL.  Specifically,
+ * it'd fail for a string literal if standard_conforming_strings is off.
+ */
+static void
+appendQuotedString(StringInfo buf, const char *str, char quote)
+{
+       appendStringInfoChar(buf, quote);
+       while (*str)
+       {
+               char            c = *str++;
+
+               if (c == quote)
+                       appendStringInfoChar(buf, c);
+               appendStringInfoChar(buf, c);
+       }
+       appendStringInfoChar(buf, quote);
+}
+
+#define appendQuotedIdentifier(b, s)   appendQuotedString(b, s, '"')
+#define appendQuotedLiteral(b, s)              appendQuotedString(b, s, '\'')
+
 /*
  * Start streaming WAL data from given streaming options.
  *
@@ -489,8 +515,10 @@ libpqrcv_startstreaming(WalReceiverConn *conn,
        /* Build the command. */
        appendStringInfoString(&cmd, "START_REPLICATION");
        if (options->slotname != NULL)
-               appendStringInfo(&cmd, " SLOT \"%s\"",
-                                                options->slotname);
+       {
+               appendStringInfoString(&cmd, " SLOT ");
+               appendQuotedIdentifier(&cmd, options->slotname);
+       }
 
        if (options->logical)
                appendStringInfoString(&cmd, " LOGICAL");
@@ -505,7 +533,6 @@ libpqrcv_startstreaming(WalReceiverConn *conn,
        {
                char       *pubnames_str;
                List       *pubnames;
-               char       *pubnames_literal;
 
                appendStringInfoString(&cmd, " (");
 
@@ -521,21 +548,9 @@ libpqrcv_startstreaming(WalReceiverConn *conn,
                        appendStringInfoString(&cmd, ", two_phase 'on'");
 
                pubnames = options->proto.logical.publication_names;
-               pubnames_str = stringlist_to_identifierstr(conn->streamConn, pubnames);
-               if (!pubnames_str)
-                       ereport(ERROR,
-                                       (errcode(ERRCODE_OUT_OF_MEMORY),        /* likely guess */
-                                        errmsg("could not start WAL streaming: %s",
-                                                       pchomp(PQerrorMessage(conn->streamConn)))));
-               pubnames_literal = PQescapeLiteral(conn->streamConn, pubnames_str,
-                                                                                  strlen(pubnames_str));
-               if (!pubnames_literal)
-                       ereport(ERROR,
-                                       (errcode(ERRCODE_OUT_OF_MEMORY),        /* likely guess */
-                                        errmsg("could not start WAL streaming: %s",
-                                                       pchomp(PQerrorMessage(conn->streamConn)))));
-               appendStringInfo(&cmd, ", publication_names %s", pubnames_literal);
-               PQfreemem(pubnames_literal);
+               pubnames_str = stringlist_to_identifierstr(pubnames);
+               appendStringInfoString(&cmd, ", publication_names ");
+               appendQuotedLiteral(&cmd, pubnames_str);
                pfree(pubnames_str);
 
                if (options->proto.logical.binary &&
@@ -944,7 +959,8 @@ libpqrcv_create_slot(WalReceiverConn *conn, const char *slotname,
 
        initStringInfo(&cmd);
 
-       appendStringInfo(&cmd, "CREATE_REPLICATION_SLOT \"%s\"", slotname);
+       appendStringInfoString(&cmd, "CREATE_REPLICATION_SLOT ");
+       appendQuotedIdentifier(&cmd, slotname);
 
        if (temporary)
                appendStringInfoString(&cmd, " TEMPORARY");
@@ -1196,10 +1212,10 @@ libpqrcv_exec(WalReceiverConn *conn, const char *query,
  *
  * This is essentially the reverse of SplitIdentifierString.
  *
- * The caller should free the result.
+ * The caller should pfree the result.
  */
 static char *
-stringlist_to_identifierstr(PGconn *conn, List *strings)
+stringlist_to_identifierstr(List *strings)
 {
        ListCell   *lc;
        StringInfoData res;
@@ -1210,21 +1226,12 @@ stringlist_to_identifierstr(PGconn *conn, List *strings)
        foreach(lc, strings)
        {
                char       *val = strVal(lfirst(lc));
-               char       *val_escaped;
 
                if (first)
                        first = false;
                else
                        appendStringInfoChar(&res, ',');
-
-               val_escaped = PQescapeIdentifier(conn, val, strlen(val));
-               if (!val_escaped)
-               {
-                       free(res.data);
-                       return NULL;
-               }
-               appendStringInfoString(&res, val_escaped);
-               PQfreemem(val_escaped);
+               appendQuotedIdentifier(&res, val);
        }
 
        return res.data;
index 586f0d3a5c80d4b65966655c3a2ee0f1cfd5b3c5..7c571971db0122b2ee5de928654a8b84a9ba395e 100644 (file)
@@ -179,6 +179,10 @@ WAIT                               { return K_WAIT; }
                                        return IDENT;
                                }
 
+<xd>{xddouble} {
+                                       addlitchar('"');
+                               }
+
 <xd>{xdinside}  {
                                        addlit(yytext, yyleng);
                                }
index 193adac088ed70b314b6665d572cb7dfc3a50ea4..b97520a0445b3d0864ff106b0b57683dd436fe4f 100644 (file)
@@ -232,8 +232,9 @@ StreamLogicalLog(void)
 
        /* Initiate the replication stream at specified location */
        query = createPQExpBuffer();
-       appendPQExpBuffer(query, "START_REPLICATION SLOT \"%s\" LOGICAL %X/%X",
-                                         replication_slot, LSN_FORMAT_ARGS(startpos));
+       appendPQExpBufferStr(query, "START_REPLICATION SLOT ");
+       AppendQuotedIdentifier(query, replication_slot);
+       appendPQExpBuffer(query, " LOGICAL %X/%X", LSN_FORMAT_ARGS(startpos));
 
        /* print options if there are any */
        if (noptions)
@@ -246,11 +247,14 @@ StreamLogicalLog(void)
                        appendPQExpBufferStr(query, ", ");
 
                /* write option name */
-               appendPQExpBuffer(query, "\"%s\"", options[(i * 2)]);
+               AppendQuotedIdentifier(query, options[i * 2]);
 
                /* write option value if specified */
-               if (options[(i * 2) + 1] != NULL)
-                       appendPQExpBuffer(query, " '%s'", options[(i * 2) + 1]);
+               if (options[i * 2 + 1] != NULL)
+               {
+                       appendPQExpBufferChar(query, ' ');
+                       AppendQuotedLiteral(query, options[i * 2 + 1]);
+               }
        }
 
        if (noptions)
index c58448f3176655add96d0c1654029f28b9aa5589..f3a2ffb6acf13da4ddfa851c35d21ed9bb859d8f 100644 (file)
@@ -458,8 +458,7 @@ CheckServerVersionForStreaming(PGconn *conn)
 bool
 ReceiveXlogStream(PGconn *conn, StreamCtl *stream)
 {
-       char            query[128];
-       char            slotcmd[128];
+       PQExpBuffer query;
        PGresult   *res;
        XLogRecPtr      stoppos;
 
@@ -484,7 +483,6 @@ ReceiveXlogStream(PGconn *conn, StreamCtl *stream)
        if (stream->replication_slot != NULL)
        {
                reportFlushPosition = true;
-               sprintf(slotcmd, "SLOT \"%s\" ", stream->replication_slot);
        }
        else
        {
@@ -492,7 +490,6 @@ ReceiveXlogStream(PGconn *conn, StreamCtl *stream)
                        reportFlushPosition = true;
                else
                        reportFlushPosition = false;
-               slotcmd[0] = 0;
        }
 
        if (stream->sysidentifier != NULL)
@@ -541,8 +538,10 @@ ReceiveXlogStream(PGconn *conn, StreamCtl *stream)
                 */
                if (!existsTimeLineHistoryFile(stream))
                {
-                       snprintf(query, sizeof(query), "TIMELINE_HISTORY %u", stream->timeline);
-                       res = PQexec(conn, query);
+                       query = createPQExpBuffer();
+                       appendPQExpBuffer(query, "TIMELINE_HISTORY %u", stream->timeline);
+                       res = PQexec(conn, query->data);
+                       destroyPQExpBuffer(query);
                        if (PQresultStatus(res) != PGRES_TUPLES_OK)
                        {
                                /* FIXME: we might send it ok, but get an error */
@@ -578,11 +577,18 @@ ReceiveXlogStream(PGconn *conn, StreamCtl *stream)
                        return true;
 
                /* Initiate the replication stream at specified location */
-               snprintf(query, sizeof(query), "START_REPLICATION %s%X/%X TIMELINE %u",
-                                slotcmd,
-                                LSN_FORMAT_ARGS(stream->startpos),
-                                stream->timeline);
-               res = PQexec(conn, query);
+               query = createPQExpBuffer();
+               appendPQExpBufferStr(query, "START_REPLICATION");
+               if (stream->replication_slot != NULL)
+               {
+                       appendPQExpBufferStr(query, " SLOT ");
+                       AppendQuotedIdentifier(query, stream->replication_slot);
+               }
+               appendPQExpBuffer(query, " %X/%X TIMELINE %u",
+                                                 LSN_FORMAT_ARGS(stream->startpos),
+                                                 stream->timeline);
+               res = PQexec(conn, query->data);
+               destroyPQExpBuffer(query);
                if (PQresultStatus(res) != PGRES_COPY_BOTH)
                {
                        pg_log_error("could not send replication command \"%s\": %s",
index 1478aa9f25a8aa76a9895f7578b43ee133c2050a..e250a79f97b12ad6bc5275e4417cf404242bd6d3 100644 (file)
@@ -495,7 +495,8 @@ GetSlotInformation(PGconn *conn, const char *slot_name,
                *restart_tli = tli_loc;
 
        query = createPQExpBuffer();
-       appendPQExpBuffer(query, "READ_REPLICATION_SLOT %s", slot_name);
+       appendPQExpBufferStr(query, "READ_REPLICATION_SLOT ");
+       AppendQuotedIdentifier(query, slot_name);
        res = PQexec(conn, query->data);
        destroyPQExpBuffer(query);
 
@@ -591,13 +592,17 @@ CreateReplicationSlot(PGconn *conn, const char *slot_name, const char *plugin,
        Assert(slot_name != NULL);
 
        /* Build base portion of query */
-       appendPQExpBuffer(query, "CREATE_REPLICATION_SLOT \"%s\"", slot_name);
+       appendPQExpBufferStr(query, "CREATE_REPLICATION_SLOT ");
+       AppendQuotedIdentifier(query, slot_name);
        if (is_temporary)
                appendPQExpBufferStr(query, " TEMPORARY");
        if (is_physical)
                appendPQExpBufferStr(query, " PHYSICAL");
        else
-               appendPQExpBuffer(query, " LOGICAL \"%s\"", plugin);
+       {
+               appendPQExpBufferStr(query, " LOGICAL ");
+               AppendQuotedIdentifier(query, plugin);
+       }
 
        /* Add any requested options */
        if (use_new_option_syntax)
@@ -693,8 +698,8 @@ DropReplicationSlot(PGconn *conn, const char *slot_name)
        query = createPQExpBuffer();
 
        /* Build query */
-       appendPQExpBuffer(query, "DROP_REPLICATION_SLOT \"%s\"",
-                                         slot_name);
+       appendPQExpBufferStr(query, "DROP_REPLICATION_SLOT ");
+       AppendQuotedIdentifier(query, slot_name);
        res = PQexec(conn, query->data);
        if (PQresultStatus(res) != PGRES_COMMAND_OK)
        {
@@ -722,6 +727,29 @@ DropReplicationSlot(PGconn *conn, const char *slot_name)
        return true;
 }
 
+/*
+ * Append a suitably-quoted identifier or string literal to buf.
+ * "quote" should be either a double-quote or single-quote character.
+ *
+ * Caution: this quoting logic is sufficient for identifiers and literals
+ * in the replication grammar, but not always in regular SQL.  Specifically,
+ * it'd fail for a string literal if standard_conforming_strings is off.
+ */
+void
+AppendQuotedString(PQExpBuffer buf, const char *str, char quote)
+{
+       appendPQExpBufferChar(buf, quote);
+       while (*str)
+       {
+               char            c = *str++;
+
+               if (c == quote)
+                       appendPQExpBufferChar(buf, c);
+               appendPQExpBufferChar(buf, c);
+       }
+       appendPQExpBufferChar(buf, quote);
+}
+
 /*
  * Append a "plain" option - one with no value - to a server command that
  * is being constructed.
@@ -730,10 +758,13 @@ DropReplicationSlot(PGconn *conn, const char *slot_name)
  * write things like SOME_COMMAND OPTION1 OPTION2 'opt2value' OPTION3 42. The
  * new syntax uses a comma-separated list surrounded by parentheses, so the
  * equivalent is SOME_COMMAND (OPTION1, OPTION2 'optvalue', OPTION3 42).
+ *
+ * Note: we assume option names do not require quotes.  Do not use this
+ * with option names coming from outside sources.
  */
 void
 AppendPlainCommandOption(PQExpBuffer buf, bool use_new_option_syntax,
-                                                char *option_name)
+                                                const char *option_name)
 {
        if (buf->len > 0 && buf->data[buf->len - 1] != '(')
        {
@@ -754,30 +785,26 @@ AppendPlainCommandOption(PQExpBuffer buf, bool use_new_option_syntax,
  */
 void
 AppendStringCommandOption(PQExpBuffer buf, bool use_new_option_syntax,
-                                                 char *option_name, char *option_value)
+                                                 const char *option_name, const char *option_value)
 {
        AppendPlainCommandOption(buf, use_new_option_syntax, option_name);
 
        if (option_value != NULL)
        {
-               size_t          length = strlen(option_value);
-               char       *escaped_value = palloc(1 + 2 * length);
-
-               PQescapeStringConn(conn, escaped_value, option_value, length, NULL);
-               appendPQExpBuffer(buf, " '%s'", escaped_value);
-               pfree(escaped_value);
+               appendPQExpBufferChar(buf, ' ');
+               AppendQuotedLiteral(buf, option_value);
        }
 }
 
 /*
- * Append an option with an associated integer value to a server command
+ * Append an option with an associated integer value to a server command that
  * is being constructed.
  *
  * See comments for AppendPlainCommandOption, above.
  */
 void
 AppendIntegerCommandOption(PQExpBuffer buf, bool use_new_option_syntax,
-                                                  char *option_name, int32 option_value)
+                                                  const char *option_name, int32 option_value)
 {
        AppendPlainCommandOption(buf, use_new_option_syntax, option_name);
 
index 8638f81f3bf001591095a6f61241783167ef2196..f2c60e5f6000577ec10fef2ad8ab91e28afff56e 100644 (file)
@@ -42,15 +42,20 @@ extern bool RunIdentifySystem(PGconn *conn, char **sysid,
                                                          XLogRecPtr *startpos,
                                                          char **db_name);
 
+extern void AppendQuotedString(PQExpBuffer buf, const char *str, char quote);
+#define AppendQuotedIdentifier(b, s)   AppendQuotedString(b, s, '"')
+#define AppendQuotedLiteral(b, s)              AppendQuotedString(b, s, '\'')
 extern void AppendPlainCommandOption(PQExpBuffer buf,
                                                                         bool use_new_option_syntax,
-                                                                        char *option_value);
+                                                                        const char *option_name);
 extern void AppendStringCommandOption(PQExpBuffer buf,
                                                                          bool use_new_option_syntax,
-                                                                         char *option_name, char *option_value);
+                                                                         const char *option_name,
+                                                                         const char *option_value);
 extern void AppendIntegerCommandOption(PQExpBuffer buf,
                                                                           bool use_new_option_syntax,
-                                                                          char *option_name, int32 option_value);
+                                                                          const char *option_name,
+                                                                          int32 option_value);
 
 extern bool GetSlotInformation(PGconn *conn, const char *slot_name,
                                                           XLogRecPtr *restart_lsn,