postgres.c 94.3 KB
Newer Older
1 2
/*-------------------------------------------------------------------------
 *
3
 * postgres.c
4
 *	  POSTGRES C Backend Interface
5
 *
P
 
PostgreSQL Daemon 已提交
6
 * Portions Copyright (c) 1996-2005, 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.478 2006/01/08 07:00:25 neilc 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 101

/* stack base pointer (initialized by PostgresMain) */
102
/* Do not make static so PL/Java can modifiy it */
B
Bruce Momjian 已提交
103
char	   *stack_base_ptr = NULL;
104 105


106 107 108 109 110
/*
 * 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?)
 */
111
static volatile sig_atomic_t got_SIGHUP = false;
112

113 114 115 116 117 118
/*
 * 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;

119 120 121 122 123 124 125
/*
 * 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;

126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146
/*
 * 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
147 148
 */
#ifndef TCOP_DONTUSENEWLINE
B
Bruce Momjian 已提交
149
static int	UseNewLine = 1;		/* Use newlines query delimiters (the default) */
150
#else
151
static int	UseNewLine = 0;		/* Use EOF as query delimiters */
152
#endif   /* TCOP_DONTUSENEWLINE */
153 154 155


/* ----------------------------------------------------------------
156
 *		decls for routines only used in this file
157 158
 * ----------------------------------------------------------------
 */
159 160 161
static int	InteractiveBackend(StringInfo inBuf);
static int	SocketBackend(StringInfo inBuf);
static int	ReadCommand(StringInfo inBuf);
162 163
static bool log_after_parse(List *raw_parsetree_list,
				const char *query_string, char **prepare_string);
164
static List *pg_rewrite_queries(List *querytree_list);
165
static void start_xact_command(void);
166
static void finish_xact_command(void);
167 168 169
static bool IsTransactionExitStmt(Node *parsetree);
static bool IsTransactionExitStmtList(List *parseTrees);
static bool IsTransactionStmtList(List *parseTrees);
170
static void SigHupHandler(SIGNAL_ARGS);
171
static void log_disconnections(int code, Datum arg);
172 173 174


/* ----------------------------------------------------------------
175
 *		routines to obtain user input
176 177 178 179
 * ----------------------------------------------------------------
 */

/* ----------------
180
 *	InteractiveBackend() is called for user interactive connections
181 182 183
 *
 *	the string entered by the user is placed in its parameter inBuf,
 *	and we act like a Q message was received.
184
 *
185
 *	EOF is returned if end-of-file input is seen; time to shut down.
186 187 188
 * ----------------
 */

189
static int
190
InteractiveBackend(StringInfo inBuf)
191
{
192 193 194
	int			c;				/* character read from getc() */
	bool		end = false;	/* end-of-input flag */
	bool		backslashSeen = false;	/* have we seen a \ ? */
195

196 197
	/*
	 * display a prompt and obtain input from the user
198
	 */
199
	printf("backend> ");
200
	fflush(stdout);
201

202 203 204
	/* Reset inBuf to empty */
	inBuf->len = 0;
	inBuf->data[0] = '\0';
205
	inBuf->cursor = 0;
206

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

238
				appendStringInfoChar(inBuf, (char) c);
239 240 241 242 243 244 245
			}

			if (c == EOF)
				end = true;
		}
		else
		{
246 247
			/*
			 * otherwise read characters until EOF.
248 249
			 */
			while ((c = getc(stdin)) != EOF)
250
				appendStringInfoChar(inBuf, (char) c);
251

252
			if (inBuf->len == 0)
253 254 255 256
				end = true;
		}

		if (end)
257
			return EOF;
258

259 260
		/*
		 * otherwise we have a user query so process it.
261 262 263 264
		 */
		break;
	}

265 266 267
	/* Add '\0' to make it look the same as message case. */
	appendStringInfoChar(inBuf, (char) '\0');

268 269
	/*
	 * if the query echo flag was given, print the query..
270 271
	 */
	if (EchoQuery)
272
		printf("statement: %s\n", inBuf->data);
273
	fflush(stdout);
274

275
	return 'Q';
276 277 278
}

/* ----------------
279
 *	SocketBackend()		Is called for frontend-backend connections
280
 *
281
 *	Returns the message type code, and loads message body data into inBuf.
282
 *
283
 *	EOF is returned if the connection is lost.
284 285
 * ----------------
 */
286
static int
287
SocketBackend(StringInfo inBuf)
288
{
289
	int			qtype;
290

291
	/*
292
	 * Get message type code from the frontend.
293
	 */
294
	qtype = pq_getbyte();
295

296 297
	if (qtype == EOF)			/* frontend disconnected */
	{
298 299 300
		ereport(COMMERROR,
				(errcode(ERRCODE_PROTOCOL_VIOLATION),
				 errmsg("unexpected EOF on client connection")));
301 302 303 304
		return qtype;
	}

	/*
B
Bruce Momjian 已提交
305 306 307
	 * 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.
308
	 *
309 310
	 * This also gives us a place to set the doing_extended_query_message flag
	 * as soon as possible.
311
	 */
312
	switch (qtype)
313
	{
314
		case 'Q':				/* simple query */
315
			doing_extended_query_message = false;
316 317 318 319 320
			if (PG_PROTOCOL_MAJOR(FrontendProtocol) < 3)
			{
				/* old style without length word; convert */
				if (pq_getstring(inBuf))
				{
321 322
					ereport(COMMERROR,
							(errcode(ERRCODE_PROTOCOL_VIOLATION),
B
Bruce Momjian 已提交
323
							 errmsg("unexpected EOF on client connection")));
324 325 326
					return EOF;
				}
			}
327 328
			break;

329
		case 'F':				/* fastpath function call */
330 331
			/* we let fastpath.c cope with old-style input of this */
			doing_extended_query_message = false;
332
			break;
333

334
		case 'X':				/* terminate */
335
			doing_extended_query_message = false;
336
			ignore_till_sync = false;
337 338 339 340 341 342 343 344 345 346 347
			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)
348 349
				ereport(FATAL,
						(errcode(ERRCODE_PROTOCOL_VIOLATION),
B
Bruce Momjian 已提交
350
						 errmsg("invalid frontend message type %d", qtype)));
351 352 353 354 355 356 357 358 359
			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)
360 361
				ereport(FATAL,
						(errcode(ERRCODE_PROTOCOL_VIOLATION),
B
Bruce Momjian 已提交
362
						 errmsg("invalid frontend message type %d", qtype)));
363
			break;
364

365 366 367
		case 'd':				/* copy data */
		case 'c':				/* copy done */
		case 'f':				/* copy fail */
368 369 370
			doing_extended_query_message = false;
			/* these are only legal in protocol 3 */
			if (PG_PROTOCOL_MAJOR(FrontendProtocol) < 3)
371 372
				ereport(FATAL,
						(errcode(ERRCODE_PROTOCOL_VIOLATION),
B
Bruce Momjian 已提交
373
						 errmsg("invalid frontend message type %d", qtype)));
374
			break;
375

376
		default:
B
Bruce Momjian 已提交
377

378
			/*
B
Bruce Momjian 已提交
379 380 381
			 * 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.
382
			 */
383 384 385
			ereport(FATAL,
					(errcode(ERRCODE_PROTOCOL_VIOLATION),
					 errmsg("invalid frontend message type %d", qtype)));
386
			break;
387
	}
388

389
	/*
B
Bruce Momjian 已提交
390 391 392
	 * 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.
393 394 395 396 397 398 399
	 */
	if (PG_PROTOCOL_MAJOR(FrontendProtocol) >= 3)
	{
		if (pq_getmessage(inBuf, 0))
			return EOF;			/* suitable message already logged */
	}

400
	return qtype;
401 402 403
}

/* ----------------
404
 *		ReadCommand reads a command from either the frontend or
405 406 407
 *		standard input, places it in inBuf, and returns the
 *		message type code (first byte of the message).
 *		EOF is returned if end of file.
408 409
 * ----------------
 */
410
static int
411
ReadCommand(StringInfo inBuf)
412
{
413
	int			result;
414

415
	if (whereToSendOutput == DestRemote)
416
		result = SocketBackend(inBuf);
417
	else
418 419
		result = InteractiveBackend(inBuf);
	return result;
420 421
}

422 423 424 425 426 427 428 429 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
/*
 * 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();
	}
}

468 469 470 471 472 473

/*
 * 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.
474 475 476
 *
 * NOTE: this routine is no longer used for processing interactive queries,
 * but it is still needed for parsing of SQL function bodies.
477
 */
478
List *
B
Bruce Momjian 已提交
479
pg_parse_and_rewrite(const char *query_string,	/* string to execute */
480
					 Oid *paramTypes,	/* parameter types */
B
Bruce Momjian 已提交
481
					 int numParams)		/* number of parameters */
482
{
483
	List	   *raw_parsetree_list;
484
	List	   *querytree_list;
485
	ListCell   *list_item;
486

487 488
	/*
	 * (1) parse the request string into a list of raw parse trees.
489
	 */
490
	raw_parsetree_list = pg_parse_query(query_string);
491

492 493
	/*
	 * (2) Do parse analysis and rule rewrite.
494 495 496 497
	 */
	querytree_list = NIL;
	foreach(list_item, raw_parsetree_list)
	{
B
Bruce Momjian 已提交
498
		Node	   *parsetree = (Node *) lfirst(list_item);
499

500
		querytree_list = list_concat(querytree_list,
B
Bruce Momjian 已提交
501 502 503
									 pg_analyze_and_rewrite(parsetree,
															paramTypes,
															numParams));
504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521
	}

	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.
 */
522
List *
523
pg_parse_query(const char *query_string)
524
{
525
	List	   *raw_parsetree_list;
526

B
Rename:  
Bruce Momjian 已提交
527
	if (log_parser_stats)
528 529
		ResetUsage();

530
	raw_parsetree_list = raw_parser(query_string);
531

532 533 534 535 536 537 538 539
	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 已提交
540
				char **prepare_string)
541 542 543 544 545 546
{
	ListCell   *parsetree_item;
	bool		log_this_statement = (log_statement == LOGSTMT_ALL);

	*prepare_string = NULL;

B
Bruce Momjian 已提交
547
	/* Check if we need to log the statement, and get prepare_string. */
548
	foreach(parsetree_item, raw_parsetree_list)
549
	{
550 551 552 553 554 555 556 557 558 559
		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);

560 561
		if (IsA(parsetree, SelectStmt) &&
			((SelectStmt *) parsetree)->into == NULL)
B
Bruce Momjian 已提交
562
			continue;			/* optimization for frequent command */
563 564 565 566 567 568 569

		if (log_statement == LOGSTMT_MOD &&
			(IsA(parsetree, InsertStmt) ||
			 IsA(parsetree, UpdateStmt) ||
			 IsA(parsetree, DeleteStmt) ||
			 IsA(parsetree, TruncateStmt) ||
			 (IsA(parsetree, CopyStmt) &&
B
Bruce Momjian 已提交
570
			  ((CopyStmt *) parsetree)->is_from)))		/* COPY FROM */
571 572 573 574 575 576
			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 已提交
577
			 IsA(parsetree, SelectStmt) ||		/* SELECT INTO, CREATE AS */
578 579
			 strncmp(commandTag, "ALTER ", strlen("ALTER ")) == 0 ||
			 strncmp(commandTag, "DROP ", strlen("DROP ")) == 0 ||
B
Bruce Momjian 已提交
580
			 IsA(parsetree, GrantStmt) ||		/* GRANT or REVOKE */
581 582 583 584
			 IsA(parsetree, CommentStmt)))
			log_this_statement = true;

		/*
B
Bruce Momjian 已提交
585 586
		 * For the first EXECUTE we find, record the client statement used by
		 * the PREPARE.
587 588
		 */
		if (IsA(parsetree, ExecuteStmt))
589
		{
590 591 592 593 594
			ExecuteStmt *stmt = (ExecuteStmt *) parsetree;
			PreparedStatement *entry;

			if ((entry = FetchPreparedStatement(stmt->name, false)) != NULL &&
				entry->query_string)
595
			{
596
				*prepare_string = palloc(strlen(entry->query_string) +
597 598
									  strlen("  [protocol PREPARE:  %s]") - 1);
				sprintf(*prepare_string, "  [protocol PREPARE:  %s]",
B
Bruce Momjian 已提交
599
						entry->query_string);
600 601 602
			}
		}
	}
B
Bruce Momjian 已提交
603

604 605 606 607 608 609 610 611 612
	if (log_this_statement)
	{
		ereport(LOG,
				(errmsg("statement: %s%s", query_string,
						*prepare_string ? *prepare_string : "")));
		return true;
	}
	else
		return false;
613 614
}

615

616
/*
617 618
 * Given a raw parsetree (gram.y output), and optionally information about
 * types of parameter symbols ($n), perform parse analysis and rule rewriting.
619 620 621 622 623 624
 *
 * 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.
 */
625
List *
626
pg_analyze_and_rewrite(Node *parsetree, Oid *paramTypes, int numParams)
627 628 629
{
	List	   *querytree_list;

630 631
	/*
	 * (1) Perform parse analysis.
632
	 */
B
Rename:  
Bruce Momjian 已提交
633
	if (log_parser_stats)
634 635
		ResetUsage();

636
	querytree_list = parse_analyze(parsetree, paramTypes, numParams);
637

B
Rename:  
Bruce Momjian 已提交
638
	if (log_parser_stats)
639
		ShowUsage("PARSE ANALYSIS STATISTICS");
640

641 642
	/*
	 * (2) Rewrite the queries, as necessary
643 644 645 646 647 648 649 650
	 */
	querytree_list = pg_rewrite_queries(querytree_list);

	return querytree_list;
}

/*
 * Perform rewriting of a list of queries produced by parse analysis.
651 652 653
 *
 * Note: queries must just have come from the parser, because we do not do
 * AcquireRewriteLocks() on them.
654
 */
655
static List *
656 657 658
pg_rewrite_queries(List *querytree_list)
{
	List	   *new_list = NIL;
659
	ListCell   *list_item;
660 661 662 663 664

	if (log_parser_stats)
		ResetUsage();

	/*
B
Bruce Momjian 已提交
665 666
	 * rewritten queries are collected in new_list.  Note there may be more or
	 * fewer than in the original list.
667
	 */
668
	foreach(list_item, querytree_list)
669
	{
670
		Query	   *querytree = (Query *) lfirst(list_item);
671

672
		if (Debug_print_parse)
673
			elog_node_display(DEBUG1, "parse tree", querytree,
674
							  Debug_pretty_print);
675 676 677

		if (querytree->commandType == CMD_UTILITY)
		{
678 679
			/* don't rewrite utilities, just dump 'em into new_list */
			new_list = lappend(new_list, querytree);
680
		}
681
		else
682
		{
683
			/* rewrite regular queries */
684 685
			List	   *rewritten = QueryRewrite(querytree);

686
			new_list = list_concat(new_list, rewritten);
687 688 689 690 691
		}
	}

	querytree_list = new_list;

B
Rename:  
Bruce Momjian 已提交
692
	if (log_parser_stats)
693
		ShowUsage("REWRITER STATISTICS");
694

695
#ifdef COPY_PARSE_PLAN_TREES
B
Bruce Momjian 已提交
696 697

	/*
B
Bruce Momjian 已提交
698
	 * Optional debugging check: pass querytree output through copyObject()
B
Bruce Momjian 已提交
699
	 */
700 701
	new_list = (List *) copyObject(querytree_list);
	/* This checks both copyObject() and the equal() routines... */
B
Bruce Momjian 已提交
702
	if (!equal(new_list, querytree_list))
703
		elog(WARNING, "copyObject() failed to produce an equal parse tree");
704 705
	else
		querytree_list = new_list;
706 707
#endif

708
	if (Debug_print_rewritten)
709
		elog_node_display(DEBUG1, "rewritten parse tree", querytree_list,
710
						  Debug_pretty_print);
711

712 713
	return querytree_list;
}
714 715


716
/* Generate a plan for a single already-rewritten query. */
717
Plan *
718
pg_plan_query(Query *querytree, ParamListInfo boundParams)
719 720
{
	Plan	   *plan;
721

722 723 724
	/* Utility commands have no plans. */
	if (querytree->commandType == CMD_UTILITY)
		return NULL;
725

B
Rename:  
Bruce Momjian 已提交
726
	if (log_planner_stats)
727
		ResetUsage();
728

729
	/* call the optimizer */
730
	plan = planner(querytree, false, 0, boundParams);
731

B
Rename:  
Bruce Momjian 已提交
732
	if (log_planner_stats)
733
		ShowUsage("PLANNER STATISTICS");
734

735 736 737
#ifdef COPY_PARSE_PLAN_TREES
	/* Optional debugging check: pass plan output through copyObject() */
	{
B
Bruce Momjian 已提交
738
		Plan	   *new_plan = (Plan *) copyObject(plan);
739

B
Bruce Momjian 已提交
740
		/*
B
Bruce Momjian 已提交
741 742
		 * equal() currently does not have routines to compare Plan nodes, so
		 * don't try to test equality here.  Perhaps fix someday?
743 744 745
		 */
#ifdef NOT_USED
		/* This checks both copyObject() and the equal() routines... */
B
Bruce Momjian 已提交
746
		if (!equal(new_plan, plan))
747
			elog(WARNING, "copyObject() failed to produce an equal plan tree");
748 749 750 751 752 753
		else
#endif
			plan = new_plan;
	}
#endif

754 755
	/*
	 * Print plan if debugging.
756
	 */
757
	if (Debug_print_plan)
758
		elog_node_display(DEBUG1, "plan", plan, Debug_pretty_print);
759

760
	return plan;
761 762
}

763 764
/*
 * Generate plans for a list of already-rewritten queries.
765
 *
766 767 768 769 770 771 772 773 774
 * 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 *
775 776
pg_plan_queries(List *querytrees, ParamListInfo boundParams,
				bool needSnapshot)
777 778
{
	List	   *plan_list = NIL;
779
	ListCell   *query_list;
780 781 782 783 784 785 786 787 788 789 790 791 792 793 794

	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)
			{
795
				ActiveSnapshot = CopySnapshot(GetTransactionSnapshot());
796 797
				needSnapshot = false;
			}
798
			plan = pg_plan_query(query, boundParams);
799 800 801 802 803 804 805 806 807 808
		}

		plan_list = lappend(plan_list, plan);
	}

	return plan_list;
}


/*
809
 * exec_simple_query
810
 *
811
 * Execute a "simple Query" protocol message.
812
 */
813
static void
814
exec_simple_query(const char *query_string)
815
{
B
Bruce Momjian 已提交
816
	CommandDest dest = whereToSendOutput;
817
	MemoryContext oldcontext;
818 819
	List	   *parsetree_list;
	ListCell   *parsetree_item;
B
Bruce Momjian 已提交
820 821
	struct timeval start_t,
				stop_t;
B
Rename:  
Bruce Momjian 已提交
822
	bool		save_log_duration = log_duration;
B
Bruce Momjian 已提交
823
	int			save_log_min_duration_statement = log_min_duration_statement;
824
	bool		save_log_statement_stats = log_statement_stats;
B
Bruce Momjian 已提交
825
	char	   *prepare_string = NULL;
826
	bool		was_logged = false;
B
Bruce Momjian 已提交
827

828 829 830
	/*
	 * Report query to various monitoring facilities.
	 */
831
	debug_query_string = query_string;
832

833 834
	pgstat_report_activity(query_string);

835
	/*
B
Bruce Momjian 已提交
836
	 * We use save_log_* so "SET log_duration = true"  and "SET
B
Bruce Momjian 已提交
837 838 839
	 * log_min_duration_statement = true" don't report incorrect time because
	 * gettimeofday() wasn't called. Similarly, log_statement_stats has to be
	 * captured once.
840
	 */
841
	if (save_log_duration || save_log_min_duration_statement != -1)
842
		gettimeofday(&start_t, NULL);
843

844 845 846
	if (save_log_statement_stats)
		ResetUsage();

847
	/*
B
Bruce Momjian 已提交
848 849
	 * 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 已提交
850 851 852
	 * 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.)
853 854
	 */
	start_xact_command();
855 856

	/*
B
Bruce Momjian 已提交
857 858 859 860
	 * 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.)
861 862 863 864 865 866 867 868
	 */
	unnamed_stmt_pstmt = NULL;
	if (unnamed_stmt_context)
	{
		DropDependentPortals(unnamed_stmt_context);
		MemoryContextDelete(unnamed_stmt_context);
	}
	unnamed_stmt_context = NULL;
869

870 871 872
	/*
	 * Switch to appropriate context for constructing parsetrees.
	 */
873
	oldcontext = MemoryContextSwitchTo(MessageContext);
874

875 876
	QueryContext = CurrentMemoryContext;

B
Bruce Momjian 已提交
877
	/*
B
Bruce Momjian 已提交
878 879
	 * Do basic parsing of the query or queries (this should be safe even if
	 * we are in aborted transaction state!)
880
	 */
881
	parsetree_list = pg_parse_query(query_string);
882

883 884
	if (log_statement != LOGSTMT_NONE || save_log_min_duration_statement != -1)
		was_logged = log_after_parse(parsetree_list, query_string,
B
Bruce Momjian 已提交
885
									 &prepare_string);
886

887
	/*
888
	 * Switch back to transaction context to enter the loop.
889 890 891 892
	 */
	MemoryContextSwitchTo(oldcontext);

	/*
893
	 * Run through the raw parsetree(s) and process each one.
894
	 */
895
	foreach(parsetree_item, parsetree_list)
896
	{
B
Bruce Momjian 已提交
897
		Node	   *parsetree = (Node *) lfirst(parsetree_item);
898 899
		const char *commandTag;
		char		completionTag[COMPLETION_TAG_BUFSIZE];
B
Bruce Momjian 已提交
900
		List	   *querytree_list,
901 902
				   *plantree_list;
		Portal		portal;
903 904
		DestReceiver *receiver;
		int16		format;
905

906
		/*
B
Bruce Momjian 已提交
907 908 909 910
		 * 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.
911 912 913 914 915
		 */
		commandTag = CreateCommandTag(parsetree);

		set_ps_display(commandTag);

916
		BeginCommand(commandTag, dest);
917

918
		/*
919
		 * If we are in an aborted transaction, reject all commands except
B
Bruce Momjian 已提交
920 921 922 923 924
		 * 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...)
925
		 */
926 927 928 929 930
		if (IsAbortedTransactionBlockState() &&
			!IsTransactionExitStmt(parsetree))
			ereport(ERROR,
					(errcode(ERRCODE_IN_FAILED_SQL_TRANSACTION),
					 errmsg("current transaction is aborted, "
B
Bruce Momjian 已提交
931
						"commands ignored until end of transaction block")));
932

933
		/* Make sure we are in a transaction command */
934
		start_xact_command();
935

936
		/* If we got a cancel signal in parsing or prior command, quit */
937
		CHECK_FOR_INTERRUPTS();
938 939

		/*
940
		 * OK to analyze, rewrite, and plan this query.
941
		 *
B
Bruce Momjian 已提交
942 943
		 * Switch to appropriate context for constructing querytrees (again,
		 * these must outlive the execution context).
944
		 */
945
		oldcontext = MemoryContextSwitchTo(MessageContext);
946

947
		querytree_list = pg_analyze_and_rewrite(parsetree, NULL, 0);
V
Vadim B. Mikheev 已提交
948

949
		plantree_list = pg_plan_queries(querytree_list, NULL, true);
950 951 952 953

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

954
		/*
B
Bruce Momjian 已提交
955 956
		 * Create unnamed portal to run the query or queries in. If there
		 * already is one, silently drop it.
957
		 */
958
		portal = CreatePortal("", true, true);
959

960 961 962 963 964 965
		PortalDefineQuery(portal,
						  query_string,
						  commandTag,
						  querytree_list,
						  plantree_list,
						  MessageContext);
966

967
		/*
968
		 * Start the portal.  No parameters here.
969
		 */
970
		PortalStart(portal, NULL, InvalidSnapshot);
971

972
		/*
B
Bruce Momjian 已提交
973 974 975 976
		 * 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...)
977 978 979 980 981 982 983 984 985 986 987 988
		 */
		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 已提交
989
					format = 1; /* BINARY */
990 991 992 993 994 995 996 997 998 999 1000 1001 1002 1003 1004
			}
		}
		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 已提交
1005
		 * Run the portal to completion, and then drop it (and the receiver).
1006
		 */
1007 1008
		(void) PortalRun(portal,
						 FETCH_ALL,
1009 1010
						 receiver,
						 receiver,
1011
						 completionTag);
1012

1013
		(*receiver->rDestroy) (receiver);
1014

1015
		PortalDrop(portal, false);
1016

1017
		if (IsA(parsetree, TransactionStmt))
1018
		{
1019
			/*
B
Bruce Momjian 已提交
1020 1021
			 * If this was a transaction control statement, commit it. We will
			 * start a new xact command for the next command (if any).
1022
			 */
1023
			finish_xact_command();
1024
		}
1025
		else if (lnext(parsetree_item) == NULL)
1026
		{
1027
			/*
B
Bruce Momjian 已提交
1028 1029 1030 1031 1032 1033 1034 1035
			 * 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.
1036
			 */
1037
			finish_xact_command();
1038
		}
1039
		else
1040
		{
1041
			/*
B
Bruce Momjian 已提交
1042 1043
			 * We need a CommandCounterIncrement after every query, except
			 * those that start or end a transaction block.
1044 1045
			 */
			CommandCounterIncrement();
1046
		}
1047 1048

		/*
B
Bruce Momjian 已提交
1049 1050 1051 1052
		 * 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.)
1053
		 */
1054
		EndCommand(completionTag, dest);
B
Bruce Momjian 已提交
1055
	}							/* end loop over parsetrees */
1056

1057 1058 1059 1060 1061
	/*
	 * Close down transaction statement, if one is open.
	 */
	finish_xact_command();

1062 1063 1064
	/*
	 * If there were no parsetrees, return EmptyQueryResponse message.
	 */
1065
	if (!parsetree_list)
1066 1067
		NullCommand(dest);

1068
	QueryContext = NULL;
1069

1070
	/*
B
Bruce Momjian 已提交
1071 1072
	 * Combine processing here as we need to calculate the query duration in
	 * both instances.
1073
	 */
1074
	if (save_log_duration || save_log_min_duration_statement != -1)
1075
	{
B
Bruce Momjian 已提交
1076 1077
		long		usecs;

1078
		gettimeofday(&stop_t, NULL);
1079 1080 1081 1082 1083
		if (stop_t.tv_usec < start_t.tv_usec)
		{
			stop_t.tv_sec--;
			stop_t.tv_usec += 1000000;
		}
1084
		usecs = (long) (stop_t.tv_sec - start_t.tv_sec) * 1000000 +
B
Bruce Momjian 已提交
1085
			(long) (stop_t.tv_usec - start_t.tv_usec);
B
Bruce Momjian 已提交
1086

1087
		/* Only print duration if we previously printed the statement. */
1088
		if (was_logged && save_log_duration)
B
Bruce Momjian 已提交
1089 1090
			ereport(LOG,
					(errmsg("duration: %ld.%03ld ms",
B
Bruce Momjian 已提交
1091 1092 1093
							(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 已提交
1094

B
Bruce Momjian 已提交
1095
		/*
B
Bruce Momjian 已提交
1096 1097
		 * 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 已提交
1098
		 */
B
Bruce Momjian 已提交
1099 1100 1101
		if (save_log_min_duration_statement == 0 ||
			(save_log_min_duration_statement > 0 &&
			 usecs >= save_log_min_duration_statement * 1000))
1102
			ereport(LOG,
1103
					(errmsg("duration: %ld.%03ld ms  statement: %s%s",
B
Bruce Momjian 已提交
1104 1105 1106
							(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,
1107 1108
							query_string,
							prepare_string ? prepare_string : "")));
1109
	}
1110

1111 1112 1113
	if (save_log_statement_stats)
		ShowUsage("QUERY STATISTICS");

1114 1115 1116
	if (prepare_string != NULL)
		pfree(prepare_string);

1117
	debug_query_string = NULL;
1118 1119
}

1120 1121 1122 1123 1124 1125 1126 1127
/*
 * 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 已提交
1128 1129
				   Oid *paramTypes,		/* parameter types */
				   int numParams)		/* number of parameters */
1130 1131 1132 1133 1134 1135 1136 1137 1138 1139 1140 1141 1142 1143 1144 1145 1146 1147 1148 1149 1150 1151
{
	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();

1152 1153
	if (log_statement == LOGSTMT_ALL)
		ereport(LOG,
1154
				(errmsg("statement: [protocol] PREPARE %s AS %s",
1155 1156
						(*stmt_name != '\0') ? stmt_name : "<unnamed>",
						query_string)));
1157

1158
	/*
B
Bruce Momjian 已提交
1159 1160 1161
	 * 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.
1162 1163 1164 1165 1166 1167
	 */
	start_xact_command();

	/*
	 * Switch to appropriate context for constructing parsetrees.
	 *
B
Bruce Momjian 已提交
1168 1169 1170
	 * 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 已提交
1171 1172 1173 1174 1175 1176
	 * 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.
1177 1178 1179 1180 1181 1182 1183 1184 1185 1186 1187 1188 1189 1190 1191 1192 1193 1194 1195 1196 1197 1198 1199 1200 1201 1202 1203 1204 1205 1206
	 */
	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 已提交
1207 1208
	 * Do basic parsing of the query or queries (this should be safe even if
	 * we are in aborted transaction state!)
1209 1210 1211 1212
	 */
	parsetree_list = pg_parse_query(query_string);

	/*
B
Bruce Momjian 已提交
1213 1214 1215
	 * 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.
1216
	 */
1217
	if (list_length(parsetree_list) > 1)
1218 1219
		ereport(ERROR,
				(errcode(ERRCODE_SYNTAX_ERROR),
B
Bruce Momjian 已提交
1220
		errmsg("cannot insert multiple commands into a prepared statement")));
1221 1222 1223

	if (parsetree_list != NIL)
	{
1224
		Node	   *parsetree = (Node *) linitial(parsetree_list);
B
Bruce Momjian 已提交
1225
		int			i;
1226 1227 1228 1229 1230 1231 1232 1233

		/*
		 * 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 已提交
1234 1235 1236 1237 1238
		 * 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...)
1239
		 */
1240 1241 1242 1243 1244
		if (IsAbortedTransactionBlockState() &&
			!IsTransactionExitStmt(parsetree))
			ereport(ERROR,
					(errcode(ERRCODE_IN_FAILED_SQL_TRANSACTION),
					 errmsg("current transaction is aborted, "
B
Bruce Momjian 已提交
1245
						"commands ignored until end of transaction block")));
1246 1247 1248

		/*
		 * OK to analyze, rewrite, and plan this query.  Note that the
B
Bruce Momjian 已提交
1249 1250
		 * originally specified parameter set is not required to be complete,
		 * so we have to use parse_analyze_varparams().
1251 1252 1253 1254 1255 1256 1257 1258 1259 1260 1261 1262 1263 1264 1265
		 */
		if (log_parser_stats)
			ResetUsage();

		querytree_list = parse_analyze_varparams(parsetree,
												 &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 已提交
1266
			Oid			ptype = paramTypes[i];
1267 1268

			if (ptype == InvalidOid || ptype == UNKNOWNOID)
1269 1270
				ereport(ERROR,
						(errcode(ERRCODE_INDETERMINATE_DATATYPE),
B
Bruce Momjian 已提交
1271 1272
					 errmsg("could not determine data type of parameter $%d",
							i + 1)));
1273
			param_list = lappend_oid(param_list, ptype);
1274 1275 1276 1277 1278 1279 1280
		}

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

		querytree_list = pg_rewrite_queries(querytree_list);

1281
		/*
B
Bruce Momjian 已提交
1282 1283
		 * If this is the unnamed statement and it has parameters, defer query
		 * planning until Bind.  Otherwise do it now.
1284 1285 1286 1287 1288
		 */
		if (!is_named && numParams > 0)
			plantree_list = NIL;
		else
			plantree_list = pg_plan_queries(querytree_list, NULL, true);
1289 1290 1291
	}
	else
	{
B
Bruce Momjian 已提交
1292
		/* Empty input string.	This is legal. */
1293 1294 1295 1296 1297 1298 1299 1300 1301 1302 1303 1304 1305 1306 1307 1308 1309 1310 1311
		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,
1312 1313
							   param_list,
							   false);
1314 1315 1316 1317 1318 1319 1320 1321 1322 1323 1324 1325 1326
	}
	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;
1327
		pstmt->from_sql = false;
1328 1329 1330 1331 1332 1333 1334 1335 1336 1337
		pstmt->context = unnamed_stmt_context;
		/* Now the unnamed statement is complete and valid */
		unnamed_stmt_pstmt = pstmt;
	}

	MemoryContextSwitchTo(oldcontext);

	QueryContext = NULL;

	/*
B
Bruce Momjian 已提交
1338 1339 1340
	 * 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.
1341 1342 1343 1344 1345 1346
	 */
	CommandCounterIncrement();

	/*
	 * Send ParseComplete.
	 */
1347
	if (whereToSendOutput == DestRemote)
1348 1349 1350 1351 1352 1353 1354 1355 1356 1357 1358 1359 1360 1361 1362 1363 1364 1365
		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;
1366 1367
	int			numPFormats;
	int16	   *pformats = NULL;
1368
	int			numParams;
1369 1370 1371
	int			numRFormats;
	int16	   *rformats = NULL;
	int			i;
1372 1373 1374 1375 1376 1377 1378 1379 1380
	PreparedStatement *pstmt;
	Portal		portal;
	ParamListInfo params;

	pgstat_report_activity("<BIND>");

	set_ps_display("BIND");

	/*
B
Bruce Momjian 已提交
1381 1382 1383
	 * 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.
1384 1385 1386
	 */
	start_xact_command();

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

1390 1391 1392 1393
	/* Get the fixed part of the message */
	portal_name = pq_getmsgstring(input_message);
	stmt_name = pq_getmsgstring(input_message);

1394 1395 1396 1397 1398 1399 1400 1401 1402 1403 1404 1405 1406
	/* 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)
1407 1408
		ereport(ERROR,
				(errcode(ERRCODE_PROTOCOL_VIOLATION),
B
Bruce Momjian 已提交
1409 1410
			errmsg("bind message has %d parameter formats but %d parameters",
				   numPFormats, numParams)));
1411 1412 1413 1414 1415 1416 1417 1418 1419

	/* 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)
1420 1421
			ereport(ERROR,
					(errcode(ERRCODE_UNDEFINED_PSTATEMENT),
B
Bruce Momjian 已提交
1422
					 errmsg("unnamed prepared statement does not exist")));
1423 1424
	}

1425
	if (numParams != list_length(pstmt->argtype_list))
1426 1427 1428
		ereport(ERROR,
				(errcode(ERRCODE_PROTOCOL_VIOLATION),
				 errmsg("bind message supplies %d parameters, but prepared statement \"%s\" requires %d",
B
Bruce Momjian 已提交
1429
				   numParams, stmt_name, list_length(pstmt->argtype_list))));
1430

1431 1432
	/*
	 * If we are in aborted transaction state, the only portals we can
1433 1434 1435 1436 1437
	 * 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.
1438 1439 1440 1441 1442 1443 1444 1445 1446
	 */
	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")));

1447
	/*
B
Bruce Momjian 已提交
1448 1449
	 * Create the portal.  Allow silent replacement of an existing portal only
	 * if the unnamed portal is specified.
1450 1451 1452 1453 1454 1455
	 */
	if (portal_name[0] == '\0')
		portal = CreatePortal(portal_name, true, true);
	else
		portal = CreatePortal(portal_name, false, false);

1456
	/* We need to output the parameter values someday */
1457 1458
	if (log_statement == LOGSTMT_ALL)
		ereport(LOG,
1459
				(errmsg("statement: [protocol] <BIND> %s", portal_name)));
1460

1461 1462 1463 1464 1465
	/*
	 * Fetch parameters, if any, and store in the portal's memory context.
	 */
	if (numParams > 0)
	{
1466
		ListCell   *l;
1467 1468 1469 1470 1471 1472 1473
		MemoryContext oldContext;

		oldContext = MemoryContextSwitchTo(PortalGetHeapMemory(portal));

		params = (ParamListInfo)
			palloc0((numParams + 1) * sizeof(ParamListInfoData));

1474
		i = 0;
1475 1476
		foreach(l, pstmt->argtype_list)
		{
1477
			Oid			ptype = lfirst_oid(l);
1478
			int32		plength;
1479 1480
			bool		isNull;

1481 1482 1483
			plength = pq_getmsgint(input_message, 4);
			isNull = (plength == -1);

1484 1485
			if (!isNull)
			{
1486
				const char *pvalue = pq_getmsgbytes(input_message, plength);
1487 1488 1489 1490 1491 1492 1493 1494 1495 1496 1497 1498 1499
				int16		pformat;
				StringInfoData pbuf;
				char		csave;

				if (numPFormats > 1)
					pformat = pformats[i];
				else if (numPFormats > 0)
					pformat = pformats[0];
				else
					pformat = 0;	/* default = text */

				/*
				 * Rather than copying data around, we just set up a phony
1500 1501 1502 1503 1504
				 * 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.
1505 1506 1507 1508 1509 1510 1511 1512 1513 1514
				 */
				pbuf.data = (char *) pvalue;
				pbuf.maxlen = plength + 1;
				pbuf.len = plength;
				pbuf.cursor = 0;

				csave = pbuf.data[plength];
				pbuf.data[plength] = '\0';

				if (pformat == 0)
1515
				{
1516 1517 1518 1519 1520 1521 1522
					Oid			typinput;
					Oid			typioparam;
					char	   *pstring;

					getTypeInputInfo(ptype, &typinput, &typioparam);

					/*
1523 1524
					 * We have to do encoding conversion before calling the
					 * typinput routine.
1525 1526 1527 1528 1529 1530 1531 1532 1533 1534
					 */
					pstring = pg_client_to_server(pbuf.data, plength);
					params[i].value =
						OidFunctionCall3(typinput,
										 CStringGetDatum(pstring),
										 ObjectIdGetDatum(typioparam),
										 Int32GetDatum(-1));
					/* Free result of encoding conversion, if any */
					if (pstring != pbuf.data)
						pfree(pstring);
1535
				}
1536
				else if (pformat == 1)
1537
				{
1538 1539
					Oid			typreceive;
					Oid			typioparam;
1540

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

1546 1547 1548 1549 1550
					params[i].value =
						OidFunctionCall3(typreceive,
										 PointerGetDatum(&pbuf),
										 ObjectIdGetDatum(typioparam),
										 Int32GetDatum(-1));
1551

1552 1553
					/* Trouble if it didn't eat the whole buffer */
					if (pbuf.cursor != pbuf.len)
1554
						ereport(ERROR,
1555 1556 1557
							 (errcode(ERRCODE_INVALID_BINARY_REPRESENTATION),
							  errmsg("incorrect binary data format in bind parameter %d",
									 i + 1)));
1558 1559 1560 1561 1562 1563 1564
				}
				else
				{
					ereport(ERROR,
							(errcode(ERRCODE_INVALID_PARAMETER_VALUE),
							 errmsg("unsupported format code: %d",
									pformat)));
1565
				}
1566 1567 1568

				/* Restore message buffer contents */
				pbuf.data[plength] = csave;
1569
			}
1570

1571 1572
			params[i].kind = PARAM_NUM;
			params[i].id = i + 1;
1573
			params[i].ptype = ptype;
1574 1575 1576 1577 1578 1579 1580 1581 1582 1583 1584 1585
			params[i].isnull = isNull;

			i++;
		}

		params[i].kind = PARAM_INVALID;

		MemoryContextSwitchTo(oldContext);
	}
	else
		params = NULL;

1586 1587 1588 1589 1590 1591 1592 1593 1594
	/* 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);
	}

1595 1596 1597
	pq_getmsgend(input_message);

	/*
B
Bruce Momjian 已提交
1598 1599
	 * 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.
1600
	 *
B
Bruce Momjian 已提交
1601 1602
	 * This happens only for unnamed statements, and so switching into the
	 * statement context for planning is correct (see notes in
1603
	 * exec_parse_message).
1604
	 */
1605
	if (pstmt->plan_list == NIL && pstmt->query_list != NIL)
1606 1607 1608 1609 1610 1611 1612 1613 1614 1615 1616 1617 1618 1619 1620 1621 1622
	{
		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);

1623
	PortalStart(portal, params, InvalidSnapshot);
1624

1625 1626 1627 1628 1629
	/*
	 * Apply the result format requests to the portal.
	 */
	PortalSetResultFormat(portal, numRFormats, rformats);

1630 1631 1632
	/*
	 * Send BindComplete.
	 */
1633
	if (whereToSendOutput == DestRemote)
1634 1635 1636 1637 1638 1639 1640 1641 1642
		pq_putemptymessage('2');
}

/*
 * exec_execute_message
 *
 * Process an "Execute" message for a portal
 */
static void
1643
exec_execute_message(const char *portal_name, long max_rows)
1644
{
B
Bruce Momjian 已提交
1645
	CommandDest dest;
1646
	DestReceiver *receiver;
1647 1648 1649
	Portal		portal;
	bool		completed;
	char		completionTag[COMPLETION_TAG_BUFSIZE];
B
Bruce Momjian 已提交
1650 1651
	struct timeval start_t,
				stop_t;
1652 1653 1654
	bool		save_log_duration = log_duration;
	int			save_log_min_duration_statement = log_min_duration_statement;
	bool		save_log_statement_stats = log_statement_stats;
1655
	bool		execute_is_fetch = false;
1656 1657 1658

	/* Adjust destination to tell printtup.c what to do */
	dest = whereToSendOutput;
1659 1660
	if (dest == DestRemote)
		dest = DestRemoteExecute;
1661 1662 1663

	portal = GetPortalByName(portal_name);
	if (!PortalIsValid(portal))
1664 1665 1666
		ereport(ERROR,
				(errcode(ERRCODE_UNDEFINED_CURSOR),
				 errmsg("portal \"%s\" does not exist", portal_name)));
1667

1668
	/*
B
Bruce Momjian 已提交
1669 1670 1671 1672
	 * 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.
1673 1674 1675 1676
	 */
	if (!portal->atStart)
		execute_is_fetch = true;

1677
	/*
B
Bruce Momjian 已提交
1678 1679
	 * If the original query was a null string, just return
	 * EmptyQueryResponse.
1680 1681 1682 1683 1684 1685 1686 1687
	 */
	if (portal->commandTag == NULL)
	{
		Assert(portal->parseTrees == NIL);
		NullCommand(dest);
		return;
	}

1688 1689 1690 1691 1692 1693 1694
	/* Should we display the portal names here? */
	if (execute_is_fetch)
	{
		debug_query_string = "fetch message";
		pgstat_report_activity("<FETCH>");
	}
	else if (portal->sourceText)
1695 1696 1697 1698 1699 1700 1701 1702 1703 1704 1705 1706
	{
		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);

1707 1708
	/*
	 * We use save_log_* so "SET log_duration = true"  and "SET
B
Bruce Momjian 已提交
1709 1710 1711
	 * log_min_duration_statement = true" don't report incorrect time because
	 * gettimeofday() wasn't called. Similarly, log_statement_stats has to be
	 * captured once.
1712 1713 1714 1715 1716 1717 1718 1719 1720 1721
	 */
	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,
1722
				(errmsg("statement: [protocol] %sEXECUTE %s  [PREPARE:  %s]",
1723
						(execute_is_fetch) ? "FETCH from " : "",
1724
						(*portal_name != '\0') ? portal_name : "<unnamed>",
1725 1726
						portal->sourceText ? portal->sourceText : "")));

1727 1728
	BeginCommand(portal->commandTag, dest);

1729
	/*
B
Bruce Momjian 已提交
1730 1731
	 * Create dest receiver in MessageContext (we don't want it in transaction
	 * context, because that may get deleted if portal contains VACUUM).
1732 1733 1734
	 */
	receiver = CreateDestReceiver(dest, portal);

1735
	/*
B
Bruce Momjian 已提交
1736 1737
	 * Ensure we are in a transaction command (this should normally be the
	 * case already due to prior BIND).
1738 1739 1740 1741 1742 1743 1744
	 */
	start_xact_command();

	/*
	 * If we are in aborted transaction state, the only portals we can
	 * actually run are those containing COMMIT or ROLLBACK commands.
	 */
1745 1746 1747 1748 1749
	if (IsAbortedTransactionBlockState() &&
		!IsTransactionExitStmtList(portal->parseTrees))
		ereport(ERROR,
				(errcode(ERRCODE_IN_FAILED_SQL_TRANSACTION),
				 errmsg("current transaction is aborted, "
B
Bruce Momjian 已提交
1750
						"commands ignored until end of transaction block")));
1751 1752 1753 1754 1755 1756 1757 1758 1759 1760 1761 1762

	/* 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,
1763 1764
						  receiver,
						  receiver,
1765 1766
						  completionTag);

1767
	(*receiver->rDestroy) (receiver);
1768

1769 1770
	if (completed)
	{
1771
		if (IsTransactionStmtList(portal->parseTrees))
1772 1773
		{
			/*
B
Bruce Momjian 已提交
1774
			 * If this was a transaction control statement, commit it.	We
B
Bruce Momjian 已提交
1775
			 * will start a new xact command for the next command (if any).
1776
			 */
1777
			finish_xact_command();
1778 1779 1780 1781
		}
		else
		{
			/*
B
Bruce Momjian 已提交
1782 1783
			 * We need a CommandCounterIncrement after every query, except
			 * those that start or end a transaction block.
1784 1785 1786 1787 1788 1789 1790 1791 1792 1793
			 */
			CommandCounterIncrement();
		}

		/* Send appropriate CommandComplete to client */
		EndCommand(completionTag, dest);
	}
	else
	{
		/* Portal run not complete, so send PortalSuspended */
1794
		if (whereToSendOutput == DestRemote)
1795 1796 1797
			pq_putemptymessage('s');
	}

1798
	/*
B
Bruce Momjian 已提交
1799 1800
	 * Combine processing here as we need to calculate the query duration in
	 * both instances.
1801 1802 1803 1804 1805 1806 1807 1808 1809 1810 1811 1812
	 */
	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 已提交
1813
			(long) (stop_t.tv_usec - start_t.tv_usec);
1814 1815 1816 1817 1818

		/* 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 已提交
1819 1820 1821
							(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)));
1822 1823

		/*
B
Bruce Momjian 已提交
1824 1825
		 * Output a duration_statement to the log if the query has exceeded
		 * the min duration, or if we are to print all durations.
1826 1827 1828 1829 1830
		 */
		if (save_log_min_duration_statement == 0 ||
			(save_log_min_duration_statement > 0 &&
			 usecs >= save_log_min_duration_statement * 1000))
			ereport(LOG,
1831
					(errmsg("duration: %ld.%03ld ms  statement: [protocol] %sEXECUTE %s  [PREPARE:  %s]",
B
Bruce Momjian 已提交
1832 1833 1834
							(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,
1835
							(execute_is_fetch) ? "FETCH from " : "",
B
Bruce Momjian 已提交
1836
						  (*portal_name != '\0') ? portal_name : "<unnamed>",
1837 1838 1839 1840 1841 1842
							portal->sourceText ? portal->sourceText : "")));
	}

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

1843 1844 1845 1846 1847 1848 1849 1850 1851 1852 1853 1854
	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;
1855
	TupleDesc	tupdesc;
1856
	ListCell   *l;
1857 1858
	StringInfoData buf;

1859 1860 1861 1862 1863 1864 1865 1866 1867
	/*
	 * Start up a transaction command. (Note that this will normally change
	 * current memory context.) Nothing happens if we are already in one.
	 */
	start_xact_command();

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

1868 1869 1870 1871 1872 1873 1874 1875
	/* 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)
1876 1877
			ereport(ERROR,
					(errcode(ERRCODE_UNDEFINED_PSTATEMENT),
B
Bruce Momjian 已提交
1878
					 errmsg("unnamed prepared statement does not exist")));
1879 1880
	}

1881 1882 1883 1884 1885 1886 1887 1888 1889 1890 1891 1892 1893 1894 1895 1896
	/*
	 * 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")));

1897
	if (whereToSendOutput != DestRemote)
1898 1899
		return;					/* can't actually do anything... */

1900 1901 1902
	/*
	 * First describe the parameters...
	 */
B
Bruce Momjian 已提交
1903
	pq_beginmessage(&buf, 't'); /* parameter description message type */
1904
	pq_sendint(&buf, list_length(pstmt->argtype_list), 2);
1905 1906 1907

	foreach(l, pstmt->argtype_list)
	{
1908
		Oid			ptype = lfirst_oid(l);
1909 1910 1911 1912

		pq_sendint(&buf, (int) ptype, 4);
	}
	pq_endmessage(&buf);
1913 1914 1915 1916 1917 1918

	/*
	 * Next send RowDescription or NoData to describe the result...
	 */
	tupdesc = FetchPreparedStatementResultDesc(pstmt);
	if (tupdesc)
1919 1920 1921
		SendRowDescriptionMessage(tupdesc,
								  FetchPreparedStatementTargetList(pstmt),
								  NULL);
1922 1923 1924
	else
		pq_putemptymessage('n');	/* NoData */

1925 1926 1927 1928 1929 1930 1931 1932 1933 1934 1935 1936
}

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

1937 1938 1939 1940 1941 1942 1943 1944 1945
	/*
	 * Start up a transaction command. (Note that this will normally change
	 * current memory context.) Nothing happens if we are already in one.
	 */
	start_xact_command();

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

1946 1947
	portal = GetPortalByName(portal_name);
	if (!PortalIsValid(portal))
1948 1949 1950
		ereport(ERROR,
				(errcode(ERRCODE_UNDEFINED_CURSOR),
				 errmsg("portal \"%s\" does not exist", portal_name)));
1951

1952 1953 1954 1955 1956 1957 1958 1959 1960 1961 1962 1963 1964 1965 1966
	/*
	 * 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")));

1967
	if (whereToSendOutput != DestRemote)
1968 1969 1970
		return;					/* can't actually do anything... */

	if (portal->tupDesc)
1971 1972
		SendRowDescriptionMessage(portal->tupDesc,
								  FetchPortalTargetList(portal),
1973
								  portal->formats);
1974 1975 1976 1977 1978
	else
		pq_putemptymessage('n');	/* NoData */
}


1979 1980 1981 1982 1983 1984
/*
 * Convenience routines for starting/committing a single command.
 */
static void
start_xact_command(void)
{
1985 1986
	if (!xact_started)
	{
1987 1988
		ereport(DEBUG3,
				(errmsg_internal("StartTransactionCommand")));
1989
		StartTransactionCommand();
1990 1991 1992 1993

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

1997 1998
		xact_started = true;
	}
1999 2000 2001
}

static void
2002
finish_xact_command(void)
2003
{
2004 2005 2006 2007
	if (xact_started)
	{
		/* Cancel any active statement timeout before committing */
		disable_sig_alarm(true);
2008

2009
		/* Now commit the command */
2010 2011
		ereport(DEBUG3,
				(errmsg_internal("CommitTransactionCommand")));
2012

2013
		CommitTransactionCommand();
2014

2015 2016 2017 2018 2019 2020
#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

2021
#ifdef SHOW_MEMORY_STATS
2022
		/* Print mem stats after each commit for leak tracking */
2023 2024
		if (ShowStats)
			MemoryContextStats(TopMemoryContext);
2025
#endif
2026 2027 2028

		xact_started = false;
	}
2029 2030 2031
}


2032 2033 2034 2035 2036 2037 2038 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 2069 2070 2071 2072 2073 2074 2075 2076 2077 2078 2079 2080 2081
/*
 * 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;
}


2082
/* --------------------------------
2083
 *		signal handler routines used in PostgresMain()
2084 2085 2086
 * --------------------------------
 */

2087
/*
T
Tom Lane 已提交
2088
 * quickdie() occurs when signalled SIGQUIT by the postmaster.
2089 2090 2091 2092
 *
 * Some backend has bought the farm,
 * so we need to stop what we're doing and exit.
 */
T
Tom Lane 已提交
2093
void
2094
quickdie(SIGNAL_ARGS)
2095
{
2096
	PG_SETMASK(&BlockSig);
B
Bruce Momjian 已提交
2097

2098
	/*
B
Bruce Momjian 已提交
2099 2100
	 * Ideally this should be ereport(FATAL), but then we'd not get control
	 * back...
2101 2102 2103
	 */
	ereport(WARNING,
			(errcode(ERRCODE_CRASH_SHUTDOWN),
B
Bruce Momjian 已提交
2104
			 errmsg("terminating connection because of crash of another server process"),
B
Bruce Momjian 已提交
2105 2106 2107 2108
	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."),
2109
			 errhint("In a moment you should be able to reconnect to the"
2110
					 " database and repeat your command.")));
B
Bruce Momjian 已提交
2111

2112
	/*
2113
	 * DO NOT proc_exit() -- we're here because shared memory may be
B
Bruce Momjian 已提交
2114 2115
	 * corrupted, so we don't want to try to clean up our transaction. Just
	 * nail the windows shut and get out of town.
2116
	 *
B
Bruce Momjian 已提交
2117 2118 2119 2120
	 * 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.
2121
	 */
2122
	exit(1);
2123 2124
}

2125
/*
2126 2127
 * Shutdown signal from postmaster: abort transaction and exit
 * at soonest convenient time
2128
 */
2129
void
2130
die(SIGNAL_ARGS)
2131
{
2132 2133 2134
	int			save_errno = errno;

	/* Don't joggle the elbow of proc_exit */
B
Bruce Momjian 已提交
2135
	if (!proc_exit_inprogress)
2136
	{
2137
		InterruptPending = true;
2138
		ProcDiePending = true;
B
Bruce Momjian 已提交
2139

2140
		/*
B
Bruce Momjian 已提交
2141 2142
		 * If it's safe to interrupt, and we're waiting for input or a lock,
		 * service the interrupt immediately
2143
		 */
2144 2145
		if (ImmediateInterruptOK && InterruptHoldoffCount == 0 &&
			CritSectionCount == 0)
2146
		{
2147 2148 2149
			/* bump holdoff count to make ProcessInterrupts() a no-op */
			/* until we are done getting ready for it */
			InterruptHoldoffCount++;
2150
			DisableNotifyInterrupt();
2151
			DisableCatchupInterrupt();
2152
			/* Make sure CheckDeadLock won't run while shutting down... */
2153
			LockWaitCancel();
2154
			InterruptHoldoffCount--;
2155 2156
			ProcessInterrupts();
		}
2157
	}
2158 2159

	errno = save_errno;
2160 2161
}

2162
/*
2163
 * Timeout or shutdown signal from postmaster during client authentication.
2164
 * Simply exit(0).
2165 2166 2167
 *
 * XXX: possible future improvement: try to send a message indicating
 * why we are disconnecting.  Problem is to be sure we don't block while
2168
 * doing so, nor mess up the authentication message exchange.
2169 2170 2171 2172 2173 2174 2175
 */
void
authdie(SIGNAL_ARGS)
{
	exit(0);
}

2176
/*
2177 2178
 * Query-cancel signal from postmaster: abort current transaction
 * at soonest convenient time
2179
 */
2180
void
2181
StatementCancelHandler(SIGNAL_ARGS)
2182
{
2183 2184
	int			save_errno = errno;

B
Bruce Momjian 已提交
2185
	/*
2186
	 * Don't joggle the elbow of proc_exit
B
Bruce Momjian 已提交
2187
	 */
2188
	if (!proc_exit_inprogress)
2189
	{
2190 2191
		InterruptPending = true;
		QueryCancelPending = true;
B
Bruce Momjian 已提交
2192

2193
		/*
B
Bruce Momjian 已提交
2194 2195 2196
		 * 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.
2197
		 */
2198
		if (ImmediateInterruptOK && InterruptHoldoffCount == 0 &&
2199
			CritSectionCount == 0)
2200
		{
2201 2202 2203 2204 2205 2206
			/* bump holdoff count to make ProcessInterrupts() a no-op */
			/* until we are done getting ready for it */
			InterruptHoldoffCount++;
			if (LockWaitCancel())
			{
				DisableNotifyInterrupt();
2207
				DisableCatchupInterrupt();
T
Tom Lane 已提交
2208
				InterruptHoldoffCount--;
2209 2210 2211 2212
				ProcessInterrupts();
			}
			else
				InterruptHoldoffCount--;
2213
		}
2214 2215
	}

2216
	errno = save_errno;
2217 2218
}

2219
/* signal handler for floating point exception */
2220
void
2221 2222
FloatExceptionHandler(SIGNAL_ARGS)
{
2223 2224 2225
	ereport(ERROR,
			(errcode(ERRCODE_FLOATING_POINT_EXCEPTION),
			 errmsg("floating-point exception"),
B
Bruce Momjian 已提交
2226 2227 2228
			 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.")));
2229 2230
}

2231
/* SIGHUP: set flag to re-read config file at next convenient time */
2232
static void
2233
SigHupHandler(SIGNAL_ARGS)
2234
{
2235
	got_SIGHUP = true;
2236 2237
}

2238

2239 2240 2241 2242 2243 2244 2245 2246 2247 2248
/*
 * 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)
{
2249 2250
	/* OK to accept interrupt now? */
	if (InterruptHoldoffCount != 0 || CritSectionCount != 0)
2251 2252 2253 2254 2255
		return;
	InterruptPending = false;
	if (ProcDiePending)
	{
		ProcDiePending = false;
B
Bruce Momjian 已提交
2256 2257
		QueryCancelPending = false;		/* ProcDie trumps QueryCancel */
		ImmediateInterruptOK = false;	/* not idle anymore */
2258
		DisableNotifyInterrupt();
2259
		DisableCatchupInterrupt();
2260 2261
		ereport(FATAL,
				(errcode(ERRCODE_ADMIN_SHUTDOWN),
B
Bruce Momjian 已提交
2262
			 errmsg("terminating connection due to administrator command")));
2263 2264 2265 2266
	}
	if (QueryCancelPending)
	{
		QueryCancelPending = false;
B
Bruce Momjian 已提交
2267
		ImmediateInterruptOK = false;	/* not idle anymore */
2268
		DisableNotifyInterrupt();
2269
		DisableCatchupInterrupt();
2270 2271 2272 2273 2274 2275 2276 2277
		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")));
2278 2279 2280 2281
	}
	/* If we get here, do nothing (probably, QueryCancelPending was reset) */
}

2282

2283 2284 2285 2286 2287 2288 2289 2290 2291 2292 2293 2294 2295
/*
 * 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 已提交
2296 2297
	char		stack_top_loc;
	int			stack_depth;
2298 2299 2300 2301

	/*
	 * Compute distance from PostgresMain's local variables to my own
	 *
B
Bruce Momjian 已提交
2302 2303 2304
	 * 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.
2305 2306
	 */
	stack_depth = (int) (stack_base_ptr - &stack_top_loc);
B
Bruce Momjian 已提交
2307

2308
	/*
B
Bruce Momjian 已提交
2309
	 * Take abs value, since stacks grow up on some machines, down on others
2310 2311 2312
	 */
	if (stack_depth < 0)
		stack_depth = -stack_depth;
B
Bruce Momjian 已提交
2313

2314 2315 2316
	/*
	 * Trouble?
	 *
2317 2318 2319 2320
	 * 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.
2321 2322 2323 2324 2325 2326 2327 2328 2329 2330 2331 2332 2333 2334 2335 2336 2337 2338 2339 2340 2341 2342
	 */
	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;
}


2343
static void
2344
usage(const char *progname)
2345
{
2346
	printf(_("%s is the PostgreSQL stand-alone backend.  It is not\nintended to be used by normal users.\n\n"), progname);
2347

2348
	printf(_("Usage:\n  %s [OPTION]... DBNAME\n\n"), progname);
2349
	printf(_("Options:\n"));
M
 
Marc G. Fournier 已提交
2350
#ifdef USE_ASSERT_CHECKING
2351
	printf(_("  -A 1|0          enable/disable run-time assert checking\n"));
M
 
Marc G. Fournier 已提交
2352
#endif
2353 2354
	printf(_("  -B NBUFFERS     number of shared buffers\n"));
	printf(_("  -c NAME=VALUE   set run-time parameter\n"));
2355
	printf(_("  -d 0-5          debugging level\n"));
2356 2357
	printf(_("  -D DATADIR      database directory\n"));
	printf(_("  -e              use European date input format (DMY)\n"));
2358
	printf(_("  -E              echo statement before execution\n"));
2359
	printf(_("  -F              turn fsync off\n"));
2360 2361
	printf(_("  -j              do not use newline as interactive query delimiter\n"));
	printf(_("  -r FILENAME     send stdout and stderr to given file\n"));
2362 2363
	printf(_("  -s              show statistics after each query\n"));
	printf(_("  -S WORK-MEM     set amount of memory for sorts (in kB)\n"));
2364
	printf(_("  --NAME=VALUE    set run-time parameter\n"));
2365 2366 2367 2368 2369 2370
	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"));
2371
	printf(_("  -P              disable system indexes\n"));
2372 2373 2374
	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"));
2375 2376
}

2377

2378 2379 2380 2381 2382 2383 2384 2385 2386 2387 2388 2389 2390 2391 2392 2393 2394 2395 2396 2397 2398 2399 2400 2401 2402 2403 2404 2405 2406 2407 2408 2409 2410 2411 2412
/*
 * 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);
}


2413 2414 2415 2416 2417 2418 2419 2420 2421 2422 2423 2424 2425 2426 2427 2428 2429 2430 2431 2432 2433 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 2472
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;
}


2473
/* ----------------------------------------------------------------
2474
 * PostgresMain
B
Bruce Momjian 已提交
2475
 *	   postgres main loop -- all backends, interactive or otherwise start here
2476
 *
2477 2478 2479 2480
 * 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.
2481 2482 2483
 * ----------------------------------------------------------------
 */
int
2484
PostgresMain(int argc, char *argv[], const char *username)
2485
{
2486
	int			flag;
2487
	const char *dbname = NULL;
2488
	char	   *userDoption = NULL;
2489
	bool		secure;
2490
	int			errs = 0;
B
Bruce Momjian 已提交
2491 2492
	int			debug_flag = -1;	/* -1 means not given */
	List	   *guc_names = NIL;	/* for SUSET options */
2493 2494
	List	   *guc_values = NIL;
	GucContext	ctx;
2495
	GucSource	gucsource;
2496
	bool		am_superuser;
2497
	int			firstchar;
2498
	char		stack_base;
B
Bruce Momjian 已提交
2499
	StringInfoData input_message;
2500
	sigjmp_buf	local_sigjmp_buf;
2501
	volatile bool send_ready_for_query = true;
B
Bruce Momjian 已提交
2502

2503 2504 2505 2506
#define PendingConfigOption(name,val) \
	(guc_names = lappend(guc_names, pstrdup(name)), \
	 guc_values = lappend(guc_values, pstrdup(val)))

2507
	/*
B
Bruce Momjian 已提交
2508 2509
	 * Catch standard options before doing much else.  This even works on
	 * systems without getopt_long.
2510 2511 2512
	 */
	if (!IsUnderPostmaster && argc > 1)
	{
B
Bruce Momjian 已提交
2513
		if (strcmp(argv[1], "--help") == 0 || strcmp(argv[1], "-?") == 0)
2514 2515 2516 2517
		{
			usage(argv[0]);
			exit(0);
		}
B
Bruce Momjian 已提交
2518
		if (strcmp(argv[1], "--version") == 0 || strcmp(argv[1], "-V") == 0)
2519
		{
2520
			puts(PG_VERSIONSTR);
2521 2522
			exit(0);
		}
B
Bruce Momjian 已提交
2523
	}
2524

2525 2526 2527 2528 2529 2530
	/*
	 * initialize globals (already done if under postmaster, but not if
	 * standalone; cheap enough to do over)
	 */
	MyProcPid = getpid();

2531 2532 2533 2534 2535
	/*
	 * Fire up essential subsystems: error and memory management
	 *
	 * If we are running under the postmaster, this is done already.
	 */
2536
	if (!IsUnderPostmaster)
2537 2538
		MemoryContextInit();

2539 2540
	set_ps_display("startup");

2541 2542
	SetProcessingMode(InitProcessing);

2543 2544 2545
	/* Set up reference point for stack depth checking */
	stack_base_ptr = &stack_base;

2546 2547 2548 2549 2550 2551 2552
	/* 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 已提交
2553

B
Bruce Momjian 已提交
2554 2555
	if (pkglib_path[0] == '\0')
		get_pkglib_path(my_exec_path, pkglib_path);
2556

2557
	/*
2558
	 * Set default values for command-line options.
2559
	 */
2560
	EchoQuery = false;
2561

2562
	if (!IsUnderPostmaster)
2563
		InitializeGUCOptions();
2564

2565 2566 2567 2568 2569 2570 2571 2572 2573 2574 2575 2576 2577 2578 2579 2580 2581
	/* ----------------
	 *	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.
	 * ----------------
	 */

2582 2583
	/* all options are allowed until '-p' */
	secure = true;
2584
	ctx = PGC_POSTMASTER;
2585
	gucsource = PGC_S_ARGV;		/* initial switches came from command line */
2586

2587
	while ((flag = getopt(argc, argv, "A:B:c:D:d:EeFf:h:ijk:lN:nOo:Pp:r:S:sTt:v:W:y:-:")) != -1)
2588
	{
2589 2590
		switch (flag)
		{
M
 
Marc G. Fournier 已提交
2591
			case 'A':
2592
				SetConfigOption("debug_assertions", optarg, ctx, gucsource);
M
 
Marc G. Fournier 已提交
2593
				break;
2594

2595
			case 'B':
2596
				SetConfigOption("shared_buffers", optarg, ctx, gucsource);
2597
				break;
2598

2599
			case 'D':
2600
				if (secure)
2601
					userDoption = optarg;
M
 
Marc G. Fournier 已提交
2602
				break;
2603

2604
			case 'd':
2605
				debug_flag = atoi(optarg);
2606
				break;
2607 2608

			case 'E':
2609
				EchoQuery = true;
2610
				break;
2611 2612

			case 'e':
2613
				SetConfigOption("datestyle", "euro", ctx, gucsource);
2614
				break;
2615 2616

			case 'F':
2617
				SetConfigOption("fsync", "false", ctx, gucsource);
2618
				break;
2619 2620

			case 'f':
2621 2622 2623
				if (!set_plan_disabling_options(optarg, ctx, gucsource))
					errs++;
				break;
2624

2625 2626
			case 'h':
				SetConfigOption("listen_addresses", optarg, ctx, gucsource);
2627 2628
				break;

2629 2630 2631
			case 'i':
				SetConfigOption("listen_addresses", "*", ctx, gucsource);
				break;
2632

2633
			case 'j':
2634 2635
				UseNewLine = 0;
				break;
2636

2637 2638 2639
			case 'k':
				SetConfigOption("unix_socket_directory", optarg, ctx, gucsource);
				break;
2640

2641 2642
			case 'l':
				SetConfigOption("ssl", "true", ctx, gucsource);
2643 2644
				break;

2645 2646 2647
			case 'N':
				SetConfigOption("max_connections", optarg, ctx, gucsource);
				break;
2648

2649 2650 2651 2652 2653 2654
			case 'n':
				/* ignored for consistency with postmaster */
				break;

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

T
Tom Lane 已提交
2657
			case 'o':
2658 2659
				errs++;
				break;
2660

2661 2662
			case 'P':
				SetConfigOption("ignore_system_indexes", "true", ctx, gucsource);
T
Tom Lane 已提交
2663 2664
				break;

2665
			case 'p':
2666 2667
				SetConfigOption("port", optarg, ctx, gucsource);
				break;
B
Bruce Momjian 已提交
2668

2669 2670
			case 'r':
				/* send output (stdout and stderr) to the given file */
2671
				if (secure)
2672
					StrNCpy(OutputFileName, optarg, MAXPGPATH);
2673
				break;
2674

2675
			case 'S':
2676
				SetConfigOption("work_mem", optarg, ctx, gucsource);
2677
				break;
2678 2679

			case 's':
2680
				/*
2681 2682
				 * Since log options are SUSET, we need to postpone unless
				 * still in secure context
2683
				 */
2684 2685 2686 2687 2688
				if (ctx == PGC_BACKEND)
					PendingConfigOption("log_statement_stats", "true");
				else
					SetConfigOption("log_statement_stats", "true",
									ctx, gucsource);
M
 
Marc G. Fournier 已提交
2689 2690
				break;

2691 2692 2693 2694
			case 'T':
				/* ignored for consistency with postmaster */
				break;

2695
			case 't':
2696 2697
			{
				const char *tmp = get_stats_option_name(optarg);
2698
				if (tmp)
2699 2700 2701 2702 2703 2704
				{
					if (ctx == PGC_BACKEND)
						PendingConfigOption(tmp, "true");
					else
						SetConfigOption(tmp, "true", ctx, gucsource);
				}
2705 2706
				else
					errs++;
2707
				break;
2708
			}
2709

2710
			case 'v':
2711 2712
				if (secure)
					FrontendProtocol = (ProtocolVersion) atoi(optarg);
2713 2714
				break;

M
 
Marc G. Fournier 已提交
2715
			case 'W':
2716 2717
				SetConfigOption("post_auth_delay", optarg, ctx, gucsource);
				break;
2718

2719 2720

			case 'y':
2721
				/*
2722 2723
				 * y - special flag passed if backend was forked by a
				 * postmaster.
M
 
Marc G. Fournier 已提交
2724
				 */
2725 2726 2727 2728 2729 2730 2731 2732
				if (secure)
				{
					dbname = strdup(optarg);

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

2735
			case 'c':
2736
			case '-':
2737
				{
B
Bruce Momjian 已提交
2738 2739
					char	   *name,
							   *value;
2740

B
Bruce Momjian 已提交
2741 2742 2743 2744
					ParseLongOption(optarg, &name, &value);
					if (!value)
					{
						if (flag == '-')
2745 2746 2747 2748
							ereport(ERROR,
									(errcode(ERRCODE_SYNTAX_ERROR),
									 errmsg("--%s requires a value",
											optarg)));
B
Bruce Momjian 已提交
2749
						else
2750 2751 2752 2753
							ereport(ERROR,
									(errcode(ERRCODE_SYNTAX_ERROR),
									 errmsg("-c %s requires a value",
											optarg)));
B
Bruce Momjian 已提交
2754 2755
					}

2756
					/*
B
Bruce Momjian 已提交
2757 2758
					 * If a SUSET option, must postpone evaluation, unless we
					 * are still reading secure switches.
2759 2760 2761 2762 2763
					 */
					if (ctx == PGC_BACKEND && IsSuperuserConfigOption(name))
						PendingConfigOption(name, value);
					else
						SetConfigOption(name, value, ctx, gucsource);
B
Bruce Momjian 已提交
2764 2765 2766 2767 2768
					free(name);
					if (value)
						free(value);
					break;
				}
2769

2770 2771
			default:
				errs++;
T
Tom Lane 已提交
2772
				break;
2773
		}
2774 2775
	}

2776
	/*
B
Bruce Momjian 已提交
2777 2778
	 * Process any additional GUC variable settings passed in startup packet.
	 * These are handled exactly like command-line variables.
2779 2780 2781 2782 2783 2784 2785 2786 2787 2788 2789 2790 2791 2792 2793 2794 2795 2796 2797 2798 2799 2800 2801
	 */
	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);
		}
	}

2802 2803
	/* Acquire configuration parameters, unless inherited from postmaster */
	if (!IsUnderPostmaster)
2804
	{
2805 2806
		if (!SelectConfigFiles(userDoption, argv[0]))
			proc_exit(1);
2807 2808
		/* If timezone is not set, determine what the OS uses */
		pg_timezone_initialize();
2809
	}
2810

2811 2812 2813
	if (PostAuthDelay)
		pg_usleep(PostAuthDelay * 1000000L);

2814
	/*
2815
	 * Set up signal handlers and masks.
2816
	 *
2817 2818 2819
	 * 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 已提交
2820
	 *
B
Bruce Momjian 已提交
2821 2822 2823 2824 2825 2826
	 * 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.)
2827
	 */
2828
	pqsignal(SIGHUP, SigHupHandler);	/* set flag to read config file */
B
Bruce Momjian 已提交
2829
	pqsignal(SIGINT, StatementCancelHandler);	/* cancel current query */
2830
	pqsignal(SIGTERM, die);		/* cancel current query and exit */
2831
	pqsignal(SIGQUIT, quickdie);	/* hard crash time */
B
Bruce Momjian 已提交
2832
	pqsignal(SIGALRM, handle_sig_alarm);		/* timeout conditions */
2833 2834 2835 2836

	/*
	 * Ignore failure to write to frontend. Note: if frontend closes
	 * connection, we will notice it and exit cleanly when control next
B
Bruce Momjian 已提交
2837 2838
	 * returns to outer loop.  This seems safer than forcing exit in the midst
	 * of output during who-knows-what operation...
2839 2840
	 */
	pqsignal(SIGPIPE, SIG_IGN);
2841 2842
	pqsignal(SIGUSR1, CatchupInterruptHandler);
	pqsignal(SIGUSR2, NotifyInterruptHandler);
2843
	pqsignal(SIGFPE, FloatExceptionHandler);
2844 2845

	/*
B
Bruce Momjian 已提交
2846
	 * Reset some signals that are accepted by postmaster but not by backend
2847
	 */
B
Bruce Momjian 已提交
2848
	pqsignal(SIGCHLD, SIG_DFL); /* system() requires this on some platforms */
2849

2850 2851
	pqinitmask();

T
Tom Lane 已提交
2852
	/* We allow SIGQUIT (quickdie) at all times */
2853
#ifdef HAVE_SIGPROCMASK
T
Tom Lane 已提交
2854
	sigdelset(&BlockSig, SIGQUIT);
2855
#else
T
Tom Lane 已提交
2856
	BlockSig &= ~(sigmask(SIGQUIT));
2857 2858
#endif

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

2861
	if (IsUnderPostmaster)
2862
	{
2863
		/* noninteractive case: nothing should be left after switches */
2864
		if (errs || argc != optind || dbname == NULL)
2865
		{
2866 2867
			ereport(FATAL,
					(errcode(ERRCODE_SYNTAX_ERROR),
B
Bruce Momjian 已提交
2868 2869
				 errmsg("invalid command-line arguments for server process"),
			   errhint("Try \"%s --help\" for more information.", argv[0])));
2870
		}
2871

2872
		BaseInit();
2873
	}
2874
	else
2875
	{
2876 2877 2878
		/* interactive case: database name can be last arg on command line */
		if (errs || argc - optind > 1)
		{
2879 2880 2881 2882
			ereport(FATAL,
					(errcode(ERRCODE_SYNTAX_ERROR),
					 errmsg("%s: invalid command-line arguments",
							argv[0]),
B
Bruce Momjian 已提交
2883
			   errhint("Try \"%s --help\" for more information.", argv[0])));
2884 2885
		}
		else if (argc - optind == 1)
2886 2887
			dbname = argv[optind];
		else if ((dbname = username) == NULL)
2888
		{
2889 2890 2891 2892
			ereport(FATAL,
					(errcode(ERRCODE_INVALID_PARAMETER_VALUE),
					 errmsg("%s: no database nor user name specified",
							argv[0])));
2893
		}
2894

2895
		/*
B
Bruce Momjian 已提交
2896 2897
		 * Validate we have been given a reasonable-looking DataDir (if under
		 * postmaster, assume postmaster did this already).
2898
		 */
2899
		Assert(DataDir);
2900 2901
		ValidatePgVersion(DataDir);

2902 2903 2904
		/* Change into DataDir (if under postmaster, was done already) */
		ChangeToDataDir();

2905
		/*
2906
		 * Create lockfile for data directory.
2907
		 */
2908
		CreateDataDirLockFile(false);
2909

2910
		BaseInit();
2911 2912 2913 2914 2915

		/*
		 * Start up xlog for standalone backend, and register to have it
		 * closed down at exit.
		 */
2916
		StartupXLOG();
2917
		on_shmem_exit(ShutdownXLOG, 0);
2918 2919

		/*
B
Bruce Momjian 已提交
2920 2921
		 * Read any existing FSM cache file, and register to write one out at
		 * exit.
2922 2923 2924
		 */
		LoadFreeSpaceMap();
		on_shmem_exit(DumpFreeSpaceMap, 0);
2925 2926

		/*
B
Bruce Momjian 已提交
2927 2928
		 * 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.
2929 2930
		 */
		BuildFlatFiles(true);
2931 2932
	}

2933 2934 2935 2936 2937 2938 2939 2940 2941 2942 2943 2944 2945
	/*
	 * 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

2946
	/*
2947 2948
	 * General initialization.
	 *
2949 2950 2951
	 * 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.
2952
	 */
2953 2954
	ereport(DEBUG3,
			(errmsg_internal("InitPostgres")));
2955
	am_superuser = InitPostgres(dbname, username);
2956

2957
	SetProcessingMode(NormalProcessing);
2958

2959
	/*
2960 2961
	 * Now that we know if client is a superuser, we can try to apply SUSET
	 * GUC options that came from the client.
2962 2963 2964 2965 2966 2967 2968 2969 2970 2971 2972 2973 2974 2975 2976 2977 2978 2979 2980 2981 2982 2983 2984 2985 2986 2987 2988 2989
	 */
	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();

2990
	/*
B
Bruce Momjian 已提交
2991 2992
	 * Also set up handler to log session end; we have to wait till now to be
	 * sure Log_disconnections has its final value.
2993 2994 2995 2996
	 */
	if (IsUnderPostmaster && Log_disconnections)
		on_proc_exit(log_disconnections, 0);

2997 2998
	/*
	 * Send this backend's cancellation info to the frontend.
2999
	 */
3000
	if (whereToSendOutput == DestRemote &&
M
 
Marc G. Fournier 已提交
3001 3002
		PG_PROTOCOL_MAJOR(FrontendProtocol) >= 2)
	{
3003
		StringInfoData buf;
B
Bruce Momjian 已提交
3004

3005
		pq_beginmessage(&buf, 'K');
3006 3007 3008
		pq_sendint(&buf, (int32) MyProcPid, sizeof(int32));
		pq_sendint(&buf, (int32) MyCancelKey, sizeof(int32));
		pq_endmessage(&buf);
M
 
Marc G. Fournier 已提交
3009 3010 3011
		/* Need not flush since ReadyForQuery will do it. */
	}

3012
	/* Welcome banner for standalone case */
3013
	if (whereToSendOutput == DestDebug)
3014
		printf("\nPostgreSQL stand-alone backend %s\n", PG_VERSION);
3015

3016 3017 3018
	/*
	 * Create the memory context we will use in the main loop.
	 *
3019 3020
	 * MessageContext is reset once per iteration of the main loop, ie, upon
	 * completion of processing of each command message from the client.
3021
	 */
3022 3023 3024 3025 3026
	MessageContext = AllocSetContextCreate(TopMemoryContext,
										   "MessageContext",
										   ALLOCSET_DEFAULT_MINSIZE,
										   ALLOCSET_DEFAULT_INITSIZE,
										   ALLOCSET_DEFAULT_MAXSIZE);
3027

3028
	/*
3029
	 * Remember stand-alone backend startup time
3030 3031
	 */
	if (!IsUnderPostmaster)
3032
		PgStartTime = GetCurrentTimestamp();
3033

3034 3035
	/*
	 * POSTGRES main processing loop begins here
3036
	 *
B
Bruce Momjian 已提交
3037 3038
	 * If an exception is encountered, processing resumes here so we abort the
	 * current transaction and start a new one.
3039
	 *
3040 3041 3042 3043 3044 3045 3046
	 * 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.)
3047 3048
	 */

3049
	if (sigsetjmp(local_sigjmp_buf, 1) != 0)
3050
	{
3051
		/*
3052
		 * NOTE: if you are tempted to add more code in this if-block,
3053
		 * consider the high probability that it should be in
B
Bruce Momjian 已提交
3054
		 * AbortTransaction() instead.	The only stuff done directly here
B
Bruce Momjian 已提交
3055 3056
		 * should be stuff that is guaranteed to apply *only* for outer-level
		 * error recovery, such as adjusting the FE/BE protocol status.
3057 3058 3059 3060 3061 3062 3063 3064 3065
		 */

		/* 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 已提交
3066 3067
		 * Forget any pending QueryCancel request, since we're returning to
		 * the idle loop anyway, and cancel the statement timer if running.
3068 3069
		 */
		QueryCancelPending = false;
3070
		disable_sig_alarm(true);
B
Bruce Momjian 已提交
3071
		QueryCancelPending = false;		/* again in case timeout occurred */
3072 3073

		/*
B
Bruce Momjian 已提交
3074 3075 3076
		 * 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.
3077
		 */
3078
		DoingCommandRead = false;
3079
		DisableNotifyInterrupt();
3080
		DisableCatchupInterrupt();
3081

3082 3083 3084
		/* Make sure libpq is in a good state */
		pq_comm_reset();

3085 3086
		/* Report the error to the client and/or server log */
		EmitErrorReport();
3087

3088
		/*
B
Bruce Momjian 已提交
3089 3090
		 * Make sure debug_query_string gets reset before we possibly clobber
		 * the storage it points at.
3091
		 */
3092
		debug_query_string = NULL;
3093

3094
		/*
3095
		 * Abort the current transaction in order to recover.
3096
		 */
3097
		AbortCurrentTransaction();
3098 3099

		/*
B
Bruce Momjian 已提交
3100 3101
		 * Now return to normal top-level context and clear ErrorContext for
		 * next time.
3102 3103
		 */
		MemoryContextSwitchTo(TopMemoryContext);
3104
		FlushErrorState();
3105
		QueryContext = NULL;
3106

3107
		/*
B
Bruce Momjian 已提交
3108 3109
		 * If we were handling an extended-query-protocol message, initiate
		 * skip till next Sync.  This also causes us not to issue
B
Bruce Momjian 已提交
3110
		 * ReadyForQuery (until we get Sync).
3111 3112 3113
		 */
		if (doing_extended_query_message)
			ignore_till_sync = true;
3114

3115 3116 3117 3118
		/* We don't have a transaction command open anymore */
		xact_started = false;

		/* Now we can allow interrupts again */
3119
		RESUME_INTERRUPTS();
3120
	}
3121

3122 3123
	/* We can now handle ereport(ERROR) */
	PG_exception_stack = &local_sigjmp_buf;
3124

3125
	PG_SETMASK(&UnBlockSig);
3126

3127
	if (!ignore_till_sync)
3128
		send_ready_for_query = true;		/* initially, or after error */
3129

3130 3131
	/*
	 * Non-error queries loop here.
3132 3133 3134 3135
	 */

	for (;;)
	{
3136
		/*
B
Bruce Momjian 已提交
3137 3138
		 * At top of loop, reset extended-query-message flag, so that any
		 * errors encountered in "idle" state don't provoke skip.
3139 3140 3141
		 */
		doing_extended_query_message = false;

3142
		/*
B
Bruce Momjian 已提交
3143 3144
		 * Release storage left over from prior query cycle, and create a new
		 * query input buffer in the cleared MessageContext.
3145
		 */
3146 3147
		MemoryContextSwitchTo(MessageContext);
		MemoryContextResetAndDeleteChildren(MessageContext);
3148

3149
		initStringInfo(&input_message);
3150

3151
		/*
B
Bruce Momjian 已提交
3152 3153
		 * (1) If we've reached idle state, tell the frontend we're ready for
		 * a new query.
3154
		 *
3155
		 * Note: this includes fflush()'ing the last of the prior output.
3156 3157 3158
		 *
		 * 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 已提交
3159 3160 3161
		 * 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 已提交
3162
		 */
3163
		if (send_ready_for_query)
3164
		{
3165
			if (IsTransactionOrTransactionBlock())
3166 3167 3168 3169 3170 3171
			{
				set_ps_display("idle in transaction");
				pgstat_report_activity("<IDLE> in transaction");
			}
			else
			{
3172 3173
				pgstat_report_tabstat();

3174 3175 3176
				set_ps_display("idle");
				pgstat_report_activity("<IDLE>");
			}
3177

3178
			ReadyForQuery(whereToSendOutput);
3179
			send_ready_for_query = false;
3180
		}
3181

3182
		/*
B
Bruce Momjian 已提交
3183 3184 3185 3186
		 * (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.)
3187
		 */
3188 3189
		QueryCancelPending = false;		/* forget any earlier CANCEL signal */
		DoingCommandRead = true;
3190

3191 3192
		/*
		 * (3) read a command (loop blocks here)
3193
		 */
3194
		firstchar = ReadCommand(&input_message);
3195

3196 3197
		/*
		 * (4) disable async signal conditions again.
3198
		 */
3199
		DoingCommandRead = false;
3200

3201
		/*
B
Bruce Momjian 已提交
3202 3203
		 * (5) check for any other interesting events that happened while we
		 * slept.
3204 3205 3206 3207 3208 3209 3210
		 */
		if (got_SIGHUP)
		{
			got_SIGHUP = false;
			ProcessConfigFile(PGC_SIGHUP);
		}

3211
		/*
B
Bruce Momjian 已提交
3212 3213
		 * (6) process the command.  But ignore it if we're skipping till
		 * Sync.
3214
		 */
3215
		if (ignore_till_sync && firstchar != EOF)
3216 3217
			continue;

3218 3219
		switch (firstchar)
		{
3220
			case 'Q':			/* simple query */
3221
				{
3222 3223
					const char *query_string;

3224 3225
					query_string = pq_getmsgstring(&input_message);
					pq_getmsgend(&input_message);
3226

3227
					exec_simple_query(query_string);
3228

3229
					send_ready_for_query = true;
3230
				}
3231 3232
				break;

3233 3234 3235 3236 3237 3238 3239
			case 'P':			/* parse */
				{
					const char *stmt_name;
					const char *query_string;
					int			numParams;
					Oid		   *paramTypes = NULL;

3240 3241 3242
					stmt_name = pq_getmsgstring(&input_message);
					query_string = pq_getmsgstring(&input_message);
					numParams = pq_getmsgint(&input_message, 2);
3243 3244
					if (numParams > 0)
					{
B
Bruce Momjian 已提交
3245
						int			i;
3246 3247 3248

						paramTypes = (Oid *) palloc(numParams * sizeof(Oid));
						for (i = 0; i < numParams; i++)
3249
							paramTypes[i] = pq_getmsgint(&input_message, 4);
3250
					}
3251
					pq_getmsgend(&input_message);
3252 3253 3254 3255 3256 3257 3258

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

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

3260
				/*
B
Bruce Momjian 已提交
3261 3262
				 * this message is complex enough that it seems best to put
				 * the field extraction out-of-line
3263
				 */
3264
				exec_bind_message(&input_message);
3265 3266 3267 3268 3269
				break;

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

3272 3273 3274
					portal_name = pq_getmsgstring(&input_message);
					max_rows = pq_getmsgint(&input_message, 4);
					pq_getmsgend(&input_message);
3275

3276
					exec_execute_message(portal_name, max_rows);
3277 3278 3279
				}
				break;

3280 3281
			case 'F':			/* fastpath function call */
				/* Tell the collector what we're doing */
3282 3283
				pgstat_report_activity("<FASTPATH> function call");

3284
				/* start an xact for this function invocation */
3285
				start_xact_command();
3286

3287 3288 3289
				/* switch back to message context */
				MemoryContextSwitchTo(MessageContext);

3290 3291 3292
				/* set snapshot in case function needs one */
				ActiveSnapshot = CopySnapshot(GetTransactionSnapshot());

3293
				if (HandleFunctionRequest(&input_message) == EOF)
3294 3295
				{
					/* lost frontend connection during F message input */
B
Bruce Momjian 已提交
3296

3297
					/*
3298
					 * Reset whereToSendOutput to prevent ereport from
B
Bruce Momjian 已提交
3299
					 * attempting to send any more messages to client.
3300
					 */
3301 3302
					if (whereToSendOutput == DestRemote)
						whereToSendOutput = DestNone;
3303

3304
					proc_exit(0);
3305
				}
3306 3307

				/* commit the function-invocation transaction */
3308
				finish_xact_command();
3309

3310
				send_ready_for_query = true;
3311 3312
				break;

B
Bruce Momjian 已提交
3313
			case 'C':			/* close */
3314
				{
B
Bruce Momjian 已提交
3315
					int			close_type;
3316 3317
					const char *close_target;

3318 3319 3320
					close_type = pq_getmsgbyte(&input_message);
					close_target = pq_getmsgstring(&input_message);
					pq_getmsgend(&input_message);
3321 3322 3323 3324 3325 3326 3327 3328 3329 3330 3331 3332 3333 3334 3335 3336 3337 3338 3339 3340 3341 3342 3343 3344 3345 3346 3347 3348

					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:
3349 3350
							ereport(ERROR,
									(errcode(ERRCODE_PROTOCOL_VIOLATION),
B
Bruce Momjian 已提交
3351 3352
								   errmsg("invalid CLOSE message subtype %d",
										  close_type)));
3353 3354 3355
							break;
					}

3356
					if (whereToSendOutput == DestRemote)
B
Bruce Momjian 已提交
3357
						pq_putemptymessage('3');		/* CloseComplete */
3358 3359 3360 3361 3362
				}
				break;

			case 'D':			/* describe */
				{
B
Bruce Momjian 已提交
3363
					int			describe_type;
3364 3365
					const char *describe_target;

3366 3367 3368
					describe_type = pq_getmsgbyte(&input_message);
					describe_target = pq_getmsgstring(&input_message);
					pq_getmsgend(&input_message);
3369 3370 3371 3372 3373 3374 3375 3376 3377 3378

					switch (describe_type)
					{
						case 'S':
							exec_describe_statement_message(describe_target);
							break;
						case 'P':
							exec_describe_portal_message(describe_target);
							break;
						default:
3379 3380
							ereport(ERROR,
									(errcode(ERRCODE_PROTOCOL_VIOLATION),
B
Bruce Momjian 已提交
3381 3382
								errmsg("invalid DESCRIBE message subtype %d",
									   describe_type)));
3383 3384 3385 3386 3387
							break;
					}
				}
				break;

B
Bruce Momjian 已提交
3388
			case 'H':			/* flush */
3389
				pq_getmsgend(&input_message);
3390
				if (whereToSendOutput == DestRemote)
3391 3392 3393
					pq_flush();
				break;

B
Bruce Momjian 已提交
3394
			case 'S':			/* sync */
3395
				pq_getmsgend(&input_message);
3396
				finish_xact_command();
3397
				send_ready_for_query = true;
3398 3399
				break;

3400
				/*
B
Bruce Momjian 已提交
3401 3402 3403
				 * 'X' means that the frontend is closing down the socket. EOF
				 * means unexpected loss of frontend connection. Either way,
				 * perform normal shutdown.
3404 3405
				 */
			case 'X':
3406
			case EOF:
B
Bruce Momjian 已提交
3407

3408
				/*
B
Bruce Momjian 已提交
3409 3410
				 * Reset whereToSendOutput to prevent ereport from attempting
				 * to send any more messages to client.
3411
				 */
3412 3413
				if (whereToSendOutput == DestRemote)
					whereToSendOutput = DestNone;
B
Bruce Momjian 已提交
3414

3415 3416
				/*
				 * NOTE: if you are tempted to add more code here, DON'T!
B
Bruce Momjian 已提交
3417
				 * Whatever you had in mind to do should be set up as an
B
Bruce Momjian 已提交
3418 3419 3420
				 * on_proc_exit or on_shmem_exit callback, instead. Otherwise
				 * it will fail to be called during other backend-shutdown
				 * scenarios.
3421
				 */
3422
				proc_exit(0);
3423

B
Bruce Momjian 已提交
3424 3425 3426 3427
			case 'd':			/* copy data */
			case 'c':			/* copy done */
			case 'f':			/* copy fail */

3428
				/*
B
Bruce Momjian 已提交
3429
				 * Accept but ignore these messages, per protocol spec; we
B
Bruce Momjian 已提交
3430 3431
				 * probably got here because a COPY failed, and the frontend
				 * is still sending data.
3432 3433 3434
				 */
				break;

3435
			default:
3436 3437 3438 3439
				ereport(FATAL,
						(errcode(ERRCODE_PROTOCOL_VIOLATION),
						 errmsg("invalid frontend message type %d",
								firstchar)));
3440
		}
3441
	}							/* end of input-reading loop */
3442

3443 3444
	/* can't get here because the above loop never exits */
	Assert(false);
3445

3446
	return 1;					/* keep compiler quiet */
3447 3448
}

3449
#ifndef HAVE_GETRUSAGE
B
Bruce Momjian 已提交
3450 3451
#include "rusagestub.h"
#else
3452
#include <sys/resource.h>
3453
#endif   /* HAVE_GETRUSAGE */
3454

3455 3456
static struct rusage Save_r;
static struct timeval Save_t;
3457 3458

void
3459
ResetUsage(void)
3460
{
3461
	getrusage(RUSAGE_SELF, &Save_r);
3462
	gettimeofday(&Save_t, NULL);
3463
	ResetBufferUsage();
3464
	/* ResetTupleCount(); */
3465 3466 3467
}

void
3468
ShowUsage(const char *title)
3469
{
3470
	StringInfoData str;
3471 3472 3473 3474
	struct timeval user,
				sys;
	struct timeval elapse_t;
	struct rusage r;
B
Bruce Momjian 已提交
3475
	char	   *bufusage;
3476 3477

	getrusage(RUSAGE_SELF, &r);
3478
	gettimeofday(&elapse_t, NULL);
3479 3480
	memcpy((char *) &user, (char *) &r.ru_utime, sizeof(user));
	memcpy((char *) &sys, (char *) &r.ru_stime, sizeof(sys));
3481 3482 3483 3484 3485 3486 3487 3488 3489 3490 3491 3492 3493 3494 3495 3496 3497 3498
	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 已提交
3499 3500 3501 3502
	 * 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.
3503
	 */
3504
	initStringInfo(&str);
3505

3506 3507
	appendStringInfo(&str, "! system usage stats:\n");
	appendStringInfo(&str,
B
Bruce Momjian 已提交
3508
				"!\t%ld.%06ld elapsed %ld.%06ld user %ld.%06ld system sec\n",
3509 3510 3511
					 (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 已提交
3512
					 (long) (r.ru_utime.tv_usec - Save_r.ru_utime.tv_usec),
3513
					 (long) (r.ru_stime.tv_sec - Save_r.ru_stime.tv_sec),
B
Bruce Momjian 已提交
3514
					 (long) (r.ru_stime.tv_usec - Save_r.ru_stime.tv_usec));
3515
	appendStringInfo(&str,
B
Bruce Momjian 已提交
3516
					 "!\t[%ld.%06ld user %ld.%06ld sys total]\n",
3517 3518 3519 3520
					 (long) user.tv_sec,
					 (long) user.tv_usec,
					 (long) sys.tv_sec,
					 (long) sys.tv_usec);
3521
#if defined(HAVE_GETRUSAGE)
3522
	appendStringInfo(&str,
B
Bruce Momjian 已提交
3523 3524
					 "!\t%ld/%ld [%ld/%ld] filesystem blocks in/out\n",
					 r.ru_inblock - Save_r.ru_inblock,
3525
	/* they only drink coffee at dec */
B
Bruce Momjian 已提交
3526 3527
					 r.ru_oublock - Save_r.ru_oublock,
					 r.ru_inblock, r.ru_oublock);
3528
	appendStringInfo(&str,
B
Bruce Momjian 已提交
3529
			  "!\t%ld/%ld [%ld/%ld] page faults/reclaims, %ld [%ld] swaps\n",
B
Bruce Momjian 已提交
3530 3531 3532 3533 3534
					 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);
3535
	appendStringInfo(&str,
B
Bruce Momjian 已提交
3536
		 "!\t%ld [%ld] signals rcvd, %ld/%ld [%ld/%ld] messages rcvd/sent\n",
B
Bruce Momjian 已提交
3537 3538 3539 3540 3541
					 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);
3542
	appendStringInfo(&str,
B
Bruce Momjian 已提交
3543
			 "!\t%ld/%ld [%ld/%ld] voluntary/involuntary context switches\n",
B
Bruce Momjian 已提交
3544 3545 3546
					 r.ru_nvcsw - Save_r.ru_nvcsw,
					 r.ru_nivcsw - Save_r.ru_nivcsw,
					 r.ru_nvcsw, r.ru_nivcsw);
3547
#endif   /* HAVE_GETRUSAGE */
3548 3549

	bufusage = ShowBufferUsage();
3550
	appendStringInfo(&str, "! buffer usage stats:\n%s", bufusage);
3551 3552 3553
	pfree(bufusage);

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

3557 3558 3559
	ereport(LOG,
			(errmsg_internal("%s", title),
			 errdetail("%s", str.data)));
3560 3561

	pfree(str.data);
3562
}
3563 3564 3565 3566

/*
 * on_proc_exit handler to log end of session
 */
B
Bruce Momjian 已提交
3567
static void
3568
log_disconnections(int code, Datum arg)
3569
{
B
Bruce Momjian 已提交
3570 3571 3572 3573 3574
	Port	   *port = MyProcPort;
	struct timeval end;
	int			hours,
				minutes,
				seconds;
3575

3576
	gettimeofday(&end, NULL);
3577 3578 3579 3580 3581 3582 3583 3584
	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;

3585
	/* for stricter accuracy here we could round - this is close enough */
3586 3587 3588 3589
	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;
3590

3591 3592 3593 3594 3595
	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 已提交
3596
				  port->remote_port[0] ? " port=" : "", port->remote_port)));
3597
}