Improve new wording of libpq's connection failure messages.

"connection to server so-and-so failed:" seems clearer than the
previous wording "could not connect to so-and-so:" (introduced by
52a10224e), because the latter suggests a network-level connection
failure.  We're now prefixing this string to all types of connection
failures, for instance authentication failures; so we need wording
that doesn't imply a low-level error.

Per discussion with Robert Haas.

Discussion: https://postgr.es/m/CA+TgmobssJ6rS22dspWnu-oDxXevGmhMD8VcRBjmj-b9UDqRjw@mail.gmail.com
This commit is contained in:
Tom Lane 2021-01-21 16:10:18 -05:00
parent 55dc86eca7
commit 27a48e5a16
4 changed files with 23 additions and 22 deletions

View File

@ -3460,7 +3460,7 @@ foreach my $db (sort keys %create_sql)
command_fails_like( command_fails_like(
[ 'pg_dump', '-p', "$port", 'qqq' ], [ 'pg_dump', '-p', "$port", 'qqq' ],
qr/pg_dump: error: connection to database "qqq" failed: could not connect to .*: FATAL: database "qqq" does not exist/, qr/pg_dump: error: connection to database "qqq" failed: connection to server .* failed: FATAL: database "qqq" does not exist/,
'connecting to a non-existent database'); 'connecting to a non-existent database');
######################################### #########################################

View File

@ -36,7 +36,7 @@
[NO_PID]: sqlca: code: 0, state: 00000 [NO_PID]: sqlca: code: 0, state: 00000
[NO_PID]: ECPGconnect: opening database <DEFAULT> on <DEFAULT> port <DEFAULT> for user regress_ecpg_user2 [NO_PID]: ECPGconnect: opening database <DEFAULT> on <DEFAULT> port <DEFAULT> for user regress_ecpg_user2
[NO_PID]: sqlca: code: 0, state: 00000 [NO_PID]: sqlca: code: 0, state: 00000
[NO_PID]: ECPGconnect: could not open database: could not connect: FATAL: database "regress_ecpg_user2" does not exist [NO_PID]: ECPGconnect: could not open database: connection to server failed: FATAL: database "regress_ecpg_user2" does not exist
[NO_PID]: sqlca: code: 0, state: 00000 [NO_PID]: sqlca: code: 0, state: 00000
[NO_PID]: ecpg_finish: connection main closed [NO_PID]: ecpg_finish: connection main closed
@ -73,7 +73,7 @@
[NO_PID]: sqlca: code: -220, state: 08003 [NO_PID]: sqlca: code: -220, state: 08003
[NO_PID]: ECPGconnect: opening database <DEFAULT> on <DEFAULT> port <DEFAULT> for user regress_ecpg_user2 [NO_PID]: ECPGconnect: opening database <DEFAULT> on <DEFAULT> port <DEFAULT> for user regress_ecpg_user2
[NO_PID]: sqlca: code: 0, state: 00000 [NO_PID]: sqlca: code: 0, state: 00000
[NO_PID]: ECPGconnect: could not open database: could not connect: FATAL: database "regress_ecpg_user2" does not exist [NO_PID]: ECPGconnect: could not open database: connection to server failed: FATAL: database "regress_ecpg_user2" does not exist
[NO_PID]: sqlca: code: 0, state: 00000 [NO_PID]: sqlca: code: 0, state: 00000
[NO_PID]: ecpg_finish: connection main closed [NO_PID]: ecpg_finish: connection main closed

View File

@ -80,7 +80,7 @@ ecpg_filter_source(const char *sourcefile, const char *outfile)
} }
/* /*
* Remove the details of "could not connect to ...: " error messages * Remove the details of connection failure error messages
* in a test result file, since the target host/pathname and/or port * in a test result file, since the target host/pathname and/or port
* can vary. Rewrite the result file in-place. * can vary. Rewrite the result file in-place.
* *
@ -113,15 +113,15 @@ ecpg_filter_stderr(const char *resultfile, const char *tmpfile)
while (pg_get_line_buf(s, &linebuf)) while (pg_get_line_buf(s, &linebuf))
{ {
char *p1 = strstr(linebuf.data, "could not connect to "); char *p1 = strstr(linebuf.data, "connection to server ");
if (p1) if (p1)
{ {
char *p2 = strstr(p1, ": "); char *p2 = strstr(p1, "failed: ");
if (p2) if (p2)
{ {
memmove(p1 + 17, p2, strlen(p2) + 1); memmove(p1 + 21, p2, strlen(p2) + 1);
/* we don't bother to fix up linebuf.len */ /* we don't bother to fix up linebuf.len */
} }
} }

View File

@ -1668,17 +1668,16 @@ getHostaddr(PGconn *conn, char *host_addr, int host_addr_len)
host_addr[0] = '\0'; host_addr[0] = '\0';
} }
/* ---------- /*
* emitCouldNotConnect - * emitHostIdentityInfo -
* Speculatively append "could not connect to ...: " to conn->errorMessage * Speculatively append "connection to server so-and-so failed: " to
* once we've identified the current connection target address. This ensures * conn->errorMessage once we've identified the current connection target
* that any subsequent error message will be properly attributed to the * address. This ensures that any subsequent error message will be properly
* server we couldn't connect to. conn->raddr must be valid, and the result * attributed to the server we couldn't connect to. conn->raddr must be
* of getHostaddr() must be supplied. * valid, and the result of getHostaddr() must be supplied.
* ----------
*/ */
static void static void
emitCouldNotConnect(PGconn *conn, const char *host_addr) emitHostIdentityInfo(PGconn *conn, const char *host_addr)
{ {
#ifdef HAVE_UNIX_SOCKETS #ifdef HAVE_UNIX_SOCKETS
if (IS_AF_UNIX(conn->raddr.addr.ss_family)) if (IS_AF_UNIX(conn->raddr.addr.ss_family))
@ -1690,7 +1689,7 @@ emitCouldNotConnect(PGconn *conn, const char *host_addr)
service, sizeof(service), service, sizeof(service),
NI_NUMERICSERV); NI_NUMERICSERV);
appendPQExpBuffer(&conn->errorMessage, appendPQExpBuffer(&conn->errorMessage,
libpq_gettext("could not connect to socket \"%s\": "), libpq_gettext("connection to server on socket \"%s\" failed: "),
service); service);
} }
else else
@ -1717,12 +1716,12 @@ emitCouldNotConnect(PGconn *conn, const char *host_addr)
host_addr[0] && host_addr[0] &&
strcmp(displayed_host, host_addr) != 0) strcmp(displayed_host, host_addr) != 0)
appendPQExpBuffer(&conn->errorMessage, appendPQExpBuffer(&conn->errorMessage,
libpq_gettext("could not connect to host \"%s\" (%s), port %s: "), libpq_gettext("connection to server at \"%s\" (%s), port %s failed: "),
displayed_host, host_addr, displayed_host, host_addr,
displayed_port); displayed_port);
else else
appendPQExpBuffer(&conn->errorMessage, appendPQExpBuffer(&conn->errorMessage,
libpq_gettext("could not connect to host \"%s\", port %s: "), libpq_gettext("connection to server at \"%s\", port %s failed: "),
displayed_host, displayed_host,
displayed_port); displayed_port);
} }
@ -2524,7 +2523,7 @@ keep_going: /* We will come back to here until there is
conn->try_next_addr = true; conn->try_next_addr = true;
goto keep_going; goto keep_going;
} }
emitCouldNotConnect(conn, host_addr); emitHostIdentityInfo(conn, host_addr);
appendPQExpBuffer(&conn->errorMessage, appendPQExpBuffer(&conn->errorMessage,
libpq_gettext("could not create socket: %s\n"), libpq_gettext("could not create socket: %s\n"),
SOCK_STRERROR(errorno, sebuf, sizeof(sebuf))); SOCK_STRERROR(errorno, sebuf, sizeof(sebuf)));
@ -2534,9 +2533,11 @@ keep_going: /* We will come back to here until there is
/* /*
* Once we've identified a target address, all errors * Once we've identified a target address, all errors
* except the preceding socket()-failure case should be * except the preceding socket()-failure case should be
* prefixed with "could not connect to <target>: ". * prefixed with host-identity information. (If the
* connection succeeds, the contents of conn->errorMessage
* won't matter, so this is harmless.)
*/ */
emitCouldNotConnect(conn, host_addr); emitHostIdentityInfo(conn, host_addr);
/* /*
* Select socket options: no delay of outgoing data for * Select socket options: no delay of outgoing data for