PostgreSQL Source Code  git master
tcopprot.h File Reference
#include "nodes/params.h"
#include "nodes/parsenodes.h"
#include "nodes/plannodes.h"
#include "storage/procsignal.h"
#include "utils/guc.h"
#include "utils/queryenvironment.h"
Include dependency graph for tcopprot.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros

#define STACK_DEPTH_SLOP   (512 * 1024L)
 

Enumerations

enum  LogStmtLevel { LOGSTMT_NONE, LOGSTMT_DDL, LOGSTMT_MOD, LOGSTMT_ALL }
 

Functions

Listpg_parse_query (const char *query_string)
 
Listpg_analyze_and_rewrite (RawStmt *parsetree, const char *query_string, Oid *paramTypes, int numParams, QueryEnvironment *queryEnv)
 
Listpg_analyze_and_rewrite_params (RawStmt *parsetree, const char *query_string, ParserSetupHook parserSetup, void *parserSetupArg, QueryEnvironment *queryEnv)
 
PlannedStmtpg_plan_query (Query *querytree, int cursorOptions, ParamListInfo boundParams)
 
Listpg_plan_queries (List *querytrees, int cursorOptions, ParamListInfo boundParams)
 
bool check_max_stack_depth (int *newval, void **extra, GucSource source)
 
void assign_max_stack_depth (int newval, void *extra)
 
void die (SIGNAL_ARGS)
 
void quickdie (SIGNAL_ARGS) pg_attribute_noreturn()
 
void StatementCancelHandler (SIGNAL_ARGS)
 
void FloatExceptionHandler (SIGNAL_ARGS) pg_attribute_noreturn()
 
void RecoveryConflictInterrupt (ProcSignalReason reason)
 
void ProcessClientReadInterrupt (bool blocked)
 
void ProcessClientWriteInterrupt (bool blocked)
 
void process_postgres_switches (int argc, char *argv[], GucContext ctx, const char **dbname)
 
void PostgresMain (int argc, char *argv[], const char *dbname, const char *username) pg_attribute_noreturn()
 
long get_stack_depth_rlimit (void)
 
void ResetUsage (void)
 
void ShowUsage (const char *title)
 
int check_log_duration (char *msec_str, bool was_logged)
 
void set_debug_options (int debug_flag, GucContext context, GucSource source)
 
bool set_plan_disabling_options (const char *arg, GucContext context, GucSource source)
 
const char * get_stats_option_name (const char *arg)
 

Variables

CommandDest whereToSendOutput
 
PGDLLIMPORT const char * debug_query_string
 
int max_stack_depth
 
int PostAuthDelay
 
PGDLLIMPORT int log_statement
 

Macro Definition Documentation

◆ STACK_DEPTH_SLOP

#define STACK_DEPTH_SLOP   (512 * 1024L)

Definition at line 26 of file tcopprot.h.

Referenced by check_max_stack_depth(), and InitializeGUCOptionsFromEnvironment().

Enumeration Type Documentation

◆ LogStmtLevel

Enumerator
LOGSTMT_NONE 
LOGSTMT_DDL 
LOGSTMT_MOD 
LOGSTMT_ALL 

Definition at line 35 of file tcopprot.h.

36 {
37  LOGSTMT_NONE, /* log no statements */
38  LOGSTMT_DDL, /* log data definition statements */
39  LOGSTMT_MOD, /* log modification statements, plus DDL */
40  LOGSTMT_ALL /* log all statements */
41 } LogStmtLevel;
LogStmtLevel
Definition: tcopprot.h:35

Function Documentation

◆ assign_max_stack_depth()

void assign_max_stack_depth ( int  newval,
void *  extra 
)

Definition at line 3368 of file postgres.c.

References max_stack_depth_bytes.

3369 {
3370  long newval_bytes = newval * 1024L;
3371 
3372  max_stack_depth_bytes = newval_bytes;
3373 }
static long max_stack_depth_bytes
Definition: postgres.c:112
#define newval

◆ check_log_duration()

int check_log_duration ( char *  msec_str,
bool  was_logged 
)

Definition at line 2300 of file postgres.c.

References GetCurrentStatementStartTimestamp(), GetCurrentTimestamp(), log_duration, log_min_duration_sample, log_min_duration_statement, log_statement_sample_rate, MAX_RANDOM_VALUE, random(), snprintf, TimestampDifference(), and xact_is_sampled.

Referenced by exec_bind_message(), exec_execute_message(), exec_parse_message(), exec_simple_query(), and HandleFunctionRequest().

2301 {
2302  if (log_duration || log_min_duration_sample >= 0 ||
2304  {
2305  long secs;
2306  int usecs;
2307  int msecs;
2308  bool exceeded_duration;
2309  bool exceeded_sample_duration;
2310  bool in_sample = false;
2311 
2314  &secs, &usecs);
2315  msecs = usecs / 1000;
2316 
2317  /*
2318  * This odd-looking test for log_min_duration_* being exceeded is
2319  * designed to avoid integer overflow with very long durations: don't
2320  * compute secs * 1000 until we've verified it will fit in int.
2321  */
2322  exceeded_duration = (log_min_duration_statement == 0 ||
2324  (secs > log_min_duration_statement / 1000 ||
2325  secs * 1000 + msecs >= log_min_duration_statement)));
2326 
2327  exceeded_sample_duration = (log_min_duration_sample == 0 ||
2328  (log_min_duration_sample > 0 &&
2329  (secs > log_min_duration_sample / 1000 ||
2330  secs * 1000 + msecs >= log_min_duration_sample)));
2331 
2332  /*
2333  * Do not log if log_statement_sample_rate = 0. Log a sample if
2334  * log_statement_sample_rate <= 1 and avoid unecessary random() call
2335  * if log_statement_sample_rate = 1.
2336  */
2337  if (exceeded_sample_duration)
2338  in_sample = log_statement_sample_rate != 0 &&
2339  (log_statement_sample_rate == 1 ||
2341 
2342  if (exceeded_duration || in_sample || log_duration || xact_is_sampled)
2343  {
2344  snprintf(msec_str, 32, "%ld.%03d",
2345  secs * 1000 + msecs, usecs % 1000);
2346  if ((exceeded_duration || in_sample || xact_is_sampled) && !was_logged)
2347  return 2;
2348  else
2349  return 1;
2350  }
2351  }
2352 
2353  return 0;
2354 }
int log_min_duration_statement
Definition: guc.c:517
double log_statement_sample_rate
Definition: guc.c:519
TimestampTz GetCurrentTimestamp(void)
Definition: timestamp.c:1583
long random(void)
Definition: random.c:22
int log_min_duration_sample
Definition: guc.c:516
#define MAX_RANDOM_VALUE
bool xact_is_sampled
Definition: xact.c:267
bool log_duration
Definition: guc.c:488
void TimestampDifference(TimestampTz start_time, TimestampTz stop_time, long *secs, int *microsecs)
Definition: timestamp.c:1657
#define snprintf
Definition: port.h:192
TimestampTz GetCurrentStatementStartTimestamp(void)
Definition: xact.c:791

◆ check_max_stack_depth()

bool check_max_stack_depth ( int *  newval,
void **  extra,
GucSource  source 
)

Definition at line 3351 of file postgres.c.

References get_stack_depth_rlimit(), GUC_check_errdetail, GUC_check_errhint, and STACK_DEPTH_SLOP.

3352 {
3353  long newval_bytes = *newval * 1024L;
3354  long stack_rlimit = get_stack_depth_rlimit();
3355 
3356  if (stack_rlimit > 0 && newval_bytes > stack_rlimit - STACK_DEPTH_SLOP)
3357  {
3358  GUC_check_errdetail("\"max_stack_depth\" must not exceed %ldkB.",
3359  (stack_rlimit - STACK_DEPTH_SLOP) / 1024L);
3360  GUC_check_errhint("Increase the platform's stack depth limit via \"ulimit -s\" or local equivalent.");
3361  return false;
3362  }
3363  return true;
3364 }
#define GUC_check_errdetail
Definition: guc.h:414
long get_stack_depth_rlimit(void)
Definition: postgres.c:4551
#define newval
#define GUC_check_errhint
Definition: guc.h:418
#define STACK_DEPTH_SLOP
Definition: tcopprot.h:26

◆ die()

void die ( SIGNAL_ARGS  )

Definition at line 2802 of file postgres.c.

References DestRemote, DoingCommandRead, InterruptPending, MyLatch, proc_exit_inprogress, ProcDiePending, ProcessInterrupts(), SetLatch(), and whereToSendOutput.

Referenced by PostgresMain().

2803 {
2804  int save_errno = errno;
2805 
2806  /* Don't joggle the elbow of proc_exit */
2807  if (!proc_exit_inprogress)
2808  {
2809  InterruptPending = true;
2810  ProcDiePending = true;
2811  }
2812 
2813  /* If we're still here, waken anything waiting on the process latch */
2814  SetLatch(MyLatch);
2815 
2816  /*
2817  * If we're in single user mode, we want to quit immediately - we can't
2818  * rely on latches as they wouldn't work when stdin/stdout is a file.
2819  * Rather ugly, but it's unlikely to be worthwhile to invest much more
2820  * effort just for the benefit of single user mode.
2821  */
2824 
2825  errno = save_errno;
2826 }
void SetLatch(Latch *latch)
Definition: latch.c:436
void ProcessInterrupts(void)
Definition: postgres.c:2995
volatile sig_atomic_t ProcDiePending
Definition: globals.c:32
bool proc_exit_inprogress
Definition: ipc.c:40
static bool DoingCommandRead
Definition: postgres.c:140
volatile sig_atomic_t InterruptPending
Definition: globals.c:30
struct Latch * MyLatch
Definition: globals.c:54
CommandDest whereToSendOutput
Definition: postgres.c:91

◆ FloatExceptionHandler()

void FloatExceptionHandler ( SIGNAL_ARGS  )

Definition at line 2854 of file postgres.c.

References ereport, errcode(), errdetail(), errmsg(), and ERROR.

Referenced by AutoVacLauncherMain(), AutoVacWorkerMain(), plperl_init_interp(), PostgresMain(), and StartBackgroundWorker().

2855 {
2856  /* We're not returning, so no need to save errno */
2857  ereport(ERROR,
2858  (errcode(ERRCODE_FLOATING_POINT_EXCEPTION),
2859  errmsg("floating-point exception"),
2860  errdetail("An invalid floating-point operation was signaled. "
2861  "This probably means an out-of-range result or an "
2862  "invalid operation, such as division by zero.")));
2863 }
int errcode(int sqlerrcode)
Definition: elog.c:608
#define ERROR
Definition: elog.h:43
int errdetail(const char *fmt,...)
Definition: elog.c:955
#define ereport(elevel, rest)
Definition: elog.h:141
int errmsg(const char *fmt,...)
Definition: elog.c:822

◆ get_stack_depth_rlimit()

long get_stack_depth_rlimit ( void  )

Definition at line 4551 of file postgres.c.

References val.

Referenced by check_max_stack_depth(), and InitializeGUCOptionsFromEnvironment().

4552 {
4553 #if defined(HAVE_GETRLIMIT) && defined(RLIMIT_STACK)
4554  static long val = 0;
4555 
4556  /* This won't change after process launch, so check just once */
4557  if (val == 0)
4558  {
4559  struct rlimit rlim;
4560 
4561  if (getrlimit(RLIMIT_STACK, &rlim) < 0)
4562  val = -1;
4563  else if (rlim.rlim_cur == RLIM_INFINITY)
4564  val = LONG_MAX;
4565  /* rlim_cur is probably of an unsigned type, so check for overflow */
4566  else if (rlim.rlim_cur >= LONG_MAX)
4567  val = LONG_MAX;
4568  else
4569  val = rlim.rlim_cur;
4570  }
4571  return val;
4572 #else /* no getrlimit */
4573 #if defined(WIN32) || defined(__CYGWIN__)
4574  /* On Windows we set the backend stack size in src/backend/Makefile */
4575  return WIN32_STACK_RLIMIT;
4576 #else /* not windows ... give up */
4577  return -1;
4578 #endif
4579 #endif
4580 }
long val
Definition: informix.c:664

◆ get_stats_option_name()

const char* get_stats_option_name ( const char *  arg)

Definition at line 3454 of file postgres.c.

References optarg.

Referenced by PostmasterMain(), and process_postgres_switches().

3455 {
3456  switch (arg[0])
3457  {
3458  case 'p':
3459  if (optarg[1] == 'a') /* "parser" */
3460  return "log_parser_stats";
3461  else if (optarg[1] == 'l') /* "planner" */
3462  return "log_planner_stats";
3463  break;
3464 
3465  case 'e': /* "executor" */
3466  return "log_executor_stats";
3467  break;
3468  }
3469 
3470  return NULL;
3471 }
char * optarg
Definition: getopt.c:52
void * arg

◆ pg_analyze_and_rewrite()

List* pg_analyze_and_rewrite ( RawStmt parsetree,
const char *  query_string,
Oid paramTypes,
int  numParams,
QueryEnvironment queryEnv 
)

Definition at line 676 of file postgres.c.

References log_parser_stats, parse_analyze(), pg_rewrite_query(), ResetUsage(), and ShowUsage().

Referenced by _SPI_execute_plan(), _SPI_prepare_plan(), BeginCopy(), exec_simple_query(), execute_sql_string(), and RevalidateCachedQuery().

679 {
680  Query *query;
681  List *querytree_list;
682 
683  TRACE_POSTGRESQL_QUERY_REWRITE_START(query_string);
684 
685  /*
686  * (1) Perform parse analysis.
687  */
688  if (log_parser_stats)
689  ResetUsage();
690 
691  query = parse_analyze(parsetree, query_string, paramTypes, numParams,
692  queryEnv);
693 
694  if (log_parser_stats)
695  ShowUsage("PARSE ANALYSIS STATISTICS");
696 
697  /*
698  * (2) Rewrite the queries, as necessary
699  */
700  querytree_list = pg_rewrite_query(query);
701 
702  TRACE_POSTGRESQL_QUERY_REWRITE_DONE(query_string);
703 
704  return querytree_list;
705 }
bool log_parser_stats
Definition: guc.c:495
void ShowUsage(const char *title)
Definition: postgres.c:4594
void ResetUsage(void)
Definition: postgres.c:4587
static List * pg_rewrite_query(Query *query)
Definition: postgres.c:765
Query * parse_analyze(RawStmt *parseTree, const char *sourceText, Oid *paramTypes, int numParams, QueryEnvironment *queryEnv)
Definition: analyze.c:100
Definition: pg_list.h:50

◆ pg_analyze_and_rewrite_params()

List* pg_analyze_and_rewrite_params ( RawStmt parsetree,
const char *  query_string,
ParserSetupHook  parserSetup,
void *  parserSetupArg,
QueryEnvironment queryEnv 
)

Definition at line 713 of file postgres.c.

References Assert, free_parsestate(), log_parser_stats, make_parsestate(), ParseState::p_queryEnv, ParseState::p_sourcetext, pg_rewrite_query(), post_parse_analyze_hook, ResetUsage(), ShowUsage(), and transformTopLevelStmt().

Referenced by _SPI_execute_plan(), _SPI_prepare_plan(), fmgr_sql_validator(), init_sql_fcache(), inline_set_returning_function(), and RevalidateCachedQuery().

718 {
719  ParseState *pstate;
720  Query *query;
721  List *querytree_list;
722 
723  Assert(query_string != NULL); /* required as of 8.4 */
724 
725  TRACE_POSTGRESQL_QUERY_REWRITE_START(query_string);
726 
727  /*
728  * (1) Perform parse analysis.
729  */
730  if (log_parser_stats)
731  ResetUsage();
732 
733  pstate = make_parsestate(NULL);
734  pstate->p_sourcetext = query_string;
735  pstate->p_queryEnv = queryEnv;
736  (*parserSetup) (pstate, parserSetupArg);
737 
738  query = transformTopLevelStmt(pstate, parsetree);
739 
741  (*post_parse_analyze_hook) (pstate, query);
742 
743  free_parsestate(pstate);
744 
745  if (log_parser_stats)
746  ShowUsage("PARSE ANALYSIS STATISTICS");
747 
748  /*
749  * (2) Rewrite the queries, as necessary
750  */
751  querytree_list = pg_rewrite_query(query);
752 
753  TRACE_POSTGRESQL_QUERY_REWRITE_DONE(query_string);
754 
755  return querytree_list;
756 }
bool log_parser_stats
Definition: guc.c:495
QueryEnvironment * p_queryEnv
Definition: parse_node.h:203
void ShowUsage(const char *title)
Definition: postgres.c:4594
ParseState * make_parsestate(ParseState *parentParseState)
Definition: parse_node.c:43
void ResetUsage(void)
Definition: postgres.c:4587
const char * p_sourcetext
Definition: parse_node.h:179
static List * pg_rewrite_query(Query *query)
Definition: postgres.c:765
#define Assert(condition)
Definition: c.h:739
Query * transformTopLevelStmt(ParseState *pstate, RawStmt *parseTree)
Definition: analyze.c:191
void free_parsestate(ParseState *pstate)
Definition: parse_node.c:76
Definition: pg_list.h:50
post_parse_analyze_hook_type post_parse_analyze_hook
Definition: analyze.c:51

◆ pg_parse_query()

List* pg_parse_query ( const char *  query_string)

Definition at line 628 of file postgres.c.

References copyObject, elog, equal(), log_parser_stats, new_list(), raw_parser(), ResetUsage(), ShowUsage(), and WARNING.

Referenced by _SPI_prepare_oneshot_plan(), _SPI_prepare_plan(), exec_parse_message(), exec_simple_query(), execute_sql_string(), fmgr_sql_validator(), ImportForeignSchema(), init_sql_fcache(), inline_function(), and inline_set_returning_function().

629 {
630  List *raw_parsetree_list;
631 
632  TRACE_POSTGRESQL_QUERY_PARSE_START(query_string);
633 
634  if (log_parser_stats)
635  ResetUsage();
636 
637  raw_parsetree_list = raw_parser(query_string);
638 
639  if (log_parser_stats)
640  ShowUsage("PARSER STATISTICS");
641 
642 #ifdef COPY_PARSE_PLAN_TREES
643  /* Optional debugging check: pass raw parsetrees through copyObject() */
644  {
645  List *new_list = copyObject(raw_parsetree_list);
646 
647  /* This checks both copyObject() and the equal() routines... */
648  if (!equal(new_list, raw_parsetree_list))
649  elog(WARNING, "copyObject() failed to produce an equal raw parse tree");
650  else
651  raw_parsetree_list = new_list;
652  }
653 #endif
654 
655  /*
656  * Currently, outfuncs/readfuncs support is missing for many raw parse
657  * tree nodes, so we don't try to implement WRITE_READ_PARSE_PLAN_TREES
658  * here.
659  */
660 
661  TRACE_POSTGRESQL_QUERY_PARSE_DONE(query_string);
662 
663  return raw_parsetree_list;
664 }
List * raw_parser(const char *str)
Definition: parser.c:42
bool log_parser_stats
Definition: guc.c:495
bool equal(const void *a, const void *b)
Definition: equalfuncs.c:3018
void ShowUsage(const char *title)
Definition: postgres.c:4594
void ResetUsage(void)
Definition: postgres.c:4587
#define WARNING
Definition: elog.h:40
#define elog(elevel,...)
Definition: elog.h:228
#define copyObject(obj)
Definition: nodes.h:641
Definition: pg_list.h:50
static List * new_list(NodeTag type, int min_size)
Definition: list.c:87

◆ pg_plan_queries()

List* pg_plan_queries ( List querytrees,
int  cursorOptions,
ParamListInfo  boundParams 
)

Definition at line 942 of file postgres.c.

References PlannedStmt::canSetTag, Query::canSetTag, CMD_UTILITY, PlannedStmt::commandType, Query::commandType, lappend(), lfirst_node, makeNode, NIL, pg_plan_query(), PlannedStmt::stmt_len, Query::stmt_len, PlannedStmt::stmt_location, Query::stmt_location, PlannedStmt::utilityStmt, and Query::utilityStmt.

Referenced by BuildCachedPlan(), exec_simple_query(), and execute_sql_string().

943 {
944  List *stmt_list = NIL;
945  ListCell *query_list;
946 
947  foreach(query_list, querytrees)
948  {
949  Query *query = lfirst_node(Query, query_list);
950  PlannedStmt *stmt;
951 
952  if (query->commandType == CMD_UTILITY)
953  {
954  /* Utility commands require no planning. */
955  stmt = makeNode(PlannedStmt);
956  stmt->commandType = CMD_UTILITY;
957  stmt->canSetTag = query->canSetTag;
958  stmt->utilityStmt = query->utilityStmt;
959  stmt->stmt_location = query->stmt_location;
960  stmt->stmt_len = query->stmt_len;
961  }
962  else
963  {
964  stmt = pg_plan_query(query, cursorOptions, boundParams);
965  }
966 
967  stmt_list = lappend(stmt_list, stmt);
968  }
969 
970  return stmt_list;
971 }
#define NIL
Definition: pg_list.h:65
int stmt_location
Definition: parsenodes.h:180
Node * utilityStmt
Definition: parsenodes.h:120
int stmt_len
Definition: plannodes.h:96
#define lfirst_node(type, lc)
Definition: pg_list.h:193
int stmt_location
Definition: plannodes.h:95
Node * utilityStmt
Definition: plannodes.h:92
List * lappend(List *list, void *datum)
Definition: list.c:322
bool canSetTag
Definition: plannodes.h:54
CmdType commandType
Definition: plannodes.h:46
CmdType commandType
Definition: parsenodes.h:112
#define makeNode(_type_)
Definition: nodes.h:573
bool canSetTag
Definition: parsenodes.h:118
Definition: pg_list.h:50
int stmt_len
Definition: parsenodes.h:181
PlannedStmt * pg_plan_query(Query *querytree, int cursorOptions, ParamListInfo boundParams)
Definition: postgres.c:857

◆ pg_plan_query()

PlannedStmt* pg_plan_query ( Query querytree,
int  cursorOptions,
ParamListInfo  boundParams 
)

Definition at line 857 of file postgres.c.

References ActiveSnapshotSet(), Assert, CMD_UTILITY, Query::commandType, copyObject, Debug_pretty_print, Debug_print_plan, elog, elog_node_display(), equal(), LOG, log_planner_stats, nodeToString(), pfree(), planner(), ResetUsage(), ShowUsage(), generate_unaccent_rules::str, and WARNING.

Referenced by BeginCopy(), ExecCreateTableAs(), ExplainOneQuery(), init_execution_state(), PerformCursorOpen(), pg_plan_queries(), and refresh_matview_datafill().

858 {
859  PlannedStmt *plan;
860 
861  /* Utility commands have no plans. */
862  if (querytree->commandType == CMD_UTILITY)
863  return NULL;
864 
865  /* Planner must have a snapshot in case it calls user-defined functions. */
867 
868  TRACE_POSTGRESQL_QUERY_PLAN_START();
869 
870  if (log_planner_stats)
871  ResetUsage();
872 
873  /* call the optimizer */
874  plan = planner(querytree, cursorOptions, boundParams);
875 
876  if (log_planner_stats)
877  ShowUsage("PLANNER STATISTICS");
878 
879 #ifdef COPY_PARSE_PLAN_TREES
880  /* Optional debugging check: pass plan tree through copyObject() */
881  {
882  PlannedStmt *new_plan = copyObject(plan);
883 
884  /*
885  * equal() currently does not have routines to compare Plan nodes, so
886  * don't try to test equality here. Perhaps fix someday?
887  */
888 #ifdef NOT_USED
889  /* This checks both copyObject() and the equal() routines... */
890  if (!equal(new_plan, plan))
891  elog(WARNING, "copyObject() failed to produce an equal plan tree");
892  else
893 #endif
894  plan = new_plan;
895  }
896 #endif
897 
898 #ifdef WRITE_READ_PARSE_PLAN_TREES
899  /* Optional debugging check: pass plan tree through outfuncs/readfuncs */
900  {
901  char *str;
902  PlannedStmt *new_plan;
903 
904  str = nodeToString(plan);
905  new_plan = stringToNodeWithLocations(str);
906  pfree(str);
907 
908  /*
909  * equal() currently does not have routines to compare Plan nodes, so
910  * don't try to test equality here. Perhaps fix someday?
911  */
912 #ifdef NOT_USED
913  /* This checks both outfuncs/readfuncs and the equal() routines... */
914  if (!equal(new_plan, plan))
915  elog(WARNING, "outfuncs/readfuncs failed to produce an equal plan tree");
916  else
917 #endif
918  plan = new_plan;
919  }
920 #endif
921 
922  /*
923  * Print plan if debugging.
924  */
925  if (Debug_print_plan)
926  elog_node_display(LOG, "plan", plan, Debug_pretty_print);
927 
928  TRACE_POSTGRESQL_QUERY_PLAN_DONE();
929 
930  return plan;
931 }
void elog_node_display(int lev, const char *title, const void *obj, bool pretty)
Definition: print.c:72
bool equal(const void *a, const void *b)
Definition: equalfuncs.c:3018
void ShowUsage(const char *title)
Definition: postgres.c:4594
#define LOG
Definition: elog.h:26
PlannedStmt * planner(Query *parse, int cursorOptions, ParamListInfo boundParams)
Definition: planner.c:267
void ResetUsage(void)
Definition: postgres.c:4587
bool Debug_print_plan
Definition: guc.c:490
void pfree(void *pointer)
Definition: mcxt.c:1056
bool ActiveSnapshotSet(void)
Definition: snapmgr.c:853
#define WARNING
Definition: elog.h:40
CmdType commandType
Definition: parsenodes.h:112
#define Assert(condition)
Definition: c.h:739
#define elog(elevel,...)
Definition: elog.h:228
bool Debug_pretty_print
Definition: guc.c:493
char * nodeToString(const void *obj)
Definition: outfuncs.c:4325
#define copyObject(obj)
Definition: nodes.h:641
bool log_planner_stats
Definition: guc.c:496

◆ PostgresMain()

void PostgresMain ( int  argc,
char *  argv[],
const char *  dbname,
const char *  username 
)

Definition at line 3753 of file postgres.c.

References AbortCurrentTransaction(), ALLOCSET_DEFAULT_SIZES, AllocSetContextCreate, am_walsender, BaseInit(), BeginReportingGUCOptions(), BlockSig, buf, ChangeToDataDir(), CHECK_FOR_INTERRUPTS, checkDataDir(), ConfigReloadPending, CreateDataDirLockFile(), debug_query_string, DestDebug, DestNone, DestRemote, die(), disable_all_timeouts(), disable_timeout(), doing_extended_query_message, DoingCommandRead, drop_unnamed_stmt(), DropPreparedStatement(), EmitErrorReport(), enable_timeout_after(), ereport, errcode(), errmsg(), ERROR, error_context_stack, exec_bind_message(), exec_describe_portal_message(), exec_describe_statement_message(), exec_execute_message(), exec_parse_message(), exec_replication_command(), exec_simple_query(), FATAL, finish_xact_command(), FloatExceptionHandler(), FlushErrorState(), forbidden_in_wal_sender(), GetCurrentTimestamp(), GetPortalByName(), HandleFunctionRequest(), HOLD_INTERRUPTS, i, IDLE_IN_TRANSACTION_SESSION_TIMEOUT, IdleInTransactionSessionTimeout, ignore_till_sync, InitializeGUCOptions(), InitializeMaxBackends(), InitializeTimeouts(), InitPostgres(), InitProcess(), InitProcessing, InitStandaloneProcess(), initStringInfo(), InitWalSender(), InvalidateCatalogSnapshotConditionally(), InvalidOid, IsAbortedTransactionBlockState(), IsTransactionOrTransactionBlock(), IsUnderPostmaster, jit_reset_after_error(), LocalProcessControlFile(), Log_disconnections, log_disconnections(), MemoryContextDelete(), MemoryContextResetAndDeleteChildren, MemoryContextSwitchTo(), MessageContext, MyCancelKey, MyProcPid, MyReplicationSlot, NormalProcessing, notifyInterruptPending, on_proc_exit(), palloc(), PG_exception_stack, PG_SETMASK, PGC_POSTMASTER, PGC_SIGHUP, PgStartTime, pgstat_report_activity(), pgstat_report_stat(), PortalDrop(), PortalErrorCleanup(), PortalIsValid, PostmasterContext, pq_beginmessage(), pq_comm_reset, pq_endmessage(), pq_flush, pq_getmsgbyte(), pq_getmsgend(), pq_getmsgint(), pq_getmsgstring(), pq_is_reading_msg(), pq_putemptymessage(), pq_sendint32(), pqinitmask(), pqsignal(), printf, proc_exit(), process_postgres_switches(), process_session_preload_libraries(), ProcessCompletedNotifies(), ProcessConfigFile(), ProcessNotifyInterrupt(), procsignal_sigusr1_handler(), progname, QueryCancelPending, quickdie(), ReadCommand(), ReadyForQuery(), ReplicationSlotCleanup(), ReplicationSlotRelease(), RESUME_INTERRUPTS, SelectConfigFiles(), set_ps_display(), SetCurrentStatementStartTimestamp(), SetProcessingMode, SIG_DFL, SIG_IGN, SIGCHLD, SIGHUP, SignalHandlerForConfigReload(), SIGPIPE, SIGQUIT, SIGUSR1, SIGUSR2, SPICleanup(), start_xact_command(), STATE_FASTPATH, STATE_IDLE, STATE_IDLEINTRANSACTION, STATE_IDLEINTRANSACTION_ABORTED, StatementCancelHandler(), TopMemoryContext, UnBlockSig, userDoption, username, WalSndErrorCleanup(), WalSndSignals(), whereToSendOutput, and xact_started.

Referenced by BackendRun(), and main().

3756 {
3757  int firstchar;
3758  StringInfoData input_message;
3759  sigjmp_buf local_sigjmp_buf;
3760  volatile bool send_ready_for_query = true;
3761  bool disable_idle_in_transaction_timeout = false;
3762 
3763  /* Initialize startup process environment if necessary. */
3764  if (!IsUnderPostmaster)
3765  InitStandaloneProcess(argv[0]);
3766 
3768 
3769  /*
3770  * Set default values for command-line options.
3771  */
3772  if (!IsUnderPostmaster)
3774 
3775  /*
3776  * Parse command-line options.
3777  */
3779 
3780  /* Must have gotten a database name, or have a default (the username) */
3781  if (dbname == NULL)
3782  {
3783  dbname = username;
3784  if (dbname == NULL)
3785  ereport(FATAL,
3786  (errcode(ERRCODE_INVALID_PARAMETER_VALUE),
3787  errmsg("%s: no database nor user name specified",
3788  progname)));
3789  }
3790 
3791  /* Acquire configuration parameters, unless inherited from postmaster */
3792  if (!IsUnderPostmaster)
3793  {
3795  proc_exit(1);
3796  }
3797 
3798  /*
3799  * Set up signal handlers and masks.
3800  *
3801  * Note that postmaster blocked all signals before forking child process,
3802  * so there is no race condition whereby we might receive a signal before
3803  * we have set up the handler.
3804  *
3805  * Also note: it's best not to use any signals that are SIG_IGNored in the
3806  * postmaster. If such a signal arrives before we are able to change the
3807  * handler to non-SIG_IGN, it'll get dropped. Instead, make a dummy
3808  * handler in the postmaster to reserve the signal. (Of course, this isn't
3809  * an issue for signals that are locally generated, such as SIGALRM and
3810  * SIGPIPE.)
3811  */
3812  if (am_walsender)
3813  WalSndSignals();
3814  else
3815  {
3817  pqsignal(SIGINT, StatementCancelHandler); /* cancel current query */
3818  pqsignal(SIGTERM, die); /* cancel current query and exit */
3819 
3820  /*
3821  * In a standalone backend, SIGQUIT can be generated from the keyboard
3822  * easily, while SIGTERM cannot, so we make both signals do die()
3823  * rather than quickdie().
3824  */
3825  if (IsUnderPostmaster)
3826  pqsignal(SIGQUIT, quickdie); /* hard crash time */
3827  else
3828  pqsignal(SIGQUIT, die); /* cancel current query and exit */
3829  InitializeTimeouts(); /* establishes SIGALRM handler */
3830 
3831  /*
3832  * Ignore failure to write to frontend. Note: if frontend closes
3833  * connection, we will notice it and exit cleanly when control next
3834  * returns to outer loop. This seems safer than forcing exit in the
3835  * midst of output during who-knows-what operation...
3836  */
3841 
3842  /*
3843  * Reset some signals that are accepted by postmaster but not by
3844  * backend
3845  */
3846  pqsignal(SIGCHLD, SIG_DFL); /* system() requires this on some
3847  * platforms */
3848  }
3849 
3850  pqinitmask();
3851 
3852  if (IsUnderPostmaster)
3853  {
3854  /* We allow SIGQUIT (quickdie) at all times */
3855  sigdelset(&BlockSig, SIGQUIT);
3856  }
3857 
3858  PG_SETMASK(&BlockSig); /* block everything except SIGQUIT */
3859 
3860  if (!IsUnderPostmaster)
3861  {
3862  /*
3863  * Validate we have been given a reasonable-looking DataDir (if under
3864  * postmaster, assume postmaster did this already).
3865  */
3866  checkDataDir();
3867 
3868  /* Change into DataDir (if under postmaster, was done already) */
3869  ChangeToDataDir();
3870 
3871  /*
3872  * Create lockfile for data directory.
3873  */
3874  CreateDataDirLockFile(false);
3875 
3876  /* read control file (error checking and contains config ) */
3877  LocalProcessControlFile(false);
3878 
3879  /* Initialize MaxBackends (if under postmaster, was done already) */
3881  }
3882 
3883  /* Early initialization */
3884  BaseInit();
3885 
3886  /*
3887  * Create a per-backend PGPROC struct in shared memory, except in the
3888  * EXEC_BACKEND case where this was done in SubPostmasterMain. We must do
3889  * this before we can use LWLocks (and in the EXEC_BACKEND case we already
3890  * had to do some stuff with LWLocks).
3891  */
3892 #ifdef EXEC_BACKEND
3893  if (!IsUnderPostmaster)
3894  InitProcess();
3895 #else
3896  InitProcess();
3897 #endif
3898 
3899  /* We need to allow SIGINT, etc during the initial transaction */
3901 
3902  /*
3903  * General initialization.
3904  *
3905  * NOTE: if you are tempted to add code in this vicinity, consider putting
3906  * it inside InitPostgres() instead. In particular, anything that
3907  * involves database access should be there, not here.
3908  */
3910 
3911  /*
3912  * If the PostmasterContext is still around, recycle the space; we don't
3913  * need it anymore after InitPostgres completes. Note this does not trash
3914  * *MyProcPort, because ConnCreate() allocated that space with malloc()
3915  * ... else we'd need to copy the Port data first. Also, subsidiary data
3916  * such as the username isn't lost either; see ProcessStartupPacket().
3917  */
3918  if (PostmasterContext)
3919  {
3921  PostmasterContext = NULL;
3922  }
3923 
3925 
3926  /*
3927  * Now all GUC states are fully set up. Report them to client if
3928  * appropriate.
3929  */
3931 
3932  /*
3933  * Also set up handler to log session end; we have to wait till now to be
3934  * sure Log_disconnections has its final value.
3935  */
3938 
3939  /* Perform initialization specific to a WAL sender process. */
3940  if (am_walsender)
3941  InitWalSender();
3942 
3943  /*
3944  * process any libraries that should be preloaded at backend start (this
3945  * likewise can't be done until GUC settings are complete)
3946  */
3948 
3949  /*
3950  * Send this backend's cancellation info to the frontend.
3951  */
3953  {
3955 
3956  pq_beginmessage(&buf, 'K');
3957  pq_sendint32(&buf, (int32) MyProcPid);
3958  pq_sendint32(&buf, (int32) MyCancelKey);
3959  pq_endmessage(&buf);
3960  /* Need not flush since ReadyForQuery will do it. */
3961  }
3962 
3963  /* Welcome banner for standalone case */
3965  printf("\nPostgreSQL stand-alone backend %s\n", PG_VERSION);
3966 
3967  /*
3968  * Create the memory context we will use in the main loop.
3969  *
3970  * MessageContext is reset once per iteration of the main loop, ie, upon
3971  * completion of processing of each command message from the client.
3972  */
3974  "MessageContext",
3976 
3977  /*
3978  * Create memory context and buffer used for RowDescription messages. As
3979  * SendRowDescriptionMessage(), via exec_describe_statement_message(), is
3980  * frequently executed for ever single statement, we don't want to
3981  * allocate a separate buffer every time.
3982  */
3984  "RowDescriptionContext",
3989 
3990  /*
3991  * Remember stand-alone backend startup time
3992  */
3993  if (!IsUnderPostmaster)
3995 
3996  /*
3997  * POSTGRES main processing loop begins here
3998  *
3999  * If an exception is encountered, processing resumes here so we abort the
4000  * current transaction and start a new one.
4001  *
4002  * You might wonder why this isn't coded as an infinite loop around a
4003  * PG_TRY construct. The reason is that this is the bottom of the
4004  * exception stack, and so with PG_TRY there would be no exception handler
4005  * in force at all during the CATCH part. By leaving the outermost setjmp
4006  * always active, we have at least some chance of recovering from an error
4007  * during error recovery. (If we get into an infinite loop thereby, it
4008  * will soon be stopped by overflow of elog.c's internal state stack.)
4009  *
4010  * Note that we use sigsetjmp(..., 1), so that this function's signal mask
4011  * (to wit, UnBlockSig) will be restored when longjmp'ing to here. This
4012  * is essential in case we longjmp'd out of a signal handler on a platform
4013  * where that leaves the signal blocked. It's not redundant with the
4014  * unblock in AbortTransaction() because the latter is only called if we
4015  * were inside a transaction.
4016  */
4017 
4018  if (sigsetjmp(local_sigjmp_buf, 1) != 0)
4019  {
4020  /*
4021  * NOTE: if you are tempted to add more code in this if-block,
4022  * consider the high probability that it should be in
4023  * AbortTransaction() instead. The only stuff done directly here
4024  * should be stuff that is guaranteed to apply *only* for outer-level
4025  * error recovery, such as adjusting the FE/BE protocol status.
4026  */
4027 
4028  /* Since not using PG_TRY, must reset error stack by hand */
4029  error_context_stack = NULL;
4030 
4031  /* Prevent interrupts while cleaning up */
4032  HOLD_INTERRUPTS();
4033 
4034  /*
4035  * Forget any pending QueryCancel request, since we're returning to
4036  * the idle loop anyway, and cancel any active timeout requests. (In
4037  * future we might want to allow some timeout requests to survive, but
4038  * at minimum it'd be necessary to do reschedule_timeouts(), in case
4039  * we got here because of a query cancel interrupting the SIGALRM
4040  * interrupt handler.) Note in particular that we must clear the
4041  * statement and lock timeout indicators, to prevent any future plain
4042  * query cancels from being misreported as timeouts in case we're
4043  * forgetting a timeout cancel.
4044  */
4045  disable_all_timeouts(false);
4046  QueryCancelPending = false; /* second to avoid race condition */
4047 
4048  /* Not reading from the client anymore. */
4049  DoingCommandRead = false;
4050 
4051  /* Make sure libpq is in a good state */
4052  pq_comm_reset();
4053 
4054  /* Report the error to the client and/or server log */
4055  EmitErrorReport();
4056 
4057  /*
4058  * Make sure debug_query_string gets reset before we possibly clobber
4059  * the storage it points at.
4060  */
4061  debug_query_string = NULL;
4062 
4063  /*
4064  * Abort the current transaction in order to recover.
4065  */
4067 
4068  if (am_walsender)
4070 
4072  SPICleanup();
4073 
4074  /*
4075  * We can't release replication slots inside AbortTransaction() as we
4076  * need to be able to start and abort transactions while having a slot
4077  * acquired. But we never need to hold them across top level errors,
4078  * so releasing here is fine. There's another cleanup in ProcKill()
4079  * ensuring we'll correctly cleanup on FATAL errors as well.
4080  */
4081  if (MyReplicationSlot != NULL)
4083 
4084  /* We also want to cleanup temporary slots on error. */
4086 
4088 
4089  /*
4090  * Now return to normal top-level context and clear ErrorContext for
4091  * next time.
4092  */
4094  FlushErrorState();
4095 
4096  /*
4097  * If we were handling an extended-query-protocol message, initiate
4098  * skip till next Sync. This also causes us not to issue
4099  * ReadyForQuery (until we get Sync).
4100  */
4102  ignore_till_sync = true;
4103 
4104  /* We don't have a transaction command open anymore */
4105  xact_started = false;
4106 
4107  /*
4108  * If an error occurred while we were reading a message from the
4109  * client, we have potentially lost track of where the previous
4110  * message ends and the next one begins. Even though we have
4111  * otherwise recovered from the error, we cannot safely read any more
4112  * messages from the client, so there isn't much we can do with the
4113  * connection anymore.
4114  */
4115  if (pq_is_reading_msg())
4116  ereport(FATAL,
4117  (errcode(ERRCODE_PROTOCOL_VIOLATION),
4118  errmsg("terminating connection because protocol synchronization was lost")));
4119 
4120  /* Now we can allow interrupts again */
4122  }
4123 
4124  /* We can now handle ereport(ERROR) */
4125  PG_exception_stack = &local_sigjmp_buf;
4126 
4127  if (!ignore_till_sync)
4128  send_ready_for_query = true; /* initially, or after error */
4129 
4130  /*
4131  * Non-error queries loop here.
4132  */
4133 
4134  for (;;)
4135  {
4136  /*
4137  * At top of loop, reset extended-query-message flag, so that any
4138  * errors encountered in "idle" state don't provoke skip.
4139  */
4141 
4142  /*
4143  * Release storage left over from prior query cycle, and create a new
4144  * query input buffer in the cleared MessageContext.
4145  */
4148 
4149  initStringInfo(&input_message);
4150 
4151  /*
4152  * Also consider releasing our catalog snapshot if any, so that it's
4153  * not preventing advance of global xmin while we wait for the client.
4154  */
4156 
4157  /*
4158  * (1) If we've reached idle state, tell the frontend we're ready for
4159  * a new query.
4160  *
4161  * Note: this includes fflush()'ing the last of the prior output.
4162  *
4163  * This is also a good time to send collected statistics to the
4164  * collector, and to update the PS stats display. We avoid doing
4165  * those every time through the message loop because it'd slow down
4166  * processing of batched messages, and because we don't want to report
4167  * uncommitted updates (that confuses autovacuum). The notification
4168  * processor wants a call too, if we are not in a transaction block.
4169  */
4170  if (send_ready_for_query)
4171  {
4173  {
4174  set_ps_display("idle in transaction (aborted)", false);
4176 
4177  /* Start the idle-in-transaction timer */
4179  {
4180  disable_idle_in_transaction_timeout = true;
4183  }
4184  }
4186  {
4187  set_ps_display("idle in transaction", false);
4189 
4190  /* Start the idle-in-transaction timer */
4192  {
4193  disable_idle_in_transaction_timeout = true;
4196  }
4197  }
4198  else
4199  {
4200  /* Send out notify signals and transmit self-notifies */
4202 
4203  /*
4204  * Also process incoming notifies, if any. This is mostly to
4205  * ensure stable behavior in tests: if any notifies were
4206  * received during the just-finished transaction, they'll be
4207  * seen by the client before ReadyForQuery is.
4208  */
4211 
4212  pgstat_report_stat(false);
4213 
4214  set_ps_display("idle", false);
4216  }
4217 
4219  send_ready_for_query = false;
4220  }
4221 
4222  /*
4223  * (2) Allow asynchronous signals to be executed immediately if they
4224  * come in while we are waiting for client input. (This must be
4225  * conditional since we don't want, say, reads on behalf of COPY FROM
4226  * STDIN doing the same thing.)
4227  */
4228  DoingCommandRead = true;
4229 
4230  /*
4231  * (3) read a command (loop blocks here)
4232  */
4233  firstchar = ReadCommand(&input_message);
4234 
4235  /*
4236  * (4) disable async signal conditions again.
4237  *
4238  * Query cancel is supposed to be a no-op when there is no query in
4239  * progress, so if a query cancel arrived while we were idle, just
4240  * reset QueryCancelPending. ProcessInterrupts() has that effect when
4241  * it's called when DoingCommandRead is set, so check for interrupts
4242  * before resetting DoingCommandRead.
4243  */
4245  DoingCommandRead = false;
4246 
4247  /*
4248  * (5) turn off the idle-in-transaction timeout
4249  */
4250  if (disable_idle_in_transaction_timeout)
4251  {
4253  disable_idle_in_transaction_timeout = false;
4254  }
4255 
4256  /*
4257  * (6) check for any other interesting events that happened while we
4258  * slept.
4259  */
4260  if (ConfigReloadPending)
4261  {
4262  ConfigReloadPending = false;
4264  }
4265 
4266  /*
4267  * (7) process the command. But ignore it if we're skipping till
4268  * Sync.
4269  */
4270  if (ignore_till_sync && firstchar != EOF)
4271  continue;
4272 
4273  switch (firstchar)
4274  {
4275  case 'Q': /* simple query */
4276  {
4277  const char *query_string;
4278 
4279  /* Set statement_timestamp() */
4281 
4282  query_string = pq_getmsgstring(&input_message);
4283  pq_getmsgend(&input_message);
4284 
4285  if (am_walsender)
4286  {
4287  if (!exec_replication_command(query_string))
4288  exec_simple_query(query_string);
4289  }
4290  else
4291  exec_simple_query(query_string);
4292 
4293  send_ready_for_query = true;
4294  }
4295  break;
4296 
4297  case 'P': /* parse */
4298  {
4299  const char *stmt_name;
4300  const char *query_string;
4301  int numParams;
4302  Oid *paramTypes = NULL;
4303 
4304  forbidden_in_wal_sender(firstchar);
4305 
4306  /* Set statement_timestamp() */
4308 
4309  stmt_name = pq_getmsgstring(&input_message);
4310  query_string = pq_getmsgstring(&input_message);
4311  numParams = pq_getmsgint(&input_message, 2);
4312  if (numParams > 0)
4313  {
4314  paramTypes = (Oid *) palloc(numParams * sizeof(Oid));
4315  for (int i = 0; i < numParams; i++)
4316  paramTypes[i] = pq_getmsgint(&input_message, 4);
4317  }
4318  pq_getmsgend(&input_message);
4319 
4320  exec_parse_message(query_string, stmt_name,
4321  paramTypes, numParams);
4322  }
4323  break;
4324 
4325  case 'B': /* bind */
4326  forbidden_in_wal_sender(firstchar);
4327 
4328  /* Set statement_timestamp() */
4330 
4331  /*
4332  * this message is complex enough that it seems best to put
4333  * the field extraction out-of-line
4334  */
4335  exec_bind_message(&input_message);
4336  break;
4337 
4338  case 'E': /* execute */
4339  {
4340  const char *portal_name;
4341  int max_rows;
4342 
4343  forbidden_in_wal_sender(firstchar);
4344 
4345  /* Set statement_timestamp() */
4347 
4348  portal_name = pq_getmsgstring(&input_message);
4349  max_rows = pq_getmsgint(&input_message, 4);
4350  pq_getmsgend(&input_message);
4351 
4352  exec_execute_message(portal_name, max_rows);
4353  }
4354  break;
4355 
4356  case 'F': /* fastpath function call */
4357  forbidden_in_wal_sender(firstchar);
4358 
4359  /* Set statement_timestamp() */
4361 
4362  /* Report query to various monitoring facilities. */
4364  set_ps_display("<FASTPATH>", false);
4365 
4366  /* start an xact for this function invocation */
4368 
4369  /*
4370  * Note: we may at this point be inside an aborted
4371  * transaction. We can't throw error for that until we've
4372  * finished reading the function-call message, so
4373  * HandleFunctionRequest() must check for it after doing so.
4374  * Be careful not to do anything that assumes we're inside a
4375  * valid transaction here.
4376  */
4377 
4378  /* switch back to message context */
4380 
4381  HandleFunctionRequest(&input_message);
4382 
4383  /* commit the function-invocation transaction */
4385 
4386  send_ready_for_query = true;
4387  break;
4388 
4389  case 'C': /* close */
4390  {
4391  int close_type;
4392  const char *close_target;
4393 
4394  forbidden_in_wal_sender(firstchar);
4395 
4396  close_type = pq_getmsgbyte(&input_message);
4397  close_target = pq_getmsgstring(&input_message);
4398  pq_getmsgend(&input_message);
4399 
4400  switch (close_type)
4401  {
4402  case 'S':
4403  if (close_target[0] != '\0')
4404  DropPreparedStatement(close_target, false);
4405  else
4406  {
4407  /* special-case the unnamed statement */
4409  }
4410  break;
4411  case 'P':
4412  {
4413  Portal portal;
4414 
4415  portal = GetPortalByName(close_target);
4416  if (PortalIsValid(portal))
4417  PortalDrop(portal, false);
4418  }
4419  break;
4420  default:
4421  ereport(ERROR,
4422  (errcode(ERRCODE_PROTOCOL_VIOLATION),
4423  errmsg("invalid CLOSE message subtype %d",
4424  close_type)));
4425  break;
4426  }
4427 
4429  pq_putemptymessage('3'); /* CloseComplete */
4430  }
4431  break;
4432 
4433  case 'D': /* describe */
4434  {
4435  int describe_type;
4436  const char *describe_target;
4437 
4438  forbidden_in_wal_sender(firstchar);
4439 
4440  /* Set statement_timestamp() (needed for xact) */
4442 
4443  describe_type = pq_getmsgbyte(&input_message);
4444  describe_target = pq_getmsgstring(&input_message);
4445  pq_getmsgend(&input_message);
4446 
4447  switch (describe_type)
4448  {
4449  case 'S':
4450  exec_describe_statement_message(describe_target);
4451  break;
4452  case 'P':
4453  exec_describe_portal_message(describe_target);
4454  break;
4455  default:
4456  ereport(ERROR,
4457  (errcode(ERRCODE_PROTOCOL_VIOLATION),
4458  errmsg("invalid DESCRIBE message subtype %d",
4459  describe_type)));
4460  break;
4461  }
4462  }
4463  break;
4464 
4465  case 'H': /* flush */
4466  pq_getmsgend(&input_message);
4468  pq_flush();
4469  break;
4470 
4471  case 'S': /* sync */
4472  pq_getmsgend(&input_message);
4474  send_ready_for_query = true;
4475  break;
4476 
4477  /*
4478  * 'X' means that the frontend is closing down the socket. EOF
4479  * means unexpected loss of frontend connection. Either way,
4480  * perform normal shutdown.
4481  */
4482  case 'X':
4483  case EOF:
4484 
4485  /*
4486  * Reset whereToSendOutput to prevent ereport from attempting
4487  * to send any more messages to client.
4488  */
4491 
4492  /*
4493  * NOTE: if you are tempted to add more code here, DON'T!
4494  * Whatever you had in mind to do should be set up as an
4495  * on_proc_exit or on_shmem_exit callback, instead. Otherwise
4496  * it will fail to be called during other backend-shutdown
4497  * scenarios.
4498  */
4499  proc_exit(0);
4500 
4501  case 'd': /* copy data */
4502  case 'c': /* copy done */
4503  case 'f': /* copy fail */
4504 
4505  /*
4506  * Accept but ignore these messages, per protocol spec; we
4507  * probably got here because a COPY failed, and the frontend
4508  * is still sending data.
4509  */
4510  break;
4511 
4512  default:
4513  ereport(FATAL,
4514  (errcode(ERRCODE_PROTOCOL_VIOLATION),
4515  errmsg("invalid frontend message type %d",
4516  firstchar)));
4517  }
4518  } /* end of input-reading loop */
4519 }
void InitializeTimeouts(void)
Definition: timeout.c:346
void AbortCurrentTransaction(void)
Definition: xact.c:3162
static void exec_describe_portal_message(const char *portal_name)
Definition: postgres.c:2559
#define SIGQUIT
Definition: win32_port.h:155
void MemoryContextDelete(MemoryContext context)
Definition: mcxt.c:211
#define AllocSetContextCreate
Definition: memutils.h:170
volatile sig_atomic_t QueryCancelPending
Definition: globals.c:31
void BeginReportingGUCOptions(void)
Definition: guc.c:6083
int MyProcPid
Definition: globals.c:40
#define pq_flush()
Definition: libpq.h:39
static int ReadCommand(StringInfo inBuf)
Definition: postgres.c:505
static void finish_xact_command(void)
Definition: postgres.c:2631
void ProcessConfigFile(GucContext context)
bool exec_replication_command(const char *cmd_string)
Definition: walsender.c:1462
#define SIGUSR1
Definition: win32_port.h:166
TimestampTz GetCurrentTimestamp(void)
Definition: timestamp.c:1583
void on_proc_exit(pg_on_exit_callback function, Datum arg)
Definition: ipc.c:305
void pgstat_report_activity(BackendState state, const char *cmd_str)
Definition: pgstat.c:3114
#define SIGCHLD
Definition: win32_port.h:164
const char * pq_getmsgstring(StringInfo msg)
Definition: pqformat.c:581
Portal GetPortalByName(const char *name)
Definition: portalmem.c:130
void SignalHandlerForConfigReload(SIGNAL_ARGS)
Definition: interrupt.c:56
void InitStandaloneProcess(const char *argv0)
Definition: miscinit.c:318
bool IsAbortedTransactionBlockState(void)
Definition: xact.c:375
static MemoryContext MemoryContextSwitchTo(MemoryContext context)
Definition: palloc.h:109
void SPICleanup(void)
Definition: spi.c:349
void set_ps_display(const char *activity, bool force)
Definition: ps_status.c:335
static void forbidden_in_wal_sender(char firstchar)
Definition: postgres.c:4529
void proc_exit(int code)
Definition: ipc.c:104
int errcode(int sqlerrcode)
Definition: elog.c:608
bool IsTransactionOrTransactionBlock(void)
Definition: xact.c:4653
void pq_putemptymessage(char msgtype)
Definition: pqformat.c:390
#define SetProcessingMode(mode)
Definition: miscadmin.h:378
void BaseInit(void)
Definition: postinit.c:547
#define printf(...)
Definition: port.h:198
void checkDataDir(void)
Definition: miscinit.c:99
#define SIGPIPE
Definition: win32_port.h:159
#define SIGUSR2
Definition: win32_port.h:167
unsigned int Oid
Definition: postgres_ext.h:31
const char * progname
Definition: pg_standby.c:36
void FlushErrorState(void)
Definition: elog.c:1678
#define PG_SETMASK(mask)
Definition: pqsignal.h:19
void pq_beginmessage(StringInfo buf, char msgtype)
Definition: pqformat.c:87
void StatementCancelHandler(SIGNAL_ARGS)
Definition: postgres.c:2833
signed int int32
Definition: c.h:347
static void exec_execute_message(const char *portal_name, long max_rows)
Definition: postgres.c:2019
static void log_disconnections(int code, Datum arg)
Definition: postgres.c:4696
void jit_reset_after_error(void)
Definition: jit.c:128
#define RESUME_INTERRUPTS()
Definition: miscadmin.h:118
ErrorContextCallback * error_context_stack
Definition: elog.c:91
static void pq_sendint32(StringInfo buf, uint32 i)
Definition: pqformat.h:145
void pqinitmask(void)
Definition: pqsignal.c:41
bool am_walsender
Definition: walsender.c:115
void disable_all_timeouts(bool keep_indicators)
Definition: timeout.c:598
#define ERROR
Definition: elog.h:43
void CreateDataDirLockFile(bool amPostmaster)
Definition: miscinit.c:1177
void ProcessNotifyInterrupt(void)
Definition: async.c:1895
bool pq_is_reading_msg(void)
Definition: pqcomm.c:1251
int IdleInTransactionSessionTimeout
Definition: proc.c:63
int32 MyCancelKey
Definition: globals.c:44
void WalSndSignals(void)
Definition: walsender.c:2981
#define FATAL
Definition: elog.h:52
#define ALLOCSET_DEFAULT_SIZES
Definition: memutils.h:192
void InitProcess(void)
Definition: proc.c:304
Definition: dest.h:88
static char * buf
Definition: pg_test_fsync.c:67
bool IsUnderPostmaster
Definition: globals.c:109
static void exec_bind_message(StringInfo input_message)
Definition: postgres.c:1599
Definition: dest.h:89
#define SIGHUP
Definition: win32_port.h:154
void LocalProcessControlFile(bool reset)
Definition: xlog.c:4918
void ChangeToDataDir(void)
Definition: miscinit.c:213
void ReplicationSlotRelease(void)
Definition: slot.c:424
sigset_t UnBlockSig
Definition: pqsignal.c:22
void PortalErrorCleanup(void)
Definition: portalmem.c:908
static bool xact_started
Definition: postgres.c:133
void InitWalSender(void)
#define ereport(elevel, rest)
Definition: elog.h:141
MemoryContext TopMemoryContext
Definition: mcxt.c:44
Definition: guc.h:72
#define SIG_IGN
Definition: win32_port.h:151
void initStringInfo(StringInfo str)
Definition: stringinfo.c:59
const char * debug_query_string
Definition: postgres.c:88
#define MemoryContextResetAndDeleteChildren(ctx)
Definition: memutils.h:67
static void exec_parse_message(const char *query_string, const char *stmt_name, Oid *paramTypes, int numParams)
Definition: postgres.c:1337
#define PortalIsValid(p)
Definition: portal.h:201
static void start_xact_command(void)
Definition: postgres.c:2611
static bool doing_extended_query_message
Definition: postgres.c:146
sigset_t BlockSig
Definition: pqsignal.c:22
void process_session_preload_libraries(void)
Definition: miscinit.c:1596
void WalSndErrorCleanup(void)
Definition: walsender.c:300
bool SelectConfigFiles(const char *userDoption, const char *progname)
Definition: guc.c:5411
void EmitErrorReport(void)
Definition: elog.c:1533
static StringInfoData row_description_buf
Definition: postgres.c:168
TimestampTz PgStartTime
Definition: timestamp.c:49
static char * username
Definition: initdb.c:133
#define InvalidOid
Definition: postgres_ext.h:36
void InitPostgres(const char *in_dbname, Oid dboid, const char *username, Oid useroid, char *out_dbname, bool override_allow_connections)
Definition: postinit.c:589
pqsigfunc pqsignal(int signum, pqsigfunc handler)
Definition: signal.c:170
int pq_getmsgbyte(StringInfo msg)
Definition: pqformat.c:401
void enable_timeout_after(TimeoutId id, int delay_ms)
Definition: timeout.c:435
ReplicationSlot * MyReplicationSlot
Definition: slot.c:96
#define pq_comm_reset()
Definition: libpq.h:38
#define SIG_DFL
Definition: win32_port.h:149
void ProcessCompletedNotifies(void)
Definition: async.c:1223
void HandleFunctionRequest(StringInfo msgBuf)
Definition: fastpath.c:259
void InvalidateCatalogSnapshotConditionally(void)
Definition: snapmgr.c:533
static bool DoingCommandRead
Definition: postgres.c:140
void InitializeMaxBackends(void)
Definition: postinit.c:525
char * dbname
Definition: streamutil.c:50
MemoryContext MessageContext
Definition: mcxt.c:48
sigjmp_buf * PG_exception_stack
Definition: elog.c:93
static const char * userDoption
Definition: postgres.c:157
void SetCurrentStatementStartTimestamp(void)
Definition: xact.c:817
void * palloc(Size size)
Definition: mcxt.c:949
int errmsg(const char *fmt,...)
Definition: elog.c:822
void PortalDrop(Portal portal, bool isTopCommit)
Definition: portalmem.c:465
void ReadyForQuery(CommandDest dest)
Definition: dest.c:250
void pq_endmessage(StringInfo buf)
Definition: pqformat.c:298
void die(SIGNAL_ARGS)
Definition: postgres.c:2802
#define HOLD_INTERRUPTS()
Definition: miscadmin.h:116
volatile sig_atomic_t ConfigReloadPending
Definition: interrupt.c:26
int i
void FloatExceptionHandler(SIGNAL_ARGS)
Definition: postgres.c:2854
static void drop_unnamed_stmt(void)
Definition: postgres.c:2710
void ReplicationSlotCleanup(void)
Definition: slot.c:479
volatile sig_atomic_t notifyInterruptPending
Definition: async.c:415
unsigned int pq_getmsgint(StringInfo msg, int b)
Definition: pqformat.c:417
#define CHECK_FOR_INTERRUPTS()
Definition: miscadmin.h:99
bool Log_disconnections
Definition: postgres.c:94
void process_postgres_switches(int argc, char *argv[], GucContext ctx, const char **dbname)
Definition: postgres.c:3494
void pq_getmsgend(StringInfo msg)
Definition: pqformat.c:637
void disable_timeout(TimeoutId id, bool keep_indicator)
Definition: timeout.c:532
void procsignal_sigusr1_handler(SIGNAL_ARGS)
Definition: procsignal.c:533
CommandDest whereToSendOutput
Definition: postgres.c:91
static bool ignore_till_sync
Definition: postgres.c:147
static MemoryContext row_description_context
Definition: postgres.c:167
void quickdie(SIGNAL_ARGS)
Definition: postgres.c:2735
MemoryContext PostmasterContext
Definition: mcxt.c:46
static void exec_simple_query(const char *query_string)
Definition: postgres.c:980
void InitializeGUCOptions(void)
Definition: guc.c:5189
void pgstat_report_stat(bool force)
Definition: pgstat.c:806
void DropPreparedStatement(const char *stmt_name, bool showError)
Definition: prepare.c:554
static void exec_describe_statement_message(const char *stmt_name)
Definition: postgres.c:2464

◆ process_postgres_switches()

void process_postgres_switches ( int  argc,
char *  argv[],
GucContext  ctx,
const char **  dbname 
)

Definition at line 3494 of file postgres.c.

References EchoQuery, ereport, errcode(), errhint(), errmsg(), ERROR, FATAL, flag(), free, FrontendProtocol, get_stats_option_name(), getopt(), IsBinaryUpgrade, IsUnderPostmaster, MAXPGPATH, name, optarg, opterr, optind, OutputFileName, ParseLongOption(), PGC_POSTMASTER, PGC_S_ARGV, PGC_S_CLIENT, progname, set_debug_options(), set_plan_disabling_options(), SetConfigOption(), strlcpy(), userDoption, UseSemiNewlineNewline, and value.

Referenced by PostgresMain(), and process_startup_options().

3496 {
3497  bool secure = (ctx == PGC_POSTMASTER);
3498  int errs = 0;
3499  GucSource gucsource;
3500  int flag;
3501 
3502  if (secure)
3503  {
3504  gucsource = PGC_S_ARGV; /* switches came from command line */
3505 
3506  /* Ignore the initial --single argument, if present */
3507  if (argc > 1 && strcmp(argv[1], "--single") == 0)
3508  {
3509  argv++;
3510  argc--;
3511  }
3512  }
3513  else
3514  {
3515  gucsource = PGC_S_CLIENT; /* switches came from client */
3516  }
3517 
3518 #ifdef HAVE_INT_OPTERR
3519 
3520  /*
3521  * Turn this off because it's either printed to stderr and not the log
3522  * where we'd want it, or argv[0] is now "--single", which would make for
3523  * a weird error message. We print our own error message below.
3524  */
3525  opterr = 0;
3526 #endif
3527 
3528  /*
3529  * Parse command-line options. CAUTION: keep this in sync with
3530  * postmaster/postmaster.c (the option sets should not conflict) and with
3531  * the common help() function in main/main.c.
3532  */
3533  while ((flag = getopt(argc, argv, "B:bc:C:D:d:EeFf:h:ijk:lN:nOo:Pp:r:S:sTt:v:W:-:")) != -1)
3534  {
3535  switch (flag)
3536  {
3537  case 'B':
3538  SetConfigOption("shared_buffers", optarg, ctx, gucsource);
3539  break;
3540 
3541  case 'b':
3542  /* Undocumented flag used for binary upgrades */
3543  if (secure)
3544  IsBinaryUpgrade = true;
3545  break;
3546 
3547  case 'C':
3548  /* ignored for consistency with the postmaster */
3549  break;
3550 
3551  case 'D':
3552  if (secure)
3553  userDoption = strdup(optarg);
3554  break;
3555 
3556  case 'd':
3557  set_debug_options(atoi(optarg), ctx, gucsource);
3558  break;
3559 
3560  case 'E':
3561  if (secure)
3562  EchoQuery = true;
3563  break;
3564 
3565  case 'e':
3566  SetConfigOption("datestyle", "euro", ctx, gucsource);
3567  break;
3568 
3569  case 'F':
3570  SetConfigOption("fsync", "false", ctx, gucsource);
3571  break;
3572 
3573  case 'f':
3574  if (!set_plan_disabling_options(optarg, ctx, gucsource))
3575  errs++;
3576  break;
3577 
3578  case 'h':
3579  SetConfigOption("listen_addresses", optarg, ctx, gucsource);
3580  break;
3581 
3582  case 'i':
3583  SetConfigOption("listen_addresses", "*", ctx, gucsource);
3584  break;
3585 
3586  case 'j':
3587  if (secure)
3588  UseSemiNewlineNewline = true;
3589  break;
3590 
3591  case 'k':
3592  SetConfigOption("unix_socket_directories", optarg, ctx, gucsource);
3593  break;
3594 
3595  case 'l':
3596  SetConfigOption("ssl", "true", ctx, gucsource);
3597  break;
3598 
3599  case 'N':
3600  SetConfigOption("max_connections", optarg, ctx, gucsource);
3601  break;
3602 
3603  case 'n':
3604  /* ignored for consistency with postmaster */
3605  break;
3606 
3607  case 'O':
3608  SetConfigOption("allow_system_table_mods", "true", ctx, gucsource);
3609  break;
3610 
3611  case 'o':
3612  errs++;
3613  break;
3614 
3615  case 'P':
3616  SetConfigOption("ignore_system_indexes", "true", ctx, gucsource);
3617  break;
3618 
3619  case 'p':
3620  SetConfigOption("port", optarg, ctx, gucsource);
3621  break;
3622 
3623  case 'r':
3624  /* send output (stdout and stderr) to the given file */
3625  if (secure)
3627  break;
3628 
3629  case 'S':
3630  SetConfigOption("work_mem", optarg, ctx, gucsource);
3631  break;
3632 
3633  case 's':
3634  SetConfigOption("log_statement_stats", "true", ctx, gucsource);
3635  break;
3636 
3637  case 'T':
3638  /* ignored for consistency with the postmaster */
3639  break;
3640 
3641  case 't':
3642  {
3643  const char *tmp = get_stats_option_name(optarg);
3644 
3645  if (tmp)
3646  SetConfigOption(tmp, "true", ctx, gucsource);
3647  else
3648  errs++;
3649  break;
3650  }
3651 
3652  case 'v':
3653 
3654  /*
3655  * -v is no longer used in normal operation, since
3656  * FrontendProtocol is already set before we get here. We keep
3657  * the switch only for possible use in standalone operation,
3658  * in case we ever support using normal FE/BE protocol with a
3659  * standalone backend.
3660  */
3661  if (secure)
3663  break;
3664 
3665  case 'W':
3666  SetConfigOption("post_auth_delay", optarg, ctx, gucsource);
3667  break;
3668 
3669  case 'c':
3670  case '-':
3671  {
3672  char *name,
3673  *value;
3674 
3675  ParseLongOption(optarg, &name, &value);
3676  if (!value)
3677  {
3678  if (flag == '-')
3679  ereport(ERROR,
3680  (errcode(ERRCODE_SYNTAX_ERROR),
3681  errmsg("--%s requires a value",
3682  optarg)));
3683  else
3684  ereport(ERROR,
3685  (errcode(ERRCODE_SYNTAX_ERROR),
3686  errmsg("-c %s requires a value",
3687  optarg)));
3688  }
3689  SetConfigOption(name, value, ctx, gucsource);
3690  free(name);
3691  if (value)
3692  free(value);
3693  break;
3694  }
3695 
3696  default:
3697  errs++;
3698  break;
3699  }
3700 
3701  if (errs)
3702  break;
3703  }
3704 
3705  /*
3706  * Optional database name should be there only if *dbname is NULL.
3707  */
3708  if (!errs && dbname && *dbname == NULL && argc - optind >= 1)
3709  *dbname = strdup(argv[optind++]);
3710 
3711  if (errs || argc != optind)
3712  {
3713  if (errs)
3714  optind--; /* complain about the previous argument */
3715 
3716  /* spell the error message a bit differently depending on context */
3717  if (IsUnderPostmaster)
3718  ereport(FATAL,
3719  (errcode(ERRCODE_SYNTAX_ERROR),
3720  errmsg("invalid command-line argument for server process: %s", argv[optind]),
3721  errhint("Try \"%s --help\" for more information.", progname)));
3722  else
3723  ereport(FATAL,
3724  (errcode(ERRCODE_SYNTAX_ERROR),
3725  errmsg("%s: invalid command-line argument: %s",
3726  progname, argv[optind]),
3727  errhint("Try \"%s --help\" for more information.", progname)));
3728  }
3729 
3730  /*
3731  * Reset getopt(3) library so that it will work correctly in subprocesses
3732  * or when this function is called a second time with another array.
3733  */
3734  optind = 1;
3735 #ifdef HAVE_INT_OPTRESET
3736  optreset = 1; /* some systems need this too */
3737 #endif
3738 }
int errhint(const char *fmt,...)
Definition: elog.c:1069
void ParseLongOption(const char *string, char **name, char **value)
Definition: guc.c:10378
bool set_plan_disabling_options(const char *arg, GucContext context, GucSource source)
Definition: postgres.c:3412
static struct @145 value
int errcode(int sqlerrcode)
Definition: elog.c:608
const char * get_stats_option_name(const char *arg)
Definition: postgres.c:3454
void set_debug_options(int debug_flag, GucContext context, GucSource source)
Definition: postgres.c:3383
const char * progname
Definition: pg_standby.c:36
bool IsBinaryUpgrade
Definition: globals.c:110
int getopt(int nargc, char *const *nargv, const char *ostr)
Definition: getopt.c:71
GucSource
Definition: guc.h:105
int optind
Definition: getopt.c:50
#define ERROR
Definition: elog.h:43
#define FATAL
Definition: elog.h:52
#define MAXPGPATH
char OutputFileName[MAXPGPATH]
Definition: globals.c:70
void SetConfigOption(const char *name, const char *value, GucContext context, GucSource source)
Definition: guc.c:7559
bool IsUnderPostmaster
Definition: globals.c:109
char * flag(int b)
Definition: test-ctype.c:33
int opterr
Definition: getopt.c:49
#define ereport(elevel, rest)
Definition: elog.h:141
uint32 ProtocolVersion
Definition: pqcomm.h:113
#define free(a)
Definition: header.h:65
size_t strlcpy(char *dst, const char *src, size_t siz)
Definition: strlcpy.c:45
char * dbname
Definition: streamutil.c:50
const char * name
Definition: encode.c:521
static bool EchoQuery
Definition: postgres.c:158
static const char * userDoption
Definition: postgres.c:157
static bool UseSemiNewlineNewline
Definition: postgres.c:159
int errmsg(const char *fmt,...)
Definition: elog.c:822
char * optarg
Definition: getopt.c:52
ProtocolVersion FrontendProtocol
Definition: globals.c:28

◆ ProcessClientReadInterrupt()

void ProcessClientReadInterrupt ( bool  blocked)

Definition at line 526 of file postgres.c.

References catchupInterruptPending, CHECK_FOR_INTERRUPTS, DoingCommandRead, MyLatch, notifyInterruptPending, ProcDiePending, ProcessCatchupInterrupt(), ProcessNotifyInterrupt(), and SetLatch().

Referenced by interactive_getc(), and secure_read().

527 {
528  int save_errno = errno;
529 
530  if (DoingCommandRead)
531  {
532  /* Check for general interrupts that arrived before/while reading */
534 
535  /* Process sinval catchup interrupts, if any */
538 
539  /* Process notify interrupts, if any */
542  }
543  else if (ProcDiePending)
544  {
545  /*
546  * We're dying. If there is no data available to read, then it's safe
547  * (and sane) to handle that now. If we haven't tried to read yet,
548  * make sure the process latch is set, so that if there is no data
549  * then we'll come back here and die. If we're done reading, also
550  * make sure the process latch is set, as we might've undesirably
551  * cleared it while reading.
552  */
553  if (blocked)
555  else
556  SetLatch(MyLatch);
557  }
558 
559  errno = save_errno;
560 }
void ProcessCatchupInterrupt(void)
Definition: sinval.c:176
void SetLatch(Latch *latch)
Definition: latch.c:436
void ProcessNotifyInterrupt(void)
Definition: async.c:1895
volatile sig_atomic_t ProcDiePending
Definition: globals.c:32
static bool DoingCommandRead
Definition: postgres.c:140
struct Latch * MyLatch
Definition: globals.c:54
volatile sig_atomic_t notifyInterruptPending
Definition: async.c:415
volatile sig_atomic_t catchupInterruptPending
Definition: sinval.c:41
#define CHECK_FOR_INTERRUPTS()
Definition: miscadmin.h:99

◆ ProcessClientWriteInterrupt()

void ProcessClientWriteInterrupt ( bool  blocked)

Definition at line 572 of file postgres.c.

References CHECK_FOR_INTERRUPTS, CritSectionCount, DestNone, DestRemote, InterruptHoldoffCount, MyLatch, ProcDiePending, SetLatch(), and whereToSendOutput.

Referenced by secure_write().

573 {
574  int save_errno = errno;
575 
576  if (ProcDiePending)
577  {
578  /*
579  * We're dying. If it's not possible to write, then we should handle
580  * that immediately, else a stuck client could indefinitely delay our
581  * response to the signal. If we haven't tried to write yet, make
582  * sure the process latch is set, so that if the write would block
583  * then we'll come back here and die. If we're done writing, also
584  * make sure the process latch is set, as we might've undesirably
585  * cleared it while writing.
586  */
587  if (blocked)
588  {
589  /*
590  * Don't mess with whereToSendOutput if ProcessInterrupts wouldn't
591  * do anything.
592  */
593  if (InterruptHoldoffCount == 0 && CritSectionCount == 0)
594  {
595  /*
596  * We don't want to send the client the error message, as a)
597  * that would possibly block again, and b) it would likely
598  * lead to loss of protocol sync because we may have already
599  * sent a partial protocol message.
600  */
603 
605  }
606  }
607  else
608  SetLatch(MyLatch);
609  }
610 
611  errno = save_errno;
612 }
volatile uint32 InterruptHoldoffCount
Definition: globals.c:36
void SetLatch(Latch *latch)
Definition: latch.c:436
Definition: dest.h:88
volatile uint32 CritSectionCount
Definition: globals.c:38
volatile sig_atomic_t ProcDiePending
Definition: globals.c:32
struct Latch * MyLatch
Definition: globals.c:54
#define CHECK_FOR_INTERRUPTS()
Definition: miscadmin.h:99
CommandDest whereToSendOutput
Definition: postgres.c:91

◆ quickdie()

void quickdie ( SIGNAL_ARGS  )

Definition at line 2735 of file postgres.c.

References BlockSig, ClientAuthInProgress, DestNone, DestRemote, ereport, errcode(), errdetail(), errhint(), errmsg(), HOLD_INTERRUPTS, PG_SETMASK, SIGQUIT, WARNING, and whereToSendOutput.

Referenced by AutoVacLauncherMain(), AutoVacWorkerMain(), PostgresMain(), and WalSndSignals().

2736 {
2737  sigaddset(&BlockSig, SIGQUIT); /* prevent nested calls */
2738  PG_SETMASK(&BlockSig);
2739 
2740  /*
2741  * Prevent interrupts while exiting; though we just blocked signals that
2742  * would queue new interrupts, one may have been pending. We don't want a
2743  * quickdie() downgraded to a mere query cancel.
2744  */
2745  HOLD_INTERRUPTS();
2746 
2747  /*
2748  * If we're aborting out of client auth, don't risk trying to send
2749  * anything to the client; we will likely violate the protocol, not to
2750  * mention that we may have interrupted the guts of OpenSSL or some
2751  * authentication library.
2752  */
2755 
2756  /*
2757  * Notify the client before exiting, to give a clue on what happened.
2758  *
2759  * It's dubious to call ereport() from a signal handler. It is certainly
2760  * not async-signal safe. But it seems better to try, than to disconnect
2761  * abruptly and leave the client wondering what happened. It's remotely
2762  * possible that we crash or hang while trying to send the message, but
2763  * receiving a SIGQUIT is a sign that something has already gone badly
2764  * wrong, so there's not much to lose. Assuming the postmaster is still
2765  * running, it will SIGKILL us soon if we get stuck for some reason.
2766  *
2767  * Ideally this should be ereport(FATAL), but then we'd not get control
2768  * back...
2769  */
2770  ereport(WARNING,
2771  (errcode(ERRCODE_CRASH_SHUTDOWN),
2772  errmsg("terminating connection because of crash of another server process"),
2773  errdetail("The postmaster has commanded this server process to roll back"
2774  " the current transaction and exit, because another"
2775  " server process exited abnormally and possibly corrupted"
2776  " shared memory."),
2777  errhint("In a moment you should be able to reconnect to the"
2778  " database and repeat your command.")));
2779 
2780  /*
2781  * We DO NOT want to run proc_exit() or atexit() callbacks -- we're here
2782  * because shared memory may be corrupted, so we don't want to try to
2783  * clean up our transaction. Just nail the windows shut and get out of
2784  * town. The callbacks wouldn't be safe to run from a signal handler,
2785  * anyway.
2786  *
2787  * Note we do _exit(2) not _exit(0). This is to force the postmaster into
2788  * a system reset cycle if someone sends a manual SIGQUIT to a random
2789  * backend. This is necessary precisely because we don't clean up our
2790  * shared memory state. (The "dead man switch" mechanism in pmsignal.c
2791  * should ensure the postmaster sees this as a crash, too, but no harm in
2792  * being doubly sure.)
2793  */
2794  _exit(2);
2795 }
#define SIGQUIT
Definition: win32_port.h:155
int errhint(const char *fmt,...)
Definition: elog.c:1069
int errcode(int sqlerrcode)
Definition: elog.c:608
#define PG_SETMASK(mask)
Definition: pqsignal.h:19
bool ClientAuthInProgress
Definition: postmaster.c:352
Definition: dest.h:88
int errdetail(const char *fmt,...)
Definition: elog.c:955
#define ereport(elevel, rest)
Definition: elog.h:141
#define WARNING
Definition: elog.h:40
sigset_t BlockSig
Definition: pqsignal.c:22
int errmsg(const char *fmt,...)
Definition: elog.c:822
#define HOLD_INTERRUPTS()
Definition: miscadmin.h:116
CommandDest whereToSendOutput
Definition: postgres.c:91

◆ RecoveryConflictInterrupt()

void RecoveryConflictInterrupt ( ProcSignalReason  reason)

Definition at line 2872 of file postgres.c.

References Assert, elog, FATAL, HoldingBufferPinThatDelaysRecovery(), InterruptPending, IsAbortedTransactionBlockState(), IsSubTransaction(), IsTransactionOrTransactionBlock(), IsWaitingForLock(), MyLatch, MyProc, proc_exit_inprogress, ProcDiePending, PROCSIG_RECOVERY_CONFLICT_BUFFERPIN, PROCSIG_RECOVERY_CONFLICT_DATABASE, PROCSIG_RECOVERY_CONFLICT_LOCK, PROCSIG_RECOVERY_CONFLICT_SNAPSHOT, PROCSIG_RECOVERY_CONFLICT_STARTUP_DEADLOCK, PROCSIG_RECOVERY_CONFLICT_TABLESPACE, QueryCancelPending, PGPROC::recoveryConflictPending, RecoveryConflictPending, RecoveryConflictReason, RecoveryConflictRetryable, and SetLatch().

Referenced by procsignal_sigusr1_handler().

2873 {
2874  int save_errno = errno;
2875 
2876  /*
2877  * Don't joggle the elbow of proc_exit
2878  */
2879  if (!proc_exit_inprogress)
2880  {
2881  RecoveryConflictReason = reason;
2882  switch (reason)
2883  {
2885 
2886  /*
2887  * If we aren't waiting for a lock we can never deadlock.
2888  */
2889  if (!IsWaitingForLock())
2890  return;
2891 
2892  /* Intentional fall through to check wait for pin */
2893  /* FALLTHROUGH */
2894 
2896 
2897  /*
2898  * If we aren't blocking the Startup process there is nothing
2899  * more to do.
2900  */
2902  return;
2903 
2905 
2906  /* Intentional fall through to error handling */
2907  /* FALLTHROUGH */
2908 
2912 
2913  /*
2914  * If we aren't in a transaction any longer then ignore.
2915  */
2917  return;
2918 
2919  /*
2920  * If we can abort just the current subtransaction then we are
2921  * OK to throw an ERROR to resolve the conflict. Otherwise
2922  * drop through to the FATAL case.
2923  *
2924  * XXX other times that we can throw just an ERROR *may* be
2925  * PROCSIG_RECOVERY_CONFLICT_LOCK if no locks are held in
2926  * parent transactions
2927  *
2928  * PROCSIG_RECOVERY_CONFLICT_SNAPSHOT if no snapshots are held
2929  * by parent transactions and the transaction is not
2930  * transaction-snapshot mode
2931  *
2932  * PROCSIG_RECOVERY_CONFLICT_TABLESPACE if no temp files or
2933  * cursors open in parent transactions
2934  */
2935  if (!IsSubTransaction())
2936  {
2937  /*
2938  * If we already aborted then we no longer need to cancel.
2939  * We do this here since we do not wish to ignore aborted
2940  * subtransactions, which must cause FATAL, currently.
2941  */
2943  return;
2944 
2945  RecoveryConflictPending = true;
2946  QueryCancelPending = true;
2947  InterruptPending = true;
2948  break;
2949  }
2950 
2951  /* Intentional fall through to session cancel */
2952  /* FALLTHROUGH */
2953 
2955  RecoveryConflictPending = true;
2956  ProcDiePending = true;
2957  InterruptPending = true;
2958  break;
2959 
2960  default:
2961  elog(FATAL, "unrecognized conflict mode: %d",
2962  (int) reason);
2963  }
2964 
2966 
2967  /*
2968  * All conflicts apart from database cause dynamic errors where the
2969  * command or transaction can be retried at a later point with some
2970  * potential for success. No need to reset this, since non-retryable
2971  * conflict errors are currently FATAL.
2972  */
2973  if (reason == PROCSIG_RECOVERY_CONFLICT_DATABASE)
2974  RecoveryConflictRetryable = false;
2975  }
2976 
2977  /*
2978  * Set the process latch. This function essentially emulates signal
2979  * handlers like die() and StatementCancelHandler() and it seems prudent
2980  * to behave similarly as they do.
2981  */
2982  SetLatch(MyLatch);
2983 
2984  errno = save_errno;
2985 }
bool IsWaitingForLock(void)
Definition: proc.c:694
volatile sig_atomic_t QueryCancelPending
Definition: globals.c:31
PGPROC * MyProc
Definition: proc.c:67
bool IsAbortedTransactionBlockState(void)
Definition: xact.c:375
bool IsTransactionOrTransactionBlock(void)
Definition: xact.c:4653
void SetLatch(Latch *latch)
Definition: latch.c:436
#define FATAL
Definition: elog.h:52
bool recoveryConflictPending
Definition: proc.h:127
static ProcSignalReason RecoveryConflictReason
Definition: postgres.c:164
static bool RecoveryConflictPending
Definition: postgres.c:162
static bool RecoveryConflictRetryable
Definition: postgres.c:163
#define Assert(condition)
Definition: c.h:739
volatile sig_atomic_t ProcDiePending
Definition: globals.c:32
bool proc_exit_inprogress
Definition: ipc.c:40
bool HoldingBufferPinThatDelaysRecovery(void)
Definition: bufmgr.c:3758
volatile sig_atomic_t InterruptPending
Definition: globals.c:30
bool IsSubTransaction(void)
Definition: xact.c:4708
#define elog(elevel,...)
Definition: elog.h:228
struct Latch * MyLatch
Definition: globals.c:54

◆ ResetUsage()

void ResetUsage ( void  )

Definition at line 4587 of file postgres.c.

References getrusage(), gettimeofday(), RUSAGE_SELF, Save_r, and Save_t.

Referenced by _bt_leader_participate_as_worker(), _bt_leafbuild(), _bt_parallel_build_main(), _SPI_pquery(), btbuild(), exec_bind_message(), exec_execute_message(), exec_parse_message(), exec_simple_query(), pg_analyze_and_rewrite(), pg_analyze_and_rewrite_params(), pg_parse_query(), pg_plan_query(), pg_rewrite_query(), PortalRun(), and PortalRunMulti().

4588 {
4590  gettimeofday(&Save_t, NULL);
4591 }
int gettimeofday(struct timeval *tp, struct timezone *tzp)
Definition: gettimeofday.c:105
static struct rusage Save_r
Definition: postgres.c:4583
int getrusage(int who, struct rusage *rusage)
Definition: getrusage.c:31
static struct timeval Save_t
Definition: postgres.c:4584
#define RUSAGE_SELF
Definition: rusagestub.h:23

◆ set_debug_options()

void set_debug_options ( int  debug_flag,
GucContext  context,
GucSource  source 
)

Definition at line 3383 of file postgres.c.

References PGC_POSTMASTER, SetConfigOption(), and sprintf.

Referenced by PostmasterMain(), and process_postgres_switches().

3384 {
3385  if (debug_flag > 0)
3386  {
3387  char debugstr[64];
3388 
3389  sprintf(debugstr, "debug%d", debug_flag);
3390  SetConfigOption("log_min_messages", debugstr, context, source);
3391  }
3392  else
3393  SetConfigOption("log_min_messages", "notice", context, source);
3394 
3395  if (debug_flag >= 1 && context == PGC_POSTMASTER)
3396  {
3397  SetConfigOption("log_connections", "true", context, source);
3398  SetConfigOption("log_disconnections", "true", context, source);
3399  }
3400  if (debug_flag >= 2)
3401  SetConfigOption("log_statement", "all", context, source);
3402  if (debug_flag >= 3)
3403  SetConfigOption("debug_print_parse", "true", context, source);
3404  if (debug_flag >= 4)
3405  SetConfigOption("debug_print_plan", "true", context, source);
3406  if (debug_flag >= 5)
3407  SetConfigOption("debug_print_rewritten", "true", context, source);
3408 }
#define sprintf
Definition: port.h:194
void SetConfigOption(const char *name, const char *value, GucContext context, GucSource source)
Definition: guc.c:7559

◆ set_plan_disabling_options()

bool set_plan_disabling_options ( const char *  arg,
GucContext  context,
GucSource  source 
)

Definition at line 3412 of file postgres.c.

References SetConfigOption().

Referenced by PostmasterMain(), and process_postgres_switches().

3413 {
3414  const char *tmp = NULL;
3415 
3416  switch (arg[0])
3417  {
3418  case 's': /* seqscan */
3419  tmp = "enable_seqscan";
3420  break;
3421  case 'i': /* indexscan */
3422  tmp = "enable_indexscan";
3423  break;
3424  case 'o': /* indexonlyscan */
3425  tmp = "enable_indexonlyscan";
3426  break;
3427  case 'b': /* bitmapscan */
3428  tmp = "enable_bitmapscan";
3429  break;
3430  case 't': /* tidscan */
3431  tmp = "enable_tidscan";
3432  break;
3433  case 'n': /* nestloop */
3434  tmp = "enable_nestloop";
3435  break;
3436  case 'm': /* mergejoin */
3437  tmp = "enable_mergejoin";
3438  break;
3439  case 'h': /* hashjoin */
3440  tmp = "enable_hashjoin";
3441  break;
3442  }
3443  if (tmp)
3444  {
3445  SetConfigOption(tmp, "false", context, source);
3446  return true;
3447  }
3448  else
3449  return false;
3450 }
void SetConfigOption(const char *name, const char *value, GucContext context, GucSource source)
Definition: guc.c:7559
void * arg

◆ ShowUsage()

void ShowUsage ( const char *  title)

Definition at line 4594 of file postgres.c.

References __darwin__, appendStringInfo(), appendStringInfoString(), StringInfoData::data, ereport, errdetail_internal(), errmsg_internal(), getrusage(), gettimeofday(), initStringInfo(), StringInfoData::len, LOG, pfree(), rusage::ru_stime, rusage::ru_utime, RUSAGE_SELF, Save_r, Save_t, and generate_unaccent_rules::str.

Referenced by _bt_leader_participate_as_worker(), _bt_leafbuild(), _bt_parallel_build_main(), _SPI_pquery(), btbuild(), exec_bind_message(), exec_execute_message(), exec_parse_message(), exec_simple_query(), pg_analyze_and_rewrite(), pg_analyze_and_rewrite_params(), pg_parse_query(), pg_plan_query(), pg_rewrite_query(), PortalRun(), and PortalRunMulti().

4595 {
4597  struct timeval user,
4598  sys;
4599  struct timeval elapse_t;
4600  struct rusage r;
4601 
4602  getrusage(RUSAGE_SELF, &r);
4603  gettimeofday(&elapse_t, NULL);
4604  memcpy((char *) &user, (char *) &r.ru_utime, sizeof(user));
4605  memcpy((char *) &sys, (char *) &r.ru_stime, sizeof(sys));
4606  if (elapse_t.tv_usec < Save_t.tv_usec)
4607  {
4608  elapse_t.tv_sec--;
4609  elapse_t.tv_usec += 1000000;
4610  }
4611  if (r.ru_utime.tv_usec < Save_r.ru_utime.tv_usec)
4612  {
4613  r.ru_utime.tv_sec--;
4614  r.ru_utime.tv_usec += 1000000;
4615  }
4616  if (r.ru_stime.tv_usec < Save_r.ru_stime.tv_usec)
4617  {
4618  r.ru_stime.tv_sec--;
4619  r.ru_stime.tv_usec += 1000000;
4620  }
4621 
4622  /*
4623  * The only stats we don't show here are ixrss, idrss, isrss. It takes
4624  * some work to interpret them, and most platforms don't fill them in.
4625  */
4626  initStringInfo(&str);
4627 
4628  appendStringInfoString(&str, "! system usage stats:\n");
4629  appendStringInfo(&str,
4630  "!\t%ld.%06ld s user, %ld.%06ld s system, %ld.%06ld s elapsed\n",
4631  (long) (r.ru_utime.tv_sec - Save_r.ru_utime.tv_sec),
4632  (long) (r.ru_utime.tv_usec - Save_r.ru_utime.tv_usec),
4633  (long) (r.ru_stime.tv_sec - Save_r.ru_stime.tv_sec),
4634  (long) (r.ru_stime.tv_usec - Save_r.ru_stime.tv_usec),
4635  (long) (elapse_t.tv_sec - Save_t.tv_sec),
4636  (long) (elapse_t.tv_usec - Save_t.tv_usec));
4637  appendStringInfo(&str,
4638  "!\t[%ld.%06ld s user, %ld.%06ld s system total]\n",
4639  (long) user.tv_sec,
4640  (long) user.tv_usec,
4641  (long) sys.tv_sec,
4642  (long) sys.tv_usec);
4643 #if defined(HAVE_GETRUSAGE)
4644  appendStringInfo(&str,
4645  "!\t%ld kB max resident size\n",
4646 #if defined(__darwin__)
4647  /* in bytes on macOS */
4648  r.ru_maxrss / 1024
4649 #else
4650  /* in kilobytes on most other platforms */
4651  r.ru_maxrss
4652 #endif
4653  );
4654  appendStringInfo(&str,
4655  "!\t%ld/%ld [%ld/%ld] filesystem blocks in/out\n",
4656  r.ru_inblock - Save_r.ru_inblock,
4657  /* they only drink coffee at dec */
4658  r.ru_oublock - Save_r.ru_oublock,
4659  r.ru_inblock, r.ru_oublock);
4660  appendStringInfo(&str,
4661  "!\t%ld/%ld [%ld/%ld] page faults/reclaims, %ld [%ld] swaps\n",
4662  r.ru_majflt - Save_r.ru_majflt,
4663  r.ru_minflt - Save_r.ru_minflt,
4664  r.ru_majflt, r.ru_minflt,
4665  r.ru_nswap - Save_r.ru_nswap,
4666  r.ru_nswap);
4667  appendStringInfo(&str,
4668  "!\t%ld [%ld] signals rcvd, %ld/%ld [%ld/%ld] messages rcvd/sent\n",
4669  r.ru_nsignals - Save_r.ru_nsignals,
4670  r.ru_nsignals,
4671  r.ru_msgrcv - Save_r.ru_msgrcv,
4672  r.ru_msgsnd - Save_r.ru_msgsnd,
4673  r.ru_msgrcv, r.ru_msgsnd);
4674  appendStringInfo(&str,
4675  "!\t%ld/%ld [%ld/%ld] voluntary/involuntary context switches\n",
4676  r.ru_nvcsw - Save_r.ru_nvcsw,
4677  r.ru_nivcsw - Save_r.ru_nivcsw,
4678  r.ru_nvcsw, r.ru_nivcsw);
4679 #endif /* HAVE_GETRUSAGE */
4680 
4681  /* remove trailing newline */
4682  if (str.data[str.len - 1] == '\n')
4683  str.data[--str.len] = '\0';
4684 
4685  ereport(LOG,
4686  (errmsg_internal("%s", title),
4687  errdetail_internal("%s", str.data)));
4688 
4689  pfree(str.data);
4690 }
int gettimeofday(struct timeval *tp, struct timezone *tzp)
Definition: gettimeofday.c:105
static struct rusage Save_r
Definition: postgres.c:4583
struct timeval ru_stime
Definition: rusagestub.h:29
int getrusage(int who, struct rusage *rusage)
Definition: getrusage.c:31
#define LOG
Definition: elog.h:26
int errdetail_internal(const char *fmt,...)
Definition: elog.c:982
void pfree(void *pointer)
Definition: mcxt.c:1056
void appendStringInfo(StringInfo str, const char *fmt,...)
Definition: stringinfo.c:91
void appendStringInfoString(StringInfo str, const char *s)
Definition: stringinfo.c:176
static struct timeval Save_t
Definition: postgres.c:4584
#define ereport(elevel, rest)
Definition: elog.h:141
void initStringInfo(StringInfo str)
Definition: stringinfo.c:59
struct timeval ru_utime
Definition: rusagestub.h:28
#define RUSAGE_SELF
Definition: rusagestub.h:23
int errmsg_internal(const char *fmt,...)
Definition: elog.c:909
static char * user
Definition: pg_regress.c:94
#define __darwin__
Definition: darwin.h:3

◆ StatementCancelHandler()

void StatementCancelHandler ( SIGNAL_ARGS  )

Definition at line 2833 of file postgres.c.

References InterruptPending, MyLatch, proc_exit_inprogress, QueryCancelPending, and SetLatch().

Referenced by AutoVacLauncherMain(), AutoVacWorkerMain(), PostgresMain(), StartBackgroundWorker(), and WalSndSignals().

2834 {
2835  int save_errno = errno;
2836 
2837  /*
2838  * Don't joggle the elbow of proc_exit
2839  */
2840  if (!proc_exit_inprogress)
2841  {
2842  InterruptPending = true;
2843  QueryCancelPending = true;
2844  }
2845 
2846  /* If we're still here, waken anything waiting on the process latch */
2847  SetLatch(MyLatch);
2848 
2849  errno = save_errno;
2850 }
volatile sig_atomic_t QueryCancelPending
Definition: globals.c:31
void SetLatch(Latch *latch)
Definition: latch.c:436
bool proc_exit_inprogress
Definition: ipc.c:40
volatile sig_atomic_t InterruptPending
Definition: globals.c:30
struct Latch * MyLatch
Definition: globals.c:54

Variable Documentation

◆ debug_query_string

◆ log_statement

PGDLLIMPORT int log_statement

Definition at line 96 of file postgres.c.

Referenced by check_log_statement(), and HandleFunctionRequest().

◆ max_stack_depth

int max_stack_depth

Definition at line 99 of file postgres.c.

Referenced by check_stack_depth().

◆ PostAuthDelay

int PostAuthDelay

◆ whereToSendOutput