postgres.c 94.6 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
B
Bruce Momjian 已提交
11
 *	  $PostgreSQL: pgsql/src/backend/tcop/postgres.c,v 1.476 2006/01/05 03:01:35 momjian Exp $
12 13
 *
 * NOTES
14 15
 *	  this is the "main" module of the postgres backend and
 *	  hence the main module of the "traffic cop".
16 17 18
 *
 *-------------------------------------------------------------------------
 */
B
Bruce Momjian 已提交
19

20 21
#include "postgres.h"

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

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

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

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

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

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

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

82 83
LogStmtLevel log_statement = LOGSTMT_NONE;

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


88 89 90 91
/* ----------------
 *		private variables
 * ----------------
 */
92

93
/* max_stack_depth converted to bytes for speed of checking */
B
Bruce Momjian 已提交
94
static int	max_stack_depth_bytes = 2048 * 1024;
95 96

/* stack base pointer (initialized by PostgresMain) */
97
/* Do not make static so PL/Java can modifiy it */
B
Bruce Momjian 已提交
98
char	   *stack_base_ptr = NULL;
99 100


101 102 103 104 105
/*
 * 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?)
 */
106
static volatile sig_atomic_t got_SIGHUP = false;
107

108 109 110 111 112 113
/*
 * 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;

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

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


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


/* ----------------------------------------------------------------
170
 *		routines to obtain user input
171 172 173 174
 * ----------------------------------------------------------------
 */

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

184
static int
185
InteractiveBackend(StringInfo inBuf)
186
{
187 188 189
	int			c;				/* character read from getc() */
	bool		end = false;	/* end-of-input flag */
	bool		backslashSeen = false;	/* have we seen a \ ? */
190

191 192
	/*
	 * display a prompt and obtain input from the user
193
	 */
194
	printf("backend> ");
195
	fflush(stdout);
196

197 198 199
	/* Reset inBuf to empty */
	inBuf->len = 0;
	inBuf->data[0] = '\0';
200
	inBuf->cursor = 0;
201

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

233
				appendStringInfoChar(inBuf, (char) c);
234 235 236 237 238 239 240
			}

			if (c == EOF)
				end = true;
		}
		else
		{
241 242
			/*
			 * otherwise read characters until EOF.
243 244
			 */
			while ((c = getc(stdin)) != EOF)
245
				appendStringInfoChar(inBuf, (char) c);
246

247
			if (inBuf->len == 0)
248 249 250 251
				end = true;
		}

		if (end)
252
			return EOF;
253

254 255
		/*
		 * otherwise we have a user query so process it.
256 257 258 259
		 */
		break;
	}

260 261 262
	/* Add '\0' to make it look the same as message case. */
	appendStringInfoChar(inBuf, (char) '\0');

263 264
	/*
	 * if the query echo flag was given, print the query..
265 266
	 */
	if (EchoQuery)
267
		printf("statement: %s\n", inBuf->data);
268
	fflush(stdout);
269

270
	return 'Q';
271 272 273
}

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

286
	/*
287
	 * Get message type code from the frontend.
288
	 */
289
	qtype = pq_getbyte();
290

291 292
	if (qtype == EOF)			/* frontend disconnected */
	{
293 294 295
		ereport(COMMERROR,
				(errcode(ERRCODE_PROTOCOL_VIOLATION),
				 errmsg("unexpected EOF on client connection")));
296 297 298 299
		return qtype;
	}

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

324
		case 'F':				/* fastpath function call */
325 326
			/* we let fastpath.c cope with old-style input of this */
			doing_extended_query_message = false;
327
			break;
328

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

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

371
		default:
B
Bruce Momjian 已提交
372

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

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

395
	return qtype;
396 397 398
}

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

410
	if (whereToSendOutput == DestRemote)
411
		result = SocketBackend(inBuf);
412
	else
413 414
		result = InteractiveBackend(inBuf);
	return result;
415 416
}

417 418 419 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
/*
 * 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();
	}
}

463 464 465 466 467 468

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

482 483
	/*
	 * (1) parse the request string into a list of raw parse trees.
484
	 */
485
	raw_parsetree_list = pg_parse_query(query_string);
486

487 488
	/*
	 * (2) Do parse analysis and rule rewrite.
489 490 491 492
	 */
	querytree_list = NIL;
	foreach(list_item, raw_parsetree_list)
	{
B
Bruce Momjian 已提交
493
		Node	   *parsetree = (Node *) lfirst(list_item);
494

495
		querytree_list = list_concat(querytree_list,
B
Bruce Momjian 已提交
496 497 498
									 pg_analyze_and_rewrite(parsetree,
															paramTypes,
															numParams));
499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516
	}

	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.
 */
517
List *
518
pg_parse_query(const char *query_string)
519
{
520
	List	   *raw_parsetree_list;
521

B
Rename:  
Bruce Momjian 已提交
522
	if (log_parser_stats)
523 524
		ResetUsage();

525
	raw_parsetree_list = raw_parser(query_string);
526

527 528 529 530 531 532 533 534
	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 已提交
535
				char **prepare_string)
536 537 538 539 540 541
{
	ListCell   *parsetree_item;
	bool		log_this_statement = (log_statement == LOGSTMT_ALL);

	*prepare_string = NULL;

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

555 556
		if (IsA(parsetree, SelectStmt) &&
			((SelectStmt *) parsetree)->into == NULL)
B
Bruce Momjian 已提交
557
			continue;			/* optimization for frequent command */
558 559 560 561 562 563 564

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

		/*
B
Bruce Momjian 已提交
580 581
		 * For the first EXECUTE we find, record the client statement used by
		 * the PREPARE.
582 583
		 */
		if (IsA(parsetree, ExecuteStmt))
584
		{
585 586 587 588 589
			ExecuteStmt *stmt = (ExecuteStmt *) parsetree;
			PreparedStatement *entry;

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

599 600 601 602 603 604 605 606 607
	if (log_this_statement)
	{
		ereport(LOG,
				(errmsg("statement: %s%s", query_string,
						*prepare_string ? *prepare_string : "")));
		return true;
	}
	else
		return false;
608 609
}

610

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

625 626
	/*
	 * (1) Perform parse analysis.
627
	 */
B
Rename:  
Bruce Momjian 已提交
628
	if (log_parser_stats)
629 630
		ResetUsage();

631
	querytree_list = parse_analyze(parsetree, paramTypes, numParams);
632

B
Rename:  
Bruce Momjian 已提交
633
	if (log_parser_stats)
634
		ShowUsage("PARSE ANALYSIS STATISTICS");
635

636 637
	/*
	 * (2) Rewrite the queries, as necessary
638 639 640 641 642 643 644 645
	 */
	querytree_list = pg_rewrite_queries(querytree_list);

	return querytree_list;
}

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

	if (log_parser_stats)
		ResetUsage();

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

667
		if (Debug_print_parse)
668
			elog_node_display(DEBUG1, "parse tree", querytree,
669
							  Debug_pretty_print);
670 671 672

		if (querytree->commandType == CMD_UTILITY)
		{
673 674
			/* don't rewrite utilities, just dump 'em into new_list */
			new_list = lappend(new_list, querytree);
675
		}
676
		else
677
		{
678
			/* rewrite regular queries */
679 680
			List	   *rewritten = QueryRewrite(querytree);

681
			new_list = list_concat(new_list, rewritten);
682 683 684 685 686
		}
	}

	querytree_list = new_list;

B
Rename:  
Bruce Momjian 已提交
687
	if (log_parser_stats)
688
		ShowUsage("REWRITER STATISTICS");
689

690
#ifdef COPY_PARSE_PLAN_TREES
B
Bruce Momjian 已提交
691 692

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

703
	if (Debug_print_rewritten)
704
		elog_node_display(DEBUG1, "rewritten parse tree", querytree_list,
705
						  Debug_pretty_print);
706

707 708
	return querytree_list;
}
709 710


711
/* Generate a plan for a single already-rewritten query. */
712
Plan *
713
pg_plan_query(Query *querytree, ParamListInfo boundParams)
714 715
{
	Plan	   *plan;
716

717 718 719
	/* Utility commands have no plans. */
	if (querytree->commandType == CMD_UTILITY)
		return NULL;
720

B
Rename:  
Bruce Momjian 已提交
721
	if (log_planner_stats)
722
		ResetUsage();
723

724
	/* call the optimizer */
725
	plan = planner(querytree, false, 0, boundParams);
726

B
Rename:  
Bruce Momjian 已提交
727
	if (log_planner_stats)
728
		ShowUsage("PLANNER STATISTICS");
729

730 731 732
#ifdef COPY_PARSE_PLAN_TREES
	/* Optional debugging check: pass plan output through copyObject() */
	{
B
Bruce Momjian 已提交
733
		Plan	   *new_plan = (Plan *) copyObject(plan);
734

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

749 750
	/*
	 * Print plan if debugging.
751
	 */
752
	if (Debug_print_plan)
753
		elog_node_display(DEBUG1, "plan", plan, Debug_pretty_print);
754

755
	return plan;
756 757
}

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

	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)
			{
790
				ActiveSnapshot = CopySnapshot(GetTransactionSnapshot());
791 792
				needSnapshot = false;
			}
793
			plan = pg_plan_query(query, boundParams);
794 795 796 797 798 799 800 801 802 803
		}

		plan_list = lappend(plan_list, plan);
	}

	return plan_list;
}


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

823 824 825
	/*
	 * Report query to various monitoring facilities.
	 */
826
	debug_query_string = query_string;
827

828 829
	pgstat_report_activity(query_string);

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

839 840 841
	if (save_log_statement_stats)
		ResetUsage();

842
	/*
B
Bruce Momjian 已提交
843 844
	 * 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 已提交
845 846 847
	 * 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.)
848 849
	 */
	start_xact_command();
850 851

	/*
B
Bruce Momjian 已提交
852 853 854 855
	 * 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.)
856 857 858 859 860 861 862 863
	 */
	unnamed_stmt_pstmt = NULL;
	if (unnamed_stmt_context)
	{
		DropDependentPortals(unnamed_stmt_context);
		MemoryContextDelete(unnamed_stmt_context);
	}
	unnamed_stmt_context = NULL;
864

865 866 867
	/*
	 * Switch to appropriate context for constructing parsetrees.
	 */
868
	oldcontext = MemoryContextSwitchTo(MessageContext);
869

870 871
	QueryContext = CurrentMemoryContext;

B
Bruce Momjian 已提交
872
	/*
B
Bruce Momjian 已提交
873 874
	 * Do basic parsing of the query or queries (this should be safe even if
	 * we are in aborted transaction state!)
875
	 */
876
	parsetree_list = pg_parse_query(query_string);
877

878 879
	if (log_statement != LOGSTMT_NONE || save_log_min_duration_statement != -1)
		was_logged = log_after_parse(parsetree_list, query_string,
B
Bruce Momjian 已提交
880
									 &prepare_string);
881

882
	/*
883
	 * Switch back to transaction context to enter the loop.
884 885 886 887
	 */
	MemoryContextSwitchTo(oldcontext);

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

901
		/*
B
Bruce Momjian 已提交
902 903 904 905
		 * 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.
906 907 908 909 910
		 */
		commandTag = CreateCommandTag(parsetree);

		set_ps_display(commandTag);

911
		BeginCommand(commandTag, dest);
912

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

928
		/* Make sure we are in a transaction command */
929
		start_xact_command();
930

931
		/* If we got a cancel signal in parsing or prior command, quit */
932
		CHECK_FOR_INTERRUPTS();
933 934

		/*
935
		 * OK to analyze, rewrite, and plan this query.
936
		 *
B
Bruce Momjian 已提交
937 938
		 * Switch to appropriate context for constructing querytrees (again,
		 * these must outlive the execution context).
939
		 */
940
		oldcontext = MemoryContextSwitchTo(MessageContext);
941

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

944
		plantree_list = pg_plan_queries(querytree_list, NULL, true);
945 946 947 948

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

949
		/*
B
Bruce Momjian 已提交
950 951
		 * Create unnamed portal to run the query or queries in. If there
		 * already is one, silently drop it.
952
		 */
953
		portal = CreatePortal("", true, true);
954

955 956 957 958 959 960
		PortalDefineQuery(portal,
						  query_string,
						  commandTag,
						  querytree_list,
						  plantree_list,
						  MessageContext);
961

962
		/*
963
		 * Start the portal.  No parameters here.
964
		 */
965
		PortalStart(portal, NULL, InvalidSnapshot);
966

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

1008
		(*receiver->rDestroy) (receiver);
1009

1010
		PortalDrop(portal, false);
1011

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

		/*
B
Bruce Momjian 已提交
1044 1045 1046 1047
		 * 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.)
1048
		 */
1049
		EndCommand(completionTag, dest);
B
Bruce Momjian 已提交
1050
	}							/* end loop over parsetrees */
1051

1052 1053 1054 1055 1056
	/*
	 * Close down transaction statement, if one is open.
	 */
	finish_xact_command();

1057 1058 1059
	/*
	 * If there were no parsetrees, return EmptyQueryResponse message.
	 */
1060
	if (!parsetree_list)
1061 1062
		NullCommand(dest);

1063
	QueryContext = NULL;
1064

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

1073
		gettimeofday(&stop_t, NULL);
1074 1075 1076 1077 1078
		if (stop_t.tv_usec < start_t.tv_usec)
		{
			stop_t.tv_sec--;
			stop_t.tv_usec += 1000000;
		}
1079
		usecs = (long) (stop_t.tv_sec - start_t.tv_sec) * 1000000 +
B
Bruce Momjian 已提交
1080
			(long) (stop_t.tv_usec - start_t.tv_usec);
B
Bruce Momjian 已提交
1081

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

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

1106 1107 1108
	if (save_log_statement_stats)
		ShowUsage("QUERY STATISTICS");

1109 1110 1111
	if (prepare_string != NULL)
		pfree(prepare_string);

1112
	debug_query_string = NULL;
1113 1114
}

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

1147 1148
	if (log_statement == LOGSTMT_ALL)
		ereport(LOG,
1149
				(errmsg("statement: [protocol] PREPARE %s AS %s",
1150 1151
						(*stmt_name != '\0') ? stmt_name : "<unnamed>",
						query_string)));
1152

1153
	/*
B
Bruce Momjian 已提交
1154 1155 1156
	 * 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.
1157 1158 1159 1160 1161 1162
	 */
	start_xact_command();

	/*
	 * Switch to appropriate context for constructing parsetrees.
	 *
B
Bruce Momjian 已提交
1163 1164 1165
	 * 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 已提交
1166 1167 1168 1169 1170 1171
	 * 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.
1172 1173 1174 1175 1176 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
	 */
	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 已提交
1202 1203
	 * Do basic parsing of the query or queries (this should be safe even if
	 * we are in aborted transaction state!)
1204 1205 1206 1207
	 */
	parsetree_list = pg_parse_query(query_string);

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

	if (parsetree_list != NIL)
	{
1219
		Node	   *parsetree = (Node *) linitial(parsetree_list);
B
Bruce Momjian 已提交
1220
		int			i;
1221 1222 1223 1224 1225 1226 1227 1228

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

		/*
		 * OK to analyze, rewrite, and plan this query.  Note that the
B
Bruce Momjian 已提交
1244 1245
		 * originally specified parameter set is not required to be complete,
		 * so we have to use parse_analyze_varparams().
1246 1247 1248 1249 1250 1251 1252 1253 1254 1255 1256 1257 1258 1259 1260
		 */
		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 已提交
1261
			Oid			ptype = paramTypes[i];
1262 1263

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

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

		querytree_list = pg_rewrite_queries(querytree_list);

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

	MemoryContextSwitchTo(oldcontext);

	QueryContext = NULL;

	/*
B
Bruce Momjian 已提交
1331 1332 1333
	 * 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.
1334 1335 1336 1337 1338 1339
	 */
	CommandCounterIncrement();

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

	pgstat_report_activity("<BIND>");

	set_ps_display("BIND");

	/*
B
Bruce Momjian 已提交
1374 1375 1376
	 * 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.
1377 1378 1379
	 */
	start_xact_command();

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

1383 1384 1385 1386
	/* Get the fixed part of the message */
	portal_name = pq_getmsgstring(input_message);
	stmt_name = pq_getmsgstring(input_message);

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

	/* 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)
1413 1414
			ereport(ERROR,
					(errcode(ERRCODE_UNDEFINED_PSTATEMENT),
B
Bruce Momjian 已提交
1415
					 errmsg("unnamed prepared statement does not exist")));
1416 1417
	}

1418
	if (numParams != list_length(pstmt->argtype_list))
1419 1420 1421
		ereport(ERROR,
				(errcode(ERRCODE_PROTOCOL_VIOLATION),
				 errmsg("bind message supplies %d parameters, but prepared statement \"%s\" requires %d",
B
Bruce Momjian 已提交
1422
				   numParams, stmt_name, list_length(pstmt->argtype_list))));
1423

1424 1425
	/*
	 * If we are in aborted transaction state, the only portals we can
1426 1427 1428 1429 1430
	 * 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.
1431 1432 1433 1434 1435 1436 1437 1438 1439
	 */
	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")));

1440
	/*
B
Bruce Momjian 已提交
1441 1442
	 * Create the portal.  Allow silent replacement of an existing portal only
	 * if the unnamed portal is specified.
1443 1444 1445 1446 1447 1448
	 */
	if (portal_name[0] == '\0')
		portal = CreatePortal(portal_name, true, true);
	else
		portal = CreatePortal(portal_name, false, false);

1449
	/* We need to output the parameter values someday */
1450 1451
	if (log_statement == LOGSTMT_ALL)
		ereport(LOG,
1452
				(errmsg("statement: [protocol] <BIND> %s", portal_name)));
1453

1454 1455 1456 1457 1458
	/*
	 * Fetch parameters, if any, and store in the portal's memory context.
	 */
	if (numParams > 0)
	{
1459
		ListCell   *l;
1460 1461 1462 1463 1464 1465 1466
		MemoryContext oldContext;

		oldContext = MemoryContextSwitchTo(PortalGetHeapMemory(portal));

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

1467
		i = 0;
1468 1469
		foreach(l, pstmt->argtype_list)
		{
1470
			Oid			ptype = lfirst_oid(l);
1471
			int32		plength;
1472 1473
			bool		isNull;

1474 1475 1476
			plength = pq_getmsgint(input_message, 4);
			isNull = (plength == -1);

1477 1478
			if (!isNull)
			{
1479
				const char *pvalue = pq_getmsgbytes(input_message, plength);
1480 1481 1482 1483 1484 1485 1486 1487 1488 1489 1490 1491 1492
				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
1493 1494 1495 1496 1497
				 * 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.
1498 1499 1500 1501 1502 1503 1504 1505 1506 1507
				 */
				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)
1508
				{
1509 1510 1511 1512 1513 1514 1515
					Oid			typinput;
					Oid			typioparam;
					char	   *pstring;

					getTypeInputInfo(ptype, &typinput, &typioparam);

					/*
1516 1517
					 * We have to do encoding conversion before calling the
					 * typinput routine.
1518 1519 1520 1521 1522 1523 1524 1525 1526 1527
					 */
					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);
1528
				}
1529
				else if (pformat == 1)
1530
				{
1531 1532
					Oid			typreceive;
					Oid			typioparam;
1533

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

1539 1540 1541 1542 1543
					params[i].value =
						OidFunctionCall3(typreceive,
										 PointerGetDatum(&pbuf),
										 ObjectIdGetDatum(typioparam),
										 Int32GetDatum(-1));
1544

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

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

1564 1565
			params[i].kind = PARAM_NUM;
			params[i].id = i + 1;
1566
			params[i].ptype = ptype;
1567 1568 1569 1570 1571 1572 1573 1574 1575 1576 1577 1578
			params[i].isnull = isNull;

			i++;
		}

		params[i].kind = PARAM_INVALID;

		MemoryContextSwitchTo(oldContext);
	}
	else
		params = NULL;

1579 1580 1581 1582 1583 1584 1585 1586 1587
	/* 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);
	}

1588 1589 1590
	pq_getmsgend(input_message);

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

1616
	PortalStart(portal, params, InvalidSnapshot);
1617

1618 1619 1620 1621 1622
	/*
	 * Apply the result format requests to the portal.
	 */
	PortalSetResultFormat(portal, numRFormats, rformats);

1623 1624 1625
	/*
	 * Send BindComplete.
	 */
1626
	if (whereToSendOutput == DestRemote)
1627 1628 1629 1630 1631 1632 1633 1634 1635
		pq_putemptymessage('2');
}

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

	/* Adjust destination to tell printtup.c what to do */
	dest = whereToSendOutput;
1652 1653
	if (dest == DestRemote)
		dest = DestRemoteExecute;
1654 1655 1656

	portal = GetPortalByName(portal_name);
	if (!PortalIsValid(portal))
1657 1658 1659
		ereport(ERROR,
				(errcode(ERRCODE_UNDEFINED_CURSOR),
				 errmsg("portal \"%s\" does not exist", portal_name)));
1660

1661
	/*
B
Bruce Momjian 已提交
1662 1663 1664 1665
	 * 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.
1666 1667 1668 1669
	 */
	if (!portal->atStart)
		execute_is_fetch = true;

1670
	/*
B
Bruce Momjian 已提交
1671 1672
	 * If the original query was a null string, just return
	 * EmptyQueryResponse.
1673 1674 1675 1676 1677 1678 1679 1680
	 */
	if (portal->commandTag == NULL)
	{
		Assert(portal->parseTrees == NIL);
		NullCommand(dest);
		return;
	}

1681 1682 1683 1684 1685 1686 1687
	/* Should we display the portal names here? */
	if (execute_is_fetch)
	{
		debug_query_string = "fetch message";
		pgstat_report_activity("<FETCH>");
	}
	else if (portal->sourceText)
1688 1689 1690 1691 1692 1693 1694 1695 1696 1697 1698 1699
	{
		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);

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

1720 1721
	BeginCommand(portal->commandTag, dest);

1722
	/*
B
Bruce Momjian 已提交
1723 1724
	 * Create dest receiver in MessageContext (we don't want it in transaction
	 * context, because that may get deleted if portal contains VACUUM).
1725 1726 1727
	 */
	receiver = CreateDestReceiver(dest, portal);

1728
	/*
B
Bruce Momjian 已提交
1729 1730
	 * Ensure we are in a transaction command (this should normally be the
	 * case already due to prior BIND).
1731 1732 1733 1734 1735 1736 1737
	 */
	start_xact_command();

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

	/* 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,
1756 1757
						  receiver,
						  receiver,
1758 1759
						  completionTag);

1760
	(*receiver->rDestroy) (receiver);
1761

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

		/* Send appropriate CommandComplete to client */
		EndCommand(completionTag, dest);
	}
	else
	{
		/* Portal run not complete, so send PortalSuspended */
1787
		if (whereToSendOutput == DestRemote)
1788 1789 1790
			pq_putemptymessage('s');
	}

1791
	/*
B
Bruce Momjian 已提交
1792 1793
	 * Combine processing here as we need to calculate the query duration in
	 * both instances.
1794 1795 1796 1797 1798 1799 1800 1801 1802 1803 1804 1805
	 */
	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 已提交
1806
			(long) (stop_t.tv_usec - start_t.tv_usec);
1807 1808 1809 1810 1811

		/* 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 已提交
1812 1813 1814
							(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)));
1815 1816

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

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

1836 1837 1838 1839 1840 1841 1842 1843 1844 1845 1846 1847
	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;
1848
	TupleDesc	tupdesc;
1849
	ListCell   *l;
1850 1851
	StringInfoData buf;

1852 1853 1854 1855 1856 1857 1858 1859 1860
	/*
	 * 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);

1861 1862 1863 1864 1865 1866 1867 1868
	/* 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)
1869 1870
			ereport(ERROR,
					(errcode(ERRCODE_UNDEFINED_PSTATEMENT),
B
Bruce Momjian 已提交
1871
					 errmsg("unnamed prepared statement does not exist")));
1872 1873
	}

1874 1875 1876 1877 1878 1879 1880 1881 1882 1883 1884 1885 1886 1887 1888 1889
	/*
	 * 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")));

1890
	if (whereToSendOutput != DestRemote)
1891 1892
		return;					/* can't actually do anything... */

1893 1894 1895
	/*
	 * First describe the parameters...
	 */
B
Bruce Momjian 已提交
1896
	pq_beginmessage(&buf, 't'); /* parameter description message type */
1897
	pq_sendint(&buf, list_length(pstmt->argtype_list), 2);
1898 1899 1900

	foreach(l, pstmt->argtype_list)
	{
1901
		Oid			ptype = lfirst_oid(l);
1902 1903 1904 1905

		pq_sendint(&buf, (int) ptype, 4);
	}
	pq_endmessage(&buf);
1906 1907 1908 1909 1910 1911

	/*
	 * Next send RowDescription or NoData to describe the result...
	 */
	tupdesc = FetchPreparedStatementResultDesc(pstmt);
	if (tupdesc)
1912 1913 1914
		SendRowDescriptionMessage(tupdesc,
								  FetchPreparedStatementTargetList(pstmt),
								  NULL);
1915 1916 1917
	else
		pq_putemptymessage('n');	/* NoData */

1918 1919 1920 1921 1922 1923 1924 1925 1926 1927 1928 1929
}

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

1930 1931 1932 1933 1934 1935 1936 1937 1938
	/*
	 * 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);

1939 1940
	portal = GetPortalByName(portal_name);
	if (!PortalIsValid(portal))
1941 1942 1943
		ereport(ERROR,
				(errcode(ERRCODE_UNDEFINED_CURSOR),
				 errmsg("portal \"%s\" does not exist", portal_name)));
1944

1945 1946 1947 1948 1949 1950 1951 1952 1953 1954 1955 1956 1957 1958 1959
	/*
	 * 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")));

1960
	if (whereToSendOutput != DestRemote)
1961 1962 1963
		return;					/* can't actually do anything... */

	if (portal->tupDesc)
1964 1965
		SendRowDescriptionMessage(portal->tupDesc,
								  FetchPortalTargetList(portal),
1966
								  portal->formats);
1967 1968 1969 1970 1971
	else
		pq_putemptymessage('n');	/* NoData */
}


1972 1973 1974 1975 1976 1977
/*
 * Convenience routines for starting/committing a single command.
 */
static void
start_xact_command(void)
{
1978 1979
	if (!xact_started)
	{
1980 1981
		ereport(DEBUG3,
				(errmsg_internal("StartTransactionCommand")));
1982
		StartTransactionCommand();
1983 1984 1985 1986

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

1990 1991
		xact_started = true;
	}
1992 1993 1994
}

static void
1995
finish_xact_command(void)
1996
{
1997 1998 1999 2000
	if (xact_started)
	{
		/* Cancel any active statement timeout before committing */
		disable_sig_alarm(true);
2001

2002
		/* Now commit the command */
2003 2004
		ereport(DEBUG3,
				(errmsg_internal("CommitTransactionCommand")));
2005

2006
		CommitTransactionCommand();
2007

2008 2009 2010 2011 2012 2013
#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

2014
#ifdef SHOW_MEMORY_STATS
2015
		/* Print mem stats after each commit for leak tracking */
2016 2017
		if (ShowStats)
			MemoryContextStats(TopMemoryContext);
2018
#endif
2019 2020 2021

		xact_started = false;
	}
2022 2023 2024
}


2025 2026 2027 2028 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
/*
 * 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;
}


2075
/* --------------------------------
2076
 *		signal handler routines used in PostgresMain()
2077 2078 2079
 * --------------------------------
 */

2080
/*
T
Tom Lane 已提交
2081
 * quickdie() occurs when signalled SIGQUIT by the postmaster.
2082 2083 2084 2085
 *
 * Some backend has bought the farm,
 * so we need to stop what we're doing and exit.
 */
T
Tom Lane 已提交
2086
void
2087
quickdie(SIGNAL_ARGS)
2088
{
2089
	PG_SETMASK(&BlockSig);
B
Bruce Momjian 已提交
2090

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

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

2118
/*
2119 2120
 * Shutdown signal from postmaster: abort transaction and exit
 * at soonest convenient time
2121
 */
2122
void
2123
die(SIGNAL_ARGS)
2124
{
2125 2126 2127
	int			save_errno = errno;

	/* Don't joggle the elbow of proc_exit */
B
Bruce Momjian 已提交
2128
	if (!proc_exit_inprogress)
2129
	{
2130
		InterruptPending = true;
2131
		ProcDiePending = true;
B
Bruce Momjian 已提交
2132

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

	errno = save_errno;
2153 2154
}

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

2169
/*
2170 2171
 * Query-cancel signal from postmaster: abort current transaction
 * at soonest convenient time
2172
 */
2173
void
2174
StatementCancelHandler(SIGNAL_ARGS)
2175
{
2176 2177
	int			save_errno = errno;

B
Bruce Momjian 已提交
2178
	/*
2179
	 * Don't joggle the elbow of proc_exit
B
Bruce Momjian 已提交
2180
	 */
2181
	if (!proc_exit_inprogress)
2182
	{
2183 2184
		InterruptPending = true;
		QueryCancelPending = true;
B
Bruce Momjian 已提交
2185

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

2209
	errno = save_errno;
2210 2211
}

2212
/* signal handler for floating point exception */
2213
void
2214 2215
FloatExceptionHandler(SIGNAL_ARGS)
{
2216 2217 2218
	ereport(ERROR,
			(errcode(ERRCODE_FLOATING_POINT_EXCEPTION),
			 errmsg("floating-point exception"),
B
Bruce Momjian 已提交
2219 2220 2221
			 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.")));
2222 2223
}

2224
/* SIGHUP: set flag to re-read config file at next convenient time */
2225
static void
2226
SigHupHandler(SIGNAL_ARGS)
2227
{
2228
	got_SIGHUP = true;
2229 2230
}

2231

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

2275

2276 2277 2278 2279 2280 2281 2282 2283 2284 2285 2286 2287 2288
/*
 * 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 已提交
2289 2290
	char		stack_top_loc;
	int			stack_depth;
2291 2292 2293 2294

	/*
	 * Compute distance from PostgresMain's local variables to my own
	 *
B
Bruce Momjian 已提交
2295 2296 2297
	 * 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.
2298 2299
	 */
	stack_depth = (int) (stack_base_ptr - &stack_top_loc);
B
Bruce Momjian 已提交
2300

2301
	/*
B
Bruce Momjian 已提交
2302
	 * Take abs value, since stacks grow up on some machines, down on others
2303 2304 2305
	 */
	if (stack_depth < 0)
		stack_depth = -stack_depth;
B
Bruce Momjian 已提交
2306

2307 2308 2309
	/*
	 * Trouble?
	 *
2310 2311 2312 2313
	 * 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.
2314 2315 2316 2317 2318 2319 2320 2321 2322 2323 2324 2325 2326 2327 2328 2329 2330 2331 2332 2333 2334 2335
	 */
	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;
}


2336
static void
2337
usage(const char *progname)
2338
{
2339
	printf(_("%s is the PostgreSQL stand-alone backend.  It is not\nintended to be used by normal users.\n\n"), progname);
2340

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

2370

2371 2372 2373 2374 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
/*
 * 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);
}


2406
/* ----------------------------------------------------------------
2407
 * PostgresMain
B
Bruce Momjian 已提交
2408
 *	   postgres main loop -- all backends, interactive or otherwise start here
2409
 *
2410 2411 2412 2413
 * 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.
2414 2415 2416
 * ----------------------------------------------------------------
 */
int
2417
PostgresMain(int argc, char *argv[], const char *username)
2418
{
2419
	int			flag;
2420
	const char *dbname = NULL;
2421
	char	   *userDoption = NULL;
2422
	bool		secure;
2423
	int			errs = 0;
B
Bruce Momjian 已提交
2424 2425
	int			debug_flag = -1;	/* -1 means not given */
	List	   *guc_names = NIL;	/* for SUSET options */
2426 2427
	List	   *guc_values = NIL;
	GucContext	ctx;
2428
	GucSource	gucsource;
2429
	bool		am_superuser;
2430
	char	   *tmp;
2431
	int			firstchar;
2432
	char		stack_base;
B
Bruce Momjian 已提交
2433
	StringInfoData input_message;
2434
	sigjmp_buf	local_sigjmp_buf;
2435
	volatile bool send_ready_for_query = true;
B
Bruce Momjian 已提交
2436

2437 2438 2439 2440
#define PendingConfigOption(name,val) \
	(guc_names = lappend(guc_names, pstrdup(name)), \
	 guc_values = lappend(guc_values, pstrdup(val)))

2441
	/*
B
Bruce Momjian 已提交
2442 2443
	 * Catch standard options before doing much else.  This even works on
	 * systems without getopt_long.
2444 2445 2446
	 */
	if (!IsUnderPostmaster && argc > 1)
	{
B
Bruce Momjian 已提交
2447
		if (strcmp(argv[1], "--help") == 0 || strcmp(argv[1], "-?") == 0)
2448 2449 2450 2451
		{
			usage(argv[0]);
			exit(0);
		}
B
Bruce Momjian 已提交
2452
		if (strcmp(argv[1], "--version") == 0 || strcmp(argv[1], "-V") == 0)
2453
		{
2454
			puts(PG_VERSIONSTR);
2455 2456
			exit(0);
		}
B
Bruce Momjian 已提交
2457
	}
2458

2459 2460 2461 2462 2463 2464
	/*
	 * initialize globals (already done if under postmaster, but not if
	 * standalone; cheap enough to do over)
	 */
	MyProcPid = getpid();

2465 2466 2467 2468 2469
	/*
	 * Fire up essential subsystems: error and memory management
	 *
	 * If we are running under the postmaster, this is done already.
	 */
2470
	if (!IsUnderPostmaster)
2471 2472
		MemoryContextInit();

2473 2474
	set_ps_display("startup");

2475 2476
	SetProcessingMode(InitProcessing);

2477 2478 2479
	/* Set up reference point for stack depth checking */
	stack_base_ptr = &stack_base;

2480 2481 2482 2483 2484 2485 2486
	/* 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 已提交
2487

B
Bruce Momjian 已提交
2488 2489
	if (pkglib_path[0] == '\0')
		get_pkglib_path(my_exec_path, pkglib_path);
2490

2491
	/*
2492
	 * Set default values for command-line options.
2493
	 */
2494
	EchoQuery = false;
2495

2496
	if (!IsUnderPostmaster)
2497
		InitializeGUCOptions();
2498

2499 2500 2501 2502 2503 2504 2505 2506 2507 2508 2509 2510 2511 2512 2513 2514 2515
	/* ----------------
	 *	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.
	 * ----------------
	 */

2516 2517
	/* all options are allowed until '-p' */
	secure = true;
2518
	ctx = PGC_POSTMASTER;
2519
	gucsource = PGC_S_ARGV;		/* initial switches came from command line */
2520

2521
	while ((flag = getopt(argc, argv, "A:B:c:D:d:Eef:FiNOPo:p:S:st:v:W:-:")) != -1)
2522
	{
2523 2524
		switch (flag)
		{
M
 
Marc G. Fournier 已提交
2525 2526
			case 'A':
#ifdef USE_ASSERT_CHECKING
2527
				SetConfigOption("debug_assertions", optarg, ctx, gucsource);
M
 
Marc G. Fournier 已提交
2528
#else
2529 2530 2531
				ereport(WARNING,
						(errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
						 errmsg("assert checking is not compiled in")));
M
 
Marc G. Fournier 已提交
2532 2533
#endif
				break;
2534

2535
			case 'B':
2536 2537 2538

				/*
				 * specify the size of buffer pool
2539
				 */
2540
				SetConfigOption("shared_buffers", optarg, ctx, gucsource);
2541
				break;
2542

2543
			case 'D':			/* PGDATA or config directory */
2544
				if (secure)
2545
					userDoption = optarg;
M
 
Marc G. Fournier 已提交
2546
				break;
2547

2548
			case 'd':			/* debug level */
2549
				debug_flag = atoi(optarg);
2550
				break;
2551 2552

			case 'E':
2553 2554 2555

				/*
				 * E - echo the query the user entered
2556
				 */
2557
				EchoQuery = true;
2558
				break;
2559 2560

			case 'e':
2561 2562

				/*
2563
				 * Use European date input format (DMY)
2564
				 */
2565
				SetConfigOption("datestyle", "euro", ctx, gucsource);
2566
				break;
2567 2568

			case 'F':
2569 2570 2571

				/*
				 * turn off fsync
2572
				 */
2573
				SetConfigOption("fsync", "false", ctx, gucsource);
2574
				break;
2575 2576

			case 'f':
2577 2578 2579

				/*
				 * f - forbid generation of certain plans
2580
				 */
2581
				tmp = NULL;
2582 2583 2584
				switch (optarg[0])
				{
					case 's':	/* seqscan */
2585
						tmp = "enable_seqscan";
2586 2587
						break;
					case 'i':	/* indexscan */
2588
						tmp = "enable_indexscan";
2589
						break;
2590 2591 2592
					case 'b':	/* bitmapscan */
						tmp = "enable_bitmapscan";
						break;
2593
					case 't':	/* tidscan */
2594
						tmp = "enable_tidscan";
2595 2596
						break;
					case 'n':	/* nestloop */
2597
						tmp = "enable_nestloop";
2598 2599
						break;
					case 'm':	/* mergejoin */
2600
						tmp = "enable_mergejoin";
2601 2602
						break;
					case 'h':	/* hashjoin */
2603
						tmp = "enable_hashjoin";
2604 2605 2606 2607
						break;
					default:
						errs++;
				}
2608
				if (tmp)
2609
					SetConfigOption(tmp, "false", ctx, gucsource);
2610 2611
				break;

2612
			case 'N':
2613 2614 2615

				/*
				 * N - Don't use newline as a query delimiter
2616 2617 2618
				 */
				UseNewLine = 0;
				break;
2619

2620
			case 'O':
2621 2622 2623

				/*
				 * allow system table structure modifications
2624
				 */
2625 2626
				if (secure)		/* XXX safe to allow from client??? */
					allowSystemTableMods = true;
2627 2628
				break;

H
Hiroshi Inoue 已提交
2629
			case 'P':
2630 2631 2632

				/*
				 * ignore system indexes
2633
				 *
2634 2635 2636
				 * As of PG 7.4 this is safe to allow from the client, since
				 * it only disables reading the system indexes, not writing
				 * them. Worst case consequence is slowness.
H
Hiroshi Inoue 已提交
2637
				 */
2638
				IgnoreSystemIndexes(true);
H
Hiroshi Inoue 已提交
2639 2640
				break;

T
Tom Lane 已提交
2641
			case 'o':
2642 2643 2644

				/*
				 * o - send output (stdout and stderr) to the given file
T
Tom Lane 已提交
2645
				 */
2646 2647
				if (secure)
					StrNCpy(OutputFileName, optarg, MAXPGPATH);
T
Tom Lane 已提交
2648 2649
				break;

2650
			case 'p':
B
Bruce Momjian 已提交
2651

2652 2653 2654
				/*
				 * p - special flag passed if backend was forked by a
				 * postmaster.
2655
				 */
2656 2657
				if (secure)
				{
2658
					dbname = strdup(optarg);
2659

B
Bruce Momjian 已提交
2660
					secure = false;		/* subsequent switches are NOT secure */
2661
					ctx = PGC_BACKEND;
2662
					gucsource = PGC_S_CLIENT;
2663
				}
2664
				break;
2665

2666
			case 'S':
2667 2668 2669

				/*
				 * S - amount of sort memory to use in 1k bytes
2670
				 */
2671
				SetConfigOption("work_mem", optarg, ctx, gucsource);
2672
				break;
2673 2674

			case 's':
2675 2676 2677

				/*
				 * s - report usage statistics (timings) after each query
2678
				 *
2679 2680
				 * Since log options are SUSET, we need to postpone unless
				 * still in secure context
2681
				 */
2682 2683 2684 2685 2686
				if (ctx == PGC_BACKEND)
					PendingConfigOption("log_statement_stats", "true");
				else
					SetConfigOption("log_statement_stats", "true",
									ctx, gucsource);
M
 
Marc G. Fournier 已提交
2687 2688
				break;

2689
			case 't':
2690
				/* ---------------
2691 2692 2693 2694 2695 2696 2697 2698 2699
				 *	tell postgres to report usage statistics (timings) for
				 *	each query
				 *
				 *	-tpa[rser] = print stats for parser time of each query
				 *	-tpl[anner] = print stats for planner time of each query
				 *	-te[xecutor] = print stats for executor time of each query
				 *	caution: -s can not be used together with -t.
				 * ----------------
				 */
2700
				tmp = NULL;
2701 2702 2703 2704
				switch (optarg[0])
				{
					case 'p':
						if (optarg[1] == 'a')
B
Rename:  
Bruce Momjian 已提交
2705
							tmp = "log_parser_stats";
2706
						else if (optarg[1] == 'l')
B
Rename:  
Bruce Momjian 已提交
2707
							tmp = "log_planner_stats";
2708 2709 2710 2711
						else
							errs++;
						break;
					case 'e':
2712
						tmp = "log_executor_stats";
2713 2714 2715 2716 2717
						break;
					default:
						errs++;
						break;
				}
2718
				if (tmp)
2719 2720 2721 2722 2723 2724
				{
					if (ctx == PGC_BACKEND)
						PendingConfigOption(tmp, "true");
					else
						SetConfigOption(tmp, "true", ctx, gucsource);
				}
2725 2726
				break;

2727
			case 'v':
2728 2729
				if (secure)
					FrontendProtocol = (ProtocolVersion) atoi(optarg);
2730 2731
				break;

M
 
Marc G. Fournier 已提交
2732
			case 'W':
2733 2734 2735

				/*
				 * wait N seconds to allow attach from a debugger
M
 
Marc G. Fournier 已提交
2736
				 */
B
Bruce Momjian 已提交
2737
				pg_usleep(atoi(optarg) * 1000000L);
M
 
Marc G. Fournier 已提交
2738 2739
				break;

2740
			case 'c':
2741
			case '-':
2742
				{
B
Bruce Momjian 已提交
2743 2744
					char	   *name,
							   *value;
2745

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

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

2775 2776
			default:
				errs++;
T
Tom Lane 已提交
2777
				break;
2778
		}
2779 2780
	}

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

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

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

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

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

2852 2853
	pqinitmask();

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

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

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

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

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

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

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

2912
		BaseInit();
2913 2914 2915 2916 2917

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

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

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

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

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

2959
	SetProcessingMode(NormalProcessing);
2960

2961
	/*
2962 2963
	 * Now that we know if client is a superuser, we can try to apply SUSET
	 * GUC options that came from the client.
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 2990 2991
	 */
	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();

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

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

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

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

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

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

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

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

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

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

3084 3085 3086
		/* Make sure libpq is in a good state */
		pq_comm_reset();

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

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

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

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

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

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

		/* Now we can allow interrupts again */
3121
		RESUME_INTERRUPTS();
3122
	}
3123

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

3127
	PG_SETMASK(&UnBlockSig);
3128

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

3132 3133
	/*
	 * Non-error queries loop here.
3134 3135 3136 3137
	 */

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

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

3151
		initStringInfo(&input_message);
3152

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

3176 3177 3178
				set_ps_display("idle");
				pgstat_report_activity("<IDLE>");
			}
3179

3180
			ReadyForQuery(whereToSendOutput);
3181
			send_ready_for_query = false;
3182
		}
3183

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

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

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

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

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

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

3226 3227
					query_string = pq_getmsgstring(&input_message);
					pq_getmsgend(&input_message);
3228

3229
					exec_simple_query(query_string);
3230

3231
					send_ready_for_query = true;
3232
				}
3233 3234
				break;

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

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

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

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

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

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

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

3274 3275 3276
					portal_name = pq_getmsgstring(&input_message);
					max_rows = pq_getmsgint(&input_message, 4);
					pq_getmsgend(&input_message);
3277

3278
					exec_execute_message(portal_name, max_rows);
3279 3280 3281
				}
				break;

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

3286
				/* start an xact for this function invocation */
3287
				start_xact_command();
3288

3289 3290 3291
				/* switch back to message context */
				MemoryContextSwitchTo(MessageContext);

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

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

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

3306
					proc_exit(0);
3307
				}
3308 3309

				/* commit the function-invocation transaction */
3310
				finish_xact_command();
3311

3312
				send_ready_for_query = true;
3313 3314
				break;

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

3320 3321 3322
					close_type = pq_getmsgbyte(&input_message);
					close_target = pq_getmsgstring(&input_message);
					pq_getmsgend(&input_message);
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 3349 3350

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

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

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

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

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

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

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

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

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

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

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

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

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

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

3448
	return 1;					/* keep compiler quiet */
3449 3450
}

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

3457 3458
static struct rusage Save_r;
static struct timeval Save_t;
3459 3460

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

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

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

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

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

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

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

	pfree(str.data);
3564
}
3565 3566 3567 3568

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

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

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

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