guc.c 170.0 KB
Newer Older
1 2 3 4 5
/*--------------------------------------------------------------------
 * guc.c
 *
 * Support for grand unified configuration scheme, including SET
 * command, configuration file, and command line options.
6
 * See src/backend/utils/misc/README for more information.
7 8
 *
 *
9
 * Copyright (c) 2000-2007, PostgreSQL Global Development Group
10
 * Written by Peter Eisentraut <peter_e@gmx.net>.
11 12
 *
 * IDENTIFICATION
13
 *	  $PostgreSQL: pgsql/src/backend/utils/misc/guc.c,v 1.404 2007/06/30 19:12:02 tgl Exp $
14
 *
15 16 17 18
 *--------------------------------------------------------------------
 */
#include "postgres.h"

19
#include <ctype.h>
20 21 22
#include <float.h>
#include <limits.h>
#include <unistd.h>
23
#include <sys/stat.h>
24 25 26
#ifdef HAVE_SYSLOG
#include <syslog.h>
#endif
27 28


29
#include "access/gin.h"
30
#include "access/transam.h"
31
#include "access/twophase.h"
32
#include "access/xact.h"
33
#include "catalog/namespace.h"
34
#include "commands/async.h"
35
#include "commands/prepare.h"
36
#include "commands/vacuum.h"
37
#include "commands/variable.h"
38
#include "commands/trigger.h"
39
#include "funcapi.h"
40
#include "libpq/auth.h"
41
#include "libpq/pqformat.h"
42 43 44 45
#include "miscadmin.h"
#include "optimizer/cost.h"
#include "optimizer/geqo.h"
#include "optimizer/paths.h"
46
#include "optimizer/planmain.h"
47
#include "parser/gramparse.h"
48
#include "parser/parse_expr.h"
49
#include "parser/parse_relation.h"
50
#include "parser/parse_type.h"
51
#include "parser/scansup.h"
52
#include "pgstat.h"
53
#include "postmaster/autovacuum.h"
54 55
#include "postmaster/bgwriter.h"
#include "postmaster/postmaster.h"
56
#include "postmaster/syslogger.h"
57
#include "storage/fd.h"
58
#include "storage/freespace.h"
59
#include "tcop/tcopprot.h"
60
#include "utils/builtins.h"
61
#include "utils/guc_tables.h"
62
#include "utils/memutils.h"
63
#include "utils/pg_locale.h"
64
#include "utils/plancache.h"
65
#include "utils/portal.h"
66
#include "utils/ps_status.h"
67
#include "utils/tzparser.h"
68
#include "utils/xml.h"
69

70 71 72
#ifndef PG_KRB_SRVTAB
#define PG_KRB_SRVTAB ""
#endif
B
 
Bruce Momjian 已提交
73 74 75
#ifndef PG_KRB_SRVNAM
#define PG_KRB_SRVNAM ""
#endif
76

B
Bruce Momjian 已提交
77
#define CONFIG_FILENAME "postgresql.conf"
78 79
#define HBA_FILENAME	"pg_hba.conf"
#define IDENT_FILENAME	"pg_ident.conf"
80

B
Bruce Momjian 已提交
81 82
#ifdef EXEC_BACKEND
#define CONFIG_EXEC_PARAMS "global/config_exec_params"
83
#define CONFIG_EXEC_PARAMS_NEW "global/config_exec_params.new"
B
Bruce Momjian 已提交
84
#endif
85

86 87 88 89 90 91 92
/* upper limit for GUC variables measured in kilobytes of memory */
#if SIZEOF_SIZE_T > 4
#define MAX_KILOBYTES	INT_MAX
#else
#define MAX_KILOBYTES	(INT_MAX / 1024)
#endif

93 94 95 96
#define KB_PER_MB (1024)
#define KB_PER_GB (1024*1024)

#define MS_PER_S 1000
97
#define S_PER_MIN 60
98
#define MS_PER_MIN (1000 * 60)
99 100
#define MIN_PER_H 60
#define S_PER_H (60 * 60)
101
#define MS_PER_H (1000 * 60 * 60)
102 103
#define MIN_PER_D (60 * 24)
#define S_PER_D (60 * 60 * 24)
104 105
#define MS_PER_D (1000 * 60 * 60 * 24)

106
/* XXX these should appear in other modules' header files */
107
extern bool Log_disconnections;
B
Bruce Momjian 已提交
108 109
extern int	CommitDelay;
extern int	CommitSiblings;
110
extern char *default_tablespace;
111
extern char *temp_tablespaces;
B
Bruce Momjian 已提交
112 113
extern bool fullPageWrites;

114
#ifdef TRACE_SORT
B
Bruce Momjian 已提交
115
extern bool trace_sort;
116
#endif
117 118 119
#ifdef TRACE_SYNCSCAN
extern bool trace_syncscan;
#endif
120 121 122
#ifdef DEBUG_BOUNDED_SORT
extern bool optimize_bounded_sort;
#endif
123

T
Tom Lane 已提交
124 125 126 127 128
#ifdef USE_SSL
extern char *SSLCipherSuites;
#endif


129
static const char *assign_log_destination(const char *value,
B
Bruce Momjian 已提交
130
					   bool doit, GucSource source);
131

T
Tatsuo Ishii 已提交
132
#ifdef HAVE_SYSLOG
133
static int	syslog_facility = LOG_LOCAL0;
134

135
static const char *assign_syslog_facility(const char *facility,
B
Bruce Momjian 已提交
136
					   bool doit, GucSource source);
137
static const char *assign_syslog_ident(const char *ident,
B
Bruce Momjian 已提交
138
					bool doit, GucSource source);
139
#endif
140

141 142
static const char *assign_defaultxactisolevel(const char *newval, bool doit,
						   GucSource source);
143 144
static const char *assign_session_replication_role(const char *newval, bool doit,
						   GucSource source);
145
static const char *assign_log_min_messages(const char *newval, bool doit,
B
Bruce Momjian 已提交
146
						GucSource source);
147
static const char *assign_client_min_messages(const char *newval,
148
						   bool doit, GucSource source);
149
static const char *assign_min_error_statement(const char *newval, bool doit,
150
						   GucSource source);
151
static const char *assign_msglvl(int *var, const char *newval, bool doit,
B
Bruce Momjian 已提交
152
			  GucSource source);
153
static const char *assign_log_error_verbosity(const char *newval, bool doit,
154
						   GucSource source);
155
static const char *assign_log_statement(const char *newval, bool doit,
B
Bruce Momjian 已提交
156
					 GucSource source);
157
static const char *show_num_temp_buffers(void);
158
static bool assign_phony_autocommit(bool newval, bool doit, GucSource source);
159
static const char *assign_custom_variable_classes(const char *newval, bool doit,
B
Bruce Momjian 已提交
160
							   GucSource source);
161
static bool assign_debug_assertions(bool newval, bool doit, GucSource source);
162
static bool assign_ssl(bool newval, bool doit, GucSource source);
163 164
static bool assign_stage_log_stats(bool newval, bool doit, GucSource source);
static bool assign_log_stats(bool newval, bool doit, GucSource source);
165
static bool assign_transaction_read_only(bool newval, bool doit, GucSource source);
166
static const char *assign_canonical_path(const char *newval, bool doit, GucSource source);
167
static const char *assign_backslash_quote(const char *newval, bool doit, GucSource source);
168
static const char *assign_timezone_abbreviations(const char *newval, bool doit, GucSource source);
169
static const char *assign_xmlbinary(const char *newval, bool doit, GucSource source);
170
static const char *assign_xmloption(const char *newval, bool doit, GucSource source);
171

172 173 174 175 176 177
static bool assign_tcp_keepalives_idle(int newval, bool doit, GucSource source);
static bool assign_tcp_keepalives_interval(int newval, bool doit, GucSource source);
static bool assign_tcp_keepalives_count(int newval, bool doit, GucSource source);
static const char *show_tcp_keepalives_idle(void);
static const char *show_tcp_keepalives_interval(void);
static const char *show_tcp_keepalives_count(void);
178 179
static bool assign_autovacuum_max_workers(int newval, bool doit, GucSource source);
static bool assign_maxconnections(int newval, bool doit, GucSource source);
180

181 182
/*
 * GUC option variables that are exported from this module
183
 */
184
#ifdef USE_ASSERT_CHECKING
B
Bruce Momjian 已提交
185
bool		assert_enabled = true;
186 187 188
#else
bool		assert_enabled = false;
#endif
B
Rename:  
Bruce Momjian 已提交
189
bool		log_duration = false;
B
Bruce Momjian 已提交
190 191 192 193
bool		Debug_print_plan = false;
bool		Debug_print_parse = false;
bool		Debug_print_rewritten = false;
bool		Debug_pretty_print = false;
194
bool		Explain_pretty_print = true;
195

B
Rename:  
Bruce Momjian 已提交
196 197 198
bool		log_parser_stats = false;
bool		log_planner_stats = false;
bool		log_executor_stats = false;
B
Bruce Momjian 已提交
199 200
bool		log_statement_stats = false;		/* this is sort of all three
												 * above together */
201
bool		log_btree_build_stats = false;
202

203 204
bool		check_function_bodies = true;
bool		default_with_oids = false;
B
Bruce Momjian 已提交
205
bool		SQL_inheritance = true;
206

207
bool		Password_encryption = true;
208

209
int			log_min_error_statement = ERROR;
210
int			log_min_messages = NOTICE;
211
int			client_min_messages = NOTICE;
212
int			log_min_duration_statement = -1;
213
int			log_temp_files = -1;
214

215 216
int			num_temp_buffers = 1000;

217 218 219 220
char	   *ConfigFileName;
char	   *HbaFileName;
char	   *IdentFileName;
char	   *external_pid_file;
221

B
Bruce Momjian 已提交
222 223 224
int			tcp_keepalives_idle;
int			tcp_keepalives_interval;
int			tcp_keepalives_count;
225

226 227 228 229 230
/*
 * These variables are all dummies that don't do anything, except in some
 * cases provide the value for SHOW to display.  The real state is elsewhere
 * and is kept in sync by assign_hooks.
 */
231
static char *client_min_messages_str;
232 233
static char *log_min_messages_str;
static char *log_error_verbosity_str;
234
static char *log_statement_str;
235
static char *log_min_error_statement_str;
236
static char *log_destination_string;
B
Bruce Momjian 已提交
237

238
#ifdef HAVE_SYSLOG
239 240
static char *syslog_facility_str;
static char *syslog_ident_str;
241
#endif
242
static bool phony_autocommit;
243
static bool session_auth_is_superuser;
244
static double phony_random_seed;
245
static char *backslash_quote_string;
246 247 248
static char *client_encoding_string;
static char *datestyle_string;
static char *default_iso_level_string;
249
static char *session_replication_role_string;
250 251
static char *locale_collate;
static char *locale_ctype;
252
static char *regex_flavor_string;
253
static char *server_encoding_string;
254
static char *server_version_string;
B
Bruce Momjian 已提交
255
static int	server_version_num;
256
static char *timezone_string;
257
static char *timezone_abbreviations_string;
258
static char *XactIsoLevel_string;
259
static char *data_directory;
260
static char *custom_variable_classes;
261
static char *xmlbinary_string;
262
static char *xmloption_string;
263 264 265 266
static int	max_function_args;
static int	max_index_keys;
static int	max_identifier_length;
static int	block_size;
B
Bruce Momjian 已提交
267
static bool integer_datetimes;
B
Bruce Momjian 已提交
268

269 270
/* should be static, but commands/variable.c needs to get at these */
char	   *role_string;
B
Bruce Momjian 已提交
271
char	   *session_authorization_string;
272

273

274
/*
275 276 277
 * Displayable names for context types (enum GucContext)
 *
 * Note: these strings are deliberately not localized.
278
 */
B
Bruce Momjian 已提交
279
const char *const GucContext_Names[] =
280
{
B
Bruce Momjian 已提交
281 282 283 284 285 286
	 /* PGC_INTERNAL */ "internal",
	 /* PGC_POSTMASTER */ "postmaster",
	 /* PGC_SIGHUP */ "sighup",
	 /* PGC_BACKEND */ "backend",
	 /* PGC_SUSET */ "superuser",
	 /* PGC_USERSET */ "user"
287 288 289 290 291 292
};

/*
 * Displayable names for source types (enum GucSource)
 *
 * Note: these strings are deliberately not localized.
B
Bruce Momjian 已提交
293 294
 */
const char *const GucSource_Names[] =
295
{
B
Bruce Momjian 已提交
296 297 298 299 300 301 302 303 304 305 306
	 /* PGC_S_DEFAULT */ "default",
	 /* PGC_S_ENV_VAR */ "environment variable",
	 /* PGC_S_FILE */ "configuration file",
	 /* PGC_S_ARGV */ "command line",
	 /* PGC_S_DATABASE */ "database",
	 /* PGC_S_USER */ "user",
	 /* PGC_S_CLIENT */ "client",
	 /* PGC_S_OVERRIDE */ "override",
	 /* PGC_S_INTERACTIVE */ "interactive",
	 /* PGC_S_TEST */ "test",
	 /* PGC_S_SESSION */ "session"
307 308 309 310 311 312 313 314
};

/*
 * Displayable names for the groupings defined in enum config_group
 */
const char *const config_group_names[] =
{
	/* UNGROUPED */
315
	gettext_noop("Ungrouped"),
316 317
	/* FILE_LOCATIONS */
	gettext_noop("File Locations"),
318
	/* CONN_AUTH */
319
	gettext_noop("Connections and Authentication"),
320
	/* CONN_AUTH_SETTINGS */
321
	gettext_noop("Connections and Authentication / Connection Settings"),
322
	/* CONN_AUTH_SECURITY */
323
	gettext_noop("Connections and Authentication / Security and Authentication"),
324
	/* RESOURCES */
325
	gettext_noop("Resource Usage"),
326
	/* RESOURCES_MEM */
327
	gettext_noop("Resource Usage / Memory"),
328
	/* RESOURCES_FSM */
329
	gettext_noop("Resource Usage / Free Space Map"),
330
	/* RESOURCES_KERNEL */
331
	gettext_noop("Resource Usage / Kernel Resources"),
332
	/* WAL */
333
	gettext_noop("Write-Ahead Log"),
334
	/* WAL_SETTINGS */
335
	gettext_noop("Write-Ahead Log / Settings"),
336
	/* WAL_CHECKPOINTS */
337
	gettext_noop("Write-Ahead Log / Checkpoints"),
338
	/* QUERY_TUNING */
339
	gettext_noop("Query Tuning"),
340
	/* QUERY_TUNING_METHOD */
341
	gettext_noop("Query Tuning / Planner Method Configuration"),
342
	/* QUERY_TUNING_COST */
343
	gettext_noop("Query Tuning / Planner Cost Constants"),
344
	/* QUERY_TUNING_GEQO */
345
	gettext_noop("Query Tuning / Genetic Query Optimizer"),
346
	/* QUERY_TUNING_OTHER */
347
	gettext_noop("Query Tuning / Other Planner Options"),
348
	/* LOGGING */
349
	gettext_noop("Reporting and Logging"),
350 351
	/* LOGGING_WHERE */
	gettext_noop("Reporting and Logging / Where to Log"),
352
	/* LOGGING_WHEN */
353
	gettext_noop("Reporting and Logging / When to Log"),
354
	/* LOGGING_WHAT */
355
	gettext_noop("Reporting and Logging / What to Log"),
356
	/* STATS */
357
	gettext_noop("Statistics"),
358
	/* STATS_MONITORING */
359
	gettext_noop("Statistics / Monitoring"),
360
	/* STATS_COLLECTOR */
361
	gettext_noop("Statistics / Query and Index Statistics Collector"),
362
	/* AUTOVACUUM */
363
	gettext_noop("Autovacuum"),
364
	/* CLIENT_CONN */
365
	gettext_noop("Client Connection Defaults"),
366
	/* CLIENT_CONN_STATEMENT */
367
	gettext_noop("Client Connection Defaults / Statement Behavior"),
368
	/* CLIENT_CONN_LOCALE */
369
	gettext_noop("Client Connection Defaults / Locale and Formatting"),
370
	/* CLIENT_CONN_OTHER */
371
	gettext_noop("Client Connection Defaults / Other Defaults"),
372
	/* LOCK_MANAGEMENT */
373
	gettext_noop("Lock Management"),
374
	/* COMPAT_OPTIONS */
375
	gettext_noop("Version and Platform Compatibility"),
376
	/* COMPAT_OPTIONS_PREVIOUS */
377
	gettext_noop("Version and Platform Compatibility / Previous PostgreSQL Versions"),
378
	/* COMPAT_OPTIONS_CLIENT */
379
	gettext_noop("Version and Platform Compatibility / Other Platforms and Clients"),
380 381 382 383
	/* PRESET_OPTIONS */
	gettext_noop("Preset Options"),
	/* CUSTOM_OPTIONS */
	gettext_noop("Customized Options"),
384
	/* DEVELOPER_OPTIONS */
385
	gettext_noop("Developer Options"),
386
	/* help_config wants this array to be null-terminated */
387 388 389
	NULL
};

390 391 392 393 394
/*
 * Displayable names for GUC variable types (enum config_type)
 *
 * Note: these strings are deliberately not localized.
 */
B
Bruce Momjian 已提交
395
const char *const config_type_names[] =
396
{
B
Bruce Momjian 已提交
397 398 399 400
	 /* PGC_BOOL */ "bool",
	 /* PGC_INT */ "integer",
	 /* PGC_REAL */ "real",
	 /* PGC_STRING */ "string"
401 402
};

403

404
/*
405 406 407 408
 * Contents of GUC tables
 *
 * See src/backend/utils/misc/README for design notes.
 *
409 410 411
 * TO ADD AN OPTION:
 *
 * 1. Declare a global variable of type bool, int, double, or char*
B
Bruce Momjian 已提交
412
 *	  and make use of it.
413 414
 *
 * 2. Decide at what times it's safe to set the option. See guc.h for
B
Bruce Momjian 已提交
415
 *	  details.
416 417
 *
 * 3. Decide on a name, a default value, upper and lower bounds (if
B
Bruce Momjian 已提交
418
 *	  applicable), etc.
419 420 421
 *
 * 4. Add a record below.
 *
422
 * 5. Add it to src/backend/utils/misc/postgresql.conf.sample, if
B
Bruce Momjian 已提交
423
 *	  appropriate
424
 *
425
 * 6. Don't forget to document the option.
426
 *
427
 * 7. If it's a new GUC_LIST option you must edit pg_dumpall.c to ensure
B
Bruce Momjian 已提交
428
 *	  it is not single quoted at dump time.
429 430
 */

431

432
/******** option records follow ********/
433

434
static struct config_bool ConfigureNamesBool[] =
435
{
436
	{
437
		{"enable_seqscan", PGC_USERSET, QUERY_TUNING_METHOD,
438
			gettext_noop("Enables the planner's use of sequential-scan plans."),
439 440 441
			NULL
		},
		&enable_seqscan,
442
		true, NULL, NULL
443
	},
444
	{
445
		{"enable_indexscan", PGC_USERSET, QUERY_TUNING_METHOD,
446
			gettext_noop("Enables the planner's use of index-scan plans."),
447 448 449
			NULL
		},
		&enable_indexscan,
450
		true, NULL, NULL
451
	},
452 453 454 455 456 457 458 459
	{
		{"enable_bitmapscan", PGC_USERSET, QUERY_TUNING_METHOD,
			gettext_noop("Enables the planner's use of bitmap-scan plans."),
			NULL
		},
		&enable_bitmapscan,
		true, NULL, NULL
	},
460
	{
461
		{"enable_tidscan", PGC_USERSET, QUERY_TUNING_METHOD,
462
			gettext_noop("Enables the planner's use of TID scan plans."),
463 464 465
			NULL
		},
		&enable_tidscan,
466
		true, NULL, NULL
467 468
	},
	{
469
		{"enable_sort", PGC_USERSET, QUERY_TUNING_METHOD,
470
			gettext_noop("Enables the planner's use of explicit sort steps."),
471 472 473
			NULL
		},
		&enable_sort,
474
		true, NULL, NULL
475
	},
476
	{
477
		{"enable_hashagg", PGC_USERSET, QUERY_TUNING_METHOD,
478
			gettext_noop("Enables the planner's use of hashed aggregation plans."),
479 480 481
			NULL
		},
		&enable_hashagg,
482 483
		true, NULL, NULL
	},
484
	{
485
		{"enable_nestloop", PGC_USERSET, QUERY_TUNING_METHOD,
486
			gettext_noop("Enables the planner's use of nested-loop join plans."),
487 488 489
			NULL
		},
		&enable_nestloop,
490
		true, NULL, NULL
491 492
	},
	{
493
		{"enable_mergejoin", PGC_USERSET, QUERY_TUNING_METHOD,
494
			gettext_noop("Enables the planner's use of merge join plans."),
495 496 497
			NULL
		},
		&enable_mergejoin,
498
		true, NULL, NULL
499 500
	},
	{
501
		{"enable_hashjoin", PGC_USERSET, QUERY_TUNING_METHOD,
502
			gettext_noop("Enables the planner's use of hash join plans."),
503 504 505
			NULL
		},
		&enable_hashjoin,
506
		true, NULL, NULL
507
	},
508
	{
509
		{"constraint_exclusion", PGC_USERSET, QUERY_TUNING_OTHER,
510 511
			gettext_noop("Enables the planner to use constraints to optimize queries."),
			gettext_noop("Child table scans will be skipped if their "
512
					   "constraints guarantee that no rows match the query.")
513
		},
514
		&constraint_exclusion,
515 516
		false, NULL, NULL
	},
517
	{
518
		{"geqo", PGC_USERSET, QUERY_TUNING_GEQO,
519
			gettext_noop("Enables genetic query optimization."),
520
			gettext_noop("This algorithm attempts to do planning without "
521
						 "exhaustive searching.")
522 523
		},
		&enable_geqo,
524
		true, NULL, NULL
525
	},
526
	{
527 528
		/* Not for general use --- used by SET SESSION AUTHORIZATION */
		{"is_superuser", PGC_INTERNAL, UNGROUPED,
529
			gettext_noop("Shows whether the current user is a superuser."),
530 531 532
			NULL,
			GUC_REPORT | GUC_NO_SHOW_ALL | GUC_NO_RESET_ALL | GUC_NOT_IN_SAMPLE | GUC_DISALLOW_IN_FILE
		},
533 534 535
		&session_auth_is_superuser,
		false, NULL, NULL
	},
536
	{
537
		{"ssl", PGC_POSTMASTER, CONN_AUTH_SECURITY,
538
			gettext_noop("Enables SSL connections."),
539 540 541
			NULL
		},
		&EnableSSL,
542
		false, assign_ssl, NULL
543 544
	},
	{
545
		{"fsync", PGC_SIGHUP, WAL_SETTINGS,
546
			gettext_noop("Forces synchronization of updates to disk."),
547
			gettext_noop("The server will use the fsync() system call in several places to make "
548
			"sure that updates are physically written to disk. This insures "
549
						 "that a database cluster will recover to a consistent state after "
550
						 "an operating system or hardware crash.")
551 552
		},
		&enableFsync,
553
		true, NULL, NULL
554
	},
555
	{
556
		{"zero_damaged_pages", PGC_SUSET, DEVELOPER_OPTIONS,
557
			gettext_noop("Continues processing past damaged page headers."),
558
			gettext_noop("Detection of a damaged page header normally causes PostgreSQL to "
B
Bruce Momjian 已提交
559
				"report an error, aborting the current transaction. Setting "
560 561
						 "zero_damaged_pages to true causes the system to instead report a "
						 "warning, zero out the damaged page, and continue processing. This "
562
						 "behavior will destroy data, namely all the rows on the damaged page."),
563
			GUC_NOT_IN_SAMPLE
564 565
		},
		&zero_damaged_pages,
566 567
		false, NULL, NULL
	},
568 569 570 571
	{
		{"full_page_writes", PGC_SIGHUP, WAL_SETTINGS,
			gettext_noop("Writes full pages to WAL when first modified after a checkpoint."),
			gettext_noop("A page write in process during an operating system crash might be "
B
Bruce Momjian 已提交
572
						 "only partially written to disk.  During recovery, the row changes "
573
			  "stored in WAL are not enough to recover.  This option writes "
574 575 576 577 578 579
						 "pages when first modified after a checkpoint to WAL so full recovery "
						 "is possible.")
		},
		&fullPageWrites,
		true, NULL, NULL
	},
580
	{
581
		{"silent_mode", PGC_POSTMASTER, LOGGING_WHEN,
582
			gettext_noop("Runs the server silently."),
583
			gettext_noop("If this parameter is set, the server will automatically run in the "
B
Bruce Momjian 已提交
584
				 "background and any controlling terminals are dissociated.")
585 586
		},
		&SilentMode,
587
		false, NULL, NULL
588
	},
589 590 591 592 593 594 595 596
	{
		{"log_checkpoints", PGC_SIGHUP, LOGGING_WHAT,
			gettext_noop("Logs each checkpoint."),
			NULL
		},
		&log_checkpoints,
		false, NULL, NULL
	},
597
	{
598
		{"log_connections", PGC_BACKEND, LOGGING_WHAT,
599
			gettext_noop("Logs each successful connection."),
600 601 602
			NULL
		},
		&Log_connections,
603
		false, NULL, NULL
604
	},
605 606
	{
		{"log_disconnections", PGC_BACKEND, LOGGING_WHAT,
P
Peter Eisentraut 已提交
607
			gettext_noop("Logs end of a session, including duration."),
B
Bruce Momjian 已提交
608
			NULL
609 610 611 612
		},
		&Log_disconnections,
		false, NULL, NULL
	},
613
	{
614
		{"debug_assertions", PGC_USERSET, DEVELOPER_OPTIONS,
615
			gettext_noop("Turns on various assertion checks."),
616
			gettext_noop("This is a debugging aid."),
617 618 619
			GUC_NOT_IN_SAMPLE
		},
		&assert_enabled,
620 621 622 623
#ifdef USE_ASSERT_CHECKING
		true,
#else
		false,
624
#endif
625 626
		assign_debug_assertions, NULL
	},
627 628
	{
		/* currently undocumented, so don't show in SHOW ALL */
629
		{"exit_on_error", PGC_USERSET, UNGROUPED,
630
			gettext_noop("No description available."),
631 632 633 634
			NULL,
			GUC_NO_SHOW_ALL | GUC_NOT_IN_SAMPLE
		},
		&ExitOnAnyError,
635 636
		false, NULL, NULL
	},
637
	{
638 639
		{"log_duration", PGC_SUSET, LOGGING_WHAT,
			gettext_noop("Logs the duration of each completed SQL statement."),
640 641 642
			NULL
		},
		&log_duration,
643
		false, NULL, NULL
644 645
	},
	{
646
		{"debug_print_parse", PGC_USERSET, LOGGING_WHAT,
647
			gettext_noop("Prints the parse tree to the server log."),
648
			NULL
649 650
		},
		&Debug_print_parse,
651
		false, NULL, NULL
652 653
	},
	{
654
		{"debug_print_rewritten", PGC_USERSET, LOGGING_WHAT,
655
			gettext_noop("Prints the parse tree after rewriting to server log."),
656 657 658
			NULL
		},
		&Debug_print_rewritten,
659
		false, NULL, NULL
660 661
	},
	{
662
		{"debug_print_plan", PGC_USERSET, LOGGING_WHAT,
663
			gettext_noop("Prints the execution plan to server log."),
664 665 666
			NULL
		},
		&Debug_print_plan,
667
		false, NULL, NULL
668 669
	},
	{
670
		{"debug_pretty_print", PGC_USERSET, LOGGING_WHAT,
671
			gettext_noop("Indents parse and plan tree displays."),
672 673 674
			NULL
		},
		&Debug_pretty_print,
675
		false, NULL, NULL
676 677
	},
	{
678
		{"log_parser_stats", PGC_SUSET, STATS_MONITORING,
679
			gettext_noop("Writes parser performance statistics to the server log."),
680 681 682
			NULL
		},
		&log_parser_stats,
683
		false, assign_stage_log_stats, NULL
684 685
	},
	{
686
		{"log_planner_stats", PGC_SUSET, STATS_MONITORING,
687
			gettext_noop("Writes planner performance statistics to the server log."),
688 689 690
			NULL
		},
		&log_planner_stats,
691
		false, assign_stage_log_stats, NULL
692 693
	},
	{
694
		{"log_executor_stats", PGC_SUSET, STATS_MONITORING,
695
			gettext_noop("Writes executor performance statistics to the server log."),
696 697 698
			NULL
		},
		&log_executor_stats,
699
		false, assign_stage_log_stats, NULL
700 701
	},
	{
702
		{"log_statement_stats", PGC_SUSET, STATS_MONITORING,
703
			gettext_noop("Writes cumulative performance statistics to the server log."),
704 705 706
			NULL
		},
		&log_statement_stats,
707
		false, assign_log_stats, NULL
708
	},
709
#ifdef BTREE_BUILD_STATS
710
	{
711
		{"log_btree_build_stats", PGC_SUSET, DEVELOPER_OPTIONS,
712
			gettext_noop("No description available."),
713 714 715 716
			NULL,
			GUC_NOT_IN_SAMPLE
		},
		&log_btree_build_stats,
717
		false, NULL, NULL
718
	},
719 720
#endif

721
	{
722
		{"explain_pretty_print", PGC_USERSET, CLIENT_CONN_OTHER,
723
			gettext_noop("Uses the indented output format for EXPLAIN VERBOSE."),
724 725 726
			NULL
		},
		&Explain_pretty_print,
727
		true, NULL, NULL
728
	},
729
	{
730
		{"stats_start_collector", PGC_POSTMASTER, STATS_COLLECTOR,
731
			gettext_noop("Starts the server statistics-collection subprocess."),
732 733 734
			NULL
		},
		&pgstat_collect_startcollector,
735
		true, NULL, NULL
736 737
	},
	{
738
		{"stats_reset_on_server_start", PGC_POSTMASTER, STATS_COLLECTOR,
739
			gettext_noop("Zeroes collected statistics on server restart."),
740 741 742
			NULL
		},
		&pgstat_collect_resetonpmstart,
743
		false, NULL, NULL
744 745
	},
	{
746
		{"stats_row_level", PGC_SUSET, STATS_COLLECTOR,
747
			gettext_noop("Collects row-level statistics on database activity."),
748 749 750
			NULL
		},
		&pgstat_collect_tuplelevel,
751
		true, NULL, NULL
752 753
	},
	{
754
		{"stats_block_level", PGC_SUSET, STATS_COLLECTOR,
755
			gettext_noop("Collects block-level statistics on database activity."),
756 757 758
			NULL
		},
		&pgstat_collect_blocklevel,
759
		false, NULL, NULL
760
	},
761

762 763 764 765 766 767 768 769
	{
		{"stats_command_string", PGC_SUSET, STATS_COLLECTOR,
			gettext_noop("Collects information about executing commands."),
			gettext_noop("Enables the collection of information on the currently "
					"executing command of each session, along with the time "
						 "at which that command began execution.")
		},
		&pgstat_collect_querystring,
770
		true, NULL, NULL
771 772
	},

773 774 775
	{
		{"update_process_title", PGC_SUSET, STATS_COLLECTOR,
			gettext_noop("Updates the process title to show the active SQL command."),
776
			gettext_noop("Enables updating of the process title every time a new SQL command is received by the server.")
777 778 779 780 781
		},
		&update_process_title,
		true, NULL, NULL
	},

782 783
	{
		{"autovacuum", PGC_SIGHUP, AUTOVACUUM,
P
Peter Eisentraut 已提交
784
			gettext_noop("Starts the autovacuum subprocess."),
785 786 787
			NULL
		},
		&autovacuum_start_daemon,
788
		true, NULL, NULL
789 790
	},

791
	{
792
		{"trace_notify", PGC_USERSET, DEVELOPER_OPTIONS,
793
			gettext_noop("Generates debugging output for LISTEN and NOTIFY."),
794 795 796 797
			NULL,
			GUC_NOT_IN_SAMPLE
		},
		&Trace_notify,
798
		false, NULL, NULL
799
	},
800 801

#ifdef LOCK_DEBUG
802
	{
803
		{"trace_locks", PGC_SUSET, DEVELOPER_OPTIONS,
804
			gettext_noop("No description available."),
805 806 807 808
			NULL,
			GUC_NOT_IN_SAMPLE
		},
		&Trace_locks,
809
		false, NULL, NULL
810 811
	},
	{
812
		{"trace_userlocks", PGC_SUSET, DEVELOPER_OPTIONS,
813
			gettext_noop("No description available."),
814 815 816 817
			NULL,
			GUC_NOT_IN_SAMPLE
		},
		&Trace_userlocks,
818
		false, NULL, NULL
819 820
	},
	{
821
		{"trace_lwlocks", PGC_SUSET, DEVELOPER_OPTIONS,
822
			gettext_noop("No description available."),
823 824 825 826
			NULL,
			GUC_NOT_IN_SAMPLE
		},
		&Trace_lwlocks,
827
		false, NULL, NULL
828 829
	},
	{
830
		{"debug_deadlocks", PGC_SUSET, DEVELOPER_OPTIONS,
831
			gettext_noop("No description available."),
832 833 834 835
			NULL,
			GUC_NOT_IN_SAMPLE
		},
		&Debug_deadlocks,
836
		false, NULL, NULL
837
	},
838 839
#endif

840
	{
841 842
		{"log_lock_waits", PGC_SUSET, LOGGING_WHAT,
			gettext_noop("Logs long lock waits."),
843 844 845 846 847
			NULL
		},
		&log_lock_waits,
		false, NULL, NULL
	},
848

849
	{
850
		{"log_hostname", PGC_SIGHUP, LOGGING_WHAT,
851
			gettext_noop("Logs the host name in the connection logs."),
852 853
			gettext_noop("By default, connection logs only show the IP address "
						 "of the connecting host. If you want them to show the host name you "
B
Bruce Momjian 已提交
854 855
			  "can turn this on, but depending on your host name resolution "
			   "setup it might impose a non-negligible performance penalty.")
856 857
		},
		&log_hostname,
858
		false, NULL, NULL
859 860
	},
	{
861
		{"sql_inheritance", PGC_USERSET, COMPAT_OPTIONS_PREVIOUS,
862
			gettext_noop("Causes subtables to be included by default in various commands."),
863
			NULL
864 865
		},
		&SQL_inheritance,
866
		true, NULL, NULL
867 868
	},
	{
869
		{"password_encryption", PGC_USERSET, CONN_AUTH_SECURITY,
870
			gettext_noop("Encrypt passwords."),
871
			gettext_noop("When a password is specified in CREATE USER or "
B
Bruce Momjian 已提交
872
			   "ALTER USER without writing either ENCRYPTED or UNENCRYPTED, "
873
						 "this parameter determines whether the password is to be encrypted.")
874 875
		},
		&Password_encryption,
876
		true, NULL, NULL
877 878
	},
	{
879
		{"transform_null_equals", PGC_USERSET, COMPAT_OPTIONS_CLIENT,
880
			gettext_noop("Treats \"expr=NULL\" as \"expr IS NULL\"."),
881
			gettext_noop("When turned on, expressions of the form expr = NULL "
B
Bruce Momjian 已提交
882 883 884
			   "(or NULL = expr) are treated as expr IS NULL, that is, they "
				"return true if expr evaluates to the null value, and false "
			   "otherwise. The correct behavior of expr = NULL is to always "
885
						 "return null (unknown).")
886 887
		},
		&Transform_null_equals,
888
		false, NULL, NULL
889
	},
890
	{
891
		{"db_user_namespace", PGC_SIGHUP, CONN_AUTH_SECURITY,
892
			gettext_noop("Enables per-database user names."),
893 894 895
			NULL
		},
		&Db_user_namespace,
896 897
		false, NULL, NULL
	},
898
	{
899 900
		/* only here for backwards compatibility */
		{"autocommit", PGC_USERSET, CLIENT_CONN_STATEMENT,
901 902
			gettext_noop("This parameter doesn't do anything."),
			gettext_noop("It's just here so that we won't choke on SET AUTOCOMMIT TO ON from 7.3-vintage clients."),
903 904 905
			GUC_NO_SHOW_ALL | GUC_NOT_IN_SAMPLE
		},
		&phony_autocommit,
906
		true, assign_phony_autocommit, NULL
907
	},
908
	{
909
		{"default_transaction_read_only", PGC_USERSET, CLIENT_CONN_STATEMENT,
910
			gettext_noop("Sets the default read-only status of new transactions."),
911 912 913
			NULL
		},
		&DefaultXactReadOnly,
914 915 916
		false, NULL, NULL
	},
	{
917
		{"transaction_read_only", PGC_USERSET, CLIENT_CONN_STATEMENT,
918
			gettext_noop("Sets the current transaction's read-only status."),
919 920 921 922
			NULL,
			GUC_NO_RESET_ALL | GUC_NOT_IN_SAMPLE | GUC_DISALLOW_IN_FILE
		},
		&XactReadOnly,
923
		false, assign_transaction_read_only, NULL
924
	},
925
	{
926
		{"add_missing_from", PGC_USERSET, COMPAT_OPTIONS_PREVIOUS,
927
			gettext_noop("Automatically adds missing table references to FROM clauses."),
928 929 930
			NULL
		},
		&add_missing_from,
931
		false, NULL, NULL
932
	},
933 934
	{
		{"check_function_bodies", PGC_USERSET, CLIENT_CONN_STATEMENT,
935
			gettext_noop("Check function bodies during CREATE FUNCTION."),
936 937 938 939 940
			NULL
		},
		&check_function_bodies,
		true, NULL, NULL
	},
941 942 943 944
	{
		{"array_nulls", PGC_USERSET, COMPAT_OPTIONS_PREVIOUS,
			gettext_noop("Enable input of NULL elements in arrays."),
			gettext_noop("When turned on, unquoted NULL in an array input "
P
Peter Eisentraut 已提交
945
						 "value means a null value; "
946 947 948 949 950
						 "otherwise it is taken literally.")
		},
		&Array_nulls,
		true, NULL, NULL
	},
951 952
	{
		{"default_with_oids", PGC_USERSET, COMPAT_OPTIONS_PREVIOUS,
953
			gettext_noop("Create new tables with OIDs by default."),
B
Bruce Momjian 已提交
954
			NULL
955 956
		},
		&default_with_oids,
957
		false, NULL, NULL
958
	},
959
	{
960
		{"redirect_stderr", PGC_POSTMASTER, LOGGING_WHERE,
P
Peter Eisentraut 已提交
961
			gettext_noop("Start a subprocess to capture stderr output into log files."),
B
Bruce Momjian 已提交
962
			NULL
963
		},
964
		&Redirect_stderr,
965 966
		false, NULL, NULL
	},
967 968
	{
		{"log_truncate_on_rotation", PGC_SIGHUP, LOGGING_WHERE,
P
Peter Eisentraut 已提交
969
			gettext_noop("Truncate existing log files of same name during log rotation."),
970 971 972 973 974
			NULL
		},
		&Log_truncate_on_rotation,
		false, NULL, NULL
	},
975

976 977 978 979 980 981 982 983 984 985 986 987
#ifdef TRACE_SORT
	{
		{"trace_sort", PGC_USERSET, DEVELOPER_OPTIONS,
			gettext_noop("Emit information about resource usage in sorting."),
			NULL,
			GUC_NOT_IN_SAMPLE
		},
		&trace_sort,
		false, NULL, NULL
	},
#endif

988 989 990 991 992 993 994 995 996 997 998 999 1000
#ifdef TRACE_SYNCSCAN
	/* this is undocumented because not exposed in a standard build */
	{
		{"trace_syncscan", PGC_USERSET, DEVELOPER_OPTIONS,
			gettext_noop("Generate debugging output for synchronized scanning."),
			NULL,
			GUC_NOT_IN_SAMPLE
		},
		&trace_syncscan,
		false, NULL, NULL
	},
#endif

1001 1002 1003 1004 1005 1006 1007 1008 1009 1010 1011 1012 1013 1014
#ifdef DEBUG_BOUNDED_SORT
	/* this is undocumented because not exposed in a standard build */
	{
		{
			"optimize_bounded_sort", PGC_USERSET, QUERY_TUNING_METHOD,
			gettext_noop("Enable bounded sorting using heap sort."),
			NULL,
			GUC_NOT_IN_SAMPLE
		},
		&optimize_bounded_sort,
		true, NULL, NULL
	},
#endif

1015 1016 1017 1018 1019 1020 1021 1022 1023 1024 1025 1026
#ifdef WAL_DEBUG
	{
		{"wal_debug", PGC_SUSET, DEVELOPER_OPTIONS,
			gettext_noop("Emit WAL-related debugging output."),
			NULL,
			GUC_NOT_IN_SAMPLE
		},
		&XLOG_DEBUG,
		false, NULL, NULL
	},
#endif

1027
	{
1028
		{"integer_datetimes", PGC_INTERNAL, PRESET_OPTIONS,
1029
			gettext_noop("Datetimes are integer based."),
1030
			NULL,
1031
			GUC_REPORT | GUC_NOT_IN_SAMPLE | GUC_DISALLOW_IN_FILE
1032 1033 1034 1035 1036 1037 1038 1039 1040
		},
		&integer_datetimes,
#ifdef HAVE_INT64_TIMESTAMP
		true, NULL, NULL
#else
		false, NULL, NULL
#endif
	},

B
 
Bruce Momjian 已提交
1041 1042
	{
		{"krb_caseins_users", PGC_POSTMASTER, CONN_AUTH_SECURITY,
1043
			gettext_noop("Sets whether Kerberos user names should be treated as case-insensitive."),
B
 
Bruce Momjian 已提交
1044 1045 1046 1047 1048 1049
			NULL
		},
		&pg_krb_caseins_users,
		false, NULL, NULL
	},

1050 1051
	{
		{"escape_string_warning", PGC_USERSET, COMPAT_OPTIONS_PREVIOUS,
1052
			gettext_noop("Warn about backslash escapes in ordinary string literals."),
1053 1054 1055
			NULL
		},
		&escape_string_warning,
1056
		true, NULL, NULL
1057 1058 1059
	},

	{
1060
		{"standard_conforming_strings", PGC_USERSET, COMPAT_OPTIONS_PREVIOUS,
1061
			gettext_noop("Causes '...' strings to treat backslashes literally."),
1062
			NULL,
1063
			GUC_REPORT
1064
		},
1065
		&standard_conforming_strings,
1066 1067 1068
		false, NULL, NULL
	},

1069
	{
1070
		{"allow_system_table_mods", PGC_POSTMASTER, DEVELOPER_OPTIONS,
B
Bruce Momjian 已提交
1071 1072 1073
			gettext_noop("Allows modifications of the structure of system tables."),
			NULL,
			GUC_NOT_IN_SAMPLE
1074 1075 1076 1077 1078 1079 1080
		},
		&allowSystemTableMods,
		false, NULL, NULL
	},

	{
		{"ignore_system_indexes", PGC_BACKEND, DEVELOPER_OPTIONS,
B
Bruce Momjian 已提交
1081 1082 1083 1084
			gettext_noop("Disables reading from system indexes."),
			gettext_noop("It does not prevent updating the indexes, so it is safe "
						 "to use.  The worst consequence is slowness."),
			GUC_NOT_IN_SAMPLE
1085 1086 1087 1088 1089
		},
		&IgnoreSystemIndexes,
		false, NULL, NULL
	},

1090
	/* End-of-list marker */
1091
	{
1092 1093
		{NULL, 0, 0, NULL, NULL}, NULL, false, NULL, NULL
	}
1094 1095 1096
};


1097
static struct config_int ConfigureNamesInt[] =
1098
{
1099 1100
	{
		{"archive_timeout", PGC_SIGHUP, WAL_SETTINGS,
B
Bruce Momjian 已提交
1101 1102 1103 1104
			gettext_noop("Forces a switch to the next xlog file if a "
						 "new file has not been started within N seconds."),
			NULL,
			GUC_UNIT_S
1105 1106 1107 1108
		},
		&XLogArchiveTimeout,
		0, 0, INT_MAX, NULL, NULL
	},
1109 1110
	{
		{"post_auth_delay", PGC_BACKEND, DEVELOPER_OPTIONS,
B
Bruce Momjian 已提交
1111 1112 1113
			gettext_noop("Waits N seconds on connection startup after authentication."),
			gettext_noop("This allows attaching a debugger to the process."),
			GUC_NOT_IN_SAMPLE | GUC_UNIT_S
1114 1115 1116 1117
		},
		&PostAuthDelay,
		0, 0, INT_MAX, NULL, NULL
	},
1118
	{
1119
		{"default_statistics_target", PGC_USERSET, QUERY_TUNING_OTHER,
1120
			gettext_noop("Sets the default statistics target."),
1121
			gettext_noop("This applies to table columns that have not had a "
B
Bruce Momjian 已提交
1122
				"column-specific target set via ALTER TABLE SET STATISTICS.")
1123 1124
		},
		&default_statistics_target,
1125 1126
		10, 1, 1000, NULL, NULL
	},
1127
	{
1128
		{"from_collapse_limit", PGC_USERSET, QUERY_TUNING_OTHER,
1129 1130
			gettext_noop("Sets the FROM-list size beyond which subqueries "
						 "are not collapsed."),
1131
			gettext_noop("The planner will merge subqueries into upper "
B
Bruce Momjian 已提交
1132
				"queries if the resulting FROM list would have no more than "
1133
						 "this many items.")
1134 1135
		},
		&from_collapse_limit,
1136 1137 1138
		8, 1, INT_MAX, NULL, NULL
	},
	{
1139
		{"join_collapse_limit", PGC_USERSET, QUERY_TUNING_OTHER,
1140 1141
			gettext_noop("Sets the FROM-list size beyond which JOIN "
						 "constructs are not flattened."),
1142
			gettext_noop("The planner will flatten explicit JOIN "
1143 1144
						 "constructs into lists of FROM items whenever a "
						 "list of no more than this many items would result.")
1145 1146
		},
		&join_collapse_limit,
1147 1148 1149
		8, 1, INT_MAX, NULL, NULL
	},
	{
1150
		{"geqo_threshold", PGC_USERSET, QUERY_TUNING_GEQO,
1151
			gettext_noop("Sets the threshold of FROM items beyond which GEQO is used."),
1152 1153 1154
			NULL
		},
		&geqo_threshold,
1155
		12, 2, INT_MAX, NULL, NULL
1156
	},
1157
	{
1158 1159
		{"geqo_effort", PGC_USERSET, QUERY_TUNING_GEQO,
			gettext_noop("GEQO: effort is used to set the default for other GEQO parameters."),
1160 1161
			NULL
		},
1162 1163 1164 1165 1166 1167 1168 1169
		&Geqo_effort,
		DEFAULT_GEQO_EFFORT, MIN_GEQO_EFFORT, MAX_GEQO_EFFORT, NULL, NULL
	},
	{
		{"geqo_pool_size", PGC_USERSET, QUERY_TUNING_GEQO,
			gettext_noop("GEQO: number of individuals in the population."),
			gettext_noop("Zero selects a suitable default value.")
		},
1170
		&Geqo_pool_size,
1171
		0, 0, INT_MAX, NULL, NULL
1172 1173
	},
	{
1174
		{"geqo_generations", PGC_USERSET, QUERY_TUNING_GEQO,
1175
			gettext_noop("GEQO: number of iterations of the algorithm."),
1176
			gettext_noop("Zero selects a suitable default value.")
1177 1178
		},
		&Geqo_generations,
1179
		0, 0, INT_MAX, NULL, NULL
1180 1181 1182
	},

	{
1183
		{"deadlock_timeout", PGC_SIGHUP, LOCK_MANAGEMENT,
1184
			gettext_noop("Sets the time to wait on a lock before checking for deadlock."),
1185 1186
			NULL,
			GUC_UNIT_MS
1187 1188
		},
		&DeadlockTimeout,
1189
		1000, 1, INT_MAX/1000, NULL, NULL
1190
	},
1191 1192

	/*
B
Bruce Momjian 已提交
1193 1194
	 * Note: There is some postprocessing done in PostmasterMain() to make
	 * sure the buffers are at least twice the number of backends, so the
1195
	 * constraints here are partially unused. Similarly, the superuser
B
Bruce Momjian 已提交
1196 1197
	 * reserved number is checked to ensure it is less than the max backends
	 * number.
1198 1199
	 *
	 * MaxBackends is limited to INT_MAX/4 because some places compute
1200 1201 1202 1203 1204
	 * 4*MaxBackends without any overflow check.  This check is made on
	 * assign_maxconnections, since MaxBackends is computed as MaxConnections +
	 * autovacuum_max_workers.
	 *
	 * Likewise we have to limit NBuffers to INT_MAX/2.
1205
	 */
1206
	{
1207
		{"max_connections", PGC_POSTMASTER, CONN_AUTH_SETTINGS,
1208
			gettext_noop("Sets the maximum number of concurrent connections."),
1209 1210
			NULL
		},
1211 1212
		&MaxConnections,
		100, 1, INT_MAX / 4, assign_maxconnections, NULL
1213
	},
1214

1215
	{
1216
		{"superuser_reserved_connections", PGC_POSTMASTER, CONN_AUTH_SETTINGS,
1217
			gettext_noop("Sets the number of connection slots reserved for superusers."),
1218 1219 1220
			NULL
		},
		&ReservedBackends,
1221
		3, 0, INT_MAX / 4, NULL, NULL
1222 1223
	},

1224
	{
1225
		{"shared_buffers", PGC_POSTMASTER, RESOURCES_MEM,
1226
			gettext_noop("Sets the number of shared memory buffers used by the server."),
1227 1228
			NULL,
			GUC_UNIT_BLOCKS
1229 1230
		},
		&NBuffers,
1231
		1024, 16, INT_MAX / 2, NULL, NULL
1232
	},
1233

1234 1235 1236
	{
		{"temp_buffers", PGC_USERSET, RESOURCES_MEM,
			gettext_noop("Sets the maximum number of temporary buffers used by each session."),
1237 1238
			NULL,
			GUC_UNIT_BLOCKS
1239 1240
		},
		&num_temp_buffers,
1241
		1024, 100, INT_MAX / 2, NULL, show_num_temp_buffers
1242 1243
	},

1244
	{
1245
		{"port", PGC_POSTMASTER, CONN_AUTH_SETTINGS,
1246
			gettext_noop("Sets the TCP port the server listens on."),
1247 1248 1249
			NULL
		},
		&PostPortNumber,
1250
		DEF_PGPORT, 1, 65535, NULL, NULL
1251
	},
1252

1253
	{
1254
		{"unix_socket_permissions", PGC_POSTMASTER, CONN_AUTH_SETTINGS,
1255
			gettext_noop("Sets the access permissions of the Unix-domain socket."),
1256
			gettext_noop("Unix-domain sockets use the usual Unix file system "
1257
						 "permission set. The parameter value is expected to be an numeric mode "
1258
						 "specification in the form accepted by the chmod and umask system "
1259 1260 1261 1262
						 "calls. (To use the customary octal format the number must start with "
						 "a 0 (zero).)")
		},
		&Unix_socket_permissions,
1263
		0777, 0000, 0777, NULL, NULL
1264
	},
1265

1266
	{
1267 1268
		{"work_mem", PGC_USERSET, RESOURCES_MEM,
			gettext_noop("Sets the maximum memory to be used for query workspaces."),
1269
			gettext_noop("This much memory can be used by each internal "
B
Bruce Momjian 已提交
1270
						 "sort operation and hash table before switching to "
1271 1272
						 "temporary disk files."),
			GUC_UNIT_KB
1273
		},
1274
		&work_mem,
1275
		1024, 8 * BLCKSZ / 1024, MAX_KILOBYTES, NULL, NULL
1276
	},
1277

1278
	{
1279 1280
		{"maintenance_work_mem", PGC_USERSET, RESOURCES_MEM,
			gettext_noop("Sets the maximum memory to be used for maintenance operations."),
1281 1282
			gettext_noop("This includes operations such as VACUUM and CREATE INDEX."),
			GUC_UNIT_KB
1283
		},
1284
		&maintenance_work_mem,
1285
		16384, 1024, MAX_KILOBYTES, NULL, NULL
1286
	},
1287

1288 1289 1290
	{
		{"max_stack_depth", PGC_SUSET, RESOURCES_MEM,
			gettext_noop("Sets the maximum stack depth, in kilobytes."),
1291 1292
			NULL,
			GUC_UNIT_KB
1293 1294
		},
		&max_stack_depth,
1295
		100, 100, MAX_KILOBYTES, assign_max_stack_depth, NULL
1296 1297
	},

J
Jan Wieck 已提交
1298 1299 1300 1301 1302 1303 1304 1305 1306 1307 1308 1309 1310 1311 1312 1313 1314 1315 1316 1317 1318 1319 1320 1321 1322 1323 1324 1325 1326 1327 1328 1329 1330 1331 1332 1333 1334
	{
		{"vacuum_cost_page_hit", PGC_USERSET, RESOURCES,
			gettext_noop("Vacuum cost for a page found in the buffer cache."),
			NULL
		},
		&VacuumCostPageHit,
		1, 0, 10000, NULL, NULL
	},

	{
		{"vacuum_cost_page_miss", PGC_USERSET, RESOURCES,
			gettext_noop("Vacuum cost for a page not found in the buffer cache."),
			NULL
		},
		&VacuumCostPageMiss,
		10, 0, 10000, NULL, NULL
	},

	{
		{"vacuum_cost_page_dirty", PGC_USERSET, RESOURCES,
			gettext_noop("Vacuum cost for a page dirtied by vacuum."),
			NULL
		},
		&VacuumCostPageDirty,
		20, 0, 10000, NULL, NULL
	},

	{
		{"vacuum_cost_limit", PGC_USERSET, RESOURCES,
			gettext_noop("Vacuum cost amount available before napping."),
			NULL
		},
		&VacuumCostLimit,
		200, 1, 10000, NULL, NULL
	},

	{
1335 1336
		{"vacuum_cost_delay", PGC_USERSET, RESOURCES,
			gettext_noop("Vacuum cost delay in milliseconds."),
1337 1338
			NULL,
			GUC_UNIT_MS
J
Jan Wieck 已提交
1339
		},
1340
		&VacuumCostDelay,
1341
		0, 0, 1000, NULL, NULL
J
Jan Wieck 已提交
1342 1343
	},

1344 1345 1346
	{
		{"autovacuum_vacuum_cost_delay", PGC_SIGHUP, AUTOVACUUM,
			gettext_noop("Vacuum cost delay in milliseconds, for autovacuum."),
1347 1348
			NULL,
			GUC_UNIT_MS
1349 1350 1351 1352 1353 1354 1355 1356 1357 1358 1359 1360 1361 1362
		},
		&autovacuum_vac_cost_delay,
		-1, -1, 1000, NULL, NULL
	},

	{
		{"autovacuum_vacuum_cost_limit", PGC_SIGHUP, AUTOVACUUM,
			gettext_noop("Vacuum cost amount available before napping, for autovacuum."),
			NULL
		},
		&autovacuum_vac_cost_limit,
		-1, -1, 10000, NULL, NULL
	},

1363
	{
1364
		{"max_files_per_process", PGC_POSTMASTER, RESOURCES_KERNEL,
1365
			gettext_noop("Sets the maximum number of simultaneously open files for each server process."),
1366 1367 1368
			NULL
		},
		&max_files_per_process,
1369
		1000, 25, INT_MAX, NULL, NULL
1370
	},
1371

1372 1373 1374 1375 1376 1377
	{
		{"max_prepared_transactions", PGC_POSTMASTER, RESOURCES,
			gettext_noop("Sets the maximum number of simultaneously prepared transactions."),
			NULL
		},
		&max_prepared_xacts,
1378
		5, 0, INT_MAX, NULL, NULL
1379 1380
	},

1381
#ifdef LOCK_DEBUG
1382
	{
1383
		{"trace_lock_oidmin", PGC_SUSET, DEVELOPER_OPTIONS,
1384
			gettext_noop("No description available."),
1385 1386 1387 1388
			NULL,
			GUC_NOT_IN_SAMPLE
		},
		&Trace_lock_oidmin,
1389
		FirstNormalObjectId, 0, INT_MAX, NULL, NULL
1390 1391
	},
	{
1392
		{"trace_lock_table", PGC_SUSET, DEVELOPER_OPTIONS,
1393
			gettext_noop("No description available."),
1394 1395 1396 1397
			NULL,
			GUC_NOT_IN_SAMPLE
		},
		&Trace_lock_table,
1398
		0, 0, INT_MAX, NULL, NULL
1399
	},
1400 1401
#endif

1402
	{
1403
		{"statement_timeout", PGC_USERSET, CLIENT_CONN_STATEMENT,
1404
			gettext_noop("Sets the maximum allowed duration of any statement."),
1405 1406
			gettext_noop("A value of 0 turns off the timeout."),
			GUC_UNIT_MS
1407 1408
		},
		&StatementTimeout,
1409 1410 1411
		0, 0, INT_MAX, NULL, NULL
	},

1412 1413 1414 1415 1416 1417 1418 1419 1420
	{
		{"vacuum_freeze_min_age", PGC_USERSET, CLIENT_CONN_STATEMENT,
			gettext_noop("Minimum age at which VACUUM should freeze a table row."),
			NULL
		},
		&vacuum_freeze_min_age,
		100000000, 0, 1000000000, NULL, NULL
	},

1421
	{
1422
		{"max_fsm_relations", PGC_POSTMASTER, RESOURCES_FSM,
1423
			gettext_noop("Sets the maximum number of tables and indexes for which free space is tracked."),
1424 1425 1426
			NULL
		},
		&MaxFSMRelations,
1427
		1000, 100, INT_MAX, NULL, NULL
1428 1429
	},
	{
1430
		{"max_fsm_pages", PGC_POSTMASTER, RESOURCES_FSM,
1431
			gettext_noop("Sets the maximum number of disk pages for which free space is tracked."),
1432 1433 1434
			NULL
		},
		&MaxFSMPages,
1435
		20000, 1000, INT_MAX, NULL, NULL
1436
	},
1437

1438
	{
1439
		{"max_locks_per_transaction", PGC_POSTMASTER, LOCK_MANAGEMENT,
1440
			gettext_noop("Sets the maximum number of locks per transaction."),
1441
			gettext_noop("The shared lock table is sized on the assumption that "
B
Bruce Momjian 已提交
1442
			  "at most max_locks_per_transaction * max_connections distinct "
1443
						 "objects will need to be locked at any one time.")
1444 1445
		},
		&max_locks_per_xact,
1446
		64, 10, INT_MAX, NULL, NULL
1447
	},
1448

1449
	{
1450
		{"authentication_timeout", PGC_SIGHUP, CONN_AUTH_SECURITY,
1451
			gettext_noop("Sets the maximum allowed time to complete client authentication."),
1452 1453
			NULL,
			GUC_UNIT_S
1454 1455
		},
		&AuthenticationTimeout,
1456
		60, 1, 600, NULL, NULL
1457
	},
1458

1459
	{
1460 1461
		/* Not for general use */
		{"pre_auth_delay", PGC_SIGHUP, DEVELOPER_OPTIONS,
1462 1463
			gettext_noop("Waits N seconds on connection startup before authentication."),
			gettext_noop("This allows attaching a debugger to the process."),
1464
			GUC_NOT_IN_SAMPLE | GUC_UNIT_S
1465 1466
		},
		&PreAuthDelay,
1467
		0, 0, 60, NULL, NULL
1468
	},
1469

1470
	{
1471
		{"checkpoint_segments", PGC_SIGHUP, WAL_CHECKPOINTS,
1472
			gettext_noop("Sets the maximum distance in log segments between automatic WAL checkpoints."),
1473 1474 1475
			NULL
		},
		&CheckPointSegments,
1476
		3, 1, INT_MAX, NULL, NULL
1477
	},
T
Tom Lane 已提交
1478

1479
	{
1480
		{"checkpoint_timeout", PGC_SIGHUP, WAL_CHECKPOINTS,
1481
			gettext_noop("Sets the maximum time between automatic WAL checkpoints."),
1482 1483
			NULL,
			GUC_UNIT_S
1484 1485
		},
		&CheckPointTimeout,
1486
		300, 30, 3600, NULL, NULL
1487
	},
V
Vadim B. Mikheev 已提交
1488

1489
	{
1490
		{"checkpoint_warning", PGC_SIGHUP, WAL_CHECKPOINTS,
1491 1492
			gettext_noop("Enables warnings if checkpoint segments are filled more "
						 "frequently than this."),
1493
			gettext_noop("Write a message to the server log if checkpoints "
B
Bruce Momjian 已提交
1494
			"caused by the filling of checkpoint segment files happens more "
1495 1496
						 "frequently than this number of seconds. Zero turns off the warning."),
			GUC_UNIT_S
1497 1498
		},
		&CheckPointWarning,
1499 1500 1501
		30, 0, INT_MAX, NULL, NULL
	},

1502
	{
1503
		{"wal_buffers", PGC_POSTMASTER, WAL_SETTINGS,
1504
			gettext_noop("Sets the number of disk-page buffers in shared memory for WAL."),
1505 1506
			NULL,
			GUC_UNIT_XBLOCKS
1507 1508
		},
		&XLOGbuffers,
1509
		8, 4, INT_MAX, NULL, NULL
1510
	},
V
Vadim B. Mikheev 已提交
1511

1512
	{
1513
		{"commit_delay", PGC_USERSET, WAL_CHECKPOINTS,
1514 1515
			gettext_noop("Sets the delay in microseconds between transaction commit and "
						 "flushing WAL to disk."),
1516 1517 1518
			NULL
		},
		&CommitDelay,
1519
		0, 0, 100000, NULL, NULL
1520
	},
V
Vadim B. Mikheev 已提交
1521

1522
	{
1523
		{"commit_siblings", PGC_USERSET, WAL_CHECKPOINTS,
1524 1525
			gettext_noop("Sets the minimum concurrent open transactions before performing "
						 "commit_delay."),
1526 1527 1528
			NULL
		},
		&CommitSiblings,
1529
		5, 1, 1000, NULL, NULL
1530
	},
1531

1532
	{
1533
		{"extra_float_digits", PGC_USERSET, CLIENT_CONN_LOCALE,
1534
			gettext_noop("Sets the number of digits displayed for floating-point values."),
1535
			gettext_noop("This affects real, double precision, and geometric data types. "
B
Bruce Momjian 已提交
1536
			 "The parameter value is added to the standard number of digits "
1537
						 "(FLT_DIG or DBL_DIG as appropriate).")
1538 1539
		},
		&extra_float_digits,
1540 1541 1542
		0, -15, 2, NULL, NULL
	},

B
Bruce Momjian 已提交
1543
	{
1544
		{"log_min_duration_statement", PGC_SUSET, LOGGING_WHEN,
1545
			gettext_noop("Sets the minimum execution time above which statements will "
1546
						 "be logged."),
1547 1548
			gettext_noop("Zero prints all queries. The default is -1 (turning this feature off)."),
			GUC_UNIT_MS
1549 1550
		},
		&log_min_duration_statement,
1551
		-1, -1, INT_MAX / 1000, NULL, NULL
B
Bruce Momjian 已提交
1552 1553
	},

1554 1555 1556 1557 1558 1559 1560 1561 1562 1563 1564
	{
		{"log_autovacuum", PGC_BACKEND, LOGGING_WHAT,
			gettext_noop("Sets the minimum execution time above which autovacuum actions "
						 "will be logged."),
			gettext_noop("Zero prints all actions.  The default is -1 (turning this feature off)."),
			GUC_UNIT_MS
		},
		&Log_autovacuum,
		-1, -1, INT_MAX / 1000, NULL, NULL
	},

J
Jan Wieck 已提交
1565 1566
	{
		{"bgwriter_delay", PGC_SIGHUP, RESOURCES,
1567
			gettext_noop("Background writer sleep time between rounds."),
1568 1569
			NULL,
			GUC_UNIT_MS
J
Jan Wieck 已提交
1570 1571
		},
		&BgWriterDelay,
1572
		200, 10, 10000, NULL, NULL
J
Jan Wieck 已提交
1573 1574 1575
	},

	{
1576
		{"bgwriter_lru_maxpages", PGC_SIGHUP, RESOURCES,
1577
			gettext_noop("Background writer maximum number of LRU pages to flush per round."),
J
Jan Wieck 已提交
1578 1579
			NULL
		},
1580 1581
		&bgwriter_lru_maxpages,
		5, 0, 1000, NULL, NULL
J
Jan Wieck 已提交
1582 1583
	},

1584 1585
	{
		{"log_rotation_age", PGC_SIGHUP, LOGGING_WHERE,
1586
			gettext_noop("Automatic log file rotation will occur after N minutes."),
1587 1588
			NULL,
			GUC_UNIT_MIN
1589 1590
		},
		&Log_RotationAge,
B
Bruce Momjian 已提交
1591
		HOURS_PER_DAY * MINS_PER_HOUR, 0, INT_MAX / MINS_PER_HOUR, NULL, NULL
1592 1593 1594 1595
	},

	{
		{"log_rotation_size", PGC_SIGHUP, LOGGING_WHERE,
1596
			gettext_noop("Automatic log file rotation will occur after N kilobytes."),
1597 1598
			NULL,
			GUC_UNIT_KB
1599 1600
		},
		&Log_RotationSize,
1601
		10 * 1024, 0, INT_MAX / 1024, NULL, NULL
1602 1603
	},

1604
	{
1605
		{"max_function_args", PGC_INTERNAL, PRESET_OPTIONS,
P
Peter Eisentraut 已提交
1606
			gettext_noop("Shows the maximum number of function arguments."),
1607 1608 1609 1610 1611 1612 1613 1614
			NULL,
			GUC_NOT_IN_SAMPLE | GUC_DISALLOW_IN_FILE
		},
		&max_function_args,
		FUNC_MAX_ARGS, FUNC_MAX_ARGS, FUNC_MAX_ARGS, NULL, NULL
	},

	{
1615
		{"max_index_keys", PGC_INTERNAL, PRESET_OPTIONS,
P
Peter Eisentraut 已提交
1616
			gettext_noop("Shows the maximum number of index keys."),
1617 1618 1619 1620 1621 1622 1623 1624
			NULL,
			GUC_NOT_IN_SAMPLE | GUC_DISALLOW_IN_FILE
		},
		&max_index_keys,
		INDEX_MAX_KEYS, INDEX_MAX_KEYS, INDEX_MAX_KEYS, NULL, NULL
	},

	{
1625
		{"max_identifier_length", PGC_INTERNAL, PRESET_OPTIONS,
1626
			gettext_noop("Shows the maximum identifier length."),
1627 1628 1629 1630 1631 1632 1633 1634
			NULL,
			GUC_NOT_IN_SAMPLE | GUC_DISALLOW_IN_FILE
		},
		&max_identifier_length,
		NAMEDATALEN - 1, NAMEDATALEN - 1, NAMEDATALEN - 1, NULL, NULL
	},

	{
1635
		{"block_size", PGC_INTERNAL, PRESET_OPTIONS,
1636
			gettext_noop("Shows the size of a disk block."),
1637 1638 1639 1640 1641 1642 1643
			NULL,
			GUC_NOT_IN_SAMPLE | GUC_DISALLOW_IN_FILE
		},
		&block_size,
		BLCKSZ, BLCKSZ, BLCKSZ, NULL, NULL
	},

1644 1645
	{
		{"autovacuum_naptime", PGC_SIGHUP, AUTOVACUUM,
1646
			gettext_noop("Time to sleep between autovacuum runs."),
1647 1648
			NULL,
			GUC_UNIT_S
1649 1650
		},
		&autovacuum_naptime,
1651
		60, 1, INT_MAX / 1000, NULL, NULL
1652 1653 1654 1655 1656 1657 1658
	},
	{
		{"autovacuum_vacuum_threshold", PGC_SIGHUP, AUTOVACUUM,
			gettext_noop("Minimum number of tuple updates or deletes prior to vacuum."),
			NULL
		},
		&autovacuum_vac_thresh,
1659
		500, 0, INT_MAX, NULL, NULL
1660 1661 1662 1663 1664 1665 1666
	},
	{
		{"autovacuum_analyze_threshold", PGC_SIGHUP, AUTOVACUUM,
			gettext_noop("Minimum number of tuple inserts, updates or deletes prior to analyze."),
			NULL
		},
		&autovacuum_anl_thresh,
1667
		250, 0, INT_MAX, NULL, NULL
1668
	},
1669 1670 1671
	{
		/* see varsup.c for why this is PGC_POSTMASTER not PGC_SIGHUP */
		{"autovacuum_freeze_max_age", PGC_POSTMASTER, AUTOVACUUM,
P
Peter Eisentraut 已提交
1672
			gettext_noop("Age at which to autovacuum a table to prevent transaction ID wraparound."),
1673 1674 1675 1676 1677
			NULL
		},
		&autovacuum_freeze_max_age,
		200000000, 100000000, 2000000000, NULL, NULL
	},
1678 1679 1680 1681 1682 1683 1684 1685 1686
	{
		/* see max_connections */
		{"autovacuum_max_workers", PGC_POSTMASTER, AUTOVACUUM,
			gettext_noop("Sets the maximum number of simultaneously running autovacuum worker processes."),
			NULL
		},
		&autovacuum_max_workers,
		3, 1, INT_MAX / 4, assign_autovacuum_max_workers, NULL
	},
1687

1688 1689
	{
		{"tcp_keepalives_idle", PGC_USERSET, CLIENT_CONN_OTHER,
1690
			gettext_noop("Time between issuing TCP keepalives."),
B
Bruce Momjian 已提交
1691
			gettext_noop("A value of 0 uses the system default."),
1692
			GUC_UNIT_S
B
Bruce Momjian 已提交
1693
		},
1694 1695 1696 1697 1698 1699
		&tcp_keepalives_idle,
		0, 0, INT_MAX, assign_tcp_keepalives_idle, show_tcp_keepalives_idle
	},

	{
		{"tcp_keepalives_interval", PGC_USERSET, CLIENT_CONN_OTHER,
1700
			gettext_noop("Time between TCP keepalive retransmits."),
B
Bruce Momjian 已提交
1701
			gettext_noop("A value of 0 uses the system default."),
1702
			GUC_UNIT_S
B
Bruce Momjian 已提交
1703
		},
1704 1705 1706 1707 1708 1709
		&tcp_keepalives_interval,
		0, 0, INT_MAX, assign_tcp_keepalives_interval, show_tcp_keepalives_interval
	},

	{
		{"tcp_keepalives_count", PGC_USERSET, CLIENT_CONN_OTHER,
B
Bruce Momjian 已提交
1710 1711 1712 1713 1714
			gettext_noop("Maximum number of TCP keepalive retransmits."),
			gettext_noop("This controls the number of consecutive keepalive retransmits that can be "
						 "lost before a connection is considered dead. A value of 0 uses the "
						 "system default."),
		},
1715 1716 1717 1718
		&tcp_keepalives_count,
		0, 0, INT_MAX, assign_tcp_keepalives_count, show_tcp_keepalives_count
	},

T
Teodor Sigaev 已提交
1719
	{
1720
		{"gin_fuzzy_search_limit", PGC_USERSET, CLIENT_CONN_OTHER,
P
Peter Eisentraut 已提交
1721
			gettext_noop("Sets the maximum allowed result for exact search by GIN."),
T
Teodor Sigaev 已提交
1722 1723 1724 1725 1726 1727 1728
			NULL,
			0
		},
		&GinFuzzySearchLimit,
		0, 0, INT_MAX, NULL, NULL
	},

1729 1730
	{
		{"effective_cache_size", PGC_USERSET, QUERY_TUNING_COST,
1731
			gettext_noop("Sets the planner's assumption about the size of the disk cache."),
1732 1733
			gettext_noop("That is, the portion of the kernel's disk cache that "
						 "will be used for PostgreSQL data files. This is measured in disk "
1734 1735
						 "pages, which are normally 8 kB each."),
			GUC_UNIT_BLOCKS,
1736 1737 1738 1739 1740
		},
		&effective_cache_size,
		DEFAULT_EFFECTIVE_CACHE_SIZE, 1, INT_MAX, NULL, NULL
	},

1741 1742 1743 1744 1745
	{
		/* Can't be set in postgresql.conf */
		{"server_version_num", PGC_INTERNAL, PRESET_OPTIONS,
			gettext_noop("Shows the server version as an integer."),
			NULL,
1746
			GUC_NOT_IN_SAMPLE | GUC_DISALLOW_IN_FILE
1747 1748 1749 1750
		},
		&server_version_num,
		PG_VERSION_NUM, PG_VERSION_NUM, PG_VERSION_NUM, NULL, NULL
	},
1751

1752 1753
	{
		{"log_temp_files", PGC_USERSET, LOGGING_WHAT,
1754
			gettext_noop("Log the use of temporary files larger than this number of kilobytes."),
1755
			gettext_noop("Zero logs all files. The default is -1 (turning this feature off)."),
1756
			GUC_UNIT_KB
1757 1758 1759 1760
		},
		&log_temp_files,
		-1, -1, INT_MAX, NULL, NULL
	},
1761

1762
	/* End-of-list marker */
1763
	{
1764
		{NULL, 0, 0, NULL, NULL}, NULL, 0, 0, 0, NULL, NULL
1765
	}
1766 1767 1768
};


1769
static struct config_real ConfigureNamesReal[] =
1770
{
1771
	{
1772 1773 1774 1775
		{"seq_page_cost", PGC_USERSET, QUERY_TUNING_COST,
			gettext_noop("Sets the planner's estimate of the cost of a "
						 "sequentially fetched disk page."),
			NULL
1776
		},
1777 1778
		&seq_page_cost,
		DEFAULT_SEQ_PAGE_COST, 0, DBL_MAX, NULL, NULL
1779
	},
1780
	{
1781
		{"random_page_cost", PGC_USERSET, QUERY_TUNING_COST,
1782 1783 1784
			gettext_noop("Sets the planner's estimate of the cost of a "
						 "nonsequentially fetched disk page."),
			NULL
1785 1786
		},
		&random_page_cost,
1787
		DEFAULT_RANDOM_PAGE_COST, 0, DBL_MAX, NULL, NULL
1788 1789
	},
	{
1790
		{"cpu_tuple_cost", PGC_USERSET, QUERY_TUNING_COST,
1791 1792 1793
			gettext_noop("Sets the planner's estimate of the cost of "
						 "processing each tuple (row)."),
			NULL
1794 1795
		},
		&cpu_tuple_cost,
1796
		DEFAULT_CPU_TUPLE_COST, 0, DBL_MAX, NULL, NULL
1797 1798
	},
	{
1799
		{"cpu_index_tuple_cost", PGC_USERSET, QUERY_TUNING_COST,
1800 1801 1802
			gettext_noop("Sets the planner's estimate of the cost of "
						 "processing each index entry during an index scan."),
			NULL
1803 1804
		},
		&cpu_index_tuple_cost,
1805
		DEFAULT_CPU_INDEX_TUPLE_COST, 0, DBL_MAX, NULL, NULL
1806 1807
	},
	{
1808
		{"cpu_operator_cost", PGC_USERSET, QUERY_TUNING_COST,
1809 1810 1811
			gettext_noop("Sets the planner's estimate of the cost of "
						 "processing each operator or function call."),
			NULL
1812 1813
		},
		&cpu_operator_cost,
1814
		DEFAULT_CPU_OPERATOR_COST, 0, DBL_MAX, NULL, NULL
1815 1816 1817
	},

	{
1818
		{"geqo_selection_bias", PGC_USERSET, QUERY_TUNING_GEQO,
1819
			gettext_noop("GEQO: selective pressure within the population."),
1820 1821 1822
			NULL
		},
		&Geqo_selection_bias,
1823 1824
		DEFAULT_GEQO_SELECTION_BIAS, MIN_GEQO_SELECTION_BIAS,
		MAX_GEQO_SELECTION_BIAS, NULL, NULL
1825 1826
	},

1827 1828
	{
		{"bgwriter_lru_percent", PGC_SIGHUP, RESOURCES,
1829
			gettext_noop("Background writer percentage of LRU buffers to flush per round."),
1830 1831 1832 1833 1834 1835
			NULL
		},
		&bgwriter_lru_percent,
		1.0, 0.0, 100.0, NULL, NULL
	},

1836
	{
1837
		{"seed", PGC_USERSET, UNGROUPED,
1838
			gettext_noop("Sets the seed for random-number generation."),
1839 1840 1841
			NULL,
			GUC_NO_SHOW_ALL | GUC_NO_RESET_ALL | GUC_NOT_IN_SAMPLE | GUC_DISALLOW_IN_FILE
		},
1842 1843 1844 1845
		&phony_random_seed,
		0.5, 0.0, 1.0, assign_random_seed, show_random_seed
	},

1846 1847 1848 1849 1850 1851
	{
		{"autovacuum_vacuum_scale_factor", PGC_SIGHUP, AUTOVACUUM,
			gettext_noop("Number of tuple updates or deletes prior to vacuum as a fraction of reltuples."),
			NULL
		},
		&autovacuum_vac_scale,
1852
		0.2, 0.0, 100.0, NULL, NULL
1853 1854 1855 1856 1857 1858 1859
	},
	{
		{"autovacuum_analyze_scale_factor", PGC_SIGHUP, AUTOVACUUM,
			gettext_noop("Number of tuple inserts, updates or deletes prior to analyze as a fraction of reltuples."),
			NULL
		},
		&autovacuum_anl_scale,
1860
		0.1, 0.0, 100.0, NULL, NULL
1861 1862
	},

1863 1864 1865 1866 1867 1868 1869 1870 1871
	{
		{"checkpoint_completion_target", PGC_SIGHUP, WAL_CHECKPOINTS,
			gettext_noop("Time spent flushing dirty buffers during checkpoint, as fraction of checkpoint interval."),
			NULL
		},
		&CheckPointCompletionTarget,
		0.5, 0.0, 1.0, NULL, NULL
	},

1872
	/* End-of-list marker */
1873
	{
1874
		{NULL, 0, 0, NULL, NULL}, NULL, 0.0, 0.0, 0.0, NULL, NULL
1875
	}
1876 1877 1878
};


1879
static struct config_string ConfigureNamesString[] =
1880
{
B
Bruce Momjian 已提交
1881 1882
	{
		{"archive_command", PGC_SIGHUP, WAL_SETTINGS,
1883 1884
			gettext_noop("Sets the shell command that will be called to archive a WAL file."),
			NULL
B
Bruce Momjian 已提交
1885 1886 1887 1888
		},
		&XLogArchiveCommand,
		"", NULL, NULL
	},
1889

1890 1891 1892 1893 1894 1895 1896 1897 1898
	{
		{"backslash_quote", PGC_USERSET, COMPAT_OPTIONS_PREVIOUS,
			gettext_noop("Sets whether \"\\'\" is allowed in string literals."),
			gettext_noop("Valid values are ON, OFF, and SAFE_ENCODING.")
		},
		&backslash_quote_string,
		"safe_encoding", assign_backslash_quote, NULL
	},

1899
	{
1900
		{"client_encoding", PGC_USERSET, CLIENT_CONN_LOCALE,
1901
			gettext_noop("Sets the client's character set encoding."),
1902
			NULL,
1903
			GUC_IS_NAME | GUC_REPORT
1904
		},
1905
		&client_encoding_string,
1906
		"SQL_ASCII", assign_client_encoding, NULL
1907 1908
	},

1909
	{
1910
		{"client_min_messages", PGC_USERSET, LOGGING_WHEN,
1911
			gettext_noop("Sets the message levels that are sent to the client."),
1912 1913 1914 1915 1916 1917
			gettext_noop("Valid values are DEBUG5, DEBUG4, DEBUG3, DEBUG2, "
						 "DEBUG1, LOG, NOTICE, WARNING, and ERROR. Each level includes all the "
						 "levels that follow it. The later the level, the fewer messages are "
						 "sent.")
		},
		&client_min_messages_str,
1918
		"notice", assign_client_min_messages, NULL
1919
	},
1920

1921
	{
1922
		{"log_min_messages", PGC_SUSET, LOGGING_WHEN,
1923
			gettext_noop("Sets the message levels that are logged."),
1924
			gettext_noop("Valid values are DEBUG5, DEBUG4, DEBUG3, DEBUG2, DEBUG1, "
B
Bruce Momjian 已提交
1925
			"INFO, NOTICE, WARNING, ERROR, LOG, FATAL, and PANIC. Each level "
1926
						 "includes all the levels that follow it.")
1927 1928
		},
		&log_min_messages_str,
1929 1930 1931 1932
		"notice", assign_log_min_messages, NULL
	},

	{
1933
		{"log_error_verbosity", PGC_SUSET, LOGGING_WHEN,
1934
			gettext_noop("Sets the verbosity of logged messages."),
1935
			gettext_noop("Valid values are \"terse\", \"default\", and \"verbose\".")
1936 1937
		},
		&log_error_verbosity_str,
1938 1939
		"default", assign_log_error_verbosity, NULL
	},
1940
	{
1941
		{"log_statement", PGC_SUSET, LOGGING_WHAT,
1942
			gettext_noop("Sets the type of statements logged."),
1943
			gettext_noop("Valid values are \"none\", \"ddl\", \"mod\", and \"all\".")
1944 1945 1946 1947
		},
		&log_statement_str,
		"none", assign_log_statement, NULL
	},
1948

1949
	{
1950
		{"log_min_error_statement", PGC_SUSET, LOGGING_WHEN,
1951
			gettext_noop("Causes all statements generating error at or above this level to be logged."),
1952
			gettext_noop("All SQL statements that cause an error of the "
1953
						 "specified level or a higher level are logged.")
1954 1955
		},
		&log_min_error_statement_str,
1956
		"error", assign_min_error_statement, NULL
1957 1958
	},

B
Add:  
Bruce Momjian 已提交
1959 1960
	{
		{"log_line_prefix", PGC_SIGHUP, LOGGING_WHAT,
1961 1962
			gettext_noop("Controls information prefixed to each log line."),
			gettext_noop("If blank, no prefix is used.")
B
Add:  
Bruce Momjian 已提交
1963 1964 1965 1966 1967 1968
		},
		&Log_line_prefix,
		"", NULL, NULL
	},


1969
	{
1970
		{"DateStyle", PGC_USERSET, CLIENT_CONN_LOCALE,
1971
			gettext_noop("Sets the display format for date and time values."),
1972
			gettext_noop("Also controls interpretation of ambiguous "
1973
						 "date inputs."),
1974 1975
			GUC_LIST_INPUT | GUC_REPORT
		},
1976
		&datestyle_string,
1977
		"ISO, MDY", assign_datestyle, NULL
1978
	},
1979

1980 1981 1982
	{
		{"default_tablespace", PGC_USERSET, CLIENT_CONN_STATEMENT,
			gettext_noop("Sets the default tablespace to create tables and indexes in."),
1983
			gettext_noop("An empty string selects the database's default tablespace."),
B
Bruce Momjian 已提交
1984
			GUC_IS_NAME
1985 1986 1987 1988 1989
		},
		&default_tablespace,
		"", assign_default_tablespace, NULL
	},

1990 1991 1992 1993 1994 1995 1996 1997 1998 1999
	{
		{"temp_tablespaces", PGC_USERSET, CLIENT_CONN_STATEMENT,
			gettext_noop("Sets the tablespace(s) to use for temporary tables and sort files."),
			NULL,
			GUC_LIST_INPUT | GUC_LIST_QUOTE
		},
		&temp_tablespaces,
		"", assign_temp_tablespaces, NULL
	},

2000
	{
2001
		{"default_transaction_isolation", PGC_USERSET, CLIENT_CONN_STATEMENT,
2002
			gettext_noop("Sets the transaction isolation level of each new transaction."),
2003
			gettext_noop("Each SQL transaction has an isolation level, which "
B
Bruce Momjian 已提交
2004
						 "can be either \"read uncommitted\", \"read committed\", \"repeatable read\", or \"serializable\".")
2005 2006
		},
		&default_iso_level_string,
2007
		"read committed", assign_defaultxactisolevel, NULL
2008 2009
	},

2010 2011
	{
		{"session_replication_role", PGC_SUSET, CLIENT_CONN_STATEMENT,
2012
			gettext_noop("Sets the sessions behavior for triggers and rewrite rules."),
2013 2014 2015 2016 2017 2018 2019
			gettext_noop("Each session can be either"
						 " \"origin\", \"replica\" or \"local\".")
		},
		&session_replication_role_string,
		"origin", assign_session_replication_role, NULL
	},

2020
	{
2021
		{"dynamic_library_path", PGC_SUSET, CLIENT_CONN_OTHER,
2022
			gettext_noop("Sets the path for dynamically loadable modules."),
2023
			gettext_noop("If a dynamically loadable module needs to be opened and "
2024
						 "the specified name does not have a directory component (i.e., the "
2025
						 "name does not contain a slash), the system will search this path for "
2026 2027
						 "the specified file."),
			GUC_SUPERUSER_ONLY
2028 2029
		},
		&Dynamic_library_path,
2030
		"$libdir", NULL, NULL
2031 2032 2033
	},

	{
2034
		{"krb_server_keyfile", PGC_POSTMASTER, CONN_AUTH_SECURITY,
2035
			gettext_noop("Sets the location of the Kerberos server key file."),
2036 2037
			NULL,
			GUC_SUPERUSER_ONLY
2038 2039
		},
		&pg_krb_server_keyfile,
2040
		PG_KRB_SRVTAB, NULL, NULL
2041
	},
2042

B
 
Bruce Momjian 已提交
2043 2044 2045 2046 2047 2048 2049 2050 2051
	{
		{"krb_srvname", PGC_POSTMASTER, CONN_AUTH_SECURITY,
			gettext_noop("Sets the name of the Kerberos service."),
			NULL
		},
		&pg_krb_srvnam,
		PG_KRB_SRVNAM, NULL, NULL
	},

2052 2053 2054 2055 2056 2057 2058 2059 2060
	{
		{"krb_server_hostname", PGC_POSTMASTER, CONN_AUTH_SECURITY,
			gettext_noop("Sets the hostname of the Kerberos server."),
			NULL
		},
		&pg_krb_server_hostname,
		NULL, NULL, NULL
	},

2061
	{
2062 2063
		{"bonjour_name", PGC_POSTMASTER, CONN_AUTH_SETTINGS,
			gettext_noop("Sets the Bonjour broadcast service name."),
2064 2065
			NULL
		},
2066
		&bonjour_name,
2067 2068 2069
		"", NULL, NULL
	},

2070 2071
	/* See main.c about why defaults for LC_foo are not all alike */

2072
	{
2073
		{"lc_collate", PGC_INTERNAL, CLIENT_CONN_LOCALE,
2074
			gettext_noop("Shows the collation order locale."),
2075 2076 2077 2078
			NULL,
			GUC_NOT_IN_SAMPLE | GUC_DISALLOW_IN_FILE
		},
		&locale_collate,
2079 2080 2081 2082
		"C", NULL, NULL
	},

	{
2083
		{"lc_ctype", PGC_INTERNAL, CLIENT_CONN_LOCALE,
2084
			gettext_noop("Shows the character classification and case conversion locale."),
2085 2086 2087 2088
			NULL,
			GUC_NOT_IN_SAMPLE | GUC_DISALLOW_IN_FILE
		},
		&locale_ctype,
2089 2090 2091
		"C", NULL, NULL
	},

2092
	{
2093
		{"lc_messages", PGC_SUSET, CLIENT_CONN_LOCALE,
2094
			gettext_noop("Sets the language in which messages are displayed."),
2095 2096 2097
			NULL
		},
		&locale_messages,
2098 2099 2100 2101
		"", locale_messages_assign, NULL
	},

	{
2102
		{"lc_monetary", PGC_USERSET, CLIENT_CONN_LOCALE,
2103
			gettext_noop("Sets the locale for formatting monetary amounts."),
2104 2105 2106
			NULL
		},
		&locale_monetary,
2107
		"C", locale_monetary_assign, NULL
2108 2109 2110
	},

	{
2111
		{"lc_numeric", PGC_USERSET, CLIENT_CONN_LOCALE,
2112
			gettext_noop("Sets the locale for formatting numbers."),
2113 2114 2115
			NULL
		},
		&locale_numeric,
2116
		"C", locale_numeric_assign, NULL
2117 2118 2119
	},

	{
2120
		{"lc_time", PGC_USERSET, CLIENT_CONN_LOCALE,
2121
			gettext_noop("Sets the locale for formatting date and time values."),
2122 2123 2124
			NULL
		},
		&locale_time,
2125
		"C", locale_time_assign, NULL
2126 2127
	},

2128
	{
2129
		{"shared_preload_libraries", PGC_POSTMASTER, RESOURCES_KERNEL,
2130
			gettext_noop("Lists shared libraries to preload into server."),
2131
			NULL,
2132
			GUC_LIST_INPUT | GUC_LIST_QUOTE | GUC_SUPERUSER_ONLY
2133
		},
2134 2135 2136 2137 2138 2139 2140 2141 2142 2143 2144
		&shared_preload_libraries_string,
		"", NULL, NULL
	},

	{
		{"local_preload_libraries", PGC_BACKEND, CLIENT_CONN_OTHER,
			gettext_noop("Lists shared libraries to preload into each backend."),
			NULL,
			GUC_LIST_INPUT | GUC_LIST_QUOTE
		},
		&local_preload_libraries_string,
2145
		"", NULL, NULL
2146 2147
	},

2148
	{
2149
		{"regex_flavor", PGC_USERSET, COMPAT_OPTIONS_PREVIOUS,
2150
			gettext_noop("Sets the regular expression \"flavor\"."),
2151
			gettext_noop("This can be set to advanced, extended, or basic.")
2152 2153
		},
		&regex_flavor_string,
2154 2155 2156
		"advanced", assign_regex_flavor, NULL
	},

2157
	{
2158
		{"search_path", PGC_USERSET, CLIENT_CONN_STATEMENT,
2159
			gettext_noop("Sets the schema search order for names that are not schema-qualified."),
2160 2161 2162
			NULL,
			GUC_LIST_INPUT | GUC_LIST_QUOTE
		},
2163
		&namespace_search_path,
2164
		"\"$user\",public", assign_search_path, NULL
2165 2166 2167
	},

	{
2168 2169
		/* Can't be set in postgresql.conf */
		{"server_encoding", PGC_INTERNAL, CLIENT_CONN_LOCALE,
2170
			gettext_noop("Sets the server (database) character set encoding."),
2171
			NULL,
2172
			GUC_IS_NAME | GUC_REPORT | GUC_NOT_IN_SAMPLE | GUC_DISALLOW_IN_FILE
2173
		},
2174 2175 2176 2177 2178
		&server_encoding_string,
		"SQL_ASCII", NULL, NULL
	},

	{
2179
		/* Can't be set in postgresql.conf */
2180
		{"server_version", PGC_INTERNAL, PRESET_OPTIONS,
2181
			gettext_noop("Shows the server version."),
2182 2183 2184
			NULL,
			GUC_REPORT | GUC_NOT_IN_SAMPLE | GUC_DISALLOW_IN_FILE
		},
2185 2186
		&server_version_string,
		PG_VERSION, NULL, NULL
2187 2188
	},

2189 2190 2191 2192 2193
	{
		/* Not for general use --- used by SET ROLE */
		{"role", PGC_USERSET, UNGROUPED,
			gettext_noop("Sets the current role."),
			NULL,
2194
			GUC_IS_NAME | GUC_NO_SHOW_ALL | GUC_NO_RESET_ALL | GUC_NOT_IN_SAMPLE | GUC_DISALLOW_IN_FILE
2195 2196 2197 2198 2199
		},
		&role_string,
		"none", assign_role, show_role
	},

2200
	{
2201 2202
		/* Not for general use --- used by SET SESSION AUTHORIZATION */
		{"session_authorization", PGC_USERSET, UNGROUPED,
2203
			gettext_noop("Sets the session user name."),
2204
			NULL,
2205
			GUC_IS_NAME | GUC_REPORT | GUC_NO_SHOW_ALL | GUC_NO_RESET_ALL | GUC_NOT_IN_SAMPLE | GUC_DISALLOW_IN_FILE
2206
		},
2207 2208
		&session_authorization_string,
		NULL, assign_session_authorization, show_session_authorization
2209 2210
	},

2211
	{
2212
		{"log_destination", PGC_SIGHUP, LOGGING_WHERE,
B
Bruce Momjian 已提交
2213
			gettext_noop("Sets the destination for server log output."),
P
Peter Eisentraut 已提交
2214 2215
			gettext_noop("Valid values are combinations of \"stderr\", \"syslog\", "
						 "and \"eventlog\", depending on the platform."),
B
Bruce Momjian 已提交
2216
			GUC_LIST_INPUT
2217 2218 2219 2220
		},
		&log_destination_string,
		"stderr", assign_log_destination, NULL
	},
2221 2222
	{
		{"log_directory", PGC_SIGHUP, LOGGING_WHERE,
2223
			gettext_noop("Sets the destination directory for log files."),
2224
			gettext_noop("Can be specified as relative to the data directory "
2225 2226
						 "or as absolute path."),
			GUC_SUPERUSER_ONLY
2227 2228
		},
		&Log_directory,
2229
		"pg_log", assign_canonical_path, NULL
2230 2231
	},
	{
2232 2233
		{"log_filename", PGC_SIGHUP, LOGGING_WHERE,
			gettext_noop("Sets the file name pattern for log files."),
2234 2235
			NULL,
			GUC_SUPERUSER_ONLY
2236
		},
2237 2238
		&Log_filename,
		"postgresql-%Y-%m-%d_%H%M%S.log", NULL, NULL
2239
	},
2240

T
Tatsuo Ishii 已提交
2241
#ifdef HAVE_SYSLOG
2242
	{
2243
		{"syslog_facility", PGC_SIGHUP, LOGGING_WHERE,
2244
			gettext_noop("Sets the syslog \"facility\" to be used when syslog enabled."),
2245 2246
			gettext_noop("Valid values are LOCAL0, LOCAL1, LOCAL2, LOCAL3, "
						 "LOCAL4, LOCAL5, LOCAL6, LOCAL7.")
2247
		},
2248 2249
		&syslog_facility_str,
		"LOCAL0", assign_syslog_facility, NULL
2250 2251
	},
	{
2252 2253 2254
		{"syslog_ident", PGC_SIGHUP, LOGGING_WHERE,
			gettext_noop("Sets the program name used to identify PostgreSQL "
						 "messages in syslog."),
2255 2256
			NULL
		},
2257 2258
		&syslog_ident_str,
		"postgres", assign_syslog_ident, NULL
2259
	},
2260
#endif
2261

2262
	{
2263
		{"TimeZone", PGC_USERSET, CLIENT_CONN_LOCALE,
2264
			gettext_noop("Sets the time zone for displaying and interpreting time stamps."),
2265 2266
			NULL,
			GUC_REPORT
2267 2268
		},
		&timezone_string,
2269 2270
		"UNKNOWN", assign_timezone, show_timezone
	},
2271 2272
	{
		{"timezone_abbreviations", PGC_USERSET, CLIENT_CONN_LOCALE,
2273
			gettext_noop("Selects a file of time zone abbreviations."),
2274 2275
			NULL,
		},
2276 2277
		&timezone_abbreviations_string,
		"UNKNOWN", assign_timezone_abbreviations, NULL
2278
	},
2279 2280

	{
2281
		{"transaction_isolation", PGC_USERSET, CLIENT_CONN_STATEMENT,
2282
			gettext_noop("Sets the current transaction's isolation level."),
2283 2284 2285
			NULL,
			GUC_NO_RESET_ALL | GUC_NOT_IN_SAMPLE | GUC_DISALLOW_IN_FILE
		},
2286 2287 2288 2289 2290
		&XactIsoLevel_string,
		NULL, assign_XactIsoLevel, show_XactIsoLevel
	},

	{
2291
		{"unix_socket_group", PGC_POSTMASTER, CONN_AUTH_SETTINGS,
2292
			gettext_noop("Sets the owning group of the Unix-domain socket."),
2293 2294
			gettext_noop("The owning user of the socket is always the user "
						 "that starts the server.")
2295 2296
		},
		&Unix_socket_group,
2297
		"", NULL, NULL
2298
	},
2299

2300
	{
2301
		{"unix_socket_directory", PGC_POSTMASTER, CONN_AUTH_SETTINGS,
2302
			gettext_noop("Sets the directory where the Unix-domain socket will be created."),
2303 2304
			NULL,
			GUC_SUPERUSER_ONLY
2305 2306
		},
		&UnixSocketDir,
2307
		"", assign_canonical_path, NULL
2308
	},
2309

2310
	{
2311
		{"listen_addresses", PGC_POSTMASTER, CONN_AUTH_SETTINGS,
2312 2313 2314
			gettext_noop("Sets the host name or IP address(es) to listen to."),
			NULL,
			GUC_LIST_INPUT
2315
		},
2316 2317
		&ListenAddresses,
		"localhost", NULL, NULL
2318
	},
2319

2320
	{
2321
		{"wal_sync_method", PGC_SIGHUP, WAL_SETTINGS,
2322
			gettext_noop("Selects the method used for forcing WAL updates to disk."),
2323 2324 2325
			NULL
		},
		&XLOG_sync_method,
2326
		XLOG_sync_method_default, assign_xlog_sync_method, NULL
2327
	},
2328

2329
	{
2330
		{"custom_variable_classes", PGC_SIGHUP, CUSTOM_OPTIONS,
2331
			gettext_noop("Sets the list of known custom variable classes."),
2332 2333 2334 2335 2336 2337 2338
			NULL,
			GUC_LIST_INPUT | GUC_LIST_QUOTE
		},
		&custom_variable_classes,
		NULL, assign_custom_variable_classes, NULL
	},

2339
	{
2340
		{"data_directory", PGC_POSTMASTER, FILE_LOCATIONS,
B
Bruce Momjian 已提交
2341 2342 2343
			gettext_noop("Sets the server's data directory."),
			NULL,
			GUC_SUPERUSER_ONLY
2344
		},
2345 2346
		&data_directory,
		NULL, NULL, NULL
2347 2348 2349
	},

	{
2350
		{"config_file", PGC_POSTMASTER, FILE_LOCATIONS,
B
Bruce Momjian 已提交
2351 2352 2353
			gettext_noop("Sets the server's main configuration file."),
			NULL,
			GUC_DISALLOW_IN_FILE | GUC_SUPERUSER_ONLY
2354 2355 2356 2357 2358 2359 2360
		},
		&ConfigFileName,
		NULL, NULL, NULL
	},

	{
		{"hba_file", PGC_POSTMASTER, FILE_LOCATIONS,
2361
			gettext_noop("Sets the server's \"hba\" configuration file."),
B
Bruce Momjian 已提交
2362 2363
			NULL,
			GUC_SUPERUSER_ONLY
2364
		},
2365 2366
		&HbaFileName,
		NULL, NULL, NULL
2367 2368 2369
	},

	{
2370
		{"ident_file", PGC_POSTMASTER, FILE_LOCATIONS,
2371
			gettext_noop("Sets the server's \"ident\" configuration file."),
B
Bruce Momjian 已提交
2372 2373
			NULL,
			GUC_SUPERUSER_ONLY
2374
		},
2375 2376
		&IdentFileName,
		NULL, NULL, NULL
2377 2378 2379
	},

	{
2380
		{"external_pid_file", PGC_POSTMASTER, FILE_LOCATIONS,
B
Bruce Momjian 已提交
2381 2382 2383
			gettext_noop("Writes the postmaster PID to the specified file."),
			NULL,
			GUC_SUPERUSER_ONLY
2384
		},
2385
		&external_pid_file,
2386
		NULL, assign_canonical_path, NULL
2387 2388
	},

2389 2390 2391 2392 2393 2394 2395 2396 2397
	{
		{"xmlbinary", PGC_USERSET, CLIENT_CONN_STATEMENT,
			gettext_noop("Sets how binary values are to be encoded in XML."),
			gettext_noop("Valid values are BASE64 and HEX.")
		},
		&xmlbinary_string,
		"base64", assign_xmlbinary, NULL
	},

2398 2399 2400 2401 2402 2403 2404 2405 2406 2407
	{
		{"xmloption", PGC_USERSET, CLIENT_CONN_STATEMENT,
			gettext_noop("Sets whether XML data in implicit parsing and serialization "
						 "operations is to be considered as documents or content fragments."),
			gettext_noop("Valid values are DOCUMENT and CONTENT.")
		},
		&xmloption_string,
		"content", assign_xmloption, NULL
	},

T
Tom Lane 已提交
2408
#ifdef USE_SSL
B
Bruce Momjian 已提交
2409 2410 2411 2412 2413 2414 2415 2416 2417
	{
		{"ssl_ciphers", PGC_POSTMASTER, CONN_AUTH_SECURITY,
			gettext_noop("Sets the list of allowed SSL ciphers."),
			NULL,
			GUC_SUPERUSER_ONLY
		},
		&SSLCipherSuites,
		"ALL:!ADH:!LOW:!EXP:!MD5:@STRENGTH", NULL, NULL
	},
T
Tom Lane 已提交
2418 2419
#endif /* USE_SSL */

2420
	/* End-of-list marker */
2421
	{
2422
		{NULL, 0, 0, NULL, NULL}, NULL, NULL, NULL, NULL
2423
	}
2424 2425 2426
};


2427
/******** end of options list ********/
2428

B
Bruce Momjian 已提交
2429

2430 2431 2432 2433 2434 2435
/*
 * To allow continued support of obsolete names for GUC variables, we apply
 * the following mappings to any unrecognized name.  Note that an old name
 * should be mapped to a new one only if the new variable has very similar
 * semantics to the old.
 */
B
Bruce Momjian 已提交
2436
static const char *const map_old_guc_names[] = {
2437 2438 2439 2440 2441 2442
	"sort_mem", "work_mem",
	"vacuum_mem", "maintenance_work_mem",
	NULL
};


2443
/*
2444
 * Actual lookup of variables is done through this single, sorted array.
2445
 */
2446 2447
static struct config_generic **guc_variables;

2448
/* Current number of variables contained in the vector */
B
Bruce Momjian 已提交
2449
static int	num_guc_variables;
2450

2451
/* Vector capacity */
B
Bruce Momjian 已提交
2452
static int	size_guc_variables;
2453

2454

2455
static bool guc_dirty;			/* TRUE if need to do commit/abort work */
2456

2457 2458
static bool reporting_enabled;	/* TRUE to enable GUC_REPORT */

2459

B
Bruce Momjian 已提交
2460
static int	guc_var_compare(const void *a, const void *b);
2461
static int	guc_name_compare(const char *namea, const char *nameb);
B
Bruce Momjian 已提交
2462
static void push_old_value(struct config_generic * gconf);
2463
static void ReportGUCOption(struct config_generic * record);
2464 2465
static void ShowGUCConfigOption(const char *name, DestReceiver *dest);
static void ShowAllGUCConfig(DestReceiver *dest);
2466
static char *_ShowOption(struct config_generic * record, bool use_units);
B
Bruce Momjian 已提交
2467
static bool is_newvalue_equal(struct config_generic * record, const char *newvalue);
2468

2469

2470 2471 2472 2473 2474 2475
/*
 * Some infrastructure for checking malloc/strdup/realloc calls
 */
static void *
guc_malloc(int elevel, size_t size)
{
B
Bruce Momjian 已提交
2476
	void	   *data;
2477 2478 2479 2480 2481 2482 2483 2484 2485 2486 2487 2488

	data = malloc(size);
	if (data == NULL)
		ereport(elevel,
				(errcode(ERRCODE_OUT_OF_MEMORY),
				 errmsg("out of memory")));
	return data;
}

static void *
guc_realloc(int elevel, void *old, size_t size)
{
B
Bruce Momjian 已提交
2489
	void	   *data;
2490 2491 2492 2493 2494 2495 2496 2497 2498 2499 2500 2501

	data = realloc(old, size);
	if (data == NULL)
		ereport(elevel,
				(errcode(ERRCODE_OUT_OF_MEMORY),
				 errmsg("out of memory")));
	return data;
}

static char *
guc_strdup(int elevel, const char *src)
{
B
Bruce Momjian 已提交
2502
	char	   *data;
2503 2504 2505 2506 2507 2508 2509 2510 2511 2512

	data = strdup(src);
	if (data == NULL)
		ereport(elevel,
				(errcode(ERRCODE_OUT_OF_MEMORY),
				 errmsg("out of memory")));
	return data;
}


2513 2514 2515 2516 2517 2518
/*
 * Support for assigning to a field of a string GUC item.  Free the prior
 * value if it's not referenced anywhere else in the item (including stacked
 * states).
 */
static void
2519
set_string_field(struct config_string * conf, char **field, char *newval)
2520
{
B
Bruce Momjian 已提交
2521 2522
	char	   *oldval = *field;
	GucStack   *stack;
2523 2524 2525 2526 2527 2528 2529 2530

	/* Do the assignment */
	*field = newval;

	/* Exit if any duplicate references, or if old value was NULL anyway */
	if (oldval == NULL ||
		oldval == *(conf->variable) ||
		oldval == conf->reset_val ||
2531 2532
		oldval == conf->tentative_val ||
		oldval == conf->boot_val)
2533 2534 2535 2536 2537 2538 2539 2540 2541 2542 2543 2544 2545 2546 2547 2548
		return;
	for (stack = conf->gen.stack; stack; stack = stack->prev)
	{
		if (oldval == stack->tentative_val.stringval ||
			oldval == stack->value.stringval)
			return;
	}

	/* Not used anymore, so free it */
	free(oldval);
}

/*
 * Detect whether strval is referenced anywhere in a GUC string item
 */
static bool
B
Bruce Momjian 已提交
2549
string_field_used(struct config_string * conf, char *strval)
2550
{
B
Bruce Momjian 已提交
2551
	GucStack   *stack;
2552 2553 2554

	if (strval == *(conf->variable) ||
		strval == conf->reset_val ||
2555 2556
		strval == conf->tentative_val ||
		strval == conf->boot_val)
2557 2558 2559 2560 2561 2562 2563 2564 2565 2566 2567 2568 2569
		return true;
	for (stack = conf->gen.stack; stack; stack = stack->prev)
	{
		if (strval == stack->tentative_val.stringval ||
			strval == stack->value.stringval)
			return true;
	}
	return false;
}


struct config_generic **
get_guc_variables(void)
2570 2571 2572
{
	return guc_variables;
}
2573

2574

2575
/*
B
Bruce Momjian 已提交
2576
 * Build the sorted array.	This is split out so that it could be
2577 2578
 * re-executed after startup (eg, we could allow loadable modules to
 * add vars, and then we'd need to re-sort).
2579
 */
2580
void
2581
build_guc_variables(void)
2582
{
B
Bruce Momjian 已提交
2583
	int			size_vars;
2584 2585
	int			num_vars = 0;
	struct config_generic **guc_vars;
B
Bruce Momjian 已提交
2586
	int			i;
2587

2588
	for (i = 0; ConfigureNamesBool[i].gen.name; i++)
2589 2590 2591
	{
		struct config_bool *conf = &ConfigureNamesBool[i];

2592 2593 2594
		/* Rather than requiring vartype to be filled in by hand, do this: */
		conf->gen.vartype = PGC_BOOL;
		num_vars++;
2595
	}
2596

2597
	for (i = 0; ConfigureNamesInt[i].gen.name; i++)
2598 2599 2600
	{
		struct config_int *conf = &ConfigureNamesInt[i];

2601 2602
		conf->gen.vartype = PGC_INT;
		num_vars++;
2603
	}
2604

2605
	for (i = 0; ConfigureNamesReal[i].gen.name; i++)
2606 2607 2608
	{
		struct config_real *conf = &ConfigureNamesReal[i];

2609 2610
		conf->gen.vartype = PGC_REAL;
		num_vars++;
2611
	}
2612

2613
	for (i = 0; ConfigureNamesString[i].gen.name; i++)
2614
	{
2615
		struct config_string *conf = &ConfigureNamesString[i];
2616

2617 2618
		conf->gen.vartype = PGC_STRING;
		num_vars++;
2619 2620
	}

B
Bruce Momjian 已提交
2621 2622
	/*
	 * Create table with 20% slack
2623 2624 2625
	 */
	size_vars = num_vars + num_vars / 4;

2626
	guc_vars = (struct config_generic **)
2627
		guc_malloc(FATAL, size_vars * sizeof(struct config_generic *));
2628

2629
	num_vars = 0;
2630

2631
	for (i = 0; ConfigureNamesBool[i].gen.name; i++)
B
Bruce Momjian 已提交
2632
		guc_vars[num_vars++] = &ConfigureNamesBool[i].gen;
2633

2634
	for (i = 0; ConfigureNamesInt[i].gen.name; i++)
B
Bruce Momjian 已提交
2635
		guc_vars[num_vars++] = &ConfigureNamesInt[i].gen;
2636

2637
	for (i = 0; ConfigureNamesReal[i].gen.name; i++)
B
Bruce Momjian 已提交
2638
		guc_vars[num_vars++] = &ConfigureNamesReal[i].gen;
2639

2640
	for (i = 0; ConfigureNamesString[i].gen.name; i++)
B
Bruce Momjian 已提交
2641
		guc_vars[num_vars++] = &ConfigureNamesString[i].gen;
2642

2643 2644 2645 2646
	if (guc_variables)
		free(guc_variables);
	guc_variables = guc_vars;
	num_guc_variables = num_vars;
2647
	size_guc_variables = size_vars;
B
Bruce Momjian 已提交
2648 2649
	qsort((void *) guc_variables, num_guc_variables,
		  sizeof(struct config_generic *), guc_var_compare);
2650 2651
}

2652 2653 2654
static bool
is_custom_class(const char *name, int dotPos)
{
B
Bruce Momjian 已提交
2655
	/*
B
Bruce Momjian 已提交
2656 2657
	 * assign_custom_variable_classes() has made sure no empty identifiers or
	 * whitespace exists in the variable
2658
	 */
B
Bruce Momjian 已提交
2659
	bool		result = false;
2660
	const char *ccs = GetConfigOption("custom_variable_classes");
B
Bruce Momjian 已提交
2661 2662

	if (ccs != NULL)
2663 2664
	{
		const char *start = ccs;
B
Bruce Momjian 已提交
2665 2666

		for (;; ++ccs)
2667
		{
B
Bruce Momjian 已提交
2668 2669 2670
			int			c = *ccs;

			if (c == 0 || c == ',')
2671
			{
B
Bruce Momjian 已提交
2672
				if (dotPos == ccs - start && strncmp(start, name, dotPos) == 0)
2673 2674 2675 2676
				{
					result = true;
					break;
				}
B
Bruce Momjian 已提交
2677
				if (c == 0)
2678 2679 2680 2681 2682 2683 2684 2685 2686 2687 2688 2689
					break;
				start = ccs + 1;
			}
		}
	}
	return result;
}

/*
 * Add a new GUC variable to the list of known variables. The
 * list is expanded if needed.
 */
2690
static bool
B
Bruce Momjian 已提交
2691
add_guc_variable(struct config_generic * var, int elevel)
2692
{
B
Bruce Momjian 已提交
2693
	if (num_guc_variables + 1 >= size_guc_variables)
2694
	{
B
Bruce Momjian 已提交
2695 2696
		/*
		 * Increase the vector by 25%
2697
		 */
B
Bruce Momjian 已提交
2698 2699
		int			size_vars = size_guc_variables + size_guc_variables / 4;
		struct config_generic **guc_vars;
2700

B
Bruce Momjian 已提交
2701
		if (size_vars == 0)
2702
		{
2703
			size_vars = 100;
B
Bruce Momjian 已提交
2704 2705
			guc_vars = (struct config_generic **)
				guc_malloc(elevel, size_vars * sizeof(struct config_generic *));
2706 2707
		}
		else
2708
		{
B
Bruce Momjian 已提交
2709 2710
			guc_vars = (struct config_generic **)
				guc_realloc(elevel, guc_variables, size_vars * sizeof(struct config_generic *));
2711 2712
		}

B
Bruce Momjian 已提交
2713
		if (guc_vars == NULL)
2714 2715
			return false;		/* out of memory */

2716 2717 2718 2719
		guc_variables = guc_vars;
		size_guc_variables = size_vars;
	}
	guc_variables[num_guc_variables++] = var;
B
Bruce Momjian 已提交
2720 2721
	qsort((void *) guc_variables, num_guc_variables,
		  sizeof(struct config_generic *), guc_var_compare);
2722
	return true;
2723 2724 2725
}

/*
2726
 * Create and add a placeholder variable. It's presumed to belong
2727 2728
 * to a valid custom variable class at this point.
 */
B
Bruce Momjian 已提交
2729
static struct config_string *
2730
add_placeholder_variable(const char *name, int elevel)
2731
{
B
Bruce Momjian 已提交
2732 2733 2734
	size_t		sz = sizeof(struct config_string) + sizeof(char *);
	struct config_string *var;
	struct config_generic *gen;
2735

B
Bruce Momjian 已提交
2736 2737
	var = (struct config_string *) guc_malloc(elevel, sz);
	if (var == NULL)
2738 2739 2740
		return NULL;

	gen = &var->gen;
2741 2742
	memset(var, 0, sz);

2743 2744
	gen->name = guc_strdup(elevel, name);
	if (gen->name == NULL)
2745 2746 2747 2748 2749
	{
		free(var);
		return NULL;
	}

B
Bruce Momjian 已提交
2750 2751
	gen->context = PGC_USERSET;
	gen->group = CUSTOM_OPTIONS;
2752
	gen->short_desc = "GUC placeholder variable";
B
Bruce Momjian 已提交
2753 2754
	gen->flags = GUC_NO_SHOW_ALL | GUC_NOT_IN_SAMPLE | GUC_CUSTOM_PLACEHOLDER;
	gen->vartype = PGC_STRING;
2755

B
Bruce Momjian 已提交
2756 2757 2758 2759 2760
	/*
	 * The char* is allocated at the end of the struct since we have no
	 * 'static' place to point to.
	 */
	var->variable = (char **) (var + 1);
2761

B
Bruce Momjian 已提交
2762
	if (!add_guc_variable((struct config_generic *) var, elevel))
2763 2764 2765 2766 2767 2768
	{
		free((void *) gen->name);
		free(var);
		return NULL;
	}

2769 2770
	return var;
}
2771 2772

/*
2773 2774
 * Look up option NAME. If it exists, return a pointer to its record,
 * else return NULL.
2775
 */
2776
static struct config_generic *
2777
find_option(const char *name, int elevel)
2778
{
2779
	const char *dot;
2780 2781
	const char **key = &name;
	struct config_generic **res;
2782
	int			i;
2783

2784
	Assert(name);
2785

2786
	/*
B
Bruce Momjian 已提交
2787 2788
	 * By equating const char ** with struct config_generic *, we are assuming
	 * the name field is first in config_generic.
2789
	 */
B
Bruce Momjian 已提交
2790 2791 2792
	res = (struct config_generic **) bsearch((void *) &key,
											 (void *) guc_variables,
											 num_guc_variables,
B
Bruce Momjian 已提交
2793
											 sizeof(struct config_generic *),
B
Bruce Momjian 已提交
2794
											 guc_var_compare);
2795 2796
	if (res)
		return *res;
2797 2798

	/*
B
Bruce Momjian 已提交
2799 2800 2801
	 * See if the name is an obsolete name for a variable.	We assume that the
	 * set of supported old names is short enough that a brute-force search is
	 * the best way.
2802 2803 2804 2805
	 */
	for (i = 0; map_old_guc_names[i] != NULL; i += 2)
	{
		if (guc_name_compare(name, map_old_guc_names[i]) == 0)
B
Bruce Momjian 已提交
2806
			return find_option(map_old_guc_names[i + 1], elevel);
2807 2808
	}

2809
	/*
B
Bruce Momjian 已提交
2810 2811
	 * Check if the name is qualified, and if so, check if the qualifier maps
	 * to a custom variable class.
2812 2813
	 */
	dot = strchr(name, GUC_QUALIFIER_SEPARATOR);
B
Bruce Momjian 已提交
2814
	if (dot != NULL && is_custom_class(name, dot - name))
2815
		/* Add a placeholder variable for this name */
B
Bruce Momjian 已提交
2816
		return (struct config_generic *) add_placeholder_variable(name, elevel);
2817

2818
	/* Unknown name */
2819 2820
	return NULL;
}
2821 2822 2823


/*
2824
 * comparator for qsorting and bsearching guc_variables array
2825
 */
2826 2827
static int
guc_var_compare(const void *a, const void *b)
2828
{
2829 2830
	struct config_generic *confa = *(struct config_generic **) a;
	struct config_generic *confb = *(struct config_generic **) b;
2831

2832 2833 2834 2835 2836 2837 2838
	return guc_name_compare(confa->name, confb->name);
}


static int
guc_name_compare(const char *namea, const char *nameb)
{
2839
	/*
B
Bruce Momjian 已提交
2840 2841 2842
	 * The temptation to use strcasecmp() here must be resisted, because the
	 * array ordering has to remain stable across setlocale() calls. So, build
	 * our own with a simple ASCII-only downcasing.
2843
	 */
2844 2845 2846 2847 2848 2849 2850 2851 2852 2853 2854
	while (*namea && *nameb)
	{
		char		cha = *namea++;
		char		chb = *nameb++;

		if (cha >= 'A' && cha <= 'Z')
			cha += 'a' - 'A';
		if (chb >= 'A' && chb <= 'Z')
			chb += 'a' - 'A';
		if (cha != chb)
			return cha - chb;
2855
	}
2856 2857 2858 2859 2860
	if (*namea)
		return 1;				/* a is longer */
	if (*nameb)
		return -1;				/* b is longer */
	return 0;
2861
}
2862 2863


2864 2865 2866 2867 2868 2869 2870 2871 2872 2873 2874 2875 2876 2877 2878 2879 2880 2881 2882 2883 2884 2885 2886 2887
static int
guc_get_index(const char *name)
{
	const char **key = &name;
	struct config_generic **res;

	Assert(name);

	/*
	 * By equating const char ** with struct config_generic *, we are assuming
	 * the name field is first in config_generic.
	 */
	res = (struct config_generic **) bsearch((void *) &key,
											 (void *) guc_variables,
											 num_guc_variables,
											 sizeof(struct config_generic *),
											 guc_var_compare);
	if (!res)
		return -1;

	return res - guc_variables;
}


2888
/*
2889
 * Initialize GUC options during program startup.
2890 2891 2892
 *
 * Note that we cannot read the config file yet, since we have not yet
 * processed command-line switches.
2893
 */
2894 2895
void
InitializeGUCOptions(void)
2896
{
2897 2898
	int			i;
	char	   *env;
2899
	long		stack_rlimit;
2900

2901 2902 2903 2904
	/*
	 * Build sorted array of all GUC variables.
	 */
	build_guc_variables();
2905

2906
	/*
2907 2908
	 * Load all variables with their compiled-in defaults, and initialize
	 * status fields as needed.
2909
	 */
2910
	for (i = 0; i < num_guc_variables; i++)
2911
	{
2912
		struct config_generic *gconf = guc_variables[i];
2913

2914 2915 2916 2917
		gconf->status = 0;
		gconf->reset_source = PGC_S_DEFAULT;
		gconf->tentative_source = PGC_S_DEFAULT;
		gconf->source = PGC_S_DEFAULT;
2918
		gconf->stack = NULL;
2919 2920 2921 2922

		switch (gconf->vartype)
		{
			case PGC_BOOL:
B
Bruce Momjian 已提交
2923 2924
				{
					struct config_bool *conf = (struct config_bool *) gconf;
2925

2926
					if (conf->assign_hook)
2927
						if (!(*conf->assign_hook) (conf->boot_val, true,
2928 2929
												   PGC_S_DEFAULT))
							elog(FATAL, "failed to initialize %s to %d",
2930 2931
								 conf->gen.name, (int) conf->boot_val);
					*conf->variable = conf->reset_val = conf->boot_val;
B
Bruce Momjian 已提交
2932 2933
					break;
				}
2934
			case PGC_INT:
B
Bruce Momjian 已提交
2935 2936
				{
					struct config_int *conf = (struct config_int *) gconf;
2937

2938 2939
					Assert(conf->boot_val >= conf->min);
					Assert(conf->boot_val <= conf->max);
2940
					if (conf->assign_hook)
2941
						if (!(*conf->assign_hook) (conf->boot_val, true,
2942 2943
												   PGC_S_DEFAULT))
							elog(FATAL, "failed to initialize %s to %d",
2944
								 conf->gen.name, conf->boot_val);
2945
					*conf->variable = conf->reset_val = conf->boot_val;
B
Bruce Momjian 已提交
2946 2947
					break;
				}
2948 2949
			case PGC_REAL:
				{
B
Bruce Momjian 已提交
2950 2951
					struct config_real *conf = (struct config_real *) gconf;

2952 2953
					Assert(conf->boot_val >= conf->min);
					Assert(conf->boot_val <= conf->max);
2954
					if (conf->assign_hook)
2955
						if (!(*conf->assign_hook) (conf->boot_val, true,
2956 2957
												   PGC_S_DEFAULT))
							elog(FATAL, "failed to initialize %s to %g",
2958
								 conf->gen.name, conf->boot_val);
2959
					*conf->variable = conf->reset_val = conf->boot_val;
2960 2961
					break;
				}
B
Bruce Momjian 已提交
2962
			case PGC_STRING:
2963
				{
B
Bruce Momjian 已提交
2964 2965 2966 2967 2968 2969
					struct config_string *conf = (struct config_string *) gconf;
					char	   *str;

					*conf->variable = NULL;
					conf->reset_val = NULL;
					conf->tentative_val = NULL;
2970

B
Bruce Momjian 已提交
2971
					if (conf->boot_val == NULL)
2972
					{
B
Bruce Momjian 已提交
2973 2974
						/* Cannot set value yet */
						break;
2975
					}
B
Bruce Momjian 已提交
2976

2977
					str = guc_strdup(FATAL, conf->boot_val);
B
Bruce Momjian 已提交
2978 2979 2980
					conf->reset_val = str;

					if (conf->assign_hook)
2981
					{
B
Bruce Momjian 已提交
2982 2983
						const char *newstr;

2984 2985
						newstr = (*conf->assign_hook) (str, true,
													   PGC_S_DEFAULT);
B
Bruce Momjian 已提交
2986
						if (newstr == NULL)
2987
						{
2988 2989
							elog(FATAL, "failed to initialize %s to \"%s\"",
								 conf->gen.name, str);
2990
						}
B
Bruce Momjian 已提交
2991 2992 2993 2994 2995
						else if (newstr != str)
						{
							free(str);

							/*
B
Bruce Momjian 已提交
2996
							 * See notes in set_config_option about casting
B
Bruce Momjian 已提交
2997 2998 2999 3000
							 */
							str = (char *) newstr;
							conf->reset_val = str;
						}
3001
					}
B
Bruce Momjian 已提交
3002 3003
					*conf->variable = str;
					break;
3004 3005 3006 3007 3008 3009
				}
		}
	}

	guc_dirty = false;

3010 3011
	reporting_enabled = false;

3012
	/*
3013
	 * Prevent any attempt to override the transaction modes from
3014 3015
	 * non-interactive sources.
	 */
3016 3017 3018
	SetConfigOption("transaction_isolation", "default",
					PGC_POSTMASTER, PGC_S_OVERRIDE);
	SetConfigOption("transaction_read_only", "no",
3019 3020 3021
					PGC_POSTMASTER, PGC_S_OVERRIDE);

	/*
B
Bruce Momjian 已提交
3022 3023
	 * For historical reasons, some GUC parameters can receive defaults from
	 * environment variables.  Process those settings.
3024 3025 3026 3027 3028 3029
	 */

	env = getenv("PGPORT");
	if (env != NULL)
		SetConfigOption("port", env, PGC_POSTMASTER, PGC_S_ENV_VAR);

3030 3031
	env = getenv("PGDATESTYLE");
	if (env != NULL)
3032 3033
		SetConfigOption("datestyle", env, PGC_POSTMASTER, PGC_S_ENV_VAR);

3034 3035
	env = getenv("PGCLIENTENCODING");
	if (env != NULL)
3036
		SetConfigOption("client_encoding", env, PGC_POSTMASTER, PGC_S_ENV_VAR);
3037 3038 3039 3040 3041 3042 3043 3044 3045 3046 3047 3048 3049 3050 3051 3052 3053 3054 3055 3056 3057

	/*
	 * rlimit isn't exactly an "environment variable", but it behaves about
	 * the same.  If we can identify the platform stack depth rlimit, increase
	 * default stack depth setting up to whatever is safe (but at most 2MB).
	 */
	stack_rlimit = get_stack_depth_rlimit();
	if (stack_rlimit > 0)
	{
		int		new_limit = (stack_rlimit - STACK_DEPTH_SLOP) / 1024L;

		if (new_limit > 100)
		{
			char	limbuf[16];

			new_limit = Min(new_limit, 2048);
			sprintf(limbuf, "%d", new_limit);
			SetConfigOption("max_stack_depth", limbuf,
							PGC_POSTMASTER, PGC_S_ENV_VAR);
		}
	}
3058 3059 3060
}


3061 3062 3063 3064 3065 3066 3067 3068 3069 3070 3071 3072 3073 3074
/*
 * Select the configuration files and data directory to be used, and
 * do the initial read of postgresql.conf.
 *
 * This is called after processing command-line switches.
 *		userDoption is the -D switch value if any (NULL if unspecified).
 *		progname is just for use in error messages.
 *
 * Returns true on success; on failure, prints a suitable error message
 * to stderr and returns false.
 */
bool
SelectConfigFiles(const char *userDoption, const char *progname)
{
3075 3076
	char	   *configdir;
	char	   *fname;
3077 3078
	struct stat stat_buf;

3079 3080 3081 3082 3083
	/* configdir is -D option, or $PGDATA if no -D */
	if (userDoption)
		configdir = make_absolute_path(userDoption);
	else
		configdir = make_absolute_path(getenv("PGDATA"));
3084 3085

	/*
3086
	 * Find the configuration file: if config_file was specified on the
B
Bruce Momjian 已提交
3087 3088 3089
	 * command line, use it, else use configdir/postgresql.conf.  In any case
	 * ensure the result is an absolute path, so that it will be interpreted
	 * the same way by future backends.
3090
	 */
3091 3092
	if (ConfigFileName)
		fname = make_absolute_path(ConfigFileName);
3093 3094 3095 3096 3097 3098 3099
	else if (configdir)
	{
		fname = guc_malloc(FATAL,
						   strlen(configdir) + strlen(CONFIG_FILENAME) + 2);
		sprintf(fname, "%s/%s", configdir, CONFIG_FILENAME);
	}
	else
3100
	{
3101
		write_stderr("%s does not know where to find the server configuration file.\n"
P
Peter Eisentraut 已提交
3102
					 "You must specify the --config-file or -D invocation "
3103 3104 3105
					 "option or set the PGDATA environment variable.\n",
					 progname);
		return false;
3106 3107
	}

3108
	/*
B
Bruce Momjian 已提交
3109 3110
	 * Set the ConfigFileName GUC variable to its final value, ensuring that
	 * it can't be overridden later.
3111 3112 3113 3114 3115 3116 3117
	 */
	SetConfigOption("config_file", fname, PGC_POSTMASTER, PGC_S_OVERRIDE);
	free(fname);

	/*
	 * Now read the config file for the first time.
	 */
3118 3119
	if (stat(ConfigFileName, &stat_buf) != 0)
	{
3120
		write_stderr("%s cannot access the server configuration file \"%s\": %s\n",
3121 3122 3123 3124 3125 3126 3127
					 progname, ConfigFileName, strerror(errno));
		return false;
	}

	ProcessConfigFile(PGC_POSTMASTER);

	/*
3128 3129
	 * If the data_directory GUC variable has been set, use that as DataDir;
	 * otherwise use configdir if set; else punt.
3130
	 *
3131 3132
	 * Note: SetDataDir will copy and absolute-ize its argument, so we don't
	 * have to.
3133
	 */
3134 3135 3136 3137
	if (data_directory)
		SetDataDir(data_directory);
	else if (configdir)
		SetDataDir(configdir);
3138 3139 3140
	else
	{
		write_stderr("%s does not know where to find the database system data.\n"
3141 3142 3143 3144 3145 3146 3147 3148 3149 3150 3151
					 "This can be specified as \"data_directory\" in \"%s\", "
					 "or by the -D invocation option, or by the "
					 "PGDATA environment variable.\n",
					 progname, ConfigFileName);
		return false;
	}

	/*
	 * Reflect the final DataDir value back into the data_directory GUC var.
	 * (If you are wondering why we don't just make them a single variable,
	 * it's because the EXEC_BACKEND case needs DataDir to be transmitted to
B
Bruce Momjian 已提交
3152 3153 3154
	 * child backends specially.  XXX is that still true?  Given that we now
	 * chdir to DataDir, EXEC_BACKEND can read the config file without knowing
	 * DataDir in advance.)
3155 3156 3157 3158 3159 3160 3161 3162
	 */
	SetConfigOption("data_directory", DataDir, PGC_POSTMASTER, PGC_S_OVERRIDE);

	/*
	 * Figure out where pg_hba.conf is, and make sure the path is absolute.
	 */
	if (HbaFileName)
		fname = make_absolute_path(HbaFileName);
3163 3164 3165 3166 3167 3168 3169
	else if (configdir)
	{
		fname = guc_malloc(FATAL,
						   strlen(configdir) + strlen(HBA_FILENAME) + 2);
		sprintf(fname, "%s/%s", configdir, HBA_FILENAME);
	}
	else
3170 3171 3172 3173 3174
	{
		write_stderr("%s does not know where to find the \"hba\" configuration file.\n"
					 "This can be specified as \"hba_file\" in \"%s\", "
					 "or by the -D invocation option, or by the "
					 "PGDATA environment variable.\n",
3175 3176 3177
					 progname, ConfigFileName);
		return false;
	}
3178 3179
	SetConfigOption("hba_file", fname, PGC_POSTMASTER, PGC_S_OVERRIDE);
	free(fname);
3180 3181

	/*
3182
	 * Likewise for pg_ident.conf.
3183
	 */
3184 3185
	if (IdentFileName)
		fname = make_absolute_path(IdentFileName);
3186 3187 3188 3189 3190 3191 3192
	else if (configdir)
	{
		fname = guc_malloc(FATAL,
						   strlen(configdir) + strlen(IDENT_FILENAME) + 2);
		sprintf(fname, "%s/%s", configdir, IDENT_FILENAME);
	}
	else
3193 3194 3195 3196 3197 3198 3199 3200 3201 3202 3203 3204
	{
		write_stderr("%s does not know where to find the \"ident\" configuration file.\n"
					 "This can be specified as \"ident_file\" in \"%s\", "
					 "or by the -D invocation option, or by the "
					 "PGDATA environment variable.\n",
					 progname, ConfigFileName);
		return false;
	}
	SetConfigOption("ident_file", fname, PGC_POSTMASTER, PGC_S_OVERRIDE);
	free(fname);

	free(configdir);
3205 3206 3207 3208 3209

	return true;
}


3210 3211 3212 3213 3214 3215 3216 3217 3218 3219 3220 3221 3222
/*
 * Reset all options to their saved default values (implements RESET ALL)
 */
void
ResetAllOptions(void)
{
	int			i;

	for (i = 0; i < num_guc_variables; i++)
	{
		struct config_generic *gconf = guc_variables[i];

		/* Don't reset non-SET-able values */
3223 3224
		if (gconf->context != PGC_SUSET &&
			gconf->context != PGC_USERSET)
3225 3226 3227 3228 3229 3230 3231 3232
			continue;
		/* Don't reset if special exclusion from RESET ALL */
		if (gconf->flags & GUC_NO_RESET_ALL)
			continue;
		/* No need to reset if wasn't SET */
		if (gconf->source <= PGC_S_OVERRIDE)
			continue;

3233 3234 3235
		/* Save old value to support transaction abort */
		push_old_value(gconf);

3236 3237 3238
		switch (gconf->vartype)
		{
			case PGC_BOOL:
B
Bruce Momjian 已提交
3239 3240
				{
					struct config_bool *conf = (struct config_bool *) gconf;
3241

B
Bruce Momjian 已提交
3242
					if (conf->assign_hook)
3243 3244
						if (!(*conf->assign_hook) (conf->reset_val, true,
												   PGC_S_SESSION))
3245
							elog(ERROR, "failed to reset %s", conf->gen.name);
B
Bruce Momjian 已提交
3246 3247 3248 3249 3250 3251 3252 3253
					*conf->variable = conf->reset_val;
					conf->tentative_val = conf->reset_val;
					conf->gen.source = conf->gen.reset_source;
					conf->gen.tentative_source = conf->gen.reset_source;
					conf->gen.status |= GUC_HAVE_TENTATIVE;
					guc_dirty = true;
					break;
				}
3254
			case PGC_INT:
B
Bruce Momjian 已提交
3255 3256
				{
					struct config_int *conf = (struct config_int *) gconf;
3257

B
Bruce Momjian 已提交
3258
					if (conf->assign_hook)
3259 3260
						if (!(*conf->assign_hook) (conf->reset_val, true,
												   PGC_S_SESSION))
3261
							elog(ERROR, "failed to reset %s", conf->gen.name);
B
Bruce Momjian 已提交
3262 3263 3264 3265 3266 3267 3268 3269
					*conf->variable = conf->reset_val;
					conf->tentative_val = conf->reset_val;
					conf->gen.source = conf->gen.reset_source;
					conf->gen.tentative_source = conf->gen.reset_source;
					conf->gen.status |= GUC_HAVE_TENTATIVE;
					guc_dirty = true;
					break;
				}
3270 3271
			case PGC_REAL:
				{
B
Bruce Momjian 已提交
3272 3273 3274
					struct config_real *conf = (struct config_real *) gconf;

					if (conf->assign_hook)
3275 3276
						if (!(*conf->assign_hook) (conf->reset_val, true,
												   PGC_S_SESSION))
3277
							elog(ERROR, "failed to reset %s", conf->gen.name);
B
Bruce Momjian 已提交
3278 3279 3280 3281 3282 3283
					*conf->variable = conf->reset_val;
					conf->tentative_val = conf->reset_val;
					conf->gen.source = conf->gen.reset_source;
					conf->gen.tentative_source = conf->gen.reset_source;
					conf->gen.status |= GUC_HAVE_TENTATIVE;
					guc_dirty = true;
3284 3285
					break;
				}
B
Bruce Momjian 已提交
3286 3287 3288 3289
			case PGC_STRING:
				{
					struct config_string *conf = (struct config_string *) gconf;
					char	   *str;
3290

B
Bruce Momjian 已提交
3291 3292 3293 3294 3295
					if (conf->reset_val == NULL)
					{
						/* Nothing to reset to, as yet; so do nothing */
						break;
					}
3296

B
Bruce Momjian 已提交
3297 3298
					/* We need not strdup here */
					str = conf->reset_val;
3299

B
Bruce Momjian 已提交
3300
					if (conf->assign_hook)
3301
					{
B
Bruce Momjian 已提交
3302 3303
						const char *newstr;

3304 3305
						newstr = (*conf->assign_hook) (str, true,
													   PGC_S_SESSION);
B
Bruce Momjian 已提交
3306
						if (newstr == NULL)
3307
							elog(ERROR, "failed to reset %s", conf->gen.name);
B
Bruce Momjian 已提交
3308 3309 3310
						else if (newstr != str)
						{
							/*
B
Bruce Momjian 已提交
3311
							 * See notes in set_config_option about casting
B
Bruce Momjian 已提交
3312 3313 3314
							 */
							str = (char *) newstr;
						}
3315 3316
					}

3317 3318
					set_string_field(conf, conf->variable, str);
					set_string_field(conf, &conf->tentative_val, str);
B
Bruce Momjian 已提交
3319 3320 3321 3322 3323 3324
					conf->gen.source = conf->gen.reset_source;
					conf->gen.tentative_source = conf->gen.reset_source;
					conf->gen.status |= GUC_HAVE_TENTATIVE;
					guc_dirty = true;
					break;
				}
3325
		}
3326 3327 3328

		if (gconf->flags & GUC_REPORT)
			ReportGUCOption(gconf);
3329 3330 3331 3332 3333
	}
}


/*
3334 3335 3336 3337 3338 3339 3340 3341 3342 3343
 * push_old_value
 *		Push previous state during first assignment to a GUC variable
 *		within a particular transaction.
 *
 * We have to be willing to "back-fill" the state stack if the first
 * assignment occurs within a subtransaction nested several levels deep.
 * This ensures that if an intermediate transaction aborts, it will have
 * the proper value available to restore the setting to.
 */
static void
B
Bruce Momjian 已提交
3344
push_old_value(struct config_generic * gconf)
3345 3346 3347 3348 3349 3350 3351 3352 3353 3354 3355 3356 3357 3358 3359 3360
{
	int			my_level = GetCurrentTransactionNestLevel();
	GucStack   *stack;

	/* If we're not inside a transaction, do nothing */
	if (my_level == 0)
		return;

	for (;;)
	{
		/* Done if we already pushed it at this nesting depth */
		if (gconf->stack && gconf->stack->nest_level >= my_level)
			return;

		/*
		 * We keep all the stack entries in TopTransactionContext so as to
B
Bruce Momjian 已提交
3361 3362
		 * avoid allocation problems when a subtransaction back-fills stack
		 * entries for upper transaction levels.
3363 3364 3365 3366 3367 3368 3369 3370 3371 3372 3373 3374 3375 3376 3377 3378 3379 3380 3381 3382 3383 3384 3385 3386 3387 3388 3389 3390 3391 3392 3393 3394 3395 3396 3397 3398 3399 3400 3401 3402 3403 3404 3405 3406 3407 3408 3409 3410 3411 3412 3413
		 */
		stack = (GucStack *) MemoryContextAlloc(TopTransactionContext,
												sizeof(GucStack));

		stack->prev = gconf->stack;
		stack->nest_level = stack->prev ? stack->prev->nest_level + 1 : 1;
		stack->status = gconf->status;
		stack->tentative_source = gconf->tentative_source;
		stack->source = gconf->source;

		switch (gconf->vartype)
		{
			case PGC_BOOL:
				stack->tentative_val.boolval =
					((struct config_bool *) gconf)->tentative_val;
				stack->value.boolval =
					*((struct config_bool *) gconf)->variable;
				break;

			case PGC_INT:
				stack->tentative_val.intval =
					((struct config_int *) gconf)->tentative_val;
				stack->value.intval =
					*((struct config_int *) gconf)->variable;
				break;

			case PGC_REAL:
				stack->tentative_val.realval =
					((struct config_real *) gconf)->tentative_val;
				stack->value.realval =
					*((struct config_real *) gconf)->variable;
				break;

			case PGC_STRING:
				stack->tentative_val.stringval =
					((struct config_string *) gconf)->tentative_val;
				stack->value.stringval =
					*((struct config_string *) gconf)->variable;
				break;
		}

		gconf->stack = stack;

		/* Set state to indicate nothing happened yet within this level */
		gconf->status = GUC_HAVE_STACK;

		/* Ensure we remember to pop at end of xact */
		guc_dirty = true;
	}
}

3414
/*
3415
 * Do GUC processing at transaction or subtransaction commit or abort.
3416 3417
 */
void
3418
AtEOXact_GUC(bool isCommit, bool isSubXact)
3419
{
3420
	int			my_level;
3421 3422 3423 3424 3425 3426
	int			i;

	/* Quick exit if nothing's changed in this transaction */
	if (!guc_dirty)
		return;

3427 3428 3429
	my_level = GetCurrentTransactionNestLevel();
	Assert(isSubXact ? (my_level > 1) : (my_level == 1));

3430 3431 3432
	for (i = 0; i < num_guc_variables; i++)
	{
		struct config_generic *gconf = guc_variables[i];
3433
		int			my_status = gconf->status;
3434 3435
		GucStack   *stack = gconf->stack;
		bool		useTentative;
3436
		bool		changed;
3437

3438 3439 3440 3441 3442 3443 3444 3445 3446 3447 3448 3449
		/*
		 * Skip if nothing's happened to this var in this transaction
		 */
		if (my_status == 0)
		{
			Assert(stack == NULL);
			continue;
		}
		/* Assert that we stacked old value before changing it */
		Assert(stack != NULL && (my_status & GUC_HAVE_STACK));
		/* However, the last change may have been at an outer xact level */
		if (stack->nest_level < my_level)
3450
			continue;
3451 3452 3453
		Assert(stack->nest_level == my_level);

		/*
B
Bruce Momjian 已提交
3454 3455 3456
		 * We will pop the stack entry.  Start by restoring outer xact status
		 * (since we may want to modify it below).	Be careful to use
		 * my_status to reference the inner xact status below this point...
3457 3458 3459 3460 3461 3462
		 */
		gconf->status = stack->status;

		/*
		 * We have two cases:
		 *
3463 3464
		 * If commit and HAVE_TENTATIVE, set actual value to tentative (this
		 * is to override a SET LOCAL if one occurred later than SET). We keep
B
Bruce Momjian 已提交
3465 3466 3467 3468
		 * the tentative value and propagate HAVE_TENTATIVE to the parent
		 * status, allowing the SET's effect to percolate up. (But if we're
		 * exiting the outermost transaction, we'll drop the HAVE_TENTATIVE
		 * bit below.)
3469
		 *
B
Bruce Momjian 已提交
3470
		 * Otherwise, we have a transaction that aborted or executed only SET
B
Bruce Momjian 已提交
3471 3472 3473
		 * LOCAL (or no SET at all).  In either case it should have no further
		 * effect, so restore both tentative and actual values from the stack
		 * entry.
3474
		 */
3475

3476
		useTentative = isCommit && (my_status & GUC_HAVE_TENTATIVE) != 0;
3477 3478
		changed = false;

3479 3480 3481 3482
		switch (gconf->vartype)
		{
			case PGC_BOOL:
				{
B
Bruce Momjian 已提交
3483
					struct config_bool *conf = (struct config_bool *) gconf;
3484 3485
					bool		newval;
					GucSource	newsource;
3486

3487 3488 3489 3490 3491 3492 3493
					if (useTentative)
					{
						newval = conf->tentative_val;
						newsource = conf->gen.tentative_source;
						conf->gen.status |= GUC_HAVE_TENTATIVE;
					}
					else
B
Bruce Momjian 已提交
3494
					{
3495 3496 3497 3498
						newval = stack->value.boolval;
						newsource = stack->source;
						conf->tentative_val = stack->tentative_val.boolval;
						conf->gen.tentative_source = stack->tentative_source;
B
Bruce Momjian 已提交
3499 3500
					}

3501
					if (*conf->variable != newval)
B
Bruce Momjian 已提交
3502 3503
					{
						if (conf->assign_hook)
3504
							if (!(*conf->assign_hook) (newval,
B
Bruce Momjian 已提交
3505
													   true, PGC_S_OVERRIDE))
3506 3507
								elog(LOG, "failed to commit %s",
									 conf->gen.name);
3508
						*conf->variable = newval;
3509
						changed = true;
B
Bruce Momjian 已提交
3510
					}
3511
					conf->gen.source = newsource;
B
Bruce Momjian 已提交
3512
					break;
3513 3514 3515
				}
			case PGC_INT:
				{
B
Bruce Momjian 已提交
3516
					struct config_int *conf = (struct config_int *) gconf;
3517 3518
					int			newval;
					GucSource	newsource;
3519

3520 3521 3522 3523 3524 3525 3526
					if (useTentative)
					{
						newval = conf->tentative_val;
						newsource = conf->gen.tentative_source;
						conf->gen.status |= GUC_HAVE_TENTATIVE;
					}
					else
B
Bruce Momjian 已提交
3527
					{
3528 3529 3530 3531
						newval = stack->value.intval;
						newsource = stack->source;
						conf->tentative_val = stack->tentative_val.intval;
						conf->gen.tentative_source = stack->tentative_source;
B
Bruce Momjian 已提交
3532 3533
					}

3534
					if (*conf->variable != newval)
B
Bruce Momjian 已提交
3535 3536
					{
						if (conf->assign_hook)
3537
							if (!(*conf->assign_hook) (newval,
B
Bruce Momjian 已提交
3538
													   true, PGC_S_OVERRIDE))
3539 3540
								elog(LOG, "failed to commit %s",
									 conf->gen.name);
3541
						*conf->variable = newval;
3542
						changed = true;
B
Bruce Momjian 已提交
3543
					}
3544
					conf->gen.source = newsource;
B
Bruce Momjian 已提交
3545
					break;
3546 3547 3548
				}
			case PGC_REAL:
				{
B
Bruce Momjian 已提交
3549
					struct config_real *conf = (struct config_real *) gconf;
3550 3551
					double		newval;
					GucSource	newsource;
3552

3553
					if (useTentative)
B
Bruce Momjian 已提交
3554
					{
3555 3556 3557 3558 3559 3560 3561 3562 3563 3564
						newval = conf->tentative_val;
						newsource = conf->gen.tentative_source;
						conf->gen.status |= GUC_HAVE_TENTATIVE;
					}
					else
					{
						newval = stack->value.realval;
						newsource = stack->source;
						conf->tentative_val = stack->tentative_val.realval;
						conf->gen.tentative_source = stack->tentative_source;
B
Bruce Momjian 已提交
3565
					}
3566

3567
					if (*conf->variable != newval)
B
Bruce Momjian 已提交
3568 3569
					{
						if (conf->assign_hook)
3570
							if (!(*conf->assign_hook) (newval,
B
Bruce Momjian 已提交
3571
													   true, PGC_S_OVERRIDE))
3572 3573
								elog(LOG, "failed to commit %s",
									 conf->gen.name);
3574
						*conf->variable = newval;
3575
						changed = true;
B
Bruce Momjian 已提交
3576
					}
3577
					conf->gen.source = newsource;
B
Bruce Momjian 已提交
3578
					break;
3579
				}
B
Bruce Momjian 已提交
3580
			case PGC_STRING:
3581
				{
B
Bruce Momjian 已提交
3582
					struct config_string *conf = (struct config_string *) gconf;
3583 3584
					char	   *newval;
					GucSource	newsource;
3585

3586
					if (useTentative)
B
Bruce Momjian 已提交
3587
					{
3588 3589 3590
						newval = conf->tentative_val;
						newsource = conf->gen.tentative_source;
						conf->gen.status |= GUC_HAVE_TENTATIVE;
B
Bruce Momjian 已提交
3591 3592
					}
					else
3593
					{
3594 3595 3596 3597 3598 3599
						newval = stack->value.stringval;
						newsource = stack->source;
						set_string_field(conf, &conf->tentative_val,
										 stack->tentative_val.stringval);
						conf->gen.tentative_source = stack->tentative_source;
					}
3600

3601 3602
					if (*conf->variable != newval)
					{
B
Bruce Momjian 已提交
3603
						if (conf->assign_hook)
3604
						{
B
Bruce Momjian 已提交
3605 3606
							const char *newstr;

3607
							newstr = (*conf->assign_hook) (newval, true,
B
Bruce Momjian 已提交
3608
														   PGC_S_OVERRIDE);
B
Bruce Momjian 已提交
3609
							if (newstr == NULL)
3610 3611
								elog(LOG, "failed to commit %s",
									 conf->gen.name);
3612
							else if (newstr != newval)
B
Bruce Momjian 已提交
3613 3614
							{
								/*
3615 3616 3617
								 * If newval should now be freed, it'll be
								 * taken care of below.
								 *
3618 3619
								 * See notes in set_config_option about
								 * casting
B
Bruce Momjian 已提交
3620
								 */
3621
								newval = (char *) newstr;
B
Bruce Momjian 已提交
3622
							}
3623 3624
						}

3625
						set_string_field(conf, conf->variable, newval);
3626
						changed = true;
B
Bruce Momjian 已提交
3627
					}
3628 3629 3630 3631 3632 3633 3634 3635 3636
					conf->gen.source = newsource;
					/* Release stacked values if not used anymore */
					set_string_field(conf, &stack->value.stringval,
									 NULL);
					set_string_field(conf, &stack->tentative_val.stringval,
									 NULL);
					/* Don't store tentative value separately after commit */
					if (!isSubXact)
						set_string_field(conf, &conf->tentative_val, NULL);
B
Bruce Momjian 已提交
3637
					break;
3638 3639
				}
		}
3640

3641 3642 3643 3644 3645
		/* Finish popping the state stack */
		gconf->stack = stack->prev;
		pfree(stack);

		/*
B
Bruce Momjian 已提交
3646 3647
		 * If we're now out of all xact levels, forget TENTATIVE status bit;
		 * there's nothing tentative about the value anymore.
3648 3649 3650 3651 3652 3653 3654 3655
		 */
		if (!isSubXact)
		{
			Assert(gconf->stack == NULL);
			gconf->status = 0;
		}

		/* Report new value if we changed it */
3656 3657
		if (changed && (gconf->flags & GUC_REPORT))
			ReportGUCOption(gconf);
3658 3659
	}

3660
	/*
B
Bruce Momjian 已提交
3661 3662 3663 3664
	 * If we're now out of all xact levels, we can clear guc_dirty. (Note: we
	 * cannot reset guc_dirty when exiting a subtransaction, because we know
	 * that all outer transaction levels will have stacked values to deal
	 * with.)
3665 3666 3667
	 */
	if (!isSubXact)
		guc_dirty = false;
3668 3669 3670
}


3671 3672 3673 3674 3675 3676 3677 3678 3679 3680
/*
 * Start up automatic reporting of changes to variables marked GUC_REPORT.
 * This is executed at completion of backend startup.
 */
void
BeginReportingGUCOptions(void)
{
	int			i;

	/*
B
Bruce Momjian 已提交
3681 3682
	 * Don't do anything unless talking to an interactive frontend of protocol
	 * 3.0 or later.
3683
	 */
3684
	if (whereToSendOutput != DestRemote ||
3685 3686 3687 3688 3689 3690 3691 3692 3693 3694 3695 3696 3697 3698 3699 3700 3701 3702 3703
		PG_PROTOCOL_MAJOR(FrontendProtocol) < 3)
		return;

	reporting_enabled = true;

	/* Transmit initial values of interesting variables */
	for (i = 0; i < num_guc_variables; i++)
	{
		struct config_generic *conf = guc_variables[i];

		if (conf->flags & GUC_REPORT)
			ReportGUCOption(conf);
	}
}

/*
 * ReportGUCOption: if appropriate, transmit option value to frontend
 */
static void
3704
ReportGUCOption(struct config_generic * record)
3705 3706 3707
{
	if (reporting_enabled && (record->flags & GUC_REPORT))
	{
3708
		char	   *val = _ShowOption(record, false);
3709 3710 3711 3712 3713 3714 3715 3716 3717 3718 3719 3720
		StringInfoData msgbuf;

		pq_beginmessage(&msgbuf, 'S');
		pq_sendstring(&msgbuf, record->name);
		pq_sendstring(&msgbuf, val);
		pq_endmessage(&msgbuf);

		pfree(val);
	}
}


3721 3722
/*
 * Try to interpret value as boolean value.  Valid values are: true,
3723 3724 3725
 * false, yes, no, on, off, 1, 0; as well as unique prefixes thereof.
 * If the string parses okay, return true, else false.
 * If okay and result is not NULL, return the value in *result.
3726 3727 3728 3729 3730 3731
 */
static bool
parse_bool(const char *value, bool *result)
{
	size_t		len = strlen(value);

3732
	if (pg_strncasecmp(value, "true", len) == 0)
3733 3734 3735 3736
	{
		if (result)
			*result = true;
	}
3737
	else if (pg_strncasecmp(value, "false", len) == 0)
3738 3739 3740 3741 3742
	{
		if (result)
			*result = false;
	}

3743
	else if (pg_strncasecmp(value, "yes", len) == 0)
3744 3745 3746 3747
	{
		if (result)
			*result = true;
	}
3748
	else if (pg_strncasecmp(value, "no", len) == 0)
3749 3750 3751 3752 3753
	{
		if (result)
			*result = false;
	}

3754 3755
	/* 'o' is not unique enough */
	else if (pg_strncasecmp(value, "on", (len > 2 ? len : 2)) == 0)
3756 3757 3758 3759
	{
		if (result)
			*result = true;
	}
3760
	else if (pg_strncasecmp(value, "off", (len > 2 ? len : 2)) == 0)
3761 3762 3763 3764 3765
	{
		if (result)
			*result = false;
	}

3766
	else if (pg_strcasecmp(value, "1") == 0)
3767 3768 3769 3770
	{
		if (result)
			*result = true;
	}
3771
	else if (pg_strcasecmp(value, "0") == 0)
3772 3773 3774 3775 3776 3777
	{
		if (result)
			*result = false;
	}

	else
3778 3779 3780
	{
		if (result)
			*result = false;	/* suppress compiler warning */
3781
		return false;
3782
	}
3783 3784 3785 3786 3787 3788 3789
	return true;
}



/*
 * Try to parse value as an integer.  The accepted formats are the
3790 3791 3792 3793 3794 3795 3796
 * usual decimal, octal, or hexadecimal formats, optionally followed by
 * a unit name if "flags" indicates a unit is allowed.
 *
 * If the string parses okay, return true, else false.
 * If okay and result is not NULL, return the value in *result.
 * If not okay and hintmsg is not NULL, *hintmsg is set to a suitable
 *	HINT message, or NULL if no hint provided.
3797 3798
 */
static bool
3799
parse_int(const char *value, int *result, int flags, const char **hintmsg)
3800
{
3801
	int64		val;
3802 3803
	char	   *endptr;

3804 3805 3806 3807 3808 3809 3810
	/* To suppress compiler warnings, always set output params */
	if (result)
		*result = 0;
	if (hintmsg)
		*hintmsg = NULL;

	/* We assume here that int64 is at least as wide as long */
3811 3812
	errno = 0;
	val = strtol(value, &endptr, 0);
3813

3814 3815 3816 3817
	if (endptr == value)
		return false;			/* no HINT for integer syntax error */

	if (errno == ERANGE || val != (int64) ((int32) val))
3818
	{
3819 3820 3821 3822
		if (hintmsg)
			*hintmsg = gettext_noop("Value exceeds integer range.");
		return false;
	}
3823

3824 3825 3826
	/* allow whitespace between integer and unit */
	while (isspace((unsigned char) *endptr))
		endptr++;
3827

3828 3829 3830 3831 3832 3833 3834 3835 3836 3837 3838 3839
	/* Handle possible unit */
	if (*endptr != '\0')
	{
		/*
		 * Note: the multiple-switch coding technique here is a bit tedious,
		 * but seems necessary to avoid intermediate-value overflows.
		 *
		 * If INT64_IS_BUSTED (ie, it's really int32) we will fail to detect
		 * overflow due to units conversion, but there are few enough such
		 * machines that it does not seem worth trying to be smarter.
		 */
		if (flags & GUC_UNIT_MEMORY)
3840
		{
3841 3842 3843
			/* Set hint for use if no match or trailing garbage */
			if (hintmsg)
				*hintmsg = gettext_noop("Valid units for this parameter are \"kB\", \"MB\", and \"GB\".");
3844

3845 3846 3847 3848 3849
#if BLCKSZ < 1024 || BLCKSZ > (1024*1024)
#error BLCKSZ must be between 1KB and 1MB
#endif
#if XLOG_BLCKSZ < 1024 || XLOG_BLCKSZ > (1024*1024)
#error XLOG_BLCKSZ must be between 1KB and 1MB
3850 3851
#endif

3852
			if (strncmp(endptr, "kB", 2) == 0)
3853
			{
3854 3855 3856 3857 3858 3859 3860 3861 3862 3863 3864 3865 3866 3867 3868 3869 3870 3871 3872 3873 3874 3875 3876 3877 3878 3879 3880 3881 3882 3883 3884 3885 3886 3887 3888 3889 3890 3891 3892 3893 3894 3895
				endptr += 2;
				switch (flags & GUC_UNIT_MEMORY)
				{
					case GUC_UNIT_BLOCKS:
						val /= (BLCKSZ / 1024);
						break;
					case GUC_UNIT_XBLOCKS:
						val /= (XLOG_BLCKSZ / 1024);
						break;
				}
			}
			else if (strncmp(endptr, "MB", 2) == 0)
			{
				endptr += 2;
				switch (flags & GUC_UNIT_MEMORY)
				{
					case GUC_UNIT_KB:
						val *= KB_PER_MB;
						break;
					case GUC_UNIT_BLOCKS:
						val *= KB_PER_MB / (BLCKSZ / 1024);
						break;
					case GUC_UNIT_XBLOCKS:
						val *= KB_PER_MB / (XLOG_BLCKSZ / 1024);
						break;
				}
			}
			else if (strncmp(endptr, "GB", 2) == 0)
			{
				endptr += 2;
				switch (flags & GUC_UNIT_MEMORY)
				{
					case GUC_UNIT_KB:
						val *= KB_PER_GB;
						break;
					case GUC_UNIT_BLOCKS:
						val *= KB_PER_GB / (BLCKSZ / 1024);
						break;
					case GUC_UNIT_XBLOCKS:
						val *= KB_PER_GB / (XLOG_BLCKSZ / 1024);
						break;
				}
3896 3897
			}
		}
3898 3899 3900 3901 3902
		else if (flags & GUC_UNIT_TIME)
		{
			/* Set hint for use if no match or trailing garbage */
			if (hintmsg)
				*hintmsg = gettext_noop("Valid units for this parameter are \"ms\", \"s\", \"min\", \"h\", and \"d\".");
3903

3904 3905 3906 3907 3908 3909 3910 3911 3912 3913 3914 3915 3916 3917 3918 3919 3920 3921 3922 3923 3924 3925 3926 3927 3928 3929 3930 3931 3932 3933 3934 3935 3936 3937 3938 3939 3940 3941 3942 3943 3944 3945 3946 3947 3948 3949 3950 3951 3952 3953 3954 3955 3956 3957 3958 3959 3960 3961 3962 3963 3964 3965 3966 3967 3968 3969 3970 3971 3972 3973 3974 3975
			if (strncmp(endptr, "ms", 2) == 0)
			{
				endptr += 2;
				switch (flags & GUC_UNIT_TIME)
				{
					case GUC_UNIT_S:
						val /= MS_PER_S;
						break;
					case GUC_UNIT_MIN:
						val /= MS_PER_MIN;
						break;
				}
			}
			else if (strncmp(endptr, "s", 1) == 0)
			{
				endptr += 1;
				switch (flags & GUC_UNIT_TIME)
				{
					case GUC_UNIT_MS:
						val *= MS_PER_S;
						break;
					case GUC_UNIT_MIN:
						val /= S_PER_MIN;
						break;
				}
			}
			else if (strncmp(endptr, "min", 3) == 0)
			{
				endptr += 3;
				switch (flags & GUC_UNIT_TIME)
				{
					case GUC_UNIT_MS:
						val *= MS_PER_MIN;
						break;
					case GUC_UNIT_S:
						val *= S_PER_MIN;
						break;
				}
			}
			else if (strncmp(endptr, "h", 1) == 0)
			{
				endptr += 1;
				switch (flags & GUC_UNIT_TIME)
				{
					case GUC_UNIT_MS:
						val *= MS_PER_H;
						break;
					case GUC_UNIT_S:
						val *= S_PER_H;
						break;
					case GUC_UNIT_MIN:
						val *= MIN_PER_H;
						break;
				}
			}
			else if (strncmp(endptr, "d", 1) == 0)
			{
				endptr += 1;
				switch (flags & GUC_UNIT_TIME)
				{
					case GUC_UNIT_MS:
						val *= MS_PER_D;
						break;
					case GUC_UNIT_S:
						val *= S_PER_D;
						break;
					case GUC_UNIT_MIN:
						val *= MIN_PER_D;
						break;
				}
			}
		}
3976

3977 3978
		/* allow whitespace after unit */
		while (isspace((unsigned char) *endptr))
3979 3980
			endptr++;

3981 3982
		if (*endptr != '\0')
			return false;		/* appropriate hint, if any, already set */
3983

3984 3985
		/* Check for overflow due to units conversion */
		if (val != (int64) ((int32) val))
3986
		{
3987 3988 3989
			if (hintmsg)
				*hintmsg = gettext_noop("Value exceeds integer range.");
			return false;
3990
		}
3991 3992
	}

3993 3994 3995 3996 3997 3998 3999 4000
	if (result)
		*result = (int) val;
	return true;
}



/*
4001 4002 4003
 * Try to parse value as a floating point number in the usual format.
 * If the string parses okay, return true, else false.
 * If okay and result is not NULL, return the value in *result.
4004 4005 4006 4007 4008 4009 4010
 */
static bool
parse_real(const char *value, double *result)
{
	double		val;
	char	   *endptr;

4011 4012 4013
	if (result)
		*result = 0;			/* suppress compiler warning */

4014 4015
	errno = 0;
	val = strtod(value, &endptr);
4016
	if (endptr == value || errno == ERANGE)
4017
		return false;
4018 4019 4020 4021 4022 4023 4024

	/* allow whitespace after number */
	while (isspace((unsigned char) *endptr))
		endptr++;
	if (*endptr != '\0')
		return false;

4025 4026 4027 4028 4029 4030
	if (result)
		*result = val;
	return true;
}


4031 4032 4033 4034 4035 4036 4037 4038 4039 4040 4041 4042 4043 4044 4045 4046 4047 4048 4049 4050 4051 4052 4053 4054 4055 4056 4057
/*
 * Call a GucStringAssignHook function, being careful to free the
 * "newval" string if the hook ereports.
 *
 * This is split out of set_config_option just to avoid the "volatile"
 * qualifiers that would otherwise have to be plastered all over.
 */
static const char *
call_string_assign_hook(GucStringAssignHook assign_hook,
						char *newval, bool doit, GucSource source)
{
	const char *result;

	PG_TRY();
	{
		result = (*assign_hook) (newval, doit, source);
	}
	PG_CATCH();
	{
		free(newval);
		PG_RE_THROW();
	}
	PG_END_TRY();

	return result;
}

4058

4059
/*
4060 4061 4062 4063 4064 4065 4066 4067 4068 4069 4070 4071 4072 4073 4074 4075 4076 4077 4078 4079
 * Sets option `name' to given value. The value should be a string
 * which is going to be parsed and converted to the appropriate data
 * type.  The context and source parameters indicate in which context this
 * function is being called so it can apply the access restrictions
 * properly.
 *
 * If value is NULL, set the option to its default value. If the
 * parameter changeVal is false then don't really set the option but do all
 * the checks to see if it would work.
 *
 * If there is an error (non-existing option, invalid value) then an
 * ereport(ERROR) is thrown *unless* this is called in a context where we
 * don't want to ereport (currently, startup or SIGHUP config file reread).
 * In that case we write a suitable error message via ereport(DEBUG) and
 * return false. This is working around the deficiencies in the ereport
 * mechanism, so don't blame me.  In all other cases, the function
 * returns true, including cases where the input is valid but we chose
 * not to apply it because of context or source-priority considerations.
 *
 * See also SetConfigOption for an external interface.
4080
 */
4081 4082 4083 4084
bool
set_config_option(const char *name, const char *value,
				  GucContext context, GucSource source,
				  bool isLocal, bool changeVal)
4085
{
4086 4087 4088
	struct config_generic *record;
	int			elevel;
	bool		makeDefault;
4089

4090 4091 4092 4093 4094 4095 4096 4097 4098 4099 4100 4101
	if (context == PGC_SIGHUP || source == PGC_S_DEFAULT)
	{
		/*
		 * To avoid cluttering the log, only the postmaster bleats loudly
		 * about problems with the config file.
		 */
		elevel = IsUnderPostmaster ? DEBUG2 : LOG;
	}
	else if (source == PGC_S_DATABASE || source == PGC_S_USER)
		elevel = INFO;
	else
		elevel = ERROR;
4102

4103 4104 4105 4106 4107 4108 4109
	record = find_option(name, elevel);
	if (record == NULL)
	{
		ereport(elevel,
				(errcode(ERRCODE_UNDEFINED_OBJECT),
			   errmsg("unrecognized configuration parameter \"%s\"", name)));
		return false;
4110 4111
	}

4112 4113 4114 4115 4116 4117 4118
	/*
	 * Do not replace a value that has been set on the command line by a SIGHUP
	 * reload
	 */
	if (context == PGC_SIGHUP && record->source == PGC_S_ARGV)
		return true;

4119 4120 4121 4122 4123
	/*
	 * Check if the option can be set at this time. See guc.h for the precise
	 * rules. Note that we don't want to throw errors if we're in the SIGHUP
	 * context. In that case we just ignore the attempt and return true.
	 */
4124 4125
	switch (record->context)
	{
4126
		case PGC_INTERNAL:
4127 4128
			if (context == PGC_SIGHUP)
				return true;
4129 4130
			if (context != PGC_INTERNAL)
			{
4131 4132
				ereport(elevel,
						(errcode(ERRCODE_CANT_CHANGE_RUNTIME_PARAM),
4133
						 errmsg("parameter \"%s\" cannot be changed",
4134
								name)));
4135 4136 4137
				return false;
			}
			break;
4138 4139
		case PGC_POSTMASTER:
			if (context == PGC_SIGHUP)
4140 4141 4142 4143 4144 4145
			{
				if (changeVal && !is_newvalue_equal(record, value))
					ereport(elevel,
							(errcode(ERRCODE_CANT_CHANGE_RUNTIME_PARAM),
							 errmsg("parameter \"%s\" cannot be changed after server start; configuration file change ignored",
									name)));
4146

4147 4148
				return true;
			}
4149 4150
			if (context != PGC_POSTMASTER)
			{
4151 4152
				ereport(elevel,
						(errcode(ERRCODE_CANT_CHANGE_RUNTIME_PARAM),
B
Bruce Momjian 已提交
4153
						 errmsg("parameter \"%s\" cannot be changed after server start",
4154
								name)));
4155 4156 4157 4158 4159 4160
				return false;
			}
			break;
		case PGC_SIGHUP:
			if (context != PGC_SIGHUP && context != PGC_POSTMASTER)
			{
4161 4162
				ereport(elevel,
						(errcode(ERRCODE_CANT_CHANGE_RUNTIME_PARAM),
4163
						 errmsg("parameter \"%s\" cannot be changed now",
4164
								name)));
4165 4166 4167 4168
				return false;
			}

			/*
B
Bruce Momjian 已提交
4169 4170 4171 4172
			 * Hmm, the idea of the SIGHUP context is "ought to be global, but
			 * can be changed after postmaster start". But there's nothing
			 * that prevents a crafty administrator from sending SIGHUP
			 * signals to individual backends only.
4173 4174 4175 4176 4177 4178
			 */
			break;
		case PGC_BACKEND:
			if (context == PGC_SIGHUP)
			{
				/*
B
Bruce Momjian 已提交
4179 4180 4181 4182 4183 4184
				 * If a PGC_BACKEND parameter is changed in the config file,
				 * we want to accept the new value in the postmaster (whence
				 * it will propagate to subsequently-started backends), but
				 * ignore it in existing backends.	This is a tad klugy, but
				 * necessary because we don't re-read the config file during
				 * backend start.
4185 4186
				 */
				if (IsUnderPostmaster)
4187
					return true;
4188 4189 4190
			}
			else if (context != PGC_BACKEND && context != PGC_POSTMASTER)
			{
4191 4192
				ereport(elevel,
						(errcode(ERRCODE_CANT_CHANGE_RUNTIME_PARAM),
B
Bruce Momjian 已提交
4193
						 errmsg("parameter \"%s\" cannot be set after connection start",
4194
								name)));
4195 4196 4197 4198 4199 4200
				return false;
			}
			break;
		case PGC_SUSET:
			if (context == PGC_USERSET || context == PGC_BACKEND)
			{
4201 4202
				ereport(elevel,
						(errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
B
Bruce Momjian 已提交
4203
						 errmsg("permission denied to set parameter \"%s\"",
4204
								name)));
4205
				return false;
4206 4207 4208 4209 4210
			}
			break;
		case PGC_USERSET:
			/* always okay */
			break;
4211
	}
4212

4213
	/*
4214 4215 4216 4217
	 * Should we set reset/stacked values?  (If so, the behavior is not
	 * transactional.)  This is done either when we get a default
	 * value from the database's/user's/client's default settings or
	 * when we reset a value to its default.
4218
	 */
4219 4220
	makeDefault = changeVal && (source <= PGC_S_OVERRIDE)
					&& ((value != NULL) || source == PGC_S_DEFAULT);
4221 4222

	/*
4223 4224 4225 4226 4227 4228 4229 4230
	 * Ignore attempted set if overridden by previously processed
	 * setting.  However, if changeVal is false then plow ahead anyway
	 * since we are trying to find out if the value is potentially
	 * good, not actually use it.  Also keep going if makeDefault is
	 * true, since we may want to set the reset/stacked values even if
	 * we can't set the variable itself.  There's one exception to
	 * this rule: if we want to apply the default value to variables
	 * that were removed from the configuration file.  This is
4231
	 * indicated by source == PGC_S_DEFAULT and context == PGC_SIGHUP.
4232
	 */
4233 4234
	if (record->source > source
		&& !(source == PGC_S_DEFAULT && context == PGC_SIGHUP))
4235
	{
4236
		if (changeVal && !makeDefault)
4237
		{
4238
			elog(DEBUG3, "\"%s\": setting ignored because previous source is higher priority",
4239 4240 4241
				 name);
			return true;
		}
4242
		changeVal = false;
4243 4244
	}

4245
	/*
4246
	 * Evaluate value and set variable.
4247
	 */
4248
	switch (record->vartype)
4249 4250 4251
	{
		case PGC_BOOL:
			{
B
Bruce Momjian 已提交
4252
				struct config_bool *conf = (struct config_bool *) record;
4253
				bool		newval;
4254 4255 4256 4257 4258 4259 4260 4261 4262 4263 4264 4265

				if (value)
				{
					if (!parse_bool(value, &newval))
					{
						ereport(elevel,
								(errcode(ERRCODE_INVALID_PARAMETER_VALUE),
						  errmsg("parameter \"%s\" requires a Boolean value",
								 name)));
						return false;
					}
				}
4266 4267 4268 4269 4270 4271 4272 4273
				/*
				 * If value == NULL and source == PGC_S_DEFAULT then
				 * we reset some value to its default (removed from
				 * configuration file).
				 */
				else if (source == PGC_S_DEFAULT)
					newval = conf->boot_val;
				/* else we handle a "RESET varname" command */
4274 4275 4276 4277 4278 4279 4280 4281 4282 4283 4284 4285 4286 4287 4288
				else
				{
					newval = conf->reset_val;
					source = conf->gen.reset_source;
				}

				if (conf->assign_hook)
					if (!(*conf->assign_hook) (newval, changeVal, source))
					{
						ereport(elevel,
								(errcode(ERRCODE_INVALID_PARAMETER_VALUE),
							 errmsg("invalid value for parameter \"%s\": %d",
									name, (int) newval)));
						return false;
					}
4289

4290
				if (changeVal || makeDefault)
4291
				{
4292 4293 4294
					/* Save old value to support transaction abort */
					if (!makeDefault)
						push_old_value(&conf->gen);
4295
					if (changeVal)
4296
					{
4297 4298 4299 4300 4301
						*conf->variable = newval;
						conf->gen.source = source;
					}
					if (makeDefault)
					{
B
Bruce Momjian 已提交
4302
						GucStack   *stack;
4303

4304 4305 4306 4307 4308
						if (conf->gen.reset_source <= source)
						{
							conf->reset_val = newval;
							conf->gen.reset_source = source;
						}
4309
						for (stack = conf->gen.stack; stack; stack = stack->prev)
4310
						{
4311 4312 4313 4314 4315
							if (stack->source <= source)
							{
								stack->value.boolval = newval;
								stack->source = source;
							}
4316 4317 4318 4319 4320 4321 4322 4323 4324 4325 4326 4327 4328
						}
					}
					else if (isLocal)
					{
						conf->gen.status |= GUC_HAVE_LOCAL;
						guc_dirty = true;
					}
					else
					{
						conf->tentative_val = newval;
						conf->gen.tentative_source = source;
						conf->gen.status |= GUC_HAVE_TENTATIVE;
						guc_dirty = true;
4329
					}
4330
				}
B
Bruce Momjian 已提交
4331
				break;
4332
			}
4333 4334

		case PGC_INT:
4335
			{
B
Bruce Momjian 已提交
4336
				struct config_int *conf = (struct config_int *) record;
4337
				int			newval;
4338

4339 4340
				if (value)
				{
4341 4342 4343
					const char *hintmsg;

					if (!parse_int(value, &newval, conf->gen.flags, &hintmsg))
4344 4345 4346
					{
						ereport(elevel,
								(errcode(ERRCODE_INVALID_PARAMETER_VALUE),
4347 4348 4349
								 errmsg("invalid value for parameter \"%s\": \"%s\"",
										name, value),
								 hintmsg ? errhint(hintmsg) : 0));
4350 4351 4352 4353 4354 4355 4356 4357 4358 4359 4360
						return false;
					}
					if (newval < conf->min || newval > conf->max)
					{
						ereport(elevel,
								(errcode(ERRCODE_INVALID_PARAMETER_VALUE),
								 errmsg("%d is outside the valid range for parameter \"%s\" (%d .. %d)",
										newval, name, conf->min, conf->max)));
						return false;
					}
				}
4361 4362 4363 4364 4365 4366 4367 4368
				/*
				 * If value == NULL and source == PGC_S_DEFAULT then
				 * we reset some value to its default (removed from
				 * configuration file).
				 */
				else if (source == PGC_S_DEFAULT)
					newval = conf->boot_val;
				/* else we handle a "RESET varname" command */
4369 4370 4371 4372 4373 4374 4375 4376 4377 4378 4379 4380 4381 4382 4383
				else
				{
					newval = conf->reset_val;
					source = conf->gen.reset_source;
				}

				if (conf->assign_hook)
					if (!(*conf->assign_hook) (newval, changeVal, source))
					{
						ereport(elevel,
								(errcode(ERRCODE_INVALID_PARAMETER_VALUE),
							 errmsg("invalid value for parameter \"%s\": %d",
									name, newval)));
						return false;
					}
4384

4385
				if (changeVal || makeDefault)
4386
				{
4387 4388 4389
					/* Save old value to support transaction abort */
					if (!makeDefault)
						push_old_value(&conf->gen);
4390
					if (changeVal)
4391
					{
4392 4393 4394 4395 4396
						*conf->variable = newval;
						conf->gen.source = source;
					}
					if (makeDefault)
					{
B
Bruce Momjian 已提交
4397
						GucStack   *stack;
4398

4399 4400 4401 4402 4403
						if (conf->gen.reset_source <= source)
						{
							conf->reset_val = newval;
							conf->gen.reset_source = source;
						}
4404
						for (stack = conf->gen.stack; stack; stack = stack->prev)
4405
						{
4406 4407 4408 4409 4410
							if (stack->source <= source)
							{
								stack->value.intval = newval;
								stack->source = source;
							}
4411 4412 4413 4414 4415 4416 4417 4418 4419 4420 4421 4422 4423
						}
					}
					else if (isLocal)
					{
						conf->gen.status |= GUC_HAVE_LOCAL;
						guc_dirty = true;
					}
					else
					{
						conf->tentative_val = newval;
						conf->gen.tentative_source = source;
						conf->gen.status |= GUC_HAVE_TENTATIVE;
						guc_dirty = true;
4424
					}
4425
				}
B
Bruce Momjian 已提交
4426
				break;
4427
			}
4428 4429

		case PGC_REAL:
4430
			{
B
Bruce Momjian 已提交
4431
				struct config_real *conf = (struct config_real *) record;
4432
				double		newval;
4433

4434 4435 4436 4437 4438 4439 4440 4441 4442 4443 4444 4445 4446 4447 4448 4449 4450 4451 4452
				if (value)
				{
					if (!parse_real(value, &newval))
					{
						ereport(elevel,
								(errcode(ERRCODE_INVALID_PARAMETER_VALUE),
						  errmsg("parameter \"%s\" requires a numeric value",
								 name)));
						return false;
					}
					if (newval < conf->min || newval > conf->max)
					{
						ereport(elevel,
								(errcode(ERRCODE_INVALID_PARAMETER_VALUE),
								 errmsg("%g is outside the valid range for parameter \"%s\" (%g .. %g)",
										newval, name, conf->min, conf->max)));
						return false;
					}
				}
4453 4454 4455 4456 4457 4458 4459 4460
				/*
				 * If value == NULL and source == PGC_S_DEFAULT then
				 * we reset some value to its default (removed from
				 * configuration file).
				 */
				else if (source == PGC_S_DEFAULT)
					newval = conf->boot_val;
				/* else we handle a "RESET varname" command */
4461 4462 4463 4464 4465 4466 4467 4468 4469 4470 4471 4472 4473 4474 4475
				else
				{
					newval = conf->reset_val;
					source = conf->gen.reset_source;
				}

				if (conf->assign_hook)
					if (!(*conf->assign_hook) (newval, changeVal, source))
					{
						ereport(elevel,
								(errcode(ERRCODE_INVALID_PARAMETER_VALUE),
							 errmsg("invalid value for parameter \"%s\": %g",
									name, newval)));
						return false;
					}
4476

4477
				if (changeVal || makeDefault)
4478
				{
4479 4480 4481
					/* Save old value to support transaction abort */
					if (!makeDefault)
						push_old_value(&conf->gen);
4482
					if (changeVal)
4483
					{
4484 4485 4486 4487 4488
						*conf->variable = newval;
						conf->gen.source = source;
					}
					if (makeDefault)
					{
B
Bruce Momjian 已提交
4489
						GucStack   *stack;
4490

4491 4492 4493 4494 4495
						if (conf->gen.reset_source <= source)
						{
							conf->reset_val = newval;
							conf->gen.reset_source = source;
						}
4496
						for (stack = conf->gen.stack; stack; stack = stack->prev)
4497
						{
4498 4499 4500 4501 4502
							if (stack->source <= source)
							{
								stack->value.realval = newval;
								stack->source = source;
							}
4503 4504 4505 4506 4507 4508 4509 4510 4511 4512 4513 4514 4515
						}
					}
					else if (isLocal)
					{
						conf->gen.status |= GUC_HAVE_LOCAL;
						guc_dirty = true;
					}
					else
					{
						conf->tentative_val = newval;
						conf->gen.tentative_source = source;
						conf->gen.status |= GUC_HAVE_TENTATIVE;
						guc_dirty = true;
4516
					}
4517
				}
B
Bruce Momjian 已提交
4518
				break;
4519
			}
4520 4521 4522

		case PGC_STRING:
			{
B
Bruce Momjian 已提交
4523
				struct config_string *conf = (struct config_string *) record;
4524
				char	   *newval;
B
Bruce Momjian 已提交
4525

4526 4527 4528 4529 4530
				if (value)
				{
					newval = guc_strdup(elevel, value);
					if (newval == NULL)
						return false;
B
Bruce Momjian 已提交
4531

4532
					/*
B
Bruce Momjian 已提交
4533 4534
					 * The only sort of "parsing" check we need to do is apply
					 * truncation if GUC_IS_NAME.
4535 4536 4537 4538
					 */
					if (conf->gen.flags & GUC_IS_NAME)
						truncate_identifier(newval, strlen(newval), true);
				}
4539 4540 4541 4542 4543 4544 4545 4546 4547 4548 4549 4550 4551 4552 4553 4554 4555
				/*
				 * If value == NULL and source == PGC_S_DEFAULT then
				 * we reset some value to its default (removed from
				 * configuration file).
				 */
				else if (source == PGC_S_DEFAULT)
				{
					if (conf->boot_val == NULL)
						newval = NULL;
					else
					{
						newval = guc_strdup(elevel, conf->boot_val);
						if (newval == NULL)
							return false;
					}
				}
				/* else we handle a "RESET varname" command */
4556 4557 4558 4559 4560 4561 4562 4563 4564 4565 4566 4567 4568 4569 4570 4571 4572 4573 4574 4575 4576 4577 4578 4579 4580 4581 4582 4583 4584 4585 4586 4587 4588 4589 4590 4591 4592 4593 4594 4595 4596 4597 4598 4599 4600 4601 4602 4603 4604 4605 4606 4607 4608
				else if (conf->reset_val)
				{
					/*
					 * We could possibly avoid strdup here, but easier to make
					 * this case work the same as the normal assignment case.
					 */
					newval = guc_strdup(elevel, conf->reset_val);
					if (newval == NULL)
						return false;
					source = conf->gen.reset_source;
				}
				else
				{
					/* Nothing to reset to, as yet; so do nothing */
					break;
				}

				if (conf->assign_hook)
				{
					const char *hookresult;

					/*
					 * If the hook ereports, we have to make sure we free
					 * newval, else it will be a permanent memory leak.
					 */
					hookresult = call_string_assign_hook(conf->assign_hook,
														 newval,
														 changeVal,
														 source);
					if (hookresult == NULL)
					{
						free(newval);
						ereport(elevel,
								(errcode(ERRCODE_INVALID_PARAMETER_VALUE),
						 errmsg("invalid value for parameter \"%s\": \"%s\"",
								name, value ? value : "")));
						return false;
					}
					else if (hookresult != newval)
					{
						free(newval);

						/*
						 * Having to cast away const here is annoying, but the
						 * alternative is to declare assign_hooks as returning
						 * char*, which would mean they'd have to cast away
						 * const, or as both taking and returning char*, which
						 * doesn't seem attractive either --- we don't want
						 * them to scribble on the passed str.
						 */
						newval = (char *) hookresult;
					}
				}
4609

4610
				if (changeVal || makeDefault)
4611
				{
4612 4613 4614
					/* Save old value to support transaction abort */
					if (!makeDefault)
						push_old_value(&conf->gen);
4615
					if (changeVal)
4616
					{
4617
						set_string_field(conf, conf->variable, newval);
4618 4619 4620 4621
						conf->gen.source = source;
					}
					if (makeDefault)
					{
B
Bruce Momjian 已提交
4622
						GucStack   *stack;
4623

4624
						if (conf->gen.reset_source <= source)
B
Bruce Momjian 已提交
4625
						{
4626
							set_string_field(conf, &conf->reset_val, newval);
4627
							conf->gen.reset_source = source;
B
Bruce Momjian 已提交
4628
						}
4629
						for (stack = conf->gen.stack; stack; stack = stack->prev)
4630
						{
4631 4632 4633 4634 4635 4636
							if (stack->source <= source)
							{
								set_string_field(conf, &stack->value.stringval,
												 newval);
								stack->source = source;
							}
4637
						}
4638
						/* Perhaps we didn't install newval anywhere */
4639
						if (!string_field_used(conf, newval))
4640
							free(newval);
B
Bruce Momjian 已提交
4641
					}
4642
					else if (isLocal)
4643
					{
4644 4645
						conf->gen.status |= GUC_HAVE_LOCAL;
						guc_dirty = true;
4646
					}
4647
					else
4648
					{
4649
						set_string_field(conf, &conf->tentative_val, newval);
4650 4651 4652
						conf->gen.tentative_source = source;
						conf->gen.status |= GUC_HAVE_TENTATIVE;
						guc_dirty = true;
4653
					}
4654 4655
				}
				else
4656
					free(newval);
B
Bruce Momjian 已提交
4657
				break;
4658
			}
4659
	}
4660

4661
	if (changeVal && (record->flags & GUC_REPORT))
4662
		ReportGUCOption(record);
4663

4664 4665 4666 4667 4668 4669
	return true;
}


/*
 * Set a config option to the given value. See also set_config_option,
B
Bruce Momjian 已提交
4670
 * this is just the wrapper to be called from outside GUC.	NB: this
4671
 * is used only for non-transactional operations.
4672 4673
 */
void
4674
SetConfigOption(const char *name, const char *value,
4675
				GucContext context, GucSource source)
4676
{
4677
	(void) set_config_option(name, value, context, source, false, true);
4678 4679 4680 4681 4682
}



/*
4683
 * Fetch the current value of the option `name'. If the option doesn't exist,
4684
 * throw an ereport and don't return.
4685 4686 4687 4688 4689
 *
 * The string is *not* allocated for modification and is really only
 * valid until the next call to configuration related functions.
 */
const char *
B
Bruce Momjian 已提交
4690
GetConfigOption(const char *name)
4691
{
B
Bruce Momjian 已提交
4692
	struct config_generic *record;
4693 4694
	static char buffer[256];

4695
	record = find_option(name, ERROR);
4696
	if (record == NULL)
4697 4698
		ereport(ERROR,
				(errcode(ERRCODE_UNDEFINED_OBJECT),
B
Bruce Momjian 已提交
4699
			   errmsg("unrecognized configuration parameter \"%s\"", name)));
4700 4701 4702 4703
	if ((record->flags & GUC_SUPERUSER_ONLY) && !superuser())
		ereport(ERROR,
				(errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
				 errmsg("must be superuser to examine \"%s\"", name)));
4704

4705
	switch (record->vartype)
4706 4707
	{
		case PGC_BOOL:
B
Bruce Momjian 已提交
4708
			return *((struct config_bool *) record)->variable ? "on" : "off";
4709

4710
		case PGC_INT:
4711 4712
			snprintf(buffer, sizeof(buffer), "%d",
					 *((struct config_int *) record)->variable);
4713 4714
			return buffer;

4715
		case PGC_REAL:
4716 4717
			snprintf(buffer, sizeof(buffer), "%g",
					 *((struct config_real *) record)->variable);
4718 4719 4720
			return buffer;

		case PGC_STRING:
B
Bruce Momjian 已提交
4721
			return *((struct config_string *) record)->variable;
4722 4723 4724
	}
	return NULL;
}
4725

4726 4727 4728 4729 4730
/*
 * Get the RESET value associated with the given option.
 */
const char *
GetConfigOptionResetString(const char *name)
4731
{
4732 4733
	struct config_generic *record;
	static char buffer[256];
4734

4735
	record = find_option(name, ERROR);
4736
	if (record == NULL)
4737 4738
		ereport(ERROR,
				(errcode(ERRCODE_UNDEFINED_OBJECT),
B
Bruce Momjian 已提交
4739
			   errmsg("unrecognized configuration parameter \"%s\"", name)));
4740 4741 4742 4743
	if ((record->flags & GUC_SUPERUSER_ONLY) && !superuser())
		ereport(ERROR,
				(errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
				 errmsg("must be superuser to examine \"%s\"", name)));
4744 4745

	switch (record->vartype)
4746 4747
	{
		case PGC_BOOL:
4748
			return ((struct config_bool *) record)->reset_val ? "on" : "off";
4749

4750
		case PGC_INT:
4751
			snprintf(buffer, sizeof(buffer), "%d",
4752 4753
					 ((struct config_int *) record)->reset_val);
			return buffer;
4754 4755

		case PGC_REAL:
4756
			snprintf(buffer, sizeof(buffer), "%g",
4757 4758
					 ((struct config_real *) record)->reset_val);
			return buffer;
4759 4760

		case PGC_STRING:
4761 4762 4763 4764
			return ((struct config_string *) record)->reset_val;
	}
	return NULL;
}
4765

4766 4767 4768 4769 4770 4771 4772 4773 4774 4775 4776 4777 4778 4779 4780
/*
 * Detect whether the given configuration option can only be set by
 * a superuser.
 */
bool
IsSuperuserConfigOption(const char *name)
{
	struct config_generic *record;

	record = find_option(name, ERROR);
	/* On an unrecognized name, don't error, just return false. */
	if (record == NULL)
		return false;
	return (record->context == PGC_SUSET);
}
4781 4782 4783 4784 4785 4786 4787 4788 4789 4790 4791 4792 4793 4794 4795 4796 4797 4798 4799


/*
 * flatten_set_variable_args
 *		Given a parsenode List as emitted by the grammar for SET,
 *		convert to the flat string representation used by GUC.
 *
 * We need to be told the name of the variable the args are for, because
 * the flattening rules vary (ugh).
 *
 * The result is NULL if input is NIL (ie, SET ... TO DEFAULT), otherwise
 * a palloc'd string.
 */
char *
flatten_set_variable_args(const char *name, List *args)
{
	struct config_generic *record;
	int			flags;
	StringInfoData buf;
4800
	ListCell   *l;
4801

4802
	/*
B
Bruce Momjian 已提交
4803 4804
	 * Fast path if just DEFAULT.  We do not check the variable name in this
	 * case --- necessary for RESET ALL to work correctly.
4805
	 */
4806 4807 4808
	if (args == NIL)
		return NULL;

4809
	/* Else get flags for the variable */
4810
	record = find_option(name, ERROR);
4811
	if (record == NULL)
4812 4813
		ereport(ERROR,
				(errcode(ERRCODE_UNDEFINED_OBJECT),
B
Bruce Momjian 已提交
4814
			   errmsg("unrecognized configuration parameter \"%s\"", name)));
4815 4816

	flags = record->flags;
4817 4818 4819

	/* Complain if list input and non-list variable */
	if ((flags & GUC_LIST_INPUT) == 0 &&
4820
		list_length(args) != 1)
4821 4822 4823
		ereport(ERROR,
				(errcode(ERRCODE_INVALID_PARAMETER_VALUE),
				 errmsg("SET %s takes only one argument", name)));
4824 4825 4826 4827 4828 4829 4830 4831

	initStringInfo(&buf);

	foreach(l, args)
	{
		A_Const    *arg = (A_Const *) lfirst(l);
		char	   *val;

4832
		if (l != list_head(args))
4833 4834 4835
			appendStringInfo(&buf, ", ");

		if (!IsA(arg, A_Const))
4836
			elog(ERROR, "unrecognized node type: %d", (int) nodeTag(arg));
4837 4838 4839 4840 4841 4842 4843 4844

		switch (nodeTag(&arg->val))
		{
			case T_Integer:
				appendStringInfo(&buf, "%ld", intVal(&arg->val));
				break;
			case T_Float:
				/* represented as a string, so just copy it */
N
Neil Conway 已提交
4845
				appendStringInfoString(&buf, strVal(&arg->val));
4846 4847 4848 4849 4850 4851
				break;
			case T_String:
				val = strVal(&arg->val);
				if (arg->typename != NULL)
				{
					/*
B
Bruce Momjian 已提交
4852 4853 4854
					 * Must be a ConstInterval argument for TIME ZONE. Coerce
					 * to interval and back to normalize the value and account
					 * for any typmod.
4855
					 */
4856
					int32		typmod;
B
Bruce Momjian 已提交
4857
					Datum		interval;
B
Bruce Momjian 已提交
4858
					char	   *intervalout;
4859

4860 4861
					typmod = typenameTypeMod(NULL, arg->typename, INTERVALOID);

4862
					interval =
B
Bruce Momjian 已提交
4863 4864 4865
						DirectFunctionCall3(interval_in,
											CStringGetDatum(val),
											ObjectIdGetDatum(InvalidOid),
4866
											Int32GetDatum(typmod));
4867 4868

					intervalout =
4869 4870
						DatumGetCString(DirectFunctionCall1(interval_out,
															interval));
4871 4872 4873 4874 4875
					appendStringInfo(&buf, "INTERVAL '%s'", intervalout);
				}
				else
				{
					/*
B
Bruce Momjian 已提交
4876 4877
					 * Plain string literal or identifier.	For quote mode,
					 * quote it if it's not a vanilla identifier.
4878 4879
					 */
					if (flags & GUC_LIST_QUOTE)
N
Neil Conway 已提交
4880
						appendStringInfoString(&buf, quote_identifier(val));
4881
					else
N
Neil Conway 已提交
4882
						appendStringInfoString(&buf, val);
4883 4884 4885
				}
				break;
			default:
4886 4887
				elog(ERROR, "unrecognized node type: %d",
					 (int) nodeTag(&arg->val));
4888 4889
				break;
		}
4890
	}
4891 4892 4893 4894 4895 4896 4897 4898 4899 4900 4901 4902 4903 4904 4905 4906 4907 4908 4909 4910 4911 4912

	return buf.data;
}


/*
 * SET command
 */
void
SetPGVariable(const char *name, List *args, bool is_local)
{
	char	   *argstring = flatten_set_variable_args(name, args);

	/* Note SET DEFAULT (argstring == NULL) is equivalent to RESET */
	set_config_option(name,
					  argstring,
					  (superuser() ? PGC_SUSET : PGC_USERSET),
					  PGC_S_SESSION,
					  is_local,
					  true);
}

4913 4914 4915 4916 4917 4918
/*
 * SET command wrapped as a SQL callable function.
 */
Datum
set_config_by_name(PG_FUNCTION_ARGS)
{
B
Bruce Momjian 已提交
4919 4920 4921 4922 4923
	char	   *name;
	char	   *value;
	char	   *new_value;
	bool		is_local;
	text	   *result_text;
4924 4925

	if (PG_ARGISNULL(0))
4926 4927
		ereport(ERROR,
				(errcode(ERRCODE_NULL_VALUE_NOT_ALLOWED),
4928
				 errmsg("SET requires parameter name")));
4929 4930

	/* Get the GUC variable name */
4931
	name = DatumGetCString(DirectFunctionCall1(textout, PG_GETARG_DATUM(0)));
4932 4933 4934 4935 4936

	/* Get the desired value or set to NULL for a reset request */
	if (PG_ARGISNULL(1))
		value = NULL;
	else
4937
		value = DatumGetCString(DirectFunctionCall1(textout, PG_GETARG_DATUM(1)));
4938 4939

	/*
B
Bruce Momjian 已提交
4940 4941
	 * Get the desired state of is_local. Default to false if provided value
	 * is NULL
4942 4943 4944 4945 4946 4947 4948 4949 4950 4951 4952 4953 4954 4955 4956
	 */
	if (PG_ARGISNULL(2))
		is_local = false;
	else
		is_local = PG_GETARG_BOOL(2);

	/* Note SET DEFAULT (argstring == NULL) is equivalent to RESET */
	set_config_option(name,
					  value,
					  (superuser() ? PGC_SUSET : PGC_USERSET),
					  PGC_S_SESSION,
					  is_local,
					  true);

	/* get the new current value */
4957
	new_value = GetConfigOptionByName(name, NULL);
4958 4959 4960 4961 4962 4963 4964 4965

	/* Convert return string to text */
	result_text = DatumGetTextP(DirectFunctionCall1(textin, CStringGetDatum(new_value)));

	/* return it */
	PG_RETURN_TEXT_P(result_text);
}

4966
static void
B
Bruce Momjian 已提交
4967
define_custom_variable(struct config_generic * variable)
4968
{
B
Bruce Momjian 已提交
4969 4970 4971 4972 4973
	const char *name = variable->name;
	const char **nameAddr = &name;
	const char *value;
	struct config_string *pHolder;
	struct config_generic **res = (struct config_generic **) bsearch(
B
Bruce Momjian 已提交
4974 4975 4976 4977 4978
														  (void *) &nameAddr,
													  (void *) guc_variables,
														   num_guc_variables,
											 sizeof(struct config_generic *),
															guc_var_compare);
B
Bruce Momjian 已提交
4979 4980

	if (res == NULL)
4981
	{
4982
		add_guc_variable(variable, ERROR);
4983 4984 4985
		return;
	}

B
Bruce Momjian 已提交
4986 4987
	/*
	 * This better be a placeholder
4988
	 */
B
Bruce Momjian 已提交
4989
	if (((*res)->flags & GUC_CUSTOM_PLACEHOLDER) == 0)
4990 4991 4992
		ereport(ERROR,
				(errcode(ERRCODE_INTERNAL_ERROR),
				 errmsg("attempt to redefine parameter \"%s\"", name)));
4993 4994

	Assert((*res)->vartype == PGC_STRING);
B
Bruce Momjian 已提交
4995 4996
	pHolder = (struct config_string *) * res;

4997
	/* We have the same name, no sorting is necessary */
4998 4999 5000 5001
	*res = variable;

	value = *pHolder->variable;

5002
	/*
B
Bruce Momjian 已提交
5003
	 * Assign the string value stored in the placeholder to the real variable.
5004 5005 5006 5007
	 *
	 * XXX this is not really good enough --- it should be a nontransactional
	 * assignment, since we don't want it to roll back if the current xact
	 * fails later.
5008 5009
	 */
	set_config_option(name, value,
B
Bruce Momjian 已提交
5010 5011
					  pHolder->gen.context, pHolder->gen.source,
					  false, true);
5012

5013 5014 5015
	/*
	 * Free up as much as we conveniently can of the placeholder structure
	 * (this neglects any stack items...)
5016
	 */
5017 5018 5019
	set_string_field(pHolder, pHolder->variable, NULL);
	set_string_field(pHolder, &pHolder->reset_val, NULL);
	set_string_field(pHolder, &pHolder->tentative_val, NULL);
5020 5021 5022 5023

	free(pHolder);
}

B
Bruce Momjian 已提交
5024
static void
5025
init_custom_variable(struct config_generic * gen,
B
Bruce Momjian 已提交
5026 5027 5028 5029 5030
					 const char *name,
					 const char *short_desc,
					 const char *long_desc,
					 GucContext context,
					 enum config_type type)
5031
{
B
Bruce Momjian 已提交
5032 5033 5034
	gen->name = guc_strdup(ERROR, name);
	gen->context = context;
	gen->group = CUSTOM_OPTIONS;
5035
	gen->short_desc = short_desc;
B
Bruce Momjian 已提交
5036 5037
	gen->long_desc = long_desc;
	gen->vartype = type;
5038 5039
}

B
Bruce Momjian 已提交
5040
void
5041
DefineCustomBoolVariable(const char *name,
B
Bruce Momjian 已提交
5042 5043 5044 5045 5046 5047
						 const char *short_desc,
						 const char *long_desc,
						 bool *valueAddr,
						 GucContext context,
						 GucBoolAssignHook assign_hook,
						 GucShowHook show_hook)
5048
{
B
Bruce Momjian 已提交
5049 5050
	size_t		sz = sizeof(struct config_bool);
	struct config_bool *var = (struct config_bool *) guc_malloc(ERROR, sz);
5051 5052 5053 5054

	memset(var, 0, sz);
	init_custom_variable(&var->gen, name, short_desc, long_desc, context, PGC_BOOL);

B
Bruce Momjian 已提交
5055 5056
	var->variable = valueAddr;
	var->reset_val = *valueAddr;
5057
	var->assign_hook = assign_hook;
B
Bruce Momjian 已提交
5058
	var->show_hook = show_hook;
5059 5060 5061
	define_custom_variable(&var->gen);
}

B
Bruce Momjian 已提交
5062
void
5063
DefineCustomIntVariable(const char *name,
B
Bruce Momjian 已提交
5064 5065 5066
						const char *short_desc,
						const char *long_desc,
						int *valueAddr,
5067 5068
						int minValue,
						int maxValue,
B
Bruce Momjian 已提交
5069 5070 5071
						GucContext context,
						GucIntAssignHook assign_hook,
						GucShowHook show_hook)
5072
{
B
Bruce Momjian 已提交
5073 5074
	size_t		sz = sizeof(struct config_int);
	struct config_int *var = (struct config_int *) guc_malloc(ERROR, sz);
5075 5076 5077 5078

	memset(var, 0, sz);
	init_custom_variable(&var->gen, name, short_desc, long_desc, context, PGC_INT);

B
Bruce Momjian 已提交
5079 5080
	var->variable = valueAddr;
	var->reset_val = *valueAddr;
5081 5082
	var->min = minValue;
	var->max = maxValue;
5083
	var->assign_hook = assign_hook;
B
Bruce Momjian 已提交
5084
	var->show_hook = show_hook;
5085 5086 5087
	define_custom_variable(&var->gen);
}

B
Bruce Momjian 已提交
5088
void
5089
DefineCustomRealVariable(const char *name,
B
Bruce Momjian 已提交
5090 5091 5092
						 const char *short_desc,
						 const char *long_desc,
						 double *valueAddr,
5093 5094
						 double minValue,
						 double maxValue,
B
Bruce Momjian 已提交
5095 5096 5097
						 GucContext context,
						 GucRealAssignHook assign_hook,
						 GucShowHook show_hook)
5098
{
B
Bruce Momjian 已提交
5099 5100
	size_t		sz = sizeof(struct config_real);
	struct config_real *var = (struct config_real *) guc_malloc(ERROR, sz);
5101 5102 5103 5104

	memset(var, 0, sz);
	init_custom_variable(&var->gen, name, short_desc, long_desc, context, PGC_REAL);

B
Bruce Momjian 已提交
5105 5106
	var->variable = valueAddr;
	var->reset_val = *valueAddr;
5107 5108
	var->min = minValue;
	var->max = maxValue;
5109
	var->assign_hook = assign_hook;
B
Bruce Momjian 已提交
5110
	var->show_hook = show_hook;
5111 5112 5113
	define_custom_variable(&var->gen);
}

B
Bruce Momjian 已提交
5114
void
5115
DefineCustomStringVariable(const char *name,
B
Bruce Momjian 已提交
5116 5117 5118 5119 5120 5121
						   const char *short_desc,
						   const char *long_desc,
						   char **valueAddr,
						   GucContext context,
						   GucStringAssignHook assign_hook,
						   GucShowHook show_hook)
5122
{
B
Bruce Momjian 已提交
5123 5124
	size_t		sz = sizeof(struct config_string);
	struct config_string *var = (struct config_string *) guc_malloc(ERROR, sz);
5125 5126 5127 5128

	memset(var, 0, sz);
	init_custom_variable(&var->gen, name, short_desc, long_desc, context, PGC_STRING);

B
Bruce Momjian 已提交
5129 5130
	var->variable = valueAddr;
	var->reset_val = *valueAddr;
5131
	var->assign_hook = assign_hook;
B
Bruce Momjian 已提交
5132
	var->show_hook = show_hook;
5133 5134 5135
	define_custom_variable(&var->gen);
}

N
Neil Conway 已提交
5136
void
B
Bruce Momjian 已提交
5137
EmitWarningsOnPlaceholders(const char *className)
5138
{
B
Bruce Momjian 已提交
5139 5140 5141 5142
	struct config_generic **vars = guc_variables;
	struct config_generic **last = vars + num_guc_variables;

	int			nameLen = strlen(className);
5143

B
Bruce Momjian 已提交
5144
	while (vars < last)
5145
	{
B
Bruce Momjian 已提交
5146 5147 5148 5149 5150
		struct config_generic *var = *vars++;

		if ((var->flags & GUC_CUSTOM_PLACEHOLDER) != 0 &&
			strncmp(className, var->name, nameLen) == 0 &&
			var->name[nameLen] == GUC_QUALIFIER_SEPARATOR)
5151 5152
		{
			ereport(INFO,
B
Bruce Momjian 已提交
5153 5154
					(errcode(ERRCODE_UNDEFINED_OBJECT),
					 errmsg("unrecognized configuration parameter \"%s\"", var->name)));
5155 5156 5157 5158 5159
		}
	}
}


5160 5161 5162 5163
/*
 * SHOW command
 */
void
5164
GetPGVariable(const char *name, DestReceiver *dest)
5165
{
5166
	if (pg_strcasecmp(name, "all") == 0)
5167
		ShowAllGUCConfig(dest);
5168
	else
5169 5170 5171 5172 5173 5174 5175 5176
		ShowGUCConfigOption(name, dest);
}

TupleDesc
GetPGVariableResultDesc(const char *name)
{
	TupleDesc	tupdesc;

5177
	if (pg_strcasecmp(name, "all") == 0)
5178
	{
5179 5180
		/* need a tuple descriptor representing three TEXT columns */
		tupdesc = CreateTemplateTupleDesc(3, false);
5181
		TupleDescInitEntry(tupdesc, (AttrNumber) 1, "name",
5182
						   TEXTOID, -1, 0);
5183
		TupleDescInitEntry(tupdesc, (AttrNumber) 2, "setting",
5184
						   TEXTOID, -1, 0);
5185 5186 5187
		TupleDescInitEntry(tupdesc, (AttrNumber) 3, "description",
						   TEXTOID, -1, 0);

5188 5189 5190 5191 5192 5193 5194 5195 5196 5197
	}
	else
	{
		const char *varname;

		/* Get the canonical spelling of name */
		(void) GetConfigOptionByName(name, &varname);

		/* need a tuple descriptor representing a single TEXT column */
		tupdesc = CreateTemplateTupleDesc(1, false);
5198 5199
		TupleDescInitEntry(tupdesc, (AttrNumber) 1, varname,
						   TEXTOID, -1, 0);
5200 5201
	}
	return tupdesc;
5202 5203 5204 5205 5206 5207
}

/*
 * RESET command
 */
void
5208
ResetPGVariable(const char *name, bool isTopLevel)
5209
{
5210
	if (pg_strcasecmp(name, "all") == 0)
5211 5212 5213 5214 5215 5216 5217 5218 5219 5220 5221 5222 5223 5224
		ResetAllOptions();
	else
		set_config_option(name,
						  NULL,
						  (superuser() ? PGC_SUSET : PGC_USERSET),
						  PGC_S_SESSION,
						  false,
						  true);
}


/*
 * SHOW command
 */
5225
static void
5226
ShowGUCConfigOption(const char *name, DestReceiver *dest)
5227
{
5228
	TupOutputState *tstate;
B
Bruce Momjian 已提交
5229 5230 5231
	TupleDesc	tupdesc;
	const char *varname;
	char	   *value;
5232

5233 5234 5235
	/* Get the value and canonical spelling of name */
	value = GetConfigOptionByName(name, &varname);

5236
	/* need a tuple descriptor representing a single TEXT column */
5237
	tupdesc = CreateTemplateTupleDesc(1, false);
5238
	TupleDescInitEntry(tupdesc, (AttrNumber) 1, varname,
5239
					   TEXTOID, -1, 0);
5240

5241 5242 5243 5244
	/* prepare for projection of tuples */
	tstate = begin_tup_output_tupdesc(dest, tupdesc);

	/* Send it */
5245
	do_text_output_oneline(tstate, value);
5246 5247

	end_tup_output(tstate);
5248 5249
}

5250 5251 5252
/*
 * SHOW ALL command
 */
5253
static void
5254
ShowAllGUCConfig(DestReceiver *dest)
5255
{
5256
	bool		am_superuser = superuser();
5257
	int			i;
5258
	TupOutputState *tstate;
B
Bruce Momjian 已提交
5259
	TupleDesc	tupdesc;
5260
	char	   *values[3];
5261

5262 5263
	/* need a tuple descriptor representing three TEXT columns */
	tupdesc = CreateTemplateTupleDesc(3, false);
5264
	TupleDescInitEntry(tupdesc, (AttrNumber) 1, "name",
5265
					   TEXTOID, -1, 0);
5266
	TupleDescInitEntry(tupdesc, (AttrNumber) 2, "setting",
5267
					   TEXTOID, -1, 0);
5268 5269
	TupleDescInitEntry(tupdesc, (AttrNumber) 3, "description",
					   TEXTOID, -1, 0);
B
Bruce Momjian 已提交
5270

5271 5272 5273

	/* prepare for projection of tuples */
	tstate = begin_tup_output_tupdesc(dest, tupdesc);
5274

5275 5276
	for (i = 0; i < num_guc_variables; i++)
	{
5277 5278
		struct config_generic *conf = guc_variables[i];

5279 5280
		if ((conf->flags & GUC_NO_SHOW_ALL) ||
			((conf->flags & GUC_SUPERUSER_ONLY) && !am_superuser))
5281
			continue;
5282 5283

		/* assign to the values array */
5284
		values[0] = (char *) conf->name;
5285
		values[1] = _ShowOption(conf, true);
5286
		values[2] = (char *) conf->short_desc;
5287 5288 5289

		/* send it to dest */
		do_tup_output(tstate, values);
5290

5291
		/* clean up */
5292 5293
		if (values[1] != NULL)
			pfree(values[1]);
5294
	}
5295 5296

	end_tup_output(tstate);
5297
}
5298

5299
/*
5300 5301
 * Return GUC variable value by name; optionally return canonical
 * form of name.  Return value is palloc'd.
5302 5303
 */
char *
5304
GetConfigOptionByName(const char *name, const char **varname)
5305 5306 5307
{
	struct config_generic *record;

5308
	record = find_option(name, ERROR);
5309
	if (record == NULL)
5310 5311
		ereport(ERROR,
				(errcode(ERRCODE_UNDEFINED_OBJECT),
B
Bruce Momjian 已提交
5312
			   errmsg("unrecognized configuration parameter \"%s\"", name)));
5313 5314 5315 5316
	if ((record->flags & GUC_SUPERUSER_ONLY) && !superuser())
		ereport(ERROR,
				(errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
				 errmsg("must be superuser to examine \"%s\"", name)));
5317

5318 5319 5320
	if (varname)
		*varname = record->name;

5321
	return _ShowOption(record, true);
5322 5323 5324
}

/*
5325 5326
 * Return GUC variable value by variable number; optionally return canonical
 * form of name.  Return value is palloc'd.
5327
 */
5328 5329
void
GetConfigOptionByNum(int varnum, const char **values, bool *noshow)
5330
{
B
Bruce Momjian 已提交
5331 5332
	char		buffer[256];
	struct config_generic *conf;
5333 5334 5335 5336 5337

	/* check requested variable number valid */
	Assert((varnum >= 0) && (varnum < num_guc_variables));

	conf = guc_variables[varnum];
5338

5339
	if (noshow)
5340 5341 5342 5343 5344 5345 5346
	{
		if ((conf->flags & GUC_NO_SHOW_ALL) ||
			((conf->flags & GUC_SUPERUSER_ONLY) && !superuser()))
			*noshow = true;
		else
			*noshow = false;
	}
5347

5348 5349 5350 5351 5352 5353
	/* first get the generic attributes */

	/* name */
	values[0] = conf->name;

	/* setting : use _ShowOption in order to avoid duplicating the logic */
5354 5355 5356 5357 5358
	values[1] = _ShowOption(conf, false);

	/* unit */
	if (conf->vartype == PGC_INT)
	{
5359
		static char buf[8];
5360

5361 5362 5363 5364 5365 5366
		switch (conf->flags & (GUC_UNIT_MEMORY | GUC_UNIT_TIME))
		{
			case GUC_UNIT_KB:
				values[2] = "kB";
				break;
			case GUC_UNIT_BLOCKS:
B
Bruce Momjian 已提交
5367
				snprintf(buf, sizeof(buf), "%dkB", BLCKSZ / 1024);
5368 5369 5370
				values[2] = buf;
				break;
			case GUC_UNIT_XBLOCKS:
B
Bruce Momjian 已提交
5371
				snprintf(buf, sizeof(buf), "%dkB", XLOG_BLCKSZ / 1024);
5372 5373 5374 5375 5376 5377 5378 5379 5380 5381 5382 5383 5384 5385
				values[2] = buf;
				break;
			case GUC_UNIT_MS:
				values[2] = "ms";
				break;
			case GUC_UNIT_S:
				values[2] = "s";
				break;
			case GUC_UNIT_MIN:
				values[2] = "min";
				break;
			default:
				values[2] = "";
				break;
5386 5387 5388 5389
		}
	}
	else
		values[2] = NULL;
5390

5391
	/* group */
5392
	values[3] = config_group_names[conf->group];
5393 5394

	/* short_desc */
5395
	values[4] = conf->short_desc;
5396 5397

	/* extra_desc */
5398
	values[5] = conf->long_desc;
5399

5400
	/* context */
5401
	values[6] = GucContext_Names[conf->context];
5402 5403

	/* vartype */
5404
	values[7] = config_type_names[conf->vartype];
5405 5406

	/* source */
5407
	values[8] = GucSource_Names[conf->source];
5408 5409 5410 5411 5412 5413 5414

	/* now get the type specifc attributes */
	switch (conf->vartype)
	{
		case PGC_BOOL:
			{
				/* min_val */
5415
				values[9] = NULL;
5416 5417

				/* max_val */
5418
				values[10] = NULL;
5419 5420 5421 5422 5423 5424 5425 5426 5427
			}
			break;

		case PGC_INT:
			{
				struct config_int *lconf = (struct config_int *) conf;

				/* min_val */
				snprintf(buffer, sizeof(buffer), "%d", lconf->min);
5428
				values[9] = pstrdup(buffer);
5429 5430 5431

				/* max_val */
				snprintf(buffer, sizeof(buffer), "%d", lconf->max);
5432
				values[10] = pstrdup(buffer);
5433 5434 5435 5436 5437 5438 5439 5440 5441
			}
			break;

		case PGC_REAL:
			{
				struct config_real *lconf = (struct config_real *) conf;

				/* min_val */
				snprintf(buffer, sizeof(buffer), "%g", lconf->min);
5442
				values[9] = pstrdup(buffer);
5443 5444 5445

				/* max_val */
				snprintf(buffer, sizeof(buffer), "%g", lconf->max);
5446
				values[10] = pstrdup(buffer);
5447 5448 5449 5450 5451 5452
			}
			break;

		case PGC_STRING:
			{
				/* min_val */
5453
				values[9] = NULL;
5454 5455

				/* max_val */
5456
				values[10] = NULL;
5457 5458 5459 5460 5461 5462
			}
			break;

		default:
			{
				/*
B
Bruce Momjian 已提交
5463
				 * should never get here, but in case we do, set 'em to NULL
5464 5465 5466
				 */

				/* min_val */
5467
				values[9] = NULL;
5468 5469

				/* max_val */
5470
				values[10] = NULL;
5471 5472 5473
			}
			break;
	}
5474 5475 5476 5477 5478 5479 5480 5481 5482 5483 5484 5485 5486 5487 5488 5489 5490 5491
}

/*
 * Return the total number of GUC variables
 */
int
GetNumConfigOptions(void)
{
	return num_guc_variables;
}

/*
 * show_config_by_name - equiv to SHOW X command but implemented as
 * a function.
 */
Datum
show_config_by_name(PG_FUNCTION_ARGS)
{
B
Bruce Momjian 已提交
5492 5493 5494
	char	   *varname;
	char	   *varval;
	text	   *result_text;
5495 5496

	/* Get the GUC variable name */
5497
	varname = DatumGetCString(DirectFunctionCall1(textout, PG_GETARG_DATUM(0)));
5498 5499

	/* Get the value */
5500
	varval = GetConfigOptionByName(varname, NULL);
5501 5502 5503 5504 5505 5506 5507 5508

	/* Convert to text */
	result_text = DatumGetTextP(DirectFunctionCall1(textin, CStringGetDatum(varval)));

	/* return it */
	PG_RETURN_TEXT_P(result_text);
}

5509 5510 5511 5512
/*
 * show_all_settings - equiv to SHOW ALL command but implemented as
 * a Table Function.
 */
5513
#define NUM_PG_SETTINGS_ATTS	11
5514

5515 5516 5517
Datum
show_all_settings(PG_FUNCTION_ARGS)
{
B
Bruce Momjian 已提交
5518 5519 5520 5521 5522 5523
	FuncCallContext *funcctx;
	TupleDesc	tupdesc;
	int			call_cntr;
	int			max_calls;
	AttInMetadata *attinmeta;
	MemoryContext oldcontext;
5524 5525

	/* stuff done only on the first call of the function */
B
Bruce Momjian 已提交
5526 5527
	if (SRF_IS_FIRSTCALL())
	{
5528
		/* create a function context for cross-call persistence */
B
Bruce Momjian 已提交
5529
		funcctx = SRF_FIRSTCALL_INIT();
5530

B
Bruce Momjian 已提交
5531
		/*
B
Bruce Momjian 已提交
5532
		 * switch to memory context appropriate for multiple function calls
B
Bruce Momjian 已提交
5533
		 */
5534 5535
		oldcontext = MemoryContextSwitchTo(funcctx->multi_call_memory_ctx);

5536
		/*
B
Bruce Momjian 已提交
5537 5538
		 * need a tuple descriptor representing NUM_PG_SETTINGS_ATTS columns
		 * of the appropriate types
5539 5540
		 */
		tupdesc = CreateTemplateTupleDesc(NUM_PG_SETTINGS_ATTS, false);
5541
		TupleDescInitEntry(tupdesc, (AttrNumber) 1, "name",
5542
						   TEXTOID, -1, 0);
5543
		TupleDescInitEntry(tupdesc, (AttrNumber) 2, "setting",
5544
						   TEXTOID, -1, 0);
5545 5546 5547
		TupleDescInitEntry(tupdesc, (AttrNumber) 3, "unit",
						   TEXTOID, -1, 0);
		TupleDescInitEntry(tupdesc, (AttrNumber) 4, "category",
5548
						   TEXTOID, -1, 0);
5549
		TupleDescInitEntry(tupdesc, (AttrNumber) 5, "short_desc",
5550
						   TEXTOID, -1, 0);
5551
		TupleDescInitEntry(tupdesc, (AttrNumber) 6, "extra_desc",
5552
						   TEXTOID, -1, 0);
5553
		TupleDescInitEntry(tupdesc, (AttrNumber) 7, "context",
5554
						   TEXTOID, -1, 0);
5555
		TupleDescInitEntry(tupdesc, (AttrNumber) 8, "vartype",
5556
						   TEXTOID, -1, 0);
5557
		TupleDescInitEntry(tupdesc, (AttrNumber) 9, "source",
5558
						   TEXTOID, -1, 0);
5559
		TupleDescInitEntry(tupdesc, (AttrNumber) 10, "min_val",
5560
						   TEXTOID, -1, 0);
5561
		TupleDescInitEntry(tupdesc, (AttrNumber) 11, "max_val",
5562
						   TEXTOID, -1, 0);
5563 5564

		/*
B
Bruce Momjian 已提交
5565 5566
		 * Generate attribute metadata needed later to produce tuples from raw
		 * C strings
5567 5568 5569 5570 5571 5572
		 */
		attinmeta = TupleDescGetAttInMetadata(tupdesc);
		funcctx->attinmeta = attinmeta;

		/* total number of tuples to be returned */
		funcctx->max_calls = GetNumConfigOptions();
5573 5574

		MemoryContextSwitchTo(oldcontext);
B
Bruce Momjian 已提交
5575
	}
5576 5577

	/* stuff done on every call of the function */
B
Bruce Momjian 已提交
5578
	funcctx = SRF_PERCALL_SETUP();
5579 5580 5581 5582 5583

	call_cntr = funcctx->call_cntr;
	max_calls = funcctx->max_calls;
	attinmeta = funcctx->attinmeta;

B
Bruce Momjian 已提交
5584 5585
	if (call_cntr < max_calls)	/* do when there is more left to send */
	{
5586
		char	   *values[NUM_PG_SETTINGS_ATTS];
5587 5588 5589 5590 5591 5592 5593 5594 5595
		bool		noshow;
		HeapTuple	tuple;
		Datum		result;

		/*
		 * Get the next visible GUC variable name and value
		 */
		do
		{
5596
			GetConfigOptionByNum(call_cntr, (const char **) values, &noshow);
5597 5598 5599 5600 5601 5602 5603
			if (noshow)
			{
				/* bump the counter and get the next config setting */
				call_cntr = ++funcctx->call_cntr;

				/* make sure we haven't gone too far now */
				if (call_cntr >= max_calls)
B
Bruce Momjian 已提交
5604
					SRF_RETURN_DONE(funcctx);
5605 5606 5607 5608 5609 5610 5611
			}
		} while (noshow);

		/* build a tuple */
		tuple = BuildTupleFromCStrings(attinmeta, values);

		/* make the tuple into a datum */
5612
		result = HeapTupleGetDatum(tuple);
5613

B
Bruce Momjian 已提交
5614 5615 5616
		SRF_RETURN_NEXT(funcctx, result);
	}
	else
5617 5618
	{
		/* do when there is no more left */
B
Bruce Momjian 已提交
5619
		SRF_RETURN_DONE(funcctx);
5620
	}
5621 5622
}

5623
static char *
5624
_ShowOption(struct config_generic * record, bool use_units)
5625 5626 5627
{
	char		buffer[256];
	const char *val;
5628

5629 5630 5631 5632 5633
	switch (record->vartype)
	{
		case PGC_BOOL:
			{
				struct config_bool *conf = (struct config_bool *) record;
5634

5635 5636 5637 5638 5639 5640 5641 5642 5643 5644 5645 5646 5647 5648 5649
				if (conf->show_hook)
					val = (*conf->show_hook) ();
				else
					val = *conf->variable ? "on" : "off";
			}
			break;

		case PGC_INT:
			{
				struct config_int *conf = (struct config_int *) record;

				if (conf->show_hook)
					val = (*conf->show_hook) ();
				else
				{
B
Bruce Momjian 已提交
5650 5651
					char		unit[4];
					int			result = *conf->variable;
5652 5653 5654

					if (use_units && result > 0 && (record->flags & GUC_UNIT_MEMORY))
					{
5655 5656 5657
						switch (record->flags & GUC_UNIT_MEMORY)
						{
							case GUC_UNIT_BLOCKS:
B
Bruce Momjian 已提交
5658
								result *= BLCKSZ / 1024;
5659 5660
								break;
							case GUC_UNIT_XBLOCKS:
B
Bruce Momjian 已提交
5661
								result *= XLOG_BLCKSZ / 1024;
5662 5663
								break;
						}
5664 5665 5666 5667 5668 5669 5670 5671 5672 5673 5674 5675 5676 5677 5678 5679 5680 5681

						if (result % KB_PER_GB == 0)
						{
							result /= KB_PER_GB;
							strcpy(unit, "GB");
						}
						else if (result % KB_PER_MB == 0)
						{
							result /= KB_PER_MB;
							strcpy(unit, "MB");
						}
						else
						{
							strcpy(unit, "kB");
						}
					}
					else if (use_units && result > 0 && (record->flags & GUC_UNIT_TIME))
					{
5682 5683 5684 5685 5686 5687 5688 5689 5690
						switch (record->flags & GUC_UNIT_TIME)
						{
							case GUC_UNIT_S:
								result *= MS_PER_S;
								break;
							case GUC_UNIT_MIN:
								result *= MS_PER_MIN;
								break;
						}
5691 5692 5693 5694 5695 5696 5697 5698 5699 5700 5701 5702 5703 5704 5705 5706 5707 5708 5709 5710 5711 5712 5713 5714 5715 5716 5717 5718 5719 5720

						if (result % MS_PER_D == 0)
						{
							result /= MS_PER_D;
							strcpy(unit, "d");
						}
						else if (result % MS_PER_H == 0)
						{
							result /= MS_PER_H;
							strcpy(unit, "h");
						}
						else if (result % MS_PER_MIN == 0)
						{
							result /= MS_PER_MIN;
							strcpy(unit, "min");
						}
						else if (result % MS_PER_S == 0)
						{
							result /= MS_PER_S;
							strcpy(unit, "s");
						}
						else
						{
							strcpy(unit, "ms");
						}
					}
					else
						strcpy(unit, "");

					snprintf(buffer, sizeof(buffer), "%d%s",
B
Bruce Momjian 已提交
5721
							 (int) result, unit);
5722 5723 5724 5725 5726 5727 5728 5729 5730 5731 5732 5733 5734 5735 5736 5737 5738 5739 5740 5741 5742 5743 5744
					val = buffer;
				}
			}
			break;

		case PGC_REAL:
			{
				struct config_real *conf = (struct config_real *) record;

				if (conf->show_hook)
					val = (*conf->show_hook) ();
				else
				{
					snprintf(buffer, sizeof(buffer), "%g",
							 *conf->variable);
					val = buffer;
				}
			}
			break;

		case PGC_STRING:
			{
				struct config_string *conf = (struct config_string *) record;
5745

5746 5747 5748 5749 5750
				if (conf->show_hook)
					val = (*conf->show_hook) ();
				else if (*conf->variable && **conf->variable)
					val = *conf->variable;
				else
5751
					val = "";
5752 5753
			}
			break;
5754

5755 5756 5757 5758 5759
		default:
			/* just to keep compiler quiet */
			val = "???";
			break;
	}
5760

5761
	return pstrdup(val);
5762
}
5763 5764


5765
static bool
B
Bruce Momjian 已提交
5766
is_newvalue_equal(struct config_generic * record, const char *newvalue)
5767 5768 5769 5770
{
	switch (record->vartype)
	{
		case PGC_BOOL:
B
Bruce Momjian 已提交
5771 5772 5773
			{
				struct config_bool *conf = (struct config_bool *) record;
				bool		newval;
5774

5775 5776
				return parse_bool(newvalue, &newval)
					&& *conf->variable == newval;
B
Bruce Momjian 已提交
5777
			}
5778
		case PGC_INT:
B
Bruce Momjian 已提交
5779 5780 5781
			{
				struct config_int *conf = (struct config_int *) record;
				int			newval;
5782

5783 5784
				return parse_int(newvalue, &newval, record->flags, NULL)
					&& *conf->variable == newval;
B
Bruce Momjian 已提交
5785
			}
5786
		case PGC_REAL:
B
Bruce Momjian 已提交
5787 5788 5789
			{
				struct config_real *conf = (struct config_real *) record;
				double		newval;
5790

5791 5792
				return parse_real(newvalue, &newval)
					&& *conf->variable == newval;
B
Bruce Momjian 已提交
5793
			}
5794
		case PGC_STRING:
B
Bruce Momjian 已提交
5795 5796
			{
				struct config_string *conf = (struct config_string *) record;
5797

B
Bruce Momjian 已提交
5798 5799
				return strcmp(*conf->variable, newvalue) == 0;
			}
5800 5801 5802 5803 5804 5805
	}

	return false;
}


B
Bruce Momjian 已提交
5806
#ifdef EXEC_BACKEND
5807

B
Bruce Momjian 已提交
5808 5809 5810 5811 5812 5813 5814 5815 5816 5817 5818
/*
 *	This routine dumps out all non-default GUC options into a binary
 *	file that is read by all exec'ed backends.  The format is:
 *
 *		variable name, string, null terminated
 *		variable value, string, null terminated
 *		variable source, integer
 */
void
write_nondefault_variables(GucContext context)
{
5819 5820 5821
	int			i;
	int			elevel;
	FILE	   *fp;
B
Bruce Momjian 已提交
5822 5823

	Assert(context == PGC_POSTMASTER || context == PGC_SIGHUP);
5824 5825

	elevel = (context == PGC_SIGHUP) ? LOG : ERROR;
B
Bruce Momjian 已提交
5826 5827 5828 5829

	/*
	 * Open file
	 */
5830
	fp = AllocateFile(CONFIG_EXEC_PARAMS_NEW, "w");
5831 5832
	if (!fp)
	{
5833 5834
		ereport(elevel,
				(errcode_for_file_access(),
5835 5836
				 errmsg("could not write to file \"%s\": %m",
						CONFIG_EXEC_PARAMS_NEW)));
B
Bruce Momjian 已提交
5837 5838 5839 5840 5841 5842 5843 5844 5845 5846 5847 5848 5849 5850 5851 5852 5853 5854 5855 5856 5857 5858 5859 5860 5861 5862 5863 5864 5865 5866 5867 5868 5869 5870 5871 5872 5873 5874 5875 5876 5877 5878 5879 5880 5881 5882 5883 5884 5885 5886 5887 5888 5889 5890 5891 5892 5893
		return;
	}

	for (i = 0; i < num_guc_variables; i++)
	{
		struct config_generic *gconf = guc_variables[i];

		if (gconf->source != PGC_S_DEFAULT)
		{
			fprintf(fp, "%s", gconf->name);
			fputc(0, fp);

			switch (gconf->vartype)
			{
				case PGC_BOOL:
					{
						struct config_bool *conf = (struct config_bool *) gconf;

						if (*conf->variable == 0)
							fprintf(fp, "false");
						else
							fprintf(fp, "true");
					}
					break;

				case PGC_INT:
					{
						struct config_int *conf = (struct config_int *) gconf;

						fprintf(fp, "%d", *conf->variable);
					}
					break;

				case PGC_REAL:
					{
						struct config_real *conf = (struct config_real *) gconf;

						/* Could lose precision here? */
						fprintf(fp, "%f", *conf->variable);
					}
					break;

				case PGC_STRING:
					{
						struct config_string *conf = (struct config_string *) gconf;

						fprintf(fp, "%s", *conf->variable);
					}
					break;
			}

			fputc(0, fp);

			fwrite(&gconf->source, sizeof(gconf->source), 1, fp);
		}
	}

5894 5895 5896 5897
	if (FreeFile(fp))
	{
		ereport(elevel,
				(errcode_for_file_access(),
5898 5899
				 errmsg("could not write to file \"%s\": %m",
						CONFIG_EXEC_PARAMS_NEW)));
5900 5901 5902
		return;
	}

5903
	/*
B
Bruce Momjian 已提交
5904 5905
	 * Put new file in place.  This could delay on Win32, but we don't hold
	 * any exclusive locks.
5906
	 */
5907
	rename(CONFIG_EXEC_PARAMS_NEW, CONFIG_EXEC_PARAMS);
B
Bruce Momjian 已提交
5908 5909 5910 5911 5912 5913 5914 5915 5916 5917 5918
}


/*
 *	Read string, including null byte from file
 *
 *	Return NULL on EOF and nothing read
 */
static char *
read_string_with_null(FILE *fp)
{
5919 5920 5921 5922
	int			i = 0,
				ch,
				maxlen = 256;
	char	   *str = NULL;
B
Bruce Momjian 已提交
5923 5924 5925 5926 5927 5928 5929 5930

	do
	{
		if ((ch = fgetc(fp)) == EOF)
		{
			if (i == 0)
				return NULL;
			else
5931
				elog(FATAL, "invalid format of exec config params file");
B
Bruce Momjian 已提交
5932 5933
		}
		if (i == 0)
5934
			str = guc_malloc(FATAL, maxlen);
B
Bruce Momjian 已提交
5935
		else if (i == maxlen)
5936
			str = guc_realloc(FATAL, str, maxlen *= 2);
B
Bruce Momjian 已提交
5937 5938 5939 5940 5941 5942 5943 5944 5945 5946 5947 5948 5949 5950
		str[i++] = ch;
	} while (ch != 0);

	return str;
}


/*
 *	This routine loads a previous postmaster dump of its non-default
 *	settings.
 */
void
read_nondefault_variables(void)
{
5951 5952 5953 5954
	FILE	   *fp;
	char	   *varname,
			   *varvalue;
	int			varsource;
B
Bruce Momjian 已提交
5955 5956 5957 5958

	/*
	 * Open file
	 */
5959
	fp = AllocateFile(CONFIG_EXEC_PARAMS, "r");
5960 5961 5962 5963
	if (!fp)
	{
		/* File not found is fine */
		if (errno != ENOENT)
5964 5965
			ereport(FATAL,
					(errcode_for_file_access(),
5966 5967
					 errmsg("could not read from file \"%s\": %m",
							CONFIG_EXEC_PARAMS)));
B
Bruce Momjian 已提交
5968
		return;
5969
	}
B
Bruce Momjian 已提交
5970

5971
	for (;;)
B
Bruce Momjian 已提交
5972
	{
5973 5974
		struct config_generic *record;

B
Bruce Momjian 已提交
5975 5976 5977
		if ((varname = read_string_with_null(fp)) == NULL)
			break;

5978
		if ((record = find_option(varname, FATAL)) == NULL)
B
Bruce Momjian 已提交
5979
			elog(FATAL, "failed to locate variable %s in exec config params file", varname);
B
Bruce Momjian 已提交
5980
		if ((varvalue = read_string_with_null(fp)) == NULL)
5981
			elog(FATAL, "invalid format of exec config params file");
5982
		if (fread(&varsource, sizeof(varsource), 1, fp) == 0)
5983
			elog(FATAL, "invalid format of exec config params file");
B
Bruce Momjian 已提交
5984

5985
		(void) set_config_option(varname, varvalue, record->context,
5986
								 varsource, false, true);
B
Bruce Momjian 已提交
5987 5988 5989 5990 5991 5992
		free(varname);
		free(varvalue);
	}

	FreeFile(fp);
}
B
Bruce Momjian 已提交
5993
#endif   /* EXEC_BACKEND */
B
Bruce Momjian 已提交
5994 5995


5996 5997 5998 5999 6000 6001 6002 6003
/*
 * A little "long argument" simulation, although not quite GNU
 * compliant. Takes a string of the form "some-option=some value" and
 * returns name = "some_option" and value = "some value" in malloc'ed
 * storage. Note that '-' is converted to '_' in the option name. If
 * there is no '=' in the input string then value will be NULL.
 */
void
B
Bruce Momjian 已提交
6004
ParseLongOption(const char *string, char **name, char **value)
6005
{
B
Bruce Momjian 已提交
6006 6007
	size_t		equal_pos;
	char	   *cp;
6008 6009 6010 6011 6012 6013 6014 6015 6016

	AssertArg(string);
	AssertArg(name);
	AssertArg(value);

	equal_pos = strcspn(string, "=");

	if (string[equal_pos] == '=')
	{
6017
		*name = guc_malloc(FATAL, equal_pos + 1);
6018
		strlcpy(*name, string, equal_pos + 1);
6019

6020
		*value = guc_strdup(FATAL, &string[equal_pos + 1]);
6021
	}
B
Bruce Momjian 已提交
6022
	else
6023
	{
6024
		/* no equal sign in string */
6025
		*name = guc_strdup(FATAL, string);
6026 6027 6028
		*value = NULL;
	}

B
Bruce Momjian 已提交
6029
	for (cp = *name; *cp; cp++)
6030 6031 6032
		if (*cp == '-')
			*cp = '_';
}
6033 6034


6035
/*
6036
 * Handle options fetched from pg_database.datconfig or pg_authid.rolconfig.
6037
 * The array parameter must be an array of TEXT (it must not be NULL).
6038
 */
6039 6040 6041
void
ProcessGUCArray(ArrayType *array, GucSource source)
{
B
Bruce Momjian 已提交
6042
	int			i;
6043

6044
	Assert(array != NULL);
6045 6046 6047
	Assert(ARR_ELEMTYPE(array) == TEXTOID);
	Assert(ARR_NDIM(array) == 1);
	Assert(ARR_LBOUND(array)[0] == 1);
6048
	Assert(source == PGC_S_DATABASE || source == PGC_S_USER);
6049 6050 6051 6052 6053 6054 6055 6056 6057 6058

	for (i = 1; i <= ARR_DIMS(array)[0]; i++)
	{
		Datum		d;
		bool		isnull;
		char	   *s;
		char	   *name;
		char	   *value;

		d = array_ref(array, 1, &i,
B
Bruce Momjian 已提交
6059 6060 6061 6062
					  -1 /* varlenarray */ ,
					  -1 /* TEXT's typlen */ ,
					  false /* TEXT's typbyval */ ,
					  'i' /* TEXT's typalign */ ,
6063 6064 6065 6066 6067 6068
					  &isnull);

		if (isnull)
			continue;

		s = DatumGetCString(DirectFunctionCall1(textout, d));
6069

6070 6071 6072
		ParseLongOption(s, &name, &value);
		if (!value)
		{
6073 6074
			ereport(WARNING,
					(errcode(ERRCODE_SYNTAX_ERROR),
B
Bruce Momjian 已提交
6075
			  errmsg("could not parse setting for parameter \"%s\"", name)));
6076
			free(name);
B
Bruce Momjian 已提交
6077
			continue;
6078 6079
		}

6080
		/*
B
Bruce Momjian 已提交
6081 6082 6083
		 * We process all these options at SUSET level.  We assume that the
		 * right to insert an option into pg_database or pg_authid was checked
		 * when it was inserted.
6084
		 */
6085
		SetConfigOption(name, value, PGC_SUSET, source);
6086 6087 6088 6089

		free(name);
		if (value)
			free(value);
6090 6091 6092 6093
	}
}


6094 6095 6096 6097
/*
 * Add an entry to an option array.  The array parameter may be NULL
 * to indicate the current table entry is NULL.
 */
6098 6099 6100
ArrayType *
GUCArrayAdd(ArrayType *array, const char *name, const char *value)
{
6101
	const char *varname;
6102 6103 6104 6105 6106 6107 6108 6109 6110 6111
	Datum		datum;
	char	   *newval;
	ArrayType  *a;

	Assert(name);
	Assert(value);

	/* test if the option is valid */
	set_config_option(name, value,
					  superuser() ? PGC_SUSET : PGC_USERSET,
6112
					  PGC_S_TEST, false, false);
6113

6114 6115 6116 6117
	/* convert name to canonical spelling, so we can use plain strcmp */
	(void) GetConfigOptionByName(name, &varname);
	name = varname;

6118 6119 6120
	newval = palloc(strlen(name) + 1 + strlen(value) + 1);
	sprintf(newval, "%s=%s", name, value);
	datum = DirectFunctionCall1(textin, CStringGetDatum(newval));
B
Bruce Momjian 已提交
6121

6122 6123
	if (array)
	{
B
Bruce Momjian 已提交
6124 6125 6126
		int			index;
		bool		isnull;
		int			i;
6127

6128 6129 6130 6131
		Assert(ARR_ELEMTYPE(array) == TEXTOID);
		Assert(ARR_NDIM(array) == 1);
		Assert(ARR_LBOUND(array)[0] == 1);

B
Bruce Momjian 已提交
6132
		index = ARR_DIMS(array)[0] + 1; /* add after end */
6133 6134 6135 6136 6137 6138 6139

		for (i = 1; i <= ARR_DIMS(array)[0]; i++)
		{
			Datum		d;
			char	   *current;

			d = array_ref(array, 1, &i,
B
Bruce Momjian 已提交
6140 6141 6142 6143
						  -1 /* varlenarray */ ,
						  -1 /* TEXT's typlen */ ,
						  false /* TEXT's typbyval */ ,
						  'i' /* TEXT's typalign */ ,
6144
						  &isnull);
6145 6146
			if (isnull)
				continue;
6147
			current = DatumGetCString(DirectFunctionCall1(textout, d));
B
Bruce Momjian 已提交
6148
			if (strncmp(current, newval, strlen(name) + 1) == 0)
6149 6150 6151 6152 6153 6154
			{
				index = i;
				break;
			}
		}

6155 6156
		a = array_set(array, 1, &index,
					  datum,
6157 6158
					  false,
					  -1 /* varlena array */ ,
B
Bruce Momjian 已提交
6159 6160
					  -1 /* TEXT's typlen */ ,
					  false /* TEXT's typbyval */ ,
6161
					  'i' /* TEXT's typalign */ );
6162 6163
	}
	else
6164 6165 6166
		a = construct_array(&datum, 1,
							TEXTOID,
							-1, false, 'i');
6167 6168 6169 6170 6171

	return a;
}


6172 6173 6174 6175 6176
/*
 * Delete an entry from an option array.  The array parameter may be NULL
 * to indicate the current table entry is NULL.  Also, if the return value
 * is NULL then a null should be stored.
 */
6177 6178 6179
ArrayType *
GUCArrayDelete(ArrayType *array, const char *name)
{
6180
	const char *varname;
B
Bruce Momjian 已提交
6181 6182 6183
	ArrayType  *newarray;
	int			i;
	int			index;
6184 6185 6186 6187 6188 6189

	Assert(name);

	/* test if the option is valid */
	set_config_option(name, NULL,
					  superuser() ? PGC_SUSET : PGC_USERSET,
6190
					  PGC_S_TEST, false, false);
6191

6192 6193 6194 6195
	/* convert name to canonical spelling, so we can use plain strcmp */
	(void) GetConfigOptionByName(name, &varname);
	name = varname;

6196 6197 6198 6199 6200
	/* if array is currently null, then surely nothing to delete */
	if (!array)
		return NULL;

	newarray = NULL;
6201 6202 6203 6204 6205 6206 6207 6208 6209
	index = 1;

	for (i = 1; i <= ARR_DIMS(array)[0]; i++)
	{
		Datum		d;
		char	   *val;
		bool		isnull;

		d = array_ref(array, 1, &i,
B
Bruce Momjian 已提交
6210 6211 6212 6213
					  -1 /* varlenarray */ ,
					  -1 /* TEXT's typlen */ ,
					  false /* TEXT's typbyval */ ,
					  'i' /* TEXT's typalign */ ,
6214
					  &isnull);
6215 6216
		if (isnull)
			continue;
6217 6218
		val = DatumGetCString(DirectFunctionCall1(textout, d));

6219
		/* ignore entry if it's what we want to delete */
B
Bruce Momjian 已提交
6220
		if (strncmp(val, name, strlen(name)) == 0
6221 6222 6223
			&& val[strlen(name)] == '=')
			continue;

6224 6225 6226 6227 6228
		/* else add it to the output array */
		if (newarray)
		{
			newarray = array_set(newarray, 1, &index,
								 d,
6229
								 false,
6230 6231 6232
								 -1 /* varlenarray */ ,
								 -1 /* TEXT's typlen */ ,
								 false /* TEXT's typbyval */ ,
6233
								 'i' /* TEXT's typalign */ );
6234 6235 6236 6237 6238 6239
		}
		else
			newarray = construct_array(&d, 1,
									   TEXTOID,
									   -1, false, 'i');

6240 6241 6242 6243 6244
		index++;
	}

	return newarray;
}
6245

6246 6247 6248 6249 6250

/*
 * assign_hook subroutines
 */

6251 6252 6253
static const char *
assign_log_destination(const char *value, bool doit, GucSource source)
{
B
Bruce Momjian 已提交
6254 6255 6256 6257 6258
	char	   *rawstring;
	List	   *elemlist;
	ListCell   *l;
	int			newlogdest = 0;

6259 6260 6261 6262
	/* Need a modifiable copy of string */
	rawstring = pstrdup(value);

	/* Parse string into list of identifiers */
B
Bruce Momjian 已提交
6263
	if (!SplitIdentifierString(rawstring, ',', &elemlist))
6264 6265 6266
	{
		/* syntax error in list */
		pfree(rawstring);
6267
		list_free(elemlist);
6268 6269 6270
		if (source >= PGC_S_INTERACTIVE)
			ereport(ERROR,
					(errcode(ERRCODE_INVALID_PARAMETER_VALUE),
B
Bruce Momjian 已提交
6271
			errmsg("invalid list syntax for parameter \"log_destination\"")));
6272 6273 6274 6275 6276
		return NULL;
	}

	foreach(l, elemlist)
	{
B
Bruce Momjian 已提交
6277 6278 6279
		char	   *tok = (char *) lfirst(l);

		if (pg_strcasecmp(tok, "stderr") == 0)
6280 6281
			newlogdest |= LOG_DESTINATION_STDERR;
#ifdef HAVE_SYSLOG
B
Bruce Momjian 已提交
6282
		else if (pg_strcasecmp(tok, "syslog") == 0)
6283 6284 6285
			newlogdest |= LOG_DESTINATION_SYSLOG;
#endif
#ifdef WIN32
B
Bruce Momjian 已提交
6286
		else if (pg_strcasecmp(tok, "eventlog") == 0)
6287 6288
			newlogdest |= LOG_DESTINATION_EVENTLOG;
#endif
B
Bruce Momjian 已提交
6289 6290
		else
		{
6291 6292 6293
			if (source >= PGC_S_INTERACTIVE)
				ereport(ERROR,
						(errcode(ERRCODE_INVALID_PARAMETER_VALUE),
B
Bruce Momjian 已提交
6294 6295
				  errmsg("unrecognized \"log_destination\" key word: \"%s\"",
						 tok)));
6296
			pfree(rawstring);
6297
			list_free(elemlist);
6298 6299 6300 6301
			return NULL;
		}
	}

6302 6303 6304
	if (doit)
		Log_destination = newlogdest;

6305
	pfree(rawstring);
6306
	list_free(elemlist);
6307 6308 6309 6310

	return value;
}

6311 6312 6313
#ifdef HAVE_SYSLOG

static const char *
6314
assign_syslog_facility(const char *facility, bool doit, GucSource source)
6315
{
B
Bruce Momjian 已提交
6316
	int			syslog_fac;
6317

6318
	if (pg_strcasecmp(facility, "LOCAL0") == 0)
6319 6320 6321 6322 6323 6324 6325 6326 6327 6328 6329 6330 6331 6332 6333 6334 6335 6336 6337 6338 6339 6340 6341 6342 6343 6344
		syslog_fac = LOG_LOCAL0;
	else if (pg_strcasecmp(facility, "LOCAL1") == 0)
		syslog_fac = LOG_LOCAL1;
	else if (pg_strcasecmp(facility, "LOCAL2") == 0)
		syslog_fac = LOG_LOCAL2;
	else if (pg_strcasecmp(facility, "LOCAL3") == 0)
		syslog_fac = LOG_LOCAL3;
	else if (pg_strcasecmp(facility, "LOCAL4") == 0)
		syslog_fac = LOG_LOCAL4;
	else if (pg_strcasecmp(facility, "LOCAL5") == 0)
		syslog_fac = LOG_LOCAL5;
	else if (pg_strcasecmp(facility, "LOCAL6") == 0)
		syslog_fac = LOG_LOCAL6;
	else if (pg_strcasecmp(facility, "LOCAL7") == 0)
		syslog_fac = LOG_LOCAL7;
	else
		return NULL;			/* reject */

	if (doit)
	{
		syslog_facility = syslog_fac;
		set_syslog_parameters(syslog_ident_str ? syslog_ident_str : "postgres",
							  syslog_facility);
	}

	return facility;
6345
}
6346 6347 6348 6349 6350 6351 6352 6353 6354

static const char *
assign_syslog_ident(const char *ident, bool doit, GucSource source)
{
	if (doit)
		set_syslog_parameters(ident, syslog_facility);

	return ident;
}
B
Bruce Momjian 已提交
6355
#endif   /* HAVE_SYSLOG */
6356 6357 6358


static const char *
6359
assign_defaultxactisolevel(const char *newval, bool doit, GucSource source)
6360
{
6361
	if (pg_strcasecmp(newval, "serializable") == 0)
6362 6363 6364 6365
	{
		if (doit)
			DefaultXactIsoLevel = XACT_SERIALIZABLE;
	}
6366
	else if (pg_strcasecmp(newval, "repeatable read") == 0)
6367 6368 6369 6370
	{
		if (doit)
			DefaultXactIsoLevel = XACT_REPEATABLE_READ;
	}
6371
	else if (pg_strcasecmp(newval, "read committed") == 0)
6372 6373 6374 6375
	{
		if (doit)
			DefaultXactIsoLevel = XACT_READ_COMMITTED;
	}
6376
	else if (pg_strcasecmp(newval, "read uncommitted") == 0)
6377 6378 6379 6380
	{
		if (doit)
			DefaultXactIsoLevel = XACT_READ_UNCOMMITTED;
	}
6381 6382 6383 6384 6385
	else
		return NULL;
	return newval;
}

6386 6387 6388
static const char *
assign_session_replication_role(const char *newval, bool doit, GucSource source)
{
6389 6390
	int		newrole;

6391
	if (pg_strcasecmp(newval, "origin") == 0)
6392
		newrole = SESSION_REPLICATION_ROLE_ORIGIN;
6393
	else if (pg_strcasecmp(newval, "replica") == 0)
6394
		newrole = SESSION_REPLICATION_ROLE_REPLICA;
6395
	else if (pg_strcasecmp(newval, "local") == 0)
6396
		newrole = SESSION_REPLICATION_ROLE_LOCAL;
6397 6398
	else
		return NULL;
6399 6400 6401 6402 6403 6404 6405 6406 6407 6408 6409

	/*
	 * Must flush the plan cache when changing replication role; but don't
	 * flush unnecessarily.
	 */
	if (doit && SessionReplicationRole != newrole)
	{
		ResetPlanCache();
		SessionReplicationRole = newrole;
	}

6410 6411 6412
	return newval;
}

6413
static const char *
6414
assign_log_min_messages(const char *newval,
6415
						bool doit, GucSource source)
6416
{
6417
	return (assign_msglvl(&log_min_messages, newval, doit, source));
6418 6419
}

6420
static const char *
6421
assign_client_min_messages(const char *newval, bool doit, GucSource source)
6422
{
6423
	return (assign_msglvl(&client_min_messages, newval, doit, source));
6424 6425
}

6426
static const char *
6427
assign_min_error_statement(const char *newval, bool doit, GucSource source)
6428
{
6429
	return (assign_msglvl(&log_min_error_statement, newval, doit, source));
6430 6431 6432
}

static const char *
6433
assign_msglvl(int *var, const char *newval, bool doit, GucSource source)
6434
{
6435
	if (pg_strcasecmp(newval, "debug") == 0)
B
Bruce Momjian 已提交
6436 6437
	{
		if (doit)
6438
			(*var) = DEBUG2;
B
Bruce Momjian 已提交
6439
	}
6440
	else if (pg_strcasecmp(newval, "debug5") == 0)
B
Bruce Momjian 已提交
6441 6442 6443 6444
	{
		if (doit)
			(*var) = DEBUG5;
	}
6445
	else if (pg_strcasecmp(newval, "debug4") == 0)
B
Bruce Momjian 已提交
6446 6447 6448 6449
	{
		if (doit)
			(*var) = DEBUG4;
	}
6450
	else if (pg_strcasecmp(newval, "debug3") == 0)
B
Bruce Momjian 已提交
6451 6452 6453 6454
	{
		if (doit)
			(*var) = DEBUG3;
	}
6455
	else if (pg_strcasecmp(newval, "debug2") == 0)
B
Bruce Momjian 已提交
6456 6457 6458 6459
	{
		if (doit)
			(*var) = DEBUG2;
	}
6460
	else if (pg_strcasecmp(newval, "debug1") == 0)
B
Bruce Momjian 已提交
6461 6462 6463 6464
	{
		if (doit)
			(*var) = DEBUG1;
	}
6465
	else if (pg_strcasecmp(newval, "log") == 0)
B
Bruce Momjian 已提交
6466 6467 6468 6469
	{
		if (doit)
			(*var) = LOG;
	}
B
Bruce Momjian 已提交
6470

6471
	/*
B
Bruce Momjian 已提交
6472 6473
	 * Client_min_messages always prints 'info', but we allow it as a value
	 * anyway.
6474
	 */
6475
	else if (pg_strcasecmp(newval, "info") == 0)
B
Bruce Momjian 已提交
6476 6477 6478 6479
	{
		if (doit)
			(*var) = INFO;
	}
6480
	else if (pg_strcasecmp(newval, "notice") == 0)
B
Bruce Momjian 已提交
6481 6482 6483 6484
	{
		if (doit)
			(*var) = NOTICE;
	}
6485
	else if (pg_strcasecmp(newval, "warning") == 0)
B
Bruce Momjian 已提交
6486 6487 6488 6489
	{
		if (doit)
			(*var) = WARNING;
	}
6490
	else if (pg_strcasecmp(newval, "error") == 0)
B
Bruce Momjian 已提交
6491 6492 6493 6494
	{
		if (doit)
			(*var) = ERROR;
	}
6495
	/* We allow FATAL/PANIC for client-side messages too. */
6496
	else if (pg_strcasecmp(newval, "fatal") == 0)
6497 6498 6499 6500
	{
		if (doit)
			(*var) = FATAL;
	}
6501
	else if (pg_strcasecmp(newval, "panic") == 0)
6502 6503 6504 6505
	{
		if (doit)
			(*var) = PANIC;
	}
6506 6507 6508 6509
	else
		return NULL;			/* fail */
	return newval;				/* OK */
}
6510

6511
static const char *
6512
assign_log_error_verbosity(const char *newval, bool doit, GucSource source)
6513
{
6514
	if (pg_strcasecmp(newval, "terse") == 0)
6515 6516 6517 6518
	{
		if (doit)
			Log_error_verbosity = PGERROR_TERSE;
	}
6519
	else if (pg_strcasecmp(newval, "default") == 0)
6520 6521 6522 6523
	{
		if (doit)
			Log_error_verbosity = PGERROR_DEFAULT;
	}
6524
	else if (pg_strcasecmp(newval, "verbose") == 0)
6525 6526 6527 6528 6529 6530 6531 6532 6533
	{
		if (doit)
			Log_error_verbosity = PGERROR_VERBOSE;
	}
	else
		return NULL;			/* fail */
	return newval;				/* OK */
}

6534 6535 6536
static const char *
assign_log_statement(const char *newval, bool doit, GucSource source)
{
6537
	if (pg_strcasecmp(newval, "none") == 0)
6538 6539
	{
		if (doit)
6540
			log_statement = LOGSTMT_NONE;
6541
	}
6542
	else if (pg_strcasecmp(newval, "ddl") == 0)
6543 6544
	{
		if (doit)
6545
			log_statement = LOGSTMT_DDL;
6546
	}
6547
	else if (pg_strcasecmp(newval, "mod") == 0)
6548 6549
	{
		if (doit)
6550
			log_statement = LOGSTMT_MOD;
6551
	}
6552
	else if (pg_strcasecmp(newval, "all") == 0)
6553 6554
	{
		if (doit)
6555
			log_statement = LOGSTMT_ALL;
6556 6557 6558 6559 6560 6561
	}
	else
		return NULL;			/* fail */
	return newval;				/* OK */
}

6562 6563 6564 6565
static const char *
show_num_temp_buffers(void)
{
	/*
B
Bruce Momjian 已提交
6566 6567
	 * We show the GUC var until local buffers have been initialized, and
	 * NLocBuffer afterwards.
6568 6569 6570 6571 6572 6573 6574
	 */
	static char nbuf[32];

	sprintf(nbuf, "%d", NLocBuffer ? NLocBuffer : num_temp_buffers);
	return nbuf;
}

6575
static bool
6576
assign_phony_autocommit(bool newval, bool doit, GucSource source)
6577 6578 6579
{
	if (!newval)
	{
6580
		if (doit && source >= PGC_S_INTERACTIVE)
6581 6582
			ereport(ERROR,
					(errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
B
Bruce Momjian 已提交
6583
					 errmsg("SET AUTOCOMMIT TO OFF is no longer supported")));
6584 6585 6586 6587 6588
		return false;
	}
	return true;
}

6589 6590 6591
static const char *
assign_custom_variable_classes(const char *newval, bool doit, GucSource source)
{
B
Bruce Momjian 已提交
6592 6593
	/*
	 * Check syntax. newval must be a comma separated list of identifiers.
6594 6595
	 * Whitespace is allowed but skipped.
	 */
B
Bruce Momjian 已提交
6596
	bool		hasSpaceAfterToken = false;
6597
	const char *cp = newval;
B
Bruce Momjian 已提交
6598 6599
	int			symLen = 0;
	int			c;
6600 6601
	StringInfoData buf;

6602 6603 6604 6605 6606 6607 6608
	/*
	 * Resetting custom_variable_classes by removing it from the
	 * configuration file will lead to newval = NULL
	 */
	if (newval == NULL)
		return guc_strdup(ERROR, "");

6609
	initStringInfo(&buf);
B
Bruce Momjian 已提交
6610
	while ((c = *cp++) != 0)
6611
	{
6612
		if (isspace((unsigned char) c))
6613
		{
B
Bruce Momjian 已提交
6614
			if (symLen > 0)
6615 6616 6617 6618
				hasSpaceAfterToken = true;
			continue;
		}

B
Bruce Momjian 已提交
6619
		if (c == ',')
6620 6621
		{
			hasSpaceAfterToken = false;
B
Bruce Momjian 已提交
6622
			if (symLen > 0)
6623 6624 6625 6626 6627 6628 6629
			{
				symLen = 0;
				appendStringInfoChar(&buf, ',');
			}
			continue;
		}

6630
		if (hasSpaceAfterToken || !isalnum((unsigned char) c))
6631
		{
B
Bruce Momjian 已提交
6632
			/*
B
Bruce Momjian 已提交
6633 6634
			 * Syntax error due to token following space after token or non
			 * alpha numeric character
6635
			 */
6636
			ereport(LOG,
6637
					(errcode(ERRCODE_SYNTAX_ERROR),
P
Peter Eisentraut 已提交
6638
					 errmsg("invalid syntax for \"custom_variable_classes\": \"%s\"", newval)));
6639
			pfree(buf.data);
6640 6641 6642
			return NULL;
		}
		symLen++;
B
Bruce Momjian 已提交
6643
		appendStringInfoChar(&buf, (char) c);
6644 6645
	}

6646
	/* Remove stray ',' at end */
B
Bruce Momjian 已提交
6647
	if (symLen == 0 && buf.len > 0)
6648
		buf.data[--buf.len] = '\0';
6649

B
Bruce Momjian 已提交
6650
	if (buf.len == 0)
6651
		newval = NULL;
B
Bruce Momjian 已提交
6652
	else if (doit)
6653
		newval = guc_strdup(ERROR, buf.data);
6654 6655 6656 6657

	pfree(buf.data);
	return newval;
}
6658

6659 6660 6661 6662 6663 6664 6665
static bool
assign_debug_assertions(bool newval, bool doit, GucSource source)
{
#ifndef USE_ASSERT_CHECKING
	if (newval)
		ereport(ERROR,
				(errcode(ERRCODE_INVALID_PARAMETER_VALUE),
B
Bruce Momjian 已提交
6666
			   errmsg("assertion checking is not supported by this build")));
6667 6668 6669 6670
#endif
	return true;
}

6671 6672 6673 6674 6675 6676 6677 6678 6679 6680 6681 6682
static bool
assign_ssl(bool newval, bool doit, GucSource source)
{
#ifndef USE_SSL
	if (newval)
		ereport(ERROR,
				(errcode(ERRCODE_INVALID_PARAMETER_VALUE),
				 errmsg("SSL is not supported by this build")));
#endif
	return true;
}

6683 6684 6685
static bool
assign_stage_log_stats(bool newval, bool doit, GucSource source)
{
6686
	if (newval && log_statement_stats)
6687
	{
6688 6689 6690 6691
		if (source >= PGC_S_INTERACTIVE)
			ereport(ERROR,
					(errcode(ERRCODE_INVALID_PARAMETER_VALUE),
					 errmsg("cannot enable parameter when \"log_statement_stats\" is true")));
6692 6693
		/* source == PGC_S_OVERRIDE means do it anyway, eg at xact abort */
		else if (source != PGC_S_OVERRIDE)
6694
			return false;
6695 6696 6697 6698 6699 6700 6701
	}
	return true;
}

static bool
assign_log_stats(bool newval, bool doit, GucSource source)
{
6702 6703
	if (newval &&
		(log_parser_stats || log_planner_stats || log_executor_stats))
6704
	{
6705 6706 6707 6708 6709 6710
		if (source >= PGC_S_INTERACTIVE)
			ereport(ERROR,
					(errcode(ERRCODE_INVALID_PARAMETER_VALUE),
					 errmsg("cannot enable \"log_statement_stats\" when "
							"\"log_parser_stats\", \"log_planner_stats\", "
							"or \"log_executor_stats\" is true")));
6711 6712
		/* source == PGC_S_OVERRIDE means do it anyway, eg at xact abort */
		else if (source != PGC_S_OVERRIDE)
6713
			return false;
6714 6715 6716 6717
	}
	return true;
}

6718 6719 6720
static bool
assign_transaction_read_only(bool newval, bool doit, GucSource source)
{
6721 6722 6723 6724 6725 6726 6727
	/* Can't go to r/w mode inside a r/o transaction */
	if (newval == false && XactReadOnly && IsSubTransaction())
	{
		if (source >= PGC_S_INTERACTIVE)
			ereport(ERROR,
					(errcode(ERRCODE_INVALID_PARAMETER_VALUE),
					 errmsg("cannot set transaction read-write mode inside a read-only transaction")));
6728 6729 6730
		/* source == PGC_S_OVERRIDE means do it anyway, eg at xact abort */
		else if (source != PGC_S_OVERRIDE)
			return false;
6731
	}
6732 6733
	return true;
}
6734

6735 6736 6737 6738 6739
static const char *
assign_canonical_path(const char *newval, bool doit, GucSource source)
{
	if (doit)
	{
B
Bruce Momjian 已提交
6740 6741
		char	   *canon_val = guc_strdup(ERROR, newval);

6742 6743 6744 6745 6746 6747 6748
		canonicalize_path(canon_val);
		return canon_val;
	}
	else
		return newval;
}

6749 6750 6751 6752
static const char *
assign_backslash_quote(const char *newval, bool doit, GucSource source)
{
	BackslashQuoteType bq;
B
Bruce Momjian 已提交
6753
	bool		bqbool;
6754 6755

	/*
B
Bruce Momjian 已提交
6756 6757
	 * Although only "on", "off", and "safe_encoding" are documented, we use
	 * parse_bool so we can accept all the likely variants of "on" and "off".
6758 6759 6760 6761 6762 6763 6764 6765 6766 6767 6768 6769 6770 6771 6772 6773
	 */
	if (pg_strcasecmp(newval, "safe_encoding") == 0)
		bq = BACKSLASH_QUOTE_SAFE_ENCODING;
	else if (parse_bool(newval, &bqbool))
	{
		bq = bqbool ? BACKSLASH_QUOTE_ON : BACKSLASH_QUOTE_OFF;
	}
	else
		return NULL;			/* reject */

	if (doit)
		backslash_quote = bq;

	return newval;
}

6774 6775 6776
static const char *
assign_timezone_abbreviations(const char *newval, bool doit, GucSource source)
{
6777 6778 6779 6780
	/*
	 * The powerup value shown above for timezone_abbreviations is "UNKNOWN".
	 * When we see this we just do nothing.  If this value isn't overridden
	 * from the config file then pg_timezone_abbrev_initialize() will
B
Bruce Momjian 已提交
6781 6782 6783 6784 6785 6786 6787 6788
	 * eventually replace it with "Default".  This hack has two purposes: to
	 * avoid wasting cycles loading values that might soon be overridden from
	 * the config file, and to avoid trying to read the timezone abbrev files
	 * during InitializeGUCOptions().  The latter doesn't work in an
	 * EXEC_BACKEND subprocess because my_exec_path hasn't been set yet and so
	 * we can't locate PGSHAREDIR.  (Essentially the same hack is used to
	 * delay initializing TimeZone ... if we have any more, we should try to
	 * clean up and centralize this mechanism ...)
6789 6790 6791 6792 6793 6794
	 */
	if (strcmp(newval, "UNKNOWN") == 0)
	{
		return newval;
	}

6795
	/* Loading abbrev file is expensive, so only do it when value changes */
6796 6797
	if (timezone_abbreviations_string == NULL ||
		strcmp(timezone_abbreviations_string, newval) != 0)
6798
	{
B
Bruce Momjian 已提交
6799
		int			elevel;
6800 6801 6802

		/*
		 * If reading config file, only the postmaster should bleat loudly
B
Bruce Momjian 已提交
6803
		 * about problems.	Otherwise, it's just this one process doing it,
6804 6805 6806 6807 6808 6809 6810 6811 6812 6813 6814 6815
		 * and we use WARNING message level.
		 */
		if (source == PGC_S_FILE)
			elevel = IsUnderPostmaster ? DEBUG2 : LOG;
		else
			elevel = WARNING;
		if (!load_tzoffsets(newval, doit, elevel))
			return NULL;
	}
	return newval;
}

6816 6817 6818 6819 6820 6821 6822 6823 6824 6825 6826 6827 6828 6829 6830 6831
/*
 * pg_timezone_abbrev_initialize --- set default value if not done already
 *
 * This is called after initial loading of postgresql.conf.  If no
 * timezone_abbreviations setting was found therein, select default.
 */
void
pg_timezone_abbrev_initialize(void)
{
	if (strcmp(timezone_abbreviations_string, "UNKNOWN") == 0)
	{
		SetConfigOption("timezone_abbreviations", "Default",
						PGC_POSTMASTER, PGC_S_ARGV);
	}
}

6832 6833 6834 6835 6836 6837 6838 6839 6840 6841 6842 6843 6844 6845 6846 6847 6848 6849
static const char *
assign_xmlbinary(const char *newval, bool doit, GucSource source)
{
	XmlBinaryType xb;

	if (pg_strcasecmp(newval, "base64") == 0)
		xb = XMLBINARY_BASE64;
	else if (pg_strcasecmp(newval, "hex") == 0)
		xb = XMLBINARY_HEX;
	else
		return NULL;			/* reject */

	if (doit)
		xmlbinary = xb;

	return newval;
}

6850 6851 6852 6853 6854 6855 6856 6857 6858 6859 6860 6861 6862 6863 6864 6865 6866 6867
static const char *
assign_xmloption(const char *newval, bool doit, GucSource source)
{
	XmlOptionType xo;

	if (pg_strcasecmp(newval, "document") == 0)
		xo = XMLOPTION_DOCUMENT;
	else if (pg_strcasecmp(newval, "content") == 0)
		xo = XMLOPTION_CONTENT;
	else
		return NULL;			/* reject */

	if (doit)
		xmloption = xo;

	return newval;
}

6868 6869 6870
static bool
assign_tcp_keepalives_idle(int newval, bool doit, GucSource source)
{
6871
	if (doit)
6872 6873 6874 6875 6876 6877 6878 6879
		return (pq_setkeepalivesidle(newval, MyProcPort) == STATUS_OK);

	return true;
}

static const char *
show_tcp_keepalives_idle(void)
{
6880 6881 6882
	static char nbuf[16];

	snprintf(nbuf, sizeof(nbuf), "%d", pq_getkeepalivesidle(MyProcPort));
6883 6884 6885 6886 6887 6888
	return nbuf;
}

static bool
assign_tcp_keepalives_interval(int newval, bool doit, GucSource source)
{
6889
	if (doit)
6890 6891 6892 6893 6894 6895 6896 6897
		return (pq_setkeepalivesinterval(newval, MyProcPort) == STATUS_OK);

	return true;
}

static const char *
show_tcp_keepalives_interval(void)
{
6898 6899 6900
	static char nbuf[16];

	snprintf(nbuf, sizeof(nbuf), "%d", pq_getkeepalivesinterval(MyProcPort));
6901 6902 6903 6904 6905 6906
	return nbuf;
}

static bool
assign_tcp_keepalives_count(int newval, bool doit, GucSource source)
{
6907
	if (doit)
6908 6909 6910 6911 6912 6913 6914 6915
		return (pq_setkeepalivescount(newval, MyProcPort) == STATUS_OK);

	return true;
}

static const char *
show_tcp_keepalives_count(void)
{
6916 6917 6918
	static char nbuf[16];

	snprintf(nbuf, sizeof(nbuf), "%d", pq_getkeepalivescount(MyProcPort));
6919 6920
	return nbuf;
}
6921

6922 6923 6924 6925 6926 6927 6928 6929 6930 6931 6932 6933 6934 6935 6936 6937 6938 6939 6940 6941 6942 6943 6944 6945 6946 6947 6948
static bool
assign_maxconnections(int newval, bool doit, GucSource source)
{
	if (doit)
	{
		if (newval + autovacuum_max_workers > INT_MAX / 4)
			return false;

		MaxBackends = newval + autovacuum_max_workers;
	}

	return true;
}

static bool
assign_autovacuum_max_workers(int newval, bool doit, GucSource source)
{
	if (doit)
	{
		if (newval + MaxConnections > INT_MAX / 4)
			return false;

		MaxBackends = newval + MaxConnections;
	}

	return true;
}
6949

6950
#include "guc-file.c"