PostgreSQL Source Code: src/bin/pg_upgrade/controldata.c Source File

PostgreSQL Source Code git master
controldata.c
Go to the documentation of this file.
1/*
2 * controldata.c
3 *
4 * controldata functions
5 *
6 * Copyright (c) 2010-2025, PostgreSQL Global Development Group
7 * src/bin/pg_upgrade/controldata.c
8 */
9
10#include "postgres_fe.h"
11
12#include <ctype.h>
13#include <limits.h> /* for CHAR_MIN */
14
15#include "access/xlog_internal.h"
16#include "common/string.h"
17#include "pg_upgrade.h"
18
19
20/*
21 * get_control_data()
22 *
23 * gets pg_control information in "ctrl". Assumes that bindir and
24 * datadir are valid absolute paths to postgresql bin and pgdata
25 * directories respectively *and* pg_resetwal is version compatible
26 * with datadir. The main purpose of this function is to get pg_control
27 * data in a version independent manner.
28 *
29 * The approach taken here is to invoke pg_resetwal with -n option
30 * and then pipe its output. With little string parsing we get the
31 * pg_control data. pg_resetwal cannot be run while the server is running
32 * so we use pg_controldata; pg_controldata doesn't provide all the fields
33 * we need to actually perform the upgrade, but it provides enough for
34 * check mode. We do not implement pg_resetwal -n because it is hard to
35 * return valid xid data for a running server.
36 */
37void
38 get_control_data(ClusterInfo *cluster)
39{
40 char cmd[MAXPGPATH];
41 char bufin[MAX_STRING];
42 FILE *output;
43 char *p;
44 bool got_tli = false;
45 bool got_log_id = false;
46 bool got_log_seg = false;
47 bool got_xid = false;
48 bool got_oid = false;
49 bool got_multi = false;
50 bool got_oldestmulti = false;
51 bool got_oldestxid = false;
52 bool got_mxoff = false;
53 bool got_nextxlogfile = false;
54 bool got_float8_pass_by_value = false;
55 bool got_align = false;
56 bool got_blocksz = false;
57 bool got_largesz = false;
58 bool got_walsz = false;
59 bool got_walseg = false;
60 bool got_ident = false;
61 bool got_index = false;
62 bool got_toast = false;
63 bool got_large_object = false;
64 bool got_date_is_int = false;
65 bool got_data_checksum_version = false;
66 bool got_cluster_state = false;
67 bool got_default_char_signedness = false;
68 char *lc_collate = NULL;
69 char *lc_ctype = NULL;
70 char *lc_monetary = NULL;
71 char *lc_numeric = NULL;
72 char *lc_time = NULL;
73 char *lang = NULL;
74 char *language = NULL;
75 char *lc_all = NULL;
76 char *lc_messages = NULL;
77 uint32 tli = 0;
78 uint32 logid = 0;
79 uint32 segno = 0;
80 char *resetwal_bin;
81 int rc;
82 bool live_check = (cluster == &old_cluster && user_opts.live_check);
83
84 /*
85 * Because we test the pg_resetwal output as strings, it has to be in
86 * English. Copied from pg_regress.c.
87 */
88 if (getenv("LC_COLLATE"))
89 lc_collate = pg_strdup(getenv("LC_COLLATE"));
90 if (getenv("LC_CTYPE"))
91 lc_ctype = pg_strdup(getenv("LC_CTYPE"));
92 if (getenv("LC_MONETARY"))
93 lc_monetary = pg_strdup(getenv("LC_MONETARY"));
94 if (getenv("LC_NUMERIC"))
95 lc_numeric = pg_strdup(getenv("LC_NUMERIC"));
96 if (getenv("LC_TIME"))
97 lc_time = pg_strdup(getenv("LC_TIME"));
98 if (getenv("LANG"))
99 lang = pg_strdup(getenv("LANG"));
100 if (getenv("LANGUAGE"))
101 language = pg_strdup(getenv("LANGUAGE"));
102 if (getenv("LC_ALL"))
103 lc_all = pg_strdup(getenv("LC_ALL"));
104 if (getenv("LC_MESSAGES"))
105 lc_messages = pg_strdup(getenv("LC_MESSAGES"));
106
107 unsetenv("LC_COLLATE");
108 unsetenv("LC_CTYPE");
109 unsetenv("LC_MONETARY");
110 unsetenv("LC_NUMERIC");
111 unsetenv("LC_TIME");
112#ifndef WIN32
113 unsetenv("LANG");
114#else
115 /* On Windows the default locale may not be English, so force it */
116 setenv("LANG", "en", 1);
117#endif
118 unsetenv("LANGUAGE");
119 unsetenv("LC_ALL");
120 setenv("LC_MESSAGES", "C", 1);
121
122 /*
123 * Check for clean shutdown
124 */
125 if (!live_check || cluster == &new_cluster)
126 {
127 /* only pg_controldata outputs the cluster state */
128 snprintf(cmd, sizeof(cmd), "\"%s/pg_controldata\" \"%s\"",
129 cluster->bindir, cluster->pgdata);
130 fflush(NULL);
131
132 if ((output = popen(cmd, "r")) == NULL)
133 pg_fatal("could not get control data using %s: %m", cmd);
134
135 /* we have the result of cmd in "output". so parse it line by line now */
136 while (fgets(bufin, sizeof(bufin), output))
137 {
138 if ((p = strstr(bufin, "Database cluster state:")) != NULL)
139 {
140 p = strchr(p, ':');
141
142 if (p == NULL || strlen(p) <= 1)
143 pg_fatal("%d: database cluster state problem", __LINE__);
144
145 p++; /* remove ':' char */
146
147 /*
148 * We checked earlier for a postmaster lock file, and if we
149 * found one, we tried to start/stop the server to replay the
150 * WAL. However, pg_ctl -m immediate doesn't leave a lock
151 * file, but does require WAL replay, so we check here that
152 * the server was shut down cleanly, from the controldata
153 * perspective.
154 */
155 /* Remove trailing newline and leading spaces */
156 (void) pg_strip_crlf(p);
157 while (*p == ' ')
158 p++;
159 if (strcmp(p, "shut down in recovery") == 0)
160 {
161 if (cluster == &old_cluster)
162 pg_fatal("The source cluster was shut down while in recovery mode. To upgrade, use \"rsync\" as documented or shut it down as a primary.");
163 else
164 pg_fatal("The target cluster was shut down while in recovery mode. To upgrade, use \"rsync\" as documented or shut it down as a primary.");
165 }
166 else if (strcmp(p, "shut down") != 0)
167 {
168 if (cluster == &old_cluster)
169 pg_fatal("The source cluster was not shut down cleanly, state reported as: \"%s\"", p);
170 else
171 pg_fatal("The target cluster was not shut down cleanly, state reported as: \"%s\"", p);
172 }
173 got_cluster_state = true;
174 }
175 }
176
177 rc = pclose(output);
178 if (rc != 0)
179 pg_fatal("could not get control data using %s: %s",
180 cmd, wait_result_to_str(rc));
181
182 if (!got_cluster_state)
183 {
184 if (cluster == &old_cluster)
185 pg_fatal("The source cluster lacks cluster state information:");
186 else
187 pg_fatal("The target cluster lacks cluster state information:");
188 }
189 }
190
191 /* pg_resetxlog has been renamed to pg_resetwal in version 10 */
192 if (GET_MAJOR_VERSION(cluster->bin_version) <= 906)
193 resetwal_bin = "pg_resetxlog\" -n";
194 else
195 resetwal_bin = "pg_resetwal\" -n";
196 snprintf(cmd, sizeof(cmd), "\"%s/%s \"%s\"",
197 cluster->bindir,
198 live_check ? "pg_controldata\"" : resetwal_bin,
199 cluster->pgdata);
200 fflush(NULL);
201
202 if ((output = popen(cmd, "r")) == NULL)
203 pg_fatal("could not get control data using %s: %m", cmd);
204
205 /* Only in <= 9.2 */
206 if (GET_MAJOR_VERSION(cluster->major_version) <= 902)
207 {
208 cluster->controldata.data_checksum_version = 0;
209 got_data_checksum_version = true;
210 }
211
212 /* we have the result of cmd in "output". so parse it line by line now */
213 while (fgets(bufin, sizeof(bufin), output))
214 {
215 /* In verbose mode, log each line */
216 pg_strip_crlf(bufin);
217 pg_log(PG_VERBOSE, "%s", bufin);
218
219 if ((p = strstr(bufin, "pg_control version number:")) != NULL)
220 {
221 p = strchr(p, ':');
222
223 if (p == NULL || strlen(p) <= 1)
224 pg_fatal("%d: pg_resetwal problem", __LINE__);
225
226 p++; /* remove ':' char */
227 cluster->controldata.ctrl_ver = str2uint(p);
228 }
229 else if ((p = strstr(bufin, "Catalog version number:")) != NULL)
230 {
231 p = strchr(p, ':');
232
233 if (p == NULL || strlen(p) <= 1)
234 pg_fatal("%d: controldata retrieval problem", __LINE__);
235
236 p++; /* remove ':' char */
237 cluster->controldata.cat_ver = str2uint(p);
238 }
239 else if ((p = strstr(bufin, "Latest checkpoint's TimeLineID:")) != NULL)
240 {
241 p = strchr(p, ':');
242
243 if (p == NULL || strlen(p) <= 1)
244 pg_fatal("%d: controldata retrieval problem", __LINE__);
245
246 p++; /* remove ':' char */
247 tli = str2uint(p);
248 got_tli = true;
249 }
250 else if ((p = strstr(bufin, "First log file ID after reset:")) != NULL)
251 {
252 p = strchr(p, ':');
253
254 if (p == NULL || strlen(p) <= 1)
255 pg_fatal("%d: controldata retrieval problem", __LINE__);
256
257 p++; /* remove ':' char */
258 logid = str2uint(p);
259 got_log_id = true;
260 }
261 else if ((p = strstr(bufin, "First log file segment after reset:")) != NULL)
262 {
263 p = strchr(p, ':');
264
265 if (p == NULL || strlen(p) <= 1)
266 pg_fatal("%d: controldata retrieval problem", __LINE__);
267
268 p++; /* remove ':' char */
269 segno = str2uint(p);
270 got_log_seg = true;
271 }
272 else if ((p = strstr(bufin, "Latest checkpoint's NextXID:")) != NULL)
273 {
274 p = strchr(p, ':');
275
276 if (p == NULL || strlen(p) <= 1)
277 pg_fatal("%d: controldata retrieval problem", __LINE__);
278
279 p++; /* remove ':' char */
280 cluster->controldata.chkpnt_nxtepoch = str2uint(p);
281
282 /*
283 * Delimiter changed from '/' to ':' in 9.6. We don't test for
284 * the catalog version of the change because the catalog version
285 * is pulled from pg_controldata too, and it isn't worth adding an
286 * order dependency for this --- we just check the string.
287 */
288 if (strchr(p, '/') != NULL)
289 p = strchr(p, '/');
290 else if (GET_MAJOR_VERSION(cluster->major_version) >= 906)
291 p = strchr(p, ':');
292 else
293 p = NULL;
294
295 if (p == NULL || strlen(p) <= 1)
296 pg_fatal("%d: controldata retrieval problem", __LINE__);
297
298 p++; /* remove '/' or ':' char */
299 cluster->controldata.chkpnt_nxtxid = str2uint(p);
300 got_xid = true;
301 }
302 else if ((p = strstr(bufin, "Latest checkpoint's NextOID:")) != NULL)
303 {
304 p = strchr(p, ':');
305
306 if (p == NULL || strlen(p) <= 1)
307 pg_fatal("%d: controldata retrieval problem", __LINE__);
308
309 p++; /* remove ':' char */
310 cluster->controldata.chkpnt_nxtoid = str2uint(p);
311 got_oid = true;
312 }
313 else if ((p = strstr(bufin, "Latest checkpoint's NextMultiXactId:")) != NULL)
314 {
315 p = strchr(p, ':');
316
317 if (p == NULL || strlen(p) <= 1)
318 pg_fatal("%d: controldata retrieval problem", __LINE__);
319
320 p++; /* remove ':' char */
321 cluster->controldata.chkpnt_nxtmulti = str2uint(p);
322 got_multi = true;
323 }
324 else if ((p = strstr(bufin, "Latest checkpoint's oldestXID:")) != NULL)
325 {
326 p = strchr(p, ':');
327
328 if (p == NULL || strlen(p) <= 1)
329 pg_fatal("%d: controldata retrieval problem", __LINE__);
330
331 p++; /* remove ':' char */
332 cluster->controldata.chkpnt_oldstxid = str2uint(p);
333 got_oldestxid = true;
334 }
335 else if ((p = strstr(bufin, "Latest checkpoint's oldestMultiXid:")) != NULL)
336 {
337 p = strchr(p, ':');
338
339 if (p == NULL || strlen(p) <= 1)
340 pg_fatal("%d: controldata retrieval problem", __LINE__);
341
342 p++; /* remove ':' char */
343 cluster->controldata.chkpnt_oldstMulti = str2uint(p);
344 got_oldestmulti = true;
345 }
346 else if ((p = strstr(bufin, "Latest checkpoint's NextMultiOffset:")) != NULL)
347 {
348 p = strchr(p, ':');
349
350 if (p == NULL || strlen(p) <= 1)
351 pg_fatal("%d: controldata retrieval problem", __LINE__);
352
353 p++; /* remove ':' char */
354 cluster->controldata.chkpnt_nxtmxoff = str2uint(p);
355 got_mxoff = true;
356 }
357 else if ((p = strstr(bufin, "First log segment after reset:")) != NULL)
358 {
359 /* Skip the colon and any whitespace after it */
360 p = strchr(p, ':');
361 if (p == NULL || strlen(p) <= 1)
362 pg_fatal("%d: controldata retrieval problem", __LINE__);
363 p = strpbrk(p, "01234567890ABCDEF");
364 if (p == NULL || strlen(p) <= 1)
365 pg_fatal("%d: controldata retrieval problem", __LINE__);
366
367 /* Make sure it looks like a valid WAL file name */
368 if (strspn(p, "0123456789ABCDEF") != 24)
369 pg_fatal("%d: controldata retrieval problem", __LINE__);
370
371 strlcpy(cluster->controldata.nextxlogfile, p, 25);
372 got_nextxlogfile = true;
373 }
374 else if ((p = strstr(bufin, "Float8 argument passing:")) != NULL)
375 {
376 p = strchr(p, ':');
377
378 if (p == NULL || strlen(p) <= 1)
379 pg_fatal("%d: controldata retrieval problem", __LINE__);
380
381 p++; /* remove ':' char */
382 /* used later for contrib check */
383 cluster->controldata.float8_pass_by_value = strstr(p, "by value") != NULL;
384 got_float8_pass_by_value = true;
385 }
386 else if ((p = strstr(bufin, "Maximum data alignment:")) != NULL)
387 {
388 p = strchr(p, ':');
389
390 if (p == NULL || strlen(p) <= 1)
391 pg_fatal("%d: controldata retrieval problem", __LINE__);
392
393 p++; /* remove ':' char */
394 cluster->controldata.align = str2uint(p);
395 got_align = true;
396 }
397 else if ((p = strstr(bufin, "Database block size:")) != NULL)
398 {
399 p = strchr(p, ':');
400
401 if (p == NULL || strlen(p) <= 1)
402 pg_fatal("%d: controldata retrieval problem", __LINE__);
403
404 p++; /* remove ':' char */
405 cluster->controldata.blocksz = str2uint(p);
406 got_blocksz = true;
407 }
408 else if ((p = strstr(bufin, "Blocks per segment of large relation:")) != NULL)
409 {
410 p = strchr(p, ':');
411
412 if (p == NULL || strlen(p) <= 1)
413 pg_fatal("%d: controldata retrieval problem", __LINE__);
414
415 p++; /* remove ':' char */
416 cluster->controldata.largesz = str2uint(p);
417 got_largesz = true;
418 }
419 else if ((p = strstr(bufin, "WAL block size:")) != NULL)
420 {
421 p = strchr(p, ':');
422
423 if (p == NULL || strlen(p) <= 1)
424 pg_fatal("%d: controldata retrieval problem", __LINE__);
425
426 p++; /* remove ':' char */
427 cluster->controldata.walsz = str2uint(p);
428 got_walsz = true;
429 }
430 else if ((p = strstr(bufin, "Bytes per WAL segment:")) != NULL)
431 {
432 p = strchr(p, ':');
433
434 if (p == NULL || strlen(p) <= 1)
435 pg_fatal("%d: controldata retrieval problem", __LINE__);
436
437 p++; /* remove ':' char */
438 cluster->controldata.walseg = str2uint(p);
439 got_walseg = true;
440 }
441 else if ((p = strstr(bufin, "Maximum length of identifiers:")) != NULL)
442 {
443 p = strchr(p, ':');
444
445 if (p == NULL || strlen(p) <= 1)
446 pg_fatal("%d: controldata retrieval problem", __LINE__);
447
448 p++; /* remove ':' char */
449 cluster->controldata.ident = str2uint(p);
450 got_ident = true;
451 }
452 else if ((p = strstr(bufin, "Maximum columns in an index:")) != NULL)
453 {
454 p = strchr(p, ':');
455
456 if (p == NULL || strlen(p) <= 1)
457 pg_fatal("%d: controldata retrieval problem", __LINE__);
458
459 p++; /* remove ':' char */
460 cluster->controldata.index = str2uint(p);
461 got_index = true;
462 }
463 else if ((p = strstr(bufin, "Maximum size of a TOAST chunk:")) != NULL)
464 {
465 p = strchr(p, ':');
466
467 if (p == NULL || strlen(p) <= 1)
468 pg_fatal("%d: controldata retrieval problem", __LINE__);
469
470 p++; /* remove ':' char */
471 cluster->controldata.toast = str2uint(p);
472 got_toast = true;
473 }
474 else if ((p = strstr(bufin, "Size of a large-object chunk:")) != NULL)
475 {
476 p = strchr(p, ':');
477
478 if (p == NULL || strlen(p) <= 1)
479 pg_fatal("%d: controldata retrieval problem", __LINE__);
480
481 p++; /* remove ':' char */
482 cluster->controldata.large_object = str2uint(p);
483 got_large_object = true;
484 }
485 else if ((p = strstr(bufin, "Date/time type storage:")) != NULL)
486 {
487 p = strchr(p, ':');
488
489 if (p == NULL || strlen(p) <= 1)
490 pg_fatal("%d: controldata retrieval problem", __LINE__);
491
492 p++; /* remove ':' char */
493 cluster->controldata.date_is_int = strstr(p, "64-bit integers") != NULL;
494 got_date_is_int = true;
495 }
496 else if ((p = strstr(bufin, "checksum")) != NULL)
497 {
498 p = strchr(p, ':');
499
500 if (p == NULL || strlen(p) <= 1)
501 pg_fatal("%d: controldata retrieval problem", __LINE__);
502
503 p++; /* remove ':' char */
504 cluster->controldata.data_checksum_version = str2uint(p);
505 got_data_checksum_version = true;
506 }
507 else if ((p = strstr(bufin, "Default char data signedness:")) != NULL)
508 {
509 p = strchr(p, ':');
510
511 if (p == NULL || strlen(p) <= 1)
512 pg_fatal("%d: controldata retrieval problem", __LINE__);
513
514 /* Skip the colon and any whitespace after it */
515 p++;
516 while (isspace((unsigned char) *p))
517 p++;
518
519 /* The value should be either 'signed' or 'unsigned' */
520 if (strcmp(p, "signed") != 0 && strcmp(p, "unsigned") != 0)
521 pg_fatal("%d: controldata retrieval problem", __LINE__);
522
523 cluster->controldata.default_char_signedness = strcmp(p, "signed") == 0;
524 got_default_char_signedness = true;
525 }
526 }
527
528 rc = pclose(output);
529 if (rc != 0)
530 pg_fatal("could not get control data using %s: %s",
531 cmd, wait_result_to_str(rc));
532
533 /*
534 * Restore environment variables. Note all but LANG and LC_MESSAGES were
535 * unset above.
536 */
537 if (lc_collate)
538 setenv("LC_COLLATE", lc_collate, 1);
539 if (lc_ctype)
540 setenv("LC_CTYPE", lc_ctype, 1);
541 if (lc_monetary)
542 setenv("LC_MONETARY", lc_monetary, 1);
543 if (lc_numeric)
544 setenv("LC_NUMERIC", lc_numeric, 1);
545 if (lc_time)
546 setenv("LC_TIME", lc_time, 1);
547 if (lang)
548 setenv("LANG", lang, 1);
549 else
550 unsetenv("LANG");
551 if (language)
552 setenv("LANGUAGE", language, 1);
553 if (lc_all)
554 setenv("LC_ALL", lc_all, 1);
555 if (lc_messages)
556 setenv("LC_MESSAGES", lc_messages, 1);
557 else
558 unsetenv("LC_MESSAGES");
559
560 pg_free(lc_collate);
561 pg_free(lc_ctype);
562 pg_free(lc_monetary);
563 pg_free(lc_numeric);
564 pg_free(lc_time);
565 pg_free(lang);
566 pg_free(language);
567 pg_free(lc_all);
568 pg_free(lc_messages);
569
570 /*
571 * Before 9.3, pg_resetwal reported the xlogid and segno of the first log
572 * file after reset as separate lines. Starting with 9.3, it reports the
573 * WAL file name. If the old cluster is older than 9.3, we construct the
574 * WAL file name from the xlogid and segno.
575 */
576 if (GET_MAJOR_VERSION(cluster->major_version) <= 902)
577 {
578 if (got_tli && got_log_id && got_log_seg)
579 {
580 snprintf(cluster->controldata.nextxlogfile, 25, "%08X%08X%08X",
581 tli, logid, segno);
582 got_nextxlogfile = true;
583 }
584 }
585
586 /*
587 * Pre-v18 database clusters don't have the default char signedness
588 * information. We use the char signedness of the platform where
589 * pg_upgrade was built.
590 */
591 if (cluster->controldata.cat_ver < DEFAULT_CHAR_SIGNEDNESS_CAT_VER)
592 {
593 Assert(!got_default_char_signedness);
594#if CHAR_MIN != 0
595 cluster->controldata.default_char_signedness = true;
596#else
597 cluster->controldata.default_char_signedness = false;
598#endif
599 }
600
601 /* verify that we got all the mandatory pg_control data */
602 if (!got_xid || !got_oid ||
603 !got_multi || !got_oldestxid ||
604 (!got_oldestmulti &&
605 cluster->controldata.cat_ver >= MULTIXACT_FORMATCHANGE_CAT_VER) ||
606 !got_mxoff || (!live_check && !got_nextxlogfile) ||
607 !got_float8_pass_by_value || !got_align || !got_blocksz ||
608 !got_largesz || !got_walsz || !got_walseg || !got_ident ||
609 !got_index || !got_toast ||
610 (!got_large_object &&
611 cluster->controldata.ctrl_ver >= LARGE_OBJECT_SIZE_PG_CONTROL_VER) ||
612 !got_date_is_int || !got_data_checksum_version ||
613 (!got_default_char_signedness &&
614 cluster->controldata.cat_ver >= DEFAULT_CHAR_SIGNEDNESS_CAT_VER))
615 {
616 if (cluster == &old_cluster)
617 pg_log(PG_REPORT,
618 "The source cluster lacks some required control information:");
619 else
620 pg_log(PG_REPORT,
621 "The target cluster lacks some required control information:");
622
623 if (!got_xid)
624 pg_log(PG_REPORT, " checkpoint next XID");
625
626 if (!got_oid)
627 pg_log(PG_REPORT, " latest checkpoint next OID");
628
629 if (!got_multi)
630 pg_log(PG_REPORT, " latest checkpoint next MultiXactId");
631
632 if (!got_oldestmulti &&
633 cluster->controldata.cat_ver >= MULTIXACT_FORMATCHANGE_CAT_VER)
634 pg_log(PG_REPORT, " latest checkpoint oldest MultiXactId");
635
636 if (!got_oldestxid)
637 pg_log(PG_REPORT, " latest checkpoint oldestXID");
638
639 if (!got_mxoff)
640 pg_log(PG_REPORT, " latest checkpoint next MultiXactOffset");
641
642 if (!live_check && !got_nextxlogfile)
643 pg_log(PG_REPORT, " first WAL segment after reset");
644
645 if (!got_float8_pass_by_value)
646 pg_log(PG_REPORT, " float8 argument passing method");
647
648 if (!got_align)
649 pg_log(PG_REPORT, " maximum alignment");
650
651 if (!got_blocksz)
652 pg_log(PG_REPORT, " block size");
653
654 if (!got_largesz)
655 pg_log(PG_REPORT, " large relation segment size");
656
657 if (!got_walsz)
658 pg_log(PG_REPORT, " WAL block size");
659
660 if (!got_walseg)
661 pg_log(PG_REPORT, " WAL segment size");
662
663 if (!got_ident)
664 pg_log(PG_REPORT, " maximum identifier length");
665
666 if (!got_index)
667 pg_log(PG_REPORT, " maximum number of indexed columns");
668
669 if (!got_toast)
670 pg_log(PG_REPORT, " maximum TOAST chunk size");
671
672 if (!got_large_object &&
673 cluster->controldata.ctrl_ver >= LARGE_OBJECT_SIZE_PG_CONTROL_VER)
674 pg_log(PG_REPORT, " large-object chunk size");
675
676 if (!got_date_is_int)
677 pg_log(PG_REPORT, " dates/times are integers?");
678
679 /* value added in Postgres 9.3 */
680 if (!got_data_checksum_version)
681 pg_log(PG_REPORT, " data checksum version");
682
683 /* value added in Postgres 18 */
684 if (!got_default_char_signedness)
685 pg_log(PG_REPORT, " default char signedness");
686
687 pg_fatal("Cannot continue without required control information, terminating");
688 }
689}
690
691
692/*
693 * check_control_data()
694 *
695 * check to make sure the control data settings are compatible
696 */
697void
698 check_control_data(ControlData *oldctrl,
699 ControlData *newctrl)
700{
701 if (oldctrl->align == 0 || oldctrl->align != newctrl->align)
702 pg_fatal("old and new pg_controldata alignments are invalid or do not match.\n"
703 "Likely one cluster is a 32-bit install, the other 64-bit");
704
705 if (oldctrl->blocksz == 0 || oldctrl->blocksz != newctrl->blocksz)
706 pg_fatal("old and new pg_controldata block sizes are invalid or do not match");
707
708 if (oldctrl->largesz == 0 || oldctrl->largesz != newctrl->largesz)
709 pg_fatal("old and new pg_controldata maximum relation segment sizes are invalid or do not match");
710
711 if (oldctrl->walsz == 0 || oldctrl->walsz != newctrl->walsz)
712 pg_fatal("old and new pg_controldata WAL block sizes are invalid or do not match");
713
714 if (oldctrl->walseg == 0 || oldctrl->walseg != newctrl->walseg)
715 pg_fatal("old and new pg_controldata WAL segment sizes are invalid or do not match");
716
717 if (oldctrl->ident == 0 || oldctrl->ident != newctrl->ident)
718 pg_fatal("old and new pg_controldata maximum identifier lengths are invalid or do not match");
719
720 if (oldctrl->index == 0 || oldctrl->index != newctrl->index)
721 pg_fatal("old and new pg_controldata maximum indexed columns are invalid or do not match");
722
723 if (oldctrl->toast == 0 || oldctrl->toast != newctrl->toast)
724 pg_fatal("old and new pg_controldata maximum TOAST chunk sizes are invalid or do not match");
725
726 /* large_object added in 9.5, so it might not exist in the old cluster */
727 if (oldctrl->large_object != 0 &&
728 oldctrl->large_object != newctrl->large_object)
729 pg_fatal("old and new pg_controldata large-object chunk sizes are invalid or do not match");
730
731 if (oldctrl->date_is_int != newctrl->date_is_int)
732 pg_fatal("old and new pg_controldata date/time storage types do not match");
733
734 /*
735 * float8_pass_by_value does not need to match, but is used in
736 * check_for_isn_and_int8_passing_mismatch().
737 */
738
739 /*
740 * We might eventually allow upgrades from checksum to no-checksum
741 * clusters.
742 */
743 if (oldctrl->data_checksum_version == 0 &&
744 newctrl->data_checksum_version != 0)
745 pg_fatal("old cluster does not use data checksums but the new one does");
746 else if (oldctrl->data_checksum_version != 0 &&
747 newctrl->data_checksum_version == 0)
748 pg_fatal("old cluster uses data checksums but the new one does not");
749 else if (oldctrl->data_checksum_version != newctrl->data_checksum_version)
750 pg_fatal("old and new cluster pg_controldata checksum versions do not match");
751}
752
753
754void
755 disable_old_cluster(transferMode transfer_mode)
756{
757 char old_path[MAXPGPATH],
758 new_path[MAXPGPATH];
759
760 /* rename pg_control so old server cannot be accidentally started */
761 /* translator: %s is the file path of the control file */
762 prep_status("Adding \".old\" suffix to old \"%s\"", XLOG_CONTROL_FILE);
763
764 snprintf(old_path, sizeof(old_path), "%s/%s", old_cluster.pgdata, XLOG_CONTROL_FILE);
765 snprintf(new_path, sizeof(new_path), "%s/%s.old", old_cluster.pgdata, XLOG_CONTROL_FILE);
766 if (pg_mv_file(old_path, new_path) != 0)
767 pg_fatal("could not rename file \"%s\" to \"%s\": %m",
768 old_path, new_path);
769 check_ok();
770
771 if (transfer_mode == TRANSFER_MODE_LINK)
772 /* translator: %s/%s is the file path of the control file */
773 pg_log(PG_REPORT, "\n"
774 "If you want to start the old cluster, you will need to remove\n"
775 "the \".old\" suffix from \"%s/%s.old\".\n"
776 "Because \"link\" mode was used, the old cluster cannot be safely\n"
777 "started once the new cluster has been started.",
778 old_cluster.pgdata, XLOG_CONTROL_FILE);
779 else if (transfer_mode == TRANSFER_MODE_SWAP)
780 pg_log(PG_REPORT, "\n"
781 "Because \"swap\" mode was used, the old cluster can no longer be\n"
782 "safely started.");
783 else
784 pg_fatal("unrecognized transfer mode");
785}
uint32_t uint32
Definition: c.h:538
void cluster(ParseState *pstate, ClusterStmt *stmt, bool isTopLevel)
Definition: cluster.c:107
void get_control_data(ClusterInfo *cluster)
Definition: controldata.c:38
void check_control_data(ControlData *oldctrl, ControlData *newctrl)
Definition: controldata.c:698
void disable_old_cluster(transferMode transfer_mode)
Definition: controldata.c:755
char * pg_strdup(const char *in)
Definition: fe_memutils.c:85
void pg_free(void *ptr)
Definition: fe_memutils.c:105
Assert(PointerIsAligned(start, uint64))
FILE * output
static char * lc_collate
Definition: initdb.c:141
static char * lc_time
Definition: initdb.c:145
static char * lc_ctype
Definition: initdb.c:142
static char * lc_messages
Definition: initdb.c:146
static char * lc_numeric
Definition: initdb.c:144
static void check_ok(void)
Definition: initdb.c:2106
static char * lc_monetary
Definition: initdb.c:143
#define pg_fatal(...)
#define MAXPGPATH
ClusterInfo new_cluster
Definition: pg_upgrade.c:73
ClusterInfo old_cluster
Definition: pg_upgrade.c:72
#define pg_mv_file
Definition: pg_upgrade.h:81
#define LARGE_OBJECT_SIZE_PG_CONTROL_VER
Definition: pg_upgrade.h:121
#define MULTIXACT_FORMATCHANGE_CAT_VER
Definition: pg_upgrade.h:115
void void unsigned int str2uint(const char *str)
Definition: util.c:352
void void pg_log(eLogType type, const char *fmt,...) pg_attribute_printf(2
transferMode
Definition: pg_upgrade.h:260
@ TRANSFER_MODE_LINK
Definition: pg_upgrade.h:264
@ TRANSFER_MODE_SWAP
Definition: pg_upgrade.h:265
@ PG_VERBOSE
Definition: pg_upgrade.h:273
@ PG_REPORT
Definition: pg_upgrade.h:276
#define GET_MAJOR_VERSION(v)
Definition: pg_upgrade.h:27
#define MAX_STRING
Definition: pg_upgrade.h:22
#define DEFAULT_CHAR_SIGNEDNESS_CAT_VER
Definition: pg_upgrade.h:132
void prep_status(const char *fmt,...) pg_attribute_printf(1
#define snprintf
Definition: port.h:239
size_t strlcpy(char *dst, const char *src, size_t siz)
Definition: strlcpy.c:45
UserOpts user_opts
Definition: option.c:30
int pg_strip_crlf(char *str)
Definition: string.c:154
char * pgdata
Definition: pg_upgrade.h:292
uint32 data_checksum_version
Definition: pg_upgrade.h:252
uint32 toast
Definition: pg_upgrade.h:248
uint32 index
Definition: pg_upgrade.h:247
uint32 walseg
Definition: pg_upgrade.h:245
uint32 blocksz
Definition: pg_upgrade.h:242
uint32 walsz
Definition: pg_upgrade.h:244
uint32 ident
Definition: pg_upgrade.h:246
bool date_is_int
Definition: pg_upgrade.h:250
uint32 large_object
Definition: pg_upgrade.h:249
uint32 align
Definition: pg_upgrade.h:241
uint32 largesz
Definition: pg_upgrade.h:243
bool live_check
Definition: pg_upgrade.h:335
char * wait_result_to_str(int exitstatus)
Definition: wait_error.c:33
#define unsetenv(x)
Definition: win32_port.h:546
#define setenv(x, y, z)
Definition: win32_port.h:545
#define XLOG_CONTROL_FILE
Definition: xlog_internal.h:150

AltStyle によって変換されたページ (->オリジナル) /