PostgreSQL Source Code git master
Loading...
Searching...
No Matches
initdb.c
Go to the documentation of this file.
1/*-------------------------------------------------------------------------
2 *
3 * initdb --- initialize a PostgreSQL installation
4 *
5 * initdb creates (initializes) a PostgreSQL database cluster (site,
6 * instance, installation, whatever). A database cluster is a
7 * collection of PostgreSQL databases all managed by the same server.
8 *
9 * To create the database cluster, we create the directory that contains
10 * all its data, create the files that hold the global tables, create
11 * a few other control files for it, and create three databases: the
12 * template databases "template0" and "template1", and a default user
13 * database "postgres".
14 *
15 * The template databases are ordinary PostgreSQL databases. template0
16 * is never supposed to change after initdb, whereas template1 can be
17 * changed to add site-local standard data. Either one can be copied
18 * to produce a new database.
19 *
20 * For largely-historical reasons, the template1 database is the one built
21 * by the basic bootstrap process. After it is complete, template0 and
22 * the default database, postgres, are made just by copying template1.
23 *
24 * To create template1, we run the postgres (backend) program in bootstrap
25 * mode and feed it data from the postgres.bki library file. After this
26 * initial bootstrap phase, some additional stuff is created by normal
27 * SQL commands fed to a standalone backend. Some of those commands are
28 * just embedded into this program (yeah, it's ugly), but larger chunks
29 * are taken from script files.
30 *
31 *
32 * Note:
33 * The program has some memory leakage - it isn't worth cleaning it up.
34 *
35 * This is a C implementation of the previous shell script for setting up a
36 * PostgreSQL cluster location, and should be highly compatible with it.
37 * author of C translation: Andrew Dunstan mailto:andrew@dunslane.net
38 *
39 * This code is released under the terms of the PostgreSQL License.
40 *
41 * Portions Copyright (c) 1996-2026, PostgreSQL Global Development Group
42 * Portions Copyright (c) 1994, Regents of the University of California
43 *
44 * src/bin/initdb/initdb.c
45 *
46 *-------------------------------------------------------------------------
47 */
48
49#include "postgres_fe.h"
50
51#include <dirent.h>
52#include <fcntl.h>
53#include <netdb.h>
54#include <sys/socket.h>
55#include <sys/stat.h>
56#ifdef USE_ICU
57#include <unicode/ucol.h>
58#endif
59#include <unistd.h>
60#include <signal.h>
61#include <time.h>
62
63#ifdef HAVE_SHM_OPEN
64#include <sys/mman.h>
65#endif
66
67#include "access/xlog_internal.h"
68#include "catalog/pg_authid_d.h"
69#include "catalog/pg_class_d.h"
70#include "catalog/pg_collation_d.h"
71#include "catalog/pg_database_d.h"
72#include "common/file_perm.h"
73#include "common/file_utils.h"
74#include "common/logging.h"
75#include "common/pg_prng.h"
76#include "common/restricted_token.h"
77#include "common/string.h"
78#include "common/username.h"
79#include "fe_utils/option_utils.h"
80#include "fe_utils/string_utils.h"
81#include "getopt_long.h"
82#include "mb/pg_wchar.h"
83#include "miscadmin.h"
84
85
86/* Ideally this would be in a .h file, but it hardly seems worth the trouble */
87extern const char *select_default_timezone(const char *share_path);
88
89/* simple list of strings */
90typedef struct _stringlist
91{
92 char *str;
93 struct _stringlist *next;
94} _stringlist;
95
96static const char *const auth_methods_host[] = {
97 "trust", "reject", "scram-sha-256", "md5", "password", "ident", "radius",
98#ifdef ENABLE_GSS
99 "gss",
100#endif
101#ifdef ENABLE_SSPI
102 "sspi",
103#endif
104#ifdef USE_PAM
105 "pam",
106#endif
107#ifdef USE_BSD_AUTH
108 "bsd",
109#endif
110#ifdef USE_LDAP
111 "ldap",
112#endif
113#ifdef USE_SSL
114 "cert",
115#endif
116 NULL
117};
118static const char *const auth_methods_local[] = {
119 "trust", "reject", "scram-sha-256", "md5", "password", "peer", "radius",
120#ifdef USE_PAM
121 "pam",
122#endif
123#ifdef USE_BSD_AUTH
124 "bsd",
125#endif
126#ifdef USE_LDAP
127 "ldap",
128#endif
129 NULL
130};
131
132/*
133 * these values are passed in by makefile defines
134 */
135static char *share_path = NULL;
136
137/* values to be obtained from arguments */
138static char *pg_data = NULL;
139static char *encoding = NULL;
140static char *locale = NULL;
141static char *lc_collate = NULL;
142static char *lc_ctype = NULL;
143static char *lc_monetary = NULL;
144static char *lc_numeric = NULL;
145static char *lc_time = NULL;
146static char *lc_messages = NULL;
147static char locale_provider = COLLPROVIDER_LIBC;
148static bool builtin_locale_specified = false;
149static char *datlocale = NULL;
150static bool icu_locale_specified = false;
151static char *icu_rules = NULL;
152static const char *default_text_search_config = NULL;
153static char *username = NULL;
154static bool pwprompt = false;
155static char *pwfilename = NULL;
156static char *superuser_password = NULL;
157static const char *authmethodhost = NULL;
158static const char *authmethodlocal = NULL;
159static _stringlist *extra_guc_names = NULL;
160static _stringlist *extra_guc_values = NULL;
161static bool debug = false;
162static bool noclean = false;
163static bool noinstructions = false;
164static bool do_sync = true;
165static bool sync_only = false;
166static bool show_setting = false;
167static bool data_checksums = true;
168static char *xlog_dir = NULL;
169static int wal_segment_size_mb = (DEFAULT_XLOG_SEG_SIZE) / (1024 * 1024);
170static DataDirSyncMethod sync_method = DATA_DIR_SYNC_METHOD_FSYNC;
171static bool sync_data_files = true;
172
173
174/* internal vars */
175static const char *progname;
176static int encodingid;
177static char *bki_file;
178static char *hba_file;
179static char *ident_file;
180static char *conf_file;
181static char *dictionary_file;
182static char *info_schema_file;
183static char *features_file;
184static char *system_constraints_file;
185static char *system_functions_file;
186static char *system_views_file;
187static bool success = false;
188static bool made_new_pgdata = false;
189static bool found_existing_pgdata = false;
190static bool made_new_xlogdir = false;
191static bool found_existing_xlogdir = false;
192static char infoversion[100];
193static bool caught_signal = false;
194static bool output_failed = false;
195static int output_errno = 0;
196static char *pgdata_native;
197
198/* defaults */
199static int n_connections = 10;
200static int n_av_slots = 16;
201static int n_buffers = 50;
202static const char *dynamic_shared_memory_type = NULL;
203static const char *default_timezone = NULL;
204
205/*
206 * Warning messages for authentication methods
207 */
208#define AUTHTRUST_WARNING \
209"# CAUTION: Configuring the system for local \"trust\" authentication\n" \
210"# allows any local user to connect as any PostgreSQL user, including\n" \
211"# the database superuser. If you do not trust all your local users,\n" \
212"# use another authentication method.\n"
213static bool authwarning = false;
214
215/*
216 * Centralized knowledge of switches to pass to backend
217 *
218 * Note: we run the backend with -F (fsync disabled) and then do a single
219 * pass of fsync'ing at the end. This is faster than fsync'ing each step.
220 *
221 * Note: in the shell-script version, we also passed PGDATA as a -D switch,
222 * but here it is more convenient to pass it as an environment variable
223 * (no quoting to worry about).
224 */
225static const char *const boot_options = "-F -c log_checkpoints=false";
226static const char *const backend_options = "--single -F -O -j -c search_path=pg_catalog -c exit_on_error=true -c log_checkpoints=false";
227
228/* Additional switches to pass to backend (either boot or standalone) */
229static char *extra_options = "";
230
231static const char *const subdirs[] = {
232 "global",
233 "pg_wal/archive_status",
234 "pg_wal/summaries",
235 "pg_commit_ts",
236 "pg_dynshmem",
237 "pg_notify",
238 "pg_serial",
239 "pg_snapshots",
240 "pg_subtrans",
241 "pg_twophase",
242 "pg_multixact",
243 "pg_multixact/members",
244 "pg_multixact/offsets",
245 "base",
246 "base/1",
247 "pg_replslot",
248 "pg_tblspc",
249 "pg_stat",
250 "pg_stat_tmp",
251 "pg_xact",
252 "pg_logical",
253 "pg_logical/snapshots",
254 "pg_logical/mappings"
255};
256
257
258/* path to 'initdb' binary directory */
259static char bin_path[MAXPGPATH];
260static char backend_exec[MAXPGPATH];
261
262static char **replace_token(char **lines,
263 const char *token, const char *replacement);
264static char **replace_guc_value(char **lines,
265 const char *guc_name, const char *guc_value,
266 bool mark_as_comment);
267static bool guc_value_requires_quotes(const char *guc_value);
268static char **readfile(const char *path);
269static void writefile(char *path, char **lines);
270static FILE *popen_check(const char *command, const char *mode);
271static char *get_id(void);
272static int get_encoding_id(const char *encoding_name);
273static void set_input(char **dest, const char *filename);
274static void check_input(char *path);
275static void write_version_file(const char *extrapath);
276static void set_null_conf(void);
277static void test_config_settings(void);
278static bool test_specific_config_settings(int test_conns, int test_av_slots,
279 int test_buffs);
280static void setup_config(void);
281static void bootstrap_template1(void);
282static void setup_auth(FILE *cmdfd);
283static void get_su_pwd(void);
284static void setup_depend(FILE *cmdfd);
285static void setup_run_file(FILE *cmdfd, const char *filename);
286static void setup_description(FILE *cmdfd);
287static void setup_collation(FILE *cmdfd);
288static void setup_privileges(FILE *cmdfd);
289static void set_info_version(void);
290static void setup_schema(FILE *cmdfd);
291static void load_plpgsql(FILE *cmdfd);
292static void vacuum_db(FILE *cmdfd);
293static void make_template0(FILE *cmdfd);
294static void make_postgres(FILE *cmdfd);
295static void trapsig(SIGNAL_ARGS);
296static void check_ok(void);
297static char *escape_quotes(const char *src);
298static char *escape_quotes_bki(const char *src);
299static int locale_date_order(const char *locale);
300static void check_locale_name(int category, const char *locale,
301 char **canonname);
302static bool check_locale_encoding(const char *locale, int user_enc);
303static void setlocales(void);
304static void usage(const char *progname);
305void setup_pgdata(void);
306void setup_bin_paths(const char *argv0);
307void setup_data_file_paths(void);
308void setup_locale_encoding(void);
309void setup_signals(void);
310void setup_text_search(void);
311void create_data_directory(void);
312void create_xlog_or_symlink(void);
313void warn_on_mount_point(int error);
314void initialize_data_directory(void);
315
316/*
317 * macros for running pipes to postgres
318 */
319#define PG_CMD_DECL FILE *cmdfd
320
321#define PG_CMD_OPEN(cmd) \
322do { \
323 cmdfd = popen_check(cmd, "w"); \
324 if (cmdfd == NULL) \
325 exit(1); /* message already printed by popen_check */ \
326} while (0)
327
328#define PG_CMD_CLOSE() \
329do { \
330 if (pclose_check(cmdfd)) \
331 exit(1); /* message already printed by pclose_check */ \
332} while (0)
333
334#define PG_CMD_PUTS(line) \
335do { \
336 if (fputs(line, cmdfd) < 0 || fflush(cmdfd) < 0) \
337 output_failed = true, output_errno = errno; \
338} while (0)
339
340#define PG_CMD_PRINTF(fmt, ...) \
341do { \
342 if (fprintf(cmdfd, fmt, __VA_ARGS__) < 0 || fflush(cmdfd) < 0) \
343 output_failed = true, output_errno = errno; \
344} while (0)
345
346#ifdef WIN32
347typedef wchar_t *save_locale_t;
348#else
349typedef char *save_locale_t;
350#endif
351
352/*
353 * Save a copy of the current global locale's name, for the given category.
354 * The returned value must be passed to restore_global_locale().
355 *
356 * Since names from the environment haven't been vetted for non-ASCII
357 * characters, we use the wchar_t variant of setlocale() on Windows. Otherwise
358 * they might not survive a save-restore round trip: when restoring, the name
359 * itself might be interpreted with a different encoding by plain setlocale(),
360 * after we switch to another locale in between. (This is a problem only in
361 * initdb, not in similar backend code where the global locale's name should
362 * already have been verified as ASCII-only.)
363 */
364static save_locale_t
365save_global_locale(int category)
366{
367 save_locale_t save;
368
369#ifdef WIN32
370 save = _wsetlocale(category, NULL);
371 if (!save)
372 pg_fatal("_wsetlocale() failed");
373 save = wcsdup(save);
374 if (!save)
375 pg_fatal("out of memory");
376#else
377 save = setlocale(category, NULL);
378 if (!save)
379 pg_fatal("setlocale() failed");
380 save = pg_strdup(save);
381#endif
382 return save;
383}
384
385/*
386 * Restore the global locale returned by save_global_locale().
387 */
388static void
389restore_global_locale(int category, save_locale_t save)
390{
391#ifdef WIN32
392 if (!_wsetlocale(category, save))
393 pg_fatal("failed to restore old locale");
394#else
395 if (!setlocale(category, save))
396 pg_fatal("failed to restore old locale \"%s\"", save);
397#endif
398 free(save);
399}
400
401/*
402 * Escape single quotes and backslashes, suitably for insertions into
403 * configuration files or SQL E'' strings.
404 */
405static char *
406escape_quotes(const char *src)
407{
408 char *result = escape_single_quotes_ascii(src);
409
410 if (!result)
411 pg_fatal("out of memory");
412 return result;
413}
414
415/*
416 * Escape a field value to be inserted into the BKI data.
417 * Run the value through escape_quotes (which will be inverted
418 * by the backend's DeescapeQuotedString() function), then wrap
419 * the value in single quotes, even if that isn't strictly necessary.
420 */
421static char *
422escape_quotes_bki(const char *src)
423{
424 char *result;
425 char *data = escape_quotes(src);
426 char *resultp;
427 char *datap;
428
429 result = (char *) pg_malloc(strlen(data) + 3);
430 resultp = result;
431 *resultp++ = '\'';
432 for (datap = data; *datap; datap++)
433 *resultp++ = *datap;
434 *resultp++ = '\'';
435 *resultp = '\0';
436
437 free(data);
438 return result;
439}
440
441/*
442 * Add an item at the end of a stringlist.
443 */
444static void
445add_stringlist_item(_stringlist **listhead, const char *str)
446{
447 _stringlist *newentry = pg_malloc(sizeof(_stringlist));
448 _stringlist *oldentry;
449
450 newentry->str = pg_strdup(str);
451 newentry->next = NULL;
452 if (*listhead == NULL)
453 *listhead = newentry;
454 else
455 {
456 for (oldentry = *listhead; oldentry->next; oldentry = oldentry->next)
457 /* skip */ ;
458 oldentry->next = newentry;
459 }
460}
461
462/*
463 * Modify the array of lines, replacing "token" by "replacement"
464 * the first time it occurs on each line.
465 *
466 * The array must be a malloc'd array of individually malloc'd strings.
467 * We free any discarded strings.
468 *
469 * This does most of what sed was used for in the shell script, but
470 * doesn't need any regexp stuff.
471 */
472static char **
473replace_token(char **lines, const char *token, const char *replacement)
474{
475 int toklen,
476 replen,
477 diff;
478
479 toklen = strlen(token);
480 replen = strlen(replacement);
481 diff = replen - toklen;
482
483 for (int i = 0; lines[i]; i++)
484 {
485 char *where;
486 char *newline;
487 int pre;
488
489 /* nothing to do if no change needed */
490 if ((where = strstr(lines[i], token)) == NULL)
491 continue;
492
493 /* if we get here a change is needed - set up new line */
494
495 newline = (char *) pg_malloc(strlen(lines[i]) + diff + 1);
496
497 pre = where - lines[i];
498
499 memcpy(newline, lines[i], pre);
500
501 memcpy(newline + pre, replacement, replen);
502
503 strcpy(newline + pre + replen, lines[i] + pre + toklen);
504
505 free(lines[i]);
506 lines[i] = newline;
507 }
508
509 return lines;
510}
511
512/*
513 * Modify the array of lines, replacing the possibly-commented-out
514 * assignment of parameter guc_name with a live assignment of guc_value.
515 * The value will be suitably quoted.
516 *
517 * If mark_as_comment is true, the replacement line is prefixed with '#'.
518 * This is used for fixing up cases where the effective default might not
519 * match what is in postgresql.conf.sample.
520 *
521 * We assume there's at most one matching assignment. If we find no match,
522 * append a new line with the desired assignment.
523 *
524 * The array must be a malloc'd array of individually malloc'd strings.
525 * We free any discarded strings.
526 */
527static char **
528replace_guc_value(char **lines, const char *guc_name, const char *guc_value,
529 bool mark_as_comment)
530{
531 int namelen = strlen(guc_name);
532 PQExpBuffer newline = createPQExpBuffer();
533 int i;
534
535 /* prepare the replacement line, except for possible comment and newline */
536 if (mark_as_comment)
537 appendPQExpBufferChar(newline, '#');
538 appendPQExpBuffer(newline, "%s = ", guc_name);
539 if (guc_value_requires_quotes(guc_value))
540 appendPQExpBuffer(newline, "'%s'", escape_quotes(guc_value));
541 else
542 appendPQExpBufferStr(newline, guc_value);
543
544 for (i = 0; lines[i]; i++)
545 {
546 const char *where;
547 const char *namestart;
548
549 /*
550 * Look for a line assigning to guc_name. Typically it will be
551 * preceded by '#', but that might not be the case if a -c switch
552 * overrides a previous assignment. We allow leading whitespace too,
553 * although normally there wouldn't be any.
554 */
555 where = lines[i];
556 while (*where == '#' || isspace((unsigned char) *where))
557 where++;
558 if (pg_strncasecmp(where, guc_name, namelen) != 0)
559 continue;
560 namestart = where;
561 where += namelen;
562 while (isspace((unsigned char) *where))
563 where++;
564 if (*where != '=')
565 continue;
566
567 /* found it -- let's use the canonical casing shown in the file */
568 memcpy(&newline->data[mark_as_comment ? 1 : 0], namestart, namelen);
569
570 /* now append the original comment if any */
571 where = strrchr(where, '#');
572 if (where)
573 {
574 /*
575 * We try to preserve original indentation, which is tedious.
576 * oldindent and newindent are measured in de-tab-ified columns.
577 */
578 const char *ptr;
579 int oldindent = 0;
580 int newindent;
581
582 for (ptr = lines[i]; ptr < where; ptr++)
583 {
584 if (*ptr == '\t')
585 oldindent += 8 - (oldindent % 8);
586 else
587 oldindent++;
588 }
589 /* ignore the possibility of tabs in guc_value */
590 newindent = newline->len;
591 /* append appropriate tabs and spaces, forcing at least one */
592 oldindent = Max(oldindent, newindent + 1);
593 while (newindent < oldindent)
594 {
595 int newindent_if_tab = newindent + 8 - (newindent % 8);
596
597 if (newindent_if_tab <= oldindent)
598 {
599 appendPQExpBufferChar(newline, '\t');
600 newindent = newindent_if_tab;
601 }
602 else
603 {
604 appendPQExpBufferChar(newline, ' ');
605 newindent++;
606 }
607 }
608 /* and finally append the old comment */
609 appendPQExpBufferStr(newline, where);
610 /* we'll have appended the original newline; don't add another */
611 }
612 else
613 appendPQExpBufferChar(newline, '\n');
614
615 free(lines[i]);
616 lines[i] = newline->data;
617
618 break; /* assume there's only one match */
619 }
620
621 if (lines[i] == NULL)
622 {
623 /*
624 * No match, so append a new entry. (We rely on the bootstrap server
625 * to complain if it's not a valid GUC name.)
626 */
627 appendPQExpBufferChar(newline, '\n');
628 lines = pg_realloc_array(lines, char *, i + 2);
629 lines[i++] = newline->data;
630 lines[i] = NULL; /* keep the array null-terminated */
631 }
632
633 free(newline); /* but don't free newline->data */
634
635 return lines;
636}
637
638/*
639 * Decide if we should quote a replacement GUC value. We aren't too tense
640 * here, but we'd like to avoid quoting simple identifiers and numbers
641 * with units, which are common cases.
642 */
643static bool
644guc_value_requires_quotes(const char *guc_value)
645{
646 /* Don't use <ctype.h> macros here, they might accept too much */
647#define LETTERS "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ"
648#define DIGITS "0123456789"
649
650 if (*guc_value == '\0')
651 return true; /* empty string must be quoted */
652 if (strchr(LETTERS, *guc_value))
653 {
654 if (strspn(guc_value, LETTERS DIGITS) == strlen(guc_value))
655 return false; /* it's an identifier */
656 return true; /* nope */
657 }
658 if (strchr(DIGITS, *guc_value))
659 {
660 /* skip over digits */
661 guc_value += strspn(guc_value, DIGITS);
662 /* there can be zero or more unit letters after the digits */
663 if (strspn(guc_value, LETTERS) == strlen(guc_value))
664 return false; /* it's a number, possibly with units */
665 return true; /* nope */
666 }
667 return true; /* all else must be quoted */
668}
669
670/*
671 * get the lines from a text file
672 *
673 * The result is a malloc'd array of individually malloc'd strings.
674 */
675static char **
676readfile(const char *path)
677{
678 char **result;
679 FILE *infile;
680 StringInfoData line;
681 int maxlines;
682 int n;
683
684 if ((infile = fopen(path, "r")) == NULL)
685 pg_fatal("could not open file \"%s\" for reading: %m", path);
686
687 initStringInfo(&line);
688
689 maxlines = 1024;
690 result = (char **) pg_malloc(maxlines * sizeof(char *));
691
692 n = 0;
693 while (pg_get_line_buf(infile, &line))
694 {
695 /* make sure there will be room for a trailing NULL pointer */
696 if (n >= maxlines - 1)
697 {
698 maxlines *= 2;
699 result = (char **) pg_realloc(result, maxlines * sizeof(char *));
700 }
701
702 result[n++] = pg_strdup(line.data);
703 }
704 result[n] = NULL;
705
706 pfree(line.data);
707
708 fclose(infile);
709
710 return result;
711}
712
713/*
714 * write an array of lines to a file
715 *
716 * "lines" must be a malloc'd array of individually malloc'd strings.
717 * All that data is freed here.
718 *
719 * This is only used to write text files. Use fopen "w" not PG_BINARY_W
720 * so that the resulting configuration files are nicely editable on Windows.
721 */
722static void
723writefile(char *path, char **lines)
724{
725 FILE *out_file;
726 char **line;
727
728 if ((out_file = fopen(path, "w")) == NULL)
729 pg_fatal("could not open file \"%s\" for writing: %m", path);
730 for (line = lines; *line != NULL; line++)
731 {
732 if (fputs(*line, out_file) < 0)
733 pg_fatal("could not write file \"%s\": %m", path);
734 free(*line);
735 }
736 if (fclose(out_file))
737 pg_fatal("could not close file \"%s\": %m", path);
738 free(lines);
739}
740
741/*
742 * Open a subcommand with suitable error messaging
743 */
744static FILE *
745popen_check(const char *command, const char *mode)
746{
747 FILE *cmdfd;
748
749 fflush(NULL);
750 errno = 0;
751 cmdfd = popen(command, mode);
752 if (cmdfd == NULL)
753 pg_log_error("could not execute command \"%s\": %m", command);
754 return cmdfd;
755}
756
757/*
758 * clean up any files we created on failure
759 * if we created the data directory remove it too
760 */
761static void
762cleanup_directories_atexit(void)
763{
764 if (success)
765 return;
766
767 if (!noclean)
768 {
769 if (made_new_pgdata)
770 {
771 pg_log_info("removing data directory \"%s\"", pg_data);
772 if (!rmtree(pg_data, true))
773 pg_log_error("failed to remove data directory");
774 }
775 else if (found_existing_pgdata)
776 {
777 pg_log_info("removing contents of data directory \"%s\"",
778 pg_data);
779 if (!rmtree(pg_data, false))
780 pg_log_error("failed to remove contents of data directory");
781 }
782
783 if (made_new_xlogdir)
784 {
785 pg_log_info("removing WAL directory \"%s\"", xlog_dir);
786 if (!rmtree(xlog_dir, true))
787 pg_log_error("failed to remove WAL directory");
788 }
789 else if (found_existing_xlogdir)
790 {
791 pg_log_info("removing contents of WAL directory \"%s\"", xlog_dir);
792 if (!rmtree(xlog_dir, false))
793 pg_log_error("failed to remove contents of WAL directory");
794 }
795 /* otherwise died during startup, do nothing! */
796 }
797 else
798 {
799 if (made_new_pgdata || found_existing_pgdata)
800 pg_log_info("data directory \"%s\" not removed at user's request",
801 pg_data);
802
803 if (made_new_xlogdir || found_existing_xlogdir)
804 pg_log_info("WAL directory \"%s\" not removed at user's request",
805 xlog_dir);
806 }
807}
808
809/*
810 * find the current user
811 *
812 * on unix make sure it isn't root
813 */
814static char *
815get_id(void)
816{
817 const char *username;
818
819#ifndef WIN32
820 if (geteuid() == 0) /* 0 is root's uid */
821 {
822 pg_log_error("cannot be run as root");
823 pg_log_error_hint("Please log in (using, e.g., \"su\") as the (unprivileged) user that will own the server process.");
824 exit(1);
825 }
826#endif
827
828 username = get_user_name_or_exit(progname);
829
830 return pg_strdup(username);
831}
832
833static char *
834encodingid_to_string(int enc)
835{
836 char result[20];
837
838 sprintf(result, "%d", enc);
839 return pg_strdup(result);
840}
841
842/*
843 * get the encoding id for a given encoding name
844 */
845static int
846get_encoding_id(const char *encoding_name)
847{
848 int enc;
849
850 if (encoding_name && *encoding_name)
851 {
852 if ((enc = pg_valid_server_encoding(encoding_name)) >= 0)
853 return enc;
854 }
855 pg_fatal("\"%s\" is not a valid server encoding name",
856 encoding_name ? encoding_name : "(null)");
857}
858
859/*
860 * Support for determining the best default text search configuration.
861 * We key this off the first part of LC_CTYPE (ie, the language name).
862 */
863struct tsearch_config_match
864{
865 const char *tsconfname;
866 const char *langname;
867};
868
869static const struct tsearch_config_match tsearch_config_languages[] =
870{
871 {"arabic", "ar"},
872 {"arabic", "Arabic"},
873 {"armenian", "hy"},
874 {"armenian", "Armenian"},
875 {"basque", "eu"},
876 {"basque", "Basque"},
877 {"catalan", "ca"},
878 {"catalan", "Catalan"},
879 {"danish", "da"},
880 {"danish", "Danish"},
881 {"dutch", "nl"},
882 {"dutch", "Dutch"},
883 {"english", "C"},
884 {"english", "POSIX"},
885 {"english", "en"},
886 {"english", "English"},
887 {"estonian", "et"},
888 {"estonian", "Estonian"},
889 {"finnish", "fi"},
890 {"finnish", "Finnish"},
891 {"french", "fr"},
892 {"french", "French"},
893 {"german", "de"},
894 {"german", "German"},
895 {"greek", "el"},
896 {"greek", "Greek"},
897 {"hindi", "hi"},
898 {"hindi", "Hindi"},
899 {"hungarian", "hu"},
900 {"hungarian", "Hungarian"},
901 {"indonesian", "id"},
902 {"indonesian", "Indonesian"},
903 {"irish", "ga"},
904 {"irish", "Irish"},
905 {"italian", "it"},
906 {"italian", "Italian"},
907 {"lithuanian", "lt"},
908 {"lithuanian", "Lithuanian"},
909 {"nepali", "ne"},
910 {"nepali", "Nepali"},
911 {"norwegian", "no"},
912 {"norwegian", "Norwegian"},
913 {"polish", "pl"},
914 {"polish", "Polish"},
915 {"portuguese", "pt"},
916 {"portuguese", "Portuguese"},
917 {"romanian", "ro"},
918 {"russian", "ru"},
919 {"russian", "Russian"},
920 {"serbian", "sr"},
921 {"serbian", "Serbian"},
922 {"spanish", "es"},
923 {"spanish", "Spanish"},
924 {"swedish", "sv"},
925 {"swedish", "Swedish"},
926 {"tamil", "ta"},
927 {"tamil", "Tamil"},
928 {"turkish", "tr"},
929 {"turkish", "Turkish"},
930 {"yiddish", "yi"},
931 {"yiddish", "Yiddish"},
932 {NULL, NULL} /* end marker */
933};
934
935/*
936 * Look for a text search configuration matching lc_ctype, and return its
937 * name; return NULL if no match.
938 */
939static const char *
940find_matching_ts_config(const char *lc_type)
941{
942 int i;
943 char *langname,
944 *ptr;
945
946 /*
947 * Convert lc_ctype to a language name by stripping everything after an
948 * underscore (usual case) or a hyphen (Windows "locale name"; see
949 * comments at IsoLocaleName()).
950 *
951 * XXX Should ' ' be a stop character? This would select "norwegian" for
952 * the Windows locale "Norwegian (Nynorsk)_Norway.1252". If we do so, we
953 * should also accept the "nn" and "nb" Unix locales.
954 *
955 * Just for paranoia, we also stop at '.' or '@'.
956 */
957 if (lc_type == NULL)
958 langname = pg_strdup("");
959 else
960 {
961 ptr = langname = pg_strdup(lc_type);
962 while (*ptr &&
963 *ptr != '_' && *ptr != '-' && *ptr != '.' && *ptr != '@')
964 ptr++;
965 *ptr = '\0';
966 }
967
968 for (i = 0; tsearch_config_languages[i].tsconfname; i++)
969 {
970 if (pg_strcasecmp(tsearch_config_languages[i].langname, langname) == 0)
971 {
972 free(langname);
973 return tsearch_config_languages[i].tsconfname;
974 }
975 }
976
977 free(langname);
978 return NULL;
979}
980
981
982/*
983 * set name of given input file variable under data directory
984 */
985static void
986set_input(char **dest, const char *filename)
987{
988 *dest = psprintf("%s/%s", share_path, filename);
989}
990
991/*
992 * check that given input file exists
993 */
994static void
995check_input(char *path)
996{
997 struct stat statbuf;
998
999 if (stat(path, &statbuf) != 0)
1000 {
1001 if (errno == ENOENT)
1002 {
1003 pg_log_error("file \"%s\" does not exist", path);
1004 pg_log_error_hint("This might mean you have a corrupted installation or identified the wrong directory with the invocation option -L.");
1005 }
1006 else
1007 {
1008 pg_log_error("could not access file \"%s\": %m", path);
1009 pg_log_error_hint("This might mean you have a corrupted installation or identified the wrong directory with the invocation option -L.");
1010 }
1011 exit(1);
1012 }
1013 if (!S_ISREG(statbuf.st_mode))
1014 {
1015 pg_log_error("file \"%s\" is not a regular file", path);
1016 pg_log_error_hint("This might mean you have a corrupted installation or identified the wrong directory with the invocation option -L.");
1017 exit(1);
1018 }
1019}
1020
1021/*
1022 * write out the PG_VERSION file in the data dir, or its subdirectory
1023 * if extrapath is not NULL
1024 */
1025static void
1026write_version_file(const char *extrapath)
1027{
1028 FILE *version_file;
1029 char *path;
1030
1031 if (extrapath == NULL)
1032 path = psprintf("%s/PG_VERSION", pg_data);
1033 else
1034 path = psprintf("%s/%s/PG_VERSION", pg_data, extrapath);
1035
1036 if ((version_file = fopen(path, PG_BINARY_W)) == NULL)
1037 pg_fatal("could not open file \"%s\" for writing: %m", path);
1038 if (fprintf(version_file, "%s\n", PG_MAJORVERSION) < 0 ||
1039 fclose(version_file))
1040 pg_fatal("could not write file \"%s\": %m", path);
1041 free(path);
1042}
1043
1044/*
1045 * set up an empty config file so we can check config settings by launching
1046 * a test backend
1047 */
1048static void
1049set_null_conf(void)
1050{
1051 FILE *conf_file;
1052 char *path;
1053
1054 path = psprintf("%s/postgresql.conf", pg_data);
1055 conf_file = fopen(path, PG_BINARY_W);
1056 if (conf_file == NULL)
1057 pg_fatal("could not open file \"%s\" for writing: %m", path);
1058 if (fclose(conf_file))
1059 pg_fatal("could not write file \"%s\": %m", path);
1060 free(path);
1061}
1062
1063/*
1064 * Determine which dynamic shared memory implementation should be used on
1065 * this platform. POSIX shared memory is preferable because the default
1066 * allocation limits are much higher than the limits for System V on most
1067 * systems that support both, but the fact that a platform has shm_open
1068 * doesn't guarantee that that call will succeed when attempted. So, we
1069 * attempt to reproduce what the postmaster will do when allocating a POSIX
1070 * segment in dsm_impl.c; if it doesn't work, we assume it won't work for
1071 * the postmaster either, and configure the cluster for System V shared
1072 * memory instead.
1073 *
1074 * We avoid choosing Solaris's implementation of shm_open() by default. It
1075 * can sleep and fail spuriously under contention.
1076 */
1077static const char *
1078choose_dsm_implementation(void)
1079{
1080#if defined(HAVE_SHM_OPEN) && !defined(__sun__)
1081 int ntries = 10;
1082 pg_prng_state prng_state;
1083
1084 /* Initialize prng; this function is its only user in this program. */
1085 pg_prng_seed(&prng_state, (uint64) (getpid() ^ time(NULL)));
1086
1087 while (ntries > 0)
1088 {
1089 uint32 handle;
1090 char name[64];
1091 int fd;
1092
1093 handle = pg_prng_uint32(&prng_state);
1094 snprintf(name, 64, "/PostgreSQL.%u", handle);
1095 if ((fd = shm_open(name, O_CREAT | O_RDWR | O_EXCL, 0600)) != -1)
1096 {
1097 close(fd);
1098 shm_unlink(name);
1099 return "posix";
1100 }
1101 if (errno != EEXIST)
1102 break;
1103 --ntries;
1104 }
1105#endif
1106
1107#ifdef WIN32
1108 return "windows";
1109#else
1110 return "sysv";
1111#endif
1112}
1113
1114/*
1115 * Determine platform-specific config settings
1116 *
1117 * Use reasonable values if kernel will let us, else scale back.
1118 */
1119static void
1120test_config_settings(void)
1121{
1122 /*
1123 * This macro defines the minimum shared_buffers we want for a given
1124 * max_connections value. The arrays show the settings to try.
1125 */
1126#define MIN_BUFS_FOR_CONNS(nconns) ((nconns) * 10)
1127
1128 /*
1129 * This macro defines the default value of autovacuum_worker_slots we want
1130 * for a given max_connections value. Note that it has been carefully
1131 * crafted to provide specific values for the associated values in
1132 * trial_conns. We want it to return autovacuum_worker_slots's initial
1133 * default value (16) for the maximum value in trial_conns[] (100), while
1134 * it mustn't return less than the default value of autovacuum_max_workers
1135 * (3) for the minimum value in trial_conns[].
1136 */
1137#define AV_SLOTS_FOR_CONNS(nconns) ((nconns) / 6)
1138
1139 static const int trial_conns[] = {
1140 100, 50, 40, 30, 20
1141 };
1142 static const int trial_bufs[] = {
1143 16384, 8192, 4096, 3584, 3072, 2560, 2048, 1536,
1144 1000, 900, 800, 700, 600, 500,
1145 400, 300, 200, 100, 50
1146 };
1147
1148 const int connslen = sizeof(trial_conns) / sizeof(int);
1149 const int bufslen = sizeof(trial_bufs) / sizeof(int);
1150 int i,
1151 test_conns,
1152 test_buffs,
1153 ok_buffers = 0;
1154
1155 /*
1156 * Need to determine working DSM implementation first so that subsequent
1157 * tests don't fail because DSM setting doesn't work.
1158 */
1159 printf(_("selecting dynamic shared memory implementation ... "));
1160 fflush(stdout);
1161 dynamic_shared_memory_type = choose_dsm_implementation();
1162 printf("%s\n", dynamic_shared_memory_type);
1163
1164 /*
1165 * Probe for max_connections before shared_buffers, since it is subject to
1166 * more constraints than shared_buffers. We also choose the default
1167 * autovacuum_worker_slots here.
1168 */
1169 printf(_("selecting default \"max_connections\" ... "));
1170 fflush(stdout);
1171
1172 for (i = 0; i < connslen; i++)
1173 {
1174 test_conns = trial_conns[i];
1175 n_av_slots = AV_SLOTS_FOR_CONNS(test_conns);
1176 test_buffs = MIN_BUFS_FOR_CONNS(test_conns);
1177
1178 if (test_specific_config_settings(test_conns, n_av_slots, test_buffs))
1179 {
1180 ok_buffers = test_buffs;
1181 break;
1182 }
1183 }
1184 if (i >= connslen)
1185 i = connslen - 1;
1186 n_connections = trial_conns[i];
1187
1188 printf("%d\n", n_connections);
1189
1190 printf(_("selecting default \"shared_buffers\" ... "));
1191 fflush(stdout);
1192
1193 for (i = 0; i < bufslen; i++)
1194 {
1195 /* Use same amount of memory, independent of BLCKSZ */
1196 test_buffs = (trial_bufs[i] * 8192) / BLCKSZ;
1197 if (test_buffs <= ok_buffers)
1198 {
1199 test_buffs = ok_buffers;
1200 break;
1201 }
1202
1203 if (test_specific_config_settings(n_connections, n_av_slots, test_buffs))
1204 break;
1205 }
1206 n_buffers = test_buffs;
1207
1208 if ((n_buffers * (BLCKSZ / 1024)) % 1024 == 0)
1209 printf("%dMB\n", (n_buffers * (BLCKSZ / 1024)) / 1024);
1210 else
1211 printf("%dkB\n", n_buffers * (BLCKSZ / 1024));
1212
1213 printf(_("selecting default time zone ... "));
1214 fflush(stdout);
1215 default_timezone = select_default_timezone(share_path);
1216 printf("%s\n", default_timezone ? default_timezone : "GMT");
1217}
1218
1219/*
1220 * Test a specific combination of configuration settings.
1221 */
1222static bool
1223test_specific_config_settings(int test_conns, int test_av_slots, int test_buffs)
1224{
1225 PQExpBufferData cmd;
1226 _stringlist *gnames,
1227 *gvalues;
1228 int status;
1229
1230 initPQExpBuffer(&cmd);
1231
1232 /* Set up the test postmaster invocation */
1233 printfPQExpBuffer(&cmd,
1234 "\"%s\" --check %s %s "
1235 "-c max_connections=%d "
1236 "-c autovacuum_worker_slots=%d "
1237 "-c shared_buffers=%d "
1238 "-c dynamic_shared_memory_type=%s",
1239 backend_exec, boot_options, extra_options,
1240 test_conns, test_av_slots, test_buffs,
1241 dynamic_shared_memory_type);
1242
1243 /* Add any user-given setting overrides */
1244 for (gnames = extra_guc_names, gvalues = extra_guc_values;
1245 gnames != NULL; /* assume lists have the same length */
1246 gnames = gnames->next, gvalues = gvalues->next)
1247 {
1248 appendPQExpBuffer(&cmd, " -c %s=", gnames->str);
1249 appendShellString(&cmd, gvalues->str);
1250 }
1251
1252 appendPQExpBuffer(&cmd,
1253 " < \"%s\" > \"%s\" 2>&1",
1254 DEVNULL, DEVNULL);
1255
1256 fflush(NULL);
1257 status = system(cmd.data);
1258
1259 termPQExpBuffer(&cmd);
1260
1261 return (status == 0);
1262}
1263
1264/*
1265 * Calculate the default wal_size with a "pretty" unit.
1266 */
1267static char *
1268pretty_wal_size(int segment_count)
1269{
1270 int sz = wal_segment_size_mb * segment_count;
1271 char *result = pg_malloc(14);
1272
1273 if ((sz % 1024) == 0)
1274 snprintf(result, 14, "%dGB", sz / 1024);
1275 else
1276 snprintf(result, 14, "%dMB", sz);
1277
1278 return result;
1279}
1280
1281/*
1282 * set up all the config files
1283 */
1284static void
1285setup_config(void)
1286{
1287 char **conflines;
1288 char repltok[MAXPGPATH];
1289 char path[MAXPGPATH];
1290 _stringlist *gnames,
1291 *gvalues;
1292
1293 fputs(_("creating configuration files ... "), stdout);
1294 fflush(stdout);
1295
1296 /* postgresql.conf */
1297
1298 conflines = readfile(conf_file);
1299
1300 snprintf(repltok, sizeof(repltok), "%d", n_connections);
1301 conflines = replace_guc_value(conflines, "max_connections",
1302 repltok, false);
1303
1304 snprintf(repltok, sizeof(repltok), "%d", n_av_slots);
1305 conflines = replace_guc_value(conflines, "autovacuum_worker_slots",
1306 repltok, false);
1307
1308 if ((n_buffers * (BLCKSZ / 1024)) % 1024 == 0)
1309 snprintf(repltok, sizeof(repltok), "%dMB",
1310 (n_buffers * (BLCKSZ / 1024)) / 1024);
1311 else
1312 snprintf(repltok, sizeof(repltok), "%dkB",
1313 n_buffers * (BLCKSZ / 1024));
1314 conflines = replace_guc_value(conflines, "shared_buffers",
1315 repltok, false);
1316
1317 conflines = replace_guc_value(conflines, "lc_messages",
1318 lc_messages, false);
1319
1320 conflines = replace_guc_value(conflines, "lc_monetary",
1321 lc_monetary, false);
1322
1323 conflines = replace_guc_value(conflines, "lc_numeric",
1324 lc_numeric, false);
1325
1326 conflines = replace_guc_value(conflines, "lc_time",
1327 lc_time, false);
1328
1329 switch (locale_date_order(lc_time))
1330 {
1331 case DATEORDER_YMD:
1332 strcpy(repltok, "iso, ymd");
1333 break;
1334 case DATEORDER_DMY:
1335 strcpy(repltok, "iso, dmy");
1336 break;
1337 case DATEORDER_MDY:
1338 default:
1339 strcpy(repltok, "iso, mdy");
1340 break;
1341 }
1342 conflines = replace_guc_value(conflines, "datestyle",
1343 repltok, false);
1344
1345 snprintf(repltok, sizeof(repltok), "pg_catalog.%s",
1346 default_text_search_config);
1347 conflines = replace_guc_value(conflines, "default_text_search_config",
1348 repltok, false);
1349
1350 if (default_timezone)
1351 {
1352 conflines = replace_guc_value(conflines, "timezone",
1353 default_timezone, false);
1354 conflines = replace_guc_value(conflines, "log_timezone",
1355 default_timezone, false);
1356 }
1357
1358 conflines = replace_guc_value(conflines, "dynamic_shared_memory_type",
1359 dynamic_shared_memory_type, false);
1360
1361 /* Caution: these depend on wal_segment_size_mb, they're not constants */
1362 conflines = replace_guc_value(conflines, "min_wal_size",
1363 pretty_wal_size(DEFAULT_MIN_WAL_SEGS), false);
1364
1365 conflines = replace_guc_value(conflines, "max_wal_size",
1366 pretty_wal_size(DEFAULT_MAX_WAL_SEGS), false);
1367
1368 /*
1369 * Fix up various entries to match the true compile-time defaults. Since
1370 * these are indeed defaults, keep the postgresql.conf lines commented.
1371 */
1372 conflines = replace_guc_value(conflines, "unix_socket_directories",
1373 DEFAULT_PGSOCKET_DIR, true);
1374
1375 conflines = replace_guc_value(conflines, "port",
1376 DEF_PGPORT_STR, true);
1377
1378#if DEFAULT_BACKEND_FLUSH_AFTER > 0
1379 snprintf(repltok, sizeof(repltok), "%dkB",
1380 DEFAULT_BACKEND_FLUSH_AFTER * (BLCKSZ / 1024));
1381 conflines = replace_guc_value(conflines, "backend_flush_after",
1382 repltok, true);
1383#endif
1384
1385#if DEFAULT_BGWRITER_FLUSH_AFTER > 0
1386 snprintf(repltok, sizeof(repltok), "%dkB",
1387 DEFAULT_BGWRITER_FLUSH_AFTER * (BLCKSZ / 1024));
1388 conflines = replace_guc_value(conflines, "bgwriter_flush_after",
1389 repltok, true);
1390#endif
1391
1392#if DEFAULT_CHECKPOINT_FLUSH_AFTER > 0
1393 snprintf(repltok, sizeof(repltok), "%dkB",
1394 DEFAULT_CHECKPOINT_FLUSH_AFTER * (BLCKSZ / 1024));
1395 conflines = replace_guc_value(conflines, "checkpoint_flush_after",
1396 repltok, true);
1397#endif
1398
1399#ifdef WIN32
1400 conflines = replace_guc_value(conflines, "update_process_title",
1401 "off", true);
1402#endif
1403
1404 /*
1405 * Change password_encryption setting to md5 if md5 was chosen as an
1406 * authentication method, unless scram-sha-256 was also chosen.
1407 */
1408 if ((strcmp(authmethodlocal, "md5") == 0 &&
1409 strcmp(authmethodhost, "scram-sha-256") != 0) ||
1410 (strcmp(authmethodhost, "md5") == 0 &&
1411 strcmp(authmethodlocal, "scram-sha-256") != 0))
1412 {
1413 conflines = replace_guc_value(conflines, "password_encryption",
1414 "md5", false);
1415 }
1416
1417 /*
1418 * If group access has been enabled for the cluster then it makes sense to
1419 * ensure that the log files also allow group access. Otherwise a backup
1420 * from a user in the group would fail if the log files were not
1421 * relocated.
1422 */
1423 if (pg_dir_create_mode == PG_DIR_MODE_GROUP)
1424 {
1425 conflines = replace_guc_value(conflines, "log_file_mode",
1426 "0640", false);
1427 }
1428
1429 /*
1430 * Now replace anything that's overridden via -c switches.
1431 */
1432 for (gnames = extra_guc_names, gvalues = extra_guc_values;
1433 gnames != NULL; /* assume lists have the same length */
1434 gnames = gnames->next, gvalues = gvalues->next)
1435 {
1436 conflines = replace_guc_value(conflines, gnames->str,
1437 gvalues->str, false);
1438 }
1439
1440 /* ... and write out the finished postgresql.conf file */
1441 snprintf(path, sizeof(path), "%s/postgresql.conf", pg_data);
1442
1443 writefile(path, conflines);
1444 if (chmod(path, pg_file_create_mode) != 0)
1445 pg_fatal("could not change permissions of \"%s\": %m", path);
1446
1447
1448 /* postgresql.auto.conf */
1449
1450 conflines = pg_malloc_array(char *, 3);
1451 conflines[0] = pg_strdup("# Do not edit this file manually!\n");
1452 conflines[1] = pg_strdup("# It will be overwritten by the ALTER SYSTEM command.\n");
1453 conflines[2] = NULL;
1454
1455 sprintf(path, "%s/postgresql.auto.conf", pg_data);
1456
1457 writefile(path, conflines);
1458 if (chmod(path, pg_file_create_mode) != 0)
1459 pg_fatal("could not change permissions of \"%s\": %m", path);
1460
1461
1462 /* pg_hba.conf */
1463
1464 conflines = readfile(hba_file);
1465
1466 conflines = replace_token(conflines, "@remove-line-for-nolocal@", "");
1467
1468
1469 /*
1470 * Probe to see if there is really any platform support for IPv6, and
1471 * comment out the relevant pg_hba line if not. This avoids runtime
1472 * warnings if getaddrinfo doesn't actually cope with IPv6. Particularly
1473 * useful on Windows, where executables built on a machine with IPv6 may
1474 * have to run on a machine without.
1475 */
1476 {
1477 struct addrinfo *gai_result;
1478 struct addrinfo hints;
1479 int err = 0;
1480
1481#ifdef WIN32
1482 /* need to call WSAStartup before calling getaddrinfo */
1483 WSADATA wsaData;
1484
1485 err = WSAStartup(MAKEWORD(2, 2), &wsaData);
1486#endif
1487
1488 /* for best results, this code should match parse_hba_line() */
1489 hints.ai_flags = AI_NUMERICHOST;
1490 hints.ai_family = AF_UNSPEC;
1491 hints.ai_socktype = 0;
1492 hints.ai_protocol = 0;
1493 hints.ai_addrlen = 0;
1494 hints.ai_canonname = NULL;
1495 hints.ai_addr = NULL;
1496 hints.ai_next = NULL;
1497
1498 if (err != 0 ||
1499 getaddrinfo("::1", NULL, &hints, &gai_result) != 0)
1500 {
1501 conflines = replace_token(conflines,
1502 "host all all ::1",
1503 "#host all all ::1");
1504 conflines = replace_token(conflines,
1505 "host replication all ::1",
1506 "#host replication all ::1");
1507 }
1508 }
1509
1510 /* Replace default authentication methods */
1511 conflines = replace_token(conflines,
1512 "@authmethodhost@",
1513 authmethodhost);
1514 conflines = replace_token(conflines,
1515 "@authmethodlocal@",
1516 authmethodlocal);
1517
1518 conflines = replace_token(conflines,
1519 "@authcomment@",
1520 (strcmp(authmethodlocal, "trust") == 0 || strcmp(authmethodhost, "trust") == 0) ? AUTHTRUST_WARNING : "");
1521
1522 snprintf(path, sizeof(path), "%s/pg_hba.conf", pg_data);
1523
1524 writefile(path, conflines);
1525 if (chmod(path, pg_file_create_mode) != 0)
1526 pg_fatal("could not change permissions of \"%s\": %m", path);
1527
1528
1529 /* pg_ident.conf */
1530
1531 conflines = readfile(ident_file);
1532
1533 snprintf(path, sizeof(path), "%s/pg_ident.conf", pg_data);
1534
1535 writefile(path, conflines);
1536 if (chmod(path, pg_file_create_mode) != 0)
1537 pg_fatal("could not change permissions of \"%s\": %m", path);
1538
1539 check_ok();
1540}
1541
1542
1543/*
1544 * run the BKI script in bootstrap mode to create template1
1545 */
1546static void
1547bootstrap_template1(void)
1548{
1549 PG_CMD_DECL;
1550 PQExpBufferData cmd;
1551 char **line;
1552 char **bki_lines;
1553 char headerline[MAXPGPATH];
1554 char buf[64];
1555
1556 printf(_("running bootstrap script ... "));
1557 fflush(stdout);
1558
1559 bki_lines = readfile(bki_file);
1560
1561 /* Check that bki file appears to be of the right version */
1562
1563 snprintf(headerline, sizeof(headerline), "# PostgreSQL %s\n",
1564 PG_MAJORVERSION);
1565
1566 if (strcmp(headerline, *bki_lines) != 0)
1567 {
1568 pg_log_error("input file \"%s\" does not belong to PostgreSQL %s",
1569 bki_file, PG_VERSION);
1570 pg_log_error_hint("Specify the correct path using the option -L.");
1571 exit(1);
1572 }
1573
1574 /* Substitute for various symbols used in the BKI file */
1575
1576 sprintf(buf, "%d", NAMEDATALEN);
1577 bki_lines = replace_token(bki_lines, "NAMEDATALEN", buf);
1578
1579 sprintf(buf, "%d", (int) sizeof(Pointer));
1580 bki_lines = replace_token(bki_lines, "SIZEOF_POINTER", buf);
1581
1582 bki_lines = replace_token(bki_lines, "ALIGNOF_POINTER",
1583 (sizeof(Pointer) == 4) ? "i" : "d");
1584
1585 bki_lines = replace_token(bki_lines, "POSTGRES",
1586 escape_quotes_bki(username));
1587
1588 bki_lines = replace_token(bki_lines, "ENCODING",
1589 encodingid_to_string(encodingid));
1590
1591 bki_lines = replace_token(bki_lines, "LC_COLLATE",
1592 escape_quotes_bki(lc_collate));
1593
1594 bki_lines = replace_token(bki_lines, "LC_CTYPE",
1595 escape_quotes_bki(lc_ctype));
1596
1597 bki_lines = replace_token(bki_lines, "DATLOCALE",
1598 datlocale ? escape_quotes_bki(datlocale) : "_null_");
1599
1600 bki_lines = replace_token(bki_lines, "ICU_RULES",
1601 icu_rules ? escape_quotes_bki(icu_rules) : "_null_");
1602
1603 sprintf(buf, "%c", locale_provider);
1604 bki_lines = replace_token(bki_lines, "LOCALE_PROVIDER", buf);
1605
1606 /* Also ensure backend isn't confused by this environment var: */
1607 unsetenv("PGCLIENTENCODING");
1608
1609 initPQExpBuffer(&cmd);
1610
1611 printfPQExpBuffer(&cmd, "\"%s\" --boot %s %s", backend_exec, boot_options, extra_options);
1612 appendPQExpBuffer(&cmd, " -X %d", wal_segment_size_mb * (1024 * 1024));
1613 if (data_checksums)
1614 appendPQExpBufferStr(&cmd, " -k");
1615 if (debug)
1616 appendPQExpBufferStr(&cmd, " -d 5");
1617
1618
1619 PG_CMD_OPEN(cmd.data);
1620
1621 for (line = bki_lines; *line != NULL; line++)
1622 {
1623 PG_CMD_PUTS(*line);
1624 free(*line);
1625 }
1626
1627 PG_CMD_CLOSE();
1628
1629 termPQExpBuffer(&cmd);
1630 free(bki_lines);
1631
1632 check_ok();
1633}
1634
1635/*
1636 * set up the shadow password table
1637 */
1638static void
1639setup_auth(FILE *cmdfd)
1640{
1641 /*
1642 * The authid table shouldn't be readable except through views, to ensure
1643 * passwords are not publicly visible.
1644 */
1645 PG_CMD_PUTS("REVOKE ALL ON pg_authid FROM public;\n\n");
1646
1647 if (superuser_password)
1648 PG_CMD_PRINTF("ALTER USER \"%s\" WITH PASSWORD E'%s';\n\n",
1649 username, escape_quotes(superuser_password));
1650}
1651
1652/*
1653 * get the superuser password if required
1654 */
1655static void
1656get_su_pwd(void)
1657{
1658 char *pwd1;
1659
1660 if (pwprompt)
1661 {
1662 /*
1663 * Read password from terminal
1664 */
1665 char *pwd2;
1666
1667 printf("\n");
1668 fflush(stdout);
1669 pwd1 = simple_prompt("Enter new superuser password: ", false);
1670 pwd2 = simple_prompt("Enter it again: ", false);
1671 if (strcmp(pwd1, pwd2) != 0)
1672 {
1673 fprintf(stderr, _("Passwords didn't match.\n"));
1674 exit(1);
1675 }
1676 free(pwd2);
1677 }
1678 else
1679 {
1680 /*
1681 * Read password from file
1682 *
1683 * Ideally this should insist that the file not be world-readable.
1684 * However, this option is mainly intended for use on Windows where
1685 * file permissions may not exist at all, so we'll skip the paranoia
1686 * for now.
1687 */
1688 FILE *pwf = fopen(pwfilename, "r");
1689
1690 if (!pwf)
1691 pg_fatal("could not open file \"%s\" for reading: %m",
1692 pwfilename);
1693 pwd1 = pg_get_line(pwf, NULL);
1694 if (!pwd1)
1695 {
1696 if (ferror(pwf))
1697 pg_fatal("could not read password from file \"%s\": %m",
1698 pwfilename);
1699 else
1700 pg_fatal("password file \"%s\" is empty",
1701 pwfilename);
1702 }
1703 fclose(pwf);
1704
1705 (void) pg_strip_crlf(pwd1);
1706 }
1707
1708 superuser_password = pwd1;
1709}
1710
1711/*
1712 * set up pg_depend
1713 */
1714static void
1715setup_depend(FILE *cmdfd)
1716{
1717 /*
1718 * Advance the OID counter so that subsequently-created objects aren't
1719 * pinned.
1720 */
1721 PG_CMD_PUTS("SELECT pg_stop_making_pinned_objects();\n\n");
1722}
1723
1724/*
1725 * Run external file
1726 */
1727static void
1728setup_run_file(FILE *cmdfd, const char *filename)
1729{
1730 char **lines;
1731
1732 lines = readfile(filename);
1733
1734 for (char **line = lines; *line != NULL; line++)
1735 {
1736 PG_CMD_PUTS(*line);
1737 free(*line);
1738 }
1739
1740 PG_CMD_PUTS("\n\n");
1741
1742 free(lines);
1743}
1744
1745/*
1746 * fill in extra description data
1747 */
1748static void
1749setup_description(FILE *cmdfd)
1750{
1751 /* Create default descriptions for operator implementation functions */
1752 PG_CMD_PUTS("WITH funcdescs AS ( "
1753 "SELECT p.oid as p_oid, o.oid as o_oid, oprname "
1754 "FROM pg_proc p JOIN pg_operator o ON oprcode = p.oid ) "
1755 "INSERT INTO pg_description "
1756 " SELECT p_oid, 'pg_proc'::regclass, 0, "
1757 " 'implementation of ' || oprname || ' operator' "
1758 " FROM funcdescs "
1759 " WHERE NOT EXISTS (SELECT 1 FROM pg_description "
1760 " WHERE objoid = p_oid AND classoid = 'pg_proc'::regclass) "
1761 " AND NOT EXISTS (SELECT 1 FROM pg_description "
1762 " WHERE objoid = o_oid AND classoid = 'pg_operator'::regclass"
1763 " AND description LIKE 'deprecated%');\n\n");
1764}
1765
1766/*
1767 * populate pg_collation
1768 */
1769static void
1770setup_collation(FILE *cmdfd)
1771{
1772 /*
1773 * Set the collation version for collations defined in pg_collation.dat,
1774 * but not the ones where we know that the collation behavior will never
1775 * change.
1776 */
1777 PG_CMD_PUTS("UPDATE pg_collation SET collversion = pg_collation_actual_version(oid) WHERE collname = 'unicode';\n\n");
1778
1779 /* Import all collations we can find in the operating system */
1780 PG_CMD_PUTS("SELECT pg_import_system_collations('pg_catalog');\n\n");
1781}
1782
1783/*
1784 * Set up privileges
1785 *
1786 * We mark most system catalogs as world-readable. We don't currently have
1787 * to touch functions, languages, or databases, because their default
1788 * permissions are OK.
1789 *
1790 * Some objects may require different permissions by default, so we
1791 * make sure we don't overwrite privilege sets that have already been
1792 * set (NOT NULL).
1793 *
1794 * Also populate pg_init_privs to save what the privileges are at init
1795 * time. This is used by pg_dump to allow users to change privileges
1796 * on catalog objects and to have those privilege changes preserved
1797 * across dump/reload and pg_upgrade.
1798 *
1799 * Note that pg_init_privs is only for per-database objects and therefore
1800 * we don't include databases or tablespaces.
1801 */
1802static void
1803setup_privileges(FILE *cmdfd)
1804{
1805 PG_CMD_PRINTF("UPDATE pg_class "
1806 " SET relacl = (SELECT array_agg(a.acl) FROM "
1807 " (SELECT E'=r/\"%s\"' as acl "
1808 " UNION SELECT unnest(pg_catalog.acldefault("
1809 " CASE WHEN relkind = " CppAsString2(RELKIND_SEQUENCE) " THEN 's' "
1810 " ELSE 'r' END::\"char\"," CppAsString2(BOOTSTRAP_SUPERUSERID) "::oid))"
1811 " ) as a) "
1812 " WHERE relkind IN (" CppAsString2(RELKIND_RELATION) ", "
1813 CppAsString2(RELKIND_VIEW) ", " CppAsString2(RELKIND_MATVIEW) ", "
1814 CppAsString2(RELKIND_SEQUENCE) ")"
1815 " AND relacl IS NULL;\n\n",
1816 escape_quotes(username));
1817 PG_CMD_PUTS("GRANT USAGE ON SCHEMA pg_catalog, public TO PUBLIC;\n\n");
1818 PG_CMD_PUTS("REVOKE ALL ON pg_largeobject FROM PUBLIC;\n\n");
1819 PG_CMD_PUTS("INSERT INTO pg_init_privs "
1820 " (objoid, classoid, objsubid, initprivs, privtype)"
1821 " SELECT"
1822 " oid,"
1823 " (SELECT oid FROM pg_class WHERE relname = 'pg_class'),"
1824 " 0,"
1825 " relacl,"
1826 " 'i'"
1827 " FROM"
1828 " pg_class"
1829 " WHERE"
1830 " relacl IS NOT NULL"
1831 " AND relkind IN (" CppAsString2(RELKIND_RELATION) ", "
1832 CppAsString2(RELKIND_VIEW) ", " CppAsString2(RELKIND_MATVIEW) ", "
1833 CppAsString2(RELKIND_SEQUENCE) ");\n\n");
1834 PG_CMD_PUTS("INSERT INTO pg_init_privs "
1835 " (objoid, classoid, objsubid, initprivs, privtype)"
1836 " SELECT"
1837 " pg_class.oid,"
1838 " (SELECT oid FROM pg_class WHERE relname = 'pg_class'),"
1839 " pg_attribute.attnum,"
1840 " pg_attribute.attacl,"
1841 " 'i'"
1842 " FROM"
1843 " pg_class"
1844 " JOIN pg_attribute ON (pg_class.oid = pg_attribute.attrelid)"
1845 " WHERE"
1846 " pg_attribute.attacl IS NOT NULL"
1847 " AND pg_class.relkind IN (" CppAsString2(RELKIND_RELATION) ", "
1848 CppAsString2(RELKIND_VIEW) ", " CppAsString2(RELKIND_MATVIEW) ", "
1849 CppAsString2(RELKIND_SEQUENCE) ");\n\n");
1850 PG_CMD_PUTS("INSERT INTO pg_init_privs "
1851 " (objoid, classoid, objsubid, initprivs, privtype)"
1852 " SELECT"
1853 " oid,"
1854 " (SELECT oid FROM pg_class WHERE relname = 'pg_proc'),"
1855 " 0,"
1856 " proacl,"
1857 " 'i'"
1858 " FROM"
1859 " pg_proc"
1860 " WHERE"
1861 " proacl IS NOT NULL;\n\n");
1862 PG_CMD_PUTS("INSERT INTO pg_init_privs "
1863 " (objoid, classoid, objsubid, initprivs, privtype)"
1864 " SELECT"
1865 " oid,"
1866 " (SELECT oid FROM pg_class WHERE relname = 'pg_type'),"
1867 " 0,"
1868 " typacl,"
1869 " 'i'"
1870 " FROM"
1871 " pg_type"
1872 " WHERE"
1873 " typacl IS NOT NULL;\n\n");
1874 PG_CMD_PUTS("INSERT INTO pg_init_privs "
1875 " (objoid, classoid, objsubid, initprivs, privtype)"
1876 " SELECT"
1877 " oid,"
1878 " (SELECT oid FROM pg_class WHERE relname = 'pg_language'),"
1879 " 0,"
1880 " lanacl,"
1881 " 'i'"
1882 " FROM"
1883 " pg_language"
1884 " WHERE"
1885 " lanacl IS NOT NULL;\n\n");
1886 PG_CMD_PUTS("INSERT INTO pg_init_privs "
1887 " (objoid, classoid, objsubid, initprivs, privtype)"
1888 " SELECT"
1889 " oid,"
1890 " (SELECT oid FROM pg_class WHERE "
1891 " relname = 'pg_largeobject_metadata'),"
1892 " 0,"
1893 " lomacl,"
1894 " 'i'"
1895 " FROM"
1896 " pg_largeobject_metadata"
1897 " WHERE"
1898 " lomacl IS NOT NULL;\n\n");
1899 PG_CMD_PUTS("INSERT INTO pg_init_privs "
1900 " (objoid, classoid, objsubid, initprivs, privtype)"
1901 " SELECT"
1902 " oid,"
1903 " (SELECT oid FROM pg_class WHERE relname = 'pg_namespace'),"
1904 " 0,"
1905 " nspacl,"
1906 " 'i'"
1907 " FROM"
1908 " pg_namespace"
1909 " WHERE"
1910 " nspacl IS NOT NULL;\n\n");
1911 PG_CMD_PUTS("INSERT INTO pg_init_privs "
1912 " (objoid, classoid, objsubid, initprivs, privtype)"
1913 " SELECT"
1914 " oid,"
1915 " (SELECT oid FROM pg_class WHERE "
1916 " relname = 'pg_foreign_data_wrapper'),"
1917 " 0,"
1918 " fdwacl,"
1919 " 'i'"
1920 " FROM"
1921 " pg_foreign_data_wrapper"
1922 " WHERE"
1923 " fdwacl IS NOT NULL;\n\n");
1924 PG_CMD_PUTS("INSERT INTO pg_init_privs "
1925 " (objoid, classoid, objsubid, initprivs, privtype)"
1926 " SELECT"
1927 " oid,"
1928 " (SELECT oid FROM pg_class "
1929 " WHERE relname = 'pg_foreign_server'),"
1930 " 0,"
1931 " srvacl,"
1932 " 'i'"
1933 " FROM"
1934 " pg_foreign_server"
1935 " WHERE"
1936 " srvacl IS NOT NULL;\n\n");
1937}
1938
1939/*
1940 * extract the strange version of version required for information schema
1941 * (09.08.0007abc)
1942 */
1943static void
1944set_info_version(void)
1945{
1946 char *letterversion;
1947 long major = 0,
1948 minor = 0,
1949 micro = 0;
1950 char *endptr;
1951 char *vstr = pg_strdup(PG_VERSION);
1952 char *ptr;
1953
1954 ptr = vstr + (strlen(vstr) - 1);
1955 while (ptr != vstr && (*ptr < '0' || *ptr > '9'))
1956 ptr--;
1957 letterversion = ptr + 1;
1958 major = strtol(vstr, &endptr, 10);
1959 if (*endptr)
1960 minor = strtol(endptr + 1, &endptr, 10);
1961 if (*endptr)
1962 micro = strtol(endptr + 1, &endptr, 10);
1963 snprintf(infoversion, sizeof(infoversion), "%02ld.%02ld.%04ld%s",
1964 major, minor, micro, letterversion);
1965}
1966
1967/*
1968 * load info schema and populate from features file
1969 */
1970static void
1971setup_schema(FILE *cmdfd)
1972{
1973 setup_run_file(cmdfd, info_schema_file);
1974
1975 PG_CMD_PRINTF("UPDATE information_schema.sql_implementation_info "
1976 " SET character_value = '%s' "
1977 " WHERE implementation_info_name = 'DBMS VERSION';\n\n",
1978 infoversion);
1979
1980 PG_CMD_PRINTF("COPY information_schema.sql_features "
1981 " (feature_id, feature_name, sub_feature_id, "
1982 " sub_feature_name, is_supported, comments) "
1983 " FROM E'%s';\n\n",
1984 escape_quotes(features_file));
1985}
1986
1987/*
1988 * load PL/pgSQL server-side language
1989 */
1990static void
1991load_plpgsql(FILE *cmdfd)
1992{
1993 PG_CMD_PUTS("CREATE EXTENSION plpgsql;\n\n");
1994}
1995
1996/*
1997 * clean everything up in template1
1998 */
1999static void
2000vacuum_db(FILE *cmdfd)
2001{
2002 /* Run analyze before VACUUM so the statistics are frozen. */
2003 PG_CMD_PUTS("ANALYZE;\n\nVACUUM FREEZE;\n\n");
2004}
2005
2006/*
2007 * copy template1 to template0
2008 */
2009static void
2010make_template0(FILE *cmdfd)
2011{
2012 /*
2013 * pg_upgrade tries to preserve database OIDs across upgrades. It's smart
2014 * enough to drop and recreate a conflicting database with the same name,
2015 * but if the same OID were used for one system-created database in the
2016 * old cluster and a different system-created database in the new cluster,
2017 * it would fail. To avoid that, assign a fixed OID to template0 rather
2018 * than letting the server choose one.
2019 *
2020 * (Note that, while the user could have dropped and recreated these
2021 * objects in the old cluster, the problem scenario only exists if the OID
2022 * that is in use in the old cluster is also used in the new cluster - and
2023 * the new cluster should be the result of a fresh initdb.)
2024 *
2025 * We use "STRATEGY = file_copy" here because checkpoints during initdb
2026 * are cheap. "STRATEGY = wal_log" would generate more WAL, which would be
2027 * a little bit slower and make the new cluster a little bit bigger.
2028 */
2029 PG_CMD_PUTS("CREATE DATABASE template0 IS_TEMPLATE = true ALLOW_CONNECTIONS = false"
2030 " OID = " CppAsString2(Template0DbOid)
2031 " STRATEGY = file_copy;\n\n");
2032
2033 /*
2034 * template0 shouldn't have any collation-dependent objects, so unset the
2035 * collation version. This disables collation version checks when making
2036 * a new database from it.
2037 */
2038 PG_CMD_PUTS("UPDATE pg_database SET datcollversion = NULL WHERE datname = 'template0';\n\n");
2039
2040 /*
2041 * While we are here, do set the collation version on template1.
2042 */
2043 PG_CMD_PUTS("UPDATE pg_database SET datcollversion = pg_database_collation_actual_version(oid) WHERE datname = 'template1';\n\n");
2044
2045 /*
2046 * Explicitly revoke public create-schema and create-temp-table privileges
2047 * in template1 and template0; else the latter would be on by default
2048 */
2049 PG_CMD_PUTS("REVOKE CREATE,TEMPORARY ON DATABASE template1 FROM public;\n\n");
2050 PG_CMD_PUTS("REVOKE CREATE,TEMPORARY ON DATABASE template0 FROM public;\n\n");
2051
2052 PG_CMD_PUTS("COMMENT ON DATABASE template0 IS 'unmodifiable empty database';\n\n");
2053
2054 /*
2055 * Finally vacuum to clean up dead rows in pg_database
2056 */
2057 PG_CMD_PUTS("VACUUM pg_database;\n\n");
2058}
2059
2060/*
2061 * copy template1 to postgres
2062 */
2063static void
2064make_postgres(FILE *cmdfd)
2065{
2066 /*
2067 * Just as we did for template0, and for the same reasons, assign a fixed
2068 * OID to postgres and select the file_copy strategy.
2069 */
2070 PG_CMD_PUTS("CREATE DATABASE postgres OID = " CppAsString2(PostgresDbOid)
2071 " STRATEGY = file_copy;\n\n");
2072 PG_CMD_PUTS("COMMENT ON DATABASE postgres IS 'default administrative connection database';\n\n");
2073}
2074
2075/*
2076 * signal handler in case we are interrupted.
2077 *
2078 * The Windows runtime docs at
2079 * https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/signal
2080 * specifically forbid a number of things being done from a signal handler,
2081 * including IO, memory allocation and system calls, and only allow jmpbuf
2082 * if you are handling SIGFPE.
2083 *
2084 * I avoided doing the forbidden things by setting a flag instead of calling
2085 * exit() directly.
2086 *
2087 * Also note the behaviour of Windows with SIGINT, which says this:
2088 * SIGINT is not supported for any Win32 application. When a CTRL+C interrupt
2089 * occurs, Win32 operating systems generate a new thread to specifically
2090 * handle that interrupt. This can cause a single-thread application, such as
2091 * one in UNIX, to become multithreaded and cause unexpected behavior.
2092 *
2093 * I have no idea how to handle this. (Strange they call UNIX an application!)
2094 * So this will need some testing on Windows.
2095 */
2096static void
2097trapsig(SIGNAL_ARGS)
2098{
2099 /* handle systems that reset the handler, like Windows (grr) */
2100 pqsignal(postgres_signal_arg, trapsig);
2101 caught_signal = true;
2102}
2103
2104/*
2105 * call exit() if we got a signal, or else output "ok".
2106 */
2107static void
2108check_ok(void)
2109{
2110 if (caught_signal)
2111 {
2112 printf(_("caught signal\n"));
2113 fflush(stdout);
2114 exit(1);
2115 }
2116 else if (output_failed)
2117 {
2118 printf(_("could not write to child process: %s\n"),
2119 strerror(output_errno));
2120 fflush(stdout);
2121 exit(1);
2122 }
2123 else
2124 {
2125 /* all seems well */
2126 printf(_("ok\n"));
2127 fflush(stdout);
2128 }
2129}
2130
2131/* Hack to suppress a warning about %x from some versions of gcc */
2132static inline size_t
2133my_strftime(char *s, size_t max, const char *fmt, const struct tm *tm)
2134{
2135 return strftime(s, max, fmt, tm);
2136}
2137
2138/*
2139 * Determine likely date order from locale
2140 */
2141static int
2142locale_date_order(const char *locale)
2143{
2144 struct tm testtime;
2145 char buf[128];
2146 char *posD;
2147 char *posM;
2148 char *posY;
2149 save_locale_t save;
2150 size_t res;
2151 int result;
2152
2153 result = DATEORDER_MDY; /* default */
2154
2155 save = save_global_locale(LC_TIME);
2156
2157 setlocale(LC_TIME, locale);
2158
2159 memset(&testtime, 0, sizeof(testtime));
2160 testtime.tm_mday = 22;
2161 testtime.tm_mon = 10; /* November, should come out as "11" */
2162 testtime.tm_year = 133; /* 2033 */
2163
2164 res = my_strftime(buf, sizeof(buf), "%x", &testtime);
2165
2166 restore_global_locale(LC_TIME, save);
2167
2168 if (res == 0)
2169 return result;
2170
2171 posM = strstr(buf, "11");
2172 posD = strstr(buf, "22");
2173 posY = strstr(buf, "33");
2174
2175 if (!posM || !posD || !posY)
2176 return result;
2177
2178 if (posY < posM && posM < posD)
2179 result = DATEORDER_YMD;
2180 else if (posD < posM)
2181 result = DATEORDER_DMY;
2182 else
2183 result = DATEORDER_MDY;
2184
2185 return result;
2186}
2187
2188/*
2189 * Verify that locale name is valid for the locale category.
2190 *
2191 * If successful, and canonname isn't NULL, a malloc'd copy of the locale's
2192 * canonical name is stored there. This is especially useful for figuring out
2193 * what locale name "" means (ie, the environment value). (Actually,
2194 * it seems that on most implementations that's the only thing it's good for;
2195 * we could wish that setlocale gave back a canonically spelled version of
2196 * the locale name, but typically it doesn't.)
2197 *
2198 * this should match the backend's check_locale() function
2199 */
2200static void
2201check_locale_name(int category, const char *locale, char **canonname)
2202{
2203 save_locale_t save;
2204 char *res;
2205
2206 /* Don't let Windows' non-ASCII locale names in. */
2207 if (locale && !pg_is_ascii(locale))
2208 pg_fatal("locale name \"%s\" contains non-ASCII characters", locale);
2209
2210 if (canonname)
2211 *canonname = NULL; /* in case of failure */
2212
2213 save = save_global_locale(category);
2214
2215 /* for setlocale() call */
2216 if (!locale)
2217 locale = "";
2218
2219 /* set the locale with setlocale, to see if it accepts it. */
2220 res = setlocale(category, locale);
2221
2222 /* save canonical name if requested. */
2223 if (res && canonname)
2224 *canonname = pg_strdup(res);
2225
2226 /* restore old value. */
2227 restore_global_locale(category, save);
2228
2229 /* complain if locale wasn't valid */
2230 if (res == NULL)
2231 {
2232 if (*locale)
2233 {
2234 pg_log_error("invalid locale name \"%s\"", locale);
2235 pg_log_error_hint("If the locale name is specific to ICU, use --icu-locale.");
2236 exit(1);
2237 }
2238 else
2239 {
2240 /*
2241 * If no relevant switch was given on command line, locale is an
2242 * empty string, which is not too helpful to report. Presumably
2243 * setlocale() found something it did not like in the environment.
2244 * Ideally we'd report the bad environment variable, but since
2245 * setlocale's behavior is implementation-specific, it's hard to
2246 * be sure what it didn't like. Print a safe generic message.
2247 */
2248 pg_fatal("invalid locale settings; check LANG and LC_* environment variables");
2249 }
2250 }
2251
2252 /* Don't let Windows' non-ASCII locale names out. */
2253 if (canonname && !pg_is_ascii(*canonname))
2254 pg_fatal("locale name \"%s\" contains non-ASCII characters",
2255 *canonname);
2256}
2257
2258/*
2259 * check if the chosen encoding matches the encoding required by the locale
2260 *
2261 * this should match the similar check in the backend createdb() function
2262 */
2263static bool
2264check_locale_encoding(const char *locale, int user_enc)
2265{
2266 int locale_enc;
2267
2268 locale_enc = pg_get_encoding_from_locale(locale, true);
2269
2270 /* See notes in createdb() to understand these tests */
2271 if (!(locale_enc == user_enc ||
2272 locale_enc == PG_SQL_ASCII ||
2273 locale_enc == -1 ||
2274#ifdef WIN32
2275 user_enc == PG_UTF8 ||
2276#endif
2277 user_enc == PG_SQL_ASCII))
2278 {
2279 pg_log_error("encoding mismatch");
2280 pg_log_error_detail("The encoding you selected (%s) and the encoding that the "
2281 "selected locale uses (%s) do not match. This would lead to "
2282 "misbehavior in various character string processing functions.",
2283 pg_encoding_to_char(user_enc),
2284 pg_encoding_to_char(locale_enc));
2285 pg_log_error_hint("Rerun %s and either do not specify an encoding explicitly, "
2286 "or choose a matching combination.",
2287 progname);
2288 return false;
2289 }
2290 return true;
2291}
2292
2293/*
2294 * check if the chosen encoding matches is supported by ICU
2295 *
2296 * this should match the similar check in the backend createdb() function
2297 */
2298static bool
2299check_icu_locale_encoding(int user_enc)
2300{
2301 if (!(is_encoding_supported_by_icu(user_enc)))
2302 {
2303 pg_log_error("encoding mismatch");
2304 pg_log_error_detail("The encoding you selected (%s) is not supported with the ICU provider.",
2305 pg_encoding_to_char(user_enc));
2306 pg_log_error_hint("Rerun %s and either do not specify an encoding explicitly, "
2307 "or choose a matching combination.",
2308 progname);
2309 return false;
2310 }
2311 return true;
2312}
2313
2314/*
2315 * Convert to canonical BCP47 language tag. Must be consistent with
2316 * icu_language_tag().
2317 */
2318static char *
2319icu_language_tag(const char *loc_str)
2320{
2321#ifdef USE_ICU
2322 UErrorCode status;
2323 char *langtag;
2324 size_t buflen = 32; /* arbitrary starting buffer size */
2325 const bool strict = true;
2326
2327 /*
2328 * A BCP47 language tag doesn't have a clearly-defined upper limit (cf.
2329 * RFC5646 section 4.4). Additionally, in older ICU versions,
2330 * uloc_toLanguageTag() doesn't always return the ultimate length on the
2331 * first call, necessitating a loop.
2332 */
2333 langtag = pg_malloc(buflen);
2334 while (true)
2335 {
2336 status = U_ZERO_ERROR;
2337 uloc_toLanguageTag(loc_str, langtag, buflen, strict, &status);
2338
2339 /* try again if the buffer is not large enough */
2340 if (status == U_BUFFER_OVERFLOW_ERROR ||
2341 status == U_STRING_NOT_TERMINATED_WARNING)
2342 {
2343 buflen = buflen * 2;
2344 langtag = pg_realloc(langtag, buflen);
2345 continue;
2346 }
2347
2348 break;
2349 }
2350
2351 if (U_FAILURE(status))
2352 {
2353 pg_free(langtag);
2354
2355 pg_fatal("could not convert locale name \"%s\" to language tag: %s",
2356 loc_str, u_errorName(status));
2357 }
2358
2359 return langtag;
2360#else
2361 pg_fatal("ICU is not supported in this build");
2362 return NULL; /* keep compiler quiet */
2363#endif
2364}
2365
2366/*
2367 * Perform best-effort check that the locale is a valid one. Should be
2368 * consistent with pg_locale.c, except that it doesn't need to open the
2369 * collator (that will happen during post-bootstrap initialization).
2370 */
2371static void
2372icu_validate_locale(const char *loc_str)
2373{
2374#ifdef USE_ICU
2375 UErrorCode status;
2376 char lang[ULOC_LANG_CAPACITY];
2377 bool found = false;
2378
2379 /* validate that we can extract the language */
2380 status = U_ZERO_ERROR;
2381 uloc_getLanguage(loc_str, lang, ULOC_LANG_CAPACITY, &status);
2382 if (U_FAILURE(status))
2383 {
2384 pg_fatal("could not get language from locale \"%s\": %s",
2385 loc_str, u_errorName(status));
2386 return;
2387 }
2388
2389 /* check for special language name */
2390 if (strcmp(lang, "") == 0 ||
2391 strcmp(lang, "root") == 0 || strcmp(lang, "und") == 0)
2392 found = true;
2393
2394 /* search for matching language within ICU */
2395 for (int32_t i = 0; !found && i < uloc_countAvailable(); i++)
2396 {
2397 const char *otherloc = uloc_getAvailable(i);
2398 char otherlang[ULOC_LANG_CAPACITY];
2399
2400 status = U_ZERO_ERROR;
2401 uloc_getLanguage(otherloc, otherlang, ULOC_LANG_CAPACITY, &status);
2402 if (U_FAILURE(status))
2403 continue;
2404
2405 if (strcmp(lang, otherlang) == 0)
2406 found = true;
2407 }
2408
2409 if (!found)
2410 pg_fatal("locale \"%s\" has unknown language \"%s\"",
2411 loc_str, lang);
2412#else
2413 pg_fatal("ICU is not supported in this build");
2414#endif
2415}
2416
2417/*
2418 * set up the locale variables
2419 *
2420 * assumes we have called setlocale(LC_ALL, "") -- see set_pglocale_pgservice
2421 */
2422static void
2423setlocales(void)
2424{
2425 char *canonname;
2426
2427 /* set empty lc_* and datlocale values to locale config if set */
2428
2429 if (locale)
2430 {
2431 if (!lc_ctype)
2432 lc_ctype = locale;
2433 if (!lc_collate)
2434 lc_collate = locale;
2435 if (!lc_numeric)
2436 lc_numeric = locale;
2437 if (!lc_time)
2438 lc_time = locale;
2439 if (!lc_monetary)
2440 lc_monetary = locale;
2441 if (!lc_messages)
2442 lc_messages = locale;
2443 if (!datlocale && locale_provider != COLLPROVIDER_LIBC)
2444 datlocale = locale;
2445 }
2446
2447 /*
2448 * canonicalize locale names, and obtain any missing values from our
2449 * current environment
2450 */
2451 check_locale_name(LC_CTYPE, lc_ctype, &canonname);
2452 lc_ctype = canonname;
2453 check_locale_name(LC_COLLATE, lc_collate, &canonname);
2454 lc_collate = canonname;
2455 check_locale_name(LC_NUMERIC, lc_numeric, &canonname);
2456 lc_numeric = canonname;
2457 check_locale_name(LC_TIME, lc_time, &canonname);
2458 lc_time = canonname;
2459 check_locale_name(LC_MONETARY, lc_monetary, &canonname);
2460 lc_monetary = canonname;
2461#if defined(LC_MESSAGES) && !defined(WIN32)
2462 check_locale_name(LC_MESSAGES, lc_messages, &canonname);
2463 lc_messages = canonname;
2464#else
2465 /* when LC_MESSAGES is not available, use the LC_CTYPE setting */
2466 check_locale_name(LC_CTYPE, lc_messages, &canonname);
2467 lc_messages = canonname;
2468#endif
2469
2470 if (locale_provider != COLLPROVIDER_LIBC && datlocale == NULL)
2471 pg_fatal("locale must be specified if provider is %s",
2472 collprovider_name(locale_provider));
2473
2474 if (locale_provider == COLLPROVIDER_BUILTIN)
2475 {
2476 if (strcmp(datlocale, "C") == 0)
2477 canonname = "C";
2478 else if (strcmp(datlocale, "C.UTF-8") == 0 ||
2479 strcmp(datlocale, "C.UTF8") == 0)
2480 canonname = "C.UTF-8";
2481 else if (strcmp(datlocale, "PG_UNICODE_FAST") == 0)
2482 canonname = "PG_UNICODE_FAST";
2483 else
2484 pg_fatal("invalid locale name \"%s\" for builtin provider",
2485 datlocale);
2486
2487 datlocale = canonname;
2488 }
2489 else if (locale_provider == COLLPROVIDER_ICU)
2490 {
2491 char *langtag;
2492
2493 /* canonicalize to a language tag */
2494 langtag = icu_language_tag(datlocale);
2495 printf(_("Using language tag \"%s\" for ICU locale \"%s\".\n"),
2496 langtag, datlocale);
2497 pg_free(datlocale);
2498 datlocale = langtag;
2499
2500 icu_validate_locale(datlocale);
2501
2502 /*
2503 * In supported builds, the ICU locale ID will be opened during
2504 * post-bootstrap initialization, which will perform extra checks.
2505 */
2506#ifndef USE_ICU
2507 pg_fatal("ICU is not supported in this build");
2508#endif
2509 }
2510}
2511
2512/*
2513 * print help text
2514 */
2515static void
2516usage(const char *progname)
2517{
2518 printf(_("%s initializes a PostgreSQL database cluster.\n\n"), progname);
2519 printf(_("Usage:\n"));
2520 printf(_(" %s [OPTION]... [DATADIR]\n"), progname);
2521 printf(_("\nOptions:\n"));
2522 printf(_(" -A, --auth=METHOD default authentication method for local connections\n"));
2523 printf(_(" --auth-host=METHOD default authentication method for local TCP/IP connections\n"));
2524 printf(_(" --auth-local=METHOD default authentication method for local-socket connections\n"));
2525 printf(_(" [-D, --pgdata=]DATADIR location for this database cluster\n"));
2526 printf(_(" -E, --encoding=ENCODING set default encoding for new databases\n"));
2527 printf(_(" -g, --allow-group-access allow group read/execute on data directory\n"));
2528 printf(_(" --icu-locale=LOCALE set ICU locale ID for new databases\n"));
2529 printf(_(" --icu-rules=RULES set additional ICU collation rules for new databases\n"));
2530 printf(_(" -k, --data-checksums use data page checksums\n"));
2531 printf(_(" --locale=LOCALE set default locale for new databases\n"));
2532 printf(_(" --lc-collate=, --lc-ctype=, --lc-messages=LOCALE\n"
2533 " --lc-monetary=, --lc-numeric=, --lc-time=LOCALE\n"
2534 " set default locale in the respective category for\n"
2535 " new databases (default taken from environment)\n"));
2536 printf(_(" --no-locale equivalent to --locale=C\n"));
2537 printf(_(" --builtin-locale=LOCALE\n"
2538 " set builtin locale name for new databases\n"));
2539 printf(_(" --locale-provider={builtin|libc|icu}\n"
2540 " set default locale provider for new databases\n"));
2541 printf(_(" --no-data-checksums do not use data page checksums\n"));
2542 printf(_(" --pwfile=FILE read password for the new superuser from file\n"));
2543 printf(_(" -T, --text-search-config=CFG\n"
2544 " default text search configuration\n"));
2545 printf(_(" -U, --username=NAME database superuser name\n"));
2546 printf(_(" -W, --pwprompt prompt for a password for the new superuser\n"));
2547 printf(_(" -X, --waldir=WALDIR location for the write-ahead log directory\n"));
2548 printf(_(" --wal-segsize=SIZE size of WAL segments, in megabytes\n"));
2549 printf(_("\nLess commonly used options:\n"));
2550 printf(_(" -c, --set NAME=VALUE override default setting for server parameter\n"));
2551 printf(_(" -d, --debug generate lots of debugging output\n"));
2552 printf(_(" --discard-caches set debug_discard_caches=1\n"));
2553 printf(_(" -L DIRECTORY where to find the input files\n"));
2554 printf(_(" -n, --no-clean do not clean up after errors\n"));
2555 printf(_(" -N, --no-sync do not wait for changes to be written safely to disk\n"));
2556 printf(_(" --no-sync-data-files do not sync files within database directories\n"));
2557 printf(_(" --no-instructions do not print instructions for next steps\n"));
2558 printf(_(" -s, --show show internal settings, then exit\n"));
2559 printf(_(" --sync-method=METHOD set method for syncing files to disk\n"));
2560 printf(_(" -S, --sync-only only sync database files to disk, then exit\n"));
2561 printf(_("\nOther options:\n"));
2562 printf(_(" -V, --version output version information, then exit\n"));
2563 printf(_(" -?, --help show this help, then exit\n"));
2564 printf(_("\nIf the data directory is not specified, the environment variable PGDATA\n"
2565 "is used.\n"));
2566 printf(_("\nReport bugs to <%s>.\n"), PACKAGE_BUGREPORT);
2567 printf(_("%s home page: <%s>\n"), PACKAGE_NAME, PACKAGE_URL);
2568}
2569
2570static void
2571check_authmethod_unspecified(const char **authmethod)
2572{
2573 if (*authmethod == NULL)
2574 {
2575 authwarning = true;
2576 *authmethod = "trust";
2577 }
2578}
2579
2580static void
2581check_authmethod_valid(const char *authmethod, const char *const *valid_methods, const char *conntype)
2582{
2583 const char *const *p;
2584
2585 for (p = valid_methods; *p; p++)
2586 {
2587 if (strcmp(authmethod, *p) == 0)
2588 return;
2589 }
2590
2591 pg_fatal("invalid authentication method \"%s\" for \"%s\" connections",
2592 authmethod, conntype);
2593}
2594
2595static void
2596check_need_password(const char *authmethodlocal, const char *authmethodhost)
2597{
2598 if ((strcmp(authmethodlocal, "md5") == 0 ||
2599 strcmp(authmethodlocal, "password") == 0 ||
2600 strcmp(authmethodlocal, "scram-sha-256") == 0) &&
2601 (strcmp(authmethodhost, "md5") == 0 ||
2602 strcmp(authmethodhost, "password") == 0 ||
2603 strcmp(authmethodhost, "scram-sha-256") == 0) &&
2604 !(pwprompt || pwfilename))
2605 pg_fatal("must specify a password for the superuser to enable password authentication");
2606}
2607
2608
2609void
2610setup_pgdata(void)
2611{
2612 char *pgdata_get_env;
2613
2614 if (!pg_data)
2615 {
2616 pgdata_get_env = getenv("PGDATA");
2617 if (pgdata_get_env && strlen(pgdata_get_env))
2618 {
2619 /* PGDATA found */
2620 pg_data = pg_strdup(pgdata_get_env);
2621 }
2622 else
2623 {
2624 pg_log_error("no data directory specified");
2625 pg_log_error_hint("You must identify the directory where the data for this database system "
2626 "will reside. Do this with either the invocation option -D or the "
2627 "environment variable PGDATA.");
2628 exit(1);
2629 }
2630 }
2631
2632 pgdata_native = pg_strdup(pg_data);
2633 canonicalize_path(pg_data);
2634
2635 /*
2636 * we have to set PGDATA for postgres rather than pass it on the command
2637 * line to avoid dumb quoting problems on Windows, and we would especially
2638 * need quotes otherwise on Windows because paths there are most likely to
2639 * have embedded spaces.
2640 */
2641 if (setenv("PGDATA", pg_data, 1) != 0)
2642 pg_fatal("could not set environment");
2643}
2644
2645
2646void
2647setup_bin_paths(const char *argv0)
2648{
2649 int ret;
2650
2651 if ((ret = find_other_exec(argv0, "postgres", PG_BACKEND_VERSIONSTR,
2652 backend_exec)) < 0)
2653 {
2654 char full_path[MAXPGPATH];
2655
2656 if (find_my_exec(argv0, full_path) < 0)
2657 strlcpy(full_path, progname, sizeof(full_path));
2658
2659 if (ret == -1)
2660 pg_fatal("program \"%s\" is needed by %s but was not found in the same directory as \"%s\"",
2661 "postgres", progname, full_path);
2662 else
2663 pg_fatal("program \"%s\" was found by \"%s\" but was not the same version as %s",
2664 "postgres", full_path, progname);
2665 }
2666
2667 /* store binary directory */
2668 strcpy(bin_path, backend_exec);
2669 *last_dir_separator(bin_path) = '\0';
2670 canonicalize_path(bin_path);
2671
2672 if (!share_path)
2673 {
2674 share_path = pg_malloc(MAXPGPATH);
2675 get_share_path(backend_exec, share_path);
2676 }
2677 else if (!is_absolute_path(share_path))
2678 pg_fatal("input file location must be an absolute path");
2679
2680 canonicalize_path(share_path);
2681}
2682
2683void
2684setup_locale_encoding(void)
2685{
2686 setlocales();
2687
2688 if (locale_provider == COLLPROVIDER_LIBC &&
2689 strcmp(lc_ctype, lc_collate) == 0 &&
2690 strcmp(lc_ctype, lc_time) == 0 &&
2691 strcmp(lc_ctype, lc_numeric) == 0 &&
2692 strcmp(lc_ctype, lc_monetary) == 0 &&
2693 strcmp(lc_ctype, lc_messages) == 0 &&
2694 (!datlocale || strcmp(lc_ctype, datlocale) == 0))
2695 printf(_("The database cluster will be initialized with locale \"%s\".\n"), lc_ctype);
2696 else
2697 {
2698 printf(_("The database cluster will be initialized with this locale configuration:\n"));
2699 printf(_(" locale provider: %s\n"), collprovider_name(locale_provider));
2700 if (locale_provider != COLLPROVIDER_LIBC)
2701 printf(_(" default collation: %s\n"), datlocale);
2702 printf(_(" LC_COLLATE: %s\n"
2703 " LC_CTYPE: %s\n"
2704 " LC_MESSAGES: %s\n"
2705 " LC_MONETARY: %s\n"
2706 " LC_NUMERIC: %s\n"
2707 " LC_TIME: %s\n"),
2708 lc_collate,
2709 lc_ctype,
2710 lc_messages,
2711 lc_monetary,
2712 lc_numeric,
2713 lc_time);
2714 }
2715
2716 if (!encoding)
2717 {
2718 int ctype_enc;
2719
2720 ctype_enc = pg_get_encoding_from_locale(lc_ctype, true);
2721
2722 /*
2723 * If ctype_enc=SQL_ASCII, it's compatible with any encoding. ICU does
2724 * not support SQL_ASCII, so select UTF-8 instead.
2725 */
2726 if (locale_provider == COLLPROVIDER_ICU && ctype_enc == PG_SQL_ASCII)
2727 ctype_enc = PG_UTF8;
2728
2729 if (ctype_enc == -1)
2730 {
2731 /* Couldn't recognize the locale's codeset */
2732 pg_log_error("could not find suitable encoding for locale \"%s\"",
2733 lc_ctype);
2734 pg_log_error_hint("Rerun %s with the -E option.", progname);
2735 pg_log_error_hint("Try \"%s --help\" for more information.", progname);
2736 exit(1);
2737 }
2738 else if (!pg_valid_server_encoding_id(ctype_enc))
2739 {
2740 /*
2741 * We recognized it, but it's not a legal server encoding. On
2742 * Windows, UTF-8 works with any locale, so we can fall back to
2743 * UTF-8.
2744 */
2745#ifdef WIN32
2746 encodingid = PG_UTF8;
2747 printf(_("Encoding \"%s\" implied by locale is not allowed as a server-side encoding.\n"
2748 "The default database encoding will be set to \"%s\" instead.\n"),
2749 pg_encoding_to_char(ctype_enc),
2750 pg_encoding_to_char(encodingid));
2751#else
2752 pg_log_error("locale \"%s\" requires unsupported encoding \"%s\"",
2753 lc_ctype, pg_encoding_to_char(ctype_enc));
2754 pg_log_error_detail("Encoding \"%s\" is not allowed as a server-side encoding.",
2755 pg_encoding_to_char(ctype_enc));
2756 pg_log_error_hint("Rerun %s with a different locale selection.",
2757 progname);
2758 exit(1);
2759#endif
2760 }
2761 else
2762 {
2763 encodingid = ctype_enc;
2764 printf(_("The default database encoding has accordingly been set to \"%s\".\n"),
2765 pg_encoding_to_char(encodingid));
2766 }
2767 }
2768 else
2769 encodingid = get_encoding_id(encoding);
2770
2771 if (!check_locale_encoding(lc_ctype, encodingid) ||
2772 !check_locale_encoding(lc_collate, encodingid))
2773 exit(1); /* check_locale_encoding printed the error */
2774
2775 if (locale_provider == COLLPROVIDER_BUILTIN)
2776 {
2777 if ((strcmp(datlocale, "C.UTF-8") == 0 ||
2778 strcmp(datlocale, "PG_UNICODE_FAST") == 0) &&
2779 encodingid != PG_UTF8)
2780 pg_fatal("builtin provider locale \"%s\" requires encoding \"%s\"",
2781 datlocale, "UTF-8");
2782 }
2783
2784 if (locale_provider == COLLPROVIDER_ICU &&
2785 !check_icu_locale_encoding(encodingid))
2786 exit(1);
2787}
2788
2789
2790void
2791setup_data_file_paths(void)
2792{
2793 set_input(&bki_file, "postgres.bki");
2794 set_input(&hba_file, "pg_hba.conf.sample");
2795 set_input(&ident_file, "pg_ident.conf.sample");
2796 set_input(&conf_file, "postgresql.conf.sample");
2797 set_input(&dictionary_file, "snowball_create.sql");
2798 set_input(&info_schema_file, "information_schema.sql");
2799 set_input(&features_file, "sql_features.txt");
2800 set_input(&system_constraints_file, "system_constraints.sql");
2801 set_input(&system_functions_file, "system_functions.sql");
2802 set_input(&system_views_file, "system_views.sql");
2803
2804 if (show_setting || debug)
2805 {
2806 fprintf(stderr,
2807 "VERSION=%s\n"
2808 "PGDATA=%s\nshare_path=%s\nPGPATH=%s\n"
2809 "POSTGRES_SUPERUSERNAME=%s\nPOSTGRES_BKI=%s\n"
2810 "POSTGRESQL_CONF_SAMPLE=%s\n"
2811 "PG_HBA_SAMPLE=%s\nPG_IDENT_SAMPLE=%s\n",
2812 PG_VERSION,
2813 pg_data, share_path, bin_path,
2814 username, bki_file,
2815 conf_file,
2816 hba_file, ident_file);
2817 if (show_setting)
2818 exit(0);
2819 }
2820
2821 check_input(bki_file);
2822 check_input(hba_file);
2823 check_input(ident_file);
2824 check_input(conf_file);
2825 check_input(dictionary_file);
2826 check_input(info_schema_file);
2827 check_input(features_file);
2828 check_input(system_constraints_file);
2829 check_input(system_functions_file);
2830 check_input(system_views_file);
2831}
2832
2833
2834void
2835setup_text_search(void)
2836{
2837 if (!default_text_search_config)
2838 {
2839 default_text_search_config = find_matching_ts_config(lc_ctype);
2840 if (!default_text_search_config)
2841 {
2842 pg_log_info("could not find suitable text search configuration for locale \"%s\"",
2843 lc_ctype);
2844 default_text_search_config = "simple";
2845 }
2846 }
2847 else
2848 {
2849 const char *checkmatch = find_matching_ts_config(lc_ctype);
2850
2851 if (checkmatch == NULL)
2852 {
2853 pg_log_warning("suitable text search configuration for locale \"%s\" is unknown",
2854 lc_ctype);
2855 }
2856 else if (strcmp(checkmatch, default_text_search_config) != 0)
2857 {
2858 pg_log_warning("specified text search configuration \"%s\" might not match locale \"%s\"",
2859 default_text_search_config, lc_ctype);
2860 }
2861 }
2862
2863 printf(_("The default text search configuration will be set to \"%s\".\n"),
2864 default_text_search_config);
2865}
2866
2867
2868void
2869setup_signals(void)
2870{
2871 pqsignal(SIGINT, trapsig);
2872 pqsignal(SIGTERM, trapsig);
2873
2874 /* the following are not valid on Windows */
2875#ifndef WIN32
2876 pqsignal(SIGHUP, trapsig);
2877 pqsignal(SIGQUIT, trapsig);
2878
2879 /* Ignore SIGPIPE when writing to backend, so we can clean up */
2880 pqsignal(SIGPIPE, SIG_IGN);
2881
2882 /* Prevent SIGSYS so we can probe for kernel calls that might not work */
2883 pqsignal(SIGSYS, SIG_IGN);
2884#endif
2885}
2886
2887
2888void
2889create_data_directory(void)
2890{
2891 int ret;
2892
2893 switch ((ret = pg_check_dir(pg_data)))
2894 {
2895 case 0:
2896 /* PGDATA not there, must create it */
2897 printf(_("creating directory %s ... "),
2898 pg_data);
2899 fflush(stdout);
2900
2901 if (pg_mkdir_p(pg_data, pg_dir_create_mode) != 0)
2902 pg_fatal("could not create directory \"%s\": %m", pg_data);
2903 else
2904 check_ok();
2905
2906 made_new_pgdata = true;
2907 break;
2908
2909 case 1:
2910 /* Present but empty, fix permissions and use it */
2911 printf(_("fixing permissions on existing directory %s ... "),
2912 pg_data);
2913 fflush(stdout);
2914
2915 if (chmod(pg_data, pg_dir_create_mode) != 0)
2916 pg_fatal("could not change permissions of directory \"%s\": %m",
2917 pg_data);
2918 else
2919 check_ok();
2920
2921 found_existing_pgdata = true;
2922 break;
2923
2924 case 2:
2925 case 3:
2926 case 4:
2927 /* Present and not empty */
2928 pg_log_error("directory \"%s\" exists but is not empty", pg_data);
2929 if (ret != 4)
2930 warn_on_mount_point(ret);
2931 else
2932 pg_log_error_hint("If you want to create a new database system, either remove or empty "
2933 "the directory \"%s\" or run %s "
2934 "with an argument other than \"%s\".",
2935 pg_data, progname, pg_data);
2936 exit(1); /* no further message needed */
2937
2938 default:
2939 /* Trouble accessing directory */
2940 pg_fatal("could not access directory \"%s\": %m", pg_data);
2941 }
2942}
2943
2944
2945/* Create WAL directory, and symlink if required */
2946void
2947create_xlog_or_symlink(void)
2948{
2949 char *subdirloc;
2950
2951 /* form name of the place for the subdirectory or symlink */
2952 subdirloc = psprintf("%s/pg_wal", pg_data);
2953
2954 if (xlog_dir)
2955 {
2956 int ret;
2957
2958 /* clean up xlog directory name, check it's absolute */
2959 canonicalize_path(xlog_dir);
2960 if (!is_absolute_path(xlog_dir))
2961 pg_fatal("WAL directory location must be an absolute path");
2962
2963 /* check if the specified xlog directory exists/is empty */
2964 switch ((ret = pg_check_dir(xlog_dir)))
2965 {
2966 case 0:
2967 /* xlog directory not there, must create it */
2968 printf(_("creating directory %s ... "),
2969 xlog_dir);
2970 fflush(stdout);
2971
2972 if (pg_mkdir_p(xlog_dir, pg_dir_create_mode) != 0)
2973 pg_fatal("could not create directory \"%s\": %m",
2974 xlog_dir);
2975 else
2976 check_ok();
2977
2978 made_new_xlogdir = true;
2979 break;
2980
2981 case 1:
2982 /* Present but empty, fix permissions and use it */
2983 printf(_("fixing permissions on existing directory %s ... "),
2984 xlog_dir);
2985 fflush(stdout);
2986
2987 if (chmod(xlog_dir, pg_dir_create_mode) != 0)
2988 pg_fatal("could not change permissions of directory \"%s\": %m",
2989 xlog_dir);
2990 else
2991 check_ok();
2992
2993 found_existing_xlogdir = true;
2994 break;
2995
2996 case 2:
2997 case 3:
2998 case 4:
2999 /* Present and not empty */
3000 pg_log_error("directory \"%s\" exists but is not empty", xlog_dir);
3001 if (ret != 4)
3002 warn_on_mount_point(ret);
3003 else
3004 pg_log_error_hint("If you want to store the WAL there, either remove or empty the directory \"%s\".",
3005 xlog_dir);
3006 exit(1);
3007
3008 default:
3009 /* Trouble accessing directory */
3010 pg_fatal("could not access directory \"%s\": %m", xlog_dir);
3011 }
3012
3013 if (symlink(xlog_dir, subdirloc) != 0)
3014 pg_fatal("could not create symbolic link \"%s\": %m",
3015 subdirloc);
3016 }
3017 else
3018 {
3019 /* Without -X option, just make the subdirectory normally */
3020 if (mkdir(subdirloc, pg_dir_create_mode) < 0)
3021 pg_fatal("could not create directory \"%s\": %m",
3022 subdirloc);
3023 }
3024
3025 free(subdirloc);
3026}
3027
3028
3029void
3030warn_on_mount_point(int error)
3031{
3032 if (error == 2)
3033 pg_log_error_detail("It contains a dot-prefixed/invisible file, perhaps due to it being a mount point.");
3034 else if (error == 3)
3035 pg_log_error_detail("It contains a lost+found directory, perhaps due to it being a mount point.");
3036
3037 pg_log_error_hint("Using a mount point directly as the data directory is not recommended.\n"
3038 "Create a subdirectory under the mount point.");
3039}
3040
3041
3042void
3043initialize_data_directory(void)
3044{
3045 PG_CMD_DECL;
3046 PQExpBufferData cmd;
3047 int i;
3048
3049 setup_signals();
3050
3051 /*
3052 * Set mask based on requested PGDATA permissions. pg_mode_mask, and
3053 * friends like pg_dir_create_mode, are set to owner-only by default and
3054 * then updated if -g is passed in by calling SetDataDirectoryCreatePerm()
3055 * when parsing our options (see above).
3056 */
3057 umask(pg_mode_mask);
3058
3059 create_data_directory();
3060
3061 create_xlog_or_symlink();
3062
3063 /* Create required subdirectories (other than pg_wal) */
3064 printf(_("creating subdirectories ... "));
3065 fflush(stdout);
3066
3067 for (i = 0; i < lengthof(subdirs); i++)
3068 {
3069 char *path;
3070
3071 path = psprintf("%s/%s", pg_data, subdirs[i]);
3072
3073 /*
3074 * The parent directory already exists, so we only need mkdir() not
3075 * pg_mkdir_p() here, which avoids some failure modes; cf bug #13853.
3076 */
3077 if (mkdir(path, pg_dir_create_mode) < 0)
3078 pg_fatal("could not create directory \"%s\": %m", path);
3079
3080 free(path);
3081 }
3082
3083 check_ok();
3084
3085 /* Top level PG_VERSION is checked by bootstrapper, so make it first */
3086 write_version_file(NULL);
3087
3088 /* Select suitable configuration settings */
3089 set_null_conf();
3090 test_config_settings();
3091
3092 /* Now create all the text config files */
3093 setup_config();
3094
3095 /* Bootstrap template1 */
3096 bootstrap_template1();
3097
3098 /*
3099 * Make the per-database PG_VERSION for template1 only after init'ing it
3100 */
3101 write_version_file("base/1");
3102
3103 /*
3104 * Create the stuff we don't need to use bootstrap mode for, using a
3105 * backend running in simple standalone mode.
3106 */
3107 fputs(_("performing post-bootstrap initialization ... "), stdout);
3108 fflush(stdout);
3109
3110 initPQExpBuffer(&cmd);
3111 printfPQExpBuffer(&cmd, "\"%s\" %s %s template1 >%s",
3112 backend_exec, backend_options, extra_options, DEVNULL);
3113
3114 PG_CMD_OPEN(cmd.data);
3115
3116 setup_auth(cmdfd);
3117
3118 setup_run_file(cmdfd, system_constraints_file);
3119
3120 setup_run_file(cmdfd, system_functions_file);
3121
3122 setup_depend(cmdfd);
3123
3124 /*
3125 * Note that no objects created after setup_depend() will be "pinned".
3126 * They are all droppable at the whim of the DBA.
3127 */
3128
3129 setup_run_file(cmdfd, system_views_file);
3130
3131 setup_description(cmdfd);
3132
3133 setup_collation(cmdfd);
3134
3135 setup_run_file(cmdfd, dictionary_file);
3136
3137 setup_privileges(cmdfd);
3138
3139 setup_schema(cmdfd);
3140
3141 load_plpgsql(cmdfd);
3142
3143 vacuum_db(cmdfd);
3144
3145 make_template0(cmdfd);
3146
3147 make_postgres(cmdfd);
3148
3149 PG_CMD_CLOSE();
3150 termPQExpBuffer(&cmd);
3151
3152 check_ok();
3153}
3154
3155
3156int
3157main(int argc, char *argv[])
3158{
3159 static struct option long_options[] = {
3160 {"pgdata", required_argument, NULL, 'D'},
3161 {"encoding", required_argument, NULL, 'E'},
3162 {"locale", required_argument, NULL, 1},
3163 {"lc-collate", required_argument, NULL, 2},
3164 {"lc-ctype", required_argument, NULL, 3},
3165 {"lc-monetary", required_argument, NULL, 4},
3166 {"lc-numeric", required_argument, NULL, 5},
3167 {"lc-time", required_argument, NULL, 6},
3168 {"lc-messages", required_argument, NULL, 7},
3169 {"no-locale", no_argument, NULL, 8},
3170 {"text-search-config", required_argument, NULL, 'T'},
3171 {"auth", required_argument, NULL, 'A'},
3172 {"auth-local", required_argument, NULL, 10},
3173 {"auth-host", required_argument, NULL, 11},
3174 {"pwprompt", no_argument, NULL, 'W'},
3175 {"pwfile", required_argument, NULL, 9},
3176 {"username", required_argument, NULL, 'U'},
3177 {"help", no_argument, NULL, '?'},
3178 {"version", no_argument, NULL, 'V'},
3179 {"debug", no_argument, NULL, 'd'},
3180 {"show", no_argument, NULL, 's'},
3181 {"noclean", no_argument, NULL, 'n'}, /* for backwards compatibility */
3182 {"no-clean", no_argument, NULL, 'n'},
3183 {"nosync", no_argument, NULL, 'N'}, /* for backwards compatibility */
3184 {"no-sync", no_argument, NULL, 'N'},
3185 {"no-instructions", no_argument, NULL, 13},
3186 {"set", required_argument, NULL, 'c'},
3187 {"sync-only", no_argument, NULL, 'S'},
3188 {"waldir", required_argument, NULL, 'X'},
3189 {"wal-segsize", required_argument, NULL, 12},
3190 {"data-checksums", no_argument, NULL, 'k'},
3191 {"allow-group-access", no_argument, NULL, 'g'},
3192 {"discard-caches", no_argument, NULL, 14},
3193 {"locale-provider", required_argument, NULL, 15},
3194 {"builtin-locale", required_argument, NULL, 16},
3195 {"icu-locale", required_argument, NULL, 17},
3196 {"icu-rules", required_argument, NULL, 18},
3197 {"sync-method", required_argument, NULL, 19},
3198 {"no-data-checksums", no_argument, NULL, 20},
3199 {"no-sync-data-files", no_argument, NULL, 21},
3200 {NULL, 0, NULL, 0}
3201 };
3202
3203 /*
3204 * options with no short version return a low integer, the rest return
3205 * their short version value
3206 */
3207 int c;
3208 int option_index;
3209 char *effective_user;
3210 PQExpBuffer start_db_cmd;
3211 char pg_ctl_path[MAXPGPATH];
3212
3213 /*
3214 * Ensure that buffering behavior of stdout matches what it is in
3215 * interactive usage (at least on most platforms). This prevents
3216 * unexpected output ordering when, eg, output is redirected to a file.
3217 * POSIX says we must do this before any other usage of these files.
3218 */
3219 setvbuf(stdout, NULL, PG_IOLBF, 0);
3220
3221 pg_logging_init(argv[0]);
3222 progname = get_progname(argv[0]);
3223 set_pglocale_pgservice(argv[0], PG_TEXTDOMAIN("initdb"));
3224
3225 if (argc > 1)
3226 {
3227 if (strcmp(argv[1], "--help") == 0 || strcmp(argv[1], "-?") == 0)
3228 {
3229 usage(progname);
3230 exit(0);
3231 }
3232 if (strcmp(argv[1], "--version") == 0 || strcmp(argv[1], "-V") == 0)
3233 {
3234 puts("initdb (PostgreSQL) " PG_VERSION);
3235 exit(0);
3236 }
3237 }
3238
3239 /* process command-line options */
3240
3241 while ((c = getopt_long(argc, argv, "A:c:dD:E:gkL:nNsST:U:WX:",
3242 long_options, &option_index)) != -1)
3243 {
3244 switch (c)
3245 {
3246 case 'A':
3247 authmethodlocal = authmethodhost = pg_strdup(optarg);
3248
3249 /*
3250 * When ident is specified, use peer for local connections.
3251 * Mirrored, when peer is specified, use ident for TCP/IP
3252 * connections.
3253 */
3254 if (strcmp(authmethodhost, "ident") == 0)
3255 authmethodlocal = "peer";
3256 else if (strcmp(authmethodlocal, "peer") == 0)
3257 authmethodhost = "ident";
3258 break;
3259 case 10:
3260 authmethodlocal = pg_strdup(optarg);
3261 break;
3262 case 11:
3263 authmethodhost = pg_strdup(optarg);
3264 break;
3265 case 'c':
3266 {
3267 char *buf = pg_strdup(optarg);
3268 char *equals = strchr(buf, '=');
3269
3270 if (!equals)
3271 {
3272 pg_log_error("-c %s requires a value", buf);
3273 pg_log_error_hint("Try \"%s --help\" for more information.",
3274 progname);
3275 exit(1);
3276 }
3277 *equals++ = '\0'; /* terminate variable name */
3278 add_stringlist_item(&extra_guc_names, buf);
3279 add_stringlist_item(&extra_guc_values, equals);
3280 pfree(buf);
3281 }
3282 break;
3283 case 'D':
3284 pg_data = pg_strdup(optarg);
3285 break;
3286 case 'E':
3287 encoding = pg_strdup(optarg);
3288 break;
3289 case 'W':
3290 pwprompt = true;
3291 break;
3292 case 'U':
3293 username = pg_strdup(optarg);
3294 break;
3295 case 'd':
3296 debug = true;
3297 printf(_("Running in debug mode.\n"));
3298 break;
3299 case 'n':
3300 noclean = true;
3301 printf(_("Running in no-clean mode. Mistakes will not be cleaned up.\n"));
3302 break;
3303 case 'N':
3304 do_sync = false;
3305 break;
3306 case 'S':
3307 sync_only = true;
3308 break;
3309 case 'k':
3310 data_checksums = true;
3311 break;
3312 case 'L':
3313 share_path = pg_strdup(optarg);
3314 break;
3315 case 1:
3316 locale = pg_strdup(optarg);
3317 break;
3318 case 2:
3319 lc_collate = pg_strdup(optarg);
3320 break;
3321 case 3:
3322 lc_ctype = pg_strdup(optarg);
3323 break;
3324 case 4:
3325 lc_monetary = pg_strdup(optarg);
3326 break;
3327 case 5:
3328 lc_numeric = pg_strdup(optarg);
3329 break;
3330 case 6:
3331 lc_time = pg_strdup(optarg);
3332 break;
3333 case 7:
3334 lc_messages = pg_strdup(optarg);
3335 break;
3336 case 8:
3337 locale = "C";
3338 break;
3339 case 9:
3340 pwfilename = pg_strdup(optarg);
3341 break;
3342 case 's':
3343 show_setting = true;
3344 break;
3345 case 'T':
3346 default_text_search_config = pg_strdup(optarg);
3347 break;
3348 case 'X':
3349 xlog_dir = pg_strdup(optarg);
3350 break;
3351 case 12:
3352 if (!option_parse_int(optarg, "--wal-segsize", 1, 1024, &wal_segment_size_mb))
3353 exit(1);
3354 break;
3355 case 13:
3356 noinstructions = true;
3357 break;
3358 case 'g':
3359 SetDataDirectoryCreatePerm(PG_DIR_MODE_GROUP);
3360 break;
3361 case 14:
3362 extra_options = psprintf("%s %s",
3363 extra_options,
3364 "-c debug_discard_caches=1");
3365 break;
3366 case 15:
3367 if (strcmp(optarg, "builtin") == 0)
3368 locale_provider = COLLPROVIDER_BUILTIN;
3369 else if (strcmp(optarg, "icu") == 0)
3370 locale_provider = COLLPROVIDER_ICU;
3371 else if (strcmp(optarg, "libc") == 0)
3372 locale_provider = COLLPROVIDER_LIBC;
3373 else
3374 pg_fatal("unrecognized locale provider: %s", optarg);
3375 break;
3376 case 16:
3377 datlocale = pg_strdup(optarg);
3378 builtin_locale_specified = true;
3379 break;
3380 case 17:
3381 datlocale = pg_strdup(optarg);
3382 icu_locale_specified = true;
3383 break;
3384 case 18:
3385 icu_rules = pg_strdup(optarg);
3386 break;
3387 case 19:
3388 if (!parse_sync_method(optarg, &sync_method))
3389 exit(1);
3390 break;
3391 case 20:
3392 data_checksums = false;
3393 break;
3394 case 21:
3395 sync_data_files = false;
3396 break;
3397 default:
3398 /* getopt_long already emitted a complaint */
3399 pg_log_error_hint("Try \"%s --help\" for more information.", progname);
3400 exit(1);
3401 }
3402 }
3403
3404
3405 /*
3406 * Non-option argument specifies data directory as long as it wasn't
3407 * already specified with -D / --pgdata
3408 */
3409 if (optind < argc && !pg_data)
3410 {
3411 pg_data = pg_strdup(argv[optind]);
3412 optind++;
3413 }
3414
3415 if (optind < argc)
3416 {
3417 pg_log_error("too many command-line arguments (first is \"%s\")",
3418 argv[optind]);
3419 pg_log_error_hint("Try \"%s --help\" for more information.", progname);
3420 exit(1);
3421 }
3422
3423 if (builtin_locale_specified && locale_provider != COLLPROVIDER_BUILTIN)
3424 pg_fatal("%s cannot be specified unless locale provider \"%s\" is chosen",
3425 "--builtin-locale", "builtin");
3426
3427 if (icu_locale_specified && locale_provider != COLLPROVIDER_ICU)
3428 pg_fatal("%s cannot be specified unless locale provider \"%s\" is chosen",
3429 "--icu-locale", "icu");
3430
3431 if (icu_rules && locale_provider != COLLPROVIDER_ICU)
3432 pg_fatal("%s cannot be specified unless locale provider \"%s\" is chosen",
3433 "--icu-rules", "icu");
3434
3435 atexit(cleanup_directories_atexit);
3436
3437 /* If we only need to sync, just do it and exit */
3438 if (sync_only)
3439 {
3440 setup_pgdata();
3441
3442 /* must check that directory is readable */
3443 if (pg_check_dir(pg_data) <= 0)
3444 pg_fatal("could not access directory \"%s\": %m", pg_data);
3445
3446 fputs(_("syncing data to disk ... "), stdout);
3447 fflush(stdout);
3448 sync_pgdata(pg_data, PG_VERSION_NUM, sync_method, sync_data_files);
3449 check_ok();
3450 return 0;
3451 }
3452
3453 if (pwprompt && pwfilename)
3454 pg_fatal("password prompt and password file cannot be specified together");
3455
3456 check_authmethod_unspecified(&authmethodlocal);
3457 check_authmethod_unspecified(&authmethodhost);
3458
3459 check_authmethod_valid(authmethodlocal, auth_methods_local, "local");
3460 check_authmethod_valid(authmethodhost, auth_methods_host, "host");
3461
3462 check_need_password(authmethodlocal, authmethodhost);
3463
3464 if (!IsValidWalSegSize(wal_segment_size_mb * 1024 * 1024))
3465 pg_fatal("argument of %s must be a power of two between 1 and 1024", "--wal-segsize");
3466
3467 get_restricted_token();
3468
3469 setup_pgdata();
3470
3471 setup_bin_paths(argv[0]);
3472
3473 effective_user = get_id();
3474 if (!username)
3475 username = effective_user;
3476
3477 if (strncmp(username, "pg_", 3) == 0)
3478 pg_fatal("superuser name \"%s\" is disallowed; role names cannot begin with \"pg_\"", username);
3479
3480 printf(_("The files belonging to this database system will be owned "
3481 "by user \"%s\".\n"
3482 "This user must also own the server process.\n\n"),
3483 effective_user);
3484
3485 set_info_version();
3486
3487 setup_data_file_paths();
3488
3489 setup_locale_encoding();
3490
3491 setup_text_search();
3492
3493 printf("\n");
3494
3495 if (data_checksums)
3496 printf(_("Data page checksums are enabled.\n"));
3497 else
3498 printf(_("Data page checksums are disabled.\n"));
3499
3500 if (pwprompt || pwfilename)
3501 get_su_pwd();
3502
3503 printf("\n");
3504
3505 initialize_data_directory();
3506
3507 if (do_sync)
3508 {
3509 fputs(_("syncing data to disk ... "), stdout);
3510 fflush(stdout);
3511 sync_pgdata(pg_data, PG_VERSION_NUM, sync_method, sync_data_files);
3512 check_ok();
3513 }
3514 else
3515 printf(_("\nSync to disk skipped.\nThe data directory might become corrupt if the operating system crashes.\n"));
3516
3517 if (authwarning)
3518 {
3519 printf("\n");
3520 pg_log_warning("enabling \"trust\" authentication for local connections");
3521 pg_log_warning_hint("You can change this by editing pg_hba.conf or using the option -A, or "
3522 "--auth-local and --auth-host, the next time you run initdb.");
3523 }
3524
3525 if (!noinstructions)
3526 {
3527 /*
3528 * Build up a shell command to tell the user how to start the server
3529 */
3530 start_db_cmd = createPQExpBuffer();
3531
3532 /* Get directory specification used to start initdb ... */
3533 strlcpy(pg_ctl_path, argv[0], sizeof(pg_ctl_path));
3534 canonicalize_path(pg_ctl_path);
3535 get_parent_directory(pg_ctl_path);
3536 /* ... and tag on pg_ctl instead */
3537 join_path_components(pg_ctl_path, pg_ctl_path, "pg_ctl");
3538
3539 /* Convert the path to use native separators */
3540 make_native_path(pg_ctl_path);
3541
3542 /* path to pg_ctl, properly quoted */
3543 appendShellString(start_db_cmd, pg_ctl_path);
3544
3545 /* add -D switch, with properly quoted data directory */
3546 appendPQExpBufferStr(start_db_cmd, " -D ");
3547 appendShellString(start_db_cmd, pgdata_native);
3548
3549 /* add suggested -l switch and "start" command */
3550 /* translator: This is a placeholder in a shell command. */
3551 appendPQExpBuffer(start_db_cmd, " -l %s start", _("logfile"));
3552
3553 printf(_("\nSuccess. You can now start the database server using:\n\n"
3554 " %s\n\n"),
3555 start_db_cmd->data);
3556
3557 destroyPQExpBuffer(start_db_cmd);
3558 }
3559
3560
3561 success = true;
3562 return 0;
3563}
Max
#define Max(x, y)
Definition c.h:1001
SIGNAL_ARGS
#define SIGNAL_ARGS
Definition c.h:1357
PG_TEXTDOMAIN
#define PG_TEXTDOMAIN(domain)
Definition c.h:1203
CppAsString2
#define CppAsString2(x)
Definition c.h:438
uint64
uint64_t uint64
Definition c.h:557
uint32
uint32_t uint32
Definition c.h:556
lengthof
#define lengthof(array)
Definition c.h:813
PG_BINARY_W
#define PG_BINARY_W
Definition c.h:1284
Pointer
void * Pointer
Definition c.h:547
find_my_exec
int find_my_exec(const char *argv0, char *retpath)
Definition exec.c:161
set_pglocale_pgservice
void set_pglocale_pgservice(const char *argv0, const char *app)
Definition exec.c:430
find_other_exec
int find_other_exec(const char *argv0, const char *target, const char *versionstr, char *retpath)
Definition exec.c:311
main
int main(void)
Definition compat_informix-charfuncs.c:16
fprintf
#define fprintf(file, fmt, msg)
Definition cubescan.l:21
_
#define _(x)
Definition elog.c:91
is_encoding_supported_by_icu
bool is_encoding_supported_by_icu(int encoding)
Definition encnames.c:461
err
void err(int eval, const char *fmt,...)
Definition err.c:43
pg_malloc
void * pg_malloc(size_t size)
Definition fe_memutils.c:47
pg_strdup
char * pg_strdup(const char *in)
Definition fe_memutils.c:85
pg_free
void pg_free(void *ptr)
Definition fe_memutils.c:105
pg_realloc
void * pg_realloc(void *ptr, size_t size)
Definition fe_memutils.c:65
pg_realloc_array
#define pg_realloc_array(pointer, type, count)
Definition fe_memutils.h:63
pg_malloc_array
#define pg_malloc_array(type, count)
Definition fe_memutils.h:56
pg_file_create_mode
int pg_file_create_mode
Definition file_perm.c:19
SetDataDirectoryCreatePerm
void SetDataDirectoryCreatePerm(int dataDirMode)
Definition file_perm.c:34
pg_mode_mask
int pg_mode_mask
Definition file_perm.c:25
pg_dir_create_mode
int pg_dir_create_mode
Definition file_perm.c:18
file_perm.h
PG_DIR_MODE_GROUP
#define PG_DIR_MODE_GROUP
Definition file_perm.h:35
file_utils.h
DataDirSyncMethod
DataDirSyncMethod
Definition file_utils.h:28
DATA_DIR_SYNC_METHOD_FSYNC
@ DATA_DIR_SYNC_METHOD_FSYNC
Definition file_utils.h:29
getopt_long.h
getopt_long
int getopt_long(int argc, char *const argv[], const char *optstring, const struct option *longopts, int *longindex)
Definition getopt_long.c:60
no_argument
#define no_argument
Definition getopt_long.h:25
required_argument
#define required_argument
Definition getopt_long.h:26
str
const char * str
Definition hashfn_unstable.h:261
newline
#define newline
Definition indent_codes.h:35
escape_quotes_bki
static char * escape_quotes_bki(const char *src)
Definition initdb.c:422
default_timezone
static const char * default_timezone
Definition initdb.c:203
superuser_password
static char * superuser_password
Definition initdb.c:156
encodingid_to_string
static char * encodingid_to_string(int enc)
Definition initdb.c:834
PG_CMD_CLOSE
#define PG_CMD_CLOSE()
Definition initdb.c:328
datlocale
static char * datlocale
Definition initdb.c:149
lc_collate
static char * lc_collate
Definition initdb.c:141
lc_time
static char * lc_time
Definition initdb.c:145
get_id
static char * get_id(void)
Definition initdb.c:815
warn_on_mount_point
void warn_on_mount_point(int error)
Definition initdb.c:3030
noclean
static bool noclean
Definition initdb.c:162
setup_depend
static void setup_depend(FILE *cmdfd)
Definition initdb.c:1715
found_existing_pgdata
static bool found_existing_pgdata
Definition initdb.c:189
found_existing_xlogdir
static bool found_existing_xlogdir
Definition initdb.c:191
hba_file
static char * hba_file
Definition initdb.c:178
pgdata_native
static char * pgdata_native
Definition initdb.c:196
PG_CMD_PUTS
#define PG_CMD_PUTS(line)
Definition initdb.c:334
check_authmethod_valid
static void check_authmethod_valid(const char *authmethod, const char *const *valid_methods, const char *conntype)
Definition initdb.c:2581
sync_data_files
static bool sync_data_files
Definition initdb.c:171
lc_ctype
static char * lc_ctype
Definition initdb.c:142
DIGITS
#define DIGITS
readfile
static char ** readfile(const char *path)
Definition initdb.c:676
n_connections
static int n_connections
Definition initdb.c:199
icu_locale_specified
static bool icu_locale_specified
Definition initdb.c:150
noinstructions
static bool noinstructions
Definition initdb.c:163
initialize_data_directory
void initialize_data_directory(void)
Definition initdb.c:3043
setup_collation
static void setup_collation(FILE *cmdfd)
Definition initdb.c:1770
xlog_dir
static char * xlog_dir
Definition initdb.c:168
debug
static bool debug
Definition initdb.c:161
check_icu_locale_encoding
static bool check_icu_locale_encoding(int user_enc)
Definition initdb.c:2299
backend_exec
static char backend_exec[MAXPGPATH]
Definition initdb.c:260
restore_global_locale
static void restore_global_locale(int category, save_locale_t save)
Definition initdb.c:389
data_checksums
static bool data_checksums
Definition initdb.c:167
PG_CMD_DECL
#define PG_CMD_DECL
Definition initdb.c:319
setup_text_search
void setup_text_search(void)
Definition initdb.c:2835
n_buffers
static int n_buffers
Definition initdb.c:201
get_encoding_id
static int get_encoding_id(const char *encoding_name)
Definition initdb.c:846
ident_file
static char * ident_file
Definition initdb.c:179
infoversion
static char infoversion[100]
Definition initdb.c:192
popen_check
static FILE * popen_check(const char *command, const char *mode)
Definition initdb.c:745
icu_language_tag
static char * icu_language_tag(const char *loc_str)
Definition initdb.c:2319
authmethodhost
static const char * authmethodhost
Definition initdb.c:157
create_data_directory
void create_data_directory(void)
Definition initdb.c:2889
guc_value_requires_quotes
static bool guc_value_requires_quotes(const char *guc_value)
Definition initdb.c:644
features_file
static char * features_file
Definition initdb.c:183
_stringlist
struct _stringlist _stringlist
share_path
static char * share_path
Definition initdb.c:135
setup_bin_paths
void setup_bin_paths(const char *argv0)
Definition initdb.c:2647
check_locale_encoding
static bool check_locale_encoding(const char *locale, int user_enc)
Definition initdb.c:2264
check_authmethod_unspecified
static void check_authmethod_unspecified(const char **authmethod)
Definition initdb.c:2571
locale_provider
static char locale_provider
Definition initdb.c:147
auth_methods_host
static const char *const auth_methods_host[]
Definition initdb.c:96
wal_segment_size_mb
static int wal_segment_size_mb
Definition initdb.c:169
bootstrap_template1
static void bootstrap_template1(void)
Definition initdb.c:1547
success
static bool success
Definition initdb.c:187
setup_locale_encoding
void setup_locale_encoding(void)
Definition initdb.c:2684
setup_run_file
static void setup_run_file(FILE *cmdfd, const char *filename)
Definition initdb.c:1728
auth_methods_local
static const char *const auth_methods_local[]
Definition initdb.c:118
replace_token
static char ** replace_token(char **lines, const char *token, const char *replacement)
Definition initdb.c:473
test_specific_config_settings
static bool test_specific_config_settings(int test_conns, int test_av_slots, int test_buffs)
Definition initdb.c:1223
my_strftime
static size_t my_strftime(char *s, size_t max, const char *fmt, const struct tm *tm)
Definition initdb.c:2133
setlocales
static void setlocales(void)
Definition initdb.c:2423
icu_rules
static char * icu_rules
Definition initdb.c:151
sync_only
static bool sync_only
Definition initdb.c:165
save_global_locale
static save_locale_t save_global_locale(int category)
Definition initdb.c:365
made_new_xlogdir
static bool made_new_xlogdir
Definition initdb.c:190
setup_auth
static void setup_auth(FILE *cmdfd)
Definition initdb.c:1639
pg_data
static char * pg_data
Definition initdb.c:138
check_need_password
static void check_need_password(const char *authmethodlocal, const char *authmethodhost)
Definition initdb.c:2596
locale_date_order
static int locale_date_order(const char *locale)
Definition initdb.c:2142
make_postgres
static void make_postgres(FILE *cmdfd)
Definition initdb.c:2064
username
static char * username
Definition initdb.c:153
do_sync
static bool do_sync
Definition initdb.c:164
test_config_settings
static void test_config_settings(void)
Definition initdb.c:1120
cleanup_directories_atexit
static void cleanup_directories_atexit(void)
Definition initdb.c:762
backend_options
static const char *const backend_options
Definition initdb.c:226
n_av_slots
static int n_av_slots
Definition initdb.c:200
setup_config
static void setup_config(void)
Definition initdb.c:1285
locale
static char * locale
Definition initdb.c:140
lc_messages
static char * lc_messages
Definition initdb.c:146
setup_privileges
static void setup_privileges(FILE *cmdfd)
Definition initdb.c:1803
write_version_file
static void write_version_file(const char *extrapath)
Definition initdb.c:1026
setup_signals
void setup_signals(void)
Definition initdb.c:2869
find_matching_ts_config
static const char * find_matching_ts_config(const char *lc_type)
Definition initdb.c:940
trapsig
static void trapsig(SIGNAL_ARGS)
Definition initdb.c:2097
save_locale_t
char * save_locale_t
Definition initdb.c:349
output_failed
static bool output_failed
Definition initdb.c:194
LETTERS
#define LETTERS
output_errno
static int output_errno
Definition initdb.c:195
system_views_file
static char * system_views_file
Definition initdb.c:186
setup_description
static void setup_description(FILE *cmdfd)
Definition initdb.c:1749
escape_quotes
static char * escape_quotes(const char *src)
Definition initdb.c:406
PG_CMD_PRINTF
#define PG_CMD_PRINTF(fmt,...)
Definition initdb.c:340
authwarning
static bool authwarning
Definition initdb.c:213
builtin_locale_specified
static bool builtin_locale_specified
Definition initdb.c:148
pretty_wal_size
static char * pretty_wal_size(int segment_count)
Definition initdb.c:1268
vacuum_db
static void vacuum_db(FILE *cmdfd)
Definition initdb.c:2000
subdirs
static const char *const subdirs[]
Definition initdb.c:231
set_info_version
static void set_info_version(void)
Definition initdb.c:1944
tsearch_config_languages
static const struct tsearch_config_match tsearch_config_languages[]
Definition initdb.c:869
setup_data_file_paths
void setup_data_file_paths(void)
Definition initdb.c:2791
set_input
static void set_input(char **dest, const char *filename)
Definition initdb.c:986
made_new_pgdata
static bool made_new_pgdata
Definition initdb.c:188
encoding
static char * encoding
Definition initdb.c:139
pwfilename
static char * pwfilename
Definition initdb.c:155
replace_guc_value
static char ** replace_guc_value(char **lines, const char *guc_name, const char *guc_value, bool mark_as_comment)
Definition initdb.c:528
MIN_BUFS_FOR_CONNS
#define MIN_BUFS_FOR_CONNS(nconns)
sync_method
static DataDirSyncMethod sync_method
Definition initdb.c:170
bin_path
static char bin_path[MAXPGPATH]
Definition initdb.c:259
encodingid
static int encodingid
Definition initdb.c:176
create_xlog_or_symlink
void create_xlog_or_symlink(void)
Definition initdb.c:2947
system_functions_file
static char * system_functions_file
Definition initdb.c:185
extra_guc_names
static _stringlist * extra_guc_names
Definition initdb.c:159
AV_SLOTS_FOR_CONNS
#define AV_SLOTS_FOR_CONNS(nconns)
dynamic_shared_memory_type
static const char * dynamic_shared_memory_type
Definition initdb.c:202
check_input
static void check_input(char *path)
Definition initdb.c:995
add_stringlist_item
static void add_stringlist_item(_stringlist **listhead, const char *str)
Definition initdb.c:445
caught_signal
static bool caught_signal
Definition initdb.c:193
progname
static const char * progname
Definition initdb.c:175
extra_guc_values
static _stringlist * extra_guc_values
Definition initdb.c:160
AUTHTRUST_WARNING
#define AUTHTRUST_WARNING
Definition initdb.c:208
choose_dsm_implementation
static const char * choose_dsm_implementation(void)
Definition initdb.c:1078
dictionary_file
static char * dictionary_file
Definition initdb.c:181
pwprompt
static bool pwprompt
Definition initdb.c:154
writefile
static void writefile(char *path, char **lines)
Definition initdb.c:723
lc_numeric
static char * lc_numeric
Definition initdb.c:144
setup_schema
static void setup_schema(FILE *cmdfd)
Definition initdb.c:1971
select_default_timezone
const char * select_default_timezone(const char *share_path)
Definition findtimezone.c:1757
conf_file
static char * conf_file
Definition initdb.c:180
setup_pgdata
void setup_pgdata(void)
Definition initdb.c:2610
check_ok
static void check_ok(void)
Definition initdb.c:2108
show_setting
static bool show_setting
Definition initdb.c:166
system_constraints_file
static char * system_constraints_file
Definition initdb.c:184
set_null_conf
static void set_null_conf(void)
Definition initdb.c:1049
extra_options
static char * extra_options
Definition initdb.c:229
authmethodlocal
static const char * authmethodlocal
Definition initdb.c:158
boot_options
static const char *const boot_options
Definition initdb.c:225
make_template0
static void make_template0(FILE *cmdfd)
Definition initdb.c:2010
info_schema_file
static char * info_schema_file
Definition initdb.c:182
load_plpgsql
static void load_plpgsql(FILE *cmdfd)
Definition initdb.c:1991
default_text_search_config
static const char * default_text_search_config
Definition initdb.c:152
PG_CMD_OPEN
#define PG_CMD_OPEN(cmd)
Definition initdb.c:321
check_locale_name
static void check_locale_name(int category, const char *locale, char **canonname)
Definition initdb.c:2201
lc_monetary
static char * lc_monetary
Definition initdb.c:143
icu_validate_locale
static void icu_validate_locale(const char *loc_str)
Definition initdb.c:2372
get_su_pwd
static void get_su_pwd(void)
Definition initdb.c:1656
bki_file
static char * bki_file
Definition initdb.c:177
close
#define close(a)
Definition win32.h:12
i
int i
Definition isn.c:77
tm
static struct pg_tm tm
Definition localtime.c:104
pg_logging_init
void pg_logging_init(const char *argv0)
Definition logging.c:83
pg_log_error
#define pg_log_error(...)
Definition logging.h:106
pg_log_error_hint
#define pg_log_error_hint(...)
Definition logging.h:112
pg_log_info
#define pg_log_info(...)
Definition logging.h:124
pg_log_warning_hint
#define pg_log_warning_hint(...)
Definition logging.h:121
pg_log_error_detail
#define pg_log_error_detail(...)
Definition logging.h:109
PG_UTF8
#define PG_UTF8
Definition mbprint.c:43
pfree
void pfree(void *pointer)
Definition mcxt.c:1616
DATEORDER_DMY
#define DATEORDER_DMY
Definition miscadmin.h:244
DATEORDER_MDY
#define DATEORDER_MDY
Definition miscadmin.h:245
DATEORDER_YMD
#define DATEORDER_YMD
Definition miscadmin.h:243
option_parse_int
bool option_parse_int(const char *optarg, const char *optname, int min_range, int max_range, int *result)
Definition option_utils.c:50
parse_sync_method
bool parse_sync_method(const char *optarg, DataDirSyncMethod *sync_method)
Definition option_utils.c:90
option_utils.h
usage
static void usage(void)
Definition pg_archivecleanup.c:258
pg_fatal
#define pg_fatal(...)
Definition pg_backup_utils.h:36
mode
static PgChecksumMode mode
Definition pg_checksums.c:56
NAMEDATALEN
#define NAMEDATALEN
Definition pg_config_manual.h:39
MAXPGPATH
#define MAXPGPATH
Definition pg_config_manual.h:105
DEFAULT_PGSOCKET_DIR
#define DEFAULT_PGSOCKET_DIR
Definition pg_config_manual.h:198
DEFAULT_XLOG_SEG_SIZE
#define DEFAULT_XLOG_SEG_SIZE
Definition pg_config_manual.h:20
DEFAULT_BACKEND_FLUSH_AFTER
#define DEFAULT_BACKEND_FLUSH_AFTER
Definition pg_config_manual.h:165
DEFAULT_CHECKPOINT_FLUSH_AFTER
#define DEFAULT_CHECKPOINT_FLUSH_AFTER
Definition pg_config_manual.h:167
DEFAULT_BGWRITER_FLUSH_AFTER
#define DEFAULT_BGWRITER_FLUSH_AFTER
Definition pg_config_manual.h:166
data
const void * data
Definition pg_crc32c_sse42.c:27
pg_ctl_path
static char * pg_ctl_path
Definition pg_createsubscriber.c:167
version_file
static char version_file[MAXPGPATH]
Definition pg_ctl.c:99
argv0
static char * argv0
Definition pg_ctl.c:94
filename
static char * filename
Definition pg_dumpall.c:120
pg_get_line
char * pg_get_line(FILE *stream, PromptInterruptContext *prompt_ctx)
Definition pg_get_line.c:59
pg_get_line_buf
bool pg_get_line_buf(FILE *stream, StringInfo buf)
Definition pg_get_line.c:95
optind
PGDLLIMPORT int optind
Definition getopt.c:51
optarg
PGDLLIMPORT char * optarg
Definition getopt.c:53
pg_prng_uint32
uint32 pg_prng_uint32(pg_prng_state *state)
Definition pg_prng.c:227
pg_prng_seed
void pg_prng_seed(pg_prng_state *state, uint64 seed)
Definition pg_prng.c:89
pg_prng.h
buf
static char buf[DEFAULT_XLOG_SEG_SIZE]
Definition pg_test_fsync.c:71
pg_wchar.h
PG_SQL_ASCII
@ PG_SQL_ASCII
Definition pg_wchar.h:226
pg_encoding_to_char
#define pg_encoding_to_char
Definition pg_wchar.h:630
pg_valid_server_encoding_id
#define pg_valid_server_encoding_id
Definition pg_wchar.h:632
pg_valid_server_encoding
#define pg_valid_server_encoding
Definition pg_wchar.h:631
pg_log_warning
#define pg_log_warning(...)
Definition pgfnames.c:24
pqsignal
#define pqsignal
Definition port.h:547
get_share_path
void get_share_path(const char *my_exec_path, char *ret_path)
Definition path.c:902
join_path_components
void join_path_components(char *ret_path, const char *head, const char *tail)
Definition path.c:286
pg_mkdir_p
int pg_mkdir_p(char *path, int omode)
Definition pgmkdirp.c:57
is_absolute_path
#define is_absolute_path(filename)
Definition port.h:104
PG_IOLBF
#define PG_IOLBF
Definition port.h:409
last_dir_separator
char * last_dir_separator(const char *filename)
Definition path.c:145
pg_strcasecmp
int pg_strcasecmp(const char *s1, const char *s2)
Definition pgstrcasecmp.c:32
escape_single_quotes_ascii
char * escape_single_quotes_ascii(const char *src)
Definition quotes.c:33
sprintf
#define sprintf
Definition port.h:262
canonicalize_path
void canonicalize_path(char *path)
Definition path.c:337
get_parent_directory
void get_parent_directory(char *path)
Definition path.c:1068
pg_check_dir
int pg_check_dir(const char *dir)
Definition pgcheckdir.c:33
strerror
#define strerror
Definition port.h:273
make_native_path
void make_native_path(char *filename)
Definition path.c:236
snprintf
#define snprintf
Definition port.h:260
DEVNULL
#define DEVNULL
Definition port.h:161
PG_BACKEND_VERSIONSTR
#define PG_BACKEND_VERSIONSTR
Definition port.h:144
get_progname
const char * get_progname(const char *argv0)
Definition path.c:652
pg_get_encoding_from_locale
int pg_get_encoding_from_locale(const char *ctype, bool write_message)
Definition chklocale.c:301
printf
#define printf(...)
Definition port.h:266
strlcpy
size_t strlcpy(char *dst, const char *src, size_t siz)
Definition strlcpy.c:45
pg_strncasecmp
int pg_strncasecmp(const char *s1, const char *s2, size_t n)
Definition pgstrcasecmp.c:65
postgres_fe.h
printfPQExpBuffer
void printfPQExpBuffer(PQExpBuffer str, const char *fmt,...)
Definition pqexpbuffer.c:235
createPQExpBuffer
PQExpBuffer createPQExpBuffer(void)
Definition pqexpbuffer.c:72
initPQExpBuffer
void initPQExpBuffer(PQExpBuffer str)
Definition pqexpbuffer.c:90
appendPQExpBuffer
void appendPQExpBuffer(PQExpBuffer str, const char *fmt,...)
Definition pqexpbuffer.c:265
destroyPQExpBuffer
void destroyPQExpBuffer(PQExpBuffer str)
Definition pqexpbuffer.c:114
appendPQExpBufferChar
void appendPQExpBufferChar(PQExpBuffer str, char ch)
Definition pqexpbuffer.c:378
appendPQExpBufferStr
void appendPQExpBufferStr(PQExpBuffer str, const char *data)
Definition pqexpbuffer.c:367
termPQExpBuffer
void termPQExpBuffer(PQExpBuffer str)
Definition pqexpbuffer.c:129
c
char * c
Definition preproc-cursor.c:31
fd
static int fd(const char *x, int i)
Definition preproc-init.c:105
fb
static int fb(int x)
Definition preproc-init.c:92
prng_state
static pg_prng_state prng_state
Definition pseudorandomfuncs.c:26
psprintf
char * psprintf(const char *fmt,...)
Definition psprintf.c:43
get_restricted_token
void get_restricted_token(void)
Definition restricted_token.c:129
restricted_token.h
rmtree
bool rmtree(const char *path, bool rmtopdir)
Definition rmtree.c:50
free
#define free(a)
Definition snowball_runtime.h:65
simple_prompt
char * simple_prompt(const char *prompt, bool echo)
Definition sprompt.c:38
error
static void error(void)
Definition sql-dyntest.c:147
pg_strip_crlf
int pg_strip_crlf(char *str)
Definition string.c:154
pg_is_ascii
bool pg_is_ascii(const char *str)
Definition string.c:132
appendShellString
void appendShellString(PQExpBuffer buf, const char *str)
Definition string_utils.c:582
string_utils.h
initStringInfo
void initStringInfo(StringInfo str)
Definition stringinfo.c:97
_stringlist
Definition initdb.c:91
_stringlist::str
char * str
Definition initdb.c:92
_stringlist::next
struct _stringlist * next
Definition initdb.c:93
pg_prng_state
Definition pg_prng.h:20
tsearch_config_match
Definition initdb.c:864
tsearch_config_match::tsconfname
const char * tsconfname
Definition initdb.c:865
tsearch_config_match::langname
const char * langname
Definition initdb.c:866
get_user_name_or_exit
const char * get_user_name_or_exit(const char *progname)
Definition username.c:74
name
const char * name
Definition wait_event_funcs.c:28
SIGHUP
#define SIGHUP
Definition win32_port.h:158
stat
#define stat
Definition win32_port.h:74
unsetenv
#define unsetenv(x)
Definition win32_port.h:543
SIGPIPE
#define SIGPIPE
Definition win32_port.h:163
SIGQUIT
#define SIGQUIT
Definition win32_port.h:159
mkdir
#define mkdir(a, b)
Definition win32_port.h:80
setenv
#define setenv(x, y, z)
Definition win32_port.h:542
symlink
#define symlink(oldpath, newpath)
Definition win32_port.h:225
S_ISREG
#define S_ISREG(m)
Definition win32_port.h:318
setlocale
#define setlocale(a, b)
Definition win32_port.h:472
xlog_internal.h
IsValidWalSegSize
#define IsValidWalSegSize(size)
Definition xlog_internal.h:96
DEFAULT_MAX_WAL_SEGS
#define DEFAULT_MAX_WAL_SEGS
Definition xlog_internal.h:92
DEFAULT_MIN_WAL_SEGS
#define DEFAULT_MIN_WAL_SEGS
Definition xlog_internal.h:91
infile
static void infile(const char *name)
Definition zic.c:1257