postgres.c 95.5 KB
Newer Older
1 2
/*-------------------------------------------------------------------------
 *
3
 * postgres.c
4
 *	  POSTGRES C Backend Interface
5
 *
6
 * Portions Copyright (c) 1996-2006, PostgreSQL Global Development Group
B
Add:  
Bruce Momjian 已提交
7
 * Portions Copyright (c) 1994, Regents of the University of California
8 9 10
 *
 *
 * IDENTIFICATION
11
 *	  $PostgreSQL: pgsql/src/backend/tcop/postgres.c,v 1.486 2006/04/25 00:25:18 momjian Exp $
12 13
 *
 * NOTES
14 15
 *	  this is the "main" module of the postgres backend and
 *	  hence the main module of the "traffic cop".
16 17 18
 *
 *-------------------------------------------------------------------------
 */
B
Bruce Momjian 已提交
19

20 21
#include "postgres.h"

B
Bruce Momjian 已提交
22
#include <unistd.h>
23
#include <signal.h>
B
Bruce Momjian 已提交
24
#include <fcntl.h>
25
#include <sys/socket.h>
26
#if HAVE_SYS_SELECT_H
27
#include <sys/select.h>
28
#endif
29
#ifdef HAVE_GETOPT_H
B
Bruce Momjian 已提交
30
#include <getopt.h>
31
#endif
32

33
#include "access/printtup.h"
34
#include "access/xlog.h"
35
#include "catalog/pg_type.h"
36
#include "commands/async.h"
37
#include "commands/prepare.h"
38
#include "commands/trigger.h"
39
#include "libpq/libpq.h"
40
#include "libpq/pqformat.h"
41
#include "libpq/pqsignal.h"
B
Bruce Momjian 已提交
42
#include "miscadmin.h"
43 44
#include "nodes/print.h"
#include "optimizer/cost.h"
45
#include "optimizer/planner.h"
46
#include "parser/analyze.h"
47
#include "parser/parser.h"
B
Bruce Momjian 已提交
48
#include "rewrite/rewriteHandler.h"
49
#include "storage/freespace.h"
50
#include "storage/ipc.h"
51
#include "storage/pg_shmem.h"
52
#include "storage/proc.h"
53
#include "storage/sinval.h"
54 55
#include "tcop/fastpath.h"
#include "tcop/pquery.h"
B
Bruce Momjian 已提交
56
#include "tcop/tcopprot.h"
57
#include "tcop/utility.h"
58
#include "utils/builtins.h"
59
#include "utils/flatfiles.h"
60
#include "utils/guc.h"
61
#include "utils/lsyscache.h"
62
#include "utils/memutils.h"
M
 
Marc G. Fournier 已提交
63
#include "utils/ps_status.h"
B
Bruce Momjian 已提交
64
#include "mb/pg_wchar.h"
65

66
#include "pgstat.h"
M
 
Marc G. Fournier 已提交
67

68 69 70
extern int	optind;
extern char *optarg;

71
/* ----------------
72
 *		global variables
73 74
 * ----------------
 */
B
Bruce Momjian 已提交
75
const char *debug_query_string; /* for pgmonitor and log_min_error_statement */
76

77
/* Note: whereToSendOutput is initialized for the bootstrap/standalone case */
78
CommandDest whereToSendOutput = DestDebug;
79

80
/* flag for logging end of session */
B
Bruce Momjian 已提交
81
bool		Log_disconnections = false;
82

83 84
LogStmtLevel log_statement = LOGSTMT_NONE;

85 86 87
/* GUC variable for maximum stack depth (measured in kilobytes) */
int			max_stack_depth = 2048;

88 89 90 91
/* wait N seconds to allow attach from a debugger */
int			PostAuthDelay = 0;


92

93 94 95 96
/* ----------------
 *		private variables
 * ----------------
 */
97

98
/* max_stack_depth converted to bytes for speed of checking */
B
Bruce Momjian 已提交
99
static int	max_stack_depth_bytes = 2048 * 1024;
100

N
Neil Conway 已提交
101 102 103 104
/*
 * Stack base pointer -- initialized by PostgresMain. This is not static
 * so that PL/Java can modify it.
 */
B
Bruce Momjian 已提交
105
char	   *stack_base_ptr = NULL;
106 107


108 109 110 111 112
/*
 * Flag to mark SIGHUP. Whenever the main loop comes around it
 * will reread the configuration file. (Better than doing the
 * reading in the signal handler, ey?)
 */
113
static volatile sig_atomic_t got_SIGHUP = false;
114

115 116 117 118 119 120
/*
 * Flag to keep track of whether we have started a transaction.
 * For extended query protocol this has to be remembered across messages.
 */
static bool xact_started = false;

121 122 123 124 125 126
/*
 * Flag to keep track of whether we have done statement initialization.
 * For extended query protocol this has to be remembered across messages.
 */
static bool command_initialized = false;

127 128 129 130 131 132 133
/*
 * Flag to indicate that we are doing the outer loop's read-from-client,
 * as opposed to any random read from client that might happen within
 * commands like COPY FROM STDIN.
 */
static bool DoingCommandRead = false;

134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154
/*
 * Flags to implement skip-till-Sync-after-error behavior for messages of
 * the extended query protocol.
 */
static bool doing_extended_query_message = false;
static bool ignore_till_sync = false;

/*
 * If an unnamed prepared statement exists, it's stored here.
 * We keep it separate from the hashtable kept by commands/prepare.c
 * in order to reduce overhead for short-lived queries.
 */
static MemoryContext unnamed_stmt_context = NULL;
static PreparedStatement *unnamed_stmt_pstmt = NULL;


static bool EchoQuery = false;	/* default don't echo */

/*
 * people who want to use EOF should #define DONTUSENEWLINE in
 * tcop/tcopdebug.h
155 156
 */
#ifndef TCOP_DONTUSENEWLINE
B
Bruce Momjian 已提交
157
static int	UseNewLine = 1;		/* Use newlines query delimiters (the default) */
158
#else
159
static int	UseNewLine = 0;		/* Use EOF as query delimiters */
160
#endif   /* TCOP_DONTUSENEWLINE */
161 162 163


/* ----------------------------------------------------------------
164
 *		decls for routines only used in this file
165 166
 * ----------------------------------------------------------------
 */
167 168 169
static int	InteractiveBackend(StringInfo inBuf);
static int	SocketBackend(StringInfo inBuf);
static int	ReadCommand(StringInfo inBuf);
170 171
static bool log_after_parse(List *raw_parsetree_list,
				const char *query_string, char **prepare_string);
172
static List *pg_rewrite_queries(List *querytree_list);
173 174
static void initialize_command(void);
static void finalize_command(void);
175
static void start_xact_command(void);
176
static void finish_xact_command(void);
177 178 179
static bool IsTransactionExitStmt(Node *parsetree);
static bool IsTransactionExitStmtList(List *parseTrees);
static bool IsTransactionStmtList(List *parseTrees);
180
static void SigHupHandler(SIGNAL_ARGS);
181
static void log_disconnections(int code, Datum arg);
182 183 184


/* ----------------------------------------------------------------
185
 *		routines to obtain user input
186 187 188 189
 * ----------------------------------------------------------------
 */

/* ----------------
190
 *	InteractiveBackend() is called for user interactive connections
191 192 193
 *
 *	the string entered by the user is placed in its parameter inBuf,
 *	and we act like a Q message was received.
194
 *
195
 *	EOF is returned if end-of-file input is seen; time to shut down.
196 197 198
 * ----------------
 */

199
static int
200
InteractiveBackend(StringInfo inBuf)
201
{
202 203 204
	int			c;				/* character read from getc() */
	bool		end = false;	/* end-of-input flag */
	bool		backslashSeen = false;	/* have we seen a \ ? */
205

206 207
	/*
	 * display a prompt and obtain input from the user
208
	 */
209
	printf("backend> ");
210
	fflush(stdout);
211

212 213 214
	/* Reset inBuf to empty */
	inBuf->len = 0;
	inBuf->data[0] = '\0';
215
	inBuf->cursor = 0;
216

217 218 219 220
	for (;;)
	{
		if (UseNewLine)
		{
221
			/*
B
Bruce Momjian 已提交
222 223
			 * if we are using \n as a delimiter, then read characters until
			 * the \n.
224 225 226 227 228 229 230
			 */
			while ((c = getc(stdin)) != EOF)
			{
				if (c == '\n')
				{
					if (backslashSeen)
					{
231 232 233
						/* discard backslash from inBuf */
						inBuf->data[--inBuf->len] = '\0';
						backslashSeen = false;
234 235 236 237 238
						continue;
					}
					else
					{
						/* keep the newline character */
239
						appendStringInfoChar(inBuf, '\n');
240 241 242 243 244 245 246 247
						break;
					}
				}
				else if (c == '\\')
					backslashSeen = true;
				else
					backslashSeen = false;

248
				appendStringInfoChar(inBuf, (char) c);
249 250 251 252 253 254 255
			}

			if (c == EOF)
				end = true;
		}
		else
		{
256 257
			/*
			 * otherwise read characters until EOF.
258 259
			 */
			while ((c = getc(stdin)) != EOF)
260
				appendStringInfoChar(inBuf, (char) c);
261

262
			if (inBuf->len == 0)
263 264 265 266
				end = true;
		}

		if (end)
267
			return EOF;
268

269 270
		/*
		 * otherwise we have a user query so process it.
271 272 273 274
		 */
		break;
	}

275 276 277
	/* Add '\0' to make it look the same as message case. */
	appendStringInfoChar(inBuf, (char) '\0');

278 279
	/*
	 * if the query echo flag was given, print the query..
280 281
	 */
	if (EchoQuery)
282
		printf("statement: %s\n", inBuf->data);
283
	fflush(stdout);
284

285
	return 'Q';
286 287 288
}

/* ----------------
289
 *	SocketBackend()		Is called for frontend-backend connections
290
 *
291
 *	Returns the message type code, and loads message body data into inBuf.
292
 *
293
 *	EOF is returned if the connection is lost.
294 295
 * ----------------
 */
296
static int
297
SocketBackend(StringInfo inBuf)
298
{
299
	int			qtype;
300

301
	/*
302
	 * Get message type code from the frontend.
303
	 */
304
	qtype = pq_getbyte();
305

306 307
	if (qtype == EOF)			/* frontend disconnected */
	{
308 309 310
		ereport(COMMERROR,
				(errcode(ERRCODE_PROTOCOL_VIOLATION),
				 errmsg("unexpected EOF on client connection")));
311 312 313 314
		return qtype;
	}

	/*
B
Bruce Momjian 已提交
315 316 317
	 * Validate message type code before trying to read body; if we have lost
	 * sync, better to say "command unknown" than to run out of memory because
	 * we used garbage as a length word.
318
	 *
319 320
	 * This also gives us a place to set the doing_extended_query_message flag
	 * as soon as possible.
321
	 */
322
	switch (qtype)
323
	{
324
		case 'Q':				/* simple query */
325
			doing_extended_query_message = false;
326 327 328 329 330
			if (PG_PROTOCOL_MAJOR(FrontendProtocol) < 3)
			{
				/* old style without length word; convert */
				if (pq_getstring(inBuf))
				{
331 332
					ereport(COMMERROR,
							(errcode(ERRCODE_PROTOCOL_VIOLATION),
B
Bruce Momjian 已提交
333
							 errmsg("unexpected EOF on client connection")));
334 335 336
					return EOF;
				}
			}
337 338
			break;

339
		case 'F':				/* fastpath function call */
340 341
			/* we let fastpath.c cope with old-style input of this */
			doing_extended_query_message = false;
342
			break;
343

344
		case 'X':				/* terminate */
345
			doing_extended_query_message = false;
346
			ignore_till_sync = false;
347 348 349 350 351 352 353 354 355 356 357
			break;

		case 'B':				/* bind */
		case 'C':				/* close */
		case 'D':				/* describe */
		case 'E':				/* execute */
		case 'H':				/* flush */
		case 'P':				/* parse */
			doing_extended_query_message = true;
			/* these are only legal in protocol 3 */
			if (PG_PROTOCOL_MAJOR(FrontendProtocol) < 3)
358 359
				ereport(FATAL,
						(errcode(ERRCODE_PROTOCOL_VIOLATION),
B
Bruce Momjian 已提交
360
						 errmsg("invalid frontend message type %d", qtype)));
361 362 363 364 365 366 367 368 369
			break;

		case 'S':				/* sync */
			/* stop any active skip-till-Sync */
			ignore_till_sync = false;
			/* mark not-extended, so that a new error doesn't begin skip */
			doing_extended_query_message = false;
			/* only legal in protocol 3 */
			if (PG_PROTOCOL_MAJOR(FrontendProtocol) < 3)
370 371
				ereport(FATAL,
						(errcode(ERRCODE_PROTOCOL_VIOLATION),
B
Bruce Momjian 已提交
372
						 errmsg("invalid frontend message type %d", qtype)));
373
			break;
374

375 376 377
		case 'd':				/* copy data */
		case 'c':				/* copy done */
		case 'f':				/* copy fail */
378 379 380
			doing_extended_query_message = false;
			/* these are only legal in protocol 3 */
			if (PG_PROTOCOL_MAJOR(FrontendProtocol) < 3)
381 382
				ereport(FATAL,
						(errcode(ERRCODE_PROTOCOL_VIOLATION),
B
Bruce Momjian 已提交
383
						 errmsg("invalid frontend message type %d", qtype)));
384
			break;
385

386
		default:
B
Bruce Momjian 已提交
387

388
			/*
B
Bruce Momjian 已提交
389 390 391
			 * Otherwise we got garbage from the frontend.	We treat this as
			 * fatal because we have probably lost message boundary sync, and
			 * there's no good way to recover.
392
			 */
393 394 395
			ereport(FATAL,
					(errcode(ERRCODE_PROTOCOL_VIOLATION),
					 errmsg("invalid frontend message type %d", qtype)));
396
			break;
397
	}
398

399
	/*
B
Bruce Momjian 已提交
400 401 402
	 * In protocol version 3, all frontend messages have a length word next
	 * after the type code; we can read the message contents independently of
	 * the type.
403 404 405 406 407 408 409
	 */
	if (PG_PROTOCOL_MAJOR(FrontendProtocol) >= 3)
	{
		if (pq_getmessage(inBuf, 0))
			return EOF;			/* suitable message already logged */
	}

410
	return qtype;
411 412 413
}

/* ----------------
414
 *		ReadCommand reads a command from either the frontend or
415 416 417
 *		standard input, places it in inBuf, and returns the
 *		message type code (first byte of the message).
 *		EOF is returned if end of file.
418 419
 * ----------------
 */
420
static int
421
ReadCommand(StringInfo inBuf)
422
{
423
	int			result;
424

425
	if (whereToSendOutput == DestRemote)
426
		result = SocketBackend(inBuf);
427
	else
428 429
		result = InteractiveBackend(inBuf);
	return result;
430 431
}

432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477
/*
 * prepare_for_client_read -- set up to possibly block on client input
 *
 * This must be called immediately before any low-level read from the
 * client connection.  It is necessary to do it at a sufficiently low level
 * that there won't be any other operations except the read kernel call
 * itself between this call and the subsequent client_read_ended() call.
 * In particular there mustn't be use of malloc() or other potentially
 * non-reentrant libc functions.  This restriction makes it safe for us
 * to allow interrupt service routines to execute nontrivial code while
 * we are waiting for input.
 */
void
prepare_for_client_read(void)
{
	if (DoingCommandRead)
	{
		/* Enable immediate processing of asynchronous signals */
		EnableNotifyInterrupt();
		EnableCatchupInterrupt();

		/* Allow "die" interrupt to be processed while waiting */
		ImmediateInterruptOK = true;

		/* And don't forget to detect one that already arrived */
		QueryCancelPending = false;
		CHECK_FOR_INTERRUPTS();
	}
}

/*
 * client_read_ended -- get out of the client-input state
 */
void
client_read_ended(void)
{
	if (DoingCommandRead)
	{
		ImmediateInterruptOK = false;
		QueryCancelPending = false;		/* forget any CANCEL signal */

		DisableNotifyInterrupt();
		DisableCatchupInterrupt();
	}
}

478 479 480 481 482 483

/*
 * Parse a query string and pass it through the rewriter.
 *
 * A list of Query nodes is returned, since the string might contain
 * multiple queries and/or the rewriter might expand one query to several.
484 485 486
 *
 * NOTE: this routine is no longer used for processing interactive queries,
 * but it is still needed for parsing of SQL function bodies.
487
 */
488
List *
B
Bruce Momjian 已提交
489
pg_parse_and_rewrite(const char *query_string,	/* string to execute */
490
					 Oid *paramTypes,	/* parameter types */
B
Bruce Momjian 已提交
491
					 int numParams)		/* number of parameters */
492
{
493
	List	   *raw_parsetree_list;
494
	List	   *querytree_list;
495
	ListCell   *list_item;
496

497 498
	/*
	 * (1) parse the request string into a list of raw parse trees.
499
	 */
500
	raw_parsetree_list = pg_parse_query(query_string);
501

502 503
	/*
	 * (2) Do parse analysis and rule rewrite.
504 505 506 507
	 */
	querytree_list = NIL;
	foreach(list_item, raw_parsetree_list)
	{
B
Bruce Momjian 已提交
508
		Node	   *parsetree = (Node *) lfirst(list_item);
509

510
		querytree_list = list_concat(querytree_list,
B
Bruce Momjian 已提交
511
									 pg_analyze_and_rewrite(parsetree,
512
															query_string,
B
Bruce Momjian 已提交
513 514
															paramTypes,
															numParams));
515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532
	}

	return querytree_list;
}

/*
 * Do raw parsing (only).
 *
 * A list of parsetrees is returned, since there might be multiple
 * commands in the given string.
 *
 * NOTE: for interactive queries, it is important to keep this routine
 * separate from the analysis & rewrite stages.  Analysis and rewriting
 * cannot be done in an aborted transaction, since they require access to
 * database tables.  So, we rely on the raw parser to determine whether
 * we've seen a COMMIT or ABORT command; when we are in abort state, other
 * commands are not processed any further than the raw parse stage.
 */
533
List *
534
pg_parse_query(const char *query_string)
535
{
536
	List	   *raw_parsetree_list;
537

B
Rename:  
Bruce Momjian 已提交
538
	if (log_parser_stats)
539 540
		ResetUsage();

541
	raw_parsetree_list = raw_parser(query_string);
542

543 544 545 546 547 548 549 550
	if (log_parser_stats)
		ShowUsage("PARSER STATISTICS");

	return raw_parsetree_list;
}

static bool
log_after_parse(List *raw_parsetree_list, const char *query_string,
B
Bruce Momjian 已提交
551
				char **prepare_string)
552 553 554 555 556 557
{
	ListCell   *parsetree_item;
	bool		log_this_statement = (log_statement == LOGSTMT_ALL);

	*prepare_string = NULL;

B
Bruce Momjian 已提交
558
	/* Check if we need to log the statement, and get prepare_string. */
559
	foreach(parsetree_item, raw_parsetree_list)
560
	{
561 562 563 564 565 566 567 568 569 570
		Node	   *parsetree = (Node *) lfirst(parsetree_item);
		const char *commandTag;

		if (IsA(parsetree, ExplainStmt) &&
			((ExplainStmt *) parsetree)->analyze)
			parsetree = (Node *) (((ExplainStmt *) parsetree)->query);

		if (IsA(parsetree, PrepareStmt))
			parsetree = (Node *) (((PrepareStmt *) parsetree)->query);

571 572
		if (IsA(parsetree, SelectStmt) &&
			((SelectStmt *) parsetree)->into == NULL)
B
Bruce Momjian 已提交
573
			continue;			/* optimization for frequent command */
574 575 576 577 578 579 580

		if (log_statement == LOGSTMT_MOD &&
			(IsA(parsetree, InsertStmt) ||
			 IsA(parsetree, UpdateStmt) ||
			 IsA(parsetree, DeleteStmt) ||
			 IsA(parsetree, TruncateStmt) ||
			 (IsA(parsetree, CopyStmt) &&
B
Bruce Momjian 已提交
581
			  ((CopyStmt *) parsetree)->is_from)))		/* COPY FROM */
582 583 584 585 586 587
			log_this_statement = true;

		commandTag = CreateCommandTag(parsetree);
		if ((log_statement == LOGSTMT_MOD ||
			 log_statement == LOGSTMT_DDL) &&
			(strncmp(commandTag, "CREATE ", strlen("CREATE ")) == 0 ||
B
Bruce Momjian 已提交
588
			 IsA(parsetree, SelectStmt) ||		/* SELECT INTO, CREATE AS */
589 590
			 strncmp(commandTag, "ALTER ", strlen("ALTER ")) == 0 ||
			 strncmp(commandTag, "DROP ", strlen("DROP ")) == 0 ||
B
Bruce Momjian 已提交
591
			 IsA(parsetree, GrantStmt) ||		/* GRANT or REVOKE */
592 593 594 595
			 IsA(parsetree, CommentStmt)))
			log_this_statement = true;

		/*
B
Bruce Momjian 已提交
596
		 * For the first EXECUTE we find, record the client statement used by
597 598
		 * the PREPARE.  PREPARE doesn't save the parse tree so we have no
		 * way to conditionally output based on the type of query prepared.
599 600
		 */
		if (IsA(parsetree, ExecuteStmt))
601
		{
602 603 604
			ExecuteStmt *stmt = (ExecuteStmt *) parsetree;
			PreparedStatement *entry;

605 606
			if (*prepare_string == NULL &&
				(entry = FetchPreparedStatement(stmt->name, false)) != NULL &&
607
				entry->query_string)
608
			{
609
				*prepare_string = palloc(strlen(entry->query_string) +
610 611
									  strlen("  [PREPARE:  %s]") - 2 + 1);
				sprintf(*prepare_string, "  [PREPARE:  %s]",
B
Bruce Momjian 已提交
612
						entry->query_string);
613 614 615
			}
		}
	}
B
Bruce Momjian 已提交
616

617 618 619 620 621 622 623 624 625
	if (log_this_statement)
	{
		ereport(LOG,
				(errmsg("statement: %s%s", query_string,
						*prepare_string ? *prepare_string : "")));
		return true;
	}
	else
		return false;
626 627
}

628

629
/*
630 631
 * Given a raw parsetree (gram.y output), and optionally information about
 * types of parameter symbols ($n), perform parse analysis and rule rewriting.
632 633 634 635 636 637
 *
 * A list of Query nodes is returned, since either the analyzer or the
 * rewriter might expand one query to several.
 *
 * NOTE: for reasons mentioned above, this must be separate from raw parsing.
 */
638
List *
639 640
pg_analyze_and_rewrite(Node *parsetree, const char *query_string,
					   Oid *paramTypes, int numParams)
641 642 643
{
	List	   *querytree_list;

644 645
	/*
	 * (1) Perform parse analysis.
646
	 */
B
Rename:  
Bruce Momjian 已提交
647
	if (log_parser_stats)
648 649
		ResetUsage();

650 651
	querytree_list = parse_analyze(parsetree, query_string,
								   paramTypes, numParams);
652

B
Rename:  
Bruce Momjian 已提交
653
	if (log_parser_stats)
654
		ShowUsage("PARSE ANALYSIS STATISTICS");
655

656 657
	/*
	 * (2) Rewrite the queries, as necessary
658 659 660 661 662 663 664 665
	 */
	querytree_list = pg_rewrite_queries(querytree_list);

	return querytree_list;
}

/*
 * Perform rewriting of a list of queries produced by parse analysis.
666 667 668
 *
 * Note: queries must just have come from the parser, because we do not do
 * AcquireRewriteLocks() on them.
669
 */
670
static List *
671 672 673
pg_rewrite_queries(List *querytree_list)
{
	List	   *new_list = NIL;
674
	ListCell   *list_item;
675 676 677 678 679

	if (log_parser_stats)
		ResetUsage();

	/*
B
Bruce Momjian 已提交
680 681
	 * rewritten queries are collected in new_list.  Note there may be more or
	 * fewer than in the original list.
682
	 */
683
	foreach(list_item, querytree_list)
684
	{
685
		Query	   *querytree = (Query *) lfirst(list_item);
686

687
		if (Debug_print_parse)
688
			elog_node_display(DEBUG1, "parse tree", querytree,
689
							  Debug_pretty_print);
690 691 692

		if (querytree->commandType == CMD_UTILITY)
		{
693 694
			/* don't rewrite utilities, just dump 'em into new_list */
			new_list = lappend(new_list, querytree);
695
		}
696
		else
697
		{
698
			/* rewrite regular queries */
699 700
			List	   *rewritten = QueryRewrite(querytree);

701
			new_list = list_concat(new_list, rewritten);
702 703 704 705 706
		}
	}

	querytree_list = new_list;

B
Rename:  
Bruce Momjian 已提交
707
	if (log_parser_stats)
708
		ShowUsage("REWRITER STATISTICS");
709

710
#ifdef COPY_PARSE_PLAN_TREES
B
Bruce Momjian 已提交
711 712

	/*
B
Bruce Momjian 已提交
713
	 * Optional debugging check: pass querytree output through copyObject()
B
Bruce Momjian 已提交
714
	 */
715 716
	new_list = (List *) copyObject(querytree_list);
	/* This checks both copyObject() and the equal() routines... */
B
Bruce Momjian 已提交
717
	if (!equal(new_list, querytree_list))
718
		elog(WARNING, "copyObject() failed to produce an equal parse tree");
719 720
	else
		querytree_list = new_list;
721 722
#endif

723
	if (Debug_print_rewritten)
724
		elog_node_display(DEBUG1, "rewritten parse tree", querytree_list,
725
						  Debug_pretty_print);
726

727 728
	return querytree_list;
}
729 730


731
/* Generate a plan for a single already-rewritten query. */
732
Plan *
733
pg_plan_query(Query *querytree, ParamListInfo boundParams)
734 735
{
	Plan	   *plan;
736

737 738 739
	/* Utility commands have no plans. */
	if (querytree->commandType == CMD_UTILITY)
		return NULL;
740

B
Rename:  
Bruce Momjian 已提交
741
	if (log_planner_stats)
742
		ResetUsage();
743

744
	/* call the optimizer */
745
	plan = planner(querytree, false, 0, boundParams);
746

B
Rename:  
Bruce Momjian 已提交
747
	if (log_planner_stats)
748
		ShowUsage("PLANNER STATISTICS");
749

750 751 752
#ifdef COPY_PARSE_PLAN_TREES
	/* Optional debugging check: pass plan output through copyObject() */
	{
B
Bruce Momjian 已提交
753
		Plan	   *new_plan = (Plan *) copyObject(plan);
754

B
Bruce Momjian 已提交
755
		/*
B
Bruce Momjian 已提交
756 757
		 * equal() currently does not have routines to compare Plan nodes, so
		 * don't try to test equality here.  Perhaps fix someday?
758 759 760
		 */
#ifdef NOT_USED
		/* This checks both copyObject() and the equal() routines... */
B
Bruce Momjian 已提交
761
		if (!equal(new_plan, plan))
762
			elog(WARNING, "copyObject() failed to produce an equal plan tree");
763 764 765 766 767 768
		else
#endif
			plan = new_plan;
	}
#endif

769 770
	/*
	 * Print plan if debugging.
771
	 */
772
	if (Debug_print_plan)
773
		elog_node_display(DEBUG1, "plan", plan, Debug_pretty_print);
774

775
	return plan;
776 777
}

778 779
/*
 * Generate plans for a list of already-rewritten queries.
780
 *
781 782 783 784 785 786 787 788 789
 * If needSnapshot is TRUE, we haven't yet set a snapshot for the current
 * query.  A snapshot must be set before invoking the planner, since it
 * might try to evaluate user-defined functions.  But we must not set a
 * snapshot if the list contains only utility statements, because some
 * utility statements depend on not having frozen the snapshot yet.
 * (We assume that such statements cannot appear together with plannable
 * statements in the rewriter's output.)
 */
List *
790 791
pg_plan_queries(List *querytrees, ParamListInfo boundParams,
				bool needSnapshot)
792 793
{
	List	   *plan_list = NIL;
794
	ListCell   *query_list;
795 796 797 798 799 800 801 802 803 804 805 806 807 808 809

	foreach(query_list, querytrees)
	{
		Query	   *query = (Query *) lfirst(query_list);
		Plan	   *plan;

		if (query->commandType == CMD_UTILITY)
		{
			/* Utility commands have no plans. */
			plan = NULL;
		}
		else
		{
			if (needSnapshot)
			{
810
				ActiveSnapshot = CopySnapshot(GetTransactionSnapshot());
811 812
				needSnapshot = false;
			}
813
			plan = pg_plan_query(query, boundParams);
814 815 816 817 818 819 820 821 822 823
		}

		plan_list = lappend(plan_list, plan);
	}

	return plan_list;
}


/*
824
 * exec_simple_query
825
 *
826
 * Execute a "simple Query" protocol message.
827
 */
828
static void
829
exec_simple_query(const char *query_string)
830
{
B
Bruce Momjian 已提交
831
	CommandDest dest = whereToSendOutput;
832
	MemoryContext oldcontext;
833 834
	List	   *parsetree_list;
	ListCell   *parsetree_item;
B
Bruce Momjian 已提交
835 836
	struct timeval start_t,
				stop_t;
B
Rename:  
Bruce Momjian 已提交
837
	bool		save_log_duration = log_duration;
B
Bruce Momjian 已提交
838
	int			save_log_min_duration_statement = log_min_duration_statement;
839
	bool		save_log_statement_stats = log_statement_stats;
B
Bruce Momjian 已提交
840
	char	   *prepare_string = NULL;
841
	bool		was_logged = false;
B
Bruce Momjian 已提交
842

843 844 845
	/*
	 * Report query to various monitoring facilities.
	 */
846
	debug_query_string = query_string;
847

848 849
	pgstat_report_activity(query_string);

850
	/*
B
Bruce Momjian 已提交
851
	 * We use save_log_* so "SET log_duration = true"  and "SET
B
Bruce Momjian 已提交
852 853 854
	 * log_min_duration_statement = true" don't report incorrect time because
	 * gettimeofday() wasn't called. Similarly, log_statement_stats has to be
	 * captured once.
855
	 */
856
	if (save_log_duration || save_log_min_duration_statement != -1)
857
		gettimeofday(&start_t, NULL);
858

859 860 861
	if (save_log_statement_stats)
		ResetUsage();

862
	/*
B
Bruce Momjian 已提交
863 864
	 * Start up a transaction command.	All queries generated by the
	 * query_string will be in this same command block, *unless* we find a
B
Bruce Momjian 已提交
865 866 867
	 * BEGIN/COMMIT/ABORT statement; we have to force a new xact command after
	 * one of those, else bad things will happen in xact.c. (Note that this
	 * will normally change current memory context.)
868
	 */
869
	initialize_command();
870 871

	/*
B
Bruce Momjian 已提交
872 873 874 875
	 * Zap any pre-existing unnamed statement.	(While not strictly necessary,
	 * it seems best to define simple-Query mode as if it used the unnamed
	 * statement and portal; this ensures we recover any storage used by prior
	 * unnamed operations.)
876 877 878 879 880 881 882 883
	 */
	unnamed_stmt_pstmt = NULL;
	if (unnamed_stmt_context)
	{
		DropDependentPortals(unnamed_stmt_context);
		MemoryContextDelete(unnamed_stmt_context);
	}
	unnamed_stmt_context = NULL;
884

885 886 887
	/*
	 * Switch to appropriate context for constructing parsetrees.
	 */
888
	oldcontext = MemoryContextSwitchTo(MessageContext);
889

890 891
	QueryContext = CurrentMemoryContext;

B
Bruce Momjian 已提交
892
	/*
B
Bruce Momjian 已提交
893 894
	 * Do basic parsing of the query or queries (this should be safe even if
	 * we are in aborted transaction state!)
895
	 */
896
	parsetree_list = pg_parse_query(query_string);
897

898 899
	if (log_statement != LOGSTMT_NONE || save_log_min_duration_statement != -1)
		was_logged = log_after_parse(parsetree_list, query_string,
B
Bruce Momjian 已提交
900
									 &prepare_string);
901

902
	/*
903
	 * Switch back to transaction context to enter the loop.
904 905 906 907
	 */
	MemoryContextSwitchTo(oldcontext);

	/*
908
	 * Run through the raw parsetree(s) and process each one.
909
	 */
910
	foreach(parsetree_item, parsetree_list)
911
	{
B
Bruce Momjian 已提交
912
		Node	   *parsetree = (Node *) lfirst(parsetree_item);
913 914
		const char *commandTag;
		char		completionTag[COMPLETION_TAG_BUFSIZE];
B
Bruce Momjian 已提交
915
		List	   *querytree_list,
916 917
				   *plantree_list;
		Portal		portal;
918 919
		DestReceiver *receiver;
		int16		format;
920

921
		/*
B
Bruce Momjian 已提交
922 923 924 925
		 * Get the command name for use in status display (it also becomes the
		 * default completion tag, down inside PortalRun).	Set ps_status and
		 * do any special start-of-SQL-command processing needed by the
		 * destination.
926 927 928 929 930
		 */
		commandTag = CreateCommandTag(parsetree);

		set_ps_display(commandTag);

931
		BeginCommand(commandTag, dest);
932

933
		/*
934
		 * If we are in an aborted transaction, reject all commands except
B
Bruce Momjian 已提交
935 936 937 938 939
		 * COMMIT/ABORT.  It is important that this test occur before we try
		 * to do parse analysis, rewrite, or planning, since all those phases
		 * try to do database accesses, which may fail in abort state. (It
		 * might be safe to allow some additional utility commands in this
		 * state, but not many...)
940
		 */
941 942 943 944 945
		if (IsAbortedTransactionBlockState() &&
			!IsTransactionExitStmt(parsetree))
			ereport(ERROR,
					(errcode(ERRCODE_IN_FAILED_SQL_TRANSACTION),
					 errmsg("current transaction is aborted, "
B
Bruce Momjian 已提交
946
						"commands ignored until end of transaction block")));
947

948
		/* Make sure we are in a transaction command */
949
		start_xact_command();
950

951
		/* If we got a cancel signal in parsing or prior command, quit */
952
		CHECK_FOR_INTERRUPTS();
953 954

		/*
955
		 * OK to analyze, rewrite, and plan this query.
956
		 *
B
Bruce Momjian 已提交
957 958
		 * Switch to appropriate context for constructing querytrees (again,
		 * these must outlive the execution context).
959
		 */
960
		oldcontext = MemoryContextSwitchTo(MessageContext);
961

962 963
		querytree_list = pg_analyze_and_rewrite(parsetree, query_string,
												NULL, 0);
V
Vadim B. Mikheev 已提交
964

965
		plantree_list = pg_plan_queries(querytree_list, NULL, true);
966 967 968 969

		/* If we got a cancel signal in analysis or planning, quit */
		CHECK_FOR_INTERRUPTS();

970
		/*
B
Bruce Momjian 已提交
971 972
		 * Create unnamed portal to run the query or queries in. If there
		 * already is one, silently drop it.
973
		 */
974
		portal = CreatePortal("", true, true);
975 976
		/* Don't display the portal in pg_cursors */
		portal->visible = false;
977

978 979 980 981 982 983
		PortalDefineQuery(portal,
						  query_string,
						  commandTag,
						  querytree_list,
						  plantree_list,
						  MessageContext);
984

985
		/*
986
		 * Start the portal.  No parameters here.
987
		 */
988
		PortalStart(portal, NULL, InvalidSnapshot);
989

990
		/*
B
Bruce Momjian 已提交
991 992 993 994
		 * Select the appropriate output format: text unless we are doing a
		 * FETCH from a binary cursor.	(Pretty grotty to have to do this here
		 * --- but it avoids grottiness in other places.  Ah, the joys of
		 * backward compatibility...)
995 996 997 998 999 1000 1001 1002 1003 1004 1005 1006
		 */
		format = 0;				/* TEXT is default */
		if (IsA(parsetree, FetchStmt))
		{
			FetchStmt  *stmt = (FetchStmt *) parsetree;

			if (!stmt->ismove)
			{
				Portal		fportal = GetPortalByName(stmt->portalname);

				if (PortalIsValid(fportal) &&
					(fportal->cursorOptions & CURSOR_OPT_BINARY))
B
Bruce Momjian 已提交
1007
					format = 1; /* BINARY */
1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019 1020 1021 1022
			}
		}
		PortalSetResultFormat(portal, 1, &format);

		/*
		 * Now we can create the destination receiver object.
		 */
		receiver = CreateDestReceiver(dest, portal);

		/*
		 * Switch back to transaction context for execution.
		 */
		MemoryContextSwitchTo(oldcontext);

		/*
B
Bruce Momjian 已提交
1023
		 * Run the portal to completion, and then drop it (and the receiver).
1024
		 */
1025 1026
		(void) PortalRun(portal,
						 FETCH_ALL,
1027 1028
						 receiver,
						 receiver,
1029
						 completionTag);
1030

1031
		(*receiver->rDestroy) (receiver);
1032

1033
		PortalDrop(portal, false);
1034

1035
		if (IsA(parsetree, TransactionStmt))
1036
		{
1037
			/*
B
Bruce Momjian 已提交
1038 1039
			 * If this was a transaction control statement, commit it. We will
			 * start a new xact command for the next command (if any).
1040
			 */
1041
			finish_xact_command();
1042
		}
1043
		else if (lnext(parsetree_item) == NULL)
1044
		{
1045
			/*
B
Bruce Momjian 已提交
1046 1047 1048 1049 1050 1051 1052 1053
			 * If this is the last parsetree of the query string, close down
			 * transaction statement before reporting command-complete.  This
			 * is so that any end-of-transaction errors are reported before
			 * the command-complete message is issued, to avoid confusing
			 * clients who will expect either a command-complete message or an
			 * error, not one and then the other.  But for compatibility with
			 * historical Postgres behavior, we do not force a transaction
			 * boundary between queries appearing in a single query string.
1054
			 */
1055
			finish_xact_command();
1056
		}
1057
		else
1058
		{
1059
			/*
B
Bruce Momjian 已提交
1060 1061
			 * We need a CommandCounterIncrement after every query, except
			 * those that start or end a transaction block.
1062 1063
			 */
			CommandCounterIncrement();
1064
		}
1065 1066

		/*
B
Bruce Momjian 已提交
1067 1068 1069 1070
		 * Tell client that we're done with this query.  Note we emit exactly
		 * one EndCommand report for each raw parsetree, thus one for each SQL
		 * command the client sent, regardless of rewriting. (But a command
		 * aborted by error will not send an EndCommand report at all.)
1071
		 */
1072
		EndCommand(completionTag, dest);
B
Bruce Momjian 已提交
1073
	}							/* end loop over parsetrees */
1074

1075 1076 1077
	/*
	 * Close down transaction statement, if one is open.
	 */
1078
	finalize_command();
1079

1080 1081 1082
	/*
	 * If there were no parsetrees, return EmptyQueryResponse message.
	 */
1083
	if (!parsetree_list)
1084 1085
		NullCommand(dest);

1086
	QueryContext = NULL;
1087

1088
	/*
B
Bruce Momjian 已提交
1089 1090
	 * Combine processing here as we need to calculate the query duration in
	 * both instances.
1091
	 */
1092
	if (save_log_duration || save_log_min_duration_statement != -1)
1093
	{
B
Bruce Momjian 已提交
1094 1095
		long		usecs;

1096
		gettimeofday(&stop_t, NULL);
1097 1098 1099 1100 1101
		if (stop_t.tv_usec < start_t.tv_usec)
		{
			stop_t.tv_sec--;
			stop_t.tv_usec += 1000000;
		}
1102
		usecs = (long) (stop_t.tv_sec - start_t.tv_sec) * 1000000 +
B
Bruce Momjian 已提交
1103
			(long) (stop_t.tv_usec - start_t.tv_usec);
B
Bruce Momjian 已提交
1104

1105
		/* Only print duration if we previously printed the statement. */
1106
		if (was_logged && save_log_duration)
B
Bruce Momjian 已提交
1107 1108
			ereport(LOG,
					(errmsg("duration: %ld.%03ld ms",
B
Bruce Momjian 已提交
1109 1110 1111
							(long) ((stop_t.tv_sec - start_t.tv_sec) * 1000 +
								  (stop_t.tv_usec - start_t.tv_usec) / 1000),
						 (long) (stop_t.tv_usec - start_t.tv_usec) % 1000)));
B
Bruce Momjian 已提交
1112

B
Bruce Momjian 已提交
1113
		/*
B
Bruce Momjian 已提交
1114 1115
		 * Output a duration_statement to the log if the query has exceeded
		 * the min duration, or if we are to print all durations.
B
Bruce Momjian 已提交
1116
		 */
B
Bruce Momjian 已提交
1117 1118 1119
		if (save_log_min_duration_statement == 0 ||
			(save_log_min_duration_statement > 0 &&
			 usecs >= save_log_min_duration_statement * 1000))
1120
			ereport(LOG,
1121
					(errmsg("duration: %ld.%03ld ms  statement: %s%s",
B
Bruce Momjian 已提交
1122 1123 1124
							(long) ((stop_t.tv_sec - start_t.tv_sec) * 1000 +
								  (stop_t.tv_usec - start_t.tv_usec) / 1000),
							(long) (stop_t.tv_usec - start_t.tv_usec) % 1000,
1125 1126
							query_string,
							prepare_string ? prepare_string : "")));
1127
	}
1128

1129 1130 1131
	if (save_log_statement_stats)
		ShowUsage("QUERY STATISTICS");

1132 1133 1134
	if (prepare_string != NULL)
		pfree(prepare_string);

1135
	debug_query_string = NULL;
1136 1137
}

1138 1139 1140 1141 1142 1143 1144 1145
/*
 * exec_parse_message
 *
 * Execute a "Parse" protocol message.
 */
static void
exec_parse_message(const char *query_string,	/* string to execute */
				   const char *stmt_name,		/* name for prepared stmt */
B
Bruce Momjian 已提交
1146 1147
				   Oid *paramTypes,		/* parameter types */
				   int numParams)		/* number of parameters */
1148 1149 1150 1151 1152 1153 1154 1155 1156 1157 1158 1159 1160 1161 1162 1163 1164 1165 1166 1167 1168 1169
{
	MemoryContext oldcontext;
	List	   *parsetree_list;
	const char *commandTag;
	List	   *querytree_list,
			   *plantree_list,
			   *param_list;
	bool		is_named;
	bool		save_log_statement_stats = log_statement_stats;

	/*
	 * Report query to various monitoring facilities.
	 */
	debug_query_string = query_string;

	pgstat_report_activity(query_string);

	set_ps_display("PARSE");

	if (save_log_statement_stats)
		ResetUsage();

1170 1171
	if (log_statement == LOGSTMT_ALL)
		ereport(LOG,
1172
				(errmsg("statement: [protocol] PREPARE %s AS %s",
1173 1174
						(*stmt_name != '\0') ? stmt_name : "<unnamed>",
						query_string)));
1175

1176
	/*
B
Bruce Momjian 已提交
1177 1178 1179
	 * Start up a transaction command so we can run parse analysis etc. (Note
	 * that this will normally change current memory context.) Nothing happens
	 * if we are already in one.
1180
	 */
1181
	initialize_command();
1182 1183 1184 1185

	/*
	 * Switch to appropriate context for constructing parsetrees.
	 *
B
Bruce Momjian 已提交
1186 1187 1188
	 * We have two strategies depending on whether the prepared statement is
	 * named or not.  For a named prepared statement, we do parsing in
	 * MessageContext and copy the finished trees into the prepared
B
Bruce Momjian 已提交
1189 1190 1191 1192 1193 1194
	 * statement's private context; then the reset of MessageContext releases
	 * temporary space used by parsing and planning.  For an unnamed prepared
	 * statement, we assume the statement isn't going to hang around long, so
	 * getting rid of temp space quickly is probably not worth the costs of
	 * copying parse/plan trees.  So in this case, we set up a special context
	 * for the unnamed statement, and do all the parsing/planning therein.
1195 1196 1197 1198 1199 1200 1201 1202 1203 1204 1205 1206 1207 1208 1209 1210 1211 1212 1213 1214 1215 1216 1217 1218 1219 1220 1221 1222 1223 1224
	 */
	is_named = (stmt_name[0] != '\0');
	if (is_named)
	{
		/* Named prepared statement --- parse in MessageContext */
		oldcontext = MemoryContextSwitchTo(MessageContext);
	}
	else
	{
		/* Unnamed prepared statement --- release any prior unnamed stmt */
		unnamed_stmt_pstmt = NULL;
		if (unnamed_stmt_context)
		{
			DropDependentPortals(unnamed_stmt_context);
			MemoryContextDelete(unnamed_stmt_context);
		}
		unnamed_stmt_context = NULL;
		/* create context for parsing/planning */
		unnamed_stmt_context =
			AllocSetContextCreate(TopMemoryContext,
								  "unnamed prepared statement",
								  ALLOCSET_DEFAULT_MINSIZE,
								  ALLOCSET_DEFAULT_INITSIZE,
								  ALLOCSET_DEFAULT_MAXSIZE);
		oldcontext = MemoryContextSwitchTo(unnamed_stmt_context);
	}

	QueryContext = CurrentMemoryContext;

	/*
B
Bruce Momjian 已提交
1225 1226
	 * Do basic parsing of the query or queries (this should be safe even if
	 * we are in aborted transaction state!)
1227 1228 1229 1230
	 */
	parsetree_list = pg_parse_query(query_string);

	/*
B
Bruce Momjian 已提交
1231 1232 1233
	 * We only allow a single user statement in a prepared statement. This is
	 * mainly to keep the protocol simple --- otherwise we'd need to worry
	 * about multiple result tupdescs and things like that.
1234
	 */
1235
	if (list_length(parsetree_list) > 1)
1236 1237
		ereport(ERROR,
				(errcode(ERRCODE_SYNTAX_ERROR),
B
Bruce Momjian 已提交
1238
		errmsg("cannot insert multiple commands into a prepared statement")));
1239 1240 1241

	if (parsetree_list != NIL)
	{
1242
		Node	   *parsetree = (Node *) linitial(parsetree_list);
B
Bruce Momjian 已提交
1243
		int			i;
1244 1245 1246 1247 1248 1249 1250 1251

		/*
		 * Get the command name for possible use in status display.
		 */
		commandTag = CreateCommandTag(parsetree);

		/*
		 * If we are in an aborted transaction, reject all commands except
B
Bruce Momjian 已提交
1252 1253 1254 1255 1256
		 * COMMIT/ROLLBACK.  It is important that this test occur before we
		 * try to do parse analysis, rewrite, or planning, since all those
		 * phases try to do database accesses, which may fail in abort state.
		 * (It might be safe to allow some additional utility commands in this
		 * state, but not many...)
1257
		 */
1258 1259 1260 1261 1262
		if (IsAbortedTransactionBlockState() &&
			!IsTransactionExitStmt(parsetree))
			ereport(ERROR,
					(errcode(ERRCODE_IN_FAILED_SQL_TRANSACTION),
					 errmsg("current transaction is aborted, "
B
Bruce Momjian 已提交
1263
						"commands ignored until end of transaction block")));
1264 1265 1266

		/*
		 * OK to analyze, rewrite, and plan this query.  Note that the
B
Bruce Momjian 已提交
1267 1268
		 * originally specified parameter set is not required to be complete,
		 * so we have to use parse_analyze_varparams().
1269 1270 1271 1272 1273
		 */
		if (log_parser_stats)
			ResetUsage();

		querytree_list = parse_analyze_varparams(parsetree,
1274
												 query_string,
1275 1276 1277 1278 1279 1280 1281 1282 1283 1284
												 &paramTypes,
												 &numParams);

		/*
		 * Check all parameter types got determined, and convert array
		 * representation to a list for storage.
		 */
		param_list = NIL;
		for (i = 0; i < numParams; i++)
		{
B
Bruce Momjian 已提交
1285
			Oid			ptype = paramTypes[i];
1286 1287

			if (ptype == InvalidOid || ptype == UNKNOWNOID)
1288 1289
				ereport(ERROR,
						(errcode(ERRCODE_INDETERMINATE_DATATYPE),
B
Bruce Momjian 已提交
1290 1291
					 errmsg("could not determine data type of parameter $%d",
							i + 1)));
1292
			param_list = lappend_oid(param_list, ptype);
1293 1294 1295 1296 1297 1298 1299
		}

		if (log_parser_stats)
			ShowUsage("PARSE ANALYSIS STATISTICS");

		querytree_list = pg_rewrite_queries(querytree_list);

1300
		/*
B
Bruce Momjian 已提交
1301 1302
		 * If this is the unnamed statement and it has parameters, defer query
		 * planning until Bind.  Otherwise do it now.
1303 1304 1305 1306 1307
		 */
		if (!is_named && numParams > 0)
			plantree_list = NIL;
		else
			plantree_list = pg_plan_queries(querytree_list, NULL, true);
1308 1309 1310
	}
	else
	{
B
Bruce Momjian 已提交
1311
		/* Empty input string.	This is legal. */
1312 1313 1314 1315 1316 1317 1318 1319 1320 1321 1322 1323 1324 1325 1326 1327 1328 1329 1330
		commandTag = NULL;
		querytree_list = NIL;
		plantree_list = NIL;
		param_list = NIL;
	}

	/* If we got a cancel signal in analysis or planning, quit */
	CHECK_FOR_INTERRUPTS();

	/*
	 * Store the query as a prepared statement.  See above comments.
	 */
	if (is_named)
	{
		StorePreparedStatement(stmt_name,
							   query_string,
							   commandTag,
							   querytree_list,
							   plantree_list,
1331 1332
							   param_list,
							   false);
1333 1334 1335 1336 1337 1338 1339 1340 1341 1342 1343 1344 1345
	}
	else
	{
		PreparedStatement *pstmt;

		pstmt = (PreparedStatement *) palloc0(sizeof(PreparedStatement));
		/* query_string needs to be copied into unnamed_stmt_context */
		pstmt->query_string = pstrdup(query_string);
		/* the rest is there already */
		pstmt->commandTag = commandTag;
		pstmt->query_list = querytree_list;
		pstmt->plan_list = plantree_list;
		pstmt->argtype_list = param_list;
1346
		pstmt->from_sql = false;
1347 1348 1349 1350 1351 1352 1353 1354 1355 1356
		pstmt->context = unnamed_stmt_context;
		/* Now the unnamed statement is complete and valid */
		unnamed_stmt_pstmt = pstmt;
	}

	MemoryContextSwitchTo(oldcontext);

	QueryContext = NULL;

	/*
B
Bruce Momjian 已提交
1357 1358 1359
	 * We do NOT close the open transaction command here; that only happens
	 * when the client sends Sync.	Instead, do CommandCounterIncrement just
	 * in case something happened during parse/plan.
1360 1361 1362 1363 1364 1365
	 */
	CommandCounterIncrement();

	/*
	 * Send ParseComplete.
	 */
1366
	if (whereToSendOutput == DestRemote)
1367 1368 1369 1370 1371 1372 1373 1374 1375 1376 1377 1378 1379 1380 1381 1382 1383 1384
		pq_putemptymessage('1');

	if (save_log_statement_stats)
		ShowUsage("PARSE MESSAGE STATISTICS");

	debug_query_string = NULL;
}

/*
 * exec_bind_message
 *
 * Process a "Bind" message to create a portal from a prepared statement
 */
static void
exec_bind_message(StringInfo input_message)
{
	const char *portal_name;
	const char *stmt_name;
1385 1386
	int			numPFormats;
	int16	   *pformats = NULL;
1387
	int			numParams;
1388 1389 1390
	int			numRFormats;
	int16	   *rformats = NULL;
	int			i;
1391 1392 1393 1394 1395 1396 1397 1398 1399
	PreparedStatement *pstmt;
	Portal		portal;
	ParamListInfo params;

	pgstat_report_activity("<BIND>");

	set_ps_display("BIND");

	/*
B
Bruce Momjian 已提交
1400 1401 1402
	 * Start up a transaction command so we can call functions etc. (Note that
	 * this will normally change current memory context.) Nothing happens if
	 * we are already in one.
1403
	 */
1404
	initialize_command();
1405

1406 1407 1408
	/* Switch back to message context */
	MemoryContextSwitchTo(MessageContext);

1409 1410 1411 1412
	/* Get the fixed part of the message */
	portal_name = pq_getmsgstring(input_message);
	stmt_name = pq_getmsgstring(input_message);

1413 1414 1415 1416 1417 1418 1419 1420 1421 1422 1423 1424 1425
	/* Get the parameter format codes */
	numPFormats = pq_getmsgint(input_message, 2);
	if (numPFormats > 0)
	{
		pformats = (int16 *) palloc(numPFormats * sizeof(int16));
		for (i = 0; i < numPFormats; i++)
			pformats[i] = pq_getmsgint(input_message, 2);
	}

	/* Get the parameter value count */
	numParams = pq_getmsgint(input_message, 2);

	if (numPFormats > 1 && numPFormats != numParams)
1426 1427
		ereport(ERROR,
				(errcode(ERRCODE_PROTOCOL_VIOLATION),
B
Bruce Momjian 已提交
1428 1429
			errmsg("bind message has %d parameter formats but %d parameters",
				   numPFormats, numParams)));
1430 1431 1432 1433 1434 1435 1436 1437 1438

	/* Find prepared statement */
	if (stmt_name[0] != '\0')
		pstmt = FetchPreparedStatement(stmt_name, true);
	else
	{
		/* special-case the unnamed statement */
		pstmt = unnamed_stmt_pstmt;
		if (!pstmt)
1439 1440
			ereport(ERROR,
					(errcode(ERRCODE_UNDEFINED_PSTATEMENT),
B
Bruce Momjian 已提交
1441
					 errmsg("unnamed prepared statement does not exist")));
1442 1443
	}

1444
	if (numParams != list_length(pstmt->argtype_list))
1445 1446 1447
		ereport(ERROR,
				(errcode(ERRCODE_PROTOCOL_VIOLATION),
				 errmsg("bind message supplies %d parameters, but prepared statement \"%s\" requires %d",
B
Bruce Momjian 已提交
1448
				   numParams, stmt_name, list_length(pstmt->argtype_list))));
1449

1450 1451
	/*
	 * If we are in aborted transaction state, the only portals we can
1452 1453 1454 1455 1456
	 * actually run are those containing COMMIT or ROLLBACK commands. We
	 * disallow binding anything else to avoid problems with infrastructure
	 * that expects to run inside a valid transaction.	We also disallow
	 * binding any parameters, since we can't risk calling user-defined I/O
	 * functions.
1457 1458 1459 1460 1461 1462 1463 1464 1465
	 */
	if (IsAbortedTransactionBlockState() &&
		(!IsTransactionExitStmtList(pstmt->query_list) ||
		 numParams != 0))
		ereport(ERROR,
				(errcode(ERRCODE_IN_FAILED_SQL_TRANSACTION),
				 errmsg("current transaction is aborted, "
						"commands ignored until end of transaction block")));

1466
	/*
B
Bruce Momjian 已提交
1467 1468
	 * Create the portal.  Allow silent replacement of an existing portal only
	 * if the unnamed portal is specified.
1469 1470 1471 1472 1473 1474
	 */
	if (portal_name[0] == '\0')
		portal = CreatePortal(portal_name, true, true);
	else
		portal = CreatePortal(portal_name, false, false);

1475
	/* We need to output the parameter values someday */
1476 1477
	if (log_statement == LOGSTMT_ALL)
		ereport(LOG,
1478
				(errmsg("statement: [protocol] <BIND> %s", portal_name)));
1479

1480 1481 1482 1483 1484
	/*
	 * Fetch parameters, if any, and store in the portal's memory context.
	 */
	if (numParams > 0)
	{
1485
		ListCell   *l;
1486 1487 1488 1489
		MemoryContext oldContext;

		oldContext = MemoryContextSwitchTo(PortalGetHeapMemory(portal));

1490 1491 1492 1493
		/* sizeof(ParamListInfoData) includes the first array element */
		params = (ParamListInfo) palloc(sizeof(ParamListInfoData) +
								(numParams - 1) * sizeof(ParamExternData));
		params->numParams = numParams;
1494

1495
		i = 0;
1496 1497
		foreach(l, pstmt->argtype_list)
		{
1498
			Oid			ptype = lfirst_oid(l);
1499
			int32		plength;
1500
			bool		isNull;
1501 1502 1503
			StringInfoData pbuf;
			char		csave;
			int16		pformat;
1504

1505 1506 1507
			plength = pq_getmsgint(input_message, 4);
			isNull = (plength == -1);

1508 1509
			if (!isNull)
			{
1510
				const char *pvalue = pq_getmsgbytes(input_message, plength);
1511 1512 1513

				/*
				 * Rather than copying data around, we just set up a phony
1514 1515 1516 1517 1518
				 * StringInfo pointing to the correct portion of the message
				 * buffer.	We assume we can scribble on the message buffer so
				 * as to maintain the convention that StringInfos have a
				 * trailing null.  This is grotty but is a big win when
				 * dealing with very large parameter strings.
1519 1520 1521 1522 1523 1524 1525 1526
				 */
				pbuf.data = (char *) pvalue;
				pbuf.maxlen = plength + 1;
				pbuf.len = plength;
				pbuf.cursor = 0;

				csave = pbuf.data[plength];
				pbuf.data[plength] = '\0';
1527 1528 1529 1530 1531 1532
			}
			else
			{
				pbuf.data = NULL;		/* keep compiler quiet */
				csave = 0;
			}
1533

1534 1535 1536 1537 1538 1539 1540 1541 1542 1543 1544 1545
			if (numPFormats > 1)
				pformat = pformats[i];
			else if (numPFormats > 0)
				pformat = pformats[0];
			else
				pformat = 0;	/* default = text */

			if (pformat == 0)
			{
				Oid			typinput;
				Oid			typioparam;
				char	   *pstring;
1546

1547
				getTypeInputInfo(ptype, &typinput, &typioparam);
1548

1549 1550 1551 1552 1553 1554 1555
				/*
				 * We have to do encoding conversion before calling the
				 * typinput routine.
				 */
				if (isNull)
					pstring = NULL;
				else
1556
					pstring = pg_client_to_server(pbuf.data, plength);
1557

1558 1559 1560 1561
				params->params[i].value = OidInputFunctionCall(typinput,
															   pstring,
															   typioparam,
															   -1);
1562 1563 1564 1565 1566 1567 1568 1569 1570 1571 1572 1573 1574 1575 1576 1577 1578
				/* Free result of encoding conversion, if any */
				if (pstring && pstring != pbuf.data)
					pfree(pstring);
			}
			else if (pformat == 1)
			{
				Oid			typreceive;
				Oid			typioparam;
				StringInfo	bufptr;

				/*
				 * Call the parameter type's binary input converter
				 */
				getTypeBinaryInputInfo(ptype, &typreceive, &typioparam);

				if (isNull)
					bufptr = NULL;
1579
				else
1580 1581
					bufptr = &pbuf;

1582 1583 1584 1585
				params->params[i].value = OidReceiveFunctionCall(typreceive,
																 bufptr,
																 typioparam,
																 -1);
1586 1587 1588

				/* Trouble if it didn't eat the whole buffer */
				if (!isNull && pbuf.cursor != pbuf.len)
1589
					ereport(ERROR,
1590 1591 1592 1593 1594 1595 1596 1597 1598 1599 1600
							(errcode(ERRCODE_INVALID_BINARY_REPRESENTATION),
							 errmsg("incorrect binary data format in bind parameter %d",
									i + 1)));
			}
			else
			{
				ereport(ERROR,
						(errcode(ERRCODE_INVALID_PARAMETER_VALUE),
						 errmsg("unsupported format code: %d",
								pformat)));
			}
1601

1602 1603
			/* Restore message buffer contents */
			if (!isNull)
1604
				pbuf.data[plength] = csave;
1605

1606 1607
			params->params[i].isnull = isNull;
			params->params[i].ptype = ptype;
1608 1609 1610 1611 1612 1613 1614 1615 1616

			i++;
		}

		MemoryContextSwitchTo(oldContext);
	}
	else
		params = NULL;

1617 1618 1619 1620 1621 1622 1623 1624 1625
	/* Get the result format codes */
	numRFormats = pq_getmsgint(input_message, 2);
	if (numRFormats > 0)
	{
		rformats = (int16 *) palloc(numRFormats * sizeof(int16));
		for (i = 0; i < numRFormats; i++)
			rformats[i] = pq_getmsgint(input_message, 2);
	}

1626 1627 1628
	pq_getmsgend(input_message);

	/*
B
Bruce Momjian 已提交
1629 1630
	 * If we didn't plan the query before, do it now.  This allows the planner
	 * to make use of the concrete parameter values we now have.
1631
	 *
B
Bruce Momjian 已提交
1632 1633
	 * This happens only for unnamed statements, and so switching into the
	 * statement context for planning is correct (see notes in
1634
	 * exec_parse_message).
1635
	 */
1636
	if (pstmt->plan_list == NIL && pstmt->query_list != NIL)
1637 1638 1639 1640 1641 1642 1643 1644 1645 1646 1647 1648 1649 1650 1651 1652 1653
	{
		MemoryContext oldContext = MemoryContextSwitchTo(pstmt->context);

		pstmt->plan_list = pg_plan_queries(pstmt->query_list, params, true);
		MemoryContextSwitchTo(oldContext);
	}

	/*
	 * Define portal and start execution.
	 */
	PortalDefineQuery(portal,
					  pstmt->query_string,
					  pstmt->commandTag,
					  pstmt->query_list,
					  pstmt->plan_list,
					  pstmt->context);

1654
	PortalStart(portal, params, InvalidSnapshot);
1655

1656 1657 1658 1659 1660
	/*
	 * Apply the result format requests to the portal.
	 */
	PortalSetResultFormat(portal, numRFormats, rformats);

1661 1662 1663
	/*
	 * Send BindComplete.
	 */
1664
	if (whereToSendOutput == DestRemote)
1665 1666 1667 1668 1669 1670 1671 1672 1673
		pq_putemptymessage('2');
}

/*
 * exec_execute_message
 *
 * Process an "Execute" message for a portal
 */
static void
1674
exec_execute_message(const char *portal_name, long max_rows)
1675
{
B
Bruce Momjian 已提交
1676
	CommandDest dest;
1677
	DestReceiver *receiver;
1678 1679 1680
	Portal		portal;
	bool		completed;
	char		completionTag[COMPLETION_TAG_BUFSIZE];
B
Bruce Momjian 已提交
1681 1682
	struct timeval start_t,
				stop_t;
1683 1684 1685
	bool		save_log_duration = log_duration;
	int			save_log_min_duration_statement = log_min_duration_statement;
	bool		save_log_statement_stats = log_statement_stats;
1686
	bool		execute_is_fetch = false;
1687 1688 1689

	/* Adjust destination to tell printtup.c what to do */
	dest = whereToSendOutput;
1690 1691
	if (dest == DestRemote)
		dest = DestRemoteExecute;
1692 1693 1694

	portal = GetPortalByName(portal_name);
	if (!PortalIsValid(portal))
1695 1696 1697
		ereport(ERROR,
				(errcode(ERRCODE_UNDEFINED_CURSOR),
				 errmsg("portal \"%s\" does not exist", portal_name)));
1698

1699
	/*
B
Bruce Momjian 已提交
1700 1701 1702 1703
	 * If we re-issue an Execute protocol request against an existing portal,
	 * then we are only fetching more rows rather than completely re-executing
	 * the query from the start. atStart is never reset for a v3 portal, so we
	 * are safe to use this check.
1704 1705 1706 1707
	 */
	if (!portal->atStart)
		execute_is_fetch = true;

1708
	/*
B
Bruce Momjian 已提交
1709 1710
	 * If the original query was a null string, just return
	 * EmptyQueryResponse.
1711 1712 1713 1714 1715 1716 1717 1718
	 */
	if (portal->commandTag == NULL)
	{
		Assert(portal->parseTrees == NIL);
		NullCommand(dest);
		return;
	}

1719 1720 1721 1722 1723 1724 1725
	/* Should we display the portal names here? */
	if (execute_is_fetch)
	{
		debug_query_string = "fetch message";
		pgstat_report_activity("<FETCH>");
	}
	else if (portal->sourceText)
1726 1727 1728 1729 1730 1731 1732 1733 1734 1735 1736 1737
	{
		debug_query_string = portal->sourceText;
		pgstat_report_activity(portal->sourceText);
	}
	else
	{
		debug_query_string = "execute message";
		pgstat_report_activity("<EXECUTE>");
	}

	set_ps_display(portal->commandTag);

1738 1739
	/*
	 * We use save_log_* so "SET log_duration = true"  and "SET
B
Bruce Momjian 已提交
1740 1741 1742
	 * log_min_duration_statement = true" don't report incorrect time because
	 * gettimeofday() wasn't called. Similarly, log_statement_stats has to be
	 * captured once.
1743 1744 1745 1746 1747 1748 1749 1750 1751 1752
	 */
	if (save_log_duration || save_log_min_duration_statement != -1)
		gettimeofday(&start_t, NULL);

	if (save_log_statement_stats)
		ResetUsage();

	if (log_statement == LOGSTMT_ALL)
		/* We have the portal, so output the source query. */
		ereport(LOG,
1753
				(errmsg("statement: [protocol] %sEXECUTE %s  [PREPARE:  %s]",
1754
						(execute_is_fetch) ? "FETCH from " : "",
1755
						(*portal_name != '\0') ? portal_name : "<unnamed>",
1756 1757
						portal->sourceText ? portal->sourceText : "")));

1758 1759
	BeginCommand(portal->commandTag, dest);

1760
	/*
B
Bruce Momjian 已提交
1761 1762
	 * Create dest receiver in MessageContext (we don't want it in transaction
	 * context, because that may get deleted if portal contains VACUUM).
1763 1764 1765
	 */
	receiver = CreateDestReceiver(dest, portal);

1766
	/*
B
Bruce Momjian 已提交
1767 1768
	 * Ensure we are in a transaction command (this should normally be the
	 * case already due to prior BIND).
1769
	 */
1770
	initialize_command();
1771 1772 1773 1774 1775

	/*
	 * If we are in aborted transaction state, the only portals we can
	 * actually run are those containing COMMIT or ROLLBACK commands.
	 */
1776 1777 1778 1779 1780
	if (IsAbortedTransactionBlockState() &&
		!IsTransactionExitStmtList(portal->parseTrees))
		ereport(ERROR,
				(errcode(ERRCODE_IN_FAILED_SQL_TRANSACTION),
				 errmsg("current transaction is aborted, "
B
Bruce Momjian 已提交
1781
						"commands ignored until end of transaction block")));
1782 1783 1784 1785 1786 1787 1788 1789 1790 1791 1792 1793

	/* Check for cancel signal before we start execution */
	CHECK_FOR_INTERRUPTS();

	/*
	 * Okay to run the portal.
	 */
	if (max_rows <= 0)
		max_rows = FETCH_ALL;

	completed = PortalRun(portal,
						  max_rows,
1794 1795
						  receiver,
						  receiver,
1796 1797
						  completionTag);

1798
	(*receiver->rDestroy) (receiver);
1799

1800 1801
	if (completed)
	{
1802
		if (IsTransactionStmtList(portal->parseTrees))
1803 1804
		{
			/*
B
Bruce Momjian 已提交
1805
			 * If this was a transaction control statement, commit it.	We
B
Bruce Momjian 已提交
1806
			 * will start a new xact command for the next command (if any).
1807
			 */
1808
			finish_xact_command();
1809 1810 1811 1812
		}
		else
		{
			/*
B
Bruce Momjian 已提交
1813 1814
			 * We need a CommandCounterIncrement after every query, except
			 * those that start or end a transaction block.
1815 1816 1817 1818 1819 1820 1821 1822 1823 1824
			 */
			CommandCounterIncrement();
		}

		/* Send appropriate CommandComplete to client */
		EndCommand(completionTag, dest);
	}
	else
	{
		/* Portal run not complete, so send PortalSuspended */
1825
		if (whereToSendOutput == DestRemote)
1826 1827 1828
			pq_putemptymessage('s');
	}

1829
	/*
B
Bruce Momjian 已提交
1830 1831
	 * Combine processing here as we need to calculate the query duration in
	 * both instances.
1832 1833 1834 1835 1836 1837 1838 1839 1840 1841 1842 1843
	 */
	if (save_log_duration || save_log_min_duration_statement != -1)
	{
		long		usecs;

		gettimeofday(&stop_t, NULL);
		if (stop_t.tv_usec < start_t.tv_usec)
		{
			stop_t.tv_sec--;
			stop_t.tv_usec += 1000000;
		}
		usecs = (long) (stop_t.tv_sec - start_t.tv_sec) * 1000000 +
B
Bruce Momjian 已提交
1844
			(long) (stop_t.tv_usec - start_t.tv_usec);
1845 1846 1847 1848 1849

		/* Only print duration if we previously printed the statement. */
		if (log_statement == LOGSTMT_ALL && save_log_duration)
			ereport(LOG,
					(errmsg("duration: %ld.%03ld ms",
B
Bruce Momjian 已提交
1850 1851 1852
							(long) ((stop_t.tv_sec - start_t.tv_sec) * 1000 +
								  (stop_t.tv_usec - start_t.tv_usec) / 1000),
						 (long) (stop_t.tv_usec - start_t.tv_usec) % 1000)));
1853 1854

		/*
B
Bruce Momjian 已提交
1855 1856
		 * Output a duration_statement to the log if the query has exceeded
		 * the min duration, or if we are to print all durations.
1857 1858 1859 1860 1861
		 */
		if (save_log_min_duration_statement == 0 ||
			(save_log_min_duration_statement > 0 &&
			 usecs >= save_log_min_duration_statement * 1000))
			ereport(LOG,
1862
					(errmsg("duration: %ld.%03ld ms  statement: [protocol] %sEXECUTE %s  [PREPARE:  %s]",
B
Bruce Momjian 已提交
1863 1864 1865
							(long) ((stop_t.tv_sec - start_t.tv_sec) * 1000 +
								  (stop_t.tv_usec - start_t.tv_usec) / 1000),
							(long) (stop_t.tv_usec - start_t.tv_usec) % 1000,
1866
							(execute_is_fetch) ? "FETCH from " : "",
B
Bruce Momjian 已提交
1867
						  (*portal_name != '\0') ? portal_name : "<unnamed>",
1868 1869 1870 1871 1872 1873
							portal->sourceText ? portal->sourceText : "")));
	}

	if (save_log_statement_stats)
		ShowUsage("QUERY STATISTICS");

1874 1875 1876 1877 1878 1879 1880 1881 1882 1883 1884 1885
	debug_query_string = NULL;
}

/*
 * exec_describe_statement_message
 *
 * Process a "Describe" message for a prepared statement
 */
static void
exec_describe_statement_message(const char *stmt_name)
{
	PreparedStatement *pstmt;
1886
	TupleDesc	tupdesc;
1887
	ListCell   *l;
1888 1889
	StringInfoData buf;

1890 1891 1892 1893
	/*
	 * Start up a transaction command. (Note that this will normally change
	 * current memory context.) Nothing happens if we are already in one.
	 */
1894
	initialize_command();
1895 1896 1897 1898

	/* Switch back to message context */
	MemoryContextSwitchTo(MessageContext);

1899 1900 1901 1902 1903 1904 1905 1906
	/* Find prepared statement */
	if (stmt_name[0] != '\0')
		pstmt = FetchPreparedStatement(stmt_name, true);
	else
	{
		/* special-case the unnamed statement */
		pstmt = unnamed_stmt_pstmt;
		if (!pstmt)
1907 1908
			ereport(ERROR,
					(errcode(ERRCODE_UNDEFINED_PSTATEMENT),
B
Bruce Momjian 已提交
1909
					 errmsg("unnamed prepared statement does not exist")));
1910 1911
	}

1912 1913 1914 1915 1916 1917 1918 1919 1920 1921 1922 1923 1924 1925 1926 1927
	/*
	 * If we are in aborted transaction state, we can't safely create a result
	 * tupledesc, because that needs catalog accesses.  Hence, refuse to
	 * Describe statements that return data.  (We shouldn't just refuse all
	 * Describes, since that might break the ability of some clients to issue
	 * COMMIT or ROLLBACK commands, if they use code that blindly Describes
	 * whatever it does.)  We can Describe parameters without doing anything
	 * dangerous, so we don't restrict that.
	 */
	if (IsAbortedTransactionBlockState() &&
		PreparedStatementReturnsTuples(pstmt))
		ereport(ERROR,
				(errcode(ERRCODE_IN_FAILED_SQL_TRANSACTION),
				 errmsg("current transaction is aborted, "
						"commands ignored until end of transaction block")));

1928
	if (whereToSendOutput != DestRemote)
1929 1930
		return;					/* can't actually do anything... */

1931 1932 1933
	/*
	 * First describe the parameters...
	 */
B
Bruce Momjian 已提交
1934
	pq_beginmessage(&buf, 't'); /* parameter description message type */
1935
	pq_sendint(&buf, list_length(pstmt->argtype_list), 2);
1936 1937 1938

	foreach(l, pstmt->argtype_list)
	{
1939
		Oid			ptype = lfirst_oid(l);
1940 1941 1942 1943

		pq_sendint(&buf, (int) ptype, 4);
	}
	pq_endmessage(&buf);
1944 1945 1946 1947 1948 1949

	/*
	 * Next send RowDescription or NoData to describe the result...
	 */
	tupdesc = FetchPreparedStatementResultDesc(pstmt);
	if (tupdesc)
1950 1951 1952
		SendRowDescriptionMessage(tupdesc,
								  FetchPreparedStatementTargetList(pstmt),
								  NULL);
1953 1954 1955
	else
		pq_putemptymessage('n');	/* NoData */

1956 1957 1958 1959 1960 1961 1962 1963 1964 1965 1966 1967
}

/*
 * exec_describe_portal_message
 *
 * Process a "Describe" message for a portal
 */
static void
exec_describe_portal_message(const char *portal_name)
{
	Portal		portal;

1968 1969 1970 1971
	/*
	 * Start up a transaction command. (Note that this will normally change
	 * current memory context.) Nothing happens if we are already in one.
	 */
1972
	initialize_command();
1973 1974 1975 1976

	/* Switch back to message context */
	MemoryContextSwitchTo(MessageContext);

1977 1978
	portal = GetPortalByName(portal_name);
	if (!PortalIsValid(portal))
1979 1980 1981
		ereport(ERROR,
				(errcode(ERRCODE_UNDEFINED_CURSOR),
				 errmsg("portal \"%s\" does not exist", portal_name)));
1982

1983 1984 1985 1986 1987 1988 1989 1990 1991 1992 1993 1994 1995 1996 1997
	/*
	 * If we are in aborted transaction state, we can't run
	 * SendRowDescriptionMessage(), because that needs catalog accesses.
	 * Hence, refuse to Describe portals that return data.  (We shouldn't just
	 * refuse all Describes, since that might break the ability of some
	 * clients to issue COMMIT or ROLLBACK commands, if they use code that
	 * blindly Describes whatever it does.)
	 */
	if (IsAbortedTransactionBlockState() &&
		portal->tupDesc)
		ereport(ERROR,
				(errcode(ERRCODE_IN_FAILED_SQL_TRANSACTION),
				 errmsg("current transaction is aborted, "
						"commands ignored until end of transaction block")));

1998
	if (whereToSendOutput != DestRemote)
1999 2000 2001
		return;					/* can't actually do anything... */

	if (portal->tupDesc)
2002 2003
		SendRowDescriptionMessage(portal->tupDesc,
								  FetchPortalTargetList(portal),
2004
								  portal->formats);
2005 2006 2007 2008 2009
	else
		pq_putemptymessage('n');	/* NoData */
}


2010
/*
2011 2012
 *	Start xact if necessary, and set statement_timestamp() and optionally
 *	statement_timeout.
2013 2014
 */
static void
2015
initialize_command(void)
2016
{
2017
	if (!command_initialized)
2018
	{
2019
		SetCurrentStatementStartTimestamp();
2020 2021 2022 2023

		/* Set statement timeout running, if any */
		if (StatementTimeout > 0)
			enable_sig_alarm(StatementTimeout, true);
2024 2025
		else
			cancel_from_timeout = false;
B
Bruce Momjian 已提交
2026

2027
		command_initialized = true;
2028
	}
2029
	start_xact_command();
2030 2031 2032
}

static void
2033
finalize_command(void)
2034
{
2035
	if (command_initialized)
2036 2037 2038
	{
		/* Cancel any active statement timeout before committing */
		disable_sig_alarm(true);
2039

2040 2041 2042 2043 2044 2045 2046 2047 2048 2049 2050 2051 2052 2053 2054 2055 2056 2057 2058 2059 2060 2061 2062 2063 2064 2065 2066 2067 2068
		command_initialized = false;
	}
	finish_xact_command();
}


/*
 *	Check if the newly-arrived query string needs to have an implicit
 *	transaction started.
 */
static void
start_xact_command(void)
{
	if (!xact_started)
	{
		ereport(DEBUG3,
				(errmsg_internal("StartTransactionCommand")));

		StartTransactionCommand();

		xact_started = true;
	}
}

static void
finish_xact_command(void)
{
	if (xact_started)
	{
2069 2070
		ereport(DEBUG3,
				(errmsg_internal("CommitTransactionCommand")));
2071

2072
		CommitTransactionCommand();
2073

2074 2075 2076 2077 2078 2079
#ifdef MEMORY_CONTEXT_CHECKING
		/* Check all memory contexts that weren't freed during commit */
		/* (those that were, were checked before being deleted) */
		MemoryContextCheck(TopMemoryContext);
#endif

2080
#ifdef SHOW_MEMORY_STATS
2081
		/* Print mem stats after each commit for leak tracking */
2082 2083
		if (ShowStats)
			MemoryContextStats(TopMemoryContext);
2084
#endif
2085 2086 2087

		xact_started = false;
	}
2088 2089 2090
}


2091 2092 2093 2094 2095 2096 2097 2098 2099 2100 2101 2102 2103 2104 2105 2106 2107 2108 2109 2110 2111 2112 2113 2114 2115 2116 2117 2118 2119 2120 2121 2122 2123 2124 2125 2126 2127 2128 2129 2130 2131 2132 2133 2134 2135 2136 2137 2138 2139 2140
/*
 * Convenience routines for checking whether a statement is one of the
 * ones that we allow in transaction-aborted state.
 */

static bool
IsTransactionExitStmt(Node *parsetree)
{
	if (parsetree && IsA(parsetree, TransactionStmt))
	{
		TransactionStmt *stmt = (TransactionStmt *) parsetree;

		if (stmt->kind == TRANS_STMT_COMMIT ||
			stmt->kind == TRANS_STMT_PREPARE ||
			stmt->kind == TRANS_STMT_ROLLBACK ||
			stmt->kind == TRANS_STMT_ROLLBACK_TO)
			return true;
	}
	return false;
}

static bool
IsTransactionExitStmtList(List *parseTrees)
{
	if (list_length(parseTrees) == 1)
	{
		Query	   *query = (Query *) linitial(parseTrees);

		if (query->commandType == CMD_UTILITY &&
			IsTransactionExitStmt(query->utilityStmt))
			return true;
	}
	return false;
}

static bool
IsTransactionStmtList(List *parseTrees)
{
	if (list_length(parseTrees) == 1)
	{
		Query	   *query = (Query *) linitial(parseTrees);

		if (query->commandType == CMD_UTILITY &&
			query->utilityStmt && IsA(query->utilityStmt, TransactionStmt))
			return true;
	}
	return false;
}


2141
/* --------------------------------
2142
 *		signal handler routines used in PostgresMain()
2143 2144 2145
 * --------------------------------
 */

2146
/*
T
Tom Lane 已提交
2147
 * quickdie() occurs when signalled SIGQUIT by the postmaster.
2148 2149 2150 2151
 *
 * Some backend has bought the farm,
 * so we need to stop what we're doing and exit.
 */
T
Tom Lane 已提交
2152
void
2153
quickdie(SIGNAL_ARGS)
2154
{
2155
	PG_SETMASK(&BlockSig);
B
Bruce Momjian 已提交
2156

2157
	/*
B
Bruce Momjian 已提交
2158 2159
	 * Ideally this should be ereport(FATAL), but then we'd not get control
	 * back...
2160 2161 2162
	 */
	ereport(WARNING,
			(errcode(ERRCODE_CRASH_SHUTDOWN),
B
Bruce Momjian 已提交
2163
			 errmsg("terminating connection because of crash of another server process"),
B
Bruce Momjian 已提交
2164 2165 2166 2167
	errdetail("The postmaster has commanded this server process to roll back"
			  " the current transaction and exit, because another"
			  " server process exited abnormally and possibly corrupted"
			  " shared memory."),
2168
			 errhint("In a moment you should be able to reconnect to the"
2169
					 " database and repeat your command.")));
B
Bruce Momjian 已提交
2170

2171
	/*
2172
	 * DO NOT proc_exit() -- we're here because shared memory may be
B
Bruce Momjian 已提交
2173 2174
	 * corrupted, so we don't want to try to clean up our transaction. Just
	 * nail the windows shut and get out of town.
2175
	 *
B
Bruce Momjian 已提交
2176 2177 2178 2179
	 * Note we do exit(1) not exit(0).	This is to force the postmaster into a
	 * system reset cycle if some idiot DBA sends a manual SIGQUIT to a random
	 * backend.  This is necessary precisely because we don't clean up our
	 * shared memory state.
2180
	 */
2181
	exit(1);
2182 2183
}

2184
/*
2185 2186
 * Shutdown signal from postmaster: abort transaction and exit
 * at soonest convenient time
2187
 */
2188
void
2189
die(SIGNAL_ARGS)
2190
{
2191 2192 2193
	int			save_errno = errno;

	/* Don't joggle the elbow of proc_exit */
B
Bruce Momjian 已提交
2194
	if (!proc_exit_inprogress)
2195
	{
2196
		InterruptPending = true;
2197
		ProcDiePending = true;
B
Bruce Momjian 已提交
2198

2199
		/*
B
Bruce Momjian 已提交
2200 2201
		 * If it's safe to interrupt, and we're waiting for input or a lock,
		 * service the interrupt immediately
2202
		 */
2203 2204
		if (ImmediateInterruptOK && InterruptHoldoffCount == 0 &&
			CritSectionCount == 0)
2205
		{
2206 2207 2208
			/* bump holdoff count to make ProcessInterrupts() a no-op */
			/* until we are done getting ready for it */
			InterruptHoldoffCount++;
2209
			DisableNotifyInterrupt();
2210
			DisableCatchupInterrupt();
2211
			/* Make sure CheckDeadLock won't run while shutting down... */
2212
			LockWaitCancel();
2213
			InterruptHoldoffCount--;
2214 2215
			ProcessInterrupts();
		}
2216
	}
2217 2218

	errno = save_errno;
2219 2220
}

2221
/*
2222
 * Timeout or shutdown signal from postmaster during client authentication.
2223
 * Simply exit(0).
2224 2225 2226
 *
 * XXX: possible future improvement: try to send a message indicating
 * why we are disconnecting.  Problem is to be sure we don't block while
2227
 * doing so, nor mess up the authentication message exchange.
2228 2229 2230 2231 2232 2233 2234
 */
void
authdie(SIGNAL_ARGS)
{
	exit(0);
}

2235
/*
2236 2237
 * Query-cancel signal from postmaster: abort current transaction
 * at soonest convenient time
2238
 */
2239
void
2240
StatementCancelHandler(SIGNAL_ARGS)
2241
{
2242 2243
	int			save_errno = errno;

B
Bruce Momjian 已提交
2244
	/*
2245
	 * Don't joggle the elbow of proc_exit
B
Bruce Momjian 已提交
2246
	 */
2247
	if (!proc_exit_inprogress)
2248
	{
2249 2250
		InterruptPending = true;
		QueryCancelPending = true;
B
Bruce Momjian 已提交
2251

2252
		/*
B
Bruce Momjian 已提交
2253 2254 2255
		 * If it's safe to interrupt, and we're waiting for a lock, service
		 * the interrupt immediately.  No point in interrupting if we're
		 * waiting for input, however.
2256
		 */
2257
		if (ImmediateInterruptOK && InterruptHoldoffCount == 0 &&
2258
			CritSectionCount == 0)
2259
		{
2260 2261 2262 2263 2264 2265
			/* bump holdoff count to make ProcessInterrupts() a no-op */
			/* until we are done getting ready for it */
			InterruptHoldoffCount++;
			if (LockWaitCancel())
			{
				DisableNotifyInterrupt();
2266
				DisableCatchupInterrupt();
T
Tom Lane 已提交
2267
				InterruptHoldoffCount--;
2268 2269 2270 2271
				ProcessInterrupts();
			}
			else
				InterruptHoldoffCount--;
2272
		}
2273 2274
	}

2275
	errno = save_errno;
2276 2277
}

2278
/* signal handler for floating point exception */
2279
void
2280 2281
FloatExceptionHandler(SIGNAL_ARGS)
{
2282 2283 2284
	ereport(ERROR,
			(errcode(ERRCODE_FLOATING_POINT_EXCEPTION),
			 errmsg("floating-point exception"),
B
Bruce Momjian 已提交
2285 2286 2287
			 errdetail("An invalid floating-point operation was signaled. "
					   "This probably means an out-of-range result or an "
					   "invalid operation, such as division by zero.")));
2288 2289
}

2290
/* SIGHUP: set flag to re-read config file at next convenient time */
2291
static void
2292
SigHupHandler(SIGNAL_ARGS)
2293
{
2294
	got_SIGHUP = true;
2295 2296
}

2297

2298 2299 2300 2301 2302 2303 2304 2305 2306 2307
/*
 * ProcessInterrupts: out-of-line portion of CHECK_FOR_INTERRUPTS() macro
 *
 * If an interrupt condition is pending, and it's safe to service it,
 * then clear the flag and accept the interrupt.  Called only when
 * InterruptPending is true.
 */
void
ProcessInterrupts(void)
{
2308 2309
	/* OK to accept interrupt now? */
	if (InterruptHoldoffCount != 0 || CritSectionCount != 0)
2310 2311 2312 2313 2314
		return;
	InterruptPending = false;
	if (ProcDiePending)
	{
		ProcDiePending = false;
B
Bruce Momjian 已提交
2315 2316
		QueryCancelPending = false;		/* ProcDie trumps QueryCancel */
		ImmediateInterruptOK = false;	/* not idle anymore */
2317
		DisableNotifyInterrupt();
2318
		DisableCatchupInterrupt();
2319 2320
		ereport(FATAL,
				(errcode(ERRCODE_ADMIN_SHUTDOWN),
B
Bruce Momjian 已提交
2321
			 errmsg("terminating connection due to administrator command")));
2322 2323 2324 2325
	}
	if (QueryCancelPending)
	{
		QueryCancelPending = false;
B
Bruce Momjian 已提交
2326
		ImmediateInterruptOK = false;	/* not idle anymore */
2327
		DisableNotifyInterrupt();
2328
		DisableCatchupInterrupt();
2329 2330 2331 2332 2333 2334 2335 2336
		if (cancel_from_timeout)
			ereport(ERROR,
					(errcode(ERRCODE_QUERY_CANCELED),
					 errmsg("canceling statement due to statement timeout")));
		else
			ereport(ERROR,
					(errcode(ERRCODE_QUERY_CANCELED),
					 errmsg("canceling statement due to user request")));
2337 2338 2339 2340
	}
	/* If we get here, do nothing (probably, QueryCancelPending was reset) */
}

2341

2342 2343 2344 2345 2346 2347 2348 2349 2350 2351 2352 2353 2354
/*
 * check_stack_depth: check for excessively deep recursion
 *
 * This should be called someplace in any recursive routine that might possibly
 * recurse deep enough to overflow the stack.  Most Unixen treat stack
 * overflow as an unrecoverable SIGSEGV, so we want to error out ourselves
 * before hitting the hardware limit.  Unfortunately we have no direct way
 * to detect the hardware limit, so we have to rely on the admin to set a
 * GUC variable for it ...
 */
void
check_stack_depth(void)
{
B
Bruce Momjian 已提交
2355 2356
	char		stack_top_loc;
	int			stack_depth;
2357 2358 2359 2360

	/*
	 * Compute distance from PostgresMain's local variables to my own
	 *
B
Bruce Momjian 已提交
2361 2362 2363
	 * Note: in theory stack_depth should be ptrdiff_t or some such, but since
	 * the whole point of this code is to bound the value to something much
	 * less than integer-sized, int should work fine.
2364 2365
	 */
	stack_depth = (int) (stack_base_ptr - &stack_top_loc);
B
Bruce Momjian 已提交
2366

2367
	/*
B
Bruce Momjian 已提交
2368
	 * Take abs value, since stacks grow up on some machines, down on others
2369 2370 2371
	 */
	if (stack_depth < 0)
		stack_depth = -stack_depth;
B
Bruce Momjian 已提交
2372

2373 2374 2375
	/*
	 * Trouble?
	 *
2376 2377 2378 2379
	 * The test on stack_base_ptr prevents us from erroring out if called
	 * during process setup or in a non-backend process.  Logically it should
	 * be done first, but putting it here avoids wasting cycles during normal
	 * cases.
2380 2381 2382 2383 2384 2385 2386 2387 2388 2389 2390 2391 2392 2393 2394 2395 2396 2397 2398 2399 2400 2401
	 */
	if (stack_depth > max_stack_depth_bytes &&
		stack_base_ptr != NULL)
	{
		ereport(ERROR,
				(errcode(ERRCODE_STATEMENT_TOO_COMPLEX),
				 errmsg("stack depth limit exceeded"),
				 errhint("Increase the configuration parameter \"max_stack_depth\".")));
	}
}

/* GUC assign hook to update max_stack_depth_bytes from max_stack_depth */
bool
assign_max_stack_depth(int newval, bool doit, GucSource source)
{
	/* Range check was already handled by guc.c */
	if (doit)
		max_stack_depth_bytes = newval * 1024;
	return true;
}


2402
static void
2403
usage(const char *progname)
2404
{
2405
	printf(_("%s is the PostgreSQL stand-alone backend.  It is not\nintended to be used by normal users.\n\n"), progname);
2406

2407
	printf(_("Usage:\n  %s [OPTION]... DBNAME\n\n"), progname);
2408
	printf(_("Options:\n"));
M
 
Marc G. Fournier 已提交
2409
#ifdef USE_ASSERT_CHECKING
2410
	printf(_("  -A 1|0          enable/disable run-time assert checking\n"));
M
 
Marc G. Fournier 已提交
2411
#endif
2412 2413
	printf(_("  -B NBUFFERS     number of shared buffers\n"));
	printf(_("  -c NAME=VALUE   set run-time parameter\n"));
2414
	printf(_("  -d 0-5          debugging level\n"));
2415 2416
	printf(_("  -D DATADIR      database directory\n"));
	printf(_("  -e              use European date input format (DMY)\n"));
2417
	printf(_("  -E              echo statement before execution\n"));
2418
	printf(_("  -F              turn fsync off\n"));
2419 2420
	printf(_("  -j              do not use newline as interactive query delimiter\n"));
	printf(_("  -r FILENAME     send stdout and stderr to given file\n"));
2421 2422
	printf(_("  -s              show statistics after each query\n"));
	printf(_("  -S WORK-MEM     set amount of memory for sorts (in kB)\n"));
2423
	printf(_("  --NAME=VALUE    set run-time parameter\n"));
2424 2425 2426 2427 2428 2429
	printf(_("  --describe-config  describe configuration parameters, then exit\n"));
	printf(_("  --help          show this help, then exit\n"));
	printf(_("  --version       output version information, then exit\n"));
	printf(_("\nDeveloper options:\n"));
	printf(_("  -f s|i|n|m|h    forbid use of some plan types\n"));
	printf(_("  -O              allow system table structure changes\n"));
2430
	printf(_("  -P              disable system indexes\n"));
2431 2432 2433
	printf(_("  -t pa|pl|ex     show timings after each query\n"));
	printf(_("  -W NUM          wait NUM seconds to allow attach from a debugger\n"));
	printf(_("\nReport bugs to <pgsql-bugs@postgresql.org>.\n"));
2434 2435
}

2436

2437 2438 2439 2440 2441 2442 2443 2444 2445 2446 2447 2448 2449 2450 2451 2452 2453 2454 2455 2456 2457 2458 2459 2460 2461 2462 2463 2464 2465 2466 2467 2468 2469 2470 2471
/*
 * set_debug_options --- apply "-d N" command line option
 *
 * -d is not quite the same as setting log_min_messages because it enables
 * other output options.
 */
void
set_debug_options(int debug_flag, GucContext context, GucSource source)
{
	if (debug_flag > 0)
	{
		char		debugstr[64];

		sprintf(debugstr, "debug%d", debug_flag);
		SetConfigOption("log_min_messages", debugstr, context, source);
	}
	else
		SetConfigOption("log_min_messages", "notice", context, source);

	if (debug_flag >= 1 && context == PGC_POSTMASTER)
	{
		SetConfigOption("log_connections", "true", context, source);
		SetConfigOption("log_disconnections", "true", context, source);
	}
	if (debug_flag >= 2)
		SetConfigOption("log_statement", "all", context, source);
	if (debug_flag >= 3)
		SetConfigOption("debug_print_parse", "true", context, source);
	if (debug_flag >= 4)
		SetConfigOption("debug_print_plan", "true", context, source);
	if (debug_flag >= 5)
		SetConfigOption("debug_print_rewritten", "true", context, source);
}


2472 2473 2474 2475 2476 2477 2478 2479 2480 2481 2482 2483 2484 2485 2486 2487 2488 2489 2490 2491 2492 2493 2494 2495 2496 2497 2498 2499 2500 2501 2502 2503 2504 2505 2506 2507 2508 2509 2510 2511 2512 2513 2514 2515 2516 2517 2518 2519 2520 2521 2522 2523 2524 2525 2526 2527 2528 2529 2530 2531
bool
set_plan_disabling_options(const char *arg, GucContext context, GucSource source)
{
	char *tmp = NULL;

	switch (arg[0])
	{
		case 's':	/* seqscan */
			tmp = "enable_seqscan";
			break;
		case 'i':	/* indexscan */
			tmp = "enable_indexscan";
			break;
		case 'b':	/* bitmapscan */
			tmp = "enable_bitmapscan";
			break;
		case 't':	/* tidscan */
			tmp = "enable_tidscan";
			break;
		case 'n':	/* nestloop */
			tmp = "enable_nestloop";
			break;
		case 'm':	/* mergejoin */
			tmp = "enable_mergejoin";
			break;
		case 'h':	/* hashjoin */
			tmp = "enable_hashjoin";
			break;
	}
	if (tmp)
	{
		SetConfigOption(tmp, "false", context, source);
		return true;
	}
	else
		return false;
}


const char *
get_stats_option_name(const char *arg)
{
	switch (arg[0])
	{
		case 'p':
			if (optarg[1] == 'a') /* "parser" */
				return "log_parser_stats";
			else if (optarg[1] == 'l') /* "planner" */
				return "log_planner_stats";
			break;

		case 'e':	/* "executor" */
			return "log_executor_stats";
			break;
	}

	return NULL;
}


2532
/* ----------------------------------------------------------------
2533
 * PostgresMain
B
Bruce Momjian 已提交
2534
 *	   postgres main loop -- all backends, interactive or otherwise start here
2535
 *
2536 2537 2538 2539
 * argc/argv are the command line arguments to be used.  (When being forked
 * by the postmaster, these are not the original argv array of the process.)
 * username is the (possibly authenticated) PostgreSQL user name to be used
 * for the session.
2540 2541 2542
 * ----------------------------------------------------------------
 */
int
2543
PostgresMain(int argc, char *argv[], const char *username)
2544
{
2545
	int			flag;
2546
	const char *dbname = NULL;
2547
	char	   *userDoption = NULL;
2548
	bool		secure;
2549
	int			errs = 0;
B
Bruce Momjian 已提交
2550 2551
	int			debug_flag = -1;	/* -1 means not given */
	List	   *guc_names = NIL;	/* for SUSET options */
2552 2553
	List	   *guc_values = NIL;
	GucContext	ctx;
2554
	GucSource	gucsource;
2555
	bool		am_superuser;
2556
	int			firstchar;
2557
	char		stack_base;
B
Bruce Momjian 已提交
2558
	StringInfoData input_message;
2559
	sigjmp_buf	local_sigjmp_buf;
2560
	volatile bool send_ready_for_query = true;
B
Bruce Momjian 已提交
2561

2562 2563 2564 2565
#define PendingConfigOption(name,val) \
	(guc_names = lappend(guc_names, pstrdup(name)), \
	 guc_values = lappend(guc_values, pstrdup(val)))

2566
	/*
B
Bruce Momjian 已提交
2567 2568
	 * Catch standard options before doing much else.  This even works on
	 * systems without getopt_long.
2569 2570 2571
	 */
	if (!IsUnderPostmaster && argc > 1)
	{
B
Bruce Momjian 已提交
2572
		if (strcmp(argv[1], "--help") == 0 || strcmp(argv[1], "-?") == 0)
2573 2574 2575 2576
		{
			usage(argv[0]);
			exit(0);
		}
B
Bruce Momjian 已提交
2577
		if (strcmp(argv[1], "--version") == 0 || strcmp(argv[1], "-V") == 0)
2578
		{
2579
			puts(PG_VERSIONSTR);
2580 2581
			exit(0);
		}
B
Bruce Momjian 已提交
2582
	}
2583

2584 2585 2586 2587 2588 2589
	/*
	 * initialize globals (already done if under postmaster, but not if
	 * standalone; cheap enough to do over)
	 */
	MyProcPid = getpid();

2590 2591 2592 2593 2594
	/*
	 * Fire up essential subsystems: error and memory management
	 *
	 * If we are running under the postmaster, this is done already.
	 */
2595
	if (!IsUnderPostmaster)
2596 2597
		MemoryContextInit();

2598 2599
	set_ps_display("startup");

2600 2601
	SetProcessingMode(InitProcessing);

2602 2603 2604
	/* Set up reference point for stack depth checking */
	stack_base_ptr = &stack_base;

2605 2606 2607 2608 2609 2610 2611
	/* Compute paths, if we didn't inherit them from postmaster */
	if (my_exec_path[0] == '\0')
	{
		if (find_my_exec(argv[0], my_exec_path) < 0)
			elog(FATAL, "%s: could not locate my own executable path",
				 argv[0]);
	}
B
Bruce Momjian 已提交
2612

B
Bruce Momjian 已提交
2613 2614
	if (pkglib_path[0] == '\0')
		get_pkglib_path(my_exec_path, pkglib_path);
2615

2616
	/*
2617
	 * Set default values for command-line options.
2618
	 */
2619
	EchoQuery = false;
2620

2621
	if (!IsUnderPostmaster)
2622
		InitializeGUCOptions();
2623

2624 2625 2626 2627 2628 2629 2630 2631 2632 2633 2634 2635 2636 2637 2638 2639 2640
	/* ----------------
	 *	parse command line arguments
	 *
	 *	There are now two styles of command line layout for the backend:
	 *
	 *	For interactive use (not started from postmaster) the format is
	 *		postgres [switches] [databasename]
	 *	If the databasename is omitted it is taken to be the user name.
	 *
	 *	When started from the postmaster, the format is
	 *		postgres [secure switches] -p databasename [insecure switches]
	 *	Switches appearing after -p came from the client (via "options"
	 *	field of connection request).  For security reasons we restrict
	 *	what these switches can do.
	 * ----------------
	 */

2641 2642
	/* all options are allowed until '-p' */
	secure = true;
2643
	ctx = PGC_POSTMASTER;
2644
	gucsource = PGC_S_ARGV;		/* initial switches came from command line */
2645

2646
	while ((flag = getopt(argc, argv, "A:B:c:D:d:EeFf:h:ijk:lN:nOo:Pp:r:S:sTt:v:W:y:-:")) != -1)
2647
	{
2648 2649
		switch (flag)
		{
M
 
Marc G. Fournier 已提交
2650
			case 'A':
2651
				SetConfigOption("debug_assertions", optarg, ctx, gucsource);
M
 
Marc G. Fournier 已提交
2652
				break;
2653

2654
			case 'B':
2655
				SetConfigOption("shared_buffers", optarg, ctx, gucsource);
2656
				break;
2657

2658
			case 'D':
2659
				if (secure)
2660
					userDoption = optarg;
M
 
Marc G. Fournier 已提交
2661
				break;
2662

2663
			case 'd':
2664
				debug_flag = atoi(optarg);
2665
				break;
2666 2667

			case 'E':
2668
				EchoQuery = true;
2669
				break;
2670 2671

			case 'e':
2672
				SetConfigOption("datestyle", "euro", ctx, gucsource);
2673
				break;
2674 2675

			case 'F':
2676
				SetConfigOption("fsync", "false", ctx, gucsource);
2677
				break;
2678 2679

			case 'f':
2680 2681 2682
				if (!set_plan_disabling_options(optarg, ctx, gucsource))
					errs++;
				break;
2683

2684 2685
			case 'h':
				SetConfigOption("listen_addresses", optarg, ctx, gucsource);
2686 2687
				break;

2688 2689 2690
			case 'i':
				SetConfigOption("listen_addresses", "*", ctx, gucsource);
				break;
2691

2692
			case 'j':
2693 2694
				UseNewLine = 0;
				break;
2695

2696 2697 2698
			case 'k':
				SetConfigOption("unix_socket_directory", optarg, ctx, gucsource);
				break;
2699

2700 2701
			case 'l':
				SetConfigOption("ssl", "true", ctx, gucsource);
2702 2703
				break;

2704 2705 2706
			case 'N':
				SetConfigOption("max_connections", optarg, ctx, gucsource);
				break;
2707

2708 2709 2710 2711 2712 2713
			case 'n':
				/* ignored for consistency with postmaster */
				break;

			case 'O':
				SetConfigOption("allow_system_table_mods", "true", ctx, gucsource);
H
Hiroshi Inoue 已提交
2714 2715
				break;

T
Tom Lane 已提交
2716
			case 'o':
2717 2718
				errs++;
				break;
2719

2720 2721
			case 'P':
				SetConfigOption("ignore_system_indexes", "true", ctx, gucsource);
T
Tom Lane 已提交
2722 2723
				break;

2724
			case 'p':
2725 2726
				SetConfigOption("port", optarg, ctx, gucsource);
				break;
B
Bruce Momjian 已提交
2727

2728 2729
			case 'r':
				/* send output (stdout and stderr) to the given file */
2730
				if (secure)
2731
					StrNCpy(OutputFileName, optarg, MAXPGPATH);
2732
				break;
2733

2734
			case 'S':
2735
				SetConfigOption("work_mem", optarg, ctx, gucsource);
2736
				break;
2737 2738

			case 's':
2739
				/*
2740 2741
				 * Since log options are SUSET, we need to postpone unless
				 * still in secure context
2742
				 */
2743 2744 2745 2746 2747
				if (ctx == PGC_BACKEND)
					PendingConfigOption("log_statement_stats", "true");
				else
					SetConfigOption("log_statement_stats", "true",
									ctx, gucsource);
M
 
Marc G. Fournier 已提交
2748 2749
				break;

2750 2751 2752 2753
			case 'T':
				/* ignored for consistency with postmaster */
				break;

2754
			case 't':
2755 2756
			{
				const char *tmp = get_stats_option_name(optarg);
2757
				if (tmp)
2758 2759 2760 2761 2762 2763
				{
					if (ctx == PGC_BACKEND)
						PendingConfigOption(tmp, "true");
					else
						SetConfigOption(tmp, "true", ctx, gucsource);
				}
2764 2765
				else
					errs++;
2766
				break;
2767
			}
2768

2769
			case 'v':
2770 2771
				if (secure)
					FrontendProtocol = (ProtocolVersion) atoi(optarg);
2772 2773
				break;

M
 
Marc G. Fournier 已提交
2774
			case 'W':
2775 2776
				SetConfigOption("post_auth_delay", optarg, ctx, gucsource);
				break;
2777

2778 2779

			case 'y':
2780
				/*
2781 2782
				 * y - special flag passed if backend was forked by a
				 * postmaster.
M
 
Marc G. Fournier 已提交
2783
				 */
2784 2785 2786 2787 2788 2789 2790 2791
				if (secure)
				{
					dbname = strdup(optarg);

					secure = false;		/* subsequent switches are NOT secure */
					ctx = PGC_BACKEND;
					gucsource = PGC_S_CLIENT;
				}
M
 
Marc G. Fournier 已提交
2792 2793
				break;

2794
			case 'c':
2795
			case '-':
2796
				{
B
Bruce Momjian 已提交
2797 2798
					char	   *name,
							   *value;
2799

B
Bruce Momjian 已提交
2800 2801 2802 2803
					ParseLongOption(optarg, &name, &value);
					if (!value)
					{
						if (flag == '-')
2804 2805 2806 2807
							ereport(ERROR,
									(errcode(ERRCODE_SYNTAX_ERROR),
									 errmsg("--%s requires a value",
											optarg)));
B
Bruce Momjian 已提交
2808
						else
2809 2810 2811 2812
							ereport(ERROR,
									(errcode(ERRCODE_SYNTAX_ERROR),
									 errmsg("-c %s requires a value",
											optarg)));
B
Bruce Momjian 已提交
2813 2814
					}

2815
					/*
B
Bruce Momjian 已提交
2816 2817
					 * If a SUSET option, must postpone evaluation, unless we
					 * are still reading secure switches.
2818 2819 2820 2821 2822
					 */
					if (ctx == PGC_BACKEND && IsSuperuserConfigOption(name))
						PendingConfigOption(name, value);
					else
						SetConfigOption(name, value, ctx, gucsource);
B
Bruce Momjian 已提交
2823 2824 2825 2826 2827
					free(name);
					if (value)
						free(value);
					break;
				}
2828

2829 2830
			default:
				errs++;
T
Tom Lane 已提交
2831
				break;
2832
		}
2833 2834
	}

2835
	/*
B
Bruce Momjian 已提交
2836 2837
	 * Process any additional GUC variable settings passed in startup packet.
	 * These are handled exactly like command-line variables.
2838 2839 2840 2841 2842 2843 2844 2845 2846 2847 2848 2849 2850 2851 2852 2853 2854 2855 2856 2857 2858 2859 2860
	 */
	if (MyProcPort != NULL)
	{
		ListCell   *gucopts = list_head(MyProcPort->guc_options);

		while (gucopts)
		{
			char	   *name;
			char	   *value;

			name = lfirst(gucopts);
			gucopts = lnext(gucopts);

			value = lfirst(gucopts);
			gucopts = lnext(gucopts);

			if (IsSuperuserConfigOption(name))
				PendingConfigOption(name, value);
			else
				SetConfigOption(name, value, PGC_BACKEND, PGC_S_CLIENT);
		}
	}

2861 2862
	/* Acquire configuration parameters, unless inherited from postmaster */
	if (!IsUnderPostmaster)
2863
	{
2864 2865
		if (!SelectConfigFiles(userDoption, argv[0]))
			proc_exit(1);
2866 2867
		/* If timezone is not set, determine what the OS uses */
		pg_timezone_initialize();
2868
	}
2869

2870 2871 2872
	if (PostAuthDelay)
		pg_usleep(PostAuthDelay * 1000000L);

2873
	/*
2874
	 * Set up signal handlers and masks.
2875
	 *
2876 2877 2878
	 * Note that postmaster blocked all signals before forking child process,
	 * so there is no race condition whereby we might receive a signal before
	 * we have set up the handler.
T
Tom Lane 已提交
2879
	 *
B
Bruce Momjian 已提交
2880 2881 2882 2883 2884 2885
	 * Also note: it's best not to use any signals that are SIG_IGNored in the
	 * postmaster.	If such a signal arrives before we are able to change the
	 * handler to non-SIG_IGN, it'll get dropped.  Instead, make a dummy
	 * handler in the postmaster to reserve the signal. (Of course, this isn't
	 * an issue for signals that are locally generated, such as SIGALRM and
	 * SIGPIPE.)
2886
	 */
2887
	pqsignal(SIGHUP, SigHupHandler);	/* set flag to read config file */
B
Bruce Momjian 已提交
2888
	pqsignal(SIGINT, StatementCancelHandler);	/* cancel current query */
2889
	pqsignal(SIGTERM, die);		/* cancel current query and exit */
2890
	pqsignal(SIGQUIT, quickdie);	/* hard crash time */
B
Bruce Momjian 已提交
2891
	pqsignal(SIGALRM, handle_sig_alarm);		/* timeout conditions */
2892 2893 2894 2895

	/*
	 * Ignore failure to write to frontend. Note: if frontend closes
	 * connection, we will notice it and exit cleanly when control next
B
Bruce Momjian 已提交
2896 2897
	 * returns to outer loop.  This seems safer than forcing exit in the midst
	 * of output during who-knows-what operation...
2898 2899
	 */
	pqsignal(SIGPIPE, SIG_IGN);
2900 2901
	pqsignal(SIGUSR1, CatchupInterruptHandler);
	pqsignal(SIGUSR2, NotifyInterruptHandler);
2902
	pqsignal(SIGFPE, FloatExceptionHandler);
2903 2904

	/*
B
Bruce Momjian 已提交
2905
	 * Reset some signals that are accepted by postmaster but not by backend
2906
	 */
B
Bruce Momjian 已提交
2907
	pqsignal(SIGCHLD, SIG_DFL); /* system() requires this on some platforms */
2908

2909 2910
	pqinitmask();

T
Tom Lane 已提交
2911
	/* We allow SIGQUIT (quickdie) at all times */
2912
#ifdef HAVE_SIGPROCMASK
T
Tom Lane 已提交
2913
	sigdelset(&BlockSig, SIGQUIT);
2914
#else
T
Tom Lane 已提交
2915
	BlockSig &= ~(sigmask(SIGQUIT));
2916 2917
#endif

T
Tom Lane 已提交
2918
	PG_SETMASK(&BlockSig);		/* block everything except SIGQUIT */
2919

2920
	if (IsUnderPostmaster)
2921
	{
2922
		/* noninteractive case: nothing should be left after switches */
2923
		if (errs || argc != optind || dbname == NULL)
2924
		{
2925 2926
			ereport(FATAL,
					(errcode(ERRCODE_SYNTAX_ERROR),
B
Bruce Momjian 已提交
2927 2928
				 errmsg("invalid command-line arguments for server process"),
			   errhint("Try \"%s --help\" for more information.", argv[0])));
2929
		}
2930

2931
		BaseInit();
2932
	}
2933
	else
2934
	{
2935 2936 2937
		/* interactive case: database name can be last arg on command line */
		if (errs || argc - optind > 1)
		{
2938 2939 2940 2941
			ereport(FATAL,
					(errcode(ERRCODE_SYNTAX_ERROR),
					 errmsg("%s: invalid command-line arguments",
							argv[0]),
B
Bruce Momjian 已提交
2942
			   errhint("Try \"%s --help\" for more information.", argv[0])));
2943 2944
		}
		else if (argc - optind == 1)
2945 2946
			dbname = argv[optind];
		else if ((dbname = username) == NULL)
2947
		{
2948 2949 2950 2951
			ereport(FATAL,
					(errcode(ERRCODE_INVALID_PARAMETER_VALUE),
					 errmsg("%s: no database nor user name specified",
							argv[0])));
2952
		}
2953

2954
		/*
B
Bruce Momjian 已提交
2955 2956
		 * Validate we have been given a reasonable-looking DataDir (if under
		 * postmaster, assume postmaster did this already).
2957
		 */
2958
		Assert(DataDir);
2959 2960
		ValidatePgVersion(DataDir);

2961 2962 2963
		/* Change into DataDir (if under postmaster, was done already) */
		ChangeToDataDir();

2964
		/*
2965
		 * Create lockfile for data directory.
2966
		 */
2967
		CreateDataDirLockFile(false);
2968

2969
		BaseInit();
2970 2971 2972 2973 2974

		/*
		 * Start up xlog for standalone backend, and register to have it
		 * closed down at exit.
		 */
2975
		StartupXLOG();
2976
		on_shmem_exit(ShutdownXLOG, 0);
2977 2978

		/*
B
Bruce Momjian 已提交
2979 2980
		 * Read any existing FSM cache file, and register to write one out at
		 * exit.
2981 2982 2983
		 */
		LoadFreeSpaceMap();
		on_shmem_exit(DumpFreeSpaceMap, 0);
2984 2985

		/*
B
Bruce Momjian 已提交
2986 2987
		 * We have to build the flat file for pg_database, but not for the
		 * user and group tables, since we won't try to do authentication.
2988 2989
		 */
		BuildFlatFiles(true);
2990 2991
	}

2992 2993 2994 2995 2996 2997 2998 2999 3000 3001 3002 3003 3004
	/*
	 * Create a per-backend PGPROC struct in shared memory, except in
	 * the EXEC_BACKEND case where this was done in SubPostmasterMain.
	 * We must do this before we can use LWLocks (and in the EXEC_BACKEND
	 * case we already had to do some stuff with LWLocks).
	 */
#ifdef EXEC_BACKEND
	if (!IsUnderPostmaster)
		InitProcess();
#else
	InitProcess();
#endif

3005
	/*
3006 3007
	 * General initialization.
	 *
3008 3009 3010
	 * NOTE: if you are tempted to add code in this vicinity, consider putting
	 * it inside InitPostgres() instead.  In particular, anything that
	 * involves database access should be there, not here.
3011
	 */
3012 3013
	ereport(DEBUG3,
			(errmsg_internal("InitPostgres")));
3014
	am_superuser = InitPostgres(dbname, username);
3015

3016
	SetProcessingMode(NormalProcessing);
3017

3018
	/*
3019 3020
	 * Now that we know if client is a superuser, we can try to apply SUSET
	 * GUC options that came from the client.
3021 3022 3023 3024 3025 3026 3027 3028 3029 3030 3031 3032 3033 3034 3035 3036 3037 3038 3039 3040 3041 3042 3043 3044 3045 3046 3047 3048
	 */
	ctx = am_superuser ? PGC_SUSET : PGC_USERSET;

	if (debug_flag >= 0)
		set_debug_options(debug_flag, ctx, PGC_S_CLIENT);

	if (guc_names != NIL)
	{
		ListCell   *namcell,
				   *valcell;

		forboth(namcell, guc_names, valcell, guc_values)
		{
			char	   *name = (char *) lfirst(namcell);
			char	   *value = (char *) lfirst(valcell);

			SetConfigOption(name, value, ctx, PGC_S_CLIENT);
			pfree(name);
			pfree(value);
		}
	}

	/*
	 * Now all GUC states are fully set up.  Report them to client if
	 * appropriate.
	 */
	BeginReportingGUCOptions();

3049
	/*
B
Bruce Momjian 已提交
3050 3051
	 * Also set up handler to log session end; we have to wait till now to be
	 * sure Log_disconnections has its final value.
3052 3053 3054 3055
	 */
	if (IsUnderPostmaster && Log_disconnections)
		on_proc_exit(log_disconnections, 0);

3056 3057
	/*
	 * Send this backend's cancellation info to the frontend.
3058
	 */
3059
	if (whereToSendOutput == DestRemote &&
M
 
Marc G. Fournier 已提交
3060 3061
		PG_PROTOCOL_MAJOR(FrontendProtocol) >= 2)
	{
3062
		StringInfoData buf;
B
Bruce Momjian 已提交
3063

3064
		pq_beginmessage(&buf, 'K');
3065 3066 3067
		pq_sendint(&buf, (int32) MyProcPid, sizeof(int32));
		pq_sendint(&buf, (int32) MyCancelKey, sizeof(int32));
		pq_endmessage(&buf);
M
 
Marc G. Fournier 已提交
3068 3069 3070
		/* Need not flush since ReadyForQuery will do it. */
	}

3071
	/* Welcome banner for standalone case */
3072
	if (whereToSendOutput == DestDebug)
3073
		printf("\nPostgreSQL stand-alone backend %s\n", PG_VERSION);
3074

3075 3076 3077
	/*
	 * Create the memory context we will use in the main loop.
	 *
3078 3079
	 * MessageContext is reset once per iteration of the main loop, ie, upon
	 * completion of processing of each command message from the client.
3080
	 */
3081 3082 3083 3084 3085
	MessageContext = AllocSetContextCreate(TopMemoryContext,
										   "MessageContext",
										   ALLOCSET_DEFAULT_MINSIZE,
										   ALLOCSET_DEFAULT_INITSIZE,
										   ALLOCSET_DEFAULT_MAXSIZE);
3086

3087
	/*
3088
	 * Remember stand-alone backend startup time
3089 3090
	 */
	if (!IsUnderPostmaster)
3091
		PgStartTime = GetCurrentTimestamp();
3092

3093 3094
	/*
	 * POSTGRES main processing loop begins here
3095
	 *
B
Bruce Momjian 已提交
3096 3097
	 * If an exception is encountered, processing resumes here so we abort the
	 * current transaction and start a new one.
3098
	 *
3099 3100 3101 3102 3103 3104 3105
	 * You might wonder why this isn't coded as an infinite loop around a
	 * PG_TRY construct.  The reason is that this is the bottom of the
	 * exception stack, and so with PG_TRY there would be no exception handler
	 * in force at all during the CATCH part.  By leaving the outermost setjmp
	 * always active, we have at least some chance of recovering from an error
	 * during error recovery.  (If we get into an infinite loop thereby, it
	 * will soon be stopped by overflow of elog.c's internal state stack.)
3106 3107
	 */

3108
	if (sigsetjmp(local_sigjmp_buf, 1) != 0)
3109
	{
3110
		/*
3111
		 * NOTE: if you are tempted to add more code in this if-block,
3112
		 * consider the high probability that it should be in
B
Bruce Momjian 已提交
3113
		 * AbortTransaction() instead.	The only stuff done directly here
B
Bruce Momjian 已提交
3114 3115
		 * should be stuff that is guaranteed to apply *only* for outer-level
		 * error recovery, such as adjusting the FE/BE protocol status.
3116 3117 3118 3119 3120 3121 3122 3123 3124
		 */

		/* Since not using PG_TRY, must reset error stack by hand */
		error_context_stack = NULL;

		/* Prevent interrupts while cleaning up */
		HOLD_INTERRUPTS();

		/*
B
Bruce Momjian 已提交
3125 3126
		 * Forget any pending QueryCancel request, since we're returning to
		 * the idle loop anyway, and cancel the statement timer if running.
3127 3128
		 */
		QueryCancelPending = false;
3129
		disable_sig_alarm(true);
B
Bruce Momjian 已提交
3130
		QueryCancelPending = false;		/* again in case timeout occurred */
3131 3132

		/*
B
Bruce Momjian 已提交
3133 3134 3135
		 * Turn off these interrupts too.  This is only needed here and not in
		 * other exception-catching places since these interrupts are only
		 * enabled while we wait for client input.
3136
		 */
3137
		DoingCommandRead = false;
3138
		DisableNotifyInterrupt();
3139
		DisableCatchupInterrupt();
3140

3141 3142 3143
		/* Make sure libpq is in a good state */
		pq_comm_reset();

3144 3145
		/* Report the error to the client and/or server log */
		EmitErrorReport();
3146

3147
		/*
B
Bruce Momjian 已提交
3148 3149
		 * Make sure debug_query_string gets reset before we possibly clobber
		 * the storage it points at.
3150
		 */
3151
		debug_query_string = NULL;
3152

3153
		/*
3154
		 * Abort the current transaction in order to recover.
3155
		 */
3156
		AbortCurrentTransaction();
3157 3158

		/*
B
Bruce Momjian 已提交
3159 3160
		 * Now return to normal top-level context and clear ErrorContext for
		 * next time.
3161 3162
		 */
		MemoryContextSwitchTo(TopMemoryContext);
3163
		FlushErrorState();
3164
		QueryContext = NULL;
3165

3166
		/*
B
Bruce Momjian 已提交
3167 3168
		 * If we were handling an extended-query-protocol message, initiate
		 * skip till next Sync.  This also causes us not to issue
B
Bruce Momjian 已提交
3169
		 * ReadyForQuery (until we get Sync).
3170 3171 3172
		 */
		if (doing_extended_query_message)
			ignore_till_sync = true;
3173

3174 3175
		/* We don't have a transaction command open anymore */
		xact_started = false;
3176 3177
		command_initialized = false;
		
3178
		/* Now we can allow interrupts again */
3179
		RESUME_INTERRUPTS();
3180
	}
3181

3182 3183
	/* We can now handle ereport(ERROR) */
	PG_exception_stack = &local_sigjmp_buf;
3184

3185
	PG_SETMASK(&UnBlockSig);
3186

3187
	if (!ignore_till_sync)
3188
		send_ready_for_query = true;		/* initially, or after error */
3189

3190 3191
	/*
	 * Non-error queries loop here.
3192 3193 3194 3195
	 */

	for (;;)
	{
3196
		/*
B
Bruce Momjian 已提交
3197 3198
		 * At top of loop, reset extended-query-message flag, so that any
		 * errors encountered in "idle" state don't provoke skip.
3199 3200 3201
		 */
		doing_extended_query_message = false;

3202
		/*
B
Bruce Momjian 已提交
3203 3204
		 * Release storage left over from prior query cycle, and create a new
		 * query input buffer in the cleared MessageContext.
3205
		 */
3206 3207
		MemoryContextSwitchTo(MessageContext);
		MemoryContextResetAndDeleteChildren(MessageContext);
3208

3209
		initStringInfo(&input_message);
3210

3211
		/*
B
Bruce Momjian 已提交
3212 3213
		 * (1) If we've reached idle state, tell the frontend we're ready for
		 * a new query.
3214
		 *
3215
		 * Note: this includes fflush()'ing the last of the prior output.
3216 3217 3218
		 *
		 * This is also a good time to send collected statistics to the
		 * collector, and to update the PS stats display.  We avoid doing
B
Bruce Momjian 已提交
3219 3220 3221
		 * those every time through the message loop because it'd slow down
		 * processing of batched messages, and because we don't want to report
		 * uncommitted updates (that confuses autovacuum).
B
Bruce Momjian 已提交
3222
		 */
3223
		if (send_ready_for_query)
3224
		{
3225
			if (IsTransactionOrTransactionBlock())
3226 3227 3228 3229 3230 3231
			{
				set_ps_display("idle in transaction");
				pgstat_report_activity("<IDLE> in transaction");
			}
			else
			{
3232 3233
				pgstat_report_tabstat();

3234 3235 3236
				set_ps_display("idle");
				pgstat_report_activity("<IDLE>");
			}
3237

3238
			ReadyForQuery(whereToSendOutput);
3239
			send_ready_for_query = false;
3240
		}
3241

3242
		/*
B
Bruce Momjian 已提交
3243 3244 3245 3246
		 * (2) Allow asynchronous signals to be executed immediately if they
		 * come in while we are waiting for client input. (This must be
		 * conditional since we don't want, say, reads on behalf of COPY FROM
		 * STDIN doing the same thing.)
3247
		 */
3248 3249
		QueryCancelPending = false;		/* forget any earlier CANCEL signal */
		DoingCommandRead = true;
3250

3251 3252
		/*
		 * (3) read a command (loop blocks here)
3253
		 */
3254
		firstchar = ReadCommand(&input_message);
3255

3256 3257
		/*
		 * (4) disable async signal conditions again.
3258
		 */
3259
		DoingCommandRead = false;
3260

3261
		/*
B
Bruce Momjian 已提交
3262 3263
		 * (5) check for any other interesting events that happened while we
		 * slept.
3264 3265 3266 3267 3268 3269 3270
		 */
		if (got_SIGHUP)
		{
			got_SIGHUP = false;
			ProcessConfigFile(PGC_SIGHUP);
		}

3271
		/*
B
Bruce Momjian 已提交
3272 3273
		 * (6) process the command.  But ignore it if we're skipping till
		 * Sync.
3274
		 */
3275
		if (ignore_till_sync && firstchar != EOF)
3276 3277
			continue;

3278 3279
		switch (firstchar)
		{
3280
			case 'Q':			/* simple query */
3281
				{
3282 3283
					const char *query_string;

3284 3285
					query_string = pq_getmsgstring(&input_message);
					pq_getmsgend(&input_message);
3286

3287
					exec_simple_query(query_string);
3288

3289
					send_ready_for_query = true;
3290
				}
3291 3292
				break;

3293 3294 3295 3296 3297 3298 3299
			case 'P':			/* parse */
				{
					const char *stmt_name;
					const char *query_string;
					int			numParams;
					Oid		   *paramTypes = NULL;

3300 3301 3302
					stmt_name = pq_getmsgstring(&input_message);
					query_string = pq_getmsgstring(&input_message);
					numParams = pq_getmsgint(&input_message, 2);
3303 3304
					if (numParams > 0)
					{
B
Bruce Momjian 已提交
3305
						int			i;
3306 3307 3308

						paramTypes = (Oid *) palloc(numParams * sizeof(Oid));
						for (i = 0; i < numParams; i++)
3309
							paramTypes[i] = pq_getmsgint(&input_message, 4);
3310
					}
3311
					pq_getmsgend(&input_message);
3312 3313 3314 3315 3316 3317 3318

					exec_parse_message(query_string, stmt_name,
									   paramTypes, numParams);
				}
				break;

			case 'B':			/* bind */
B
Bruce Momjian 已提交
3319

3320
				/*
B
Bruce Momjian 已提交
3321 3322
				 * this message is complex enough that it seems best to put
				 * the field extraction out-of-line
3323
				 */
3324
				exec_bind_message(&input_message);
3325 3326 3327 3328 3329
				break;

			case 'E':			/* execute */
				{
					const char *portal_name;
B
Bruce Momjian 已提交
3330
					int			max_rows;
3331

3332 3333 3334
					portal_name = pq_getmsgstring(&input_message);
					max_rows = pq_getmsgint(&input_message, 4);
					pq_getmsgend(&input_message);
3335

3336
					exec_execute_message(portal_name, max_rows);
3337 3338 3339
				}
				break;

3340 3341
			case 'F':			/* fastpath function call */
				/* Tell the collector what we're doing */
3342 3343
				pgstat_report_activity("<FASTPATH> function call");

3344
				/* start an xact for this function invocation */
3345
				initialize_command();
3346

3347 3348 3349
				/* switch back to message context */
				MemoryContextSwitchTo(MessageContext);

3350 3351 3352
				/* set snapshot in case function needs one */
				ActiveSnapshot = CopySnapshot(GetTransactionSnapshot());

3353
				if (HandleFunctionRequest(&input_message) == EOF)
3354 3355
				{
					/* lost frontend connection during F message input */
B
Bruce Momjian 已提交
3356

3357
					/*
3358
					 * Reset whereToSendOutput to prevent ereport from
B
Bruce Momjian 已提交
3359
					 * attempting to send any more messages to client.
3360
					 */
3361 3362
					if (whereToSendOutput == DestRemote)
						whereToSendOutput = DestNone;
3363

3364
					proc_exit(0);
3365
				}
3366 3367

				/* commit the function-invocation transaction */
3368
				finalize_command();
3369

3370
				send_ready_for_query = true;
3371 3372
				break;

B
Bruce Momjian 已提交
3373
			case 'C':			/* close */
3374
				{
B
Bruce Momjian 已提交
3375
					int			close_type;
3376 3377
					const char *close_target;

3378 3379 3380
					close_type = pq_getmsgbyte(&input_message);
					close_target = pq_getmsgstring(&input_message);
					pq_getmsgend(&input_message);
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

					switch (close_type)
					{
						case 'S':
							if (close_target[0] != '\0')
								DropPreparedStatement(close_target, false);
							else
							{
								/* special-case the unnamed statement */
								unnamed_stmt_pstmt = NULL;
								if (unnamed_stmt_context)
								{
									DropDependentPortals(unnamed_stmt_context);
									MemoryContextDelete(unnamed_stmt_context);
								}
								unnamed_stmt_context = NULL;
							}
							break;
						case 'P':
							{
								Portal		portal;

								portal = GetPortalByName(close_target);
								if (PortalIsValid(portal))
									PortalDrop(portal, false);
							}
							break;
						default:
3409 3410
							ereport(ERROR,
									(errcode(ERRCODE_PROTOCOL_VIOLATION),
B
Bruce Momjian 已提交
3411 3412
								   errmsg("invalid CLOSE message subtype %d",
										  close_type)));
3413 3414 3415
							break;
					}

3416
					if (whereToSendOutput == DestRemote)
B
Bruce Momjian 已提交
3417
						pq_putemptymessage('3');		/* CloseComplete */
3418 3419 3420 3421 3422
				}
				break;

			case 'D':			/* describe */
				{
B
Bruce Momjian 已提交
3423
					int			describe_type;
3424 3425
					const char *describe_target;

3426 3427 3428
					describe_type = pq_getmsgbyte(&input_message);
					describe_target = pq_getmsgstring(&input_message);
					pq_getmsgend(&input_message);
3429 3430 3431 3432 3433 3434 3435 3436 3437 3438

					switch (describe_type)
					{
						case 'S':
							exec_describe_statement_message(describe_target);
							break;
						case 'P':
							exec_describe_portal_message(describe_target);
							break;
						default:
3439 3440
							ereport(ERROR,
									(errcode(ERRCODE_PROTOCOL_VIOLATION),
B
Bruce Momjian 已提交
3441 3442
								errmsg("invalid DESCRIBE message subtype %d",
									   describe_type)));
3443 3444 3445 3446 3447
							break;
					}
				}
				break;

B
Bruce Momjian 已提交
3448
			case 'H':			/* flush */
3449
				pq_getmsgend(&input_message);
3450
				if (whereToSendOutput == DestRemote)
3451 3452 3453
					pq_flush();
				break;

B
Bruce Momjian 已提交
3454
			case 'S':			/* sync */
3455
				pq_getmsgend(&input_message);
3456
				finalize_command();
3457
				send_ready_for_query = true;
3458 3459
				break;

3460
				/*
B
Bruce Momjian 已提交
3461 3462 3463
				 * 'X' means that the frontend is closing down the socket. EOF
				 * means unexpected loss of frontend connection. Either way,
				 * perform normal shutdown.
3464 3465
				 */
			case 'X':
3466
			case EOF:
B
Bruce Momjian 已提交
3467

3468
				/*
B
Bruce Momjian 已提交
3469 3470
				 * Reset whereToSendOutput to prevent ereport from attempting
				 * to send any more messages to client.
3471
				 */
3472 3473
				if (whereToSendOutput == DestRemote)
					whereToSendOutput = DestNone;
B
Bruce Momjian 已提交
3474

3475 3476
				/*
				 * NOTE: if you are tempted to add more code here, DON'T!
B
Bruce Momjian 已提交
3477
				 * Whatever you had in mind to do should be set up as an
B
Bruce Momjian 已提交
3478 3479 3480
				 * on_proc_exit or on_shmem_exit callback, instead. Otherwise
				 * it will fail to be called during other backend-shutdown
				 * scenarios.
3481
				 */
3482
				proc_exit(0);
3483

B
Bruce Momjian 已提交
3484 3485 3486 3487
			case 'd':			/* copy data */
			case 'c':			/* copy done */
			case 'f':			/* copy fail */

3488
				/*
B
Bruce Momjian 已提交
3489
				 * Accept but ignore these messages, per protocol spec; we
B
Bruce Momjian 已提交
3490 3491
				 * probably got here because a COPY failed, and the frontend
				 * is still sending data.
3492 3493 3494
				 */
				break;

3495
			default:
3496 3497 3498 3499
				ereport(FATAL,
						(errcode(ERRCODE_PROTOCOL_VIOLATION),
						 errmsg("invalid frontend message type %d",
								firstchar)));
3500
		}
3501
	}							/* end of input-reading loop */
3502

3503 3504
	/* can't get here because the above loop never exits */
	Assert(false);
3505

3506
	return 1;					/* keep compiler quiet */
3507 3508
}

3509
#ifndef HAVE_GETRUSAGE
B
Bruce Momjian 已提交
3510 3511
#include "rusagestub.h"
#else
3512
#include <sys/resource.h>
3513
#endif   /* HAVE_GETRUSAGE */
3514

3515 3516
static struct rusage Save_r;
static struct timeval Save_t;
3517 3518

void
3519
ResetUsage(void)
3520
{
3521
	getrusage(RUSAGE_SELF, &Save_r);
3522
	gettimeofday(&Save_t, NULL);
3523
	ResetBufferUsage();
3524
	/* ResetTupleCount(); */
3525 3526 3527
}

void
3528
ShowUsage(const char *title)
3529
{
3530
	StringInfoData str;
3531 3532 3533 3534
	struct timeval user,
				sys;
	struct timeval elapse_t;
	struct rusage r;
B
Bruce Momjian 已提交
3535
	char	   *bufusage;
3536 3537

	getrusage(RUSAGE_SELF, &r);
3538
	gettimeofday(&elapse_t, NULL);
3539 3540
	memcpy((char *) &user, (char *) &r.ru_utime, sizeof(user));
	memcpy((char *) &sys, (char *) &r.ru_stime, sizeof(sys));
3541 3542 3543 3544 3545 3546 3547 3548 3549 3550 3551 3552 3553 3554 3555 3556 3557 3558
	if (elapse_t.tv_usec < Save_t.tv_usec)
	{
		elapse_t.tv_sec--;
		elapse_t.tv_usec += 1000000;
	}
	if (r.ru_utime.tv_usec < Save_r.ru_utime.tv_usec)
	{
		r.ru_utime.tv_sec--;
		r.ru_utime.tv_usec += 1000000;
	}
	if (r.ru_stime.tv_usec < Save_r.ru_stime.tv_usec)
	{
		r.ru_stime.tv_sec--;
		r.ru_stime.tv_usec += 1000000;
	}

	/*
	 * the only stats we don't show here are for memory usage -- i can't
B
Bruce Momjian 已提交
3559 3560 3561 3562
	 * figure out how to interpret the relevant fields in the rusage struct,
	 * and they change names across o/s platforms, anyway. if you can figure
	 * out what the entries mean, you can somehow extract resident set size,
	 * shared text size, and unshared data and stack sizes.
3563
	 */
3564
	initStringInfo(&str);
3565

3566 3567
	appendStringInfo(&str, "! system usage stats:\n");
	appendStringInfo(&str,
B
Bruce Momjian 已提交
3568
				"!\t%ld.%06ld elapsed %ld.%06ld user %ld.%06ld system sec\n",
3569 3570 3571
					 (long) (elapse_t.tv_sec - Save_t.tv_sec),
					 (long) (elapse_t.tv_usec - Save_t.tv_usec),
					 (long) (r.ru_utime.tv_sec - Save_r.ru_utime.tv_sec),
B
Bruce Momjian 已提交
3572
					 (long) (r.ru_utime.tv_usec - Save_r.ru_utime.tv_usec),
3573
					 (long) (r.ru_stime.tv_sec - Save_r.ru_stime.tv_sec),
B
Bruce Momjian 已提交
3574
					 (long) (r.ru_stime.tv_usec - Save_r.ru_stime.tv_usec));
3575
	appendStringInfo(&str,
B
Bruce Momjian 已提交
3576
					 "!\t[%ld.%06ld user %ld.%06ld sys total]\n",
3577 3578 3579 3580
					 (long) user.tv_sec,
					 (long) user.tv_usec,
					 (long) sys.tv_sec,
					 (long) sys.tv_usec);
3581
#if defined(HAVE_GETRUSAGE)
3582
	appendStringInfo(&str,
B
Bruce Momjian 已提交
3583 3584
					 "!\t%ld/%ld [%ld/%ld] filesystem blocks in/out\n",
					 r.ru_inblock - Save_r.ru_inblock,
3585
	/* they only drink coffee at dec */
B
Bruce Momjian 已提交
3586 3587
					 r.ru_oublock - Save_r.ru_oublock,
					 r.ru_inblock, r.ru_oublock);
3588
	appendStringInfo(&str,
B
Bruce Momjian 已提交
3589
			  "!\t%ld/%ld [%ld/%ld] page faults/reclaims, %ld [%ld] swaps\n",
B
Bruce Momjian 已提交
3590 3591 3592 3593 3594
					 r.ru_majflt - Save_r.ru_majflt,
					 r.ru_minflt - Save_r.ru_minflt,
					 r.ru_majflt, r.ru_minflt,
					 r.ru_nswap - Save_r.ru_nswap,
					 r.ru_nswap);
3595
	appendStringInfo(&str,
B
Bruce Momjian 已提交
3596
		 "!\t%ld [%ld] signals rcvd, %ld/%ld [%ld/%ld] messages rcvd/sent\n",
B
Bruce Momjian 已提交
3597 3598 3599 3600 3601
					 r.ru_nsignals - Save_r.ru_nsignals,
					 r.ru_nsignals,
					 r.ru_msgrcv - Save_r.ru_msgrcv,
					 r.ru_msgsnd - Save_r.ru_msgsnd,
					 r.ru_msgrcv, r.ru_msgsnd);
3602
	appendStringInfo(&str,
B
Bruce Momjian 已提交
3603
			 "!\t%ld/%ld [%ld/%ld] voluntary/involuntary context switches\n",
B
Bruce Momjian 已提交
3604 3605 3606
					 r.ru_nvcsw - Save_r.ru_nvcsw,
					 r.ru_nivcsw - Save_r.ru_nivcsw,
					 r.ru_nvcsw, r.ru_nivcsw);
3607
#endif   /* HAVE_GETRUSAGE */
3608 3609

	bufusage = ShowBufferUsage();
3610
	appendStringInfo(&str, "! buffer usage stats:\n%s", bufusage);
3611 3612 3613
	pfree(bufusage);

	/* remove trailing newline */
B
Bruce Momjian 已提交
3614
	if (str.data[str.len - 1] == '\n')
3615 3616
		str.data[--str.len] = '\0';

3617 3618 3619
	ereport(LOG,
			(errmsg_internal("%s", title),
			 errdetail("%s", str.data)));
3620 3621

	pfree(str.data);
3622
}
3623 3624 3625 3626

/*
 * on_proc_exit handler to log end of session
 */
B
Bruce Momjian 已提交
3627
static void
3628
log_disconnections(int code, Datum arg)
3629
{
B
Bruce Momjian 已提交
3630 3631 3632 3633 3634
	Port	   *port = MyProcPort;
	struct timeval end;
	int			hours,
				minutes,
				seconds;
3635

3636
	gettimeofday(&end, NULL);
3637 3638 3639 3640 3641 3642 3643 3644
	if (end.tv_usec < port->session_start.tv_usec)
	{
		end.tv_sec--;
		end.tv_usec += 1000000;
	}
	end.tv_sec -= port->session_start.tv_sec;
	end.tv_usec -= port->session_start.tv_usec;

3645
	/* for stricter accuracy here we could round - this is close enough */
3646 3647 3648 3649
	hours = end.tv_sec / SECS_PER_HOUR;
	end.tv_sec %= SECS_PER_HOUR;
	minutes = end.tv_sec / SECS_PER_MINUTE;
	seconds = end.tv_sec % SECS_PER_MINUTE;
3650

3651 3652 3653 3654 3655
	ereport(LOG,
			(errmsg("disconnection: session time: %d:%02d:%02d.%02d "
					"user=%s database=%s host=%s%s%s",
					hours, minutes, seconds, (int) (end.tv_usec / 10000),
					port->user_name, port->database_name, port->remote_host,
B
Bruce Momjian 已提交
3656
				  port->remote_port[0] ? " port=" : "", port->remote_port)));
3657
}