PostgreSQL Source Code git master
server.c File Reference
#include "postgres_fe.h"
#include "common/connect.h"
#include "fe_utils/string_utils.h"
#include "libpq/pqcomm.h"
#include "pg_upgrade.h"
Include dependency graph for server.c:

Go to the source code of this file.

Functions

static PGconnget_db_conn (ClusterInfo *cluster, const char *db_name)
 
PGconnconnectToServer (ClusterInfo *cluster, const char *db_name)
 
char * cluster_conn_opts (ClusterInfo *cluster)
 
PGresultexecuteQueryOrDie (PGconn *conn, const char *fmt,...)
 
static void stop_postmaster_atexit (void)
 
bool start_postmaster (ClusterInfo *cluster, bool report_and_exit_on_error)
 
void stop_postmaster (bool in_atexit)
 
void check_pghost_envvar (void)
 

Function Documentation

◆ check_pghost_envvar()

void check_pghost_envvar ( void  )

Definition at line 319 of file server.c.

320{
323
324 /* Get valid libpq env vars from the PQconndefaults function */
325
327
328 if (!start)
329 pg_fatal("out of memory");
330
331 for (option = start; option->keyword != NULL; option++)
332 {
333 if (option->envvar && (strcmp(option->envvar, "PGHOST") == 0 ||
334 strcmp(option->envvar, "PGHOSTADDR") == 0))
335 {
336 const char *value = getenv(option->envvar);
337
338 if (value && strlen(value) > 0 &&
339 /* check for 'local' host values */
340 (strcmp(value, "localhost") != 0 && strcmp(value, "127.0.0.1") != 0 &&
341 strcmp(value, "::1") != 0 && !is_unixsock_path(value)))
342 pg_fatal("libpq environment variable %s has a non-local server value: %s",
343 option->envvar, value);
344 }
345 }
346
347 /* Free the memory that libpq allocated on our behalf */
349}
void PQconninfoFree(PQconninfoOption *connOptions)
Definition: fe-connect.c:7525
PQconninfoOption * PQconndefaults(void)
Definition: fe-connect.c:2207
return str start
static struct @171 value
#define pg_fatal(...)
static bool is_unixsock_path(const char *path)
Definition: pqcomm.h:66

References is_unixsock_path(), pg_fatal, PQconndefaults(), PQconninfoFree(), start, and value.

Referenced by setup().

◆ cluster_conn_opts()

char * cluster_conn_opts ( ClusterInfo cluster)

Definition at line 92 of file server.c.

93{
94 static PQExpBuffer buf;
95
96 if (buf == NULL)
98 else
100
101 if (cluster->sockdir)
102 {
103 appendPQExpBufferStr(buf, "--host ");
104 appendShellString(buf, cluster->sockdir);
106 }
107 appendPQExpBuffer(buf, "--port %d --username ", cluster->port);
109
110 return buf->data;
111}
void cluster(ParseState *pstate, ClusterStmt *stmt, bool isTopLevel)
Definition: cluster.c:107
static char * buf
Definition: pg_test_fsync.c:72
OSInfo os_info
Definition: pg_upgrade.c:74
PQExpBuffer createPQExpBuffer(void)
Definition: pqexpbuffer.c:72
void resetPQExpBuffer(PQExpBuffer str)
Definition: pqexpbuffer.c:146
void appendPQExpBuffer(PQExpBuffer str, const char *fmt,...)
Definition: pqexpbuffer.c:265
void appendPQExpBufferChar(PQExpBuffer str, char ch)
Definition: pqexpbuffer.c:378
void appendPQExpBufferStr(PQExpBuffer str, const char *data)
Definition: pqexpbuffer.c:367
void appendShellString(PQExpBuffer buf, const char *str)
Definition: string_utils.c:582
char * user
Definition: pg_upgrade.h:359

References appendPQExpBuffer(), appendPQExpBufferChar(), appendPQExpBufferStr(), appendShellString(), buf, cluster(), createPQExpBuffer(), os_info, resetPQExpBuffer(), and OSInfo::user.

Referenced by create_new_objects(), generate_old_dump(), prepare_new_cluster(), and prepare_new_globals().

◆ connectToServer()

PGconn * connectToServer ( ClusterInfo cluster,
const char *  db_name 
)

Definition at line 28 of file server.c.

29{
30 PGconn *conn = get_db_conn(cluster, db_name);
31
32 if (conn == NULL || PQstatus(conn) != CONNECTION_OK)
33 {
35
36 if (conn)
38
39 printf(_("Failure, exiting\n"));
40 exit(1);
41 }
42
44
45 return conn;
46}
#define ALWAYS_SECURE_SEARCH_PATH_SQL
Definition: connect.h:25
#define _(x)
Definition: elog.c:91
ConnStatusType PQstatus(const PGconn *conn)
Definition: fe-connect.c:7641
void PQfinish(PGconn *conn)
Definition: fe-connect.c:5316
char * PQerrorMessage(const PGconn *conn)
Definition: fe-connect.c:7704
#define PQclear
Definition: libpq-be-fe.h:245
@ CONNECTION_OK
Definition: libpq-fe.h:84
void void pg_log(eLogType type, const char *fmt,...) pg_attribute_printf(2
@ PG_REPORT
Definition: pg_upgrade.h:276
#define printf(...)
Definition: port.h:266
static PGconn * get_db_conn(ClusterInfo *cluster, const char *db_name)
Definition: server.c:57
PGresult * executeQueryOrDie(PGconn *conn, const char *fmt,...)
Definition: server.c:122
PGconn * conn
Definition: streamutil.c:52

References _, ALWAYS_SECURE_SEARCH_PATH_SQL, cluster(), conn, CONNECTION_OK, executeQueryOrDie(), get_db_conn(), pg_log(), PG_REPORT, PQclear, PQerrorMessage(), PQfinish(), PQstatus(), and printf.

Referenced by check_for_connection_status(), check_for_pg_role_prefix(), check_for_prepared_transactions(), check_is_install_user(), check_loadable_libraries(), check_new_cluster_replication_slots(), check_new_cluster_subscription_configuration(), check_old_cluster_subscription_state(), create_conflict_detection_slot(), create_logical_replication_slots(), create_new_objects(), get_db_infos(), get_subscription_info(), get_tablespace_paths(), get_template0_info(), old_9_6_invalidate_hash_indexes(), set_frozenxids(), set_locale_and_encoding(), and unicode_version_changed().

◆ executeQueryOrDie()

PGresult * executeQueryOrDie ( PGconn conn,
const char *  fmt,
  ... 
)

Definition at line 122 of file server.c.

123{
124 static char query[QUERY_ALLOC];
125 va_list args;
126 PGresult *result;
127 ExecStatusType status;
128
129 va_start(args, fmt);
130 vsnprintf(query, sizeof(query), fmt, args);
131 va_end(args);
132
133 pg_log(PG_VERBOSE, "executing: %s", query);
134 result = PQexec(conn, query);
135 status = PQresultStatus(result);
136
137 if ((status != PGRES_TUPLES_OK) && (status != PGRES_COMMAND_OK))
138 {
139 pg_log(PG_REPORT, "SQL command failed\n%s\n%s", query,
141 PQclear(result);
142 PQfinish(conn);
143 printf(_("Failure, exiting\n"));
144 exit(1);
145 }
146 else
147 return result;
148}
PGresult * PQexec(PGconn *conn, const char *query)
Definition: fe-exec.c:2279
#define PQresultStatus
Definition: libpq-be-fe.h:247
ExecStatusType
Definition: libpq-fe.h:123
@ PGRES_COMMAND_OK
Definition: libpq-fe.h:125
@ PGRES_TUPLES_OK
Definition: libpq-fe.h:128
#define QUERY_ALLOC
Definition: pg_upgrade.h:23
@ PG_VERBOSE
Definition: pg_upgrade.h:273
#define vsnprintf
Definition: port.h:259

References _, generate_unaccent_rules::args, conn, pg_log(), PG_REPORT, PG_VERBOSE, PGRES_COMMAND_OK, PGRES_TUPLES_OK, PQclear, PQerrorMessage(), PQexec(), PQfinish(), PQresultStatus, printf, QUERY_ALLOC, and vsnprintf.

Referenced by connectToServer().

◆ get_db_conn()

static PGconn * get_db_conn ( ClusterInfo cluster,
const char *  db_name 
)
static

Definition at line 57 of file server.c.

58{
59 PQExpBufferData conn_opts;
60 PGconn *conn;
61
62 /* Build connection string with proper quoting */
63 initPQExpBuffer(&conn_opts);
64 appendPQExpBufferStr(&conn_opts, "dbname=");
65 appendConnStrVal(&conn_opts, db_name);
66 appendPQExpBufferStr(&conn_opts, " user=");
67 appendConnStrVal(&conn_opts, os_info.user);
68 appendPQExpBuffer(&conn_opts, " port=%d", cluster->port);
69 if (cluster->sockdir)
70 {
71 appendPQExpBufferStr(&conn_opts, " host=");
72 appendConnStrVal(&conn_opts, cluster->sockdir);
73 }
74
75 conn = PQconnectdb(conn_opts.data);
76 termPQExpBuffer(&conn_opts);
77 return conn;
78}
PGconn * PQconnectdb(const char *conninfo)
Definition: fe-connect.c:825
void initPQExpBuffer(PQExpBuffer str)
Definition: pqexpbuffer.c:90
void termPQExpBuffer(PQExpBuffer str)
Definition: pqexpbuffer.c:129
void appendConnStrVal(PQExpBuffer buf, const char *str)
Definition: string_utils.c:698

References appendConnStrVal(), appendPQExpBuffer(), appendPQExpBufferStr(), cluster(), conn, PQExpBufferData::data, initPQExpBuffer(), os_info, PQconnectdb(), termPQExpBuffer(), and OSInfo::user.

Referenced by connectToServer(), and start_postmaster().

◆ start_postmaster()

bool start_postmaster ( ClusterInfo cluster,
bool  report_and_exit_on_error 
)

Definition at line 159 of file server.c.

160{
161 char cmd[MAXPGPATH * 4 + 1000];
162 PGconn *conn;
163 bool pg_ctl_return = false;
164 char socket_string[MAXPGPATH + 200];
165 PQExpBufferData pgoptions;
166
167 static bool exit_hook_registered = false;
168
169 if (!exit_hook_registered)
170 {
172 exit_hook_registered = true;
173 }
174
175 socket_string[0] = '\0';
176
177#if !defined(WIN32)
178 /* prevent TCP/IP connections, restrict socket access */
179 strcat(socket_string,
180 " -c listen_addresses='' -c unix_socket_permissions=0700");
181
182 /* Have a sockdir? Tell the postmaster. */
183 if (cluster->sockdir)
184 snprintf(socket_string + strlen(socket_string),
185 sizeof(socket_string) - strlen(socket_string),
186 " -c %s='%s'",
187 (GET_MAJOR_VERSION(cluster->major_version) <= 902) ?
188 "unix_socket_directory" : "unix_socket_directories",
189 cluster->sockdir);
190#endif
191
192 initPQExpBuffer(&pgoptions);
193
194 /*
195 * Construct a parameter string which is passed to the server process.
196 *
197 * Turn off durability requirements to improve object creation speed, and
198 * we only modify the new cluster, so only use it there. If there is a
199 * crash, the new cluster has to be recreated anyway. fsync=off is a big
200 * win on ext4.
201 */
202 if (cluster == &new_cluster)
203 appendPQExpBufferStr(&pgoptions, " -c synchronous_commit=off -c fsync=off -c full_page_writes=off");
204
205 /*
206 * Use -b to disable autovacuum and logical replication launcher
207 * (effective in PG17 or later for the latter).
208 */
209 snprintf(cmd, sizeof(cmd),
210 "\"%s/pg_ctl\" -w -l \"%s/%s\" -D \"%s\" -o \"-p %d -b%s %s%s\" start",
211 cluster->bindir,
213 SERVER_LOG_FILE, cluster->pgconfig, cluster->port,
214 pgoptions.data,
215 cluster->pgopts ? cluster->pgopts : "", socket_string);
216
217 termPQExpBuffer(&pgoptions);
218
219 /*
220 * Don't throw an error right away, let connecting throw the error because
221 * it might supply a reason for the failure.
222 */
223 pg_ctl_return = exec_prog(SERVER_START_LOG_FILE,
224 /* pass both file names if they differ */
225 (strcmp(SERVER_LOG_FILE,
226 SERVER_START_LOG_FILE) != 0) ?
227 SERVER_LOG_FILE : NULL,
228 report_and_exit_on_error, false,
229 "%s", cmd);
230
231 /* Did it fail and we are just testing if the server could be started? */
232 if (!pg_ctl_return && !report_and_exit_on_error)
233 return false;
234
235 /*
236 * We set this here to make sure atexit() shuts down the server, but only
237 * if we started the server successfully. We do it before checking for
238 * connectivity in case the server started but there is a connectivity
239 * failure. If pg_ctl did not return success, we will exit below.
240 *
241 * Pre-9.1 servers do not have PQping(), so we could be leaving the server
242 * running if authentication was misconfigured, so someday we might went
243 * to be more aggressive about doing server shutdowns even if pg_ctl
244 * fails, but now (2013-08-14) it seems prudent to be cautious. We don't
245 * want to shutdown a server that might have been accidentally started
246 * during the upgrade.
247 */
248 if (pg_ctl_return)
250
251 /*
252 * pg_ctl -w might have failed because the server couldn't be started, or
253 * there might have been a connection problem in _checking_ if the server
254 * has started. Therefore, even if pg_ctl failed, we continue and test
255 * for connectivity in case we get a connection reason for the failure.
256 */
257 if ((conn = get_db_conn(cluster, "template1")) == NULL ||
259 {
261 if (conn)
262 PQfinish(conn);
263 if (cluster == &old_cluster)
264 pg_fatal("could not connect to source postmaster started with the command:\n"
265 "%s",
266 cmd);
267 else
268 pg_fatal("could not connect to target postmaster started with the command:\n"
269 "%s",
270 cmd);
271 }
272 PQfinish(conn);
273
274 /*
275 * If pg_ctl failed, and the connection didn't fail, and
276 * report_and_exit_on_error is enabled, fail now. This could happen if
277 * the server was already running.
278 */
279 if (!pg_ctl_return)
280 {
281 if (cluster == &old_cluster)
282 pg_fatal("pg_ctl failed to start the source server, or connection failed");
283 else
284 pg_fatal("pg_ctl failed to start the target server, or connection failed");
285 }
286
287 return true;
288}
bool exec_prog(const char *log_filename, const char *opt_log_file, bool report_error, bool exit_on_error, const char *fmt,...)
Definition: exec.c:86
#define MAXPGPATH
ClusterInfo new_cluster
Definition: pg_upgrade.c:73
ClusterInfo old_cluster
Definition: pg_upgrade.c:72
#define SERVER_START_LOG_FILE
Definition: pg_upgrade.h:67
#define SERVER_LOG_FILE
Definition: pg_upgrade.h:44
LogOpts log_opts
Definition: util.c:17
#define GET_MAJOR_VERSION(v)
Definition: pg_upgrade.h:27
#define snprintf
Definition: port.h:260
static void stop_postmaster_atexit(void)
Definition: server.c:152
char * logdir
Definition: pg_upgrade.h:324
ClusterInfo * running_cluster
Definition: pg_upgrade.h:363

References appendPQExpBufferStr(), cluster(), conn, CONNECTION_OK, PQExpBufferData::data, exec_prog(), get_db_conn(), GET_MAJOR_VERSION, initPQExpBuffer(), log_opts, LogOpts::logdir, MAXPGPATH, new_cluster, old_cluster, os_info, pg_fatal, pg_log(), PG_REPORT, PQerrorMessage(), PQfinish(), PQstatus(), OSInfo::running_cluster, SERVER_LOG_FILE, SERVER_START_LOG_FILE, snprintf, stop_postmaster_atexit(), and termPQExpBuffer().

◆ stop_postmaster()

void stop_postmaster ( bool  in_atexit)

Definition at line 292 of file server.c.

293{
295
300 else
301 return; /* no cluster running */
302
303 exec_prog(SERVER_STOP_LOG_FILE, NULL, !in_atexit, !in_atexit,
304 "\"%s/pg_ctl\" -w -D \"%s\" -o \"%s\" %s stop",
305 cluster->bindir, cluster->pgconfig,
306 cluster->pgopts ? cluster->pgopts : "",
307 in_atexit ? "-m fast" : "-m smart");
308
310}
#define SERVER_STOP_LOG_FILE
Definition: pg_upgrade.h:68

References cluster(), exec_prog(), new_cluster, old_cluster, os_info, OSInfo::running_cluster, and SERVER_STOP_LOG_FILE.

Referenced by check_and_dump_old_cluster(), issue_warnings_and_set_wal_level(), main(), report_clusters_compatible(), setup(), and stop_postmaster_atexit().

◆ stop_postmaster_atexit()

static void stop_postmaster_atexit ( void  )
static

Definition at line 152 of file server.c.

153{
154 stop_postmaster(true);
155}
void stop_postmaster(bool in_atexit)
Definition: server.c:292

References stop_postmaster().

Referenced by start_postmaster().