PostgreSQL Source Code  git master
bootstrap.c
Go to the documentation of this file.
1 /*-------------------------------------------------------------------------
2  *
3  * bootstrap.c
4  * routines to support running postgres in 'bootstrap' mode
5  * bootstrap mode is used to create the initial template database
6  *
7  * Portions Copyright (c) 1996-2023, PostgreSQL Global Development Group
8  * Portions Copyright (c) 1994, Regents of the University of California
9  *
10  * IDENTIFICATION
11  * src/backend/bootstrap/bootstrap.c
12  *
13  *-------------------------------------------------------------------------
14  */
15 #include "postgres.h"
16 
17 #include <unistd.h>
18 #include <signal.h>
19 
20 #include "access/genam.h"
21 #include "access/heapam.h"
22 #include "access/htup_details.h"
23 #include "access/tableam.h"
25 #include "access/xact.h"
26 #include "access/xlog_internal.h"
27 #include "bootstrap/bootstrap.h"
28 #include "catalog/index.h"
29 #include "catalog/pg_collation.h"
30 #include "catalog/pg_type.h"
31 #include "common/link-canary.h"
32 #include "libpq/pqsignal.h"
33 #include "miscadmin.h"
34 #include "nodes/makefuncs.h"
35 #include "pg_getopt.h"
36 #include "storage/bufmgr.h"
37 #include "storage/bufpage.h"
39 #include "storage/ipc.h"
40 #include "storage/proc.h"
41 #include "tcop/tcopprot.h"
42 #include "utils/builtins.h"
43 #include "utils/fmgroids.h"
44 #include "utils/memutils.h"
45 #include "utils/rel.h"
46 #include "utils/relmapper.h"
47 
49 
50 
51 static void CheckerModeMain(void);
52 static void bootstrap_signals(void);
54 static void populate_typ_list(void);
55 static Oid gettype(char *type);
56 static void cleanup(void);
57 
58 /* ----------------
59  * global variables
60  * ----------------
61  */
62 
63 Relation boot_reldesc; /* current relation descriptor */
64 
65 Form_pg_attribute attrtypes[MAXATTR]; /* points to attribute info */
66 int numattr; /* number of attributes for cur. rel */
67 
68 
69 /*
70  * Basic information associated with each type. This is used before
71  * pg_type is filled, so it has to cover the datatypes used as column types
72  * in the core "bootstrapped" catalogs.
73  *
74  * XXX several of these input/output functions do catalog scans
75  * (e.g., F_REGPROCIN scans pg_proc). this obviously creates some
76  * order dependencies in the catalog creation process.
77  */
78 struct typinfo
79 {
84  bool byval;
85  char align;
86  char storage;
90 };
91 
92 static const struct typinfo TypInfo[] = {
93  {"bool", BOOLOID, 0, 1, true, TYPALIGN_CHAR, TYPSTORAGE_PLAIN, InvalidOid,
94  F_BOOLIN, F_BOOLOUT},
95  {"bytea", BYTEAOID, 0, -1, false, TYPALIGN_INT, TYPSTORAGE_EXTENDED, InvalidOid,
96  F_BYTEAIN, F_BYTEAOUT},
97  {"char", CHAROID, 0, 1, true, TYPALIGN_CHAR, TYPSTORAGE_PLAIN, InvalidOid,
98  F_CHARIN, F_CHAROUT},
99  {"int2", INT2OID, 0, 2, true, TYPALIGN_SHORT, TYPSTORAGE_PLAIN, InvalidOid,
100  F_INT2IN, F_INT2OUT},
101  {"int4", INT4OID, 0, 4, true, TYPALIGN_INT, TYPSTORAGE_PLAIN, InvalidOid,
102  F_INT4IN, F_INT4OUT},
103  {"float4", FLOAT4OID, 0, 4, true, TYPALIGN_INT, TYPSTORAGE_PLAIN, InvalidOid,
104  F_FLOAT4IN, F_FLOAT4OUT},
105  {"name", NAMEOID, CHAROID, NAMEDATALEN, false, TYPALIGN_CHAR, TYPSTORAGE_PLAIN, C_COLLATION_OID,
106  F_NAMEIN, F_NAMEOUT},
107  {"regclass", REGCLASSOID, 0, 4, true, TYPALIGN_INT, TYPSTORAGE_PLAIN, InvalidOid,
108  F_REGCLASSIN, F_REGCLASSOUT},
109  {"regproc", REGPROCOID, 0, 4, true, TYPALIGN_INT, TYPSTORAGE_PLAIN, InvalidOid,
110  F_REGPROCIN, F_REGPROCOUT},
111  {"regtype", REGTYPEOID, 0, 4, true, TYPALIGN_INT, TYPSTORAGE_PLAIN, InvalidOid,
112  F_REGTYPEIN, F_REGTYPEOUT},
113  {"regrole", REGROLEOID, 0, 4, true, TYPALIGN_INT, TYPSTORAGE_PLAIN, InvalidOid,
114  F_REGROLEIN, F_REGROLEOUT},
115  {"regnamespace", REGNAMESPACEOID, 0, 4, true, TYPALIGN_INT, TYPSTORAGE_PLAIN, InvalidOid,
116  F_REGNAMESPACEIN, F_REGNAMESPACEOUT},
117  {"text", TEXTOID, 0, -1, false, TYPALIGN_INT, TYPSTORAGE_EXTENDED, DEFAULT_COLLATION_OID,
118  F_TEXTIN, F_TEXTOUT},
119  {"oid", OIDOID, 0, 4, true, TYPALIGN_INT, TYPSTORAGE_PLAIN, InvalidOid,
120  F_OIDIN, F_OIDOUT},
121  {"tid", TIDOID, 0, 6, false, TYPALIGN_SHORT, TYPSTORAGE_PLAIN, InvalidOid,
122  F_TIDIN, F_TIDOUT},
123  {"xid", XIDOID, 0, 4, true, TYPALIGN_INT, TYPSTORAGE_PLAIN, InvalidOid,
124  F_XIDIN, F_XIDOUT},
125  {"cid", CIDOID, 0, 4, true, TYPALIGN_INT, TYPSTORAGE_PLAIN, InvalidOid,
126  F_CIDIN, F_CIDOUT},
127  {"pg_node_tree", PG_NODE_TREEOID, 0, -1, false, TYPALIGN_INT, TYPSTORAGE_EXTENDED, DEFAULT_COLLATION_OID,
128  F_PG_NODE_TREE_IN, F_PG_NODE_TREE_OUT},
129  {"int2vector", INT2VECTOROID, INT2OID, -1, false, TYPALIGN_INT, TYPSTORAGE_PLAIN, InvalidOid,
130  F_INT2VECTORIN, F_INT2VECTOROUT},
131  {"oidvector", OIDVECTOROID, OIDOID, -1, false, TYPALIGN_INT, TYPSTORAGE_PLAIN, InvalidOid,
132  F_OIDVECTORIN, F_OIDVECTOROUT},
133  {"_int4", INT4ARRAYOID, INT4OID, -1, false, TYPALIGN_INT, TYPSTORAGE_EXTENDED, InvalidOid,
134  F_ARRAY_IN, F_ARRAY_OUT},
135  {"_text", 1009, TEXTOID, -1, false, TYPALIGN_INT, TYPSTORAGE_EXTENDED, DEFAULT_COLLATION_OID,
136  F_ARRAY_IN, F_ARRAY_OUT},
137  {"_oid", 1028, OIDOID, -1, false, TYPALIGN_INT, TYPSTORAGE_EXTENDED, InvalidOid,
138  F_ARRAY_IN, F_ARRAY_OUT},
139  {"_char", 1002, CHAROID, -1, false, TYPALIGN_INT, TYPSTORAGE_EXTENDED, InvalidOid,
140  F_ARRAY_IN, F_ARRAY_OUT},
141  {"_aclitem", 1034, ACLITEMOID, -1, false, TYPALIGN_INT, TYPSTORAGE_EXTENDED, InvalidOid,
142  F_ARRAY_IN, F_ARRAY_OUT}
143 };
144 
145 static const int n_types = sizeof(TypInfo) / sizeof(struct typinfo);
146 
147 struct typmap
148 { /* a hack */
151 };
152 
153 static List *Typ = NIL; /* List of struct typmap* */
154 static struct typmap *Ap = NULL;
155 
156 static Datum values[MAXATTR]; /* current row's attribute values */
157 static bool Nulls[MAXATTR];
158 
159 static MemoryContext nogc = NULL; /* special no-gc mem context */
160 
161 /*
162  * At bootstrap time, we first declare all the indices to be built, and
163  * then build them. The IndexList structure stores enough information
164  * to allow us to build the indices after they've been declared.
165  */
166 
167 typedef struct _IndexList
168 {
174 
175 static IndexList *ILHead = NULL;
176 
177 
178 /*
179  * In shared memory checker mode, all we really want to do is create shared
180  * memory and semaphores (just to prove we can do it with the current GUC
181  * settings). Since, in fact, that was already done by
182  * CreateSharedMemoryAndSemaphores(), we have nothing more to do here.
183  */
184 static void
186 {
187  proc_exit(0);
188 }
189 
190 /*
191  * The main entry point for running the backend in bootstrap mode
192  *
193  * The bootstrap mode is used to initialize the template database.
194  * The bootstrap backend doesn't speak SQL, but instead expects
195  * commands in a special bootstrap language.
196  *
197  * When check_only is true, startup is done only far enough to verify that
198  * the current configuration, particularly the passed in options pertaining
199  * to shared memory sizing, options work (or at least do not cause an error
200  * up to shared memory creation).
201  */
202 void
203 BootstrapModeMain(int argc, char *argv[], bool check_only)
204 {
205  int i;
206  char *progname = argv[0];
207  int flag;
208  char *userDoption = NULL;
209 
211 
212  InitStandaloneProcess(argv[0]);
213 
214  /* Set defaults, to be overridden by explicit options below */
216 
217  /* an initial --boot or --check should be present */
218  Assert(argc > 1
219  && (strcmp(argv[1], "--boot") == 0
220  || strcmp(argv[1], "--check") == 0));
221  argv++;
222  argc--;
223 
224  while ((flag = getopt(argc, argv, "B:c:d:D:Fkr:X:-:")) != -1)
225  {
226  switch (flag)
227  {
228  case 'B':
229  SetConfigOption("shared_buffers", optarg, PGC_POSTMASTER, PGC_S_ARGV);
230  break;
231  case 'c':
232  case '-':
233  {
234  char *name,
235  *value;
236 
238  if (!value)
239  {
240  if (flag == '-')
241  ereport(ERROR,
242  (errcode(ERRCODE_SYNTAX_ERROR),
243  errmsg("--%s requires a value",
244  optarg)));
245  else
246  ereport(ERROR,
247  (errcode(ERRCODE_SYNTAX_ERROR),
248  errmsg("-c %s requires a value",
249  optarg)));
250  }
251 
253  pfree(name);
254  pfree(value);
255  break;
256  }
257  case 'D':
259  break;
260  case 'd':
261  {
262  /* Turn on debugging for the bootstrap process. */
263  char *debugstr;
264 
265  debugstr = psprintf("debug%s", optarg);
266  SetConfigOption("log_min_messages", debugstr,
268  SetConfigOption("client_min_messages", debugstr,
270  pfree(debugstr);
271  }
272  break;
273  case 'F':
274  SetConfigOption("fsync", "false", PGC_POSTMASTER, PGC_S_ARGV);
275  break;
276  case 'k':
278  break;
279  case 'r':
281  break;
282  case 'X':
283  {
284  int WalSegSz = strtoul(optarg, NULL, 0);
285 
287  ereport(ERROR,
288  (errcode(ERRCODE_INVALID_PARAMETER_VALUE),
289  errmsg("-X requires a power of two value between 1 MB and 1 GB")));
290  SetConfigOption("wal_segment_size", optarg, PGC_INTERNAL,
292  }
293  break;
294  default:
295  write_stderr("Try \"%s --help\" for more information.\n",
296  progname);
297  proc_exit(1);
298  break;
299  }
300  }
301 
302  if (argc != optind)
303  {
304  write_stderr("%s: invalid command-line arguments\n", progname);
305  proc_exit(1);
306  }
307 
308  /* Acquire configuration parameters */
310  proc_exit(1);
311 
312  /*
313  * Validate we have been given a reasonable-looking DataDir and change
314  * into it
315  */
316  checkDataDir();
317  ChangeToDataDir();
318 
319  CreateDataDirLockFile(false);
320 
322  IgnoreSystemIndexes = true;
323 
325 
327 
328  /*
329  * XXX: It might make sense to move this into its own function at some
330  * point. Right now it seems like it'd cause more code duplication than
331  * it's worth.
332  */
333  if (check_only)
334  {
336  CheckerModeMain();
337  abort();
338  }
339 
340  /*
341  * Do backend-like initialization for bootstrap mode
342  */
343  InitProcess();
344 
345  BaseInit();
346 
348  BootStrapXLOG();
349 
350  /*
351  * To ensure that src/common/link-canary.c is linked into the backend, we
352  * must call it from somewhere. Here is as good as anywhere.
353  */
355  elog(ERROR, "backend is incorrectly linked to frontend functions");
356 
357  InitPostgres(NULL, InvalidOid, NULL, InvalidOid, false, false, NULL);
358 
359  /* Initialize stuff for bootstrap-file processing */
360  for (i = 0; i < MAXATTR; i++)
361  {
362  attrtypes[i] = NULL;
363  Nulls[i] = false;
364  }
365 
366  /*
367  * Process bootstrap input.
368  */
370  boot_yyparse();
372 
373  /*
374  * We should now know about all mapped relations, so it's okay to write
375  * out the initial relation mapping files.
376  */
378 
379  /* Clean up and exit */
380  cleanup();
381  proc_exit(0);
382 }
383 
384 
385 /* ----------------------------------------------------------------
386  * misc functions
387  * ----------------------------------------------------------------
388  */
389 
390 /*
391  * Set up signal handling for a bootstrap process
392  */
393 static void
395 {
397 
398  /*
399  * We don't actually need any non-default signal handling in bootstrap
400  * mode; "curl up and die" is a sufficient response for all these cases.
401  * Let's set that handling explicitly, as documentation if nothing else.
402  */
404  pqsignal(SIGINT, SIG_DFL);
405  pqsignal(SIGTERM, SIG_DFL);
407 }
408 
409 /* ----------------------------------------------------------------
410  * MANUAL BACKEND INTERACTIVE INTERFACE COMMANDS
411  * ----------------------------------------------------------------
412  */
413 
414 /* ----------------
415  * boot_openrel
416  *
417  * Execute BKI OPEN command.
418  * ----------------
419  */
420 void
422 {
423  int i;
424 
425  if (strlen(relname) >= NAMEDATALEN)
426  relname[NAMEDATALEN - 1] = '\0';
427 
428  /*
429  * pg_type must be filled before any OPEN command is executed, hence we
430  * can now populate Typ if we haven't yet.
431  */
432  if (Typ == NIL)
434 
435  if (boot_reldesc != NULL)
436  closerel(NULL);
437 
438  elog(DEBUG4, "open relation %s, attrsize %d",
440 
443  for (i = 0; i < numattr; i++)
444  {
445  if (attrtypes[i] == NULL)
447  memmove((char *) attrtypes[i],
448  (char *) TupleDescAttr(boot_reldesc->rd_att, i),
450 
451  {
453 
454  elog(DEBUG4, "create attribute %d name %s len %d num %d type %u",
455  i, NameStr(at->attname), at->attlen, at->attnum,
456  at->atttypid);
457  }
458  }
459 }
460 
461 /* ----------------
462  * closerel
463  * ----------------
464  */
465 void
467 {
468  if (relname)
469  {
470  if (boot_reldesc)
471  {
472  if (strcmp(RelationGetRelationName(boot_reldesc), relname) != 0)
473  elog(ERROR, "close of %s when %s was expected",
475  }
476  else
477  elog(ERROR, "close of %s before any relation was opened",
478  relname);
479  }
480 
481  if (boot_reldesc == NULL)
482  elog(ERROR, "no open relation to close");
483  else
484  {
485  elog(DEBUG4, "close relation %s",
488  boot_reldesc = NULL;
489  }
490 }
491 
492 
493 
494 /* ----------------
495  * DEFINEATTR()
496  *
497  * define a <field,type> pair
498  * if there are n fields in a relation to be created, this routine
499  * will be called n times
500  * ----------------
501  */
502 void
503 DefineAttr(char *name, char *type, int attnum, int nullness)
504 {
505  Oid typeoid;
506 
507  if (boot_reldesc != NULL)
508  {
509  elog(WARNING, "no open relations allowed with CREATE command");
510  closerel(NULL);
511  }
512 
513  if (attrtypes[attnum] == NULL)
516 
518  elog(DEBUG4, "column %s %s", NameStr(attrtypes[attnum]->attname), type);
519  attrtypes[attnum]->attnum = attnum + 1;
520 
521  typeoid = gettype(type);
522 
523  if (Typ != NIL)
524  {
525  attrtypes[attnum]->atttypid = Ap->am_oid;
526  attrtypes[attnum]->attlen = Ap->am_typ.typlen;
527  attrtypes[attnum]->attbyval = Ap->am_typ.typbyval;
528  attrtypes[attnum]->attalign = Ap->am_typ.typalign;
529  attrtypes[attnum]->attstorage = Ap->am_typ.typstorage;
530  attrtypes[attnum]->attcompression = InvalidCompressionMethod;
531  attrtypes[attnum]->attcollation = Ap->am_typ.typcollation;
532  /* if an array type, assume 1-dimensional attribute */
533  if (Ap->am_typ.typelem != InvalidOid && Ap->am_typ.typlen < 0)
534  attrtypes[attnum]->attndims = 1;
535  else
536  attrtypes[attnum]->attndims = 0;
537  }
538  else
539  {
540  attrtypes[attnum]->atttypid = TypInfo[typeoid].oid;
541  attrtypes[attnum]->attlen = TypInfo[typeoid].len;
542  attrtypes[attnum]->attbyval = TypInfo[typeoid].byval;
543  attrtypes[attnum]->attalign = TypInfo[typeoid].align;
544  attrtypes[attnum]->attstorage = TypInfo[typeoid].storage;
545  attrtypes[attnum]->attcompression = InvalidCompressionMethod;
546  attrtypes[attnum]->attcollation = TypInfo[typeoid].collation;
547  /* if an array type, assume 1-dimensional attribute */
548  if (TypInfo[typeoid].elem != InvalidOid &&
549  attrtypes[attnum]->attlen < 0)
550  attrtypes[attnum]->attndims = 1;
551  else
552  attrtypes[attnum]->attndims = 0;
553  }
554 
555  /*
556  * If a system catalog column is collation-aware, force it to use C
557  * collation, so that its behavior is independent of the database's
558  * collation. This is essential to allow template0 to be cloned with a
559  * different database collation.
560  */
561  if (OidIsValid(attrtypes[attnum]->attcollation))
562  attrtypes[attnum]->attcollation = C_COLLATION_OID;
563 
564  attrtypes[attnum]->attstattarget = -1;
565  attrtypes[attnum]->attcacheoff = -1;
566  attrtypes[attnum]->atttypmod = -1;
567  attrtypes[attnum]->attislocal = true;
568 
569  if (nullness == BOOTCOL_NULL_FORCE_NOT_NULL)
570  {
571  attrtypes[attnum]->attnotnull = true;
572  }
573  else if (nullness == BOOTCOL_NULL_FORCE_NULL)
574  {
575  attrtypes[attnum]->attnotnull = false;
576  }
577  else
578  {
579  Assert(nullness == BOOTCOL_NULL_AUTO);
580 
581  /*
582  * Mark as "not null" if type is fixed-width and prior columns are
583  * likewise fixed-width and not-null. This corresponds to case where
584  * column can be accessed directly via C struct declaration.
585  */
586  if (attrtypes[attnum]->attlen > 0)
587  {
588  int i;
589 
590  /* check earlier attributes */
591  for (i = 0; i < attnum; i++)
592  {
593  if (attrtypes[i]->attlen <= 0 ||
595  break;
596  }
597  if (i == attnum)
598  attrtypes[attnum]->attnotnull = true;
599  }
600  }
601 }
602 
603 
604 /* ----------------
605  * InsertOneTuple
606  *
607  * If objectid is not zero, it is a specific OID to assign to the tuple.
608  * Otherwise, an OID will be assigned (if necessary) by heap_insert.
609  * ----------------
610  */
611 void
613 {
614  HeapTuple tuple;
615  TupleDesc tupDesc;
616  int i;
617 
618  elog(DEBUG4, "inserting row with %d columns", numattr);
619 
620  tupDesc = CreateTupleDesc(numattr, attrtypes);
621  tuple = heap_form_tuple(tupDesc, values, Nulls);
622  pfree(tupDesc); /* just free's tupDesc, not the attrtypes */
623 
625  heap_freetuple(tuple);
626  elog(DEBUG4, "row inserted");
627 
628  /*
629  * Reset null markers for next tuple
630  */
631  for (i = 0; i < numattr; i++)
632  Nulls[i] = false;
633 }
634 
635 /* ----------------
636  * InsertOneValue
637  * ----------------
638  */
639 void
640 InsertOneValue(char *value, int i)
641 {
642  Oid typoid;
643  int16 typlen;
644  bool typbyval;
645  char typalign;
646  char typdelim;
647  Oid typioparam;
648  Oid typinput;
649  Oid typoutput;
650 
651  Assert(i >= 0 && i < MAXATTR);
652 
653  elog(DEBUG4, "inserting column %d value \"%s\"", i, value);
654 
655  typoid = TupleDescAttr(boot_reldesc->rd_att, i)->atttypid;
656 
657  boot_get_type_io_data(typoid,
658  &typlen, &typbyval, &typalign,
659  &typdelim, &typioparam,
660  &typinput, &typoutput);
661 
662  values[i] = OidInputFunctionCall(typinput, value, typioparam, -1);
663 
664  /*
665  * We use ereport not elog here so that parameters aren't evaluated unless
666  * the message is going to be printed, which generally it isn't
667  */
668  ereport(DEBUG4,
669  (errmsg_internal("inserted -> %s",
670  OidOutputFunctionCall(typoutput, values[i]))));
671 }
672 
673 /* ----------------
674  * InsertOneNull
675  * ----------------
676  */
677 void
679 {
680  elog(DEBUG4, "inserting column %d NULL", i);
681  Assert(i >= 0 && i < MAXATTR);
682  if (TupleDescAttr(boot_reldesc->rd_att, i)->attnotnull)
683  elog(ERROR,
684  "NULL value specified for not-null column \"%s\" of relation \"%s\"",
687  values[i] = PointerGetDatum(NULL);
688  Nulls[i] = true;
689 }
690 
691 /* ----------------
692  * cleanup
693  * ----------------
694  */
695 static void
696 cleanup(void)
697 {
698  if (boot_reldesc != NULL)
699  closerel(NULL);
700 }
701 
702 /* ----------------
703  * populate_typ_list
704  *
705  * Load the Typ list by reading pg_type.
706  * ----------------
707  */
708 static void
710 {
711  Relation rel;
712  TableScanDesc scan;
713  HeapTuple tup;
714  MemoryContext old;
715 
716  Assert(Typ == NIL);
717 
718  rel = table_open(TypeRelationId, NoLock);
719  scan = table_beginscan_catalog(rel, 0, NULL);
721  while ((tup = heap_getnext(scan, ForwardScanDirection)) != NULL)
722  {
723  Form_pg_type typForm = (Form_pg_type) GETSTRUCT(tup);
724  struct typmap *newtyp;
725 
726  newtyp = (struct typmap *) palloc(sizeof(struct typmap));
727  Typ = lappend(Typ, newtyp);
728 
729  newtyp->am_oid = typForm->oid;
730  memcpy(&newtyp->am_typ, typForm, sizeof(newtyp->am_typ));
731  }
733  table_endscan(scan);
734  table_close(rel, NoLock);
735 }
736 
737 /* ----------------
738  * gettype
739  *
740  * NB: this is really ugly; it will return an integer index into TypInfo[],
741  * and not an OID at all, until the first reference to a type not known in
742  * TypInfo[]. At that point it will read and cache pg_type in Typ,
743  * and subsequently return a real OID (and set the global pointer Ap to
744  * point at the found row in Typ). So caller must check whether Typ is
745  * still NIL to determine what the return value is!
746  * ----------------
747  */
748 static Oid
749 gettype(char *type)
750 {
751  if (Typ != NIL)
752  {
753  ListCell *lc;
754 
755  foreach(lc, Typ)
756  {
757  struct typmap *app = lfirst(lc);
758 
759  if (strncmp(NameStr(app->am_typ.typname), type, NAMEDATALEN) == 0)
760  {
761  Ap = app;
762  return app->am_oid;
763  }
764  }
765 
766  /*
767  * The type wasn't known; reload the pg_type contents and check again
768  * to handle composite types, added since last populating the list.
769  */
770 
772  Typ = NIL;
774 
775  /*
776  * Calling gettype would result in infinite recursion for types
777  * missing in pg_type, so just repeat the lookup.
778  */
779  foreach(lc, Typ)
780  {
781  struct typmap *app = lfirst(lc);
782 
783  if (strncmp(NameStr(app->am_typ.typname), type, NAMEDATALEN) == 0)
784  {
785  Ap = app;
786  return app->am_oid;
787  }
788  }
789  }
790  else
791  {
792  int i;
793 
794  for (i = 0; i < n_types; i++)
795  {
796  if (strncmp(type, TypInfo[i].name, NAMEDATALEN) == 0)
797  return i;
798  }
799  /* Not in TypInfo, so we'd better be able to read pg_type now */
800  elog(DEBUG4, "external type: %s", type);
802  return gettype(type);
803  }
804  elog(ERROR, "unrecognized type \"%s\"", type);
805  /* not reached, here to make compiler happy */
806  return 0;
807 }
808 
809 /* ----------------
810  * boot_get_type_io_data
811  *
812  * Obtain type I/O information at bootstrap time. This intentionally has
813  * almost the same API as lsyscache.c's get_type_io_data, except that
814  * we only support obtaining the typinput and typoutput routines, not
815  * the binary I/O routines. It is exported so that array_in and array_out
816  * can be made to work during early bootstrap.
817  * ----------------
818  */
819 void
821  int16 *typlen,
822  bool *typbyval,
823  char *typalign,
824  char *typdelim,
825  Oid *typioparam,
826  Oid *typinput,
827  Oid *typoutput)
828 {
829  if (Typ != NIL)
830  {
831  /* We have the boot-time contents of pg_type, so use it */
832  struct typmap *ap = NULL;
833  ListCell *lc;
834 
835  foreach(lc, Typ)
836  {
837  ap = lfirst(lc);
838  if (ap->am_oid == typid)
839  break;
840  }
841 
842  if (!ap || ap->am_oid != typid)
843  elog(ERROR, "type OID %u not found in Typ list", typid);
844 
845  *typlen = ap->am_typ.typlen;
846  *typbyval = ap->am_typ.typbyval;
847  *typalign = ap->am_typ.typalign;
848  *typdelim = ap->am_typ.typdelim;
849 
850  /* XXX this logic must match getTypeIOParam() */
851  if (OidIsValid(ap->am_typ.typelem))
852  *typioparam = ap->am_typ.typelem;
853  else
854  *typioparam = typid;
855 
856  *typinput = ap->am_typ.typinput;
857  *typoutput = ap->am_typ.typoutput;
858  }
859  else
860  {
861  /* We don't have pg_type yet, so use the hard-wired TypInfo array */
862  int typeindex;
863 
864  for (typeindex = 0; typeindex < n_types; typeindex++)
865  {
866  if (TypInfo[typeindex].oid == typid)
867  break;
868  }
869  if (typeindex >= n_types)
870  elog(ERROR, "type OID %u not found in TypInfo", typid);
871 
872  *typlen = TypInfo[typeindex].len;
873  *typbyval = TypInfo[typeindex].byval;
874  *typalign = TypInfo[typeindex].align;
875  /* We assume typdelim is ',' for all boot-time types */
876  *typdelim = ',';
877 
878  /* XXX this logic must match getTypeIOParam() */
879  if (OidIsValid(TypInfo[typeindex].elem))
880  *typioparam = TypInfo[typeindex].elem;
881  else
882  *typioparam = typid;
883 
884  *typinput = TypInfo[typeindex].inproc;
885  *typoutput = TypInfo[typeindex].outproc;
886  }
887 }
888 
889 /* ----------------
890  * AllocateAttribute
891  *
892  * Note: bootstrap never sets any per-column ACLs, so we only need
893  * ATTRIBUTE_FIXED_PART_SIZE space per attribute.
894  * ----------------
895  */
896 static Form_pg_attribute
898 {
899  return (Form_pg_attribute)
901 }
902 
903 /*
904  * index_register() -- record an index that has been set up for building
905  * later.
906  *
907  * At bootstrap time, we define a bunch of indexes on system catalogs.
908  * We postpone actually building the indexes until just before we're
909  * finished with initialization, however. This is because the indexes
910  * themselves have catalog entries, and those have to be included in the
911  * indexes on those catalogs. Doing it in two phases is the simplest
912  * way of making sure the indexes have the right contents at the end.
913  */
914 void
916  Oid ind,
917  IndexInfo *indexInfo)
918 {
919  IndexList *newind;
920  MemoryContext oldcxt;
921 
922  /*
923  * XXX mao 10/31/92 -- don't gc index reldescs, associated info at
924  * bootstrap time. we'll declare the indexes now, but want to create them
925  * later.
926  */
927 
928  if (nogc == NULL)
930  "BootstrapNoGC",
932 
933  oldcxt = MemoryContextSwitchTo(nogc);
934 
935  newind = (IndexList *) palloc(sizeof(IndexList));
936  newind->il_heap = heap;
937  newind->il_ind = ind;
938  newind->il_info = (IndexInfo *) palloc(sizeof(IndexInfo));
939 
940  memcpy(newind->il_info, indexInfo, sizeof(IndexInfo));
941  /* expressions will likely be null, but may as well copy it */
942  newind->il_info->ii_Expressions =
943  copyObject(indexInfo->ii_Expressions);
944  newind->il_info->ii_ExpressionsState = NIL;
945  /* predicate will likely be null, but may as well copy it */
946  newind->il_info->ii_Predicate =
947  copyObject(indexInfo->ii_Predicate);
948  newind->il_info->ii_PredicateState = NULL;
949  /* no exclusion constraints at bootstrap time, so no need to copy */
950  Assert(indexInfo->ii_ExclusionOps == NULL);
951  Assert(indexInfo->ii_ExclusionProcs == NULL);
952  Assert(indexInfo->ii_ExclusionStrats == NULL);
953 
954  newind->il_next = ILHead;
955  ILHead = newind;
956 
957  MemoryContextSwitchTo(oldcxt);
958 }
959 
960 
961 /*
962  * build_indices -- fill in all the indexes registered earlier
963  */
964 void
966 {
967  for (; ILHead != NULL; ILHead = ILHead->il_next)
968  {
969  Relation heap;
970  Relation ind;
971 
972  /* need not bother with locks during bootstrap */
973  heap = table_open(ILHead->il_heap, NoLock);
975 
976  index_build(heap, ind, ILHead->il_info, false, false);
977 
979  table_close(heap, NoLock);
980  }
981 }
#define write_stderr(str)
Definition: parallel.c:184
static Oid gettype(char *type)
Definition: bootstrap.c:749
static Datum values[MAXATTR]
Definition: bootstrap.c:156
void closerel(char *relname)
Definition: bootstrap.c:466
static void populate_typ_list(void)
Definition: bootstrap.c:709
static void CheckerModeMain(void)
Definition: bootstrap.c:185
void build_indices(void)
Definition: bootstrap.c:965
void InsertOneValue(char *value, int i)
Definition: bootstrap.c:640
static void cleanup(void)
Definition: bootstrap.c:696
static const int n_types
Definition: bootstrap.c:145
void InsertOneNull(int i)
Definition: bootstrap.c:678
static const struct typinfo TypInfo[]
Definition: bootstrap.c:92
Relation boot_reldesc
Definition: bootstrap.c:63
static struct typmap * Ap
Definition: bootstrap.c:154
static List * Typ
Definition: bootstrap.c:153
void InsertOneTuple(void)
Definition: bootstrap.c:612
struct _IndexList IndexList
static void bootstrap_signals(void)
Definition: bootstrap.c:394
Form_pg_attribute attrtypes[MAXATTR]
Definition: bootstrap.c:65
void boot_get_type_io_data(Oid typid, int16 *typlen, bool *typbyval, char *typalign, char *typdelim, Oid *typioparam, Oid *typinput, Oid *typoutput)
Definition: bootstrap.c:820
void index_register(Oid heap, Oid ind, IndexInfo *indexInfo)
Definition: bootstrap.c:915
int numattr
Definition: bootstrap.c:66
static Form_pg_attribute AllocateAttribute(void)
Definition: bootstrap.c:897
static MemoryContext nogc
Definition: bootstrap.c:159
void BootstrapModeMain(int argc, char *argv[], bool check_only)
Definition: bootstrap.c:203
void DefineAttr(char *name, char *type, int attnum, int nullness)
Definition: bootstrap.c:503
uint32 bootstrap_data_checksum_version
Definition: bootstrap.c:48
static bool Nulls[MAXATTR]
Definition: bootstrap.c:157
void boot_openrel(char *relname)
Definition: bootstrap.c:421
static IndexList * ILHead
Definition: bootstrap.c:175
#define BOOTCOL_NULL_FORCE_NULL
Definition: bootstrap.h:27
#define MAXATTR
Definition: bootstrap.h:24
int boot_yyparse(void)
#define BOOTCOL_NULL_FORCE_NOT_NULL
Definition: bootstrap.h:28
#define BOOTCOL_NULL_AUTO
Definition: bootstrap.h:26
#define PG_DATA_CHECKSUM_VERSION
Definition: bufpage.h:203
#define NameStr(name)
Definition: c.h:730
unsigned int uint32
Definition: c.h:490
signed short int16
Definition: c.h:477
#define MemSet(start, val, len)
Definition: c.h:1004
#define OidIsValid(objectId)
Definition: c.h:759
int errmsg_internal(const char *fmt,...)
Definition: elog.c:1156
int errcode(int sqlerrcode)
Definition: elog.c:858
int errmsg(const char *fmt,...)
Definition: elog.c:1069
#define WARNING
Definition: elog.h:36
#define ERROR
Definition: elog.h:39
#define ereport(elevel,...)
Definition: elog.h:149
#define DEBUG4
Definition: elog.h:27
const char * name
Definition: encode.c:571
Datum OidInputFunctionCall(Oid functionId, char *str, Oid typioparam, int32 typmod)
Definition: fmgr.c:1741
char * OidOutputFunctionCall(Oid functionId, Datum val)
Definition: fmgr.c:1750
bool IsUnderPostmaster
Definition: globals.c:113
char OutputFileName[MAXPGPATH]
Definition: globals.c:74
void SetConfigOption(const char *name, const char *value, GucContext context, GucSource source)
Definition: guc.c:4176
bool SelectConfigFiles(const char *userDoption, const char *progname)
Definition: guc.c:1749
void ParseLongOption(const char *string, char **name, char **value)
Definition: guc.c:6186
void InitializeGUCOptions(void)
Definition: guc.c:1495
@ PGC_S_DYNAMIC_DEFAULT
Definition: guc.h:110
@ PGC_S_ARGV
Definition: guc.h:113
@ PGC_INTERNAL
Definition: guc.h:69
@ PGC_POSTMASTER
Definition: guc.h:70
HeapTuple heap_getnext(TableScanDesc sscan, ScanDirection direction)
Definition: heapam.c:1093
void simple_heap_insert(Relation relation, HeapTuple tup)
Definition: heapam.c:2405
HeapTuple heap_form_tuple(TupleDesc tupleDescriptor, Datum *values, bool *isnull)
Definition: heaptuple.c:1020
void heap_freetuple(HeapTuple htup)
Definition: heaptuple.c:1338
#define GETSTRUCT(TUP)
Definition: htup_details.h:653
void index_build(Relation heapRelation, Relation indexRelation, IndexInfo *indexInfo, bool isreindex, bool parallel)
Definition: index.c:2961
void index_close(Relation relation, LOCKMODE lockmode)
Definition: indexam.c:158
Relation index_open(Oid relationId, LOCKMODE lockmode)
Definition: indexam.c:132
static struct @143 value
void proc_exit(int code)
Definition: ipc.c:104
void CreateSharedMemoryAndSemaphores(void)
Definition: ipci.c:174
int i
Definition: isn.c:73
Assert(fmt[strlen(fmt) - 1] !='\n')
List * lappend(List *list, void *datum)
Definition: list.c:338
void list_free_deep(List *list)
Definition: list.c:1559
#define NoLock
Definition: lockdefs.h:34
const char * progname
Definition: main.c:45
RangeVar * makeRangeVar(char *schemaname, char *relname, int location)
Definition: makefuncs.c:424
char * pstrdup(const char *in)
Definition: mcxt.c:1624
void pfree(void *pointer)
Definition: mcxt.c:1436
MemoryContext TopMemoryContext
Definition: mcxt.c:141
void * MemoryContextAllocZero(MemoryContext context, Size size)
Definition: mcxt.c:1048
void * palloc(Size size)
Definition: mcxt.c:1210
#define AllocSetContextCreate
Definition: memutils.h:129
#define ALLOCSET_DEFAULT_SIZES
Definition: memutils.h:153
@ NormalProcessing
Definition: miscadmin.h:400
@ BootstrapProcessing
Definition: miscadmin.h:398
#define SetProcessingMode(mode)
Definition: miscadmin.h:411
void ChangeToDataDir(void)
Definition: miscinit.c:449
void InitStandaloneProcess(const char *argv0)
Definition: miscinit.c:182
bool IgnoreSystemIndexes
Definition: miscinit.c:80
void checkDataDir(void)
Definition: miscinit.c:336
void CreateDataDirLockFile(bool amPostmaster)
Definition: miscinit.c:1459
void namestrcpy(Name name, const char *str)
Definition: name.c:233
#define copyObject(obj)
Definition: nodes.h:244
static MemoryContext MemoryContextSwitchTo(MemoryContext context)
Definition: palloc.h:138
NameData attname
Definition: pg_attribute.h:41
#define ATTRIBUTE_FIXED_PART_SIZE
Definition: pg_attribute.h:199
int16 attnum
Definition: pg_attribute.h:83
int16 attlen
Definition: pg_attribute.h:68
FormData_pg_attribute * Form_pg_attribute
Definition: pg_attribute.h:207
bool attnotnull
Definition: pg_attribute.h:139
NameData relname
Definition: pg_class.h:38
#define NAMEDATALEN
#define MAXPGPATH
PGDLLIMPORT int optind
Definition: getopt.c:50
int getopt(int nargc, char *const *nargv, const char *ostr)
Definition: getopt.c:71
PGDLLIMPORT char * optarg
Definition: getopt.c:52
#define lfirst(lc)
Definition: pg_list.h:172
#define NIL
Definition: pg_list.h:68
char typalign
Definition: pg_type.h:176
FormData_pg_type
Definition: pg_type.h:254
FormData_pg_type * Form_pg_type
Definition: pg_type.h:261
pqsigfunc pqsignal(int signo, pqsigfunc func)
size_t strlcpy(char *dst, const char *src, size_t siz)
Definition: strlcpy.c:45
static const char * userDoption
Definition: postgres.c:155
static Datum PointerGetDatum(const void *X)
Definition: postgres.h:322
uintptr_t Datum
Definition: postgres.h:64
#define InvalidOid
Definition: postgres_ext.h:36
unsigned int Oid
Definition: postgres_ext.h:31
void InitializeMaxBackends(void)
Definition: postinit.c:566
void BaseInit(void)
Definition: postinit.c:636
void InitPostgres(const char *in_dbname, Oid dboid, const char *username, Oid useroid, bool load_session_libraries, bool override_allow_connections, char *out_dbname)
Definition: postinit.c:725
char * psprintf(const char *fmt,...)
Definition: psprintf.c:46
#define RelationGetNumberOfAttributes(relation)
Definition: rel.h:509
#define RelationGetRelationName(relation)
Definition: rel.h:537
void RelationMapFinishBootstrap(void)
Definition: relmapper.c:625
@ ForwardScanDirection
Definition: sdir.h:28
void InitProcess(void)
Definition: proc.c:297
uint32 WalSegSz
Definition: streamutil.c:34
uint16 * ii_ExclusionStrats
Definition: execnodes.h:186
ExprState * ii_PredicateState
Definition: execnodes.h:183
Oid * ii_ExclusionOps
Definition: execnodes.h:184
List * ii_ExpressionsState
Definition: execnodes.h:181
List * ii_Expressions
Definition: execnodes.h:180
Oid * ii_ExclusionProcs
Definition: execnodes.h:185
List * ii_Predicate
Definition: execnodes.h:182
Definition: pg_list.h:54
TupleDesc rd_att
Definition: rel.h:111
Oid il_heap
Definition: bootstrap.c:169
struct _IndexList * il_next
Definition: bootstrap.c:172
Oid il_ind
Definition: bootstrap.c:170
IndexInfo * il_info
Definition: bootstrap.c:171
char align
Definition: bootstrap.c:85
Oid outproc
Definition: bootstrap.c:89
int16 len
Definition: bootstrap.c:83
Oid oid
Definition: bootstrap.c:81
bool byval
Definition: bootstrap.c:84
char name[NAMEDATALEN]
Definition: bootstrap.c:80
Oid collation
Definition: bootstrap.c:87
Oid elem
Definition: bootstrap.c:82
char storage
Definition: bootstrap.c:86
Oid inproc
Definition: bootstrap.c:88
Oid am_oid
Definition: bootstrap.c:149
FormData_pg_type am_typ
Definition: bootstrap.c:150
void table_close(Relation relation, LOCKMODE lockmode)
Definition: table.c:126
Relation table_open(Oid relationId, LOCKMODE lockmode)
Definition: table.c:40
Relation table_openrv(const RangeVar *relation, LOCKMODE lockmode)
Definition: table.c:83
TableScanDesc table_beginscan_catalog(Relation relation, int nkeys, struct ScanKeyData *key)
Definition: tableam.c:112
static void table_endscan(TableScanDesc scan)
Definition: tableam.h:1009
char * flag(int b)
Definition: test-ctype.c:33
#define InvalidCompressionMethod
TupleDesc CreateTupleDesc(int natts, Form_pg_attribute *attrs)
Definition: tupdesc.c:90
#define TupleDescAttr(tupdesc, i)
Definition: tupdesc.h:92
#define SIGHUP
Definition: win32_port.h:176
#define SIG_DFL
Definition: win32_port.h:171
#define SIGQUIT
Definition: win32_port.h:177
void StartTransactionCommand(void)
Definition: xact.c:2944
void CommitTransactionCommand(void)
Definition: xact.c:3041
void BootStrapXLOG(void)
Definition: xlog.c:4633
#define IsValidWalSegSize(size)
Definition: xlog_internal.h:96