Line data Source code
1 : /*--------------------------------------------------------------------
2 : * guc.c
3 : *
4 : * Support for grand unified configuration scheme, including SET
5 : * command, configuration file, and command line options.
6 : *
7 : * This file contains the generic option processing infrastructure.
8 : * guc_funcs.c contains SQL-level functionality, including SET/SHOW
9 : * commands and various system-administration SQL functions.
10 : * guc_tables.c contains the arrays that define all the built-in
11 : * GUC variables. Code that implements variable-specific behavior
12 : * is scattered around the system in check, assign, and show hooks.
13 : *
14 : * See src/backend/utils/misc/README for more information.
15 : *
16 : *
17 : * Copyright (c) 2000-2025, PostgreSQL Global Development Group
18 : * Written by Peter Eisentraut <peter_e@gmx.net>.
19 : *
20 : * IDENTIFICATION
21 : * src/backend/utils/misc/guc.c
22 : *
23 : *--------------------------------------------------------------------
24 : */
25 : #include "postgres.h"
26 :
27 : #include <limits.h>
28 : #include <math.h>
29 : #include <sys/stat.h>
30 : #include <unistd.h>
31 :
32 : #include "access/xact.h"
33 : #include "access/xlog.h"
34 : #include "catalog/objectaccess.h"
35 : #include "catalog/pg_authid.h"
36 : #include "catalog/pg_parameter_acl.h"
37 : #include "guc_internal.h"
38 : #include "libpq/pqformat.h"
39 : #include "libpq/protocol.h"
40 : #include "miscadmin.h"
41 : #include "parser/scansup.h"
42 : #include "port/pg_bitutils.h"
43 : #include "storage/fd.h"
44 : #include "storage/lwlock.h"
45 : #include "storage/shmem.h"
46 : #include "tcop/tcopprot.h"
47 : #include "utils/acl.h"
48 : #include "utils/builtins.h"
49 : #include "utils/conffiles.h"
50 : #include "utils/guc_tables.h"
51 : #include "utils/memutils.h"
52 : #include "utils/timestamp.h"
53 :
54 :
55 : #define CONFIG_FILENAME "postgresql.conf"
56 : #define HBA_FILENAME "pg_hba.conf"
57 : #define IDENT_FILENAME "pg_ident.conf"
58 :
59 : #ifdef EXEC_BACKEND
60 : #define CONFIG_EXEC_PARAMS "global/config_exec_params"
61 : #define CONFIG_EXEC_PARAMS_NEW "global/config_exec_params.new"
62 : #endif
63 :
64 : /*
65 : * Precision with which REAL type guc values are to be printed for GUC
66 : * serialization.
67 : */
68 : #define REALTYPE_PRECISION 17
69 :
70 : /*
71 : * Safe search path when executing code as the table owner, such as during
72 : * maintenance operations.
73 : */
74 : #define GUC_SAFE_SEARCH_PATH "pg_catalog, pg_temp"
75 :
76 : static int GUC_check_errcode_value;
77 :
78 : static List *reserved_class_prefix = NIL;
79 :
80 : /* global variables for check hook support */
81 : char *GUC_check_errmsg_string;
82 : char *GUC_check_errdetail_string;
83 : char *GUC_check_errhint_string;
84 :
85 :
86 : /*
87 : * Unit conversion tables.
88 : *
89 : * There are two tables, one for memory units, and another for time units.
90 : * For each supported conversion from one unit to another, we have an entry
91 : * in the table.
92 : *
93 : * To keep things simple, and to avoid possible roundoff error,
94 : * conversions are never chained. There needs to be a direct conversion
95 : * between all units (of the same type).
96 : *
97 : * The conversions for each base unit must be kept in order from greatest to
98 : * smallest human-friendly unit; convert_xxx_from_base_unit() rely on that.
99 : * (The order of the base-unit groups does not matter.)
100 : */
101 : #define MAX_UNIT_LEN 3 /* length of longest recognized unit string */
102 :
103 : typedef struct
104 : {
105 : char unit[MAX_UNIT_LEN + 1]; /* unit, as a string, like "kB" or
106 : * "min" */
107 : int base_unit; /* GUC_UNIT_XXX */
108 : double multiplier; /* Factor for converting unit -> base_unit */
109 : } unit_conversion;
110 :
111 : /* Ensure that the constants in the tables don't overflow or underflow */
112 : #if BLCKSZ < 1024 || BLCKSZ > (1024*1024)
113 : #error BLCKSZ must be between 1KB and 1MB
114 : #endif
115 : #if XLOG_BLCKSZ < 1024 || XLOG_BLCKSZ > (1024*1024)
116 : #error XLOG_BLCKSZ must be between 1KB and 1MB
117 : #endif
118 :
119 : static const char *const memory_units_hint = gettext_noop("Valid units for this parameter are \"B\", \"kB\", \"MB\", \"GB\", and \"TB\".");
120 :
121 : static const unit_conversion memory_unit_conversion_table[] =
122 : {
123 : {"TB", GUC_UNIT_BYTE, 1024.0 * 1024.0 * 1024.0 * 1024.0},
124 : {"GB", GUC_UNIT_BYTE, 1024.0 * 1024.0 * 1024.0},
125 : {"MB", GUC_UNIT_BYTE, 1024.0 * 1024.0},
126 : {"kB", GUC_UNIT_BYTE, 1024.0},
127 : {"B", GUC_UNIT_BYTE, 1.0},
128 :
129 : {"TB", GUC_UNIT_KB, 1024.0 * 1024.0 * 1024.0},
130 : {"GB", GUC_UNIT_KB, 1024.0 * 1024.0},
131 : {"MB", GUC_UNIT_KB, 1024.0},
132 : {"kB", GUC_UNIT_KB, 1.0},
133 : {"B", GUC_UNIT_KB, 1.0 / 1024.0},
134 :
135 : {"TB", GUC_UNIT_MB, 1024.0 * 1024.0},
136 : {"GB", GUC_UNIT_MB, 1024.0},
137 : {"MB", GUC_UNIT_MB, 1.0},
138 : {"kB", GUC_UNIT_MB, 1.0 / 1024.0},
139 : {"B", GUC_UNIT_MB, 1.0 / (1024.0 * 1024.0)},
140 :
141 : {"TB", GUC_UNIT_BLOCKS, (1024.0 * 1024.0 * 1024.0) / (BLCKSZ / 1024)},
142 : {"GB", GUC_UNIT_BLOCKS, (1024.0 * 1024.0) / (BLCKSZ / 1024)},
143 : {"MB", GUC_UNIT_BLOCKS, 1024.0 / (BLCKSZ / 1024)},
144 : {"kB", GUC_UNIT_BLOCKS, 1.0 / (BLCKSZ / 1024)},
145 : {"B", GUC_UNIT_BLOCKS, 1.0 / BLCKSZ},
146 :
147 : {"TB", GUC_UNIT_XBLOCKS, (1024.0 * 1024.0 * 1024.0) / (XLOG_BLCKSZ / 1024)},
148 : {"GB", GUC_UNIT_XBLOCKS, (1024.0 * 1024.0) / (XLOG_BLCKSZ / 1024)},
149 : {"MB", GUC_UNIT_XBLOCKS, 1024.0 / (XLOG_BLCKSZ / 1024)},
150 : {"kB", GUC_UNIT_XBLOCKS, 1.0 / (XLOG_BLCKSZ / 1024)},
151 : {"B", GUC_UNIT_XBLOCKS, 1.0 / XLOG_BLCKSZ},
152 :
153 : {""} /* end of table marker */
154 : };
155 :
156 : static const char *const time_units_hint = gettext_noop("Valid units for this parameter are \"us\", \"ms\", \"s\", \"min\", \"h\", and \"d\".");
157 :
158 : static const unit_conversion time_unit_conversion_table[] =
159 : {
160 : {"d", GUC_UNIT_MS, 1000 * 60 * 60 * 24},
161 : {"h", GUC_UNIT_MS, 1000 * 60 * 60},
162 : {"min", GUC_UNIT_MS, 1000 * 60},
163 : {"s", GUC_UNIT_MS, 1000},
164 : {"ms", GUC_UNIT_MS, 1},
165 : {"us", GUC_UNIT_MS, 1.0 / 1000},
166 :
167 : {"d", GUC_UNIT_S, 60 * 60 * 24},
168 : {"h", GUC_UNIT_S, 60 * 60},
169 : {"min", GUC_UNIT_S, 60},
170 : {"s", GUC_UNIT_S, 1},
171 : {"ms", GUC_UNIT_S, 1.0 / 1000},
172 : {"us", GUC_UNIT_S, 1.0 / (1000 * 1000)},
173 :
174 : {"d", GUC_UNIT_MIN, 60 * 24},
175 : {"h", GUC_UNIT_MIN, 60},
176 : {"min", GUC_UNIT_MIN, 1},
177 : {"s", GUC_UNIT_MIN, 1.0 / 60},
178 : {"ms", GUC_UNIT_MIN, 1.0 / (1000 * 60)},
179 : {"us", GUC_UNIT_MIN, 1.0 / (1000 * 1000 * 60)},
180 :
181 : {""} /* end of table marker */
182 : };
183 :
184 : /*
185 : * To allow continued support of obsolete names for GUC variables, we apply
186 : * the following mappings to any unrecognized name. Note that an old name
187 : * should be mapped to a new one only if the new variable has very similar
188 : * semantics to the old.
189 : */
190 : static const char *const map_old_guc_names[] = {
191 : "sort_mem", "work_mem",
192 : "vacuum_mem", "maintenance_work_mem",
193 : "ssl_ecdh_curve", "ssl_groups",
194 : NULL
195 : };
196 :
197 :
198 : /* Memory context holding all GUC-related data */
199 : static MemoryContext GUCMemoryContext;
200 :
201 : /*
202 : * We use a dynahash table to look up GUCs by name, or to iterate through
203 : * all the GUCs. The gucname field is redundant with gucvar->name, but
204 : * dynahash makes it too painful to not store the hash key separately.
205 : */
206 : typedef struct
207 : {
208 : const char *gucname; /* hash key */
209 : struct config_generic *gucvar; /* -> GUC's defining structure */
210 : } GUCHashEntry;
211 :
212 : static HTAB *guc_hashtab; /* entries are GUCHashEntrys */
213 :
214 : /*
215 : * In addition to the hash table, variables having certain properties are
216 : * linked into these lists, so that we can find them without scanning the
217 : * whole hash table. In most applications, only a small fraction of the
218 : * GUCs appear in these lists at any given time. The usage of the stack
219 : * and report lists is stylized enough that they can be slists, but the
220 : * nondef list has to be a dlist to avoid O(N) deletes in common cases.
221 : */
222 : static dlist_head guc_nondef_list; /* list of variables that have source
223 : * different from PGC_S_DEFAULT */
224 : static slist_head guc_stack_list; /* list of variables that have non-NULL
225 : * stack */
226 : static slist_head guc_report_list; /* list of variables that have the
227 : * GUC_NEEDS_REPORT bit set in status */
228 :
229 : static bool reporting_enabled; /* true to enable GUC_REPORT */
230 :
231 : static int GUCNestLevel = 0; /* 1 when in main transaction */
232 :
233 :
234 : static int guc_var_compare(const void *a, const void *b);
235 : static uint32 guc_name_hash(const void *key, Size keysize);
236 : static int guc_name_match(const void *key1, const void *key2, Size keysize);
237 : static void InitializeGUCOptionsFromEnvironment(void);
238 : static void InitializeOneGUCOption(struct config_generic *gconf);
239 : static void RemoveGUCFromLists(struct config_generic *gconf);
240 : static void set_guc_source(struct config_generic *gconf, GucSource newsource);
241 : static void pg_timezone_abbrev_initialize(void);
242 : static void push_old_value(struct config_generic *gconf, GucAction action);
243 : static void ReportGUCOption(struct config_generic *record);
244 : static void set_config_sourcefile(const char *name, char *sourcefile,
245 : int sourceline);
246 : static void reapply_stacked_values(struct config_generic *variable,
247 : struct config_string *pHolder,
248 : GucStack *stack,
249 : const char *curvalue,
250 : GucContext curscontext, GucSource cursource,
251 : Oid cursrole);
252 : static void free_placeholder(struct config_string *pHolder);
253 : static bool validate_option_array_item(const char *name, const char *value,
254 : bool skipIfNoPermissions);
255 : static void write_auto_conf_file(int fd, const char *filename, ConfigVariable *head);
256 : static void replace_auto_config_value(ConfigVariable **head_p, ConfigVariable **tail_p,
257 : const char *name, const char *value);
258 : static bool valid_custom_variable_name(const char *name);
259 : static bool assignable_custom_variable_name(const char *name, bool skip_errors,
260 : int elevel);
261 : static void do_serialize(char **destptr, Size *maxbytes,
262 : const char *fmt,...) pg_attribute_printf(3, 4);
263 : static bool call_bool_check_hook(struct config_bool *conf, bool *newval,
264 : void **extra, GucSource source, int elevel);
265 : static bool call_int_check_hook(struct config_int *conf, int *newval,
266 : void **extra, GucSource source, int elevel);
267 : static bool call_real_check_hook(struct config_real *conf, double *newval,
268 : void **extra, GucSource source, int elevel);
269 : static bool call_string_check_hook(struct config_string *conf, char **newval,
270 : void **extra, GucSource source, int elevel);
271 : static bool call_enum_check_hook(struct config_enum *conf, int *newval,
272 : void **extra, GucSource source, int elevel);
273 :
274 :
275 : /*
276 : * This function handles both actual config file (re)loads and execution of
277 : * show_all_file_settings() (i.e., the pg_file_settings view). In the latter
278 : * case we don't apply any of the settings, but we make all the usual validity
279 : * checks, and we return the ConfigVariable list so that it can be printed out
280 : * by show_all_file_settings().
281 : */
282 : ConfigVariable *
283 5822 : ProcessConfigFileInternal(GucContext context, bool applySettings, int elevel)
284 : {
285 5822 : bool error = false;
286 5822 : bool applying = false;
287 : const char *ConfFileWithError;
288 : ConfigVariable *item,
289 : *head,
290 : *tail;
291 : HASH_SEQ_STATUS status;
292 : GUCHashEntry *hentry;
293 :
294 : /* Parse the main config file into a list of option names and values */
295 5822 : ConfFileWithError = ConfigFileName;
296 5822 : head = tail = NULL;
297 :
298 5822 : if (!ParseConfigFile(ConfigFileName, true,
299 : NULL, 0, CONF_FILE_START_DEPTH, elevel,
300 : &head, &tail))
301 : {
302 : /* Syntax error(s) detected in the file, so bail out */
303 0 : error = true;
304 0 : goto bail_out;
305 : }
306 :
307 : /*
308 : * Parse the PG_AUTOCONF_FILENAME file, if present, after the main file to
309 : * replace any parameters set by ALTER SYSTEM command. Because this file
310 : * is in the data directory, we can't read it until the DataDir has been
311 : * set.
312 : */
313 5822 : if (DataDir)
314 : {
315 3618 : if (!ParseConfigFile(PG_AUTOCONF_FILENAME, false,
316 : NULL, 0, CONF_FILE_START_DEPTH, elevel,
317 : &head, &tail))
318 : {
319 : /* Syntax error(s) detected in the file, so bail out */
320 0 : error = true;
321 0 : ConfFileWithError = PG_AUTOCONF_FILENAME;
322 0 : goto bail_out;
323 : }
324 : }
325 : else
326 : {
327 : /*
328 : * If DataDir is not set, the PG_AUTOCONF_FILENAME file cannot be
329 : * read. In this case, we don't want to accept any settings but
330 : * data_directory from postgresql.conf, because they might be
331 : * overwritten with settings in the PG_AUTOCONF_FILENAME file which
332 : * will be read later. OTOH, since data_directory isn't allowed in the
333 : * PG_AUTOCONF_FILENAME file, it will never be overwritten later.
334 : */
335 2204 : ConfigVariable *newlist = NULL;
336 :
337 : /*
338 : * Prune all items except the last "data_directory" from the list.
339 : */
340 60336 : for (item = head; item; item = item->next)
341 : {
342 58132 : if (!item->ignore &&
343 58132 : strcmp(item->name, "data_directory") == 0)
344 0 : newlist = item;
345 : }
346 :
347 2204 : if (newlist)
348 0 : newlist->next = NULL;
349 2204 : head = tail = newlist;
350 :
351 : /*
352 : * Quick exit if data_directory is not present in file.
353 : *
354 : * We need not do any further processing, in particular we don't set
355 : * PgReloadTime; that will be set soon by subsequent full loading of
356 : * the config file.
357 : */
358 2204 : if (head == NULL)
359 2204 : goto bail_out;
360 : }
361 :
362 : /*
363 : * Mark all extant GUC variables as not present in the config file. We
364 : * need this so that we can tell below which ones have been removed from
365 : * the file since we last processed it.
366 : */
367 3618 : hash_seq_init(&status, guc_hashtab);
368 1476270 : while ((hentry = (GUCHashEntry *) hash_seq_search(&status)) != NULL)
369 : {
370 1472652 : struct config_generic *gconf = hentry->gucvar;
371 :
372 1472652 : gconf->status &= ~GUC_IS_IN_FILE;
373 : }
374 :
375 : /*
376 : * Check if all the supplied option names are valid, as an additional
377 : * quasi-syntactic check on the validity of the config file. It is
378 : * important that the postmaster and all backends agree on the results of
379 : * this phase, else we will have strange inconsistencies about which
380 : * processes accept a config file update and which don't. Hence, unknown
381 : * custom variable names have to be accepted without complaint. For the
382 : * same reason, we don't attempt to validate the options' values here.
383 : *
384 : * In addition, the GUC_IS_IN_FILE flag is set on each existing GUC
385 : * variable mentioned in the file; and we detect duplicate entries in the
386 : * file and mark the earlier occurrences as ignorable.
387 : */
388 110750 : for (item = head; item; item = item->next)
389 : {
390 : struct config_generic *record;
391 :
392 : /* Ignore anything already marked as ignorable */
393 107132 : if (item->ignore)
394 0 : continue;
395 :
396 : /*
397 : * Try to find the variable; but do not create a custom placeholder if
398 : * it's not there already.
399 : */
400 107132 : record = find_option(item->name, false, true, elevel);
401 :
402 107132 : if (record)
403 : {
404 : /* If it's already marked, then this is a duplicate entry */
405 107068 : if (record->status & GUC_IS_IN_FILE)
406 : {
407 : /*
408 : * Mark the earlier occurrence(s) as dead/ignorable. We could
409 : * avoid the O(N^2) behavior here with some additional state,
410 : * but it seems unlikely to be worth the trouble.
411 : */
412 : ConfigVariable *pitem;
413 :
414 377280 : for (pitem = head; pitem != item; pitem = pitem->next)
415 : {
416 365500 : if (!pitem->ignore &&
417 324272 : strcmp(pitem->name, item->name) == 0)
418 11780 : pitem->ignore = true;
419 : }
420 : }
421 : /* Now mark it as present in file */
422 107068 : record->status |= GUC_IS_IN_FILE;
423 : }
424 64 : else if (!valid_custom_variable_name(item->name))
425 : {
426 : /* Invalid non-custom variable, so complain */
427 2 : ereport(elevel,
428 : (errcode(ERRCODE_UNDEFINED_OBJECT),
429 : errmsg("unrecognized configuration parameter \"%s\" in file \"%s\" line %d",
430 : item->name,
431 : item->filename, item->sourceline)));
432 2 : item->errmsg = pstrdup("unrecognized configuration parameter");
433 2 : error = true;
434 2 : ConfFileWithError = item->filename;
435 : }
436 : }
437 :
438 : /*
439 : * If we've detected any errors so far, we don't want to risk applying any
440 : * changes.
441 : */
442 3618 : if (error)
443 2 : goto bail_out;
444 :
445 : /* Otherwise, set flag that we're beginning to apply changes */
446 3616 : applying = true;
447 :
448 : /*
449 : * Check for variables having been removed from the config file, and
450 : * revert their reset values (and perhaps also effective values) to the
451 : * boot-time defaults. If such a variable can't be changed after startup,
452 : * report that and continue.
453 : */
454 3616 : hash_seq_init(&status, guc_hashtab);
455 1475454 : while ((hentry = (GUCHashEntry *) hash_seq_search(&status)) != NULL)
456 : {
457 1471838 : struct config_generic *gconf = hentry->gucvar;
458 : GucStack *stack;
459 :
460 1471838 : if (gconf->reset_source != PGC_S_FILE ||
461 41768 : (gconf->status & GUC_IS_IN_FILE))
462 1471834 : continue;
463 4 : if (gconf->context < PGC_SIGHUP)
464 : {
465 : /* The removal can't be effective without a restart */
466 0 : gconf->status |= GUC_PENDING_RESTART;
467 0 : ereport(elevel,
468 : (errcode(ERRCODE_CANT_CHANGE_RUNTIME_PARAM),
469 : errmsg("parameter \"%s\" cannot be changed without restarting the server",
470 : gconf->name)));
471 0 : record_config_file_error(psprintf("parameter \"%s\" cannot be changed without restarting the server",
472 : gconf->name),
473 : NULL, 0,
474 : &head, &tail);
475 0 : error = true;
476 0 : continue;
477 : }
478 :
479 : /* No more to do if we're just doing show_all_file_settings() */
480 4 : if (!applySettings)
481 0 : continue;
482 :
483 : /*
484 : * Reset any "file" sources to "default", else set_config_option will
485 : * not override those settings.
486 : */
487 4 : if (gconf->reset_source == PGC_S_FILE)
488 4 : gconf->reset_source = PGC_S_DEFAULT;
489 4 : if (gconf->source == PGC_S_FILE)
490 4 : set_guc_source(gconf, PGC_S_DEFAULT);
491 4 : for (stack = gconf->stack; stack; stack = stack->prev)
492 : {
493 0 : if (stack->source == PGC_S_FILE)
494 0 : stack->source = PGC_S_DEFAULT;
495 : }
496 :
497 : /* Now we can re-apply the wired-in default (i.e., the boot_val) */
498 4 : if (set_config_option(gconf->name, NULL,
499 : context, PGC_S_DEFAULT,
500 : GUC_ACTION_SET, true, 0, false) > 0)
501 : {
502 : /* Log the change if appropriate */
503 4 : if (context == PGC_SIGHUP)
504 4 : ereport(elevel,
505 : (errmsg("parameter \"%s\" removed from configuration file, reset to default",
506 : gconf->name)));
507 : }
508 : }
509 :
510 : /*
511 : * Restore any variables determined by environment variables or
512 : * dynamically-computed defaults. This is a no-op except in the case
513 : * where one of these had been in the config file and is now removed.
514 : *
515 : * In particular, we *must not* do this during the postmaster's initial
516 : * loading of the file, since the timezone functions in particular should
517 : * be run only after initialization is complete.
518 : *
519 : * XXX this is an unmaintainable crock, because we have to know how to set
520 : * (or at least what to call to set) every non-PGC_INTERNAL variable that
521 : * could potentially have PGC_S_DYNAMIC_DEFAULT or PGC_S_ENV_VAR source.
522 : */
523 3616 : if (context == PGC_SIGHUP && applySettings)
524 : {
525 1408 : InitializeGUCOptionsFromEnvironment();
526 1408 : pg_timezone_abbrev_initialize();
527 : /* this selects SQL_ASCII in processes not connected to a database */
528 1408 : SetConfigOption("client_encoding", GetDatabaseEncodingName(),
529 : PGC_BACKEND, PGC_S_DYNAMIC_DEFAULT);
530 : }
531 :
532 : /*
533 : * Now apply the values from the config file.
534 : */
535 110716 : for (item = head; item; item = item->next)
536 : {
537 107102 : char *pre_value = NULL;
538 : int scres;
539 :
540 : /* Ignore anything marked as ignorable */
541 107102 : if (item->ignore)
542 11780 : continue;
543 :
544 : /* In SIGHUP cases in the postmaster, we want to report changes */
545 95322 : if (context == PGC_SIGHUP && applySettings && !IsUnderPostmaster)
546 : {
547 8046 : const char *preval = GetConfigOption(item->name, true, false);
548 :
549 : /* If option doesn't exist yet or is NULL, treat as empty string */
550 8046 : if (!preval)
551 2 : preval = "";
552 : /* must dup, else might have dangling pointer below */
553 8046 : pre_value = pstrdup(preval);
554 : }
555 :
556 95322 : scres = set_config_option(item->name, item->value,
557 : context, PGC_S_FILE,
558 : GUC_ACTION_SET, applySettings, 0, false);
559 95320 : if (scres > 0)
560 : {
561 : /* variable was updated, so log the change if appropriate */
562 78982 : if (pre_value)
563 : {
564 5082 : const char *post_value = GetConfigOption(item->name, true, false);
565 :
566 5082 : if (!post_value)
567 0 : post_value = "";
568 5082 : if (strcmp(pre_value, post_value) != 0)
569 204 : ereport(elevel,
570 : (errmsg("parameter \"%s\" changed to \"%s\"",
571 : item->name, item->value)));
572 : }
573 78982 : item->applied = true;
574 : }
575 16338 : else if (scres == 0)
576 : {
577 6 : error = true;
578 6 : item->errmsg = pstrdup("setting could not be applied");
579 6 : ConfFileWithError = item->filename;
580 : }
581 : else
582 : {
583 : /* no error, but variable's active value was not changed */
584 16332 : item->applied = true;
585 : }
586 :
587 : /*
588 : * We should update source location unless there was an error, since
589 : * even if the active value didn't change, the reset value might have.
590 : * (In the postmaster, there won't be a difference, but it does matter
591 : * in backends.)
592 : */
593 95320 : if (scres != 0 && applySettings)
594 95154 : set_config_sourcefile(item->name, item->filename,
595 : item->sourceline);
596 :
597 95320 : if (pre_value)
598 8046 : pfree(pre_value);
599 : }
600 :
601 : /* Remember when we last successfully loaded the config file. */
602 3614 : if (applySettings)
603 3608 : PgReloadTime = GetCurrentTimestamp();
604 :
605 6 : bail_out:
606 5820 : if (error && applySettings)
607 : {
608 : /* During postmaster startup, any error is fatal */
609 8 : if (context == PGC_POSTMASTER)
610 8 : ereport(ERROR,
611 : (errcode(ERRCODE_CONFIG_FILE_ERROR),
612 : errmsg("configuration file \"%s\" contains errors",
613 : ConfFileWithError)));
614 0 : else if (applying)
615 0 : ereport(elevel,
616 : (errcode(ERRCODE_CONFIG_FILE_ERROR),
617 : errmsg("configuration file \"%s\" contains errors; unaffected changes were applied",
618 : ConfFileWithError)));
619 : else
620 0 : ereport(elevel,
621 : (errcode(ERRCODE_CONFIG_FILE_ERROR),
622 : errmsg("configuration file \"%s\" contains errors; no changes were applied",
623 : ConfFileWithError)));
624 : }
625 :
626 : /* Successful or otherwise, return the collected data list */
627 5812 : return head;
628 : }
629 :
630 :
631 : /*
632 : * Some infrastructure for GUC-related memory allocation
633 : *
634 : * These functions are generally modeled on libc's malloc/realloc/etc,
635 : * but any OOM issue is reported at the specified elevel.
636 : * (Thus, control returns only if that's less than ERROR.)
637 : */
638 : void *
639 1781402 : guc_malloc(int elevel, size_t size)
640 : {
641 : void *data;
642 :
643 1781402 : data = MemoryContextAllocExtended(GUCMemoryContext, size,
644 : MCXT_ALLOC_NO_OOM);
645 1781402 : if (unlikely(data == NULL))
646 0 : ereport(elevel,
647 : (errcode(ERRCODE_OUT_OF_MEMORY),
648 : errmsg("out of memory")));
649 1781402 : return data;
650 : }
651 :
652 : void *
653 0 : guc_realloc(int elevel, void *old, size_t size)
654 : {
655 : void *data;
656 :
657 0 : if (old != NULL)
658 : {
659 : /* This is to help catch old code that malloc's GUC data. */
660 : Assert(GetMemoryChunkContext(old) == GUCMemoryContext);
661 0 : data = repalloc_extended(old, size,
662 : MCXT_ALLOC_NO_OOM);
663 : }
664 : else
665 : {
666 : /* Like realloc(3), but not like repalloc(), we allow old == NULL. */
667 0 : data = MemoryContextAllocExtended(GUCMemoryContext, size,
668 : MCXT_ALLOC_NO_OOM);
669 : }
670 0 : if (unlikely(data == NULL))
671 0 : ereport(elevel,
672 : (errcode(ERRCODE_OUT_OF_MEMORY),
673 : errmsg("out of memory")));
674 0 : return data;
675 : }
676 :
677 : char *
678 1522232 : guc_strdup(int elevel, const char *src)
679 : {
680 : char *data;
681 1522232 : size_t len = strlen(src) + 1;
682 :
683 1522232 : data = guc_malloc(elevel, len);
684 1522232 : if (likely(data != NULL))
685 1522232 : memcpy(data, src, len);
686 1522232 : return data;
687 : }
688 :
689 : void
690 1649310 : guc_free(void *ptr)
691 : {
692 : /*
693 : * Historically, GUC-related code has relied heavily on the ability to do
694 : * free(NULL), so we allow that here even though pfree() doesn't.
695 : */
696 1649310 : if (ptr != NULL)
697 : {
698 : /* This is to help catch old code that malloc's GUC data. */
699 : Assert(GetMemoryChunkContext(ptr) == GUCMemoryContext);
700 1021144 : pfree(ptr);
701 : }
702 1649310 : }
703 :
704 :
705 : /*
706 : * Detect whether strval is referenced anywhere in a GUC string item
707 : */
708 : static bool
709 2512026 : string_field_used(struct config_string *conf, char *strval)
710 : {
711 : GucStack *stack;
712 :
713 2512026 : if (strval == *(conf->variable) ||
714 1368870 : strval == conf->reset_val ||
715 758966 : strval == conf->boot_val)
716 1753060 : return true;
717 1217488 : for (stack = conf->gen.stack; stack; stack = stack->prev)
718 : {
719 541280 : if (strval == stack->prior.val.stringval ||
720 458528 : strval == stack->masked.val.stringval)
721 82758 : return true;
722 : }
723 676208 : return false;
724 : }
725 :
726 : /*
727 : * Support for assigning to a field of a string GUC item. Free the prior
728 : * value if it's not referenced anywhere else in the item (including stacked
729 : * states).
730 : */
731 : static void
732 2720784 : set_string_field(struct config_string *conf, char **field, char *newval)
733 : {
734 2720784 : char *oldval = *field;
735 :
736 : /* Do the assignment */
737 2720784 : *field = newval;
738 :
739 : /* Free old value if it's not NULL and isn't referenced anymore */
740 2720784 : if (oldval && !string_field_used(conf, oldval))
741 671720 : guc_free(oldval);
742 2720784 : }
743 :
744 : /*
745 : * Detect whether an "extra" struct is referenced anywhere in a GUC item
746 : */
747 : static bool
748 423266 : extra_field_used(struct config_generic *gconf, void *extra)
749 : {
750 : GucStack *stack;
751 :
752 423266 : if (extra == gconf->extra)
753 170528 : return true;
754 252738 : switch (gconf->vartype)
755 : {
756 0 : case PGC_BOOL:
757 0 : if (extra == ((struct config_bool *) gconf)->reset_extra)
758 0 : return true;
759 0 : break;
760 0 : case PGC_INT:
761 0 : if (extra == ((struct config_int *) gconf)->reset_extra)
762 0 : return true;
763 0 : break;
764 0 : case PGC_REAL:
765 0 : if (extra == ((struct config_real *) gconf)->reset_extra)
766 0 : return true;
767 0 : break;
768 252738 : case PGC_STRING:
769 252738 : if (extra == ((struct config_string *) gconf)->reset_extra)
770 124302 : return true;
771 128436 : break;
772 0 : case PGC_ENUM:
773 0 : if (extra == ((struct config_enum *) gconf)->reset_extra)
774 0 : return true;
775 0 : break;
776 : }
777 143380 : for (stack = gconf->stack; stack; stack = stack->prev)
778 : {
779 20996 : if (extra == stack->prior.extra ||
780 14950 : extra == stack->masked.extra)
781 6052 : return true;
782 : }
783 :
784 122384 : return false;
785 : }
786 :
787 : /*
788 : * Support for assigning to an "extra" field of a GUC item. Free the prior
789 : * value if it's not referenced anywhere else in the item (including stacked
790 : * states).
791 : */
792 : static void
793 3525264 : set_extra_field(struct config_generic *gconf, void **field, void *newval)
794 : {
795 3525264 : void *oldval = *field;
796 :
797 : /* Do the assignment */
798 3525264 : *field = newval;
799 :
800 : /* Free old value if it's not NULL and isn't referenced anymore */
801 3525264 : if (oldval && !extra_field_used(gconf, oldval))
802 121892 : guc_free(oldval);
803 3525264 : }
804 :
805 : /*
806 : * Support for copying a variable's active value into a stack entry.
807 : * The "extra" field associated with the active value is copied, too.
808 : *
809 : * NB: be sure stringval and extra fields of a new stack entry are
810 : * initialized to NULL before this is used, else we'll try to guc_free() them.
811 : */
812 : static void
813 503318 : set_stack_value(struct config_generic *gconf, config_var_value *val)
814 : {
815 503318 : switch (gconf->vartype)
816 : {
817 17842 : case PGC_BOOL:
818 17842 : val->val.boolval =
819 17842 : *((struct config_bool *) gconf)->variable;
820 17842 : break;
821 21446 : case PGC_INT:
822 21446 : val->val.intval =
823 21446 : *((struct config_int *) gconf)->variable;
824 21446 : break;
825 8350 : case PGC_REAL:
826 8350 : val->val.realval =
827 8350 : *((struct config_real *) gconf)->variable;
828 8350 : break;
829 435382 : case PGC_STRING:
830 435382 : set_string_field((struct config_string *) gconf,
831 : &(val->val.stringval),
832 435382 : *((struct config_string *) gconf)->variable);
833 435382 : break;
834 20298 : case PGC_ENUM:
835 20298 : val->val.enumval =
836 20298 : *((struct config_enum *) gconf)->variable;
837 20298 : break;
838 : }
839 503318 : set_extra_field(gconf, &(val->extra), gconf->extra);
840 503318 : }
841 :
842 : /*
843 : * Support for discarding a no-longer-needed value in a stack entry.
844 : * The "extra" field associated with the stack entry is cleared, too.
845 : */
846 : static void
847 54680 : discard_stack_value(struct config_generic *gconf, config_var_value *val)
848 : {
849 54680 : switch (gconf->vartype)
850 : {
851 35948 : case PGC_BOOL:
852 : case PGC_INT:
853 : case PGC_REAL:
854 : case PGC_ENUM:
855 : /* no need to do anything */
856 35948 : break;
857 18732 : case PGC_STRING:
858 18732 : set_string_field((struct config_string *) gconf,
859 : &(val->val.stringval),
860 : NULL);
861 18732 : break;
862 : }
863 54680 : set_extra_field(gconf, &(val->extra), NULL);
864 54680 : }
865 :
866 :
867 : /*
868 : * Fetch a palloc'd, sorted array of GUC struct pointers
869 : *
870 : * The array length is returned into *num_vars.
871 : */
872 : struct config_generic **
873 3468 : get_guc_variables(int *num_vars)
874 : {
875 : struct config_generic **result;
876 : HASH_SEQ_STATUS status;
877 : GUCHashEntry *hentry;
878 : int i;
879 :
880 3468 : *num_vars = hash_get_num_entries(guc_hashtab);
881 3468 : result = palloc(sizeof(struct config_generic *) * *num_vars);
882 :
883 : /* Extract pointers from the hash table */
884 3468 : i = 0;
885 3468 : hash_seq_init(&status, guc_hashtab);
886 1429942 : while ((hentry = (GUCHashEntry *) hash_seq_search(&status)) != NULL)
887 1426474 : result[i++] = hentry->gucvar;
888 : Assert(i == *num_vars);
889 :
890 : /* Sort by name */
891 3468 : qsort(result, *num_vars,
892 : sizeof(struct config_generic *), guc_var_compare);
893 :
894 3468 : return result;
895 : }
896 :
897 :
898 : /*
899 : * Build the GUC hash table. This is split out so that help_config.c can
900 : * extract all the variables without running all of InitializeGUCOptions.
901 : * It's not meant for use anyplace else.
902 : */
903 : void
904 2256 : build_guc_variables(void)
905 : {
906 : int size_vars;
907 2256 : int num_vars = 0;
908 : HASHCTL hash_ctl;
909 : GUCHashEntry *hentry;
910 : bool found;
911 : int i;
912 :
913 : /*
914 : * Create the memory context that will hold all GUC-related data.
915 : */
916 : Assert(GUCMemoryContext == NULL);
917 2256 : GUCMemoryContext = AllocSetContextCreate(TopMemoryContext,
918 : "GUCMemoryContext",
919 : ALLOCSET_DEFAULT_SIZES);
920 :
921 : /*
922 : * Count all the built-in variables, and set their vartypes correctly.
923 : */
924 270720 : for (i = 0; ConfigureNamesBool[i].gen.name; i++)
925 : {
926 268464 : struct config_bool *conf = &ConfigureNamesBool[i];
927 :
928 : /* Rather than requiring vartype to be filled in by hand, do this: */
929 268464 : conf->gen.vartype = PGC_BOOL;
930 268464 : num_vars++;
931 : }
932 :
933 333888 : for (i = 0; ConfigureNamesInt[i].gen.name; i++)
934 : {
935 331632 : struct config_int *conf = &ConfigureNamesInt[i];
936 :
937 331632 : conf->gen.vartype = PGC_INT;
938 331632 : num_vars++;
939 : }
940 :
941 60912 : for (i = 0; ConfigureNamesReal[i].gen.name; i++)
942 : {
943 58656 : struct config_real *conf = &ConfigureNamesReal[i];
944 :
945 58656 : conf->gen.vartype = PGC_REAL;
946 58656 : num_vars++;
947 : }
948 :
949 171456 : for (i = 0; ConfigureNamesString[i].gen.name; i++)
950 : {
951 169200 : struct config_string *conf = &ConfigureNamesString[i];
952 :
953 169200 : conf->gen.vartype = PGC_STRING;
954 169200 : num_vars++;
955 : }
956 :
957 92496 : for (i = 0; ConfigureNamesEnum[i].gen.name; i++)
958 : {
959 90240 : struct config_enum *conf = &ConfigureNamesEnum[i];
960 :
961 90240 : conf->gen.vartype = PGC_ENUM;
962 90240 : num_vars++;
963 : }
964 :
965 : /*
966 : * Create hash table with 20% slack
967 : */
968 2256 : size_vars = num_vars + num_vars / 4;
969 :
970 2256 : hash_ctl.keysize = sizeof(char *);
971 2256 : hash_ctl.entrysize = sizeof(GUCHashEntry);
972 2256 : hash_ctl.hash = guc_name_hash;
973 2256 : hash_ctl.match = guc_name_match;
974 2256 : hash_ctl.hcxt = GUCMemoryContext;
975 2256 : guc_hashtab = hash_create("GUC hash table",
976 : size_vars,
977 : &hash_ctl,
978 : HASH_ELEM | HASH_FUNCTION | HASH_COMPARE | HASH_CONTEXT);
979 :
980 270720 : for (i = 0; ConfigureNamesBool[i].gen.name; i++)
981 : {
982 268464 : struct config_generic *gucvar = &ConfigureNamesBool[i].gen;
983 :
984 268464 : hentry = (GUCHashEntry *) hash_search(guc_hashtab,
985 268464 : &gucvar->name,
986 : HASH_ENTER,
987 : &found);
988 : Assert(!found);
989 268464 : hentry->gucvar = gucvar;
990 : }
991 :
992 333888 : for (i = 0; ConfigureNamesInt[i].gen.name; i++)
993 : {
994 331632 : struct config_generic *gucvar = &ConfigureNamesInt[i].gen;
995 :
996 331632 : hentry = (GUCHashEntry *) hash_search(guc_hashtab,
997 331632 : &gucvar->name,
998 : HASH_ENTER,
999 : &found);
1000 : Assert(!found);
1001 331632 : hentry->gucvar = gucvar;
1002 : }
1003 :
1004 60912 : for (i = 0; ConfigureNamesReal[i].gen.name; i++)
1005 : {
1006 58656 : struct config_generic *gucvar = &ConfigureNamesReal[i].gen;
1007 :
1008 58656 : hentry = (GUCHashEntry *) hash_search(guc_hashtab,
1009 58656 : &gucvar->name,
1010 : HASH_ENTER,
1011 : &found);
1012 : Assert(!found);
1013 58656 : hentry->gucvar = gucvar;
1014 : }
1015 :
1016 171456 : for (i = 0; ConfigureNamesString[i].gen.name; i++)
1017 : {
1018 169200 : struct config_generic *gucvar = &ConfigureNamesString[i].gen;
1019 :
1020 169200 : hentry = (GUCHashEntry *) hash_search(guc_hashtab,
1021 169200 : &gucvar->name,
1022 : HASH_ENTER,
1023 : &found);
1024 : Assert(!found);
1025 169200 : hentry->gucvar = gucvar;
1026 : }
1027 :
1028 92496 : for (i = 0; ConfigureNamesEnum[i].gen.name; i++)
1029 : {
1030 90240 : struct config_generic *gucvar = &ConfigureNamesEnum[i].gen;
1031 :
1032 90240 : hentry = (GUCHashEntry *) hash_search(guc_hashtab,
1033 90240 : &gucvar->name,
1034 : HASH_ENTER,
1035 : &found);
1036 : Assert(!found);
1037 90240 : hentry->gucvar = gucvar;
1038 : }
1039 :
1040 : Assert(num_vars == hash_get_num_entries(guc_hashtab));
1041 2256 : }
1042 :
1043 : /*
1044 : * Add a new GUC variable to the hash of known variables. The
1045 : * hash is expanded if needed.
1046 : */
1047 : static bool
1048 18584 : add_guc_variable(struct config_generic *var, int elevel)
1049 : {
1050 : GUCHashEntry *hentry;
1051 : bool found;
1052 :
1053 18584 : hentry = (GUCHashEntry *) hash_search(guc_hashtab,
1054 18584 : &var->name,
1055 : HASH_ENTER_NULL,
1056 : &found);
1057 18584 : if (unlikely(hentry == NULL))
1058 : {
1059 0 : ereport(elevel,
1060 : (errcode(ERRCODE_OUT_OF_MEMORY),
1061 : errmsg("out of memory")));
1062 0 : return false; /* out of memory */
1063 : }
1064 : Assert(!found);
1065 18584 : hentry->gucvar = var;
1066 18584 : return true;
1067 : }
1068 :
1069 : /*
1070 : * Decide whether a proposed custom variable name is allowed.
1071 : *
1072 : * It must be two or more identifiers separated by dots, where the rules
1073 : * for what is an identifier agree with scan.l. (If you change this rule,
1074 : * adjust the errdetail in assignable_custom_variable_name().)
1075 : */
1076 : static bool
1077 270 : valid_custom_variable_name(const char *name)
1078 : {
1079 270 : bool saw_sep = false;
1080 270 : bool name_start = true;
1081 :
1082 5130 : for (const char *p = name; *p; p++)
1083 : {
1084 4872 : if (*p == GUC_QUALIFIER_SEPARATOR)
1085 : {
1086 242 : if (name_start)
1087 0 : return false; /* empty name component */
1088 242 : saw_sep = true;
1089 242 : name_start = true;
1090 : }
1091 4630 : else if (strchr("ABCDEFGHIJKLMNOPQRSTUVWXYZ"
1092 4630 : "abcdefghijklmnopqrstuvwxyz_", *p) != NULL ||
1093 16 : IS_HIGHBIT_SET(*p))
1094 : {
1095 : /* okay as first or non-first character */
1096 4614 : name_start = false;
1097 : }
1098 16 : else if (!name_start && strchr("0123456789$", *p) != NULL)
1099 : /* okay as non-first character */ ;
1100 : else
1101 12 : return false;
1102 : }
1103 258 : if (name_start)
1104 0 : return false; /* empty name component */
1105 : /* OK if we found at least one separator */
1106 258 : return saw_sep;
1107 : }
1108 :
1109 : /*
1110 : * Decide whether an unrecognized variable name is allowed to be SET.
1111 : *
1112 : * It must pass the syntactic rules of valid_custom_variable_name(),
1113 : * and it must not be in any namespace already reserved by an extension.
1114 : * (We make this separate from valid_custom_variable_name() because we don't
1115 : * apply the reserved-namespace test when reading configuration files.)
1116 : *
1117 : * If valid, return true. Otherwise, return false if skip_errors is true,
1118 : * else throw a suitable error at the specified elevel (and return false
1119 : * if that's less than ERROR).
1120 : */
1121 : static bool
1122 222 : assignable_custom_variable_name(const char *name, bool skip_errors, int elevel)
1123 : {
1124 : /* If there's no separator, it can't be a custom variable */
1125 222 : const char *sep = strchr(name, GUC_QUALIFIER_SEPARATOR);
1126 :
1127 222 : if (sep != NULL)
1128 : {
1129 160 : size_t classLen = sep - name;
1130 : ListCell *lc;
1131 :
1132 : /* The name must be syntactically acceptable ... */
1133 160 : if (!valid_custom_variable_name(name))
1134 : {
1135 12 : if (!skip_errors)
1136 12 : ereport(elevel,
1137 : (errcode(ERRCODE_INVALID_NAME),
1138 : errmsg("invalid configuration parameter name \"%s\"",
1139 : name),
1140 : errdetail("Custom parameter names must be two or more simple identifiers separated by dots.")));
1141 0 : return false;
1142 : }
1143 : /* ... and it must not match any previously-reserved prefix */
1144 176 : foreach(lc, reserved_class_prefix)
1145 : {
1146 40 : const char *rcprefix = lfirst(lc);
1147 :
1148 40 : if (strlen(rcprefix) == classLen &&
1149 12 : strncmp(name, rcprefix, classLen) == 0)
1150 : {
1151 12 : if (!skip_errors)
1152 6 : ereport(elevel,
1153 : (errcode(ERRCODE_INVALID_NAME),
1154 : errmsg("invalid configuration parameter name \"%s\"",
1155 : name),
1156 : errdetail("\"%s\" is a reserved prefix.",
1157 : rcprefix)));
1158 6 : return false;
1159 : }
1160 : }
1161 : /* OK to create it */
1162 136 : return true;
1163 : }
1164 :
1165 : /* Unrecognized single-part name */
1166 62 : if (!skip_errors)
1167 62 : ereport(elevel,
1168 : (errcode(ERRCODE_UNDEFINED_OBJECT),
1169 : errmsg("unrecognized configuration parameter \"%s\"",
1170 : name)));
1171 0 : return false;
1172 : }
1173 :
1174 : /*
1175 : * Create and add a placeholder variable for a custom variable name.
1176 : */
1177 : static struct config_generic *
1178 122 : add_placeholder_variable(const char *name, int elevel)
1179 : {
1180 122 : size_t sz = sizeof(struct config_string) + sizeof(char *);
1181 : struct config_string *var;
1182 : struct config_generic *gen;
1183 :
1184 122 : var = (struct config_string *) guc_malloc(elevel, sz);
1185 122 : if (var == NULL)
1186 0 : return NULL;
1187 122 : memset(var, 0, sz);
1188 122 : gen = &var->gen;
1189 :
1190 122 : gen->name = guc_strdup(elevel, name);
1191 122 : if (gen->name == NULL)
1192 : {
1193 0 : guc_free(var);
1194 0 : return NULL;
1195 : }
1196 :
1197 122 : gen->context = PGC_USERSET;
1198 122 : gen->group = CUSTOM_OPTIONS;
1199 122 : gen->short_desc = "GUC placeholder variable";
1200 122 : gen->flags = GUC_NO_SHOW_ALL | GUC_NOT_IN_SAMPLE | GUC_CUSTOM_PLACEHOLDER;
1201 122 : gen->vartype = PGC_STRING;
1202 :
1203 : /*
1204 : * The char* is allocated at the end of the struct since we have no
1205 : * 'static' place to point to. Note that the current value, as well as
1206 : * the boot and reset values, start out NULL.
1207 : */
1208 122 : var->variable = (char **) (var + 1);
1209 :
1210 122 : if (!add_guc_variable((struct config_generic *) var, elevel))
1211 : {
1212 0 : guc_free(unconstify(char *, gen->name));
1213 0 : guc_free(var);
1214 0 : return NULL;
1215 : }
1216 :
1217 122 : return gen;
1218 : }
1219 :
1220 : /*
1221 : * Look up option "name". If it exists, return a pointer to its record.
1222 : * Otherwise, if create_placeholders is true and name is a valid-looking
1223 : * custom variable name, we'll create and return a placeholder record.
1224 : * Otherwise, if skip_errors is true, then we silently return NULL for
1225 : * an unrecognized or invalid name. Otherwise, the error is reported at
1226 : * error level elevel (and we return NULL if that's less than ERROR).
1227 : *
1228 : * Note: internal errors, primarily out-of-memory, draw an elevel-level
1229 : * report and NULL return regardless of skip_errors. Hence, callers must
1230 : * handle a NULL return whenever elevel < ERROR, but they should not need
1231 : * to emit any additional error message. (In practice, internal errors
1232 : * can only happen when create_placeholders is true, so callers passing
1233 : * false need not think terribly hard about this.)
1234 : */
1235 : struct config_generic *
1236 1414724 : find_option(const char *name, bool create_placeholders, bool skip_errors,
1237 : int elevel)
1238 : {
1239 : GUCHashEntry *hentry;
1240 : int i;
1241 :
1242 : Assert(name);
1243 :
1244 : /* Look it up using the hash table. */
1245 1414724 : hentry = (GUCHashEntry *) hash_search(guc_hashtab,
1246 : &name,
1247 : HASH_FIND,
1248 : NULL);
1249 1414724 : if (hentry)
1250 1414312 : return hentry->gucvar;
1251 :
1252 : /*
1253 : * See if the name is an obsolete name for a variable. We assume that the
1254 : * set of supported old names is short enough that a brute-force search is
1255 : * the best way.
1256 : */
1257 1648 : for (i = 0; map_old_guc_names[i] != NULL; i += 2)
1258 : {
1259 1236 : if (guc_name_compare(name, map_old_guc_names[i]) == 0)
1260 0 : return find_option(map_old_guc_names[i + 1], false,
1261 : skip_errors, elevel);
1262 : }
1263 :
1264 412 : if (create_placeholders)
1265 : {
1266 : /*
1267 : * Check if the name is valid, and if so, add a placeholder.
1268 : */
1269 206 : if (assignable_custom_variable_name(name, skip_errors, elevel))
1270 122 : return add_placeholder_variable(name, elevel);
1271 : else
1272 6 : return NULL; /* error message, if any, already emitted */
1273 : }
1274 :
1275 : /* Unknown name and we're not supposed to make a placeholder */
1276 206 : if (!skip_errors)
1277 38 : ereport(elevel,
1278 : (errcode(ERRCODE_UNDEFINED_OBJECT),
1279 : errmsg("unrecognized configuration parameter \"%s\"",
1280 : name)));
1281 168 : return NULL;
1282 : }
1283 :
1284 :
1285 : /*
1286 : * comparator for qsorting an array of GUC pointers
1287 : */
1288 : static int
1289 12945620 : guc_var_compare(const void *a, const void *b)
1290 : {
1291 12945620 : const char *namea = **(const char **const *) a;
1292 12945620 : const char *nameb = **(const char **const *) b;
1293 :
1294 12945620 : return guc_name_compare(namea, nameb);
1295 : }
1296 :
1297 : /*
1298 : * the bare comparison function for GUC names
1299 : */
1300 : int
1301 15043800 : guc_name_compare(const char *namea, const char *nameb)
1302 : {
1303 : /*
1304 : * The temptation to use strcasecmp() here must be resisted, because the
1305 : * hash mapping has to remain stable across setlocale() calls. So, build
1306 : * our own with a simple ASCII-only downcasing.
1307 : */
1308 62254676 : while (*namea && *nameb)
1309 : {
1310 60736442 : char cha = *namea++;
1311 60736442 : char chb = *nameb++;
1312 :
1313 60736442 : if (cha >= 'A' && cha <= 'Z')
1314 259074 : cha += 'a' - 'A';
1315 60736442 : if (chb >= 'A' && chb <= 'Z')
1316 140666 : chb += 'a' - 'A';
1317 60736442 : if (cha != chb)
1318 13525566 : return cha - chb;
1319 : }
1320 1518234 : if (*namea)
1321 44342 : return 1; /* a is longer */
1322 1473892 : if (*nameb)
1323 59274 : return -1; /* b is longer */
1324 1414618 : return 0;
1325 : }
1326 :
1327 : /*
1328 : * Hash function that's compatible with guc_name_compare
1329 : */
1330 : static uint32
1331 2370078 : guc_name_hash(const void *key, Size keysize)
1332 : {
1333 2370078 : uint32 result = 0;
1334 2370078 : const char *name = *(const char *const *) key;
1335 :
1336 40421414 : while (*name)
1337 : {
1338 38051336 : char ch = *name++;
1339 :
1340 : /* Case-fold in the same way as guc_name_compare */
1341 38051336 : if (ch >= 'A' && ch <= 'Z')
1342 41480 : ch += 'a' - 'A';
1343 :
1344 : /* Merge into hash ... not very bright, but it needn't be */
1345 38051336 : result = pg_rotate_left32(result, 5);
1346 38051336 : result ^= (uint32) ch;
1347 : }
1348 2370078 : return result;
1349 : }
1350 :
1351 : /*
1352 : * Dynahash match function to use in guc_hashtab
1353 : */
1354 : static int
1355 1414428 : guc_name_match(const void *key1, const void *key2, Size keysize)
1356 : {
1357 1414428 : const char *name1 = *(const char *const *) key1;
1358 1414428 : const char *name2 = *(const char *const *) key2;
1359 :
1360 1414428 : return guc_name_compare(name1, name2);
1361 : }
1362 :
1363 :
1364 : /*
1365 : * Convert a GUC name to the form that should be used in pg_parameter_acl.
1366 : *
1367 : * We need to canonicalize entries since, for example, case should not be
1368 : * significant. In addition, we apply the map_old_guc_names[] mapping so that
1369 : * any obsolete names will be converted when stored in a new PG version.
1370 : * Note however that this function does not verify legality of the name.
1371 : *
1372 : * The result is a palloc'd string.
1373 : */
1374 : char *
1375 352 : convert_GUC_name_for_parameter_acl(const char *name)
1376 : {
1377 : char *result;
1378 :
1379 : /* Apply old-GUC-name mapping. */
1380 1408 : for (int i = 0; map_old_guc_names[i] != NULL; i += 2)
1381 : {
1382 1056 : if (guc_name_compare(name, map_old_guc_names[i]) == 0)
1383 : {
1384 0 : name = map_old_guc_names[i + 1];
1385 0 : break;
1386 : }
1387 : }
1388 :
1389 : /* Apply case-folding that matches guc_name_compare(). */
1390 352 : result = pstrdup(name);
1391 5728 : for (char *ptr = result; *ptr != '\0'; ptr++)
1392 : {
1393 5376 : char ch = *ptr;
1394 :
1395 5376 : if (ch >= 'A' && ch <= 'Z')
1396 : {
1397 12 : ch += 'a' - 'A';
1398 12 : *ptr = ch;
1399 : }
1400 : }
1401 :
1402 352 : return result;
1403 : }
1404 :
1405 : /*
1406 : * Check whether we should allow creation of a pg_parameter_acl entry
1407 : * for the given name. (This can be applied either before or after
1408 : * canonicalizing it.) Throws error if not.
1409 : */
1410 : void
1411 68 : check_GUC_name_for_parameter_acl(const char *name)
1412 : {
1413 : /* OK if the GUC exists. */
1414 68 : if (find_option(name, false, true, DEBUG5) != NULL)
1415 54 : return;
1416 : /* Otherwise, it'd better be a valid custom GUC name. */
1417 14 : (void) assignable_custom_variable_name(name, false, ERROR);
1418 : }
1419 :
1420 : /*
1421 : * Routine in charge of checking various states of a GUC.
1422 : *
1423 : * This performs two sanity checks. First, it checks that the initial
1424 : * value of a GUC is the same when declared and when loaded to prevent
1425 : * anybody looking at the C declarations of these GUCs from being fooled by
1426 : * mismatched values. Second, it checks for incorrect flag combinations.
1427 : *
1428 : * The following validation rules apply for the values:
1429 : * bool - can be false, otherwise must be same as the boot_val
1430 : * int - can be 0, otherwise must be same as the boot_val
1431 : * real - can be 0.0, otherwise must be same as the boot_val
1432 : * string - can be NULL, otherwise must be strcmp equal to the boot_val
1433 : * enum - must be same as the boot_val
1434 : */
1435 : #ifdef USE_ASSERT_CHECKING
1436 : static bool
1437 : check_GUC_init(struct config_generic *gconf)
1438 : {
1439 : /* Checks on values */
1440 : switch (gconf->vartype)
1441 : {
1442 : case PGC_BOOL:
1443 : {
1444 : struct config_bool *conf = (struct config_bool *) gconf;
1445 :
1446 : if (*conf->variable && !conf->boot_val)
1447 : {
1448 : elog(LOG, "GUC (PGC_BOOL) %s, boot_val=%d, C-var=%d",
1449 : conf->gen.name, conf->boot_val, *conf->variable);
1450 : return false;
1451 : }
1452 : break;
1453 : }
1454 : case PGC_INT:
1455 : {
1456 : struct config_int *conf = (struct config_int *) gconf;
1457 :
1458 : if (*conf->variable != 0 && *conf->variable != conf->boot_val)
1459 : {
1460 : elog(LOG, "GUC (PGC_INT) %s, boot_val=%d, C-var=%d",
1461 : conf->gen.name, conf->boot_val, *conf->variable);
1462 : return false;
1463 : }
1464 : break;
1465 : }
1466 : case PGC_REAL:
1467 : {
1468 : struct config_real *conf = (struct config_real *) gconf;
1469 :
1470 : if (*conf->variable != 0.0 && *conf->variable != conf->boot_val)
1471 : {
1472 : elog(LOG, "GUC (PGC_REAL) %s, boot_val=%g, C-var=%g",
1473 : conf->gen.name, conf->boot_val, *conf->variable);
1474 : return false;
1475 : }
1476 : break;
1477 : }
1478 : case PGC_STRING:
1479 : {
1480 : struct config_string *conf = (struct config_string *) gconf;
1481 :
1482 : if (*conf->variable != NULL &&
1483 : (conf->boot_val == NULL ||
1484 : strcmp(*conf->variable, conf->boot_val) != 0))
1485 : {
1486 : elog(LOG, "GUC (PGC_STRING) %s, boot_val=%s, C-var=%s",
1487 : conf->gen.name, conf->boot_val ? conf->boot_val : "<null>", *conf->variable);
1488 : return false;
1489 : }
1490 : break;
1491 : }
1492 : case PGC_ENUM:
1493 : {
1494 : struct config_enum *conf = (struct config_enum *) gconf;
1495 :
1496 : if (*conf->variable != conf->boot_val)
1497 : {
1498 : elog(LOG, "GUC (PGC_ENUM) %s, boot_val=%d, C-var=%d",
1499 : conf->gen.name, conf->boot_val, *conf->variable);
1500 : return false;
1501 : }
1502 : break;
1503 : }
1504 : }
1505 :
1506 : /* Flag combinations */
1507 :
1508 : /*
1509 : * GUC_NO_SHOW_ALL requires GUC_NOT_IN_SAMPLE, as a parameter not part of
1510 : * SHOW ALL should not be hidden in postgresql.conf.sample.
1511 : */
1512 : if ((gconf->flags & GUC_NO_SHOW_ALL) &&
1513 : !(gconf->flags & GUC_NOT_IN_SAMPLE))
1514 : {
1515 : elog(LOG, "GUC %s flags: NO_SHOW_ALL and !NOT_IN_SAMPLE",
1516 : gconf->name);
1517 : return false;
1518 : }
1519 :
1520 : return true;
1521 : }
1522 : #endif
1523 :
1524 : /*
1525 : * Initialize GUC options during program startup.
1526 : *
1527 : * Note that we cannot read the config file yet, since we have not yet
1528 : * processed command-line switches.
1529 : */
1530 : void
1531 2256 : InitializeGUCOptions(void)
1532 : {
1533 : HASH_SEQ_STATUS status;
1534 : GUCHashEntry *hentry;
1535 :
1536 : /*
1537 : * Before log_line_prefix could possibly receive a nonempty setting, make
1538 : * sure that timezone processing is minimally alive (see elog.c).
1539 : */
1540 2256 : pg_timezone_initialize();
1541 :
1542 : /*
1543 : * Create GUCMemoryContext and build hash table of all GUC variables.
1544 : */
1545 2256 : build_guc_variables();
1546 :
1547 : /*
1548 : * Load all variables with their compiled-in defaults, and initialize
1549 : * status fields as needed.
1550 : */
1551 2256 : hash_seq_init(&status, guc_hashtab);
1552 920448 : while ((hentry = (GUCHashEntry *) hash_seq_search(&status)) != NULL)
1553 : {
1554 : /* Check mapping between initial and default value */
1555 : Assert(check_GUC_init(hentry->gucvar));
1556 :
1557 918192 : InitializeOneGUCOption(hentry->gucvar);
1558 : }
1559 :
1560 2256 : reporting_enabled = false;
1561 :
1562 : /*
1563 : * Prevent any attempt to override the transaction modes from
1564 : * non-interactive sources.
1565 : */
1566 2256 : SetConfigOption("transaction_isolation", "read committed",
1567 : PGC_POSTMASTER, PGC_S_OVERRIDE);
1568 2256 : SetConfigOption("transaction_read_only", "no",
1569 : PGC_POSTMASTER, PGC_S_OVERRIDE);
1570 2256 : SetConfigOption("transaction_deferrable", "no",
1571 : PGC_POSTMASTER, PGC_S_OVERRIDE);
1572 :
1573 : /*
1574 : * For historical reasons, some GUC parameters can receive defaults from
1575 : * environment variables. Process those settings.
1576 : */
1577 2256 : InitializeGUCOptionsFromEnvironment();
1578 2256 : }
1579 :
1580 : /*
1581 : * Assign any GUC values that can come from the server's environment.
1582 : *
1583 : * This is called from InitializeGUCOptions, and also from ProcessConfigFile
1584 : * to deal with the possibility that a setting has been removed from
1585 : * postgresql.conf and should now get a value from the environment.
1586 : * (The latter is a kludge that should probably go away someday; if so,
1587 : * fold this back into InitializeGUCOptions.)
1588 : */
1589 : static void
1590 3664 : InitializeGUCOptionsFromEnvironment(void)
1591 : {
1592 : char *env;
1593 : ssize_t stack_rlimit;
1594 :
1595 3664 : env = getenv("PGPORT");
1596 3664 : if (env != NULL)
1597 3304 : SetConfigOption("port", env, PGC_POSTMASTER, PGC_S_ENV_VAR);
1598 :
1599 3664 : env = getenv("PGDATESTYLE");
1600 3664 : if (env != NULL)
1601 228 : SetConfigOption("datestyle", env, PGC_POSTMASTER, PGC_S_ENV_VAR);
1602 :
1603 3664 : env = getenv("PGCLIENTENCODING");
1604 3664 : if (env != NULL)
1605 30 : SetConfigOption("client_encoding", env, PGC_POSTMASTER, PGC_S_ENV_VAR);
1606 :
1607 : /*
1608 : * rlimit isn't exactly an "environment variable", but it behaves about
1609 : * the same. If we can identify the platform stack depth rlimit, increase
1610 : * default stack depth setting up to whatever is safe (but at most 2MB).
1611 : * Report the value's source as PGC_S_DYNAMIC_DEFAULT if it's 2MB, or as
1612 : * PGC_S_ENV_VAR if it's reflecting the rlimit limit.
1613 : */
1614 3664 : stack_rlimit = get_stack_depth_rlimit();
1615 3664 : if (stack_rlimit > 0)
1616 : {
1617 3664 : ssize_t new_limit = (stack_rlimit - STACK_DEPTH_SLOP) / 1024;
1618 :
1619 3664 : if (new_limit > 100)
1620 : {
1621 : GucSource source;
1622 : char limbuf[16];
1623 :
1624 3664 : if (new_limit < 2048)
1625 0 : source = PGC_S_ENV_VAR;
1626 : else
1627 : {
1628 3664 : new_limit = 2048;
1629 3664 : source = PGC_S_DYNAMIC_DEFAULT;
1630 : }
1631 3664 : snprintf(limbuf, sizeof(limbuf), "%d", (int) new_limit);
1632 3664 : SetConfigOption("max_stack_depth", limbuf,
1633 : PGC_POSTMASTER, source);
1634 : }
1635 : }
1636 3664 : }
1637 :
1638 : /*
1639 : * Initialize one GUC option variable to its compiled-in default.
1640 : *
1641 : * Note: the reason for calling check_hooks is not that we think the boot_val
1642 : * might fail, but that the hooks might wish to compute an "extra" struct.
1643 : */
1644 : static void
1645 1003204 : InitializeOneGUCOption(struct config_generic *gconf)
1646 : {
1647 1003204 : gconf->status = 0;
1648 1003204 : gconf->source = PGC_S_DEFAULT;
1649 1003204 : gconf->reset_source = PGC_S_DEFAULT;
1650 1003204 : gconf->scontext = PGC_INTERNAL;
1651 1003204 : gconf->reset_scontext = PGC_INTERNAL;
1652 1003204 : gconf->srole = BOOTSTRAP_SUPERUSERID;
1653 1003204 : gconf->reset_srole = BOOTSTRAP_SUPERUSERID;
1654 1003204 : gconf->stack = NULL;
1655 1003204 : gconf->extra = NULL;
1656 1003204 : gconf->last_reported = NULL;
1657 1003204 : gconf->sourcefile = NULL;
1658 1003204 : gconf->sourceline = 0;
1659 :
1660 1003204 : switch (gconf->vartype)
1661 : {
1662 290470 : case PGC_BOOL:
1663 : {
1664 290470 : struct config_bool *conf = (struct config_bool *) gconf;
1665 290470 : bool newval = conf->boot_val;
1666 290470 : void *extra = NULL;
1667 :
1668 290470 : if (!call_bool_check_hook(conf, &newval, &extra,
1669 : PGC_S_DEFAULT, LOG))
1670 0 : elog(FATAL, "failed to initialize %s to %d",
1671 : conf->gen.name, (int) newval);
1672 290470 : if (conf->assign_hook)
1673 0 : conf->assign_hook(newval, extra);
1674 290470 : *conf->variable = conf->reset_val = newval;
1675 290470 : conf->gen.extra = conf->reset_extra = extra;
1676 290470 : break;
1677 : }
1678 344504 : case PGC_INT:
1679 : {
1680 344504 : struct config_int *conf = (struct config_int *) gconf;
1681 344504 : int newval = conf->boot_val;
1682 344504 : void *extra = NULL;
1683 :
1684 : Assert(newval >= conf->min);
1685 : Assert(newval <= conf->max);
1686 344504 : if (!call_int_check_hook(conf, &newval, &extra,
1687 : PGC_S_DEFAULT, LOG))
1688 0 : elog(FATAL, "failed to initialize %s to %d",
1689 : conf->gen.name, newval);
1690 344504 : if (conf->assign_hook)
1691 28028 : conf->assign_hook(newval, extra);
1692 344504 : *conf->variable = conf->reset_val = newval;
1693 344504 : conf->gen.extra = conf->reset_extra = extra;
1694 344504 : break;
1695 : }
1696 58702 : case PGC_REAL:
1697 : {
1698 58702 : struct config_real *conf = (struct config_real *) gconf;
1699 58702 : double newval = conf->boot_val;
1700 58702 : void *extra = NULL;
1701 :
1702 : Assert(newval >= conf->min);
1703 : Assert(newval <= conf->max);
1704 58702 : if (!call_real_check_hook(conf, &newval, &extra,
1705 : PGC_S_DEFAULT, LOG))
1706 0 : elog(FATAL, "failed to initialize %s to %g",
1707 : conf->gen.name, newval);
1708 58702 : if (conf->assign_hook)
1709 4512 : conf->assign_hook(newval, extra);
1710 58702 : *conf->variable = conf->reset_val = newval;
1711 58702 : conf->gen.extra = conf->reset_extra = extra;
1712 58702 : break;
1713 : }
1714 207488 : case PGC_STRING:
1715 : {
1716 207488 : struct config_string *conf = (struct config_string *) gconf;
1717 : char *newval;
1718 207488 : void *extra = NULL;
1719 :
1720 : /* non-NULL boot_val must always get strdup'd */
1721 207488 : if (conf->boot_val != NULL)
1722 188740 : newval = guc_strdup(FATAL, conf->boot_val);
1723 : else
1724 18748 : newval = NULL;
1725 :
1726 207488 : if (!call_string_check_hook(conf, &newval, &extra,
1727 : PGC_S_DEFAULT, LOG))
1728 0 : elog(FATAL, "failed to initialize %s to \"%s\"",
1729 : conf->gen.name, newval ? newval : "");
1730 207488 : if (conf->assign_hook)
1731 105252 : conf->assign_hook(newval, extra);
1732 207488 : *conf->variable = conf->reset_val = newval;
1733 207488 : conf->gen.extra = conf->reset_extra = extra;
1734 207488 : break;
1735 : }
1736 102040 : case PGC_ENUM:
1737 : {
1738 102040 : struct config_enum *conf = (struct config_enum *) gconf;
1739 102040 : int newval = conf->boot_val;
1740 102040 : void *extra = NULL;
1741 :
1742 102040 : if (!call_enum_check_hook(conf, &newval, &extra,
1743 : PGC_S_DEFAULT, LOG))
1744 0 : elog(FATAL, "failed to initialize %s to %d",
1745 : conf->gen.name, newval);
1746 102040 : if (conf->assign_hook)
1747 15792 : conf->assign_hook(newval, extra);
1748 102040 : *conf->variable = conf->reset_val = newval;
1749 102040 : conf->gen.extra = conf->reset_extra = extra;
1750 102040 : break;
1751 : }
1752 : }
1753 1003204 : }
1754 :
1755 : /*
1756 : * Summarily remove a GUC variable from any linked lists it's in.
1757 : *
1758 : * We use this in cases where the variable is about to be deleted or reset.
1759 : * These aren't common operations, so it's okay if this is a bit slow.
1760 : */
1761 : static void
1762 66558 : RemoveGUCFromLists(struct config_generic *gconf)
1763 : {
1764 66558 : if (gconf->source != PGC_S_DEFAULT)
1765 66556 : dlist_delete(&gconf->nondef_link);
1766 66558 : if (gconf->stack != NULL)
1767 0 : slist_delete(&guc_stack_list, &gconf->stack_link);
1768 66558 : if (gconf->status & GUC_NEEDS_REPORT)
1769 8202 : slist_delete(&guc_report_list, &gconf->report_link);
1770 66558 : }
1771 :
1772 :
1773 : /*
1774 : * Select the configuration files and data directory to be used, and
1775 : * do the initial read of postgresql.conf.
1776 : *
1777 : * This is called after processing command-line switches.
1778 : * userDoption is the -D switch value if any (NULL if unspecified).
1779 : * progname is just for use in error messages.
1780 : *
1781 : * Returns true on success; on failure, prints a suitable error message
1782 : * to stderr and returns false.
1783 : */
1784 : bool
1785 2204 : SelectConfigFiles(const char *userDoption, const char *progname)
1786 : {
1787 : char *configdir;
1788 : char *fname;
1789 : bool fname_is_malloced;
1790 : struct stat stat_buf;
1791 : struct config_string *data_directory_rec;
1792 :
1793 : /* configdir is -D option, or $PGDATA if no -D */
1794 2204 : if (userDoption)
1795 1802 : configdir = make_absolute_path(userDoption);
1796 : else
1797 402 : configdir = make_absolute_path(getenv("PGDATA"));
1798 :
1799 2204 : if (configdir && stat(configdir, &stat_buf) != 0)
1800 : {
1801 0 : write_stderr("%s: could not access directory \"%s\": %m\n",
1802 : progname,
1803 : configdir);
1804 0 : if (errno == ENOENT)
1805 0 : write_stderr("Run initdb or pg_basebackup to initialize a PostgreSQL data directory.\n");
1806 0 : goto fail;
1807 : }
1808 :
1809 : /*
1810 : * Find the configuration file: if config_file was specified on the
1811 : * command line, use it, else use configdir/postgresql.conf. In any case
1812 : * ensure the result is an absolute path, so that it will be interpreted
1813 : * the same way by future backends.
1814 : */
1815 2204 : if (ConfigFileName)
1816 : {
1817 20 : fname = make_absolute_path(ConfigFileName);
1818 20 : fname_is_malloced = true;
1819 : }
1820 2184 : else if (configdir)
1821 : {
1822 2184 : fname = guc_malloc(FATAL,
1823 2184 : strlen(configdir) + strlen(CONFIG_FILENAME) + 2);
1824 2184 : sprintf(fname, "%s/%s", configdir, CONFIG_FILENAME);
1825 2184 : fname_is_malloced = false;
1826 : }
1827 : else
1828 : {
1829 0 : write_stderr("%s does not know where to find the server configuration file.\n"
1830 : "You must specify the --config-file or -D invocation "
1831 : "option or set the PGDATA environment variable.\n",
1832 : progname);
1833 0 : goto fail;
1834 : }
1835 :
1836 : /*
1837 : * Set the ConfigFileName GUC variable to its final value, ensuring that
1838 : * it can't be overridden later.
1839 : */
1840 2204 : SetConfigOption("config_file", fname, PGC_POSTMASTER, PGC_S_OVERRIDE);
1841 :
1842 2204 : if (fname_is_malloced)
1843 20 : free(fname);
1844 : else
1845 2184 : guc_free(fname);
1846 :
1847 : /*
1848 : * Now read the config file for the first time.
1849 : */
1850 2204 : if (stat(ConfigFileName, &stat_buf) != 0)
1851 : {
1852 0 : write_stderr("%s: could not access the server configuration file \"%s\": %m\n",
1853 : progname, ConfigFileName);
1854 0 : goto fail;
1855 : }
1856 :
1857 : /*
1858 : * Read the configuration file for the first time. This time only the
1859 : * data_directory parameter is picked up to determine the data directory,
1860 : * so that we can read the PG_AUTOCONF_FILENAME file next time.
1861 : */
1862 2204 : ProcessConfigFile(PGC_POSTMASTER);
1863 :
1864 : /*
1865 : * If the data_directory GUC variable has been set, use that as DataDir;
1866 : * otherwise use configdir if set; else punt.
1867 : *
1868 : * Note: SetDataDir will copy and absolute-ize its argument, so we don't
1869 : * have to.
1870 : */
1871 : data_directory_rec = (struct config_string *)
1872 2204 : find_option("data_directory", false, false, PANIC);
1873 2204 : if (*data_directory_rec->variable)
1874 0 : SetDataDir(*data_directory_rec->variable);
1875 2204 : else if (configdir)
1876 2204 : SetDataDir(configdir);
1877 : else
1878 : {
1879 0 : write_stderr("%s does not know where to find the database system data.\n"
1880 : "This can be specified as \"data_directory\" in \"%s\", "
1881 : "or by the -D invocation option, or by the "
1882 : "PGDATA environment variable.\n",
1883 : progname, ConfigFileName);
1884 0 : goto fail;
1885 : }
1886 :
1887 : /*
1888 : * Reflect the final DataDir value back into the data_directory GUC var.
1889 : * (If you are wondering why we don't just make them a single variable,
1890 : * it's because the EXEC_BACKEND case needs DataDir to be transmitted to
1891 : * child backends specially. XXX is that still true? Given that we now
1892 : * chdir to DataDir, EXEC_BACKEND can read the config file without knowing
1893 : * DataDir in advance.)
1894 : */
1895 2204 : SetConfigOption("data_directory", DataDir, PGC_POSTMASTER, PGC_S_OVERRIDE);
1896 :
1897 : /*
1898 : * Now read the config file a second time, allowing any settings in the
1899 : * PG_AUTOCONF_FILENAME file to take effect. (This is pretty ugly, but
1900 : * since we have to determine the DataDir before we can find the autoconf
1901 : * file, the alternatives seem worse.)
1902 : */
1903 2204 : ProcessConfigFile(PGC_POSTMASTER);
1904 :
1905 : /*
1906 : * If timezone_abbreviations wasn't set in the configuration file, install
1907 : * the default value. We do it this way because we can't safely install a
1908 : * "real" value until my_exec_path is set, which may not have happened
1909 : * when InitializeGUCOptions runs, so the bootstrap default value cannot
1910 : * be the real desired default.
1911 : */
1912 2194 : pg_timezone_abbrev_initialize();
1913 :
1914 : /*
1915 : * Figure out where pg_hba.conf is, and make sure the path is absolute.
1916 : */
1917 2194 : if (HbaFileName)
1918 : {
1919 2 : fname = make_absolute_path(HbaFileName);
1920 2 : fname_is_malloced = true;
1921 : }
1922 2192 : else if (configdir)
1923 : {
1924 2192 : fname = guc_malloc(FATAL,
1925 2192 : strlen(configdir) + strlen(HBA_FILENAME) + 2);
1926 2192 : sprintf(fname, "%s/%s", configdir, HBA_FILENAME);
1927 2192 : fname_is_malloced = false;
1928 : }
1929 : else
1930 : {
1931 0 : write_stderr("%s does not know where to find the \"hba\" configuration file.\n"
1932 : "This can be specified as \"hba_file\" in \"%s\", "
1933 : "or by the -D invocation option, or by the "
1934 : "PGDATA environment variable.\n",
1935 : progname, ConfigFileName);
1936 0 : goto fail;
1937 : }
1938 2194 : SetConfigOption("hba_file", fname, PGC_POSTMASTER, PGC_S_OVERRIDE);
1939 :
1940 2194 : if (fname_is_malloced)
1941 2 : free(fname);
1942 : else
1943 2192 : guc_free(fname);
1944 :
1945 : /*
1946 : * Likewise for pg_ident.conf.
1947 : */
1948 2194 : if (IdentFileName)
1949 : {
1950 2 : fname = make_absolute_path(IdentFileName);
1951 2 : fname_is_malloced = true;
1952 : }
1953 2192 : else if (configdir)
1954 : {
1955 2192 : fname = guc_malloc(FATAL,
1956 2192 : strlen(configdir) + strlen(IDENT_FILENAME) + 2);
1957 2192 : sprintf(fname, "%s/%s", configdir, IDENT_FILENAME);
1958 2192 : fname_is_malloced = false;
1959 : }
1960 : else
1961 : {
1962 0 : write_stderr("%s does not know where to find the \"ident\" configuration file.\n"
1963 : "This can be specified as \"ident_file\" in \"%s\", "
1964 : "or by the -D invocation option, or by the "
1965 : "PGDATA environment variable.\n",
1966 : progname, ConfigFileName);
1967 0 : goto fail;
1968 : }
1969 2194 : SetConfigOption("ident_file", fname, PGC_POSTMASTER, PGC_S_OVERRIDE);
1970 :
1971 2194 : if (fname_is_malloced)
1972 2 : free(fname);
1973 : else
1974 2192 : guc_free(fname);
1975 :
1976 2194 : free(configdir);
1977 :
1978 2194 : return true;
1979 :
1980 0 : fail:
1981 0 : free(configdir);
1982 :
1983 0 : return false;
1984 : }
1985 :
1986 : /*
1987 : * pg_timezone_abbrev_initialize --- set default value if not done already
1988 : *
1989 : * This is called after initial loading of postgresql.conf. If no
1990 : * timezone_abbreviations setting was found therein, select default.
1991 : * If a non-default value is already installed, nothing will happen.
1992 : *
1993 : * This can also be called from ProcessConfigFile to establish the default
1994 : * value after a postgresql.conf entry for it is removed.
1995 : */
1996 : static void
1997 3602 : pg_timezone_abbrev_initialize(void)
1998 : {
1999 3602 : SetConfigOption("timezone_abbreviations", "Default",
2000 : PGC_POSTMASTER, PGC_S_DYNAMIC_DEFAULT);
2001 3602 : }
2002 :
2003 :
2004 : /*
2005 : * Reset all options to their saved default values (implements RESET ALL)
2006 : */
2007 : void
2008 18 : ResetAllOptions(void)
2009 : {
2010 : dlist_mutable_iter iter;
2011 :
2012 : /* We need only consider GUCs not already at PGC_S_DEFAULT */
2013 1022 : dlist_foreach_modify(iter, &guc_nondef_list)
2014 : {
2015 1004 : struct config_generic *gconf = dlist_container(struct config_generic,
2016 : nondef_link, iter.cur);
2017 :
2018 : /* Don't reset non-SET-able values */
2019 1004 : if (gconf->context != PGC_SUSET &&
2020 926 : gconf->context != PGC_USERSET)
2021 600 : continue;
2022 : /* Don't reset if special exclusion from RESET ALL */
2023 404 : if (gconf->flags & GUC_NO_RESET_ALL)
2024 90 : continue;
2025 : /* No need to reset if wasn't SET */
2026 314 : if (gconf->source <= PGC_S_OVERRIDE)
2027 274 : continue;
2028 :
2029 : /* Save old value to support transaction abort */
2030 40 : push_old_value(gconf, GUC_ACTION_SET);
2031 :
2032 40 : switch (gconf->vartype)
2033 : {
2034 20 : case PGC_BOOL:
2035 : {
2036 20 : struct config_bool *conf = (struct config_bool *) gconf;
2037 :
2038 20 : if (conf->assign_hook)
2039 0 : conf->assign_hook(conf->reset_val,
2040 : conf->reset_extra);
2041 20 : *conf->variable = conf->reset_val;
2042 20 : set_extra_field(&conf->gen, &conf->gen.extra,
2043 : conf->reset_extra);
2044 20 : break;
2045 : }
2046 2 : case PGC_INT:
2047 : {
2048 2 : struct config_int *conf = (struct config_int *) gconf;
2049 :
2050 2 : if (conf->assign_hook)
2051 0 : conf->assign_hook(conf->reset_val,
2052 : conf->reset_extra);
2053 2 : *conf->variable = conf->reset_val;
2054 2 : set_extra_field(&conf->gen, &conf->gen.extra,
2055 : conf->reset_extra);
2056 2 : break;
2057 : }
2058 6 : case PGC_REAL:
2059 : {
2060 6 : struct config_real *conf = (struct config_real *) gconf;
2061 :
2062 6 : if (conf->assign_hook)
2063 0 : conf->assign_hook(conf->reset_val,
2064 : conf->reset_extra);
2065 6 : *conf->variable = conf->reset_val;
2066 6 : set_extra_field(&conf->gen, &conf->gen.extra,
2067 : conf->reset_extra);
2068 6 : break;
2069 : }
2070 10 : case PGC_STRING:
2071 : {
2072 10 : struct config_string *conf = (struct config_string *) gconf;
2073 :
2074 10 : if (conf->assign_hook)
2075 4 : conf->assign_hook(conf->reset_val,
2076 : conf->reset_extra);
2077 10 : set_string_field(conf, conf->variable, conf->reset_val);
2078 10 : set_extra_field(&conf->gen, &conf->gen.extra,
2079 : conf->reset_extra);
2080 10 : break;
2081 : }
2082 2 : case PGC_ENUM:
2083 : {
2084 2 : struct config_enum *conf = (struct config_enum *) gconf;
2085 :
2086 2 : if (conf->assign_hook)
2087 0 : conf->assign_hook(conf->reset_val,
2088 : conf->reset_extra);
2089 2 : *conf->variable = conf->reset_val;
2090 2 : set_extra_field(&conf->gen, &conf->gen.extra,
2091 : conf->reset_extra);
2092 2 : break;
2093 : }
2094 : }
2095 :
2096 40 : set_guc_source(gconf, gconf->reset_source);
2097 40 : gconf->scontext = gconf->reset_scontext;
2098 40 : gconf->srole = gconf->reset_srole;
2099 :
2100 40 : if ((gconf->flags & GUC_REPORT) && !(gconf->status & GUC_NEEDS_REPORT))
2101 : {
2102 6 : gconf->status |= GUC_NEEDS_REPORT;
2103 6 : slist_push_head(&guc_report_list, &gconf->report_link);
2104 : }
2105 : }
2106 18 : }
2107 :
2108 :
2109 : /*
2110 : * Apply a change to a GUC variable's "source" field.
2111 : *
2112 : * Use this rather than just assigning, to ensure that the variable's
2113 : * membership in guc_nondef_list is updated correctly.
2114 : */
2115 : static void
2116 1517472 : set_guc_source(struct config_generic *gconf, GucSource newsource)
2117 : {
2118 : /* Adjust nondef list membership if appropriate for change */
2119 1517472 : if (gconf->source == PGC_S_DEFAULT)
2120 : {
2121 562876 : if (newsource != PGC_S_DEFAULT)
2122 562730 : dlist_push_tail(&guc_nondef_list, &gconf->nondef_link);
2123 : }
2124 : else
2125 : {
2126 954596 : if (newsource == PGC_S_DEFAULT)
2127 104360 : dlist_delete(&gconf->nondef_link);
2128 : }
2129 : /* Now update the source field */
2130 1517472 : gconf->source = newsource;
2131 1517472 : }
2132 :
2133 :
2134 : /*
2135 : * push_old_value
2136 : * Push previous state during transactional assignment to a GUC variable.
2137 : */
2138 : static void
2139 514606 : push_old_value(struct config_generic *gconf, GucAction action)
2140 : {
2141 : GucStack *stack;
2142 :
2143 : /* If we're not inside a nest level, do nothing */
2144 514606 : if (GUCNestLevel == 0)
2145 0 : return;
2146 :
2147 : /* Do we already have a stack entry of the current nest level? */
2148 514606 : stack = gconf->stack;
2149 514606 : if (stack && stack->nest_level >= GUCNestLevel)
2150 : {
2151 : /* Yes, so adjust its state if necessary */
2152 : Assert(stack->nest_level == GUCNestLevel);
2153 11300 : switch (action)
2154 : {
2155 11128 : case GUC_ACTION_SET:
2156 : /* SET overrides any prior action at same nest level */
2157 11128 : if (stack->state == GUC_SET_LOCAL)
2158 : {
2159 : /* must discard old masked value */
2160 0 : discard_stack_value(gconf, &stack->masked);
2161 : }
2162 11128 : stack->state = GUC_SET;
2163 11128 : break;
2164 172 : case GUC_ACTION_LOCAL:
2165 172 : if (stack->state == GUC_SET)
2166 : {
2167 : /* SET followed by SET LOCAL, remember SET's value */
2168 12 : stack->masked_scontext = gconf->scontext;
2169 12 : stack->masked_srole = gconf->srole;
2170 12 : set_stack_value(gconf, &stack->masked);
2171 12 : stack->state = GUC_SET_LOCAL;
2172 : }
2173 : /* in all other cases, no change to stack entry */
2174 172 : break;
2175 0 : case GUC_ACTION_SAVE:
2176 : /* Could only have a prior SAVE of same variable */
2177 : Assert(stack->state == GUC_SAVE);
2178 0 : break;
2179 : }
2180 11300 : return;
2181 : }
2182 :
2183 : /*
2184 : * Push a new stack entry
2185 : *
2186 : * We keep all the stack entries in TopTransactionContext for simplicity.
2187 : */
2188 503306 : stack = (GucStack *) MemoryContextAllocZero(TopTransactionContext,
2189 : sizeof(GucStack));
2190 :
2191 503306 : stack->prev = gconf->stack;
2192 503306 : stack->nest_level = GUCNestLevel;
2193 503306 : switch (action)
2194 : {
2195 56910 : case GUC_ACTION_SET:
2196 56910 : stack->state = GUC_SET;
2197 56910 : break;
2198 8734 : case GUC_ACTION_LOCAL:
2199 8734 : stack->state = GUC_LOCAL;
2200 8734 : break;
2201 437662 : case GUC_ACTION_SAVE:
2202 437662 : stack->state = GUC_SAVE;
2203 437662 : break;
2204 : }
2205 503306 : stack->source = gconf->source;
2206 503306 : stack->scontext = gconf->scontext;
2207 503306 : stack->srole = gconf->srole;
2208 503306 : set_stack_value(gconf, &stack->prior);
2209 :
2210 503306 : if (gconf->stack == NULL)
2211 473016 : slist_push_head(&guc_stack_list, &gconf->stack_link);
2212 503306 : gconf->stack = stack;
2213 : }
2214 :
2215 :
2216 : /*
2217 : * Do GUC processing at main transaction start.
2218 : */
2219 : void
2220 1157716 : AtStart_GUC(void)
2221 : {
2222 : /*
2223 : * The nest level should be 0 between transactions; if it isn't, somebody
2224 : * didn't call AtEOXact_GUC, or called it with the wrong nestLevel. We
2225 : * throw a warning but make no other effort to clean up.
2226 : */
2227 1157716 : if (GUCNestLevel != 0)
2228 0 : elog(WARNING, "GUC nest level = %d at transaction start",
2229 : GUCNestLevel);
2230 1157716 : GUCNestLevel = 1;
2231 1157716 : }
2232 :
2233 : /*
2234 : * Enter a new nesting level for GUC values. This is called at subtransaction
2235 : * start, and when entering a function that has proconfig settings, and in
2236 : * some other places where we want to set GUC variables transiently.
2237 : * NOTE we must not risk error here, else subtransaction start will be unhappy.
2238 : */
2239 : int
2240 498662 : NewGUCNestLevel(void)
2241 : {
2242 498662 : return ++GUCNestLevel;
2243 : }
2244 :
2245 : /*
2246 : * Set search_path to a fixed value for maintenance operations. No effect
2247 : * during bootstrap, when the search_path is already set to a fixed value and
2248 : * cannot be changed.
2249 : */
2250 : void
2251 457678 : RestrictSearchPath(void)
2252 : {
2253 457678 : if (!IsBootstrapProcessingMode())
2254 396478 : set_config_option("search_path", GUC_SAFE_SEARCH_PATH, PGC_USERSET,
2255 : PGC_S_SESSION, GUC_ACTION_SAVE, true, 0, false);
2256 457678 : }
2257 :
2258 : /*
2259 : * Do GUC processing at transaction or subtransaction commit or abort, or
2260 : * when exiting a function that has proconfig settings, or when undoing a
2261 : * transient assignment to some GUC variables. (The name is thus a bit of
2262 : * a misnomer; perhaps it should be ExitGUCNestLevel or some such.)
2263 : * During abort, we discard all GUC settings that were applied at nesting
2264 : * levels >= nestLevel. nestLevel == 1 corresponds to the main transaction.
2265 : */
2266 : void
2267 1654806 : AtEOXact_GUC(bool isCommit, int nestLevel)
2268 : {
2269 : slist_mutable_iter iter;
2270 :
2271 : /*
2272 : * Note: it's possible to get here with GUCNestLevel == nestLevel-1 during
2273 : * abort, if there is a failure during transaction start before
2274 : * AtStart_GUC is called.
2275 : */
2276 : Assert(nestLevel > 0 &&
2277 : (nestLevel <= GUCNestLevel ||
2278 : (nestLevel == GUCNestLevel + 1 && !isCommit)));
2279 :
2280 : /* We need only process GUCs having nonempty stacks */
2281 2164270 : slist_foreach_modify(iter, &guc_stack_list)
2282 : {
2283 509464 : struct config_generic *gconf = slist_container(struct config_generic,
2284 : stack_link, iter.cur);
2285 : GucStack *stack;
2286 :
2287 : /*
2288 : * Process and pop each stack entry within the nest level. To simplify
2289 : * fmgr_security_definer() and other places that use GUC_ACTION_SAVE,
2290 : * we allow failure exit from code that uses a local nest level to be
2291 : * recovered at the surrounding transaction or subtransaction abort;
2292 : * so there could be more than one stack entry to pop.
2293 : */
2294 1012802 : while ((stack = gconf->stack) != NULL &&
2295 539790 : stack->nest_level >= nestLevel)
2296 : {
2297 503338 : GucStack *prev = stack->prev;
2298 503338 : bool restorePrior = false;
2299 503338 : bool restoreMasked = false;
2300 : bool changed;
2301 :
2302 : /*
2303 : * In this next bit, if we don't set either restorePrior or
2304 : * restoreMasked, we must "discard" any unwanted fields of the
2305 : * stack entries to avoid leaking memory. If we do set one of
2306 : * those flags, unused fields will be cleaned up after restoring.
2307 : */
2308 503338 : if (!isCommit) /* if abort, always restore prior value */
2309 401494 : restorePrior = true;
2310 101844 : else if (stack->state == GUC_SAVE)
2311 40284 : restorePrior = true;
2312 61560 : else if (stack->nest_level == 1)
2313 : {
2314 : /* transaction commit */
2315 61518 : if (stack->state == GUC_SET_LOCAL)
2316 12 : restoreMasked = true;
2317 61506 : else if (stack->state == GUC_SET)
2318 : {
2319 : /* we keep the current active value */
2320 54674 : discard_stack_value(gconf, &stack->prior);
2321 : }
2322 : else /* must be GUC_LOCAL */
2323 6832 : restorePrior = true;
2324 : }
2325 42 : else if (prev == NULL ||
2326 12 : prev->nest_level < stack->nest_level - 1)
2327 : {
2328 : /* decrement entry's level and do not pop it */
2329 36 : stack->nest_level--;
2330 36 : continue;
2331 : }
2332 : else
2333 : {
2334 : /*
2335 : * We have to merge this stack entry into prev. See README for
2336 : * discussion of this bit.
2337 : */
2338 6 : switch (stack->state)
2339 : {
2340 0 : case GUC_SAVE:
2341 : Assert(false); /* can't get here */
2342 0 : break;
2343 :
2344 6 : case GUC_SET:
2345 : /* next level always becomes SET */
2346 6 : discard_stack_value(gconf, &stack->prior);
2347 6 : if (prev->state == GUC_SET_LOCAL)
2348 0 : discard_stack_value(gconf, &prev->masked);
2349 6 : prev->state = GUC_SET;
2350 6 : break;
2351 :
2352 0 : case GUC_LOCAL:
2353 0 : if (prev->state == GUC_SET)
2354 : {
2355 : /* LOCAL migrates down */
2356 0 : prev->masked_scontext = stack->scontext;
2357 0 : prev->masked_srole = stack->srole;
2358 0 : prev->masked = stack->prior;
2359 0 : prev->state = GUC_SET_LOCAL;
2360 : }
2361 : else
2362 : {
2363 : /* else just forget this stack level */
2364 0 : discard_stack_value(gconf, &stack->prior);
2365 : }
2366 0 : break;
2367 :
2368 0 : case GUC_SET_LOCAL:
2369 : /* prior state at this level no longer wanted */
2370 0 : discard_stack_value(gconf, &stack->prior);
2371 : /* copy down the masked state */
2372 0 : prev->masked_scontext = stack->masked_scontext;
2373 0 : prev->masked_srole = stack->masked_srole;
2374 0 : if (prev->state == GUC_SET_LOCAL)
2375 0 : discard_stack_value(gconf, &prev->masked);
2376 0 : prev->masked = stack->masked;
2377 0 : prev->state = GUC_SET_LOCAL;
2378 0 : break;
2379 : }
2380 : }
2381 :
2382 503302 : changed = false;
2383 :
2384 503302 : if (restorePrior || restoreMasked)
2385 : {
2386 : /* Perform appropriate restoration of the stacked value */
2387 : config_var_value newvalue;
2388 : GucSource newsource;
2389 : GucContext newscontext;
2390 : Oid newsrole;
2391 :
2392 448622 : if (restoreMasked)
2393 : {
2394 12 : newvalue = stack->masked;
2395 12 : newsource = PGC_S_SESSION;
2396 12 : newscontext = stack->masked_scontext;
2397 12 : newsrole = stack->masked_srole;
2398 : }
2399 : else
2400 : {
2401 448610 : newvalue = stack->prior;
2402 448610 : newsource = stack->source;
2403 448610 : newscontext = stack->scontext;
2404 448610 : newsrole = stack->srole;
2405 : }
2406 :
2407 448622 : switch (gconf->vartype)
2408 : {
2409 3612 : case PGC_BOOL:
2410 : {
2411 3612 : struct config_bool *conf = (struct config_bool *) gconf;
2412 3612 : bool newval = newvalue.val.boolval;
2413 3612 : void *newextra = newvalue.extra;
2414 :
2415 3612 : if (*conf->variable != newval ||
2416 436 : conf->gen.extra != newextra)
2417 : {
2418 3176 : if (conf->assign_hook)
2419 0 : conf->assign_hook(newval, newextra);
2420 3176 : *conf->variable = newval;
2421 3176 : set_extra_field(&conf->gen, &conf->gen.extra,
2422 : newextra);
2423 3176 : changed = true;
2424 : }
2425 3612 : break;
2426 : }
2427 10152 : case PGC_INT:
2428 : {
2429 10152 : struct config_int *conf = (struct config_int *) gconf;
2430 10152 : int newval = newvalue.val.intval;
2431 10152 : void *newextra = newvalue.extra;
2432 :
2433 10152 : if (*conf->variable != newval ||
2434 198 : conf->gen.extra != newextra)
2435 : {
2436 9954 : if (conf->assign_hook)
2437 0 : conf->assign_hook(newval, newextra);
2438 9954 : *conf->variable = newval;
2439 9954 : set_extra_field(&conf->gen, &conf->gen.extra,
2440 : newextra);
2441 9954 : changed = true;
2442 : }
2443 10152 : break;
2444 : }
2445 1570 : case PGC_REAL:
2446 : {
2447 1570 : struct config_real *conf = (struct config_real *) gconf;
2448 1570 : double newval = newvalue.val.realval;
2449 1570 : void *newextra = newvalue.extra;
2450 :
2451 1570 : if (*conf->variable != newval ||
2452 24 : conf->gen.extra != newextra)
2453 : {
2454 1546 : if (conf->assign_hook)
2455 0 : conf->assign_hook(newval, newextra);
2456 1546 : *conf->variable = newval;
2457 1546 : set_extra_field(&conf->gen, &conf->gen.extra,
2458 : newextra);
2459 1546 : changed = true;
2460 : }
2461 1570 : break;
2462 : }
2463 416640 : case PGC_STRING:
2464 : {
2465 416640 : struct config_string *conf = (struct config_string *) gconf;
2466 416640 : char *newval = newvalue.val.stringval;
2467 416640 : void *newextra = newvalue.extra;
2468 :
2469 416640 : if (*conf->variable != newval ||
2470 20 : conf->gen.extra != newextra)
2471 : {
2472 416620 : if (conf->assign_hook)
2473 416114 : conf->assign_hook(newval, newextra);
2474 416620 : set_string_field(conf, conf->variable, newval);
2475 416620 : set_extra_field(&conf->gen, &conf->gen.extra,
2476 : newextra);
2477 416620 : changed = true;
2478 : }
2479 :
2480 : /*
2481 : * Release stacked values if not used anymore. We
2482 : * could use discard_stack_value() here, but since
2483 : * we have type-specific code anyway, might as
2484 : * well inline it.
2485 : */
2486 416640 : set_string_field(conf, &stack->prior.val.stringval, NULL);
2487 416640 : set_string_field(conf, &stack->masked.val.stringval, NULL);
2488 416640 : break;
2489 : }
2490 16648 : case PGC_ENUM:
2491 : {
2492 16648 : struct config_enum *conf = (struct config_enum *) gconf;
2493 16648 : int newval = newvalue.val.enumval;
2494 16648 : void *newextra = newvalue.extra;
2495 :
2496 16648 : if (*conf->variable != newval ||
2497 1008 : conf->gen.extra != newextra)
2498 : {
2499 15640 : if (conf->assign_hook)
2500 30 : conf->assign_hook(newval, newextra);
2501 15640 : *conf->variable = newval;
2502 15640 : set_extra_field(&conf->gen, &conf->gen.extra,
2503 : newextra);
2504 15640 : changed = true;
2505 : }
2506 16648 : break;
2507 : }
2508 : }
2509 :
2510 : /*
2511 : * Release stacked extra values if not used anymore.
2512 : */
2513 448622 : set_extra_field(gconf, &(stack->prior.extra), NULL);
2514 448622 : set_extra_field(gconf, &(stack->masked.extra), NULL);
2515 :
2516 : /* And restore source information */
2517 448622 : set_guc_source(gconf, newsource);
2518 448622 : gconf->scontext = newscontext;
2519 448622 : gconf->srole = newsrole;
2520 : }
2521 :
2522 : /*
2523 : * Pop the GUC's state stack; if it's now empty, remove the GUC
2524 : * from guc_stack_list.
2525 : */
2526 503302 : gconf->stack = prev;
2527 503302 : if (prev == NULL)
2528 473012 : slist_delete_current(&iter);
2529 503302 : pfree(stack);
2530 :
2531 : /* Report new value if we changed it */
2532 503302 : if (changed && (gconf->flags & GUC_REPORT) &&
2533 424320 : !(gconf->status & GUC_NEEDS_REPORT))
2534 : {
2535 318 : gconf->status |= GUC_NEEDS_REPORT;
2536 318 : slist_push_head(&guc_report_list, &gconf->report_link);
2537 : }
2538 : } /* end of stack-popping loop */
2539 : }
2540 :
2541 : /* Update nesting level */
2542 1654806 : GUCNestLevel = nestLevel - 1;
2543 1654806 : }
2544 :
2545 :
2546 : /*
2547 : * Start up automatic reporting of changes to variables marked GUC_REPORT.
2548 : * This is executed at completion of backend startup.
2549 : */
2550 : void
2551 26118 : BeginReportingGUCOptions(void)
2552 : {
2553 : HASH_SEQ_STATUS status;
2554 : GUCHashEntry *hentry;
2555 :
2556 : /*
2557 : * Don't do anything unless talking to an interactive frontend.
2558 : */
2559 26118 : if (whereToSendOutput != DestRemote)
2560 134 : return;
2561 :
2562 25984 : reporting_enabled = true;
2563 :
2564 : /*
2565 : * Hack for in_hot_standby: set the GUC value true if appropriate. This
2566 : * is kind of an ugly place to do it, but there's few better options.
2567 : *
2568 : * (This could be out of date by the time we actually send it, in which
2569 : * case the next ReportChangedGUCOptions call will send a duplicate
2570 : * report.)
2571 : */
2572 25984 : if (RecoveryInProgress())
2573 1086 : SetConfigOption("in_hot_standby", "true",
2574 : PGC_INTERNAL, PGC_S_OVERRIDE);
2575 :
2576 : /* Transmit initial values of interesting variables */
2577 25984 : hash_seq_init(&status, guc_hashtab);
2578 10632100 : while ((hentry = (GUCHashEntry *) hash_seq_search(&status)) != NULL)
2579 : {
2580 10580132 : struct config_generic *conf = hentry->gucvar;
2581 :
2582 10580132 : if (conf->flags & GUC_REPORT)
2583 389760 : ReportGUCOption(conf);
2584 : }
2585 : }
2586 :
2587 : /*
2588 : * ReportChangedGUCOptions: report recently-changed GUC_REPORT variables
2589 : *
2590 : * This is called just before we wait for a new client query.
2591 : *
2592 : * By handling things this way, we ensure that a ParameterStatus message
2593 : * is sent at most once per variable per query, even if the variable
2594 : * changed multiple times within the query. That's quite possible when
2595 : * using features such as function SET clauses. Function SET clauses
2596 : * also tend to cause values to change intraquery but eventually revert
2597 : * to their prevailing values; ReportGUCOption is responsible for avoiding
2598 : * redundant reports in such cases.
2599 : */
2600 : void
2601 718416 : ReportChangedGUCOptions(void)
2602 : {
2603 : slist_mutable_iter iter;
2604 :
2605 : /* Quick exit if not (yet) enabled */
2606 718416 : if (!reporting_enabled)
2607 69662 : return;
2608 :
2609 : /*
2610 : * Since in_hot_standby isn't actually changed by normal GUC actions, we
2611 : * need a hack to check whether a new value needs to be reported to the
2612 : * client. For speed, we rely on the assumption that it can never
2613 : * transition from false to true.
2614 : */
2615 648754 : if (in_hot_standby_guc && !RecoveryInProgress())
2616 8 : SetConfigOption("in_hot_standby", "false",
2617 : PGC_INTERNAL, PGC_S_OVERRIDE);
2618 :
2619 : /* Transmit new values of interesting variables */
2620 901480 : slist_foreach_modify(iter, &guc_report_list)
2621 : {
2622 252726 : struct config_generic *conf = slist_container(struct config_generic,
2623 : report_link, iter.cur);
2624 :
2625 : Assert((conf->flags & GUC_REPORT) && (conf->status & GUC_NEEDS_REPORT));
2626 252726 : ReportGUCOption(conf);
2627 252726 : conf->status &= ~GUC_NEEDS_REPORT;
2628 252726 : slist_delete_current(&iter);
2629 : }
2630 : }
2631 :
2632 : /*
2633 : * ReportGUCOption: if appropriate, transmit option value to frontend
2634 : *
2635 : * We need not transmit the value if it's the same as what we last
2636 : * transmitted.
2637 : */
2638 : static void
2639 642486 : ReportGUCOption(struct config_generic *record)
2640 : {
2641 642486 : char *val = ShowGUCOption(record, false);
2642 :
2643 642486 : if (record->last_reported == NULL ||
2644 252726 : strcmp(val, record->last_reported) != 0)
2645 : {
2646 : StringInfoData msgbuf;
2647 :
2648 404150 : pq_beginmessage(&msgbuf, PqMsg_ParameterStatus);
2649 404150 : pq_sendstring(&msgbuf, record->name);
2650 404150 : pq_sendstring(&msgbuf, val);
2651 404150 : pq_endmessage(&msgbuf);
2652 :
2653 : /*
2654 : * We need a long-lifespan copy. If guc_strdup() fails due to OOM,
2655 : * we'll set last_reported to NULL and thereby possibly make a
2656 : * duplicate report later.
2657 : */
2658 404150 : guc_free(record->last_reported);
2659 404150 : record->last_reported = guc_strdup(LOG, val);
2660 : }
2661 :
2662 642486 : pfree(val);
2663 642486 : }
2664 :
2665 : /*
2666 : * Convert a value from one of the human-friendly units ("kB", "min" etc.)
2667 : * to the given base unit. 'value' and 'unit' are the input value and unit
2668 : * to convert from (there can be trailing spaces in the unit string).
2669 : * The converted value is stored in *base_value.
2670 : * It's caller's responsibility to round off the converted value as necessary
2671 : * and check for out-of-range.
2672 : *
2673 : * Returns true on success, false if the input unit is not recognized.
2674 : */
2675 : static bool
2676 14658 : convert_to_base_unit(double value, const char *unit,
2677 : int base_unit, double *base_value)
2678 : {
2679 : char unitstr[MAX_UNIT_LEN + 1];
2680 : int unitlen;
2681 : const unit_conversion *table;
2682 : int i;
2683 :
2684 : /* extract unit string to compare to table entries */
2685 14658 : unitlen = 0;
2686 43832 : while (*unit != '\0' && !isspace((unsigned char) *unit) &&
2687 : unitlen < MAX_UNIT_LEN)
2688 29174 : unitstr[unitlen++] = *(unit++);
2689 14658 : unitstr[unitlen] = '\0';
2690 : /* allow whitespace after unit */
2691 14658 : while (isspace((unsigned char) *unit))
2692 0 : unit++;
2693 14658 : if (*unit != '\0')
2694 0 : return false; /* unit too long, or garbage after it */
2695 :
2696 : /* now search the appropriate table */
2697 14658 : if (base_unit & GUC_UNIT_MEMORY)
2698 11278 : table = memory_unit_conversion_table;
2699 : else
2700 3380 : table = time_unit_conversion_table;
2701 :
2702 176118 : for (i = 0; *table[i].unit; i++)
2703 : {
2704 176118 : if (base_unit == table[i].base_unit &&
2705 49078 : strcmp(unitstr, table[i].unit) == 0)
2706 : {
2707 14658 : double cvalue = value * table[i].multiplier;
2708 :
2709 : /*
2710 : * If the user gave a fractional value such as "30.1GB", round it
2711 : * off to the nearest multiple of the next smaller unit, if there
2712 : * is one.
2713 : */
2714 14658 : if (*table[i + 1].unit &&
2715 14658 : base_unit == table[i + 1].base_unit)
2716 14652 : cvalue = rint(cvalue / table[i + 1].multiplier) *
2717 14652 : table[i + 1].multiplier;
2718 :
2719 14658 : *base_value = cvalue;
2720 14658 : return true;
2721 : }
2722 : }
2723 0 : return false;
2724 : }
2725 :
2726 : /*
2727 : * Convert an integer value in some base unit to a human-friendly unit.
2728 : *
2729 : * The output unit is chosen so that it's the greatest unit that can represent
2730 : * the value without loss. For example, if the base unit is GUC_UNIT_KB, 1024
2731 : * is converted to 1 MB, but 1025 is represented as 1025 kB.
2732 : */
2733 : static void
2734 756 : convert_int_from_base_unit(int64 base_value, int base_unit,
2735 : int64 *value, const char **unit)
2736 : {
2737 : const unit_conversion *table;
2738 : int i;
2739 :
2740 756 : *unit = NULL;
2741 :
2742 756 : if (base_unit & GUC_UNIT_MEMORY)
2743 652 : table = memory_unit_conversion_table;
2744 : else
2745 104 : table = time_unit_conversion_table;
2746 :
2747 5052 : for (i = 0; *table[i].unit; i++)
2748 : {
2749 5052 : if (base_unit == table[i].base_unit)
2750 : {
2751 : /*
2752 : * Accept the first conversion that divides the value evenly. We
2753 : * assume that the conversions for each base unit are ordered from
2754 : * greatest unit to the smallest!
2755 : */
2756 2346 : if (table[i].multiplier <= 1.0 ||
2757 2232 : base_value % (int64) table[i].multiplier == 0)
2758 : {
2759 756 : *value = (int64) rint(base_value / table[i].multiplier);
2760 756 : *unit = table[i].unit;
2761 756 : break;
2762 : }
2763 : }
2764 : }
2765 :
2766 : Assert(*unit != NULL);
2767 756 : }
2768 :
2769 : /*
2770 : * Convert a floating-point value in some base unit to a human-friendly unit.
2771 : *
2772 : * Same as above, except we have to do the math a bit differently, and
2773 : * there's a possibility that we don't find any exact divisor.
2774 : */
2775 : static void
2776 268 : convert_real_from_base_unit(double base_value, int base_unit,
2777 : double *value, const char **unit)
2778 : {
2779 : const unit_conversion *table;
2780 : int i;
2781 :
2782 268 : *unit = NULL;
2783 :
2784 268 : if (base_unit & GUC_UNIT_MEMORY)
2785 0 : table = memory_unit_conversion_table;
2786 : else
2787 268 : table = time_unit_conversion_table;
2788 :
2789 1364 : for (i = 0; *table[i].unit; i++)
2790 : {
2791 1364 : if (base_unit == table[i].base_unit)
2792 : {
2793 : /*
2794 : * Accept the first conversion that divides the value evenly; or
2795 : * if there is none, use the smallest (last) target unit.
2796 : *
2797 : * What we actually care about here is whether snprintf with "%g"
2798 : * will print the value as an integer, so the obvious test of
2799 : * "*value == rint(*value)" is too strict; roundoff error might
2800 : * make us choose an unreasonably small unit. As a compromise,
2801 : * accept a divisor that is within 1e-8 of producing an integer.
2802 : */
2803 1364 : *value = base_value / table[i].multiplier;
2804 1364 : *unit = table[i].unit;
2805 1364 : if (*value > 0 &&
2806 1364 : fabs((rint(*value) / *value) - 1.0) <= 1e-8)
2807 268 : break;
2808 : }
2809 : }
2810 :
2811 : Assert(*unit != NULL);
2812 268 : }
2813 :
2814 : /*
2815 : * Return the name of a GUC's base unit (e.g. "ms") given its flags.
2816 : * Return NULL if the GUC is unitless.
2817 : */
2818 : const char *
2819 1403768 : get_config_unit_name(int flags)
2820 : {
2821 1403768 : switch (flags & GUC_UNIT)
2822 : {
2823 1133570 : case 0:
2824 1133570 : return NULL; /* GUC has no units */
2825 17320 : case GUC_UNIT_BYTE:
2826 17320 : return "B";
2827 41568 : case GUC_UNIT_KB:
2828 41568 : return "kB";
2829 20784 : case GUC_UNIT_MB:
2830 20784 : return "MB";
2831 62352 : case GUC_UNIT_BLOCKS:
2832 : {
2833 : static char bbuf[8];
2834 :
2835 : /* initialize if first time through */
2836 62352 : if (bbuf[0] == '\0')
2837 514 : snprintf(bbuf, sizeof(bbuf), "%dkB", BLCKSZ / 1024);
2838 62352 : return bbuf;
2839 : }
2840 6928 : case GUC_UNIT_XBLOCKS:
2841 : {
2842 : static char xbuf[8];
2843 :
2844 : /* initialize if first time through */
2845 6928 : if (xbuf[0] == '\0')
2846 514 : snprintf(xbuf, sizeof(xbuf), "%dkB", XLOG_BLCKSZ / 1024);
2847 6928 : return xbuf;
2848 : }
2849 76214 : case GUC_UNIT_MS:
2850 76214 : return "ms";
2851 38104 : case GUC_UNIT_S:
2852 38104 : return "s";
2853 6928 : case GUC_UNIT_MIN:
2854 6928 : return "min";
2855 0 : default:
2856 0 : elog(ERROR, "unrecognized GUC units value: %d",
2857 : flags & GUC_UNIT);
2858 : return NULL;
2859 : }
2860 : }
2861 :
2862 :
2863 : /*
2864 : * Try to parse value as an integer. The accepted formats are the
2865 : * usual decimal, octal, or hexadecimal formats, as well as floating-point
2866 : * formats (which will be rounded to integer after any units conversion).
2867 : * Optionally, the value can be followed by a unit name if "flags" indicates
2868 : * a unit is allowed.
2869 : *
2870 : * If the string parses okay, return true, else false.
2871 : * If okay and result is not NULL, return the value in *result.
2872 : * If not okay and hintmsg is not NULL, *hintmsg is set to a suitable
2873 : * HINT message, or NULL if no hint provided.
2874 : */
2875 : bool
2876 122108 : parse_int(const char *value, int *result, int flags, const char **hintmsg)
2877 : {
2878 : /*
2879 : * We assume here that double is wide enough to represent any integer
2880 : * value with adequate precision.
2881 : */
2882 : double val;
2883 : char *endptr;
2884 :
2885 : /* To suppress compiler warnings, always set output params */
2886 122108 : if (result)
2887 122108 : *result = 0;
2888 122108 : if (hintmsg)
2889 113476 : *hintmsg = NULL;
2890 :
2891 : /*
2892 : * Try to parse as an integer (allowing octal or hex input). If the
2893 : * conversion stops at a decimal point or 'e', or overflows, re-parse as
2894 : * float. This should work fine as long as we have no unit names starting
2895 : * with 'e'. If we ever do, the test could be extended to check for a
2896 : * sign or digit after 'e', but for now that's unnecessary.
2897 : */
2898 122108 : errno = 0;
2899 122108 : val = strtol(value, &endptr, 0);
2900 122108 : if (*endptr == '.' || *endptr == 'e' || *endptr == 'E' ||
2901 122096 : errno == ERANGE)
2902 : {
2903 12 : errno = 0;
2904 12 : val = strtod(value, &endptr);
2905 : }
2906 :
2907 122108 : if (endptr == value || errno == ERANGE)
2908 22 : return false; /* no HINT for these cases */
2909 :
2910 : /* reject NaN (infinities will fail range check below) */
2911 122086 : if (isnan(val))
2912 0 : return false; /* treat same as syntax error; no HINT */
2913 :
2914 : /* allow whitespace between number and unit */
2915 122126 : while (isspace((unsigned char) *endptr))
2916 40 : endptr++;
2917 :
2918 : /* Handle possible unit */
2919 122086 : if (*endptr != '\0')
2920 : {
2921 14650 : if ((flags & GUC_UNIT) == 0)
2922 4 : return false; /* this setting does not accept a unit */
2923 :
2924 14646 : if (!convert_to_base_unit(val,
2925 : endptr, (flags & GUC_UNIT),
2926 : &val))
2927 : {
2928 : /* invalid unit, or garbage after the unit; set hint and fail. */
2929 0 : if (hintmsg)
2930 : {
2931 0 : if (flags & GUC_UNIT_MEMORY)
2932 0 : *hintmsg = memory_units_hint;
2933 : else
2934 0 : *hintmsg = time_units_hint;
2935 : }
2936 0 : return false;
2937 : }
2938 : }
2939 :
2940 : /* Round to int, then check for overflow */
2941 122082 : val = rint(val);
2942 :
2943 122082 : if (val > INT_MAX || val < INT_MIN)
2944 : {
2945 6 : if (hintmsg)
2946 6 : *hintmsg = gettext_noop("Value exceeds integer range.");
2947 6 : return false;
2948 : }
2949 :
2950 122076 : if (result)
2951 122076 : *result = (int) val;
2952 122076 : return true;
2953 : }
2954 :
2955 : /*
2956 : * Try to parse value as a floating point number in the usual format.
2957 : * Optionally, the value can be followed by a unit name if "flags" indicates
2958 : * a unit is allowed.
2959 : *
2960 : * If the string parses okay, return true, else false.
2961 : * If okay and result is not NULL, return the value in *result.
2962 : * If not okay and hintmsg is not NULL, *hintmsg is set to a suitable
2963 : * HINT message, or NULL if no hint provided.
2964 : */
2965 : bool
2966 8716 : parse_real(const char *value, double *result, int flags, const char **hintmsg)
2967 : {
2968 : double val;
2969 : char *endptr;
2970 :
2971 : /* To suppress compiler warnings, always set output params */
2972 8716 : if (result)
2973 8716 : *result = 0;
2974 8716 : if (hintmsg)
2975 8190 : *hintmsg = NULL;
2976 :
2977 8716 : errno = 0;
2978 8716 : val = strtod(value, &endptr);
2979 :
2980 8716 : if (endptr == value || errno == ERANGE)
2981 16 : return false; /* no HINT for these cases */
2982 :
2983 : /* reject NaN (infinities will fail range checks later) */
2984 8700 : if (isnan(val))
2985 6 : return false; /* treat same as syntax error; no HINT */
2986 :
2987 : /* allow whitespace between number and unit */
2988 8694 : while (isspace((unsigned char) *endptr))
2989 0 : endptr++;
2990 :
2991 : /* Handle possible unit */
2992 8694 : if (*endptr != '\0')
2993 : {
2994 16 : if ((flags & GUC_UNIT) == 0)
2995 4 : return false; /* this setting does not accept a unit */
2996 :
2997 12 : if (!convert_to_base_unit(val,
2998 : endptr, (flags & GUC_UNIT),
2999 : &val))
3000 : {
3001 : /* invalid unit, or garbage after the unit; set hint and fail. */
3002 0 : if (hintmsg)
3003 : {
3004 0 : if (flags & GUC_UNIT_MEMORY)
3005 0 : *hintmsg = memory_units_hint;
3006 : else
3007 0 : *hintmsg = time_units_hint;
3008 : }
3009 0 : return false;
3010 : }
3011 : }
3012 :
3013 8690 : if (result)
3014 8690 : *result = val;
3015 8690 : return true;
3016 : }
3017 :
3018 :
3019 : /*
3020 : * Lookup the name for an enum option with the selected value.
3021 : * Should only ever be called with known-valid values, so throws
3022 : * an elog(ERROR) if the enum option is not found.
3023 : *
3024 : * The returned string is a pointer to static data and not
3025 : * allocated for modification.
3026 : */
3027 : const char *
3028 467760 : config_enum_lookup_by_value(struct config_enum *record, int val)
3029 : {
3030 : const struct config_enum_entry *entry;
3031 :
3032 1152506 : for (entry = record->options; entry && entry->name; entry++)
3033 : {
3034 1152506 : if (entry->val == val)
3035 467760 : return entry->name;
3036 : }
3037 :
3038 0 : elog(ERROR, "could not find enum option %d for %s",
3039 : val, record->gen.name);
3040 : return NULL; /* silence compiler */
3041 : }
3042 :
3043 :
3044 : /*
3045 : * Lookup the value for an enum option with the selected name
3046 : * (case-insensitive).
3047 : * If the enum option is found, sets the retval value and returns
3048 : * true. If it's not found, return false and retval is set to 0.
3049 : */
3050 : bool
3051 76240 : config_enum_lookup_by_name(struct config_enum *record, const char *value,
3052 : int *retval)
3053 : {
3054 : const struct config_enum_entry *entry;
3055 :
3056 165084 : for (entry = record->options; entry && entry->name; entry++)
3057 : {
3058 165046 : if (pg_strcasecmp(value, entry->name) == 0)
3059 : {
3060 76202 : *retval = entry->val;
3061 76202 : return true;
3062 : }
3063 : }
3064 :
3065 38 : *retval = 0;
3066 38 : return false;
3067 : }
3068 :
3069 :
3070 : /*
3071 : * Return a palloc'd string listing all the available options for an enum GUC
3072 : * (excluding hidden ones), separated by the given separator.
3073 : * If prefix is non-NULL, it is added before the first enum value.
3074 : * If suffix is non-NULL, it is added to the end of the string.
3075 : */
3076 : char *
3077 141568 : config_enum_get_options(struct config_enum *record, const char *prefix,
3078 : const char *suffix, const char *separator)
3079 : {
3080 : const struct config_enum_entry *entry;
3081 : StringInfoData retstr;
3082 : int seplen;
3083 :
3084 141568 : initStringInfo(&retstr);
3085 141568 : appendStringInfoString(&retstr, prefix);
3086 :
3087 141568 : seplen = strlen(separator);
3088 912664 : for (entry = record->options; entry && entry->name; entry++)
3089 : {
3090 771096 : if (!entry->hidden)
3091 : {
3092 556292 : appendStringInfoString(&retstr, entry->name);
3093 556292 : appendBinaryStringInfo(&retstr, separator, seplen);
3094 : }
3095 : }
3096 :
3097 : /*
3098 : * All the entries may have been hidden, leaving the string empty if no
3099 : * prefix was given. This indicates a broken GUC setup, since there is no
3100 : * use for an enum without any values, so we just check to make sure we
3101 : * don't write to invalid memory instead of actually trying to do
3102 : * something smart with it.
3103 : */
3104 141568 : if (retstr.len >= seplen)
3105 : {
3106 : /* Replace final separator */
3107 141568 : retstr.data[retstr.len - seplen] = '\0';
3108 141568 : retstr.len -= seplen;
3109 : }
3110 :
3111 141568 : appendStringInfoString(&retstr, suffix);
3112 :
3113 141568 : return retstr.data;
3114 : }
3115 :
3116 : /*
3117 : * Parse and validate a proposed value for the specified configuration
3118 : * parameter.
3119 : *
3120 : * This does built-in checks (such as range limits for an integer parameter)
3121 : * and also calls any check hook the parameter may have.
3122 : *
3123 : * record: GUC variable's info record
3124 : * value: proposed value, as a string
3125 : * source: identifies source of value (check hooks may need this)
3126 : * elevel: level to log any error reports at
3127 : * newval: on success, converted parameter value is returned here
3128 : * newextra: on success, receives any "extra" data returned by check hook
3129 : * (caller must initialize *newextra to NULL)
3130 : *
3131 : * Returns true if OK, false if not (or throws error, if elevel >= ERROR)
3132 : */
3133 : static bool
3134 1082810 : parse_and_validate_value(struct config_generic *record,
3135 : const char *value,
3136 : GucSource source, int elevel,
3137 : union config_var_val *newval, void **newextra)
3138 : {
3139 1082810 : switch (record->vartype)
3140 : {
3141 157220 : case PGC_BOOL:
3142 : {
3143 157220 : struct config_bool *conf = (struct config_bool *) record;
3144 :
3145 157220 : if (!parse_bool(value, &newval->boolval))
3146 : {
3147 0 : ereport(elevel,
3148 : (errcode(ERRCODE_INVALID_PARAMETER_VALUE),
3149 : errmsg("parameter \"%s\" requires a Boolean value",
3150 : conf->gen.name)));
3151 0 : return false;
3152 : }
3153 :
3154 157220 : if (!call_bool_check_hook(conf, &newval->boolval, newextra,
3155 : source, elevel))
3156 0 : return false;
3157 : }
3158 157196 : break;
3159 113422 : case PGC_INT:
3160 : {
3161 113422 : struct config_int *conf = (struct config_int *) record;
3162 : const char *hintmsg;
3163 :
3164 113422 : if (!parse_int(value, &newval->intval,
3165 : conf->gen.flags, &hintmsg))
3166 : {
3167 0 : ereport(elevel,
3168 : (errcode(ERRCODE_INVALID_PARAMETER_VALUE),
3169 : errmsg("invalid value for parameter \"%s\": \"%s\"",
3170 : conf->gen.name, value),
3171 : hintmsg ? errhint("%s", _(hintmsg)) : 0));
3172 0 : return false;
3173 : }
3174 :
3175 113422 : if (newval->intval < conf->min || newval->intval > conf->max)
3176 : {
3177 4 : const char *unit = get_config_unit_name(conf->gen.flags);
3178 : const char *unitspace;
3179 :
3180 4 : if (unit)
3181 0 : unitspace = " ";
3182 : else
3183 4 : unit = unitspace = "";
3184 :
3185 4 : ereport(elevel,
3186 : (errcode(ERRCODE_INVALID_PARAMETER_VALUE),
3187 : errmsg("%d%s%s is outside the valid range for parameter \"%s\" (%d%s%s .. %d%s%s)",
3188 : newval->intval, unitspace, unit,
3189 : conf->gen.name,
3190 : conf->min, unitspace, unit,
3191 : conf->max, unitspace, unit)));
3192 0 : return false;
3193 : }
3194 :
3195 113418 : if (!call_int_check_hook(conf, &newval->intval, newextra,
3196 : source, elevel))
3197 0 : return false;
3198 : }
3199 113418 : break;
3200 8190 : case PGC_REAL:
3201 : {
3202 8190 : struct config_real *conf = (struct config_real *) record;
3203 : const char *hintmsg;
3204 :
3205 8190 : if (!parse_real(value, &newval->realval,
3206 : conf->gen.flags, &hintmsg))
3207 : {
3208 6 : ereport(elevel,
3209 : (errcode(ERRCODE_INVALID_PARAMETER_VALUE),
3210 : errmsg("invalid value for parameter \"%s\": \"%s\"",
3211 : conf->gen.name, value),
3212 : hintmsg ? errhint("%s", _(hintmsg)) : 0));
3213 0 : return false;
3214 : }
3215 :
3216 8184 : if (newval->realval < conf->min || newval->realval > conf->max)
3217 : {
3218 6 : const char *unit = get_config_unit_name(conf->gen.flags);
3219 : const char *unitspace;
3220 :
3221 6 : if (unit)
3222 6 : unitspace = " ";
3223 : else
3224 0 : unit = unitspace = "";
3225 :
3226 6 : ereport(elevel,
3227 : (errcode(ERRCODE_INVALID_PARAMETER_VALUE),
3228 : errmsg("%g%s%s is outside the valid range for parameter \"%s\" (%g%s%s .. %g%s%s)",
3229 : newval->realval, unitspace, unit,
3230 : conf->gen.name,
3231 : conf->min, unitspace, unit,
3232 : conf->max, unitspace, unit)));
3233 0 : return false;
3234 : }
3235 :
3236 8178 : if (!call_real_check_hook(conf, &newval->realval, newextra,
3237 : source, elevel))
3238 0 : return false;
3239 : }
3240 8178 : break;
3241 727738 : case PGC_STRING:
3242 : {
3243 727738 : struct config_string *conf = (struct config_string *) record;
3244 :
3245 : /*
3246 : * The value passed by the caller could be transient, so we
3247 : * always strdup it.
3248 : */
3249 727738 : newval->stringval = guc_strdup(elevel, value);
3250 727738 : if (newval->stringval == NULL)
3251 0 : return false;
3252 :
3253 : /*
3254 : * The only built-in "parsing" check we have is to apply
3255 : * truncation if GUC_IS_NAME.
3256 : */
3257 727738 : if (conf->gen.flags & GUC_IS_NAME)
3258 170920 : truncate_identifier(newval->stringval,
3259 170920 : strlen(newval->stringval),
3260 : true);
3261 :
3262 727738 : if (!call_string_check_hook(conf, &newval->stringval, newextra,
3263 : source, elevel))
3264 : {
3265 6 : guc_free(newval->stringval);
3266 6 : newval->stringval = NULL;
3267 6 : return false;
3268 : }
3269 : }
3270 727690 : break;
3271 76240 : case PGC_ENUM:
3272 : {
3273 76240 : struct config_enum *conf = (struct config_enum *) record;
3274 :
3275 76240 : if (!config_enum_lookup_by_name(conf, value, &newval->enumval))
3276 : {
3277 : char *hintmsg;
3278 :
3279 38 : hintmsg = config_enum_get_options(conf,
3280 : "Available values: ",
3281 : ".", ", ");
3282 :
3283 38 : ereport(elevel,
3284 : (errcode(ERRCODE_INVALID_PARAMETER_VALUE),
3285 : errmsg("invalid value for parameter \"%s\": \"%s\"",
3286 : conf->gen.name, value),
3287 : hintmsg ? errhint("%s", _(hintmsg)) : 0));
3288 :
3289 0 : if (hintmsg)
3290 0 : pfree(hintmsg);
3291 0 : return false;
3292 : }
3293 :
3294 76202 : if (!call_enum_check_hook(conf, &newval->enumval, newextra,
3295 : source, elevel))
3296 0 : return false;
3297 : }
3298 76200 : break;
3299 : }
3300 :
3301 1082682 : return true;
3302 : }
3303 :
3304 :
3305 : /*
3306 : * set_config_option: sets option `name' to given value.
3307 : *
3308 : * The value should be a string, which will be parsed and converted to
3309 : * the appropriate data type. The context and source parameters indicate
3310 : * in which context this function is being called, so that it can apply the
3311 : * access restrictions properly.
3312 : *
3313 : * If value is NULL, set the option to its default value (normally the
3314 : * reset_val, but if source == PGC_S_DEFAULT we instead use the boot_val).
3315 : *
3316 : * action indicates whether to set the value globally in the session, locally
3317 : * to the current top transaction, or just for the duration of a function call.
3318 : *
3319 : * If changeVal is false then don't really set the option but do all
3320 : * the checks to see if it would work.
3321 : *
3322 : * elevel should normally be passed as zero, allowing this function to make
3323 : * its standard choice of ereport level. However some callers need to be
3324 : * able to override that choice; they should pass the ereport level to use.
3325 : *
3326 : * is_reload should be true only when called from read_nondefault_variables()
3327 : * or RestoreGUCState(), where we are trying to load some other process's
3328 : * GUC settings into a new process.
3329 : *
3330 : * Return value:
3331 : * +1: the value is valid and was successfully applied.
3332 : * 0: the name or value is invalid, or it's invalid to try to set
3333 : * this GUC now; but elevel was less than ERROR (see below).
3334 : * -1: no error detected, but the value was not applied, either
3335 : * because changeVal is false or there is some overriding setting.
3336 : *
3337 : * If there is an error (non-existing option, invalid value, etc) then an
3338 : * ereport(ERROR) is thrown *unless* this is called for a source for which
3339 : * we don't want an ERROR (currently, those are defaults, the config file,
3340 : * and per-database or per-user settings, as well as callers who specify
3341 : * a less-than-ERROR elevel). In those cases we write a suitable error
3342 : * message via ereport() and return 0.
3343 : *
3344 : * See also SetConfigOption for an external interface.
3345 : */
3346 : int
3347 959960 : set_config_option(const char *name, const char *value,
3348 : GucContext context, GucSource source,
3349 : GucAction action, bool changeVal, int elevel,
3350 : bool is_reload)
3351 : {
3352 : Oid srole;
3353 :
3354 : /*
3355 : * Non-interactive sources should be treated as having all privileges,
3356 : * except for PGC_S_CLIENT. Note in particular that this is true for
3357 : * pg_db_role_setting sources (PGC_S_GLOBAL etc): we assume a suitable
3358 : * privilege check was done when the pg_db_role_setting entry was made.
3359 : */
3360 959960 : if (source >= PGC_S_INTERACTIVE || source == PGC_S_CLIENT)
3361 538518 : srole = GetUserId();
3362 : else
3363 421442 : srole = BOOTSTRAP_SUPERUSERID;
3364 :
3365 959960 : return set_config_with_handle(name, NULL, value,
3366 : context, source, srole,
3367 : action, changeVal, elevel,
3368 : is_reload);
3369 : }
3370 :
3371 : /*
3372 : * set_config_option_ext: sets option `name' to given value.
3373 : *
3374 : * This API adds the ability to explicitly specify which role OID
3375 : * is considered to be setting the value. Most external callers can use
3376 : * set_config_option() and let it determine that based on the GucSource,
3377 : * but there are a few that are supplying a value that was determined
3378 : * in some special way and need to override the decision. Also, when
3379 : * restoring a previously-assigned value, it's important to supply the
3380 : * same role OID that set the value originally; so all guc.c callers
3381 : * that are doing that type of thing need to call this directly.
3382 : *
3383 : * Generally, srole should be GetUserId() when the source is a SQL operation,
3384 : * or BOOTSTRAP_SUPERUSERID if the source is a config file or similar.
3385 : */
3386 : int
3387 97866 : set_config_option_ext(const char *name, const char *value,
3388 : GucContext context, GucSource source, Oid srole,
3389 : GucAction action, bool changeVal, int elevel,
3390 : bool is_reload)
3391 : {
3392 97866 : return set_config_with_handle(name, NULL, value,
3393 : context, source, srole,
3394 : action, changeVal, elevel,
3395 : is_reload);
3396 : }
3397 :
3398 :
3399 : /*
3400 : * set_config_with_handle: sets option `name' to given value.
3401 : *
3402 : * This API adds the ability to pass a 'handle' argument, which can be
3403 : * obtained by the caller from get_config_handle(). NULL has no effect,
3404 : * but a non-null value avoids the need to search the GUC tables.
3405 : *
3406 : * This should be used by callers which repeatedly set the same config
3407 : * option(s), and want to avoid the overhead of a hash lookup each time.
3408 : */
3409 : int
3410 1088448 : set_config_with_handle(const char *name, config_handle *handle,
3411 : const char *value,
3412 : GucContext context, GucSource source, Oid srole,
3413 : GucAction action, bool changeVal, int elevel,
3414 : bool is_reload)
3415 : {
3416 : struct config_generic *record;
3417 : union config_var_val newval_union;
3418 1088448 : void *newextra = NULL;
3419 1088448 : bool prohibitValueChange = false;
3420 : bool makeDefault;
3421 :
3422 1088448 : if (elevel == 0)
3423 : {
3424 960156 : if (source == PGC_S_DEFAULT || source == PGC_S_FILE)
3425 : {
3426 : /*
3427 : * To avoid cluttering the log, only the postmaster bleats loudly
3428 : * about problems with the config file.
3429 : */
3430 95326 : elevel = IsUnderPostmaster ? DEBUG3 : LOG;
3431 : }
3432 864830 : else if (source == PGC_S_GLOBAL ||
3433 824044 : source == PGC_S_DATABASE ||
3434 824040 : source == PGC_S_USER ||
3435 : source == PGC_S_DATABASE_USER)
3436 40790 : elevel = WARNING;
3437 : else
3438 824040 : elevel = ERROR;
3439 : }
3440 :
3441 : /* if handle is specified, no need to look up option */
3442 1088448 : if (!handle)
3443 : {
3444 1088264 : record = find_option(name, true, false, elevel);
3445 1088192 : if (record == NULL)
3446 0 : return 0;
3447 : }
3448 : else
3449 184 : record = handle;
3450 :
3451 : /*
3452 : * GUC_ACTION_SAVE changes are acceptable during a parallel operation,
3453 : * because the current worker will also pop the change. We're probably
3454 : * dealing with a function having a proconfig entry. Only the function's
3455 : * body should observe the change, and peer workers do not share in the
3456 : * execution of a function call started by this worker.
3457 : *
3458 : * Also allow normal setting if the GUC is marked GUC_ALLOW_IN_PARALLEL.
3459 : *
3460 : * Other changes might need to affect other workers, so forbid them.
3461 : */
3462 1088376 : if (IsInParallelMode() && changeVal && action != GUC_ACTION_SAVE &&
3463 18 : (record->flags & GUC_ALLOW_IN_PARALLEL) == 0)
3464 : {
3465 0 : ereport(elevel,
3466 : (errcode(ERRCODE_INVALID_TRANSACTION_STATE),
3467 : errmsg("parameter \"%s\" cannot be set during a parallel operation",
3468 : record->name)));
3469 0 : return 0;
3470 : }
3471 :
3472 : /*
3473 : * Check if the option can be set at this time. See guc.h for the precise
3474 : * rules.
3475 : */
3476 1088376 : switch (record->context)
3477 : {
3478 131376 : case PGC_INTERNAL:
3479 131376 : if (context != PGC_INTERNAL)
3480 : {
3481 4 : ereport(elevel,
3482 : (errcode(ERRCODE_CANT_CHANGE_RUNTIME_PARAM),
3483 : errmsg("parameter \"%s\" cannot be changed",
3484 : record->name)));
3485 0 : return 0;
3486 : }
3487 131372 : break;
3488 61602 : case PGC_POSTMASTER:
3489 61602 : if (context == PGC_SIGHUP)
3490 : {
3491 : /*
3492 : * We are re-reading a PGC_POSTMASTER variable from
3493 : * postgresql.conf. We can't change the setting, so we should
3494 : * give a warning if the DBA tries to change it. However,
3495 : * because of variant formats, canonicalization by check
3496 : * hooks, etc, we can't just compare the given string directly
3497 : * to what's stored. Set a flag to check below after we have
3498 : * the final storable value.
3499 : */
3500 15666 : prohibitValueChange = true;
3501 : }
3502 45936 : else if (context != PGC_POSTMASTER)
3503 : {
3504 8 : ereport(elevel,
3505 : (errcode(ERRCODE_CANT_CHANGE_RUNTIME_PARAM),
3506 : errmsg("parameter \"%s\" cannot be changed without restarting the server",
3507 : record->name)));
3508 0 : return 0;
3509 : }
3510 61594 : break;
3511 49110 : case PGC_SIGHUP:
3512 49110 : if (context != PGC_SIGHUP && context != PGC_POSTMASTER)
3513 : {
3514 6 : ereport(elevel,
3515 : (errcode(ERRCODE_CANT_CHANGE_RUNTIME_PARAM),
3516 : errmsg("parameter \"%s\" cannot be changed now",
3517 : record->name)));
3518 0 : return 0;
3519 : }
3520 :
3521 : /*
3522 : * Hmm, the idea of the SIGHUP context is "ought to be global, but
3523 : * can be changed after postmaster start". But there's nothing
3524 : * that prevents a crafty administrator from sending SIGHUP
3525 : * signals to individual backends only.
3526 : */
3527 49104 : break;
3528 314 : case PGC_SU_BACKEND:
3529 314 : if (context == PGC_BACKEND)
3530 : {
3531 : /*
3532 : * Check whether the requesting user has been granted
3533 : * privilege to set this GUC.
3534 : */
3535 : AclResult aclresult;
3536 :
3537 0 : aclresult = pg_parameter_aclcheck(record->name, srole, ACL_SET);
3538 0 : if (aclresult != ACLCHECK_OK)
3539 : {
3540 : /* No granted privilege */
3541 0 : ereport(elevel,
3542 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
3543 : errmsg("permission denied to set parameter \"%s\"",
3544 : record->name)));
3545 0 : return 0;
3546 : }
3547 : }
3548 : /* fall through to process the same as PGC_BACKEND */
3549 : /* FALLTHROUGH */
3550 : case PGC_BACKEND:
3551 318 : if (context == PGC_SIGHUP)
3552 : {
3553 : /*
3554 : * If a PGC_BACKEND or PGC_SU_BACKEND parameter is changed in
3555 : * the config file, we want to accept the new value in the
3556 : * postmaster (whence it will propagate to
3557 : * subsequently-started backends), but ignore it in existing
3558 : * backends. This is a tad klugy, but necessary because we
3559 : * don't re-read the config file during backend start.
3560 : *
3561 : * However, if changeVal is false then plow ahead anyway since
3562 : * we are trying to find out if the value is potentially good,
3563 : * not actually use it.
3564 : *
3565 : * In EXEC_BACKEND builds, this works differently: we load all
3566 : * non-default settings from the CONFIG_EXEC_PARAMS file
3567 : * during backend start. In that case we must accept
3568 : * PGC_SIGHUP settings, so as to have the same value as if
3569 : * we'd forked from the postmaster. This can also happen when
3570 : * using RestoreGUCState() within a background worker that
3571 : * needs to have the same settings as the user backend that
3572 : * started it. is_reload will be true when either situation
3573 : * applies.
3574 : */
3575 172 : if (IsUnderPostmaster && changeVal && !is_reload)
3576 72 : return -1;
3577 : }
3578 146 : else if (context != PGC_POSTMASTER &&
3579 8 : context != PGC_BACKEND &&
3580 8 : context != PGC_SU_BACKEND &&
3581 : source != PGC_S_CLIENT)
3582 : {
3583 8 : ereport(elevel,
3584 : (errcode(ERRCODE_CANT_CHANGE_RUNTIME_PARAM),
3585 : errmsg("parameter \"%s\" cannot be set after connection start",
3586 : record->name)));
3587 0 : return 0;
3588 : }
3589 238 : break;
3590 41756 : case PGC_SUSET:
3591 41756 : if (context == PGC_USERSET || context == PGC_BACKEND)
3592 : {
3593 : /*
3594 : * Check whether the requesting user has been granted
3595 : * privilege to set this GUC.
3596 : */
3597 : AclResult aclresult;
3598 :
3599 30 : aclresult = pg_parameter_aclcheck(record->name, srole, ACL_SET);
3600 30 : if (aclresult != ACLCHECK_OK)
3601 : {
3602 : /* No granted privilege */
3603 16 : ereport(elevel,
3604 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
3605 : errmsg("permission denied to set parameter \"%s\"",
3606 : record->name)));
3607 4 : return 0;
3608 : }
3609 : }
3610 41740 : break;
3611 804214 : case PGC_USERSET:
3612 : /* always okay */
3613 804214 : break;
3614 : }
3615 :
3616 : /*
3617 : * Disallow changing GUC_NOT_WHILE_SEC_REST values if we are inside a
3618 : * security restriction context. We can reject this regardless of the GUC
3619 : * context or source, mainly because sources that it might be reasonable
3620 : * to override for won't be seen while inside a function.
3621 : *
3622 : * Note: variables marked GUC_NOT_WHILE_SEC_REST should usually be marked
3623 : * GUC_NO_RESET_ALL as well, because ResetAllOptions() doesn't check this.
3624 : * An exception might be made if the reset value is assumed to be "safe".
3625 : *
3626 : * Note: this flag is currently used for "session_authorization" and
3627 : * "role". We need to prohibit changing these inside a local userid
3628 : * context because when we exit it, GUC won't be notified, leaving things
3629 : * out of sync. (This could be fixed by forcing a new GUC nesting level,
3630 : * but that would change behavior in possibly-undesirable ways.) Also, we
3631 : * prohibit changing these in a security-restricted operation because
3632 : * otherwise RESET could be used to regain the session user's privileges.
3633 : */
3634 1088262 : if (record->flags & GUC_NOT_WHILE_SEC_REST)
3635 : {
3636 68036 : if (InLocalUserIdChange())
3637 : {
3638 : /*
3639 : * Phrasing of this error message is historical, but it's the most
3640 : * common case.
3641 : */
3642 0 : ereport(elevel,
3643 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
3644 : errmsg("cannot set parameter \"%s\" within security-definer function",
3645 : record->name)));
3646 0 : return 0;
3647 : }
3648 68036 : if (InSecurityRestrictedOperation())
3649 : {
3650 0 : ereport(elevel,
3651 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
3652 : errmsg("cannot set parameter \"%s\" within security-restricted operation",
3653 : record->name)));
3654 0 : return 0;
3655 : }
3656 : }
3657 :
3658 : /* Disallow resetting and saving GUC_NO_RESET values */
3659 1088262 : if (record->flags & GUC_NO_RESET)
3660 : {
3661 23466 : if (value == NULL)
3662 : {
3663 18 : ereport(elevel,
3664 : (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
3665 : errmsg("parameter \"%s\" cannot be reset", record->name)));
3666 0 : return 0;
3667 : }
3668 23448 : if (action == GUC_ACTION_SAVE)
3669 : {
3670 6 : ereport(elevel,
3671 : (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
3672 : errmsg("parameter \"%s\" cannot be set locally in functions",
3673 : record->name)));
3674 0 : return 0;
3675 : }
3676 : }
3677 :
3678 : /*
3679 : * Should we set reset/stacked values? (If so, the behavior is not
3680 : * transactional.) This is done either when we get a default value from
3681 : * the database's/user's/client's default settings or when we reset a
3682 : * value to its default.
3683 : */
3684 1088242 : makeDefault = changeVal && (source <= PGC_S_OVERRIDE) &&
3685 4 : ((value != NULL) || source == PGC_S_DEFAULT);
3686 :
3687 : /*
3688 : * Ignore attempted set if overridden by previously processed setting.
3689 : * However, if changeVal is false then plow ahead anyway since we are
3690 : * trying to find out if the value is potentially good, not actually use
3691 : * it. Also keep going if makeDefault is true, since we may want to set
3692 : * the reset/stacked values even if we can't set the variable itself.
3693 : */
3694 1088238 : if (record->source > source)
3695 : {
3696 2178 : if (changeVal && !makeDefault)
3697 : {
3698 0 : elog(DEBUG3, "\"%s\": setting ignored because previous source is higher priority",
3699 : record->name);
3700 0 : return -1;
3701 : }
3702 2178 : changeVal = false;
3703 : }
3704 :
3705 : /*
3706 : * Evaluate value and set variable.
3707 : */
3708 1088238 : switch (record->vartype)
3709 : {
3710 158686 : case PGC_BOOL:
3711 : {
3712 158686 : struct config_bool *conf = (struct config_bool *) record;
3713 :
3714 : #define newval (newval_union.boolval)
3715 :
3716 158686 : if (value)
3717 : {
3718 157196 : if (!parse_and_validate_value(record, value,
3719 : source, elevel,
3720 : &newval_union, &newextra))
3721 0 : return 0;
3722 : }
3723 1490 : else if (source == PGC_S_DEFAULT)
3724 : {
3725 0 : newval = conf->boot_val;
3726 0 : if (!call_bool_check_hook(conf, &newval, &newextra,
3727 : source, elevel))
3728 0 : return 0;
3729 : }
3730 : else
3731 : {
3732 1490 : newval = conf->reset_val;
3733 1490 : newextra = conf->reset_extra;
3734 1490 : source = conf->gen.reset_source;
3735 1490 : context = conf->gen.reset_scontext;
3736 1490 : srole = conf->gen.reset_srole;
3737 : }
3738 :
3739 158662 : if (prohibitValueChange)
3740 : {
3741 : /* Release newextra, unless it's reset_extra */
3742 1522 : if (newextra && !extra_field_used(&conf->gen, newextra))
3743 0 : guc_free(newextra);
3744 :
3745 1522 : if (*conf->variable != newval)
3746 : {
3747 0 : record->status |= GUC_PENDING_RESTART;
3748 0 : ereport(elevel,
3749 : (errcode(ERRCODE_CANT_CHANGE_RUNTIME_PARAM),
3750 : errmsg("parameter \"%s\" cannot be changed without restarting the server",
3751 : conf->gen.name)));
3752 0 : return 0;
3753 : }
3754 1522 : record->status &= ~GUC_PENDING_RESTART;
3755 1522 : return -1;
3756 : }
3757 :
3758 157140 : if (changeVal)
3759 : {
3760 : /* Save old value to support transaction abort */
3761 157012 : if (!makeDefault)
3762 28668 : push_old_value(&conf->gen, action);
3763 :
3764 157012 : if (conf->assign_hook)
3765 0 : conf->assign_hook(newval, newextra);
3766 157012 : *conf->variable = newval;
3767 157012 : set_extra_field(&conf->gen, &conf->gen.extra,
3768 : newextra);
3769 157012 : set_guc_source(&conf->gen, source);
3770 157012 : conf->gen.scontext = context;
3771 157012 : conf->gen.srole = srole;
3772 : }
3773 157140 : if (makeDefault)
3774 : {
3775 : GucStack *stack;
3776 :
3777 128446 : if (conf->gen.reset_source <= source)
3778 : {
3779 128344 : conf->reset_val = newval;
3780 128344 : set_extra_field(&conf->gen, &conf->reset_extra,
3781 : newextra);
3782 128344 : conf->gen.reset_source = source;
3783 128344 : conf->gen.reset_scontext = context;
3784 128344 : conf->gen.reset_srole = srole;
3785 : }
3786 128446 : for (stack = conf->gen.stack; stack; stack = stack->prev)
3787 : {
3788 0 : if (stack->source <= source)
3789 : {
3790 0 : stack->prior.val.boolval = newval;
3791 0 : set_extra_field(&conf->gen, &stack->prior.extra,
3792 : newextra);
3793 0 : stack->source = source;
3794 0 : stack->scontext = context;
3795 0 : stack->srole = srole;
3796 : }
3797 : }
3798 : }
3799 :
3800 : /* Perhaps we didn't install newextra anywhere */
3801 157140 : if (newextra && !extra_field_used(&conf->gen, newextra))
3802 0 : guc_free(newextra);
3803 157140 : break;
3804 :
3805 : #undef newval
3806 : }
3807 :
3808 113744 : case PGC_INT:
3809 : {
3810 113744 : struct config_int *conf = (struct config_int *) record;
3811 :
3812 : #define newval (newval_union.intval)
3813 :
3814 113744 : if (value)
3815 : {
3816 113386 : if (!parse_and_validate_value(record, value,
3817 : source, elevel,
3818 : &newval_union, &newextra))
3819 0 : return 0;
3820 : }
3821 358 : else if (source == PGC_S_DEFAULT)
3822 : {
3823 0 : newval = conf->boot_val;
3824 0 : if (!call_int_check_hook(conf, &newval, &newextra,
3825 : source, elevel))
3826 0 : return 0;
3827 : }
3828 : else
3829 : {
3830 358 : newval = conf->reset_val;
3831 358 : newextra = conf->reset_extra;
3832 358 : source = conf->gen.reset_source;
3833 358 : context = conf->gen.reset_scontext;
3834 358 : srole = conf->gen.reset_srole;
3835 : }
3836 :
3837 113744 : if (prohibitValueChange)
3838 : {
3839 : /* Release newextra, unless it's reset_extra */
3840 8110 : if (newextra && !extra_field_used(&conf->gen, newextra))
3841 0 : guc_free(newextra);
3842 :
3843 8110 : if (*conf->variable != newval)
3844 : {
3845 0 : record->status |= GUC_PENDING_RESTART;
3846 0 : ereport(elevel,
3847 : (errcode(ERRCODE_CANT_CHANGE_RUNTIME_PARAM),
3848 : errmsg("parameter \"%s\" cannot be changed without restarting the server",
3849 : conf->gen.name)));
3850 0 : return 0;
3851 : }
3852 8110 : record->status &= ~GUC_PENDING_RESTART;
3853 8110 : return -1;
3854 : }
3855 :
3856 105634 : if (changeVal)
3857 : {
3858 : /* Save old value to support transaction abort */
3859 104038 : if (!makeDefault)
3860 21516 : push_old_value(&conf->gen, action);
3861 :
3862 104038 : if (conf->assign_hook)
3863 18572 : conf->assign_hook(newval, newextra);
3864 104038 : *conf->variable = newval;
3865 104038 : set_extra_field(&conf->gen, &conf->gen.extra,
3866 : newextra);
3867 104038 : set_guc_source(&conf->gen, source);
3868 104038 : conf->gen.scontext = context;
3869 104038 : conf->gen.srole = srole;
3870 : }
3871 105634 : if (makeDefault)
3872 : {
3873 : GucStack *stack;
3874 :
3875 84036 : if (conf->gen.reset_source <= source)
3876 : {
3877 82522 : conf->reset_val = newval;
3878 82522 : set_extra_field(&conf->gen, &conf->reset_extra,
3879 : newextra);
3880 82522 : conf->gen.reset_source = source;
3881 82522 : conf->gen.reset_scontext = context;
3882 82522 : conf->gen.reset_srole = srole;
3883 : }
3884 84036 : for (stack = conf->gen.stack; stack; stack = stack->prev)
3885 : {
3886 0 : if (stack->source <= source)
3887 : {
3888 0 : stack->prior.val.intval = newval;
3889 0 : set_extra_field(&conf->gen, &stack->prior.extra,
3890 : newextra);
3891 0 : stack->source = source;
3892 0 : stack->scontext = context;
3893 0 : stack->srole = srole;
3894 : }
3895 : }
3896 : }
3897 :
3898 : /* Perhaps we didn't install newextra anywhere */
3899 105634 : if (newextra && !extra_field_used(&conf->gen, newextra))
3900 0 : guc_free(newextra);
3901 105634 : break;
3902 :
3903 : #undef newval
3904 : }
3905 :
3906 8366 : case PGC_REAL:
3907 : {
3908 8366 : struct config_real *conf = (struct config_real *) record;
3909 :
3910 : #define newval (newval_union.realval)
3911 :
3912 8366 : if (value)
3913 : {
3914 8190 : if (!parse_and_validate_value(record, value,
3915 : source, elevel,
3916 : &newval_union, &newextra))
3917 0 : return 0;
3918 : }
3919 176 : else if (source == PGC_S_DEFAULT)
3920 : {
3921 0 : newval = conf->boot_val;
3922 0 : if (!call_real_check_hook(conf, &newval, &newextra,
3923 : source, elevel))
3924 0 : return 0;
3925 : }
3926 : else
3927 : {
3928 176 : newval = conf->reset_val;
3929 176 : newextra = conf->reset_extra;
3930 176 : source = conf->gen.reset_source;
3931 176 : context = conf->gen.reset_scontext;
3932 176 : srole = conf->gen.reset_srole;
3933 : }
3934 :
3935 8354 : if (prohibitValueChange)
3936 : {
3937 : /* Release newextra, unless it's reset_extra */
3938 0 : if (newextra && !extra_field_used(&conf->gen, newextra))
3939 0 : guc_free(newextra);
3940 :
3941 0 : if (*conf->variable != newval)
3942 : {
3943 0 : record->status |= GUC_PENDING_RESTART;
3944 0 : ereport(elevel,
3945 : (errcode(ERRCODE_CANT_CHANGE_RUNTIME_PARAM),
3946 : errmsg("parameter \"%s\" cannot be changed without restarting the server",
3947 : conf->gen.name)));
3948 0 : return 0;
3949 : }
3950 0 : record->status &= ~GUC_PENDING_RESTART;
3951 0 : return -1;
3952 : }
3953 :
3954 8354 : if (changeVal)
3955 : {
3956 : /* Save old value to support transaction abort */
3957 8354 : if (!makeDefault)
3958 8354 : push_old_value(&conf->gen, action);
3959 :
3960 8354 : if (conf->assign_hook)
3961 0 : conf->assign_hook(newval, newextra);
3962 8354 : *conf->variable = newval;
3963 8354 : set_extra_field(&conf->gen, &conf->gen.extra,
3964 : newextra);
3965 8354 : set_guc_source(&conf->gen, source);
3966 8354 : conf->gen.scontext = context;
3967 8354 : conf->gen.srole = srole;
3968 : }
3969 8354 : if (makeDefault)
3970 : {
3971 : GucStack *stack;
3972 :
3973 0 : if (conf->gen.reset_source <= source)
3974 : {
3975 0 : conf->reset_val = newval;
3976 0 : set_extra_field(&conf->gen, &conf->reset_extra,
3977 : newextra);
3978 0 : conf->gen.reset_source = source;
3979 0 : conf->gen.reset_scontext = context;
3980 0 : conf->gen.reset_srole = srole;
3981 : }
3982 0 : for (stack = conf->gen.stack; stack; stack = stack->prev)
3983 : {
3984 0 : if (stack->source <= source)
3985 : {
3986 0 : stack->prior.val.realval = newval;
3987 0 : set_extra_field(&conf->gen, &stack->prior.extra,
3988 : newextra);
3989 0 : stack->source = source;
3990 0 : stack->scontext = context;
3991 0 : stack->srole = srole;
3992 : }
3993 : }
3994 : }
3995 :
3996 : /* Perhaps we didn't install newextra anywhere */
3997 8354 : if (newextra && !extra_field_used(&conf->gen, newextra))
3998 0 : guc_free(newextra);
3999 8354 : break;
4000 :
4001 : #undef newval
4002 : }
4003 :
4004 730678 : case PGC_STRING:
4005 : {
4006 730678 : struct config_string *conf = (struct config_string *) record;
4007 730678 : GucContext orig_context = context;
4008 730678 : GucSource orig_source = source;
4009 730678 : Oid orig_srole = srole;
4010 :
4011 : #define newval (newval_union.stringval)
4012 :
4013 730678 : if (value)
4014 : {
4015 727694 : if (!parse_and_validate_value(record, value,
4016 : source, elevel,
4017 : &newval_union, &newextra))
4018 6 : return 0;
4019 : }
4020 2984 : else if (source == PGC_S_DEFAULT)
4021 : {
4022 : /* non-NULL boot_val must always get strdup'd */
4023 4 : if (conf->boot_val != NULL)
4024 : {
4025 4 : newval = guc_strdup(elevel, conf->boot_val);
4026 4 : if (newval == NULL)
4027 0 : return 0;
4028 : }
4029 : else
4030 0 : newval = NULL;
4031 :
4032 4 : if (!call_string_check_hook(conf, &newval, &newextra,
4033 : source, elevel))
4034 : {
4035 0 : guc_free(newval);
4036 0 : return 0;
4037 : }
4038 : }
4039 : else
4040 : {
4041 : /*
4042 : * strdup not needed, since reset_val is already under
4043 : * guc.c's control
4044 : */
4045 2980 : newval = conf->reset_val;
4046 2980 : newextra = conf->reset_extra;
4047 2980 : source = conf->gen.reset_source;
4048 2980 : context = conf->gen.reset_scontext;
4049 2980 : srole = conf->gen.reset_srole;
4050 : }
4051 :
4052 730630 : if (prohibitValueChange)
4053 : {
4054 : bool newval_different;
4055 :
4056 : /* newval shouldn't be NULL, so we're a bit sloppy here */
4057 8460 : newval_different = (*conf->variable == NULL ||
4058 5640 : newval == NULL ||
4059 2820 : strcmp(*conf->variable, newval) != 0);
4060 :
4061 : /* Release newval, unless it's reset_val */
4062 2820 : if (newval && !string_field_used(conf, newval))
4063 2820 : guc_free(newval);
4064 : /* Release newextra, unless it's reset_extra */
4065 2820 : if (newextra && !extra_field_used(&conf->gen, newextra))
4066 0 : guc_free(newextra);
4067 :
4068 2820 : if (newval_different)
4069 : {
4070 0 : record->status |= GUC_PENDING_RESTART;
4071 0 : ereport(elevel,
4072 : (errcode(ERRCODE_CANT_CHANGE_RUNTIME_PARAM),
4073 : errmsg("parameter \"%s\" cannot be changed without restarting the server",
4074 : conf->gen.name)));
4075 0 : return 0;
4076 : }
4077 2820 : record->status &= ~GUC_PENDING_RESTART;
4078 2820 : return -1;
4079 : }
4080 :
4081 727810 : if (changeVal)
4082 : {
4083 : /* Save old value to support transaction abort */
4084 726114 : if (!makeDefault)
4085 435696 : push_old_value(&conf->gen, action);
4086 :
4087 726114 : if (conf->assign_hook)
4088 669698 : conf->assign_hook(newval, newextra);
4089 726112 : set_string_field(conf, conf->variable, newval);
4090 726112 : set_extra_field(&conf->gen, &conf->gen.extra,
4091 : newextra);
4092 726112 : set_guc_source(&conf->gen, source);
4093 726112 : conf->gen.scontext = context;
4094 726112 : conf->gen.srole = srole;
4095 :
4096 : /*
4097 : * Ugly hack: during SET session_authorization, forcibly
4098 : * do SET ROLE NONE with the same context/source/etc, so
4099 : * that the effects will have identical lifespan. This is
4100 : * required by the SQL spec, and it's not possible to do
4101 : * it within the variable's check hook or assign hook
4102 : * because our APIs for those don't pass enough info.
4103 : * However, don't do it if is_reload: in that case we
4104 : * expect that if "role" isn't supposed to be default, it
4105 : * has been or will be set by a separate reload action.
4106 : *
4107 : * Also, for the call from InitializeSessionUserId with
4108 : * source == PGC_S_OVERRIDE, use PGC_S_DYNAMIC_DEFAULT for
4109 : * "role"'s source, so that it's still possible to set
4110 : * "role" from pg_db_role_setting entries. (See notes in
4111 : * InitializeSessionUserId before changing this.)
4112 : *
4113 : * A fine point: for RESET session_authorization, we do
4114 : * "RESET role" not "SET ROLE NONE" (by passing down NULL
4115 : * rather than "none" for the value). This would have the
4116 : * same effects in typical cases, but if the reset value
4117 : * of "role" is not "none" it seems better to revert to
4118 : * that.
4119 : */
4120 726112 : if (!is_reload &&
4121 686662 : strcmp(conf->gen.name, "session_authorization") == 0)
4122 30438 : (void) set_config_with_handle("role", NULL,
4123 : value ? "none" : NULL,
4124 : orig_context,
4125 : (orig_source == PGC_S_OVERRIDE)
4126 : ? PGC_S_DYNAMIC_DEFAULT
4127 : : orig_source,
4128 : orig_srole,
4129 : action,
4130 : true,
4131 : elevel,
4132 : false);
4133 : }
4134 :
4135 727808 : if (makeDefault)
4136 : {
4137 : GucStack *stack;
4138 :
4139 290902 : if (conf->gen.reset_source <= source)
4140 : {
4141 290416 : set_string_field(conf, &conf->reset_val, newval);
4142 290416 : set_extra_field(&conf->gen, &conf->reset_extra,
4143 : newextra);
4144 290416 : conf->gen.reset_source = source;
4145 290416 : conf->gen.reset_scontext = context;
4146 290416 : conf->gen.reset_srole = srole;
4147 : }
4148 290902 : for (stack = conf->gen.stack; stack; stack = stack->prev)
4149 : {
4150 0 : if (stack->source <= source)
4151 : {
4152 0 : set_string_field(conf, &stack->prior.val.stringval,
4153 : newval);
4154 0 : set_extra_field(&conf->gen, &stack->prior.extra,
4155 : newextra);
4156 0 : stack->source = source;
4157 0 : stack->scontext = context;
4158 0 : stack->srole = srole;
4159 : }
4160 : }
4161 : }
4162 :
4163 : /* Perhaps we didn't install newval anywhere */
4164 727808 : if (newval && !string_field_used(conf, newval))
4165 1668 : guc_free(newval);
4166 : /* Perhaps we didn't install newextra anywhere */
4167 727808 : if (newextra && !extra_field_used(&conf->gen, newextra))
4168 492 : guc_free(newextra);
4169 727808 : break;
4170 :
4171 : #undef newval
4172 : }
4173 :
4174 76764 : case PGC_ENUM:
4175 : {
4176 76764 : struct config_enum *conf = (struct config_enum *) record;
4177 :
4178 : #define newval (newval_union.enumval)
4179 :
4180 76764 : if (value)
4181 : {
4182 76234 : if (!parse_and_validate_value(record, value,
4183 : source, elevel,
4184 : &newval_union, &newextra))
4185 0 : return 0;
4186 : }
4187 530 : else if (source == PGC_S_DEFAULT)
4188 : {
4189 0 : newval = conf->boot_val;
4190 0 : if (!call_enum_check_hook(conf, &newval, &newextra,
4191 : source, elevel))
4192 0 : return 0;
4193 : }
4194 : else
4195 : {
4196 530 : newval = conf->reset_val;
4197 530 : newextra = conf->reset_extra;
4198 530 : source = conf->gen.reset_source;
4199 530 : context = conf->gen.reset_scontext;
4200 530 : srole = conf->gen.reset_srole;
4201 : }
4202 :
4203 76724 : if (prohibitValueChange)
4204 : {
4205 : /* Release newextra, unless it's reset_extra */
4206 3214 : if (newextra && !extra_field_used(&conf->gen, newextra))
4207 0 : guc_free(newextra);
4208 :
4209 3214 : if (*conf->variable != newval)
4210 : {
4211 0 : record->status |= GUC_PENDING_RESTART;
4212 0 : ereport(elevel,
4213 : (errcode(ERRCODE_CANT_CHANGE_RUNTIME_PARAM),
4214 : errmsg("parameter \"%s\" cannot be changed without restarting the server",
4215 : conf->gen.name)));
4216 0 : return 0;
4217 : }
4218 3214 : record->status &= ~GUC_PENDING_RESTART;
4219 3214 : return -1;
4220 : }
4221 :
4222 73510 : if (changeVal)
4223 : {
4224 : /* Save old value to support transaction abort */
4225 73290 : if (!makeDefault)
4226 20332 : push_old_value(&conf->gen, action);
4227 :
4228 73290 : if (conf->assign_hook)
4229 12490 : conf->assign_hook(newval, newextra);
4230 73290 : *conf->variable = newval;
4231 73290 : set_extra_field(&conf->gen, &conf->gen.extra,
4232 : newextra);
4233 73290 : set_guc_source(&conf->gen, source);
4234 73290 : conf->gen.scontext = context;
4235 73290 : conf->gen.srole = srole;
4236 : }
4237 73510 : if (makeDefault)
4238 : {
4239 : GucStack *stack;
4240 :
4241 52958 : if (conf->gen.reset_source <= source)
4242 : {
4243 52958 : conf->reset_val = newval;
4244 52958 : set_extra_field(&conf->gen, &conf->reset_extra,
4245 : newextra);
4246 52958 : conf->gen.reset_source = source;
4247 52958 : conf->gen.reset_scontext = context;
4248 52958 : conf->gen.reset_srole = srole;
4249 : }
4250 52958 : for (stack = conf->gen.stack; stack; stack = stack->prev)
4251 : {
4252 0 : if (stack->source <= source)
4253 : {
4254 0 : stack->prior.val.enumval = newval;
4255 0 : set_extra_field(&conf->gen, &stack->prior.extra,
4256 : newextra);
4257 0 : stack->source = source;
4258 0 : stack->scontext = context;
4259 0 : stack->srole = srole;
4260 : }
4261 : }
4262 : }
4263 :
4264 : /* Perhaps we didn't install newextra anywhere */
4265 73510 : if (newextra && !extra_field_used(&conf->gen, newextra))
4266 0 : guc_free(newextra);
4267 73510 : break;
4268 :
4269 : #undef newval
4270 : }
4271 : }
4272 :
4273 1072446 : if (changeVal && (record->flags & GUC_REPORT) &&
4274 694656 : !(record->status & GUC_NEEDS_REPORT))
4275 : {
4276 253644 : record->status |= GUC_NEEDS_REPORT;
4277 253644 : slist_push_head(&guc_report_list, &record->report_link);
4278 : }
4279 :
4280 1072446 : return changeVal ? 1 : -1;
4281 : }
4282 :
4283 :
4284 : /*
4285 : * Retrieve a config_handle for the given name, suitable for calling
4286 : * set_config_with_handle(). Only return handle to permanent GUC.
4287 : */
4288 : config_handle *
4289 132 : get_config_handle(const char *name)
4290 : {
4291 132 : struct config_generic *gen = find_option(name, false, false, 0);
4292 :
4293 132 : if (gen && ((gen->flags & GUC_CUSTOM_PLACEHOLDER) == 0))
4294 132 : return gen;
4295 :
4296 0 : return NULL;
4297 : }
4298 :
4299 :
4300 : /*
4301 : * Set the fields for source file and line number the setting came from.
4302 : */
4303 : static void
4304 141608 : set_config_sourcefile(const char *name, char *sourcefile, int sourceline)
4305 : {
4306 : struct config_generic *record;
4307 : int elevel;
4308 :
4309 : /*
4310 : * To avoid cluttering the log, only the postmaster bleats loudly about
4311 : * problems with the config file.
4312 : */
4313 141608 : elevel = IsUnderPostmaster ? DEBUG3 : LOG;
4314 :
4315 141608 : record = find_option(name, true, false, elevel);
4316 : /* should not happen */
4317 141608 : if (record == NULL)
4318 0 : return;
4319 :
4320 141608 : sourcefile = guc_strdup(elevel, sourcefile);
4321 141608 : guc_free(record->sourcefile);
4322 141608 : record->sourcefile = sourcefile;
4323 141608 : record->sourceline = sourceline;
4324 : }
4325 :
4326 : /*
4327 : * Set a config option to the given value.
4328 : *
4329 : * See also set_config_option; this is just the wrapper to be called from
4330 : * outside GUC. (This function should be used when possible, because its API
4331 : * is more stable than set_config_option's.)
4332 : *
4333 : * Note: there is no support here for setting source file/line, as it
4334 : * is currently not needed.
4335 : */
4336 : void
4337 331788 : SetConfigOption(const char *name, const char *value,
4338 : GucContext context, GucSource source)
4339 : {
4340 331788 : (void) set_config_option(name, value, context, source,
4341 : GUC_ACTION_SET, true, 0, false);
4342 331738 : }
4343 :
4344 :
4345 :
4346 : /*
4347 : * Fetch the current value of the option `name', as a string.
4348 : *
4349 : * If the option doesn't exist, return NULL if missing_ok is true,
4350 : * otherwise throw an ereport and don't return.
4351 : *
4352 : * If restrict_privileged is true, we also enforce that only superusers and
4353 : * members of the pg_read_all_settings role can see GUC_SUPERUSER_ONLY
4354 : * variables. This should only be passed as true in user-driven calls.
4355 : *
4356 : * The string is *not* allocated for modification and is really only
4357 : * valid until the next call to configuration related functions.
4358 : */
4359 : const char *
4360 13268 : GetConfigOption(const char *name, bool missing_ok, bool restrict_privileged)
4361 : {
4362 : struct config_generic *record;
4363 : static char buffer[256];
4364 :
4365 13268 : record = find_option(name, false, missing_ok, ERROR);
4366 13268 : if (record == NULL)
4367 2 : return NULL;
4368 13266 : if (restrict_privileged &&
4369 0 : !ConfigOptionIsVisible(record))
4370 0 : ereport(ERROR,
4371 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
4372 : errmsg("permission denied to examine \"%s\"", name),
4373 : errdetail("Only roles with privileges of the \"%s\" role may examine this parameter.",
4374 : "pg_read_all_settings")));
4375 :
4376 13266 : switch (record->vartype)
4377 : {
4378 2232 : case PGC_BOOL:
4379 2232 : return *((struct config_bool *) record)->variable ? "on" : "off";
4380 :
4381 3406 : case PGC_INT:
4382 3406 : snprintf(buffer, sizeof(buffer), "%d",
4383 3406 : *((struct config_int *) record)->variable);
4384 3406 : return buffer;
4385 :
4386 0 : case PGC_REAL:
4387 0 : snprintf(buffer, sizeof(buffer), "%g",
4388 0 : *((struct config_real *) record)->variable);
4389 0 : return buffer;
4390 :
4391 6154 : case PGC_STRING:
4392 6154 : return *((struct config_string *) record)->variable ?
4393 6154 : *((struct config_string *) record)->variable : "";
4394 :
4395 1474 : case PGC_ENUM:
4396 1474 : return config_enum_lookup_by_value((struct config_enum *) record,
4397 1474 : *((struct config_enum *) record)->variable);
4398 : }
4399 0 : return NULL;
4400 : }
4401 :
4402 : /*
4403 : * Get the RESET value associated with the given option.
4404 : *
4405 : * Note: this is not re-entrant, due to use of static result buffer;
4406 : * not to mention that a string variable could have its reset_val changed.
4407 : * Beware of assuming the result value is good for very long.
4408 : */
4409 : const char *
4410 0 : GetConfigOptionResetString(const char *name)
4411 : {
4412 : struct config_generic *record;
4413 : static char buffer[256];
4414 :
4415 0 : record = find_option(name, false, false, ERROR);
4416 : Assert(record != NULL);
4417 0 : if (!ConfigOptionIsVisible(record))
4418 0 : ereport(ERROR,
4419 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
4420 : errmsg("permission denied to examine \"%s\"", name),
4421 : errdetail("Only roles with privileges of the \"%s\" role may examine this parameter.",
4422 : "pg_read_all_settings")));
4423 :
4424 0 : switch (record->vartype)
4425 : {
4426 0 : case PGC_BOOL:
4427 0 : return ((struct config_bool *) record)->reset_val ? "on" : "off";
4428 :
4429 0 : case PGC_INT:
4430 0 : snprintf(buffer, sizeof(buffer), "%d",
4431 : ((struct config_int *) record)->reset_val);
4432 0 : return buffer;
4433 :
4434 0 : case PGC_REAL:
4435 0 : snprintf(buffer, sizeof(buffer), "%g",
4436 : ((struct config_real *) record)->reset_val);
4437 0 : return buffer;
4438 :
4439 0 : case PGC_STRING:
4440 0 : return ((struct config_string *) record)->reset_val ?
4441 0 : ((struct config_string *) record)->reset_val : "";
4442 :
4443 0 : case PGC_ENUM:
4444 0 : return config_enum_lookup_by_value((struct config_enum *) record,
4445 : ((struct config_enum *) record)->reset_val);
4446 : }
4447 0 : return NULL;
4448 : }
4449 :
4450 : /*
4451 : * Get the GUC flags associated with the given option.
4452 : *
4453 : * If the option doesn't exist, return 0 if missing_ok is true,
4454 : * otherwise throw an ereport and don't return.
4455 : */
4456 : int
4457 34 : GetConfigOptionFlags(const char *name, bool missing_ok)
4458 : {
4459 : struct config_generic *record;
4460 :
4461 34 : record = find_option(name, false, missing_ok, ERROR);
4462 34 : if (record == NULL)
4463 0 : return 0;
4464 34 : return record->flags;
4465 : }
4466 :
4467 :
4468 : /*
4469 : * Write updated configuration parameter values into a temporary file.
4470 : * This function traverses the list of parameters and quotes the string
4471 : * values before writing them.
4472 : */
4473 : static void
4474 150 : write_auto_conf_file(int fd, const char *filename, ConfigVariable *head)
4475 : {
4476 : StringInfoData buf;
4477 : ConfigVariable *item;
4478 :
4479 150 : initStringInfo(&buf);
4480 :
4481 : /* Emit file header containing warning comment */
4482 150 : appendStringInfoString(&buf, "# Do not edit this file manually!\n");
4483 150 : appendStringInfoString(&buf, "# It will be overwritten by the ALTER SYSTEM command.\n");
4484 :
4485 150 : errno = 0;
4486 150 : if (write(fd, buf.data, buf.len) != buf.len)
4487 : {
4488 : /* if write didn't set errno, assume problem is no disk space */
4489 0 : if (errno == 0)
4490 0 : errno = ENOSPC;
4491 0 : ereport(ERROR,
4492 : (errcode_for_file_access(),
4493 : errmsg("could not write to file \"%s\": %m", filename)));
4494 : }
4495 :
4496 : /* Emit each parameter, properly quoting the value */
4497 324 : for (item = head; item != NULL; item = item->next)
4498 : {
4499 : char *escaped;
4500 :
4501 174 : resetStringInfo(&buf);
4502 :
4503 174 : appendStringInfoString(&buf, item->name);
4504 174 : appendStringInfoString(&buf, " = '");
4505 :
4506 174 : escaped = escape_single_quotes_ascii(item->value);
4507 174 : if (!escaped)
4508 0 : ereport(ERROR,
4509 : (errcode(ERRCODE_OUT_OF_MEMORY),
4510 : errmsg("out of memory")));
4511 174 : appendStringInfoString(&buf, escaped);
4512 174 : free(escaped);
4513 :
4514 174 : appendStringInfoString(&buf, "'\n");
4515 :
4516 174 : errno = 0;
4517 174 : if (write(fd, buf.data, buf.len) != buf.len)
4518 : {
4519 : /* if write didn't set errno, assume problem is no disk space */
4520 0 : if (errno == 0)
4521 0 : errno = ENOSPC;
4522 0 : ereport(ERROR,
4523 : (errcode_for_file_access(),
4524 : errmsg("could not write to file \"%s\": %m", filename)));
4525 : }
4526 : }
4527 :
4528 : /* fsync before considering the write to be successful */
4529 150 : if (pg_fsync(fd) != 0)
4530 0 : ereport(ERROR,
4531 : (errcode_for_file_access(),
4532 : errmsg("could not fsync file \"%s\": %m", filename)));
4533 :
4534 150 : pfree(buf.data);
4535 150 : }
4536 :
4537 : /*
4538 : * Update the given list of configuration parameters, adding, replacing
4539 : * or deleting the entry for item "name" (delete if "value" == NULL).
4540 : */
4541 : static void
4542 150 : replace_auto_config_value(ConfigVariable **head_p, ConfigVariable **tail_p,
4543 : const char *name, const char *value)
4544 : {
4545 : ConfigVariable *item,
4546 : *next,
4547 150 : *prev = NULL;
4548 :
4549 : /*
4550 : * Remove any existing match(es) for "name". Normally there'd be at most
4551 : * one, but if external tools have modified the config file, there could
4552 : * be more.
4553 : */
4554 290 : for (item = *head_p; item != NULL; item = next)
4555 : {
4556 140 : next = item->next;
4557 140 : if (guc_name_compare(item->name, name) == 0)
4558 : {
4559 : /* found a match, delete it */
4560 74 : if (prev)
4561 10 : prev->next = next;
4562 : else
4563 64 : *head_p = next;
4564 74 : if (next == NULL)
4565 68 : *tail_p = prev;
4566 :
4567 74 : pfree(item->name);
4568 74 : pfree(item->value);
4569 74 : pfree(item->filename);
4570 74 : pfree(item);
4571 : }
4572 : else
4573 66 : prev = item;
4574 : }
4575 :
4576 : /* Done if we're trying to delete it */
4577 150 : if (value == NULL)
4578 42 : return;
4579 :
4580 : /* OK, append a new entry */
4581 108 : item = palloc(sizeof *item);
4582 108 : item->name = pstrdup(name);
4583 108 : item->value = pstrdup(value);
4584 108 : item->errmsg = NULL;
4585 108 : item->filename = pstrdup(""); /* new item has no location */
4586 108 : item->sourceline = 0;
4587 108 : item->ignore = false;
4588 108 : item->applied = false;
4589 108 : item->next = NULL;
4590 :
4591 108 : if (*head_p == NULL)
4592 82 : *head_p = item;
4593 : else
4594 26 : (*tail_p)->next = item;
4595 108 : *tail_p = item;
4596 : }
4597 :
4598 :
4599 : /*
4600 : * Execute ALTER SYSTEM statement.
4601 : *
4602 : * Read the old PG_AUTOCONF_FILENAME file, merge in the new variable value,
4603 : * and write out an updated file. If the command is ALTER SYSTEM RESET ALL,
4604 : * we can skip reading the old file and just write an empty file.
4605 : *
4606 : * An LWLock is used to serialize updates of the configuration file.
4607 : *
4608 : * In case of an error, we leave the original automatic
4609 : * configuration file (PG_AUTOCONF_FILENAME) intact.
4610 : */
4611 : void
4612 194 : AlterSystemSetConfigFile(AlterSystemStmt *altersysstmt)
4613 : {
4614 : char *name;
4615 : char *value;
4616 194 : bool resetall = false;
4617 194 : ConfigVariable *head = NULL;
4618 194 : ConfigVariable *tail = NULL;
4619 : volatile int Tmpfd;
4620 : char AutoConfFileName[MAXPGPATH];
4621 : char AutoConfTmpFileName[MAXPGPATH];
4622 :
4623 : /*
4624 : * Extract statement arguments
4625 : */
4626 194 : name = altersysstmt->setstmt->name;
4627 :
4628 194 : if (!AllowAlterSystem)
4629 0 : ereport(ERROR,
4630 : (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
4631 : errmsg("ALTER SYSTEM is not allowed in this environment")));
4632 :
4633 194 : switch (altersysstmt->setstmt->kind)
4634 : {
4635 138 : case VAR_SET_VALUE:
4636 138 : value = ExtractSetVariableArgs(altersysstmt->setstmt);
4637 138 : break;
4638 :
4639 54 : case VAR_SET_DEFAULT:
4640 : case VAR_RESET:
4641 54 : value = NULL;
4642 54 : break;
4643 :
4644 2 : case VAR_RESET_ALL:
4645 2 : value = NULL;
4646 2 : resetall = true;
4647 2 : break;
4648 :
4649 0 : default:
4650 0 : elog(ERROR, "unrecognized alter system stmt type: %d",
4651 : altersysstmt->setstmt->kind);
4652 : break;
4653 : }
4654 :
4655 : /*
4656 : * Check permission to run ALTER SYSTEM on the target variable
4657 : */
4658 194 : if (!superuser())
4659 : {
4660 46 : if (resetall)
4661 2 : ereport(ERROR,
4662 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
4663 : errmsg("permission denied to perform ALTER SYSTEM RESET ALL")));
4664 : else
4665 : {
4666 : AclResult aclresult;
4667 :
4668 44 : aclresult = pg_parameter_aclcheck(name, GetUserId(),
4669 : ACL_ALTER_SYSTEM);
4670 44 : if (aclresult != ACLCHECK_OK)
4671 26 : ereport(ERROR,
4672 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
4673 : errmsg("permission denied to set parameter \"%s\"",
4674 : name)));
4675 : }
4676 : }
4677 :
4678 : /*
4679 : * Unless it's RESET_ALL, validate the target variable and value
4680 : */
4681 166 : if (!resetall)
4682 : {
4683 : struct config_generic *record;
4684 :
4685 : /* We don't want to create a placeholder if there's not one already */
4686 166 : record = find_option(name, false, true, DEBUG5);
4687 166 : if (record != NULL)
4688 : {
4689 : /*
4690 : * Don't allow parameters that can't be set in configuration files
4691 : * to be set in PG_AUTOCONF_FILENAME file.
4692 : */
4693 162 : if ((record->context == PGC_INTERNAL) ||
4694 158 : (record->flags & GUC_DISALLOW_IN_FILE) ||
4695 150 : (record->flags & GUC_DISALLOW_IN_AUTO_FILE))
4696 12 : ereport(ERROR,
4697 : (errcode(ERRCODE_CANT_CHANGE_RUNTIME_PARAM),
4698 : errmsg("parameter \"%s\" cannot be changed",
4699 : name)));
4700 :
4701 : /*
4702 : * If a value is specified, verify that it's sane.
4703 : */
4704 150 : if (value)
4705 : {
4706 : union config_var_val newval;
4707 110 : void *newextra = NULL;
4708 :
4709 110 : if (!parse_and_validate_value(record, value,
4710 : PGC_S_FILE, ERROR,
4711 : &newval, &newextra))
4712 0 : ereport(ERROR,
4713 : (errcode(ERRCODE_INVALID_PARAMETER_VALUE),
4714 : errmsg("invalid value for parameter \"%s\": \"%s\"",
4715 : name, value)));
4716 :
4717 106 : if (record->vartype == PGC_STRING && newval.stringval != NULL)
4718 44 : guc_free(newval.stringval);
4719 106 : guc_free(newextra);
4720 : }
4721 : }
4722 : else
4723 : {
4724 : /*
4725 : * Variable not known; check we'd be allowed to create it. (We
4726 : * cannot validate the value, but that's fine. A non-core GUC in
4727 : * the config file cannot cause postmaster start to fail, so we
4728 : * don't have to be too tense about possibly installing a bad
4729 : * value.)
4730 : *
4731 : * As an exception, we skip this check if this is a RESET command
4732 : * for an unknown custom GUC, else there'd be no way for users to
4733 : * remove such settings with reserved prefixes.
4734 : */
4735 4 : if (value || !valid_custom_variable_name(name))
4736 2 : (void) assignable_custom_variable_name(name, false, ERROR);
4737 : }
4738 :
4739 : /*
4740 : * We must also reject values containing newlines, because the grammar
4741 : * for config files doesn't support embedded newlines in string
4742 : * literals.
4743 : */
4744 150 : if (value && strchr(value, '\n'))
4745 0 : ereport(ERROR,
4746 : (errcode(ERRCODE_INVALID_PARAMETER_VALUE),
4747 : errmsg("parameter value for ALTER SYSTEM must not contain a newline")));
4748 : }
4749 :
4750 : /*
4751 : * PG_AUTOCONF_FILENAME and its corresponding temporary file are always in
4752 : * the data directory, so we can reference them by simple relative paths.
4753 : */
4754 150 : snprintf(AutoConfFileName, sizeof(AutoConfFileName), "%s",
4755 : PG_AUTOCONF_FILENAME);
4756 150 : snprintf(AutoConfTmpFileName, sizeof(AutoConfTmpFileName), "%s.%s",
4757 : AutoConfFileName,
4758 : "tmp");
4759 :
4760 : /*
4761 : * Only one backend is allowed to operate on PG_AUTOCONF_FILENAME at a
4762 : * time. Use AutoFileLock to ensure that. We must hold the lock while
4763 : * reading the old file contents.
4764 : */
4765 150 : LWLockAcquire(AutoFileLock, LW_EXCLUSIVE);
4766 :
4767 : /*
4768 : * If we're going to reset everything, then no need to open or parse the
4769 : * old file. We'll just write out an empty list.
4770 : */
4771 150 : if (!resetall)
4772 : {
4773 : struct stat st;
4774 :
4775 150 : if (stat(AutoConfFileName, &st) == 0)
4776 : {
4777 : /* open old file PG_AUTOCONF_FILENAME */
4778 : FILE *infile;
4779 :
4780 150 : infile = AllocateFile(AutoConfFileName, "r");
4781 150 : if (infile == NULL)
4782 0 : ereport(ERROR,
4783 : (errcode_for_file_access(),
4784 : errmsg("could not open file \"%s\": %m",
4785 : AutoConfFileName)));
4786 :
4787 : /* parse it */
4788 150 : if (!ParseConfigFp(infile, AutoConfFileName, CONF_FILE_START_DEPTH,
4789 : LOG, &head, &tail))
4790 0 : ereport(ERROR,
4791 : (errcode(ERRCODE_CONFIG_FILE_ERROR),
4792 : errmsg("could not parse contents of file \"%s\"",
4793 : AutoConfFileName)));
4794 :
4795 150 : FreeFile(infile);
4796 : }
4797 :
4798 : /*
4799 : * Now, replace any existing entry with the new value, or add it if
4800 : * not present.
4801 : */
4802 150 : replace_auto_config_value(&head, &tail, name, value);
4803 : }
4804 :
4805 : /*
4806 : * Invoke the post-alter hook for setting this GUC variable. GUCs
4807 : * typically do not have corresponding entries in pg_parameter_acl, so we
4808 : * call the hook using the name rather than a potentially-non-existent
4809 : * OID. Nonetheless, we pass ParameterAclRelationId so that this call
4810 : * context can be distinguished from others. (Note that "name" will be
4811 : * NULL in the RESET ALL case.)
4812 : *
4813 : * We do this here rather than at the end, because ALTER SYSTEM is not
4814 : * transactional. If the hook aborts our transaction, it will be cleaner
4815 : * to do so before we touch any files.
4816 : */
4817 150 : InvokeObjectPostAlterHookArgStr(ParameterAclRelationId, name,
4818 : ACL_ALTER_SYSTEM,
4819 : altersysstmt->setstmt->kind,
4820 : false);
4821 :
4822 : /*
4823 : * To ensure crash safety, first write the new file data to a temp file,
4824 : * then atomically rename it into place.
4825 : *
4826 : * If there is a temp file left over due to a previous crash, it's okay to
4827 : * truncate and reuse it.
4828 : */
4829 150 : Tmpfd = BasicOpenFile(AutoConfTmpFileName,
4830 : O_CREAT | O_RDWR | O_TRUNC);
4831 150 : if (Tmpfd < 0)
4832 0 : ereport(ERROR,
4833 : (errcode_for_file_access(),
4834 : errmsg("could not open file \"%s\": %m",
4835 : AutoConfTmpFileName)));
4836 :
4837 : /*
4838 : * Use a TRY block to clean up the file if we fail. Since we need a TRY
4839 : * block anyway, OK to use BasicOpenFile rather than OpenTransientFile.
4840 : */
4841 150 : PG_TRY();
4842 : {
4843 : /* Write and sync the new contents to the temporary file */
4844 150 : write_auto_conf_file(Tmpfd, AutoConfTmpFileName, head);
4845 :
4846 : /* Close before renaming; may be required on some platforms */
4847 150 : close(Tmpfd);
4848 150 : Tmpfd = -1;
4849 :
4850 : /*
4851 : * As the rename is atomic operation, if any problem occurs after this
4852 : * at worst it can lose the parameters set by last ALTER SYSTEM
4853 : * command.
4854 : */
4855 150 : durable_rename(AutoConfTmpFileName, AutoConfFileName, ERROR);
4856 : }
4857 0 : PG_CATCH();
4858 : {
4859 : /* Close file first, else unlink might fail on some platforms */
4860 0 : if (Tmpfd >= 0)
4861 0 : close(Tmpfd);
4862 :
4863 : /* Unlink, but ignore any error */
4864 0 : (void) unlink(AutoConfTmpFileName);
4865 :
4866 0 : PG_RE_THROW();
4867 : }
4868 150 : PG_END_TRY();
4869 :
4870 150 : FreeConfigVariables(head);
4871 :
4872 150 : LWLockRelease(AutoFileLock);
4873 150 : }
4874 :
4875 :
4876 : /*
4877 : * Common code for DefineCustomXXXVariable subroutines: allocate the
4878 : * new variable's config struct and fill in generic fields.
4879 : */
4880 : static struct config_generic *
4881 18570 : init_custom_variable(const char *name,
4882 : const char *short_desc,
4883 : const char *long_desc,
4884 : GucContext context,
4885 : int flags,
4886 : enum config_type type,
4887 : size_t sz)
4888 : {
4889 : struct config_generic *gen;
4890 :
4891 : /*
4892 : * Only allow custom PGC_POSTMASTER variables to be created during shared
4893 : * library preload; any later than that, we can't ensure that the value
4894 : * doesn't change after startup. This is a fatal elog if it happens; just
4895 : * erroring out isn't safe because we don't know what the calling loadable
4896 : * module might already have hooked into.
4897 : */
4898 18570 : if (context == PGC_POSTMASTER &&
4899 30 : !process_shared_preload_libraries_in_progress)
4900 0 : elog(FATAL, "cannot create PGC_POSTMASTER variables after startup");
4901 :
4902 : /*
4903 : * We can't support custom GUC_LIST_QUOTE variables, because the wrong
4904 : * things would happen if such a variable were set or pg_dump'd when the
4905 : * defining extension isn't loaded. Again, treat this as fatal because
4906 : * the loadable module may be partly initialized already.
4907 : */
4908 18570 : if (flags & GUC_LIST_QUOTE)
4909 0 : elog(FATAL, "extensions cannot define GUC_LIST_QUOTE variables");
4910 :
4911 : /*
4912 : * Before pljava commit 398f3b876ed402bdaec8bc804f29e2be95c75139
4913 : * (2015-12-15), two of that module's PGC_USERSET variables facilitated
4914 : * trivial escalation to superuser privileges. Restrict the variables to
4915 : * protect sites that have yet to upgrade pljava.
4916 : */
4917 18570 : if (context == PGC_USERSET &&
4918 14270 : (strcmp(name, "pljava.classpath") == 0 ||
4919 14270 : strcmp(name, "pljava.vmoptions") == 0))
4920 0 : context = PGC_SUSET;
4921 :
4922 : /* As above, an OOM here is FATAL */
4923 18570 : gen = (struct config_generic *) guc_malloc(FATAL, sz);
4924 18570 : memset(gen, 0, sz);
4925 :
4926 18570 : gen->name = guc_strdup(FATAL, name);
4927 18570 : gen->context = context;
4928 18570 : gen->group = CUSTOM_OPTIONS;
4929 18570 : gen->short_desc = short_desc;
4930 18570 : gen->long_desc = long_desc;
4931 18570 : gen->flags = flags;
4932 18570 : gen->vartype = type;
4933 :
4934 18570 : return gen;
4935 : }
4936 :
4937 : /*
4938 : * Common code for DefineCustomXXXVariable subroutines: insert the new
4939 : * variable into the GUC variable hash, replacing any placeholder.
4940 : */
4941 : static void
4942 18570 : define_custom_variable(struct config_generic *variable)
4943 : {
4944 18570 : const char *name = variable->name;
4945 : GUCHashEntry *hentry;
4946 : struct config_string *pHolder;
4947 :
4948 : /* Check mapping between initial and default value */
4949 : Assert(check_GUC_init(variable));
4950 :
4951 : /*
4952 : * See if there's a placeholder by the same name.
4953 : */
4954 18570 : hentry = (GUCHashEntry *) hash_search(guc_hashtab,
4955 : &name,
4956 : HASH_FIND,
4957 : NULL);
4958 18570 : if (hentry == NULL)
4959 : {
4960 : /*
4961 : * No placeholder to replace, so we can just add it ... but first,
4962 : * make sure it's initialized to its default value.
4963 : */
4964 18462 : InitializeOneGUCOption(variable);
4965 18462 : add_guc_variable(variable, ERROR);
4966 18462 : return;
4967 : }
4968 :
4969 : /*
4970 : * This better be a placeholder
4971 : */
4972 108 : if ((hentry->gucvar->flags & GUC_CUSTOM_PLACEHOLDER) == 0)
4973 0 : ereport(ERROR,
4974 : (errcode(ERRCODE_INTERNAL_ERROR),
4975 : errmsg("attempt to redefine parameter \"%s\"", name)));
4976 :
4977 : Assert(hentry->gucvar->vartype == PGC_STRING);
4978 108 : pHolder = (struct config_string *) hentry->gucvar;
4979 :
4980 : /*
4981 : * First, set the variable to its default value. We must do this even
4982 : * though we intend to immediately apply a new value, since it's possible
4983 : * that the new value is invalid.
4984 : */
4985 108 : InitializeOneGUCOption(variable);
4986 :
4987 : /*
4988 : * Replace the placeholder in the hash table. We aren't changing the name
4989 : * (at least up to case-folding), so the hash value is unchanged.
4990 : */
4991 108 : hentry->gucname = name;
4992 108 : hentry->gucvar = variable;
4993 :
4994 : /*
4995 : * Remove the placeholder from any lists it's in, too.
4996 : */
4997 108 : RemoveGUCFromLists(&pHolder->gen);
4998 :
4999 : /*
5000 : * Assign the string value(s) stored in the placeholder to the real
5001 : * variable. Essentially, we need to duplicate all the active and stacked
5002 : * values, but with appropriate validation and datatype adjustment.
5003 : *
5004 : * If an assignment fails, we report a WARNING and keep going. We don't
5005 : * want to throw ERROR for bad values, because it'd bollix the add-on
5006 : * module that's presumably halfway through getting loaded. In such cases
5007 : * the default or previous state will become active instead.
5008 : */
5009 :
5010 : /* First, apply the reset value if any */
5011 108 : if (pHolder->reset_val)
5012 102 : (void) set_config_option_ext(name, pHolder->reset_val,
5013 : pHolder->gen.reset_scontext,
5014 : pHolder->gen.reset_source,
5015 : pHolder->gen.reset_srole,
5016 : GUC_ACTION_SET, true, WARNING, false);
5017 : /* That should not have resulted in stacking anything */
5018 : Assert(variable->stack == NULL);
5019 :
5020 : /* Now, apply current and stacked values, in the order they were stacked */
5021 108 : reapply_stacked_values(variable, pHolder, pHolder->gen.stack,
5022 108 : *(pHolder->variable),
5023 : pHolder->gen.scontext, pHolder->gen.source,
5024 : pHolder->gen.srole);
5025 :
5026 : /* Also copy over any saved source-location information */
5027 108 : if (pHolder->gen.sourcefile)
5028 86 : set_config_sourcefile(name, pHolder->gen.sourcefile,
5029 : pHolder->gen.sourceline);
5030 :
5031 : /* Now we can free the no-longer-referenced placeholder variable */
5032 108 : free_placeholder(pHolder);
5033 : }
5034 :
5035 : /*
5036 : * Recursive subroutine for define_custom_variable: reapply non-reset values
5037 : *
5038 : * We recurse so that the values are applied in the same order as originally.
5039 : * At each recursion level, apply the upper-level value (passed in) in the
5040 : * fashion implied by the stack entry.
5041 : */
5042 : static void
5043 108 : reapply_stacked_values(struct config_generic *variable,
5044 : struct config_string *pHolder,
5045 : GucStack *stack,
5046 : const char *curvalue,
5047 : GucContext curscontext, GucSource cursource,
5048 : Oid cursrole)
5049 : {
5050 108 : const char *name = variable->name;
5051 108 : GucStack *oldvarstack = variable->stack;
5052 :
5053 108 : if (stack != NULL)
5054 : {
5055 : /* First, recurse, so that stack items are processed bottom to top */
5056 0 : reapply_stacked_values(variable, pHolder, stack->prev,
5057 0 : stack->prior.val.stringval,
5058 : stack->scontext, stack->source, stack->srole);
5059 :
5060 : /* See how to apply the passed-in value */
5061 0 : switch (stack->state)
5062 : {
5063 0 : case GUC_SAVE:
5064 0 : (void) set_config_option_ext(name, curvalue,
5065 : curscontext, cursource, cursrole,
5066 : GUC_ACTION_SAVE, true,
5067 : WARNING, false);
5068 0 : break;
5069 :
5070 0 : case GUC_SET:
5071 0 : (void) set_config_option_ext(name, curvalue,
5072 : curscontext, cursource, cursrole,
5073 : GUC_ACTION_SET, true,
5074 : WARNING, false);
5075 0 : break;
5076 :
5077 0 : case GUC_LOCAL:
5078 0 : (void) set_config_option_ext(name, curvalue,
5079 : curscontext, cursource, cursrole,
5080 : GUC_ACTION_LOCAL, true,
5081 : WARNING, false);
5082 0 : break;
5083 :
5084 0 : case GUC_SET_LOCAL:
5085 : /* first, apply the masked value as SET */
5086 0 : (void) set_config_option_ext(name, stack->masked.val.stringval,
5087 : stack->masked_scontext,
5088 : PGC_S_SESSION,
5089 : stack->masked_srole,
5090 : GUC_ACTION_SET, true,
5091 : WARNING, false);
5092 : /* then apply the current value as LOCAL */
5093 0 : (void) set_config_option_ext(name, curvalue,
5094 : curscontext, cursource, cursrole,
5095 : GUC_ACTION_LOCAL, true,
5096 : WARNING, false);
5097 0 : break;
5098 : }
5099 :
5100 : /* If we successfully made a stack entry, adjust its nest level */
5101 0 : if (variable->stack != oldvarstack)
5102 0 : variable->stack->nest_level = stack->nest_level;
5103 : }
5104 : else
5105 : {
5106 : /*
5107 : * We are at the end of the stack. If the active/previous value is
5108 : * different from the reset value, it must represent a previously
5109 : * committed session value. Apply it, and then drop the stack entry
5110 : * that set_config_option will have created under the impression that
5111 : * this is to be just a transactional assignment. (We leak the stack
5112 : * entry.)
5113 : */
5114 108 : if (curvalue != pHolder->reset_val ||
5115 102 : curscontext != pHolder->gen.reset_scontext ||
5116 102 : cursource != pHolder->gen.reset_source ||
5117 102 : cursrole != pHolder->gen.reset_srole)
5118 : {
5119 6 : (void) set_config_option_ext(name, curvalue,
5120 : curscontext, cursource, cursrole,
5121 : GUC_ACTION_SET, true, WARNING, false);
5122 6 : if (variable->stack != NULL)
5123 : {
5124 4 : slist_delete(&guc_stack_list, &variable->stack_link);
5125 4 : variable->stack = NULL;
5126 : }
5127 : }
5128 : }
5129 108 : }
5130 :
5131 : /*
5132 : * Free up a no-longer-referenced placeholder GUC variable.
5133 : *
5134 : * This neglects any stack items, so it's possible for some memory to be
5135 : * leaked. Since this can only happen once per session per variable, it
5136 : * doesn't seem worth spending much code on.
5137 : */
5138 : static void
5139 116 : free_placeholder(struct config_string *pHolder)
5140 : {
5141 : /* Placeholders are always STRING type, so free their values */
5142 : Assert(pHolder->gen.vartype == PGC_STRING);
5143 116 : set_string_field(pHolder, pHolder->variable, NULL);
5144 116 : set_string_field(pHolder, &pHolder->reset_val, NULL);
5145 :
5146 116 : guc_free(unconstify(char *, pHolder->gen.name));
5147 116 : guc_free(pHolder);
5148 116 : }
5149 :
5150 : /*
5151 : * Functions for extensions to call to define their custom GUC variables.
5152 : */
5153 : void
5154 7448 : DefineCustomBoolVariable(const char *name,
5155 : const char *short_desc,
5156 : const char *long_desc,
5157 : bool *valueAddr,
5158 : bool bootValue,
5159 : GucContext context,
5160 : int flags,
5161 : GucBoolCheckHook check_hook,
5162 : GucBoolAssignHook assign_hook,
5163 : GucShowHook show_hook)
5164 : {
5165 : struct config_bool *var;
5166 :
5167 : var = (struct config_bool *)
5168 7448 : init_custom_variable(name, short_desc, long_desc, context, flags,
5169 : PGC_BOOL, sizeof(struct config_bool));
5170 7448 : var->variable = valueAddr;
5171 7448 : var->boot_val = bootValue;
5172 7448 : var->reset_val = bootValue;
5173 7448 : var->check_hook = check_hook;
5174 7448 : var->assign_hook = assign_hook;
5175 7448 : var->show_hook = show_hook;
5176 7448 : define_custom_variable(&var->gen);
5177 7448 : }
5178 :
5179 : void
5180 100 : DefineCustomIntVariable(const char *name,
5181 : const char *short_desc,
5182 : const char *long_desc,
5183 : int *valueAddr,
5184 : int bootValue,
5185 : int minValue,
5186 : int maxValue,
5187 : GucContext context,
5188 : int flags,
5189 : GucIntCheckHook check_hook,
5190 : GucIntAssignHook assign_hook,
5191 : GucShowHook show_hook)
5192 : {
5193 : struct config_int *var;
5194 :
5195 : var = (struct config_int *)
5196 100 : init_custom_variable(name, short_desc, long_desc, context, flags,
5197 : PGC_INT, sizeof(struct config_int));
5198 100 : var->variable = valueAddr;
5199 100 : var->boot_val = bootValue;
5200 100 : var->reset_val = bootValue;
5201 100 : var->min = minValue;
5202 100 : var->max = maxValue;
5203 100 : var->check_hook = check_hook;
5204 100 : var->assign_hook = assign_hook;
5205 100 : var->show_hook = show_hook;
5206 100 : define_custom_variable(&var->gen);
5207 100 : }
5208 :
5209 : void
5210 46 : DefineCustomRealVariable(const char *name,
5211 : const char *short_desc,
5212 : const char *long_desc,
5213 : double *valueAddr,
5214 : double bootValue,
5215 : double minValue,
5216 : double maxValue,
5217 : GucContext context,
5218 : int flags,
5219 : GucRealCheckHook check_hook,
5220 : GucRealAssignHook assign_hook,
5221 : GucShowHook show_hook)
5222 : {
5223 : struct config_real *var;
5224 :
5225 : var = (struct config_real *)
5226 46 : init_custom_variable(name, short_desc, long_desc, context, flags,
5227 : PGC_REAL, sizeof(struct config_real));
5228 46 : var->variable = valueAddr;
5229 46 : var->boot_val = bootValue;
5230 46 : var->reset_val = bootValue;
5231 46 : var->min = minValue;
5232 46 : var->max = maxValue;
5233 46 : var->check_hook = check_hook;
5234 46 : var->assign_hook = assign_hook;
5235 46 : var->show_hook = show_hook;
5236 46 : define_custom_variable(&var->gen);
5237 46 : }
5238 :
5239 : void
5240 7318 : DefineCustomStringVariable(const char *name,
5241 : const char *short_desc,
5242 : const char *long_desc,
5243 : char **valueAddr,
5244 : const char *bootValue,
5245 : GucContext context,
5246 : int flags,
5247 : GucStringCheckHook check_hook,
5248 : GucStringAssignHook assign_hook,
5249 : GucShowHook show_hook)
5250 : {
5251 : struct config_string *var;
5252 :
5253 : var = (struct config_string *)
5254 7318 : init_custom_variable(name, short_desc, long_desc, context, flags,
5255 : PGC_STRING, sizeof(struct config_string));
5256 7318 : var->variable = valueAddr;
5257 7318 : var->boot_val = bootValue;
5258 7318 : var->check_hook = check_hook;
5259 7318 : var->assign_hook = assign_hook;
5260 7318 : var->show_hook = show_hook;
5261 7318 : define_custom_variable(&var->gen);
5262 7318 : }
5263 :
5264 : void
5265 3658 : DefineCustomEnumVariable(const char *name,
5266 : const char *short_desc,
5267 : const char *long_desc,
5268 : int *valueAddr,
5269 : int bootValue,
5270 : const struct config_enum_entry *options,
5271 : GucContext context,
5272 : int flags,
5273 : GucEnumCheckHook check_hook,
5274 : GucEnumAssignHook assign_hook,
5275 : GucShowHook show_hook)
5276 : {
5277 : struct config_enum *var;
5278 :
5279 : var = (struct config_enum *)
5280 3658 : init_custom_variable(name, short_desc, long_desc, context, flags,
5281 : PGC_ENUM, sizeof(struct config_enum));
5282 3658 : var->variable = valueAddr;
5283 3658 : var->boot_val = bootValue;
5284 3658 : var->reset_val = bootValue;
5285 3658 : var->options = options;
5286 3658 : var->check_hook = check_hook;
5287 3658 : var->assign_hook = assign_hook;
5288 3658 : var->show_hook = show_hook;
5289 3658 : define_custom_variable(&var->gen);
5290 3658 : }
5291 :
5292 : /*
5293 : * Mark the given GUC prefix as "reserved".
5294 : *
5295 : * This deletes any existing placeholders matching the prefix,
5296 : * and then prevents new ones from being created.
5297 : * Extensions should call this after they've defined all of their custom
5298 : * GUCs, to help catch misspelled config-file entries.
5299 : */
5300 : void
5301 3788 : MarkGUCPrefixReserved(const char *className)
5302 : {
5303 3788 : int classLen = strlen(className);
5304 : HASH_SEQ_STATUS status;
5305 : GUCHashEntry *hentry;
5306 : MemoryContext oldcontext;
5307 :
5308 : /*
5309 : * Check for existing placeholders. We must actually remove invalid
5310 : * placeholders, else future parallel worker startups will fail.
5311 : */
5312 3788 : hash_seq_init(&status, guc_hashtab);
5313 1568852 : while ((hentry = (GUCHashEntry *) hash_seq_search(&status)) != NULL)
5314 : {
5315 1565064 : struct config_generic *var = hentry->gucvar;
5316 :
5317 1565064 : if ((var->flags & GUC_CUSTOM_PLACEHOLDER) != 0 &&
5318 26 : strncmp(className, var->name, classLen) == 0 &&
5319 8 : var->name[classLen] == GUC_QUALIFIER_SEPARATOR)
5320 : {
5321 8 : ereport(WARNING,
5322 : (errcode(ERRCODE_INVALID_NAME),
5323 : errmsg("invalid configuration parameter name \"%s\", removing it",
5324 : var->name),
5325 : errdetail("\"%s\" is now a reserved prefix.",
5326 : className)));
5327 : /* Remove it from the hash table */
5328 8 : hash_search(guc_hashtab,
5329 8 : &var->name,
5330 : HASH_REMOVE,
5331 : NULL);
5332 : /* Remove it from any lists it's in, too */
5333 8 : RemoveGUCFromLists(var);
5334 : /* And free it */
5335 8 : free_placeholder((struct config_string *) var);
5336 : }
5337 : }
5338 :
5339 : /* And remember the name so we can prevent future mistakes. */
5340 3788 : oldcontext = MemoryContextSwitchTo(GUCMemoryContext);
5341 3788 : reserved_class_prefix = lappend(reserved_class_prefix, pstrdup(className));
5342 3788 : MemoryContextSwitchTo(oldcontext);
5343 3788 : }
5344 :
5345 :
5346 : /*
5347 : * Return an array of modified GUC options to show in EXPLAIN.
5348 : *
5349 : * We only report options related to query planning (marked with GUC_EXPLAIN),
5350 : * with values different from their built-in defaults.
5351 : */
5352 : struct config_generic **
5353 12 : get_explain_guc_options(int *num)
5354 : {
5355 : struct config_generic **result;
5356 : dlist_iter iter;
5357 :
5358 12 : *num = 0;
5359 :
5360 : /*
5361 : * While only a fraction of all the GUC variables are marked GUC_EXPLAIN,
5362 : * it doesn't seem worth dynamically resizing this array.
5363 : */
5364 12 : result = palloc(sizeof(struct config_generic *) * hash_get_num_entries(guc_hashtab));
5365 :
5366 : /* We need only consider GUCs with source not PGC_S_DEFAULT */
5367 728 : dlist_foreach(iter, &guc_nondef_list)
5368 : {
5369 716 : struct config_generic *conf = dlist_container(struct config_generic,
5370 : nondef_link, iter.cur);
5371 : bool modified;
5372 :
5373 : /* return only parameters marked for inclusion in explain */
5374 716 : if (!(conf->flags & GUC_EXPLAIN))
5375 692 : continue;
5376 :
5377 : /* return only options visible to the current user */
5378 24 : if (!ConfigOptionIsVisible(conf))
5379 0 : continue;
5380 :
5381 : /* return only options that are different from their boot values */
5382 24 : modified = false;
5383 :
5384 24 : switch (conf->vartype)
5385 : {
5386 12 : case PGC_BOOL:
5387 : {
5388 12 : struct config_bool *lconf = (struct config_bool *) conf;
5389 :
5390 12 : modified = (lconf->boot_val != *(lconf->variable));
5391 : }
5392 12 : break;
5393 :
5394 0 : case PGC_INT:
5395 : {
5396 0 : struct config_int *lconf = (struct config_int *) conf;
5397 :
5398 0 : modified = (lconf->boot_val != *(lconf->variable));
5399 : }
5400 0 : break;
5401 :
5402 0 : case PGC_REAL:
5403 : {
5404 0 : struct config_real *lconf = (struct config_real *) conf;
5405 :
5406 0 : modified = (lconf->boot_val != *(lconf->variable));
5407 : }
5408 0 : break;
5409 :
5410 0 : case PGC_STRING:
5411 : {
5412 0 : struct config_string *lconf = (struct config_string *) conf;
5413 :
5414 0 : if (lconf->boot_val == NULL &&
5415 0 : *lconf->variable == NULL)
5416 0 : modified = false;
5417 0 : else if (lconf->boot_val == NULL ||
5418 0 : *lconf->variable == NULL)
5419 0 : modified = true;
5420 : else
5421 0 : modified = (strcmp(lconf->boot_val, *(lconf->variable)) != 0);
5422 : }
5423 0 : break;
5424 :
5425 12 : case PGC_ENUM:
5426 : {
5427 12 : struct config_enum *lconf = (struct config_enum *) conf;
5428 :
5429 12 : modified = (lconf->boot_val != *(lconf->variable));
5430 : }
5431 12 : break;
5432 :
5433 0 : default:
5434 0 : elog(ERROR, "unexpected GUC type: %d", conf->vartype);
5435 : }
5436 :
5437 24 : if (!modified)
5438 0 : continue;
5439 :
5440 : /* OK, report it */
5441 24 : result[*num] = conf;
5442 24 : *num = *num + 1;
5443 : }
5444 :
5445 12 : return result;
5446 : }
5447 :
5448 : /*
5449 : * Return GUC variable value by name; optionally return canonical form of
5450 : * name. If the GUC is unset, then throw an error unless missing_ok is true,
5451 : * in which case return NULL. Return value is palloc'd (but *varname isn't).
5452 : */
5453 : char *
5454 12224 : GetConfigOptionByName(const char *name, const char **varname, bool missing_ok)
5455 : {
5456 : struct config_generic *record;
5457 :
5458 12224 : record = find_option(name, false, missing_ok, ERROR);
5459 12186 : if (record == NULL)
5460 : {
5461 6 : if (varname)
5462 0 : *varname = NULL;
5463 6 : return NULL;
5464 : }
5465 :
5466 12180 : if (!ConfigOptionIsVisible(record))
5467 2 : ereport(ERROR,
5468 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
5469 : errmsg("permission denied to examine \"%s\"", name),
5470 : errdetail("Only roles with privileges of the \"%s\" role may examine this parameter.",
5471 : "pg_read_all_settings")));
5472 :
5473 12178 : if (varname)
5474 2850 : *varname = record->name;
5475 :
5476 12178 : return ShowGUCOption(record, true);
5477 : }
5478 :
5479 : /*
5480 : * ShowGUCOption: get string value of variable
5481 : *
5482 : * We express a numeric value in appropriate units if it has units and
5483 : * use_units is true; else you just get the raw number.
5484 : * The result string is palloc'd.
5485 : */
5486 : char *
5487 2060080 : ShowGUCOption(struct config_generic *record, bool use_units)
5488 : {
5489 : char buffer[256];
5490 : const char *val;
5491 :
5492 2060080 : switch (record->vartype)
5493 : {
5494 576470 : case PGC_BOOL:
5495 : {
5496 576470 : struct config_bool *conf = (struct config_bool *) record;
5497 :
5498 576470 : if (conf->show_hook)
5499 30548 : val = conf->show_hook();
5500 : else
5501 545922 : val = *conf->variable ? "on" : "off";
5502 : }
5503 576470 : break;
5504 :
5505 534106 : case PGC_INT:
5506 : {
5507 534106 : struct config_int *conf = (struct config_int *) record;
5508 :
5509 534106 : if (conf->show_hook)
5510 25028 : val = conf->show_hook();
5511 : else
5512 : {
5513 : /*
5514 : * Use int64 arithmetic to avoid overflows in units
5515 : * conversion.
5516 : */
5517 509078 : int64 result = *conf->variable;
5518 : const char *unit;
5519 :
5520 509078 : if (use_units && result > 0 && (record->flags & GUC_UNIT))
5521 756 : convert_int_from_base_unit(result,
5522 756 : record->flags & GUC_UNIT,
5523 : &result, &unit);
5524 : else
5525 508322 : unit = "";
5526 :
5527 509078 : snprintf(buffer, sizeof(buffer), INT64_FORMAT "%s",
5528 : result, unit);
5529 509078 : val = buffer;
5530 : }
5531 : }
5532 534106 : break;
5533 :
5534 86976 : case PGC_REAL:
5535 : {
5536 86976 : struct config_real *conf = (struct config_real *) record;
5537 :
5538 86976 : if (conf->show_hook)
5539 0 : val = conf->show_hook();
5540 : else
5541 : {
5542 86976 : double result = *conf->variable;
5543 : const char *unit;
5544 :
5545 86976 : if (use_units && result > 0 && (record->flags & GUC_UNIT))
5546 268 : convert_real_from_base_unit(result,
5547 268 : record->flags & GUC_UNIT,
5548 : &result, &unit);
5549 : else
5550 86708 : unit = "";
5551 :
5552 86976 : snprintf(buffer, sizeof(buffer), "%g%s",
5553 : result, unit);
5554 86976 : val = buffer;
5555 : }
5556 : }
5557 86976 : break;
5558 :
5559 686912 : case PGC_STRING:
5560 : {
5561 686912 : struct config_string *conf = (struct config_string *) record;
5562 :
5563 686912 : if (conf->show_hook)
5564 63116 : val = conf->show_hook();
5565 623796 : else if (*conf->variable && **conf->variable)
5566 476000 : val = *conf->variable;
5567 : else
5568 147796 : val = "";
5569 : }
5570 686912 : break;
5571 :
5572 175616 : case PGC_ENUM:
5573 : {
5574 175616 : struct config_enum *conf = (struct config_enum *) record;
5575 :
5576 175616 : if (conf->show_hook)
5577 0 : val = conf->show_hook();
5578 : else
5579 175616 : val = config_enum_lookup_by_value(conf, *conf->variable);
5580 : }
5581 175616 : break;
5582 :
5583 0 : default:
5584 : /* just to keep compiler quiet */
5585 0 : val = "???";
5586 0 : break;
5587 : }
5588 :
5589 2060080 : return pstrdup(val);
5590 : }
5591 :
5592 :
5593 : #ifdef EXEC_BACKEND
5594 :
5595 : /*
5596 : * These routines dump out all non-default GUC options into a binary
5597 : * file that is read by all exec'ed backends. The format is:
5598 : *
5599 : * variable name, string, null terminated
5600 : * variable value, string, null terminated
5601 : * variable sourcefile, string, null terminated (empty if none)
5602 : * variable sourceline, integer
5603 : * variable source, integer
5604 : * variable scontext, integer
5605 : * variable srole, OID
5606 : */
5607 : static void
5608 : write_one_nondefault_variable(FILE *fp, struct config_generic *gconf)
5609 : {
5610 : Assert(gconf->source != PGC_S_DEFAULT);
5611 :
5612 : fprintf(fp, "%s", gconf->name);
5613 : fputc(0, fp);
5614 :
5615 : switch (gconf->vartype)
5616 : {
5617 : case PGC_BOOL:
5618 : {
5619 : struct config_bool *conf = (struct config_bool *) gconf;
5620 :
5621 : if (*conf->variable)
5622 : fprintf(fp, "true");
5623 : else
5624 : fprintf(fp, "false");
5625 : }
5626 : break;
5627 :
5628 : case PGC_INT:
5629 : {
5630 : struct config_int *conf = (struct config_int *) gconf;
5631 :
5632 : fprintf(fp, "%d", *conf->variable);
5633 : }
5634 : break;
5635 :
5636 : case PGC_REAL:
5637 : {
5638 : struct config_real *conf = (struct config_real *) gconf;
5639 :
5640 : fprintf(fp, "%.17g", *conf->variable);
5641 : }
5642 : break;
5643 :
5644 : case PGC_STRING:
5645 : {
5646 : struct config_string *conf = (struct config_string *) gconf;
5647 :
5648 : if (*conf->variable)
5649 : fprintf(fp, "%s", *conf->variable);
5650 : }
5651 : break;
5652 :
5653 : case PGC_ENUM:
5654 : {
5655 : struct config_enum *conf = (struct config_enum *) gconf;
5656 :
5657 : fprintf(fp, "%s",
5658 : config_enum_lookup_by_value(conf, *conf->variable));
5659 : }
5660 : break;
5661 : }
5662 :
5663 : fputc(0, fp);
5664 :
5665 : if (gconf->sourcefile)
5666 : fprintf(fp, "%s", gconf->sourcefile);
5667 : fputc(0, fp);
5668 :
5669 : fwrite(&gconf->sourceline, 1, sizeof(gconf->sourceline), fp);
5670 : fwrite(&gconf->source, 1, sizeof(gconf->source), fp);
5671 : fwrite(&gconf->scontext, 1, sizeof(gconf->scontext), fp);
5672 : fwrite(&gconf->srole, 1, sizeof(gconf->srole), fp);
5673 : }
5674 :
5675 : void
5676 : write_nondefault_variables(GucContext context)
5677 : {
5678 : int elevel;
5679 : FILE *fp;
5680 : dlist_iter iter;
5681 :
5682 : Assert(context == PGC_POSTMASTER || context == PGC_SIGHUP);
5683 :
5684 : elevel = (context == PGC_SIGHUP) ? LOG : ERROR;
5685 :
5686 : /*
5687 : * Open file
5688 : */
5689 : fp = AllocateFile(CONFIG_EXEC_PARAMS_NEW, "w");
5690 : if (!fp)
5691 : {
5692 : ereport(elevel,
5693 : (errcode_for_file_access(),
5694 : errmsg("could not write to file \"%s\": %m",
5695 : CONFIG_EXEC_PARAMS_NEW)));
5696 : return;
5697 : }
5698 :
5699 : /* We need only consider GUCs with source not PGC_S_DEFAULT */
5700 : dlist_foreach(iter, &guc_nondef_list)
5701 : {
5702 : struct config_generic *gconf = dlist_container(struct config_generic,
5703 : nondef_link, iter.cur);
5704 :
5705 : write_one_nondefault_variable(fp, gconf);
5706 : }
5707 :
5708 : if (FreeFile(fp))
5709 : {
5710 : ereport(elevel,
5711 : (errcode_for_file_access(),
5712 : errmsg("could not write to file \"%s\": %m",
5713 : CONFIG_EXEC_PARAMS_NEW)));
5714 : return;
5715 : }
5716 :
5717 : /*
5718 : * Put new file in place. This could delay on Win32, but we don't hold
5719 : * any exclusive locks.
5720 : */
5721 : rename(CONFIG_EXEC_PARAMS_NEW, CONFIG_EXEC_PARAMS);
5722 : }
5723 :
5724 :
5725 : /*
5726 : * Read string, including null byte from file
5727 : *
5728 : * Return NULL on EOF and nothing read
5729 : */
5730 : static char *
5731 : read_string_with_null(FILE *fp)
5732 : {
5733 : int i = 0,
5734 : ch,
5735 : maxlen = 256;
5736 : char *str = NULL;
5737 :
5738 : do
5739 : {
5740 : if ((ch = fgetc(fp)) == EOF)
5741 : {
5742 : if (i == 0)
5743 : return NULL;
5744 : else
5745 : elog(FATAL, "invalid format of exec config params file");
5746 : }
5747 : if (i == 0)
5748 : str = guc_malloc(FATAL, maxlen);
5749 : else if (i == maxlen)
5750 : str = guc_realloc(FATAL, str, maxlen *= 2);
5751 : str[i++] = ch;
5752 : } while (ch != 0);
5753 :
5754 : return str;
5755 : }
5756 :
5757 :
5758 : /*
5759 : * This routine loads a previous postmaster dump of its non-default
5760 : * settings.
5761 : */
5762 : void
5763 : read_nondefault_variables(void)
5764 : {
5765 : FILE *fp;
5766 : char *varname,
5767 : *varvalue,
5768 : *varsourcefile;
5769 : int varsourceline;
5770 : GucSource varsource;
5771 : GucContext varscontext;
5772 : Oid varsrole;
5773 :
5774 : /*
5775 : * Open file
5776 : */
5777 : fp = AllocateFile(CONFIG_EXEC_PARAMS, "r");
5778 : if (!fp)
5779 : {
5780 : /* File not found is fine */
5781 : if (errno != ENOENT)
5782 : ereport(FATAL,
5783 : (errcode_for_file_access(),
5784 : errmsg("could not read from file \"%s\": %m",
5785 : CONFIG_EXEC_PARAMS)));
5786 : return;
5787 : }
5788 :
5789 : for (;;)
5790 : {
5791 : if ((varname = read_string_with_null(fp)) == NULL)
5792 : break;
5793 :
5794 : if (find_option(varname, true, false, FATAL) == NULL)
5795 : elog(FATAL, "failed to locate variable \"%s\" in exec config params file", varname);
5796 :
5797 : if ((varvalue = read_string_with_null(fp)) == NULL)
5798 : elog(FATAL, "invalid format of exec config params file");
5799 : if ((varsourcefile = read_string_with_null(fp)) == NULL)
5800 : elog(FATAL, "invalid format of exec config params file");
5801 : if (fread(&varsourceline, 1, sizeof(varsourceline), fp) != sizeof(varsourceline))
5802 : elog(FATAL, "invalid format of exec config params file");
5803 : if (fread(&varsource, 1, sizeof(varsource), fp) != sizeof(varsource))
5804 : elog(FATAL, "invalid format of exec config params file");
5805 : if (fread(&varscontext, 1, sizeof(varscontext), fp) != sizeof(varscontext))
5806 : elog(FATAL, "invalid format of exec config params file");
5807 : if (fread(&varsrole, 1, sizeof(varsrole), fp) != sizeof(varsrole))
5808 : elog(FATAL, "invalid format of exec config params file");
5809 :
5810 : (void) set_config_option_ext(varname, varvalue,
5811 : varscontext, varsource, varsrole,
5812 : GUC_ACTION_SET, true, 0, true);
5813 : if (varsourcefile[0])
5814 : set_config_sourcefile(varname, varsourcefile, varsourceline);
5815 :
5816 : guc_free(varname);
5817 : guc_free(varvalue);
5818 : guc_free(varsourcefile);
5819 : }
5820 :
5821 : FreeFile(fp);
5822 : }
5823 : #endif /* EXEC_BACKEND */
5824 :
5825 : /*
5826 : * can_skip_gucvar:
5827 : * Decide whether SerializeGUCState can skip sending this GUC variable,
5828 : * or whether RestoreGUCState can skip resetting this GUC to default.
5829 : *
5830 : * It is somewhat magical and fragile that the same test works for both cases.
5831 : * Realize in particular that we are very likely selecting different sets of
5832 : * GUCs on the leader and worker sides! Be sure you've understood the
5833 : * comments here and in RestoreGUCState thoroughly before changing this.
5834 : */
5835 : static bool
5836 257280 : can_skip_gucvar(struct config_generic *gconf)
5837 : {
5838 : /*
5839 : * We can skip GUCs that are guaranteed to have the same values in leaders
5840 : * and workers. (Note it is critical that the leader and worker have the
5841 : * same idea of which GUCs fall into this category. It's okay to consider
5842 : * context and name for this purpose, since those are unchanging
5843 : * properties of a GUC.)
5844 : *
5845 : * PGC_POSTMASTER variables always have the same value in every child of a
5846 : * particular postmaster, so the worker will certainly have the right
5847 : * value already. Likewise, PGC_INTERNAL variables are set by special
5848 : * mechanisms (if indeed they aren't compile-time constants). So we may
5849 : * always skip these.
5850 : *
5851 : * For all other GUCs, we skip if the GUC has its compiled-in default
5852 : * value (i.e., source == PGC_S_DEFAULT). On the leader side, this means
5853 : * we don't send GUCs that have their default values, which typically
5854 : * saves lots of work. On the worker side, this means we don't need to
5855 : * reset the GUC to default because it already has that value. See
5856 : * comments in RestoreGUCState for more info.
5857 : */
5858 422406 : return gconf->context == PGC_POSTMASTER ||
5859 385974 : gconf->context == PGC_INTERNAL ||
5860 128694 : gconf->source == PGC_S_DEFAULT;
5861 : }
5862 :
5863 : /*
5864 : * estimate_variable_size:
5865 : * Compute space needed for dumping the given GUC variable.
5866 : *
5867 : * It's OK to overestimate, but not to underestimate.
5868 : */
5869 : static Size
5870 56790 : estimate_variable_size(struct config_generic *gconf)
5871 : {
5872 : Size size;
5873 56790 : Size valsize = 0;
5874 :
5875 : /* Skippable GUCs consume zero space. */
5876 56790 : if (can_skip_gucvar(gconf))
5877 25664 : return 0;
5878 :
5879 : /* Name, plus trailing zero byte. */
5880 31126 : size = strlen(gconf->name) + 1;
5881 :
5882 : /* Get the maximum display length of the GUC value. */
5883 31126 : switch (gconf->vartype)
5884 : {
5885 6276 : case PGC_BOOL:
5886 : {
5887 6276 : valsize = 5; /* max(strlen('true'), strlen('false')) */
5888 : }
5889 6276 : break;
5890 :
5891 6124 : case PGC_INT:
5892 : {
5893 6124 : struct config_int *conf = (struct config_int *) gconf;
5894 :
5895 : /*
5896 : * Instead of getting the exact display length, use max
5897 : * length. Also reduce the max length for typical ranges of
5898 : * small values. Maximum value is 2147483647, i.e. 10 chars.
5899 : * Include one byte for sign.
5900 : */
5901 6124 : if (abs(*conf->variable) < 1000)
5902 4820 : valsize = 3 + 1;
5903 : else
5904 1304 : valsize = 10 + 1;
5905 : }
5906 6124 : break;
5907 :
5908 1676 : case PGC_REAL:
5909 : {
5910 : /*
5911 : * We are going to print it with %e with REALTYPE_PRECISION
5912 : * fractional digits. Account for sign, leading digit,
5913 : * decimal point, and exponent with up to 3 digits. E.g.
5914 : * -3.99329042340000021e+110
5915 : */
5916 1676 : valsize = 1 + 1 + 1 + REALTYPE_PRECISION + 5;
5917 : }
5918 1676 : break;
5919 :
5920 13244 : case PGC_STRING:
5921 : {
5922 13244 : struct config_string *conf = (struct config_string *) gconf;
5923 :
5924 : /*
5925 : * If the value is NULL, we transmit it as an empty string.
5926 : * Although this is not physically the same value, GUC
5927 : * generally treats a NULL the same as empty string.
5928 : */
5929 13244 : if (*conf->variable)
5930 13244 : valsize = strlen(*conf->variable);
5931 : else
5932 0 : valsize = 0;
5933 : }
5934 13244 : break;
5935 :
5936 3806 : case PGC_ENUM:
5937 : {
5938 3806 : struct config_enum *conf = (struct config_enum *) gconf;
5939 :
5940 3806 : valsize = strlen(config_enum_lookup_by_value(conf, *conf->variable));
5941 : }
5942 3806 : break;
5943 : }
5944 :
5945 : /* Allow space for terminating zero-byte for value */
5946 31126 : size = add_size(size, valsize + 1);
5947 :
5948 31126 : if (gconf->sourcefile)
5949 15404 : size = add_size(size, strlen(gconf->sourcefile));
5950 :
5951 : /* Allow space for terminating zero-byte for sourcefile */
5952 31126 : size = add_size(size, 1);
5953 :
5954 : /* Include line whenever file is nonempty. */
5955 31126 : if (gconf->sourcefile && gconf->sourcefile[0])
5956 15404 : size = add_size(size, sizeof(gconf->sourceline));
5957 :
5958 31126 : size = add_size(size, sizeof(gconf->source));
5959 31126 : size = add_size(size, sizeof(gconf->scontext));
5960 31126 : size = add_size(size, sizeof(gconf->srole));
5961 :
5962 31126 : return size;
5963 : }
5964 :
5965 : /*
5966 : * EstimateGUCStateSpace:
5967 : * Returns the size needed to store the GUC state for the current process
5968 : */
5969 : Size
5970 910 : EstimateGUCStateSpace(void)
5971 : {
5972 : Size size;
5973 : dlist_iter iter;
5974 :
5975 : /* Add space reqd for saving the data size of the guc state */
5976 910 : size = sizeof(Size);
5977 :
5978 : /*
5979 : * Add up the space needed for each GUC variable.
5980 : *
5981 : * We need only process non-default GUCs.
5982 : */
5983 57700 : dlist_foreach(iter, &guc_nondef_list)
5984 : {
5985 56790 : struct config_generic *gconf = dlist_container(struct config_generic,
5986 : nondef_link, iter.cur);
5987 :
5988 56790 : size = add_size(size, estimate_variable_size(gconf));
5989 : }
5990 :
5991 910 : return size;
5992 : }
5993 :
5994 : /*
5995 : * do_serialize:
5996 : * Copies the formatted string into the destination. Moves ahead the
5997 : * destination pointer, and decrements the maxbytes by that many bytes. If
5998 : * maxbytes is not sufficient to copy the string, error out.
5999 : */
6000 : static void
6001 93378 : do_serialize(char **destptr, Size *maxbytes, const char *fmt,...)
6002 : {
6003 : va_list vargs;
6004 : int n;
6005 :
6006 93378 : if (*maxbytes <= 0)
6007 0 : elog(ERROR, "not enough space to serialize GUC state");
6008 :
6009 93378 : va_start(vargs, fmt);
6010 93378 : n = vsnprintf(*destptr, *maxbytes, fmt, vargs);
6011 93378 : va_end(vargs);
6012 :
6013 93378 : if (n < 0)
6014 : {
6015 : /* Shouldn't happen. Better show errno description. */
6016 0 : elog(ERROR, "vsnprintf failed: %m with format string \"%s\"", fmt);
6017 : }
6018 93378 : if (n >= *maxbytes)
6019 : {
6020 : /* This shouldn't happen either, really. */
6021 0 : elog(ERROR, "not enough space to serialize GUC state");
6022 : }
6023 :
6024 : /* Shift the destptr ahead of the null terminator */
6025 93378 : *destptr += n + 1;
6026 93378 : *maxbytes -= n + 1;
6027 93378 : }
6028 :
6029 : /* Binary copy version of do_serialize() */
6030 : static void
6031 108782 : do_serialize_binary(char **destptr, Size *maxbytes, void *val, Size valsize)
6032 : {
6033 108782 : if (valsize > *maxbytes)
6034 0 : elog(ERROR, "not enough space to serialize GUC state");
6035 :
6036 108782 : memcpy(*destptr, val, valsize);
6037 108782 : *destptr += valsize;
6038 108782 : *maxbytes -= valsize;
6039 108782 : }
6040 :
6041 : /*
6042 : * serialize_variable:
6043 : * Dumps name, value and other information of a GUC variable into destptr.
6044 : */
6045 : static void
6046 56790 : serialize_variable(char **destptr, Size *maxbytes,
6047 : struct config_generic *gconf)
6048 : {
6049 : /* Ignore skippable GUCs. */
6050 56790 : if (can_skip_gucvar(gconf))
6051 25664 : return;
6052 :
6053 31126 : do_serialize(destptr, maxbytes, "%s", gconf->name);
6054 :
6055 31126 : switch (gconf->vartype)
6056 : {
6057 6276 : case PGC_BOOL:
6058 : {
6059 6276 : struct config_bool *conf = (struct config_bool *) gconf;
6060 :
6061 6276 : do_serialize(destptr, maxbytes,
6062 6276 : (*conf->variable ? "true" : "false"));
6063 : }
6064 6276 : break;
6065 :
6066 6124 : case PGC_INT:
6067 : {
6068 6124 : struct config_int *conf = (struct config_int *) gconf;
6069 :
6070 6124 : do_serialize(destptr, maxbytes, "%d", *conf->variable);
6071 : }
6072 6124 : break;
6073 :
6074 1676 : case PGC_REAL:
6075 : {
6076 1676 : struct config_real *conf = (struct config_real *) gconf;
6077 :
6078 1676 : do_serialize(destptr, maxbytes, "%.*e",
6079 1676 : REALTYPE_PRECISION, *conf->variable);
6080 : }
6081 1676 : break;
6082 :
6083 13244 : case PGC_STRING:
6084 : {
6085 13244 : struct config_string *conf = (struct config_string *) gconf;
6086 :
6087 : /* NULL becomes empty string, see estimate_variable_size() */
6088 13244 : do_serialize(destptr, maxbytes, "%s",
6089 13244 : *conf->variable ? *conf->variable : "");
6090 : }
6091 13244 : break;
6092 :
6093 3806 : case PGC_ENUM:
6094 : {
6095 3806 : struct config_enum *conf = (struct config_enum *) gconf;
6096 :
6097 3806 : do_serialize(destptr, maxbytes, "%s",
6098 3806 : config_enum_lookup_by_value(conf, *conf->variable));
6099 : }
6100 3806 : break;
6101 : }
6102 :
6103 31126 : do_serialize(destptr, maxbytes, "%s",
6104 31126 : (gconf->sourcefile ? gconf->sourcefile : ""));
6105 :
6106 31126 : if (gconf->sourcefile && gconf->sourcefile[0])
6107 15404 : do_serialize_binary(destptr, maxbytes, &gconf->sourceline,
6108 : sizeof(gconf->sourceline));
6109 :
6110 31126 : do_serialize_binary(destptr, maxbytes, &gconf->source,
6111 : sizeof(gconf->source));
6112 31126 : do_serialize_binary(destptr, maxbytes, &gconf->scontext,
6113 : sizeof(gconf->scontext));
6114 31126 : do_serialize_binary(destptr, maxbytes, &gconf->srole,
6115 : sizeof(gconf->srole));
6116 : }
6117 :
6118 : /*
6119 : * SerializeGUCState:
6120 : * Dumps the complete GUC state onto the memory location at start_address.
6121 : */
6122 : void
6123 910 : SerializeGUCState(Size maxsize, char *start_address)
6124 : {
6125 : char *curptr;
6126 : Size actual_size;
6127 : Size bytes_left;
6128 : dlist_iter iter;
6129 :
6130 : /* Reserve space for saving the actual size of the guc state */
6131 : Assert(maxsize > sizeof(actual_size));
6132 910 : curptr = start_address + sizeof(actual_size);
6133 910 : bytes_left = maxsize - sizeof(actual_size);
6134 :
6135 : /* We need only consider GUCs with source not PGC_S_DEFAULT */
6136 57700 : dlist_foreach(iter, &guc_nondef_list)
6137 : {
6138 56790 : struct config_generic *gconf = dlist_container(struct config_generic,
6139 : nondef_link, iter.cur);
6140 :
6141 56790 : serialize_variable(&curptr, &bytes_left, gconf);
6142 : }
6143 :
6144 : /* Store actual size without assuming alignment of start_address. */
6145 910 : actual_size = maxsize - bytes_left - sizeof(actual_size);
6146 910 : memcpy(start_address, &actual_size, sizeof(actual_size));
6147 910 : }
6148 :
6149 : /*
6150 : * read_gucstate:
6151 : * Actually it does not read anything, just returns the srcptr. But it does
6152 : * move the srcptr past the terminating zero byte, so that the caller is ready
6153 : * to read the next string.
6154 : */
6155 : static char *
6156 293238 : read_gucstate(char **srcptr, char *srcend)
6157 : {
6158 293238 : char *retptr = *srcptr;
6159 : char *ptr;
6160 :
6161 293238 : if (*srcptr >= srcend)
6162 0 : elog(ERROR, "incomplete GUC state");
6163 :
6164 : /* The string variables are all null terminated */
6165 7202276 : for (ptr = *srcptr; ptr < srcend && *ptr != '\0'; ptr++)
6166 : ;
6167 :
6168 293238 : if (ptr >= srcend)
6169 0 : elog(ERROR, "could not find null terminator in GUC state");
6170 :
6171 : /* Set the new position to the byte following the terminating NUL */
6172 293238 : *srcptr = ptr + 1;
6173 :
6174 293238 : return retptr;
6175 : }
6176 :
6177 : /* Binary read version of read_gucstate(). Copies into dest */
6178 : static void
6179 339606 : read_gucstate_binary(char **srcptr, char *srcend, void *dest, Size size)
6180 : {
6181 339606 : if (*srcptr + size > srcend)
6182 0 : elog(ERROR, "incomplete GUC state");
6183 :
6184 339606 : memcpy(dest, *srcptr, size);
6185 339606 : *srcptr += size;
6186 339606 : }
6187 :
6188 : /*
6189 : * Callback used to add a context message when reporting errors that occur
6190 : * while trying to restore GUCs in parallel workers.
6191 : */
6192 : static void
6193 0 : guc_restore_error_context_callback(void *arg)
6194 : {
6195 0 : char **error_context_name_and_value = (char **) arg;
6196 :
6197 0 : if (error_context_name_and_value)
6198 0 : errcontext("while setting parameter \"%s\" to \"%s\"",
6199 : error_context_name_and_value[0],
6200 0 : error_context_name_and_value[1]);
6201 0 : }
6202 :
6203 : /*
6204 : * RestoreGUCState:
6205 : * Reads the GUC state at the specified address and sets this process's
6206 : * GUCs to match.
6207 : *
6208 : * Note that this provides the worker with only a very shallow view of the
6209 : * leader's GUC state: we'll know about the currently active values, but not
6210 : * about stacked or reset values. That's fine since the worker is just
6211 : * executing one part of a query, within which the active values won't change
6212 : * and the stacked values are invisible.
6213 : */
6214 : void
6215 2734 : RestoreGUCState(void *gucstate)
6216 : {
6217 : char *varname,
6218 : *varvalue,
6219 : *varsourcefile;
6220 : int varsourceline;
6221 : GucSource varsource;
6222 : GucContext varscontext;
6223 : Oid varsrole;
6224 2734 : char *srcptr = (char *) gucstate;
6225 : char *srcend;
6226 : Size len;
6227 : dlist_mutable_iter iter;
6228 : ErrorContextCallback error_context_callback;
6229 :
6230 : /*
6231 : * First, ensure that all potentially-shippable GUCs are reset to their
6232 : * default values. We must not touch those GUCs that the leader will
6233 : * never ship, while there is no need to touch those that are shippable
6234 : * but already have their default values. Thus, this ends up being the
6235 : * same test that SerializeGUCState uses, even though the sets of
6236 : * variables involved may well be different since the leader's set of
6237 : * variables-not-at-default-values can differ from the set that are
6238 : * not-default in this freshly started worker.
6239 : *
6240 : * Once we have set all the potentially-shippable GUCs to default values,
6241 : * restoring the GUCs that the leader sent (because they had non-default
6242 : * values over there) leads us to exactly the set of GUC values that the
6243 : * leader has. This is true even though the worker may have initially
6244 : * absorbed postgresql.conf settings that the leader hasn't yet seen, or
6245 : * ALTER USER/DATABASE SET settings that were established after the leader
6246 : * started.
6247 : *
6248 : * Note that ensuring all the potential target GUCs are at PGC_S_DEFAULT
6249 : * also ensures that set_config_option won't refuse to set them because of
6250 : * source-priority comparisons.
6251 : */
6252 146434 : dlist_foreach_modify(iter, &guc_nondef_list)
6253 : {
6254 143700 : struct config_generic *gconf = dlist_container(struct config_generic,
6255 : nondef_link, iter.cur);
6256 :
6257 : /* Do nothing if non-shippable or if already at PGC_S_DEFAULT. */
6258 143700 : if (can_skip_gucvar(gconf))
6259 77258 : continue;
6260 :
6261 : /*
6262 : * We can use InitializeOneGUCOption to reset the GUC to default, but
6263 : * first we must free any existing subsidiary data to avoid leaking
6264 : * memory. The stack must be empty, but we have to clean up all other
6265 : * fields. Beware that there might be duplicate value or "extra"
6266 : * pointers. We also have to be sure to take it out of any lists it's
6267 : * in.
6268 : */
6269 : Assert(gconf->stack == NULL);
6270 66442 : guc_free(gconf->extra);
6271 66442 : guc_free(gconf->last_reported);
6272 66442 : guc_free(gconf->sourcefile);
6273 66442 : switch (gconf->vartype)
6274 : {
6275 14558 : case PGC_BOOL:
6276 : {
6277 14558 : struct config_bool *conf = (struct config_bool *) gconf;
6278 :
6279 14558 : if (conf->reset_extra && conf->reset_extra != gconf->extra)
6280 0 : guc_free(conf->reset_extra);
6281 14558 : break;
6282 : }
6283 12772 : case PGC_INT:
6284 : {
6285 12772 : struct config_int *conf = (struct config_int *) gconf;
6286 :
6287 12772 : if (conf->reset_extra && conf->reset_extra != gconf->extra)
6288 0 : guc_free(conf->reset_extra);
6289 12772 : break;
6290 : }
6291 0 : case PGC_REAL:
6292 : {
6293 0 : struct config_real *conf = (struct config_real *) gconf;
6294 :
6295 0 : if (conf->reset_extra && conf->reset_extra != gconf->extra)
6296 0 : guc_free(conf->reset_extra);
6297 0 : break;
6298 : }
6299 30970 : case PGC_STRING:
6300 : {
6301 30970 : struct config_string *conf = (struct config_string *) gconf;
6302 :
6303 30970 : guc_free(*conf->variable);
6304 30970 : if (conf->reset_val && conf->reset_val != *conf->variable)
6305 0 : guc_free(conf->reset_val);
6306 30970 : if (conf->reset_extra && conf->reset_extra != gconf->extra)
6307 0 : guc_free(conf->reset_extra);
6308 30970 : break;
6309 : }
6310 8142 : case PGC_ENUM:
6311 : {
6312 8142 : struct config_enum *conf = (struct config_enum *) gconf;
6313 :
6314 8142 : if (conf->reset_extra && conf->reset_extra != gconf->extra)
6315 0 : guc_free(conf->reset_extra);
6316 8142 : break;
6317 : }
6318 : }
6319 : /* Remove it from any lists it's in. */
6320 66442 : RemoveGUCFromLists(gconf);
6321 : /* Now we can reset the struct to PGS_S_DEFAULT state. */
6322 66442 : InitializeOneGUCOption(gconf);
6323 : }
6324 :
6325 : /* First item is the length of the subsequent data */
6326 2734 : memcpy(&len, gucstate, sizeof(len));
6327 :
6328 2734 : srcptr += sizeof(len);
6329 2734 : srcend = srcptr + len;
6330 :
6331 : /* If the GUC value check fails, we want errors to show useful context. */
6332 2734 : error_context_callback.callback = guc_restore_error_context_callback;
6333 2734 : error_context_callback.previous = error_context_stack;
6334 2734 : error_context_callback.arg = NULL;
6335 2734 : error_context_stack = &error_context_callback;
6336 :
6337 : /* Restore all the listed GUCs. */
6338 100480 : while (srcptr < srcend)
6339 : {
6340 : int result;
6341 : char *error_context_name_and_value[2];
6342 :
6343 97746 : varname = read_gucstate(&srcptr, srcend);
6344 97746 : varvalue = read_gucstate(&srcptr, srcend);
6345 97746 : varsourcefile = read_gucstate(&srcptr, srcend);
6346 97746 : if (varsourcefile[0])
6347 46368 : read_gucstate_binary(&srcptr, srcend,
6348 : &varsourceline, sizeof(varsourceline));
6349 : else
6350 51378 : varsourceline = 0;
6351 97746 : read_gucstate_binary(&srcptr, srcend,
6352 : &varsource, sizeof(varsource));
6353 97746 : read_gucstate_binary(&srcptr, srcend,
6354 : &varscontext, sizeof(varscontext));
6355 97746 : read_gucstate_binary(&srcptr, srcend,
6356 : &varsrole, sizeof(varsrole));
6357 :
6358 97746 : error_context_name_and_value[0] = varname;
6359 97746 : error_context_name_and_value[1] = varvalue;
6360 97746 : error_context_callback.arg = &error_context_name_and_value[0];
6361 97746 : result = set_config_option_ext(varname, varvalue,
6362 : varscontext, varsource, varsrole,
6363 : GUC_ACTION_SET, true, ERROR, true);
6364 97746 : if (result <= 0)
6365 0 : ereport(ERROR,
6366 : (errcode(ERRCODE_INTERNAL_ERROR),
6367 : errmsg("parameter \"%s\" could not be set", varname)));
6368 97746 : if (varsourcefile[0])
6369 46368 : set_config_sourcefile(varname, varsourcefile, varsourceline);
6370 97746 : error_context_callback.arg = NULL;
6371 : }
6372 :
6373 2734 : error_context_stack = error_context_callback.previous;
6374 2734 : }
6375 :
6376 : /*
6377 : * A little "long argument" simulation, although not quite GNU
6378 : * compliant. Takes a string of the form "some-option=some value" and
6379 : * returns name = "some_option" and value = "some value" in palloc'ed
6380 : * storage. Note that '-' is converted to '_' in the option name. If
6381 : * there is no '=' in the input string then value will be NULL.
6382 : */
6383 : void
6384 54994 : ParseLongOption(const char *string, char **name, char **value)
6385 : {
6386 : size_t equal_pos;
6387 : char *cp;
6388 :
6389 : Assert(string);
6390 : Assert(name);
6391 : Assert(value);
6392 :
6393 54994 : equal_pos = strcspn(string, "=");
6394 :
6395 54994 : if (string[equal_pos] == '=')
6396 : {
6397 54992 : *name = palloc(equal_pos + 1);
6398 54992 : strlcpy(*name, string, equal_pos + 1);
6399 :
6400 54992 : *value = pstrdup(&string[equal_pos + 1]);
6401 : }
6402 : else
6403 : {
6404 : /* no equal sign in string */
6405 2 : *name = pstrdup(string);
6406 2 : *value = NULL;
6407 : }
6408 :
6409 771932 : for (cp = *name; *cp; cp++)
6410 716938 : if (*cp == '-')
6411 1694 : *cp = '_';
6412 54994 : }
6413 :
6414 :
6415 : /*
6416 : * Transform array of GUC settings into lists of names and values. The lists
6417 : * are faster to process in cases where the settings must be applied
6418 : * repeatedly (e.g. for each function invocation).
6419 : */
6420 : void
6421 7020 : TransformGUCArray(ArrayType *array, List **names, List **values)
6422 : {
6423 : int i;
6424 :
6425 : Assert(array != NULL);
6426 : Assert(ARR_ELEMTYPE(array) == TEXTOID);
6427 : Assert(ARR_NDIM(array) == 1);
6428 : Assert(ARR_LBOUND(array)[0] == 1);
6429 :
6430 7020 : *names = NIL;
6431 7020 : *values = NIL;
6432 48050 : for (i = 1; i <= ARR_DIMS(array)[0]; i++)
6433 : {
6434 : Datum d;
6435 : bool isnull;
6436 : char *s;
6437 : char *name;
6438 : char *value;
6439 :
6440 41030 : d = array_ref(array, 1, &i,
6441 : -1 /* varlenarray */ ,
6442 : -1 /* TEXT's typlen */ ,
6443 : false /* TEXT's typbyval */ ,
6444 : TYPALIGN_INT /* TEXT's typalign */ ,
6445 : &isnull);
6446 :
6447 41030 : if (isnull)
6448 0 : continue;
6449 :
6450 41030 : s = TextDatumGetCString(d);
6451 :
6452 41030 : ParseLongOption(s, &name, &value);
6453 41030 : if (!value)
6454 : {
6455 0 : ereport(WARNING,
6456 : (errcode(ERRCODE_SYNTAX_ERROR),
6457 : errmsg("could not parse setting for parameter \"%s\"",
6458 : name)));
6459 0 : pfree(name);
6460 0 : continue;
6461 : }
6462 :
6463 41030 : *names = lappend(*names, name);
6464 41030 : *values = lappend(*values, value);
6465 :
6466 41030 : pfree(s);
6467 : }
6468 7020 : }
6469 :
6470 :
6471 : /*
6472 : * Handle options fetched from pg_db_role_setting.setconfig,
6473 : * pg_proc.proconfig, etc. Caller must specify proper context/source/action.
6474 : *
6475 : * The array parameter must be an array of TEXT (it must not be NULL).
6476 : */
6477 : void
6478 6888 : ProcessGUCArray(ArrayType *array,
6479 : GucContext context, GucSource source, GucAction action)
6480 : {
6481 : List *gucNames;
6482 : List *gucValues;
6483 : ListCell *lc1;
6484 : ListCell *lc2;
6485 :
6486 6888 : TransformGUCArray(array, &gucNames, &gucValues);
6487 47774 : forboth(lc1, gucNames, lc2, gucValues)
6488 : {
6489 40898 : char *name = lfirst(lc1);
6490 40898 : char *value = lfirst(lc2);
6491 :
6492 40898 : (void) set_config_option(name, value,
6493 : context, source,
6494 : action, true, 0, false);
6495 :
6496 40886 : pfree(name);
6497 40886 : pfree(value);
6498 : }
6499 :
6500 6876 : list_free(gucNames);
6501 6876 : list_free(gucValues);
6502 6876 : }
6503 :
6504 :
6505 : /*
6506 : * Add an entry to an option array. The array parameter may be NULL
6507 : * to indicate the current table entry is NULL.
6508 : */
6509 : ArrayType *
6510 1408 : GUCArrayAdd(ArrayType *array, const char *name, const char *value)
6511 : {
6512 : struct config_generic *record;
6513 : Datum datum;
6514 : char *newval;
6515 : ArrayType *a;
6516 :
6517 : Assert(name);
6518 : Assert(value);
6519 :
6520 : /* test if the option is valid and we're allowed to set it */
6521 1408 : (void) validate_option_array_item(name, value, false);
6522 :
6523 : /* normalize name (converts obsolete GUC names to modern spellings) */
6524 1404 : record = find_option(name, false, true, WARNING);
6525 1404 : if (record)
6526 1404 : name = record->name;
6527 :
6528 : /* build new item for array */
6529 1404 : newval = psprintf("%s=%s", name, value);
6530 1404 : datum = CStringGetTextDatum(newval);
6531 :
6532 1404 : if (array)
6533 : {
6534 : int index;
6535 : bool isnull;
6536 : int i;
6537 :
6538 : Assert(ARR_ELEMTYPE(array) == TEXTOID);
6539 : Assert(ARR_NDIM(array) == 1);
6540 : Assert(ARR_LBOUND(array)[0] == 1);
6541 :
6542 1066 : index = ARR_DIMS(array)[0] + 1; /* add after end */
6543 :
6544 4216 : for (i = 1; i <= ARR_DIMS(array)[0]; i++)
6545 : {
6546 : Datum d;
6547 : char *current;
6548 :
6549 3164 : d = array_ref(array, 1, &i,
6550 : -1 /* varlenarray */ ,
6551 : -1 /* TEXT's typlen */ ,
6552 : false /* TEXT's typbyval */ ,
6553 : TYPALIGN_INT /* TEXT's typalign */ ,
6554 : &isnull);
6555 3164 : if (isnull)
6556 0 : continue;
6557 3164 : current = TextDatumGetCString(d);
6558 :
6559 : /* check for match up through and including '=' */
6560 3164 : if (strncmp(current, newval, strlen(name) + 1) == 0)
6561 : {
6562 14 : index = i;
6563 14 : break;
6564 : }
6565 : }
6566 :
6567 1066 : a = array_set(array, 1, &index,
6568 : datum,
6569 : false,
6570 : -1 /* varlena array */ ,
6571 : -1 /* TEXT's typlen */ ,
6572 : false /* TEXT's typbyval */ ,
6573 : TYPALIGN_INT /* TEXT's typalign */ );
6574 : }
6575 : else
6576 338 : a = construct_array_builtin(&datum, 1, TEXTOID);
6577 :
6578 1404 : return a;
6579 : }
6580 :
6581 :
6582 : /*
6583 : * Delete an entry from an option array. The array parameter may be NULL
6584 : * to indicate the current table entry is NULL. Also, if the return value
6585 : * is NULL then a null should be stored.
6586 : */
6587 : ArrayType *
6588 40 : GUCArrayDelete(ArrayType *array, const char *name)
6589 : {
6590 : struct config_generic *record;
6591 : ArrayType *newarray;
6592 : int i;
6593 : int index;
6594 :
6595 : Assert(name);
6596 :
6597 : /* test if the option is valid and we're allowed to set it */
6598 40 : (void) validate_option_array_item(name, NULL, false);
6599 :
6600 : /* normalize name (converts obsolete GUC names to modern spellings) */
6601 36 : record = find_option(name, false, true, WARNING);
6602 36 : if (record)
6603 30 : name = record->name;
6604 :
6605 : /* if array is currently null, then surely nothing to delete */
6606 36 : if (!array)
6607 4 : return NULL;
6608 :
6609 32 : newarray = NULL;
6610 32 : index = 1;
6611 :
6612 102 : for (i = 1; i <= ARR_DIMS(array)[0]; i++)
6613 : {
6614 : Datum d;
6615 : char *val;
6616 : bool isnull;
6617 :
6618 70 : d = array_ref(array, 1, &i,
6619 : -1 /* varlenarray */ ,
6620 : -1 /* TEXT's typlen */ ,
6621 : false /* TEXT's typbyval */ ,
6622 : TYPALIGN_INT /* TEXT's typalign */ ,
6623 : &isnull);
6624 70 : if (isnull)
6625 32 : continue;
6626 70 : val = TextDatumGetCString(d);
6627 :
6628 : /* ignore entry if it's what we want to delete */
6629 70 : if (strncmp(val, name, strlen(name)) == 0
6630 32 : && val[strlen(name)] == '=')
6631 32 : continue;
6632 :
6633 : /* else add it to the output array */
6634 38 : if (newarray)
6635 30 : newarray = array_set(newarray, 1, &index,
6636 : d,
6637 : false,
6638 : -1 /* varlenarray */ ,
6639 : -1 /* TEXT's typlen */ ,
6640 : false /* TEXT's typbyval */ ,
6641 : TYPALIGN_INT /* TEXT's typalign */ );
6642 : else
6643 8 : newarray = construct_array_builtin(&d, 1, TEXTOID);
6644 :
6645 38 : index++;
6646 : }
6647 :
6648 32 : return newarray;
6649 : }
6650 :
6651 :
6652 : /*
6653 : * Given a GUC array, delete all settings from it that our permission
6654 : * level allows: if superuser, delete them all; if regular user, only
6655 : * those that are PGC_USERSET or we have permission to set
6656 : */
6657 : ArrayType *
6658 2 : GUCArrayReset(ArrayType *array)
6659 : {
6660 : ArrayType *newarray;
6661 : int i;
6662 : int index;
6663 :
6664 : /* if array is currently null, nothing to do */
6665 2 : if (!array)
6666 0 : return NULL;
6667 :
6668 : /* if we're superuser, we can delete everything, so just do it */
6669 2 : if (superuser())
6670 0 : return NULL;
6671 :
6672 2 : newarray = NULL;
6673 2 : index = 1;
6674 :
6675 6 : for (i = 1; i <= ARR_DIMS(array)[0]; i++)
6676 : {
6677 : Datum d;
6678 : char *val;
6679 : char *eqsgn;
6680 : bool isnull;
6681 :
6682 4 : d = array_ref(array, 1, &i,
6683 : -1 /* varlenarray */ ,
6684 : -1 /* TEXT's typlen */ ,
6685 : false /* TEXT's typbyval */ ,
6686 : TYPALIGN_INT /* TEXT's typalign */ ,
6687 : &isnull);
6688 4 : if (isnull)
6689 2 : continue;
6690 4 : val = TextDatumGetCString(d);
6691 :
6692 4 : eqsgn = strchr(val, '=');
6693 4 : *eqsgn = '\0';
6694 :
6695 : /* skip if we have permission to delete it */
6696 4 : if (validate_option_array_item(val, NULL, true))
6697 2 : continue;
6698 :
6699 : /* else add it to the output array */
6700 2 : if (newarray)
6701 0 : newarray = array_set(newarray, 1, &index,
6702 : d,
6703 : false,
6704 : -1 /* varlenarray */ ,
6705 : -1 /* TEXT's typlen */ ,
6706 : false /* TEXT's typbyval */ ,
6707 : TYPALIGN_INT /* TEXT's typalign */ );
6708 : else
6709 2 : newarray = construct_array_builtin(&d, 1, TEXTOID);
6710 :
6711 2 : index++;
6712 2 : pfree(val);
6713 : }
6714 :
6715 2 : return newarray;
6716 : }
6717 :
6718 : /*
6719 : * Validate a proposed option setting for GUCArrayAdd/Delete/Reset.
6720 : *
6721 : * name is the option name. value is the proposed value for the Add case,
6722 : * or NULL for the Delete/Reset cases. If skipIfNoPermissions is true, it's
6723 : * not an error to have no permissions to set the option.
6724 : *
6725 : * Returns true if OK, false if skipIfNoPermissions is true and user does not
6726 : * have permission to change this option (all other error cases result in an
6727 : * error being thrown).
6728 : */
6729 : static bool
6730 1452 : validate_option_array_item(const char *name, const char *value,
6731 : bool skipIfNoPermissions)
6732 :
6733 : {
6734 : struct config_generic *gconf;
6735 : bool reset_custom;
6736 :
6737 : /*
6738 : * There are three cases to consider:
6739 : *
6740 : * name is a known GUC variable. Check the value normally, check
6741 : * permissions normally (i.e., allow if variable is USERSET, or if it's
6742 : * SUSET and user is superuser or holds ACL_SET permissions).
6743 : *
6744 : * name is not known, but exists or can be created as a placeholder (i.e.,
6745 : * it has a valid custom name). We allow this case if you're a superuser,
6746 : * otherwise not. Superusers are assumed to know what they're doing. We
6747 : * can't allow it for other users, because when the placeholder is
6748 : * resolved it might turn out to be a SUSET variable. (With currently
6749 : * available infrastructure, we can actually handle such cases within the
6750 : * current session --- but once an entry is made in pg_db_role_setting,
6751 : * it's assumed to be fully validated.)
6752 : *
6753 : * name is not known and can't be created as a placeholder. Throw error,
6754 : * unless skipIfNoPermissions or reset_custom is true. If reset_custom is
6755 : * true, this is a RESET or RESET ALL operation for an unknown custom GUC
6756 : * with a reserved prefix, in which case we want to fall through to the
6757 : * placeholder case described in the preceding paragraph (else there'd be
6758 : * no way for users to remove them). Otherwise, return false.
6759 : */
6760 1452 : reset_custom = (!value && valid_custom_variable_name(name));
6761 1452 : gconf = find_option(name, true, skipIfNoPermissions || reset_custom, ERROR);
6762 1446 : if (!gconf && !reset_custom)
6763 : {
6764 : /* not known, failed to make a placeholder */
6765 0 : return false;
6766 : }
6767 :
6768 1446 : if (!gconf || gconf->flags & GUC_CUSTOM_PLACEHOLDER)
6769 : {
6770 : /*
6771 : * We cannot do any meaningful check on the value, so only permissions
6772 : * are useful to check.
6773 : */
6774 12 : if (superuser() ||
6775 0 : pg_parameter_aclcheck(name, GetUserId(), ACL_SET) == ACLCHECK_OK)
6776 12 : return true;
6777 0 : if (skipIfNoPermissions)
6778 0 : return false;
6779 0 : ereport(ERROR,
6780 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
6781 : errmsg("permission denied to set parameter \"%s\"", name)));
6782 : }
6783 :
6784 : /* manual permissions check so we can avoid an error being thrown */
6785 1434 : if (gconf->context == PGC_USERSET)
6786 : /* ok */ ;
6787 432 : else if (gconf->context == PGC_SUSET &&
6788 228 : (superuser() ||
6789 12 : pg_parameter_aclcheck(name, GetUserId(), ACL_SET) == ACLCHECK_OK))
6790 : /* ok */ ;
6791 4 : else if (skipIfNoPermissions)
6792 2 : return false;
6793 : /* if a permissions error should be thrown, let set_config_option do it */
6794 :
6795 : /* test for permissions and valid option value */
6796 1432 : (void) set_config_option(name, value,
6797 1432 : superuser() ? PGC_SUSET : PGC_USERSET,
6798 : PGC_S_TEST, GUC_ACTION_SET, false, 0, false);
6799 :
6800 1430 : return true;
6801 : }
6802 :
6803 :
6804 : /*
6805 : * Called by check_hooks that want to override the normal
6806 : * ERRCODE_INVALID_PARAMETER_VALUE SQLSTATE for check hook failures.
6807 : *
6808 : * Note that GUC_check_errmsg() etc are just macros that result in a direct
6809 : * assignment to the associated variables. That is ugly, but forced by the
6810 : * limitations of C's macro mechanisms.
6811 : */
6812 : void
6813 38 : GUC_check_errcode(int sqlerrcode)
6814 : {
6815 38 : GUC_check_errcode_value = sqlerrcode;
6816 38 : }
6817 :
6818 :
6819 : /*
6820 : * Convenience functions to manage calling a variable's check_hook.
6821 : * These mostly take care of the protocol for letting check hooks supply
6822 : * portions of the error report on failure.
6823 : */
6824 :
6825 : static bool
6826 447694 : call_bool_check_hook(struct config_bool *conf, bool *newval, void **extra,
6827 : GucSource source, int elevel)
6828 : {
6829 : /* Quick success if no hook */
6830 447694 : if (!conf->check_hook)
6831 410286 : return true;
6832 :
6833 : /* Reset variables that might be set by hook */
6834 37408 : GUC_check_errcode_value = ERRCODE_INVALID_PARAMETER_VALUE;
6835 37408 : GUC_check_errmsg_string = NULL;
6836 37408 : GUC_check_errdetail_string = NULL;
6837 37408 : GUC_check_errhint_string = NULL;
6838 :
6839 37408 : if (!conf->check_hook(newval, extra, source))
6840 : {
6841 24 : ereport(elevel,
6842 : (errcode(GUC_check_errcode_value),
6843 : GUC_check_errmsg_string ?
6844 : errmsg_internal("%s", GUC_check_errmsg_string) :
6845 : errmsg("invalid value for parameter \"%s\": %d",
6846 : conf->gen.name, (int) *newval),
6847 : GUC_check_errdetail_string ?
6848 : errdetail_internal("%s", GUC_check_errdetail_string) : 0,
6849 : GUC_check_errhint_string ?
6850 : errhint("%s", GUC_check_errhint_string) : 0));
6851 : /* Flush any strings created in ErrorContext */
6852 0 : FlushErrorState();
6853 0 : return false;
6854 : }
6855 :
6856 37384 : return true;
6857 : }
6858 :
6859 : static bool
6860 457922 : call_int_check_hook(struct config_int *conf, int *newval, void **extra,
6861 : GucSource source, int elevel)
6862 : {
6863 : /* Quick success if no hook */
6864 457922 : if (!conf->check_hook)
6865 399668 : return true;
6866 :
6867 : /* Reset variables that might be set by hook */
6868 58254 : GUC_check_errcode_value = ERRCODE_INVALID_PARAMETER_VALUE;
6869 58254 : GUC_check_errmsg_string = NULL;
6870 58254 : GUC_check_errdetail_string = NULL;
6871 58254 : GUC_check_errhint_string = NULL;
6872 :
6873 58254 : if (!conf->check_hook(newval, extra, source))
6874 : {
6875 0 : ereport(elevel,
6876 : (errcode(GUC_check_errcode_value),
6877 : GUC_check_errmsg_string ?
6878 : errmsg_internal("%s", GUC_check_errmsg_string) :
6879 : errmsg("invalid value for parameter \"%s\": %d",
6880 : conf->gen.name, *newval),
6881 : GUC_check_errdetail_string ?
6882 : errdetail_internal("%s", GUC_check_errdetail_string) : 0,
6883 : GUC_check_errhint_string ?
6884 : errhint("%s", GUC_check_errhint_string) : 0));
6885 : /* Flush any strings created in ErrorContext */
6886 0 : FlushErrorState();
6887 0 : return false;
6888 : }
6889 :
6890 58254 : return true;
6891 : }
6892 :
6893 : static bool
6894 66880 : call_real_check_hook(struct config_real *conf, double *newval, void **extra,
6895 : GucSource source, int elevel)
6896 : {
6897 : /* Quick success if no hook */
6898 66880 : if (!conf->check_hook)
6899 64624 : return true;
6900 :
6901 : /* Reset variables that might be set by hook */
6902 2256 : GUC_check_errcode_value = ERRCODE_INVALID_PARAMETER_VALUE;
6903 2256 : GUC_check_errmsg_string = NULL;
6904 2256 : GUC_check_errdetail_string = NULL;
6905 2256 : GUC_check_errhint_string = NULL;
6906 :
6907 2256 : if (!conf->check_hook(newval, extra, source))
6908 : {
6909 0 : ereport(elevel,
6910 : (errcode(GUC_check_errcode_value),
6911 : GUC_check_errmsg_string ?
6912 : errmsg_internal("%s", GUC_check_errmsg_string) :
6913 : errmsg("invalid value for parameter \"%s\": %g",
6914 : conf->gen.name, *newval),
6915 : GUC_check_errdetail_string ?
6916 : errdetail_internal("%s", GUC_check_errdetail_string) : 0,
6917 : GUC_check_errhint_string ?
6918 : errhint("%s", GUC_check_errhint_string) : 0));
6919 : /* Flush any strings created in ErrorContext */
6920 0 : FlushErrorState();
6921 0 : return false;
6922 : }
6923 :
6924 2256 : return true;
6925 : }
6926 :
6927 : static bool
6928 935240 : call_string_check_hook(struct config_string *conf, char **newval, void **extra,
6929 : GucSource source, int elevel)
6930 : {
6931 935240 : volatile bool result = true;
6932 :
6933 : /* Quick success if no hook */
6934 935240 : if (!conf->check_hook)
6935 147886 : return true;
6936 :
6937 : /*
6938 : * If elevel is ERROR, or if the check_hook itself throws an elog
6939 : * (undesirable, but not always avoidable), make sure we don't leak the
6940 : * already-malloc'd newval string.
6941 : */
6942 787354 : PG_TRY();
6943 : {
6944 : /* Reset variables that might be set by hook */
6945 787354 : GUC_check_errcode_value = ERRCODE_INVALID_PARAMETER_VALUE;
6946 787354 : GUC_check_errmsg_string = NULL;
6947 787354 : GUC_check_errdetail_string = NULL;
6948 787354 : GUC_check_errhint_string = NULL;
6949 :
6950 787354 : if (!conf->check_hook(newval, extra, source))
6951 : {
6952 42 : ereport(elevel,
6953 : (errcode(GUC_check_errcode_value),
6954 : GUC_check_errmsg_string ?
6955 : errmsg_internal("%s", GUC_check_errmsg_string) :
6956 : errmsg("invalid value for parameter \"%s\": \"%s\"",
6957 : conf->gen.name, *newval ? *newval : ""),
6958 : GUC_check_errdetail_string ?
6959 : errdetail_internal("%s", GUC_check_errdetail_string) : 0,
6960 : GUC_check_errhint_string ?
6961 : errhint("%s", GUC_check_errhint_string) : 0));
6962 : /* Flush any strings created in ErrorContext */
6963 6 : FlushErrorState();
6964 6 : result = false;
6965 : }
6966 : }
6967 42 : PG_CATCH();
6968 : {
6969 42 : guc_free(*newval);
6970 42 : PG_RE_THROW();
6971 : }
6972 787312 : PG_END_TRY();
6973 :
6974 787312 : return result;
6975 : }
6976 :
6977 : static bool
6978 178242 : call_enum_check_hook(struct config_enum *conf, int *newval, void **extra,
6979 : GucSource source, int elevel)
6980 : {
6981 : /* Quick success if no hook */
6982 178242 : if (!conf->check_hook)
6983 159076 : return true;
6984 :
6985 : /* Reset variables that might be set by hook */
6986 19166 : GUC_check_errcode_value = ERRCODE_INVALID_PARAMETER_VALUE;
6987 19166 : GUC_check_errmsg_string = NULL;
6988 19166 : GUC_check_errdetail_string = NULL;
6989 19166 : GUC_check_errhint_string = NULL;
6990 :
6991 19166 : if (!conf->check_hook(newval, extra, source))
6992 : {
6993 2 : ereport(elevel,
6994 : (errcode(GUC_check_errcode_value),
6995 : GUC_check_errmsg_string ?
6996 : errmsg_internal("%s", GUC_check_errmsg_string) :
6997 : errmsg("invalid value for parameter \"%s\": \"%s\"",
6998 : conf->gen.name,
6999 : config_enum_lookup_by_value(conf, *newval)),
7000 : GUC_check_errdetail_string ?
7001 : errdetail_internal("%s", GUC_check_errdetail_string) : 0,
7002 : GUC_check_errhint_string ?
7003 : errhint("%s", GUC_check_errhint_string) : 0));
7004 : /* Flush any strings created in ErrorContext */
7005 0 : FlushErrorState();
7006 0 : return false;
7007 : }
7008 :
7009 19164 : return true;
7010 : }
|
