Line data Source code
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 : */
37 : void
38 60 : get_control_data(ClusterInfo *cluster)
39 : {
40 : char cmd[MAXPGPATH];
41 : char bufin[MAX_STRING];
42 : FILE *output;
43 : char *p;
44 60 : bool got_tli = false;
45 60 : bool got_log_id = false;
46 60 : bool got_log_seg = false;
47 60 : bool got_xid = false;
48 60 : bool got_oid = false;
49 60 : bool got_multi = false;
50 60 : bool got_oldestmulti = false;
51 60 : bool got_oldestxid = false;
52 60 : bool got_mxoff = false;
53 60 : bool got_nextxlogfile = false;
54 60 : bool got_float8_pass_by_value = false;
55 60 : bool got_align = false;
56 60 : bool got_blocksz = false;
57 60 : bool got_largesz = false;
58 60 : bool got_walsz = false;
59 60 : bool got_walseg = false;
60 60 : bool got_ident = false;
61 60 : bool got_index = false;
62 60 : bool got_toast = false;
63 60 : bool got_large_object = false;
64 60 : bool got_date_is_int = false;
65 60 : bool got_data_checksum_version = false;
66 60 : bool got_cluster_state = false;
67 60 : bool got_default_char_signedness = false;
68 60 : char *lc_collate = NULL;
69 60 : char *lc_ctype = NULL;
70 60 : char *lc_monetary = NULL;
71 60 : char *lc_numeric = NULL;
72 60 : char *lc_time = NULL;
73 60 : char *lang = NULL;
74 60 : char *language = NULL;
75 60 : char *lc_all = NULL;
76 60 : char *lc_messages = NULL;
77 60 : uint32 tli = 0;
78 60 : uint32 logid = 0;
79 60 : uint32 segno = 0;
80 : char *resetwal_bin;
81 : int rc;
82 60 : 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 60 : if (getenv("LC_COLLATE"))
89 0 : lc_collate = pg_strdup(getenv("LC_COLLATE"));
90 60 : if (getenv("LC_CTYPE"))
91 0 : lc_ctype = pg_strdup(getenv("LC_CTYPE"));
92 60 : if (getenv("LC_MONETARY"))
93 0 : lc_monetary = pg_strdup(getenv("LC_MONETARY"));
94 60 : if (getenv("LC_NUMERIC"))
95 0 : lc_numeric = pg_strdup(getenv("LC_NUMERIC"));
96 60 : if (getenv("LC_TIME"))
97 0 : lc_time = pg_strdup(getenv("LC_TIME"));
98 60 : if (getenv("LANG"))
99 60 : lang = pg_strdup(getenv("LANG"));
100 60 : if (getenv("LANGUAGE"))
101 0 : language = pg_strdup(getenv("LANGUAGE"));
102 60 : if (getenv("LC_ALL"))
103 0 : lc_all = pg_strdup(getenv("LC_ALL"));
104 60 : if (getenv("LC_MESSAGES"))
105 60 : lc_messages = pg_strdup(getenv("LC_MESSAGES"));
106 :
107 60 : unsetenv("LC_COLLATE");
108 60 : unsetenv("LC_CTYPE");
109 60 : unsetenv("LC_MONETARY");
110 60 : unsetenv("LC_NUMERIC");
111 60 : unsetenv("LC_TIME");
112 : #ifndef WIN32
113 60 : 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 60 : unsetenv("LANGUAGE");
119 60 : unsetenv("LC_ALL");
120 60 : setenv("LC_MESSAGES", "C", 1);
121 :
122 : /*
123 : * Check for clean shutdown
124 : */
125 60 : if (!live_check || cluster == &new_cluster)
126 : {
127 : /* only pg_controldata outputs the cluster state */
128 60 : snprintf(cmd, sizeof(cmd), "\"%s/pg_controldata\" \"%s\"",
129 : cluster->bindir, cluster->pgdata);
130 60 : fflush(NULL);
131 :
132 60 : if ((output = popen(cmd, "r")) == NULL)
133 0 : 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 3120 : while (fgets(bufin, sizeof(bufin), output))
137 : {
138 3060 : if ((p = strstr(bufin, "Database cluster state:")) != NULL)
139 : {
140 60 : p = strchr(p, ':');
141 :
142 60 : if (p == NULL || strlen(p) <= 1)
143 0 : pg_fatal("%d: database cluster state problem", __LINE__);
144 :
145 60 : 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 60 : (void) pg_strip_crlf(p);
157 960 : while (*p == ' ')
158 900 : p++;
159 60 : if (strcmp(p, "shut down in recovery") == 0)
160 : {
161 0 : if (cluster == &old_cluster)
162 0 : 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 0 : 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 60 : else if (strcmp(p, "shut down") != 0)
167 : {
168 0 : if (cluster == &old_cluster)
169 0 : pg_fatal("The source cluster was not shut down cleanly, state reported as: \"%s\"", p);
170 : else
171 0 : pg_fatal("The target cluster was not shut down cleanly, state reported as: \"%s\"", p);
172 : }
173 60 : got_cluster_state = true;
174 : }
175 : }
176 :
177 60 : rc = pclose(output);
178 60 : if (rc != 0)
179 0 : pg_fatal("could not get control data using %s: %s",
180 : cmd, wait_result_to_str(rc));
181 :
182 60 : if (!got_cluster_state)
183 : {
184 0 : if (cluster == &old_cluster)
185 0 : pg_fatal("The source cluster lacks cluster state information:");
186 : else
187 0 : 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 60 : if (GET_MAJOR_VERSION(cluster->bin_version) <= 906)
193 0 : resetwal_bin = "pg_resetxlog\" -n";
194 : else
195 60 : resetwal_bin = "pg_resetwal\" -n";
196 60 : snprintf(cmd, sizeof(cmd), "\"%s/%s \"%s\"",
197 : cluster->bindir,
198 : live_check ? "pg_controldata\"" : resetwal_bin,
199 : cluster->pgdata);
200 60 : fflush(NULL);
201 :
202 60 : if ((output = popen(cmd, "r")) == NULL)
203 0 : pg_fatal("could not get control data using %s: %m", cmd);
204 :
205 : /* Only in <= 9.2 */
206 60 : if (GET_MAJOR_VERSION(cluster->major_version) <= 902)
207 : {
208 0 : cluster->controldata.data_checksum_version = 0;
209 0 : got_data_checksum_version = true;
210 : }
211 :
212 : /* we have the result of cmd in "output". so parse it line by line now */
213 2220 : while (fgets(bufin, sizeof(bufin), output))
214 : {
215 : /* In verbose mode, log each line */
216 2160 : pg_strip_crlf(bufin);
217 2160 : pg_log(PG_VERBOSE, "%s", bufin);
218 :
219 2160 : if ((p = strstr(bufin, "pg_control version number:")) != NULL)
220 : {
221 60 : p = strchr(p, ':');
222 :
223 60 : if (p == NULL || strlen(p) <= 1)
224 0 : pg_fatal("%d: pg_resetwal problem", __LINE__);
225 :
226 60 : p++; /* remove ':' char */
227 60 : cluster->controldata.ctrl_ver = str2uint(p);
228 : }
229 2100 : else if ((p = strstr(bufin, "Catalog version number:")) != NULL)
230 : {
231 60 : p = strchr(p, ':');
232 :
233 60 : if (p == NULL || strlen(p) <= 1)
234 0 : pg_fatal("%d: controldata retrieval problem", __LINE__);
235 :
236 60 : p++; /* remove ':' char */
237 60 : cluster->controldata.cat_ver = str2uint(p);
238 : }
239 2040 : else if ((p = strstr(bufin, "Latest checkpoint's TimeLineID:")) != NULL)
240 : {
241 60 : p = strchr(p, ':');
242 :
243 60 : if (p == NULL || strlen(p) <= 1)
244 0 : pg_fatal("%d: controldata retrieval problem", __LINE__);
245 :
246 60 : p++; /* remove ':' char */
247 60 : tli = str2uint(p);
248 60 : got_tli = true;
249 : }
250 1980 : else if ((p = strstr(bufin, "First log file ID after reset:")) != NULL)
251 : {
252 0 : p = strchr(p, ':');
253 :
254 0 : if (p == NULL || strlen(p) <= 1)
255 0 : pg_fatal("%d: controldata retrieval problem", __LINE__);
256 :
257 0 : p++; /* remove ':' char */
258 0 : logid = str2uint(p);
259 0 : got_log_id = true;
260 : }
261 1980 : else if ((p = strstr(bufin, "First log file segment after reset:")) != NULL)
262 : {
263 0 : p = strchr(p, ':');
264 :
265 0 : if (p == NULL || strlen(p) <= 1)
266 0 : pg_fatal("%d: controldata retrieval problem", __LINE__);
267 :
268 0 : p++; /* remove ':' char */
269 0 : segno = str2uint(p);
270 0 : got_log_seg = true;
271 : }
272 1980 : else if ((p = strstr(bufin, "Latest checkpoint's NextXID:")) != NULL)
273 : {
274 60 : p = strchr(p, ':');
275 :
276 60 : if (p == NULL || strlen(p) <= 1)
277 0 : pg_fatal("%d: controldata retrieval problem", __LINE__);
278 :
279 60 : p++; /* remove ':' char */
280 60 : 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 60 : if (strchr(p, '/') != NULL)
289 0 : p = strchr(p, '/');
290 60 : else if (GET_MAJOR_VERSION(cluster->major_version) >= 906)
291 60 : p = strchr(p, ':');
292 : else
293 0 : p = NULL;
294 :
295 60 : if (p == NULL || strlen(p) <= 1)
296 0 : pg_fatal("%d: controldata retrieval problem", __LINE__);
297 :
298 60 : p++; /* remove '/' or ':' char */
299 60 : cluster->controldata.chkpnt_nxtxid = str2uint(p);
300 60 : got_xid = true;
301 : }
302 1920 : else if ((p = strstr(bufin, "Latest checkpoint's NextOID:")) != NULL)
303 : {
304 60 : p = strchr(p, ':');
305 :
306 60 : if (p == NULL || strlen(p) <= 1)
307 0 : pg_fatal("%d: controldata retrieval problem", __LINE__);
308 :
309 60 : p++; /* remove ':' char */
310 60 : cluster->controldata.chkpnt_nxtoid = str2uint(p);
311 60 : got_oid = true;
312 : }
313 1860 : else if ((p = strstr(bufin, "Latest checkpoint's NextMultiXactId:")) != NULL)
314 : {
315 60 : p = strchr(p, ':');
316 :
317 60 : if (p == NULL || strlen(p) <= 1)
318 0 : pg_fatal("%d: controldata retrieval problem", __LINE__);
319 :
320 60 : p++; /* remove ':' char */
321 60 : cluster->controldata.chkpnt_nxtmulti = str2uint(p);
322 60 : got_multi = true;
323 : }
324 1800 : else if ((p = strstr(bufin, "Latest checkpoint's oldestXID:")) != NULL)
325 : {
326 60 : p = strchr(p, ':');
327 :
328 60 : if (p == NULL || strlen(p) <= 1)
329 0 : pg_fatal("%d: controldata retrieval problem", __LINE__);
330 :
331 60 : p++; /* remove ':' char */
332 60 : cluster->controldata.chkpnt_oldstxid = str2uint(p);
333 60 : got_oldestxid = true;
334 : }
335 1740 : else if ((p = strstr(bufin, "Latest checkpoint's oldestMultiXid:")) != NULL)
336 : {
337 60 : p = strchr(p, ':');
338 :
339 60 : if (p == NULL || strlen(p) <= 1)
340 0 : pg_fatal("%d: controldata retrieval problem", __LINE__);
341 :
342 60 : p++; /* remove ':' char */
343 60 : cluster->controldata.chkpnt_oldstMulti = str2uint(p);
344 60 : got_oldestmulti = true;
345 : }
346 1680 : else if ((p = strstr(bufin, "Latest checkpoint's NextMultiOffset:")) != NULL)
347 : {
348 60 : p = strchr(p, ':');
349 :
350 60 : if (p == NULL || strlen(p) <= 1)
351 0 : pg_fatal("%d: controldata retrieval problem", __LINE__);
352 :
353 60 : p++; /* remove ':' char */
354 60 : cluster->controldata.chkpnt_nxtmxoff = str2uint(p);
355 60 : got_mxoff = true;
356 : }
357 1620 : else if ((p = strstr(bufin, "First log segment after reset:")) != NULL)
358 : {
359 : /* Skip the colon and any whitespace after it */
360 60 : p = strchr(p, ':');
361 60 : if (p == NULL || strlen(p) <= 1)
362 0 : pg_fatal("%d: controldata retrieval problem", __LINE__);
363 60 : p = strpbrk(p, "01234567890ABCDEF");
364 60 : if (p == NULL || strlen(p) <= 1)
365 0 : pg_fatal("%d: controldata retrieval problem", __LINE__);
366 :
367 : /* Make sure it looks like a valid WAL file name */
368 60 : if (strspn(p, "0123456789ABCDEF") != 24)
369 0 : pg_fatal("%d: controldata retrieval problem", __LINE__);
370 :
371 60 : strlcpy(cluster->controldata.nextxlogfile, p, 25);
372 60 : got_nextxlogfile = true;
373 : }
374 1560 : else if ((p = strstr(bufin, "Float8 argument passing:")) != NULL)
375 : {
376 60 : p = strchr(p, ':');
377 :
378 60 : if (p == NULL || strlen(p) <= 1)
379 0 : pg_fatal("%d: controldata retrieval problem", __LINE__);
380 :
381 60 : p++; /* remove ':' char */
382 : /* used later for contrib check */
383 60 : cluster->controldata.float8_pass_by_value = strstr(p, "by value") != NULL;
384 60 : got_float8_pass_by_value = true;
385 : }
386 1500 : else if ((p = strstr(bufin, "Maximum data alignment:")) != NULL)
387 : {
388 60 : p = strchr(p, ':');
389 :
390 60 : if (p == NULL || strlen(p) <= 1)
391 0 : pg_fatal("%d: controldata retrieval problem", __LINE__);
392 :
393 60 : p++; /* remove ':' char */
394 60 : cluster->controldata.align = str2uint(p);
395 60 : got_align = true;
396 : }
397 1440 : else if ((p = strstr(bufin, "Database block size:")) != NULL)
398 : {
399 60 : p = strchr(p, ':');
400 :
401 60 : if (p == NULL || strlen(p) <= 1)
402 0 : pg_fatal("%d: controldata retrieval problem", __LINE__);
403 :
404 60 : p++; /* remove ':' char */
405 60 : cluster->controldata.blocksz = str2uint(p);
406 60 : got_blocksz = true;
407 : }
408 1380 : else if ((p = strstr(bufin, "Blocks per segment of large relation:")) != NULL)
409 : {
410 60 : p = strchr(p, ':');
411 :
412 60 : if (p == NULL || strlen(p) <= 1)
413 0 : pg_fatal("%d: controldata retrieval problem", __LINE__);
414 :
415 60 : p++; /* remove ':' char */
416 60 : cluster->controldata.largesz = str2uint(p);
417 60 : got_largesz = true;
418 : }
419 1320 : else if ((p = strstr(bufin, "WAL block size:")) != NULL)
420 : {
421 60 : p = strchr(p, ':');
422 :
423 60 : if (p == NULL || strlen(p) <= 1)
424 0 : pg_fatal("%d: controldata retrieval problem", __LINE__);
425 :
426 60 : p++; /* remove ':' char */
427 60 : cluster->controldata.walsz = str2uint(p);
428 60 : got_walsz = true;
429 : }
430 1260 : else if ((p = strstr(bufin, "Bytes per WAL segment:")) != NULL)
431 : {
432 60 : p = strchr(p, ':');
433 :
434 60 : if (p == NULL || strlen(p) <= 1)
435 0 : pg_fatal("%d: controldata retrieval problem", __LINE__);
436 :
437 60 : p++; /* remove ':' char */
438 60 : cluster->controldata.walseg = str2uint(p);
439 60 : got_walseg = true;
440 : }
441 1200 : else if ((p = strstr(bufin, "Maximum length of identifiers:")) != NULL)
442 : {
443 60 : p = strchr(p, ':');
444 :
445 60 : if (p == NULL || strlen(p) <= 1)
446 0 : pg_fatal("%d: controldata retrieval problem", __LINE__);
447 :
448 60 : p++; /* remove ':' char */
449 60 : cluster->controldata.ident = str2uint(p);
450 60 : got_ident = true;
451 : }
452 1140 : else if ((p = strstr(bufin, "Maximum columns in an index:")) != NULL)
453 : {
454 60 : p = strchr(p, ':');
455 :
456 60 : if (p == NULL || strlen(p) <= 1)
457 0 : pg_fatal("%d: controldata retrieval problem", __LINE__);
458 :
459 60 : p++; /* remove ':' char */
460 60 : cluster->controldata.index = str2uint(p);
461 60 : got_index = true;
462 : }
463 1080 : else if ((p = strstr(bufin, "Maximum size of a TOAST chunk:")) != NULL)
464 : {
465 60 : p = strchr(p, ':');
466 :
467 60 : if (p == NULL || strlen(p) <= 1)
468 0 : pg_fatal("%d: controldata retrieval problem", __LINE__);
469 :
470 60 : p++; /* remove ':' char */
471 60 : cluster->controldata.toast = str2uint(p);
472 60 : got_toast = true;
473 : }
474 1020 : else if ((p = strstr(bufin, "Size of a large-object chunk:")) != NULL)
475 : {
476 60 : p = strchr(p, ':');
477 :
478 60 : if (p == NULL || strlen(p) <= 1)
479 0 : pg_fatal("%d: controldata retrieval problem", __LINE__);
480 :
481 60 : p++; /* remove ':' char */
482 60 : cluster->controldata.large_object = str2uint(p);
483 60 : got_large_object = true;
484 : }
485 960 : else if ((p = strstr(bufin, "Date/time type storage:")) != NULL)
486 : {
487 60 : p = strchr(p, ':');
488 :
489 60 : if (p == NULL || strlen(p) <= 1)
490 0 : pg_fatal("%d: controldata retrieval problem", __LINE__);
491 :
492 60 : p++; /* remove ':' char */
493 60 : cluster->controldata.date_is_int = strstr(p, "64-bit integers") != NULL;
494 60 : got_date_is_int = true;
495 : }
496 900 : else if ((p = strstr(bufin, "checksum")) != NULL)
497 : {
498 60 : p = strchr(p, ':');
499 :
500 60 : if (p == NULL || strlen(p) <= 1)
501 0 : pg_fatal("%d: controldata retrieval problem", __LINE__);
502 :
503 60 : p++; /* remove ':' char */
504 60 : cluster->controldata.data_checksum_version = str2uint(p);
505 60 : got_data_checksum_version = true;
506 : }
507 840 : else if ((p = strstr(bufin, "Default char data signedness:")) != NULL)
508 : {
509 60 : p = strchr(p, ':');
510 :
511 60 : if (p == NULL || strlen(p) <= 1)
512 0 : pg_fatal("%d: controldata retrieval problem", __LINE__);
513 :
514 : /* Skip the colon and any whitespace after it */
515 60 : p++;
516 600 : while (isspace((unsigned char) *p))
517 540 : p++;
518 :
519 : /* The value should be either 'signed' or 'unsigned' */
520 60 : if (strcmp(p, "signed") != 0 && strcmp(p, "unsigned") != 0)
521 0 : pg_fatal("%d: controldata retrieval problem", __LINE__);
522 :
523 60 : cluster->controldata.default_char_signedness = strcmp(p, "signed") == 0;
524 60 : got_default_char_signedness = true;
525 : }
526 : }
527 :
528 60 : rc = pclose(output);
529 60 : if (rc != 0)
530 0 : 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 60 : if (lc_collate)
538 0 : setenv("LC_COLLATE", lc_collate, 1);
539 60 : if (lc_ctype)
540 0 : setenv("LC_CTYPE", lc_ctype, 1);
541 60 : if (lc_monetary)
542 0 : setenv("LC_MONETARY", lc_monetary, 1);
543 60 : if (lc_numeric)
544 0 : setenv("LC_NUMERIC", lc_numeric, 1);
545 60 : if (lc_time)
546 0 : setenv("LC_TIME", lc_time, 1);
547 60 : if (lang)
548 60 : setenv("LANG", lang, 1);
549 : else
550 0 : unsetenv("LANG");
551 60 : if (language)
552 0 : setenv("LANGUAGE", language, 1);
553 60 : if (lc_all)
554 0 : setenv("LC_ALL", lc_all, 1);
555 60 : if (lc_messages)
556 60 : setenv("LC_MESSAGES", lc_messages, 1);
557 : else
558 0 : unsetenv("LC_MESSAGES");
559 :
560 60 : pg_free(lc_collate);
561 60 : pg_free(lc_ctype);
562 60 : pg_free(lc_monetary);
563 60 : pg_free(lc_numeric);
564 60 : pg_free(lc_time);
565 60 : pg_free(lang);
566 60 : pg_free(language);
567 60 : pg_free(lc_all);
568 60 : 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 60 : if (GET_MAJOR_VERSION(cluster->major_version) <= 902)
577 : {
578 0 : if (got_tli && got_log_id && got_log_seg)
579 : {
580 0 : snprintf(cluster->controldata.nextxlogfile, 25, "%08X%08X%08X",
581 : tli, logid, segno);
582 0 : 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 60 : if (cluster->controldata.cat_ver < DEFAULT_CHAR_SIGNEDNESS_CAT_VER)
592 : {
593 : Assert(!got_default_char_signedness);
594 : #if CHAR_MIN != 0
595 0 : 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 60 : if (!got_xid || !got_oid ||
603 60 : !got_multi || !got_oldestxid ||
604 60 : (!got_oldestmulti &&
605 0 : cluster->controldata.cat_ver >= MULTIXACT_FORMATCHANGE_CAT_VER) ||
606 60 : !got_mxoff || (!live_check && !got_nextxlogfile) ||
607 60 : !got_float8_pass_by_value || !got_align || !got_blocksz ||
608 60 : !got_largesz || !got_walsz || !got_walseg || !got_ident ||
609 60 : !got_index || !got_toast ||
610 60 : (!got_large_object &&
611 0 : cluster->controldata.ctrl_ver >= LARGE_OBJECT_SIZE_PG_CONTROL_VER) ||
612 60 : !got_date_is_int || !got_data_checksum_version ||
613 60 : (!got_default_char_signedness &&
614 0 : cluster->controldata.cat_ver >= DEFAULT_CHAR_SIGNEDNESS_CAT_VER))
615 : {
616 0 : if (cluster == &old_cluster)
617 0 : pg_log(PG_REPORT,
618 : "The source cluster lacks some required control information:");
619 : else
620 0 : pg_log(PG_REPORT,
621 : "The target cluster lacks some required control information:");
622 :
623 0 : if (!got_xid)
624 0 : pg_log(PG_REPORT, " checkpoint next XID");
625 :
626 0 : if (!got_oid)
627 0 : pg_log(PG_REPORT, " latest checkpoint next OID");
628 :
629 0 : if (!got_multi)
630 0 : pg_log(PG_REPORT, " latest checkpoint next MultiXactId");
631 :
632 0 : if (!got_oldestmulti &&
633 0 : cluster->controldata.cat_ver >= MULTIXACT_FORMATCHANGE_CAT_VER)
634 0 : pg_log(PG_REPORT, " latest checkpoint oldest MultiXactId");
635 :
636 0 : if (!got_oldestxid)
637 0 : pg_log(PG_REPORT, " latest checkpoint oldestXID");
638 :
639 0 : if (!got_mxoff)
640 0 : pg_log(PG_REPORT, " latest checkpoint next MultiXactOffset");
641 :
642 0 : if (!live_check && !got_nextxlogfile)
643 0 : pg_log(PG_REPORT, " first WAL segment after reset");
644 :
645 0 : if (!got_float8_pass_by_value)
646 0 : pg_log(PG_REPORT, " float8 argument passing method");
647 :
648 0 : if (!got_align)
649 0 : pg_log(PG_REPORT, " maximum alignment");
650 :
651 0 : if (!got_blocksz)
652 0 : pg_log(PG_REPORT, " block size");
653 :
654 0 : if (!got_largesz)
655 0 : pg_log(PG_REPORT, " large relation segment size");
656 :
657 0 : if (!got_walsz)
658 0 : pg_log(PG_REPORT, " WAL block size");
659 :
660 0 : if (!got_walseg)
661 0 : pg_log(PG_REPORT, " WAL segment size");
662 :
663 0 : if (!got_ident)
664 0 : pg_log(PG_REPORT, " maximum identifier length");
665 :
666 0 : if (!got_index)
667 0 : pg_log(PG_REPORT, " maximum number of indexed columns");
668 :
669 0 : if (!got_toast)
670 0 : pg_log(PG_REPORT, " maximum TOAST chunk size");
671 :
672 0 : if (!got_large_object &&
673 0 : cluster->controldata.ctrl_ver >= LARGE_OBJECT_SIZE_PG_CONTROL_VER)
674 0 : pg_log(PG_REPORT, " large-object chunk size");
675 :
676 0 : if (!got_date_is_int)
677 0 : pg_log(PG_REPORT, " dates/times are integers?");
678 :
679 : /* value added in Postgres 9.3 */
680 0 : if (!got_data_checksum_version)
681 0 : pg_log(PG_REPORT, " data checksum version");
682 :
683 : /* value added in Postgres 18 */
684 0 : if (!got_default_char_signedness)
685 0 : pg_log(PG_REPORT, " default char signedness");
686 :
687 0 : pg_fatal("Cannot continue without required control information, terminating");
688 : }
689 60 : }
690 :
691 :
692 : /*
693 : * check_control_data()
694 : *
695 : * check to make sure the control data settings are compatible
696 : */
697 : void
698 30 : check_control_data(ControlData *oldctrl,
699 : ControlData *newctrl)
700 : {
701 30 : if (oldctrl->align == 0 || oldctrl->align != newctrl->align)
702 0 : 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 30 : if (oldctrl->blocksz == 0 || oldctrl->blocksz != newctrl->blocksz)
706 0 : pg_fatal("old and new pg_controldata block sizes are invalid or do not match");
707 :
708 30 : if (oldctrl->largesz == 0 || oldctrl->largesz != newctrl->largesz)
709 0 : pg_fatal("old and new pg_controldata maximum relation segment sizes are invalid or do not match");
710 :
711 30 : if (oldctrl->walsz == 0 || oldctrl->walsz != newctrl->walsz)
712 0 : pg_fatal("old and new pg_controldata WAL block sizes are invalid or do not match");
713 :
714 30 : if (oldctrl->walseg == 0 || oldctrl->walseg != newctrl->walseg)
715 0 : pg_fatal("old and new pg_controldata WAL segment sizes are invalid or do not match");
716 :
717 30 : if (oldctrl->ident == 0 || oldctrl->ident != newctrl->ident)
718 0 : pg_fatal("old and new pg_controldata maximum identifier lengths are invalid or do not match");
719 :
720 30 : if (oldctrl->index == 0 || oldctrl->index != newctrl->index)
721 0 : pg_fatal("old and new pg_controldata maximum indexed columns are invalid or do not match");
722 :
723 30 : if (oldctrl->toast == 0 || oldctrl->toast != newctrl->toast)
724 0 : 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 30 : if (oldctrl->large_object != 0 &&
728 30 : oldctrl->large_object != newctrl->large_object)
729 0 : pg_fatal("old and new pg_controldata large-object chunk sizes are invalid or do not match");
730 :
731 30 : if (oldctrl->date_is_int != newctrl->date_is_int)
732 0 : 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 30 : if (oldctrl->data_checksum_version == 0 &&
744 0 : newctrl->data_checksum_version != 0)
745 0 : pg_fatal("old cluster does not use data checksums but the new one does");
746 30 : else if (oldctrl->data_checksum_version != 0 &&
747 30 : newctrl->data_checksum_version == 0)
748 0 : pg_fatal("old cluster uses data checksums but the new one does not");
749 30 : else if (oldctrl->data_checksum_version != newctrl->data_checksum_version)
750 0 : pg_fatal("old and new cluster pg_controldata checksum versions do not match");
751 30 : }
752 :
753 :
754 : void
755 4 : 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 4 : prep_status("Adding \".old\" suffix to old \"%s\"", XLOG_CONTROL_FILE);
763 :
764 4 : snprintf(old_path, sizeof(old_path), "%s/%s", old_cluster.pgdata, XLOG_CONTROL_FILE);
765 4 : snprintf(new_path, sizeof(new_path), "%s/%s.old", old_cluster.pgdata, XLOG_CONTROL_FILE);
766 4 : if (pg_mv_file(old_path, new_path) != 0)
767 0 : pg_fatal("could not rename file \"%s\" to \"%s\": %m",
768 : old_path, new_path);
769 4 : check_ok();
770 :
771 4 : if (transfer_mode == TRANSFER_MODE_LINK)
772 : /* translator: %s/%s is the file path of the control file */
773 2 : 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 2 : else if (transfer_mode == TRANSFER_MODE_SWAP)
780 2 : 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 0 : pg_fatal("unrecognized transfer mode");
785 4 : }
|
