Line data Source code
1 : /*-------------------------------------------------------------------------
2 : *
3 : * pg_waldump.c - decode and display WAL
4 : *
5 : * Copyright (c) 2013-2024, PostgreSQL Global Development Group
6 : *
7 : * IDENTIFICATION
8 : * src/bin/pg_waldump/pg_waldump.c
9 : *-------------------------------------------------------------------------
10 : */
11 :
12 : #define FRONTEND 1
13 : #include "postgres.h"
14 :
15 : #include <dirent.h>
16 : #include <limits.h>
17 : #include <signal.h>
18 : #include <sys/stat.h>
19 : #include <unistd.h>
20 :
21 : #include "access/transam.h"
22 : #include "access/xlog_internal.h"
23 : #include "access/xlogreader.h"
24 : #include "access/xlogrecord.h"
25 : #include "access/xlogstats.h"
26 : #include "common/fe_memutils.h"
27 : #include "common/file_perm.h"
28 : #include "common/file_utils.h"
29 : #include "common/logging.h"
30 : #include "common/relpath.h"
31 : #include "getopt_long.h"
32 : #include "rmgrdesc.h"
33 : #include "storage/bufpage.h"
34 :
35 : /*
36 : * NOTE: For any code change or issue fix here, it is highly recommended to
37 : * give a thought about doing the same in pg_walinspect contrib module as well.
38 : */
39 :
40 : static const char *progname;
41 :
42 : static int WalSegSz;
43 : static volatile sig_atomic_t time_to_stop = false;
44 :
45 : static const RelFileLocator emptyRelFileLocator = {0, 0, 0};
46 :
47 : typedef struct XLogDumpPrivate
48 : {
49 : TimeLineID timeline;
50 : XLogRecPtr startptr;
51 : XLogRecPtr endptr;
52 : bool endptr_reached;
53 : } XLogDumpPrivate;
54 :
55 : typedef struct XLogDumpConfig
56 : {
57 : /* display options */
58 : bool quiet;
59 : bool bkp_details;
60 : int stop_after_records;
61 : int already_displayed_records;
62 : bool follow;
63 : bool stats;
64 : bool stats_per_record;
65 :
66 : /* filter options */
67 : bool filter_by_rmgr[RM_MAX_ID + 1];
68 : bool filter_by_rmgr_enabled;
69 : TransactionId filter_by_xid;
70 : bool filter_by_xid_enabled;
71 : RelFileLocator filter_by_relation;
72 : bool filter_by_extended;
73 : bool filter_by_relation_enabled;
74 : BlockNumber filter_by_relation_block;
75 : bool filter_by_relation_block_enabled;
76 : ForkNumber filter_by_relation_forknum;
77 : bool filter_by_fpw;
78 :
79 : /* save options */
80 : char *save_fullpage_path;
81 : } XLogDumpConfig;
82 :
83 :
84 : /*
85 : * When sigint is called, just tell the system to exit at the next possible
86 : * moment.
87 : */
88 : #ifndef WIN32
89 :
90 : static void
91 0 : sigint_handler(SIGNAL_ARGS)
92 : {
93 0 : time_to_stop = true;
94 0 : }
95 : #endif
96 :
97 : static void
98 2 : print_rmgr_list(void)
99 : {
100 : int i;
101 :
102 46 : for (i = 0; i <= RM_MAX_BUILTIN_ID; i++)
103 : {
104 44 : printf("%s\n", GetRmgrDesc(i)->rm_name);
105 : }
106 2 : }
107 :
108 : /*
109 : * Check whether directory exists and whether we can open it. Keep errno set so
110 : * that the caller can report errors somewhat more accurately.
111 : */
112 : static bool
113 138 : verify_directory(const char *directory)
114 : {
115 138 : DIR *dir = opendir(directory);
116 :
117 138 : if (dir == NULL)
118 2 : return false;
119 136 : closedir(dir);
120 136 : return true;
121 : }
122 :
123 : /*
124 : * Create if necessary the directory storing the full-page images extracted
125 : * from the WAL records read.
126 : */
127 : static void
128 2 : create_fullpage_directory(char *path)
129 : {
130 : int ret;
131 :
132 2 : switch ((ret = pg_check_dir(path)))
133 : {
134 2 : case 0:
135 : /* Does not exist, so create it */
136 2 : if (pg_mkdir_p(path, pg_dir_create_mode) < 0)
137 0 : pg_fatal("could not create directory \"%s\": %m", path);
138 2 : break;
139 0 : case 1:
140 : /* Present and empty, so do nothing */
141 0 : break;
142 0 : case 2:
143 : case 3:
144 : case 4:
145 : /* Exists and not empty */
146 0 : pg_fatal("directory \"%s\" exists but is not empty", path);
147 : break;
148 0 : default:
149 : /* Trouble accessing directory */
150 0 : pg_fatal("could not access directory \"%s\": %m", path);
151 : }
152 2 : }
153 :
154 : /*
155 : * Split a pathname as dirname(1) and basename(1) would.
156 : *
157 : * XXX this probably doesn't do very well on Windows. We probably need to
158 : * apply canonicalize_path(), at the very least.
159 : */
160 : static void
161 18 : split_path(const char *path, char **dir, char **fname)
162 : {
163 : char *sep;
164 :
165 : /* split filepath into directory & filename */
166 18 : sep = strrchr(path, '/');
167 :
168 : /* directory path */
169 18 : if (sep != NULL)
170 : {
171 14 : *dir = pnstrdup(path, sep - path);
172 14 : *fname = pg_strdup(sep + 1);
173 : }
174 : /* local directory */
175 : else
176 : {
177 4 : *dir = NULL;
178 4 : *fname = pg_strdup(path);
179 : }
180 18 : }
181 :
182 : /*
183 : * Open the file in the valid target directory.
184 : *
185 : * return a read only fd
186 : */
187 : static int
188 290 : open_file_in_directory(const char *directory, const char *fname)
189 : {
190 290 : int fd = -1;
191 : char fpath[MAXPGPATH];
192 :
193 : Assert(directory != NULL);
194 :
195 290 : snprintf(fpath, MAXPGPATH, "%s/%s", directory, fname);
196 290 : fd = open(fpath, O_RDONLY | PG_BINARY, 0);
197 :
198 290 : if (fd < 0 && errno != ENOENT)
199 0 : pg_fatal("could not open file \"%s\": %m", fname);
200 290 : return fd;
201 : }
202 :
203 : /*
204 : * Try to find fname in the given directory. Returns true if it is found,
205 : * false otherwise. If fname is NULL, search the complete directory for any
206 : * file with a valid WAL file name. If file is successfully opened, set the
207 : * wal segment size.
208 : */
209 : static bool
210 166 : search_directory(const char *directory, const char *fname)
211 : {
212 166 : int fd = -1;
213 : DIR *xldir;
214 :
215 : /* open file if valid filename is provided */
216 166 : if (fname != NULL)
217 16 : fd = open_file_in_directory(directory, fname);
218 :
219 : /*
220 : * A valid file name is not passed, so search the complete directory. If
221 : * we find any file whose name is a valid WAL file name then try to open
222 : * it. If we cannot open it, bail out.
223 : */
224 150 : else if ((xldir = opendir(directory)) != NULL)
225 : {
226 : struct dirent *xlde;
227 :
228 1104 : while ((xlde = readdir(xldir)) != NULL)
229 : {
230 1078 : if (IsXLogFileName(xlde->d_name))
231 : {
232 124 : fd = open_file_in_directory(directory, xlde->d_name);
233 124 : fname = pg_strdup(xlde->d_name);
234 124 : break;
235 : }
236 : }
237 :
238 150 : closedir(xldir);
239 : }
240 :
241 : /* set WalSegSz if file is successfully opened */
242 166 : if (fd >= 0)
243 : {
244 : PGAlignedXLogBlock buf;
245 : int r;
246 :
247 136 : r = read(fd, buf.data, XLOG_BLCKSZ);
248 136 : if (r == XLOG_BLCKSZ)
249 : {
250 136 : XLogLongPageHeader longhdr = (XLogLongPageHeader) buf.data;
251 :
252 136 : WalSegSz = longhdr->xlp_seg_size;
253 :
254 136 : if (!IsValidWalSegSize(WalSegSz))
255 : {
256 2 : pg_log_error(ngettext("invalid WAL segment size in WAL file \"%s\" (%d byte)",
257 : "invalid WAL segment size in WAL file \"%s\" (%d bytes)",
258 : WalSegSz),
259 : fname, WalSegSz);
260 2 : pg_log_error_detail("The WAL segment size must be a power of two between 1 MB and 1 GB.");
261 2 : exit(1);
262 : }
263 : }
264 0 : else if (r < 0)
265 0 : pg_fatal("could not read file \"%s\": %m",
266 : fname);
267 : else
268 0 : pg_fatal("could not read file \"%s\": read %d of %d",
269 : fname, r, XLOG_BLCKSZ);
270 134 : close(fd);
271 134 : return true;
272 : }
273 :
274 30 : return false;
275 : }
276 :
277 : /*
278 : * Identify the target directory.
279 : *
280 : * Try to find the file in several places:
281 : * if directory != NULL:
282 : * directory /
283 : * directory / XLOGDIR /
284 : * else
285 : * .
286 : * XLOGDIR /
287 : * $PGDATA / XLOGDIR /
288 : *
289 : * The valid target directory is returned.
290 : */
291 : static char *
292 138 : identify_target_directory(char *directory, char *fname)
293 : {
294 : char fpath[MAXPGPATH];
295 :
296 138 : if (directory != NULL)
297 : {
298 136 : if (search_directory(directory, fname))
299 108 : return pg_strdup(directory);
300 :
301 : /* directory / XLOGDIR */
302 26 : snprintf(fpath, MAXPGPATH, "%s/%s", directory, XLOGDIR);
303 26 : if (search_directory(fpath, fname))
304 26 : return pg_strdup(fpath);
305 : }
306 : else
307 : {
308 : const char *datadir;
309 :
310 : /* current directory */
311 2 : if (search_directory(".", fname))
312 0 : return pg_strdup(".");
313 : /* XLOGDIR */
314 2 : if (search_directory(XLOGDIR, fname))
315 0 : return pg_strdup(XLOGDIR);
316 :
317 2 : datadir = getenv("PGDATA");
318 : /* $PGDATA / XLOGDIR */
319 2 : if (datadir != NULL)
320 : {
321 0 : snprintf(fpath, MAXPGPATH, "%s/%s", datadir, XLOGDIR);
322 0 : if (search_directory(fpath, fname))
323 0 : return pg_strdup(fpath);
324 : }
325 : }
326 :
327 : /* could not locate WAL file */
328 2 : if (fname)
329 2 : pg_fatal("could not locate WAL file \"%s\"", fname);
330 : else
331 0 : pg_fatal("could not find any WAL file");
332 :
333 : return NULL; /* not reached */
334 : }
335 :
336 : /* pg_waldump's XLogReaderRoutine->segment_open callback */
337 : static void
338 134 : WALDumpOpenSegment(XLogReaderState *state, XLogSegNo nextSegNo,
339 : TimeLineID *tli_p)
340 : {
341 134 : TimeLineID tli = *tli_p;
342 : char fname[MAXPGPATH];
343 : int tries;
344 :
345 134 : XLogFileName(fname, tli, nextSegNo, state->segcxt.ws_segsize);
346 :
347 : /*
348 : * In follow mode there is a short period of time after the server has
349 : * written the end of the previous file before the new file is available.
350 : * So we loop for 5 seconds looking for the file to appear before giving
351 : * up.
352 : */
353 134 : for (tries = 0; tries < 10; tries++)
354 : {
355 134 : state->seg.ws_file = open_file_in_directory(state->segcxt.ws_dir, fname);
356 134 : if (state->seg.ws_file >= 0)
357 134 : return;
358 0 : if (errno == ENOENT)
359 : {
360 0 : int save_errno = errno;
361 :
362 : /* File not there yet, try again */
363 0 : pg_usleep(500 * 1000);
364 :
365 0 : errno = save_errno;
366 0 : continue;
367 : }
368 : /* Any other error, fall through and fail */
369 0 : break;
370 : }
371 :
372 0 : pg_fatal("could not find file \"%s\": %m", fname);
373 : }
374 :
375 : /*
376 : * pg_waldump's XLogReaderRoutine->segment_close callback. Same as
377 : * wal_segment_close
378 : */
379 : static void
380 130 : WALDumpCloseSegment(XLogReaderState *state)
381 : {
382 130 : close(state->seg.ws_file);
383 : /* need to check errno? */
384 130 : state->seg.ws_file = -1;
385 130 : }
386 :
387 : /* pg_waldump's XLogReaderRoutine->page_read callback */
388 : static int
389 36876 : WALDumpReadPage(XLogReaderState *state, XLogRecPtr targetPagePtr, int reqLen,
390 : XLogRecPtr targetPtr, char *readBuff)
391 : {
392 36876 : XLogDumpPrivate *private = state->private_data;
393 36876 : int count = XLOG_BLCKSZ;
394 : WALReadError errinfo;
395 :
396 36876 : if (private->endptr != InvalidXLogRecPtr)
397 : {
398 32980 : if (targetPagePtr + XLOG_BLCKSZ <= private->endptr)
399 32742 : count = XLOG_BLCKSZ;
400 238 : else if (targetPagePtr + reqLen <= private->endptr)
401 114 : count = private->endptr - targetPagePtr;
402 : else
403 : {
404 124 : private->endptr_reached = true;
405 124 : return -1;
406 : }
407 : }
408 :
409 36752 : if (!WALRead(state, readBuff, targetPagePtr, count, private->timeline,
410 : &errinfo))
411 : {
412 0 : WALOpenSegment *seg = &errinfo.wre_seg;
413 : char fname[MAXPGPATH];
414 :
415 0 : XLogFileName(fname, seg->ws_tli, seg->ws_segno,
416 : state->segcxt.ws_segsize);
417 :
418 0 : if (errinfo.wre_errno != 0)
419 : {
420 0 : errno = errinfo.wre_errno;
421 0 : pg_fatal("could not read from file \"%s\", offset %d: %m",
422 : fname, errinfo.wre_off);
423 : }
424 : else
425 0 : pg_fatal("could not read from file \"%s\", offset %d: read %d of %d",
426 : fname, errinfo.wre_off, errinfo.wre_read,
427 : errinfo.wre_req);
428 : }
429 :
430 36752 : return count;
431 : }
432 :
433 : /*
434 : * Boolean to return whether the given WAL record matches a specific relation
435 : * and optionally block.
436 : */
437 : static bool
438 255520 : XLogRecordMatchesRelationBlock(XLogReaderState *record,
439 : RelFileLocator matchRlocator,
440 : BlockNumber matchBlock,
441 : ForkNumber matchFork)
442 : {
443 : int block_id;
444 :
445 538358 : for (block_id = 0; block_id <= XLogRecMaxBlockId(record); block_id++)
446 : {
447 : RelFileLocator rlocator;
448 : ForkNumber forknum;
449 : BlockNumber blk;
450 :
451 283254 : if (!XLogRecGetBlockTagExtended(record, block_id,
452 : &rlocator, &forknum, &blk, NULL))
453 80 : continue;
454 :
455 283174 : if ((matchFork == InvalidForkNumber || matchFork == forknum) &&
456 204822 : (RelFileLocatorEquals(matchRlocator, emptyRelFileLocator) ||
457 204822 : RelFileLocatorEquals(matchRlocator, rlocator)) &&
458 8 : (matchBlock == InvalidBlockNumber || matchBlock == blk))
459 416 : return true;
460 : }
461 :
462 255104 : return false;
463 : }
464 :
465 : /*
466 : * Boolean to return whether the given WAL record contains a full page write.
467 : */
468 : static bool
469 68990 : XLogRecordHasFPW(XLogReaderState *record)
470 : {
471 : int block_id;
472 :
473 145174 : for (block_id = 0; block_id <= XLogRecMaxBlockId(record); block_id++)
474 : {
475 78322 : if (!XLogRecHasBlockRef(record, block_id))
476 14 : continue;
477 :
478 78308 : if (XLogRecHasBlockImage(record, block_id))
479 2138 : return true;
480 : }
481 :
482 66852 : return false;
483 : }
484 :
485 : /*
486 : * Function to externally save all FPWs stored in the given WAL record.
487 : * Decompression is applied to all the blocks saved, if necessary.
488 : */
489 : static void
490 402 : XLogRecordSaveFPWs(XLogReaderState *record, const char *savepath)
491 : {
492 : int block_id;
493 :
494 804 : for (block_id = 0; block_id <= XLogRecMaxBlockId(record); block_id++)
495 : {
496 : PGAlignedBlock buf;
497 : Page page;
498 : char filename[MAXPGPATH];
499 : char forkname[FORKNAMECHARS + 2]; /* _ + terminating zero */
500 : FILE *file;
501 : BlockNumber blk;
502 : RelFileLocator rnode;
503 : ForkNumber fork;
504 :
505 402 : if (!XLogRecHasBlockRef(record, block_id))
506 400 : continue;
507 :
508 402 : if (!XLogRecHasBlockImage(record, block_id))
509 400 : continue;
510 :
511 2 : page = (Page) buf.data;
512 :
513 : /* Full page exists, so let's save it */
514 2 : if (!RestoreBlockImage(record, block_id, page))
515 0 : pg_fatal("%s", record->errormsg_buf);
516 :
517 2 : (void) XLogRecGetBlockTagExtended(record, block_id,
518 : &rnode, &fork, &blk, NULL);
519 :
520 2 : if (fork >= 0 && fork <= MAX_FORKNUM)
521 2 : sprintf(forkname, "_%s", forkNames[fork]);
522 : else
523 0 : pg_fatal("invalid fork number: %u", fork);
524 :
525 2 : snprintf(filename, MAXPGPATH, "%s/%08X-%08X-%08X.%u.%u.%u.%u%s", savepath,
526 : record->seg.ws_tli,
527 2 : LSN_FORMAT_ARGS(record->ReadRecPtr),
528 : rnode.spcOid, rnode.dbOid, rnode.relNumber, blk, forkname);
529 :
530 2 : file = fopen(filename, PG_BINARY_W);
531 2 : if (!file)
532 0 : pg_fatal("could not open file \"%s\": %m", filename);
533 :
534 2 : if (fwrite(page, BLCKSZ, 1, file) != 1)
535 0 : pg_fatal("could not write file \"%s\": %m", filename);
536 :
537 2 : if (fclose(file) != 0)
538 0 : pg_fatal("could not close file \"%s\": %m", filename);
539 : }
540 402 : }
541 :
542 : /*
543 : * Print a record to stdout
544 : */
545 : static void
546 514204 : XLogDumpDisplayRecord(XLogDumpConfig *config, XLogReaderState *record)
547 : {
548 : const char *id;
549 514204 : const RmgrDescData *desc = GetRmgrDesc(XLogRecGetRmid(record));
550 : uint32 rec_len;
551 : uint32 fpi_len;
552 514204 : uint8 info = XLogRecGetInfo(record);
553 514204 : XLogRecPtr xl_prev = XLogRecGetPrev(record);
554 : StringInfoData s;
555 :
556 514204 : XLogRecGetLen(record, &rec_len, &fpi_len);
557 :
558 514204 : printf("rmgr: %-11s len (rec/tot): %6u/%6u, tx: %10u, lsn: %X/%08X, prev %X/%08X, ",
559 : desc->rm_name,
560 : rec_len, XLogRecGetTotalLen(record),
561 : XLogRecGetXid(record),
562 : LSN_FORMAT_ARGS(record->ReadRecPtr),
563 : LSN_FORMAT_ARGS(xl_prev));
564 :
565 514204 : id = desc->rm_identify(info);
566 514204 : if (id == NULL)
567 0 : printf("desc: UNKNOWN (%x) ", info & ~XLR_INFO_MASK);
568 : else
569 514204 : printf("desc: %s ", id);
570 :
571 514204 : initStringInfo(&s);
572 514204 : desc->rm_desc(&s, record);
573 514204 : printf("%s", s.data);
574 :
575 514204 : resetStringInfo(&s);
576 514204 : XLogRecGetBlockRefInfo(record, true, config->bkp_details, &s, NULL);
577 514204 : printf("%s", s.data);
578 514204 : pfree(s.data);
579 514204 : }
580 :
581 : /*
582 : * Display a single row of record counts and sizes for an rmgr or record.
583 : */
584 : static void
585 160 : XLogDumpStatsRow(const char *name,
586 : uint64 n, uint64 total_count,
587 : uint64 rec_len, uint64 total_rec_len,
588 : uint64 fpi_len, uint64 total_fpi_len,
589 : uint64 tot_len, uint64 total_len)
590 : {
591 : double n_pct,
592 : rec_len_pct,
593 : fpi_len_pct,
594 : tot_len_pct;
595 :
596 160 : n_pct = 0;
597 160 : if (total_count != 0)
598 160 : n_pct = 100 * (double) n / total_count;
599 :
600 160 : rec_len_pct = 0;
601 160 : if (total_rec_len != 0)
602 160 : rec_len_pct = 100 * (double) rec_len / total_rec_len;
603 :
604 160 : fpi_len_pct = 0;
605 160 : if (total_fpi_len != 0)
606 160 : fpi_len_pct = 100 * (double) fpi_len / total_fpi_len;
607 :
608 160 : tot_len_pct = 0;
609 160 : if (total_len != 0)
610 160 : tot_len_pct = 100 * (double) tot_len / total_len;
611 :
612 160 : printf("%-27s "
613 : "%20" INT64_MODIFIER "u (%6.02f) "
614 : "%20" INT64_MODIFIER "u (%6.02f) "
615 : "%20" INT64_MODIFIER "u (%6.02f) "
616 : "%20" INT64_MODIFIER "u (%6.02f)\n",
617 : name, n, n_pct, rec_len, rec_len_pct, fpi_len, fpi_len_pct,
618 : tot_len, tot_len_pct);
619 160 : }
620 :
621 :
622 : /*
623 : * Display summary statistics about the records seen so far.
624 : */
625 : static void
626 4 : XLogDumpDisplayStats(XLogDumpConfig *config, XLogStats *stats)
627 : {
628 : int ri,
629 : rj;
630 4 : uint64 total_count = 0;
631 4 : uint64 total_rec_len = 0;
632 4 : uint64 total_fpi_len = 0;
633 4 : uint64 total_len = 0;
634 : double rec_len_pct,
635 : fpi_len_pct;
636 :
637 : /*
638 : * Leave if no stats have been computed yet, as tracked by the end LSN.
639 : */
640 4 : if (XLogRecPtrIsInvalid(stats->endptr))
641 0 : return;
642 :
643 : /*
644 : * Each row shows its percentages of the total, so make a first pass to
645 : * calculate column totals.
646 : */
647 :
648 1028 : for (ri = 0; ri <= RM_MAX_ID; ri++)
649 : {
650 1024 : if (!RmgrIdIsValid(ri))
651 424 : continue;
652 :
653 600 : total_count += stats->rmgr_stats[ri].count;
654 600 : total_rec_len += stats->rmgr_stats[ri].rec_len;
655 600 : total_fpi_len += stats->rmgr_stats[ri].fpi_len;
656 : }
657 4 : total_len = total_rec_len + total_fpi_len;
658 :
659 4 : printf("WAL statistics between %X/%X and %X/%X:\n",
660 : LSN_FORMAT_ARGS(stats->startptr), LSN_FORMAT_ARGS(stats->endptr));
661 :
662 : /*
663 : * 27 is strlen("Transaction/COMMIT_PREPARED"), 20 is strlen(2^64), 8 is
664 : * strlen("(100.00%)")
665 : */
666 :
667 4 : printf("%-27s %20s %8s %20s %8s %20s %8s %20s %8s\n"
668 : "%-27s %20s %8s %20s %8s %20s %8s %20s %8s\n",
669 : "Type", "N", "(%)", "Record size", "(%)", "FPI size", "(%)", "Combined size", "(%)",
670 : "----", "-", "---", "-----------", "---", "--------", "---", "-------------", "---");
671 :
672 1028 : for (ri = 0; ri <= RM_MAX_ID; ri++)
673 : {
674 : uint64 count,
675 : rec_len,
676 : fpi_len,
677 : tot_len;
678 : const RmgrDescData *desc;
679 :
680 1024 : if (!RmgrIdIsValid(ri))
681 424 : continue;
682 :
683 600 : desc = GetRmgrDesc(ri);
684 :
685 600 : if (!config->stats_per_record)
686 : {
687 300 : count = stats->rmgr_stats[ri].count;
688 300 : rec_len = stats->rmgr_stats[ri].rec_len;
689 300 : fpi_len = stats->rmgr_stats[ri].fpi_len;
690 300 : tot_len = rec_len + fpi_len;
691 :
692 300 : if (RmgrIdIsCustom(ri) && count == 0)
693 256 : continue;
694 :
695 44 : XLogDumpStatsRow(desc->rm_name,
696 : count, total_count, rec_len, total_rec_len,
697 : fpi_len, total_fpi_len, tot_len, total_len);
698 : }
699 : else
700 : {
701 5100 : for (rj = 0; rj < MAX_XLINFO_TYPES; rj++)
702 : {
703 : const char *id;
704 :
705 4800 : count = stats->record_stats[ri][rj].count;
706 4800 : rec_len = stats->record_stats[ri][rj].rec_len;
707 4800 : fpi_len = stats->record_stats[ri][rj].fpi_len;
708 4800 : tot_len = rec_len + fpi_len;
709 :
710 : /* Skip undefined combinations and ones that didn't occur */
711 4800 : if (count == 0)
712 4684 : continue;
713 :
714 : /* the upper four bits in xl_info are the rmgr's */
715 116 : id = desc->rm_identify(rj << 4);
716 116 : if (id == NULL)
717 0 : id = psprintf("UNKNOWN (%x)", rj << 4);
718 :
719 116 : XLogDumpStatsRow(psprintf("%s/%s", desc->rm_name, id),
720 : count, total_count, rec_len, total_rec_len,
721 : fpi_len, total_fpi_len, tot_len, total_len);
722 : }
723 : }
724 : }
725 :
726 4 : printf("%-27s %20s %8s %20s %8s %20s %8s %20s\n",
727 : "", "--------", "", "--------", "", "--------", "", "--------");
728 :
729 : /*
730 : * The percentages in earlier rows were calculated against the column
731 : * total, but the ones that follow are against the row total. Note that
732 : * these are displayed with a % symbol to differentiate them from the
733 : * earlier ones, and are thus up to 9 characters long.
734 : */
735 :
736 4 : rec_len_pct = 0;
737 4 : if (total_len != 0)
738 4 : rec_len_pct = 100 * (double) total_rec_len / total_len;
739 :
740 4 : fpi_len_pct = 0;
741 4 : if (total_len != 0)
742 4 : fpi_len_pct = 100 * (double) total_fpi_len / total_len;
743 :
744 4 : printf("%-27s "
745 : "%20" INT64_MODIFIER "u %-9s"
746 : "%20" INT64_MODIFIER "u %-9s"
747 : "%20" INT64_MODIFIER "u %-9s"
748 : "%20" INT64_MODIFIER "u %-6s\n",
749 : "Total", stats->count, "",
750 : total_rec_len, psprintf("[%.02f%%]", rec_len_pct),
751 : total_fpi_len, psprintf("[%.02f%%]", fpi_len_pct),
752 : total_len, "[100%]");
753 : }
754 :
755 : static void
756 2 : usage(void)
757 : {
758 2 : printf(_("%s decodes and displays PostgreSQL write-ahead logs for debugging.\n\n"),
759 : progname);
760 2 : printf(_("Usage:\n"));
761 2 : printf(_(" %s [OPTION]... [STARTSEG [ENDSEG]]\n"), progname);
762 2 : printf(_("\nOptions:\n"));
763 2 : printf(_(" -b, --bkp-details output detailed information about backup blocks\n"));
764 2 : printf(_(" -B, --block=N with --relation, only show records that modify block N\n"));
765 2 : printf(_(" -e, --end=RECPTR stop reading at WAL location RECPTR\n"));
766 2 : printf(_(" -f, --follow keep retrying after reaching end of WAL\n"));
767 2 : printf(_(" -F, --fork=FORK only show records that modify blocks in fork FORK;\n"
768 : " valid names are main, fsm, vm, init\n"));
769 2 : printf(_(" -n, --limit=N number of records to display\n"));
770 2 : printf(_(" -p, --path=PATH directory in which to find WAL segment files or a\n"
771 : " directory with a ./pg_wal that contains such files\n"
772 : " (default: current directory, ./pg_wal, $PGDATA/pg_wal)\n"));
773 2 : printf(_(" -q, --quiet do not print any output, except for errors\n"));
774 2 : printf(_(" -r, --rmgr=RMGR only show records generated by resource manager RMGR;\n"
775 : " use --rmgr=list to list valid resource manager names\n"));
776 2 : printf(_(" -R, --relation=T/D/R only show records that modify blocks in relation T/D/R\n"));
777 2 : printf(_(" -s, --start=RECPTR start reading at WAL location RECPTR\n"));
778 2 : printf(_(" -t, --timeline=TLI timeline from which to read WAL records\n"
779 : " (default: 1 or the value used in STARTSEG)\n"));
780 2 : printf(_(" -V, --version output version information, then exit\n"));
781 2 : printf(_(" -w, --fullpage only show records with a full page write\n"));
782 2 : printf(_(" -x, --xid=XID only show records with transaction ID XID\n"));
783 2 : printf(_(" -z, --stats[=record] show statistics instead of records\n"
784 : " (optionally, show per-record statistics)\n"));
785 2 : printf(_(" --save-fullpage=DIR save full page images to DIR\n"));
786 2 : printf(_(" -?, --help show this help, then exit\n"));
787 2 : printf(_("\nReport bugs to <%s>.\n"), PACKAGE_BUGREPORT);
788 2 : printf(_("%s home page: <%s>\n"), PACKAGE_NAME, PACKAGE_URL);
789 2 : }
790 :
791 : int
792 340 : main(int argc, char **argv)
793 : {
794 : uint32 xlogid;
795 : uint32 xrecoff;
796 : XLogReaderState *xlogreader_state;
797 : XLogDumpPrivate private;
798 : XLogDumpConfig config;
799 : XLogStats stats;
800 : XLogRecord *record;
801 : XLogRecPtr first_record;
802 340 : char *waldir = NULL;
803 : char *errormsg;
804 :
805 : static struct option long_options[] = {
806 : {"bkp-details", no_argument, NULL, 'b'},
807 : {"block", required_argument, NULL, 'B'},
808 : {"end", required_argument, NULL, 'e'},
809 : {"follow", no_argument, NULL, 'f'},
810 : {"fork", required_argument, NULL, 'F'},
811 : {"fullpage", no_argument, NULL, 'w'},
812 : {"help", no_argument, NULL, '?'},
813 : {"limit", required_argument, NULL, 'n'},
814 : {"path", required_argument, NULL, 'p'},
815 : {"quiet", no_argument, NULL, 'q'},
816 : {"relation", required_argument, NULL, 'R'},
817 : {"rmgr", required_argument, NULL, 'r'},
818 : {"start", required_argument, NULL, 's'},
819 : {"timeline", required_argument, NULL, 't'},
820 : {"xid", required_argument, NULL, 'x'},
821 : {"version", no_argument, NULL, 'V'},
822 : {"stats", optional_argument, NULL, 'z'},
823 : {"save-fullpage", required_argument, NULL, 1},
824 : {NULL, 0, NULL, 0}
825 : };
826 :
827 : int option;
828 340 : int optindex = 0;
829 :
830 : #ifndef WIN32
831 340 : pqsignal(SIGINT, sigint_handler);
832 : #endif
833 :
834 340 : pg_logging_init(argv[0]);
835 340 : set_pglocale_pgservice(argv[0], PG_TEXTDOMAIN("pg_waldump"));
836 340 : progname = get_progname(argv[0]);
837 :
838 340 : if (argc > 1)
839 : {
840 338 : if (strcmp(argv[1], "--help") == 0 || strcmp(argv[1], "-?") == 0)
841 : {
842 2 : usage();
843 2 : exit(0);
844 : }
845 336 : if (strcmp(argv[1], "--version") == 0 || strcmp(argv[1], "-V") == 0)
846 : {
847 176 : puts("pg_waldump (PostgreSQL) " PG_VERSION);
848 176 : exit(0);
849 : }
850 : }
851 :
852 162 : memset(&private, 0, sizeof(XLogDumpPrivate));
853 162 : memset(&config, 0, sizeof(XLogDumpConfig));
854 162 : memset(&stats, 0, sizeof(XLogStats));
855 :
856 162 : private.timeline = 1;
857 162 : private.startptr = InvalidXLogRecPtr;
858 162 : private.endptr = InvalidXLogRecPtr;
859 162 : private.endptr_reached = false;
860 :
861 162 : config.quiet = false;
862 162 : config.bkp_details = false;
863 162 : config.stop_after_records = -1;
864 162 : config.already_displayed_records = 0;
865 162 : config.follow = false;
866 : /* filter_by_rmgr array was zeroed by memset above */
867 162 : config.filter_by_rmgr_enabled = false;
868 162 : config.filter_by_xid = InvalidTransactionId;
869 162 : config.filter_by_xid_enabled = false;
870 162 : config.filter_by_extended = false;
871 162 : config.filter_by_relation_enabled = false;
872 162 : config.filter_by_relation_block_enabled = false;
873 162 : config.filter_by_relation_forknum = InvalidForkNumber;
874 162 : config.filter_by_fpw = false;
875 162 : config.save_fullpage_path = NULL;
876 162 : config.stats = false;
877 162 : config.stats_per_record = false;
878 :
879 162 : stats.startptr = InvalidXLogRecPtr;
880 162 : stats.endptr = InvalidXLogRecPtr;
881 :
882 162 : if (argc <= 1)
883 : {
884 2 : pg_log_error("no arguments specified");
885 2 : goto bad_argument;
886 : }
887 :
888 760 : while ((option = getopt_long(argc, argv, "bB:e:fF:n:p:qr:R:s:t:wx:z",
889 : long_options, &optindex)) != -1)
890 : {
891 618 : switch (option)
892 : {
893 0 : case 'b':
894 0 : config.bkp_details = true;
895 0 : break;
896 4 : case 'B':
897 4 : if (sscanf(optarg, "%u", &config.filter_by_relation_block) != 1 ||
898 2 : !BlockNumberIsValid(config.filter_by_relation_block))
899 : {
900 2 : pg_log_error("invalid block number: \"%s\"", optarg);
901 2 : goto bad_argument;
902 : }
903 2 : config.filter_by_relation_block_enabled = true;
904 2 : config.filter_by_extended = true;
905 2 : break;
906 122 : case 'e':
907 122 : if (sscanf(optarg, "%X/%X", &xlogid, &xrecoff) != 2)
908 : {
909 2 : pg_log_error("invalid WAL location: \"%s\"",
910 : optarg);
911 2 : goto bad_argument;
912 : }
913 120 : private.endptr = (uint64) xlogid << 32 | xrecoff;
914 120 : break;
915 0 : case 'f':
916 0 : config.follow = true;
917 0 : break;
918 4 : case 'F':
919 4 : config.filter_by_relation_forknum = forkname_to_number(optarg);
920 4 : if (config.filter_by_relation_forknum == InvalidForkNumber)
921 : {
922 2 : pg_log_error("invalid fork name: \"%s\"", optarg);
923 2 : goto bad_argument;
924 : }
925 2 : config.filter_by_extended = true;
926 2 : break;
927 4 : case 'n':
928 4 : if (sscanf(optarg, "%d", &config.stop_after_records) != 1)
929 : {
930 2 : pg_log_error("invalid value \"%s\" for option %s", optarg, "-n/--limit");
931 2 : goto bad_argument;
932 : }
933 2 : break;
934 126 : case 'p':
935 126 : waldir = pg_strdup(optarg);
936 126 : break;
937 106 : case 'q':
938 106 : config.quiet = true;
939 106 : break;
940 6 : case 'r':
941 : {
942 : int rmid;
943 :
944 6 : if (pg_strcasecmp(optarg, "list") == 0)
945 : {
946 2 : print_rmgr_list();
947 2 : exit(EXIT_SUCCESS);
948 : }
949 :
950 : /*
951 : * First look for the generated name of a custom rmgr, of
952 : * the form "custom###". We accept this form, because the
953 : * custom rmgr module is not loaded, so there's no way to
954 : * know the real name. This convention should be
955 : * consistent with that in rmgrdesc.c.
956 : */
957 4 : if (sscanf(optarg, "custom%03d", &rmid) == 1)
958 : {
959 0 : if (!RmgrIdIsCustom(rmid))
960 : {
961 0 : pg_log_error("custom resource manager \"%s\" does not exist",
962 : optarg);
963 2 : goto bad_argument;
964 : }
965 0 : config.filter_by_rmgr[rmid] = true;
966 0 : config.filter_by_rmgr_enabled = true;
967 : }
968 : else
969 : {
970 : /* then look for builtin rmgrs */
971 70 : for (rmid = 0; rmid <= RM_MAX_BUILTIN_ID; rmid++)
972 : {
973 68 : if (pg_strcasecmp(optarg, GetRmgrDesc(rmid)->rm_name) == 0)
974 : {
975 2 : config.filter_by_rmgr[rmid] = true;
976 2 : config.filter_by_rmgr_enabled = true;
977 2 : break;
978 : }
979 : }
980 4 : if (rmid > RM_MAX_BUILTIN_ID)
981 : {
982 2 : pg_log_error("resource manager \"%s\" does not exist",
983 : optarg);
984 2 : goto bad_argument;
985 : }
986 : }
987 : }
988 2 : break;
989 8 : case 'R':
990 8 : if (sscanf(optarg, "%u/%u/%u",
991 : &config.filter_by_relation.spcOid,
992 : &config.filter_by_relation.dbOid,
993 6 : &config.filter_by_relation.relNumber) != 3 ||
994 6 : !OidIsValid(config.filter_by_relation.spcOid) ||
995 6 : !RelFileNumberIsValid(config.filter_by_relation.relNumber))
996 : {
997 2 : pg_log_error("invalid relation specification: \"%s\"", optarg);
998 2 : pg_log_error_detail("Expecting \"tablespace OID/database OID/relation filenode\".");
999 2 : goto bad_argument;
1000 : }
1001 6 : config.filter_by_relation_enabled = true;
1002 6 : config.filter_by_extended = true;
1003 6 : break;
1004 128 : case 's':
1005 128 : if (sscanf(optarg, "%X/%X", &xlogid, &xrecoff) != 2)
1006 : {
1007 2 : pg_log_error("invalid WAL location: \"%s\"",
1008 : optarg);
1009 2 : goto bad_argument;
1010 : }
1011 : else
1012 126 : private.startptr = (uint64) xlogid << 32 | xrecoff;
1013 126 : break;
1014 100 : case 't':
1015 :
1016 : /*
1017 : * This is like option_parse_int() but needs to handle
1018 : * unsigned 32-bit int. Also, we accept both decimal and
1019 : * hexadecimal specifications here.
1020 : */
1021 : {
1022 : char *endptr;
1023 : unsigned long val;
1024 :
1025 100 : errno = 0;
1026 100 : val = strtoul(optarg, &endptr, 0);
1027 :
1028 100 : while (*endptr != '\0' && isspace((unsigned char) *endptr))
1029 0 : endptr++;
1030 :
1031 100 : if (*endptr != '\0')
1032 : {
1033 0 : pg_log_error("invalid value \"%s\" for option %s",
1034 : optarg, "-t/--timeline");
1035 0 : goto bad_argument;
1036 : }
1037 :
1038 100 : if (errno == ERANGE || val < 1 || val > UINT_MAX)
1039 : {
1040 0 : pg_log_error("%s must be in range %u..%u",
1041 : "-t/--timeline", 1, UINT_MAX);
1042 0 : goto bad_argument;
1043 : }
1044 :
1045 100 : private.timeline = val;
1046 :
1047 100 : break;
1048 : }
1049 2 : case 'w':
1050 2 : config.filter_by_fpw = true;
1051 2 : break;
1052 0 : case 'x':
1053 0 : if (sscanf(optarg, "%u", &config.filter_by_xid) != 1)
1054 : {
1055 0 : pg_log_error("invalid transaction ID specification: \"%s\"",
1056 : optarg);
1057 0 : goto bad_argument;
1058 : }
1059 0 : config.filter_by_xid_enabled = true;
1060 0 : break;
1061 4 : case 'z':
1062 4 : config.stats = true;
1063 4 : config.stats_per_record = false;
1064 4 : if (optarg)
1065 : {
1066 2 : if (strcmp(optarg, "record") == 0)
1067 2 : config.stats_per_record = true;
1068 0 : else if (strcmp(optarg, "rmgr") != 0)
1069 : {
1070 0 : pg_log_error("unrecognized value for option %s: %s",
1071 : "--stats", optarg);
1072 0 : goto bad_argument;
1073 : }
1074 : }
1075 4 : break;
1076 2 : case 1:
1077 2 : config.save_fullpage_path = pg_strdup(optarg);
1078 2 : break;
1079 2 : default:
1080 2 : goto bad_argument;
1081 : }
1082 : }
1083 :
1084 142 : if (config.filter_by_relation_block_enabled &&
1085 2 : !config.filter_by_relation_enabled)
1086 : {
1087 0 : pg_log_error("option %s requires option %s to be specified",
1088 : "-B/--block", "-R/--relation");
1089 0 : goto bad_argument;
1090 : }
1091 :
1092 142 : if ((optind + 2) < argc)
1093 : {
1094 2 : pg_log_error("too many command-line arguments (first is \"%s\")",
1095 : argv[optind + 2]);
1096 2 : goto bad_argument;
1097 : }
1098 :
1099 140 : if (waldir != NULL)
1100 : {
1101 : /* validate path points to directory */
1102 126 : if (!verify_directory(waldir))
1103 : {
1104 2 : pg_log_error("could not open directory \"%s\": %m", waldir);
1105 2 : goto bad_argument;
1106 : }
1107 : }
1108 :
1109 138 : if (config.save_fullpage_path != NULL)
1110 2 : create_fullpage_directory(config.save_fullpage_path);
1111 :
1112 : /* parse files as start/end boundaries, extract path if not specified */
1113 138 : if (optind < argc)
1114 : {
1115 14 : char *directory = NULL;
1116 14 : char *fname = NULL;
1117 : int fd;
1118 : XLogSegNo segno;
1119 :
1120 14 : split_path(argv[optind], &directory, &fname);
1121 :
1122 14 : if (waldir == NULL && directory != NULL)
1123 : {
1124 12 : waldir = directory;
1125 :
1126 12 : if (!verify_directory(waldir))
1127 0 : pg_fatal("could not open directory \"%s\": %m", waldir);
1128 : }
1129 :
1130 14 : waldir = identify_target_directory(waldir, fname);
1131 12 : fd = open_file_in_directory(waldir, fname);
1132 12 : if (fd < 0)
1133 0 : pg_fatal("could not open file \"%s\"", fname);
1134 12 : close(fd);
1135 :
1136 : /* parse position from file */
1137 12 : XLogFromFileName(fname, &private.timeline, &segno, WalSegSz);
1138 :
1139 12 : if (XLogRecPtrIsInvalid(private.startptr))
1140 10 : XLogSegNoOffsetToRecPtr(segno, 0, WalSegSz, private.startptr);
1141 2 : else if (!XLByteInSeg(private.startptr, segno, WalSegSz))
1142 : {
1143 0 : pg_log_error("start WAL location %X/%X is not inside file \"%s\"",
1144 : LSN_FORMAT_ARGS(private.startptr),
1145 : fname);
1146 0 : goto bad_argument;
1147 : }
1148 :
1149 : /* no second file specified, set end position */
1150 12 : if (!(optind + 1 < argc) && XLogRecPtrIsInvalid(private.endptr))
1151 8 : XLogSegNoOffsetToRecPtr(segno + 1, 0, WalSegSz, private.endptr);
1152 :
1153 : /* parse ENDSEG if passed */
1154 12 : if (optind + 1 < argc)
1155 : {
1156 : XLogSegNo endsegno;
1157 :
1158 : /* ignore directory, already have that */
1159 4 : split_path(argv[optind + 1], &directory, &fname);
1160 :
1161 4 : fd = open_file_in_directory(waldir, fname);
1162 4 : if (fd < 0)
1163 2 : pg_fatal("could not open file \"%s\"", fname);
1164 2 : close(fd);
1165 :
1166 : /* parse position from file */
1167 2 : XLogFromFileName(fname, &private.timeline, &endsegno, WalSegSz);
1168 :
1169 2 : if (endsegno < segno)
1170 0 : pg_fatal("ENDSEG %s is before STARTSEG %s",
1171 : argv[optind + 1], argv[optind]);
1172 :
1173 2 : if (XLogRecPtrIsInvalid(private.endptr))
1174 2 : XLogSegNoOffsetToRecPtr(endsegno + 1, 0, WalSegSz,
1175 : private.endptr);
1176 :
1177 : /* set segno to endsegno for check of --end */
1178 2 : segno = endsegno;
1179 : }
1180 :
1181 :
1182 10 : if (!XLByteInSeg(private.endptr, segno, WalSegSz) &&
1183 10 : private.endptr != (segno + 1) * WalSegSz)
1184 : {
1185 0 : pg_log_error("end WAL location %X/%X is not inside file \"%s\"",
1186 : LSN_FORMAT_ARGS(private.endptr),
1187 : argv[argc - 1]);
1188 0 : goto bad_argument;
1189 : }
1190 : }
1191 : else
1192 124 : waldir = identify_target_directory(waldir, NULL);
1193 :
1194 : /* we don't know what to print */
1195 132 : if (XLogRecPtrIsInvalid(private.startptr))
1196 : {
1197 2 : pg_log_error("no start WAL location given");
1198 2 : goto bad_argument;
1199 : }
1200 :
1201 : /* done with argument parsing, do the actual work */
1202 :
1203 : /* we have everything we need, start reading */
1204 : xlogreader_state =
1205 130 : XLogReaderAllocate(WalSegSz, waldir,
1206 130 : XL_ROUTINE(.page_read = WALDumpReadPage,
1207 : .segment_open = WALDumpOpenSegment,
1208 : .segment_close = WALDumpCloseSegment),
1209 : &private);
1210 130 : if (!xlogreader_state)
1211 0 : pg_fatal("out of memory while allocating a WAL reading processor");
1212 :
1213 : /* first find a valid recptr to start from */
1214 130 : first_record = XLogFindNextRecord(xlogreader_state, private.startptr);
1215 :
1216 130 : if (first_record == InvalidXLogRecPtr)
1217 0 : pg_fatal("could not find a valid record after %X/%X",
1218 : LSN_FORMAT_ARGS(private.startptr));
1219 :
1220 : /*
1221 : * Display a message that we're skipping data if `from` wasn't a pointer
1222 : * to the start of a record and also wasn't a pointer to the beginning of
1223 : * a segment (e.g. we were used in file mode).
1224 : */
1225 130 : if (first_record != private.startptr &&
1226 10 : XLogSegmentOffset(private.startptr, WalSegSz) != 0)
1227 2 : pg_log_info(ngettext("first record is after %X/%X, at %X/%X, skipping over %u byte",
1228 : "first record is after %X/%X, at %X/%X, skipping over %u bytes",
1229 : (first_record - private.startptr)),
1230 : LSN_FORMAT_ARGS(private.startptr),
1231 : LSN_FORMAT_ARGS(first_record),
1232 : (uint32) (first_record - private.startptr));
1233 :
1234 130 : if (config.stats == true && !config.quiet)
1235 4 : stats.startptr = first_record;
1236 :
1237 : for (;;)
1238 : {
1239 1228094 : if (time_to_stop)
1240 : {
1241 : /* We've been Ctrl-C'ed, so leave */
1242 0 : break;
1243 : }
1244 :
1245 : /* try to read the next record */
1246 1228094 : record = XLogReadRecord(xlogreader_state, &errormsg);
1247 1228094 : if (!record)
1248 : {
1249 128 : if (!config.follow || private.endptr_reached)
1250 : break;
1251 : else
1252 : {
1253 0 : pg_usleep(1000000L); /* 1 second */
1254 0 : continue;
1255 : }
1256 : }
1257 :
1258 : /* apply all specified filters */
1259 1227966 : if (config.filter_by_rmgr_enabled &&
1260 68990 : !config.filter_by_rmgr[record->xl_rmid])
1261 67002 : continue;
1262 :
1263 1160964 : if (config.filter_by_xid_enabled &&
1264 0 : config.filter_by_xid != record->xl_xid)
1265 0 : continue;
1266 :
1267 : /* check for extended filtering */
1268 1160964 : if (config.filter_by_extended &&
1269 511040 : !XLogRecordMatchesRelationBlock(xlogreader_state,
1270 255520 : config.filter_by_relation_enabled ?
1271 : config.filter_by_relation :
1272 : emptyRelFileLocator,
1273 255520 : config.filter_by_relation_block_enabled ?
1274 : config.filter_by_relation_block :
1275 : InvalidBlockNumber,
1276 : config.filter_by_relation_forknum))
1277 255104 : continue;
1278 :
1279 905860 : if (config.filter_by_fpw && !XLogRecordHasFPW(xlogreader_state))
1280 66852 : continue;
1281 :
1282 : /* perform any per-record work */
1283 839008 : if (!config.quiet)
1284 : {
1285 652184 : if (config.stats == true)
1286 : {
1287 137980 : XLogRecStoreStats(&stats, xlogreader_state);
1288 137980 : stats.endptr = xlogreader_state->EndRecPtr;
1289 : }
1290 : else
1291 514204 : XLogDumpDisplayRecord(&config, xlogreader_state);
1292 : }
1293 :
1294 : /* save full pages if requested */
1295 839008 : if (config.save_fullpage_path != NULL)
1296 402 : XLogRecordSaveFPWs(xlogreader_state, config.save_fullpage_path);
1297 :
1298 : /* check whether we printed enough */
1299 839008 : config.already_displayed_records++;
1300 839008 : if (config.stop_after_records > 0 &&
1301 12 : config.already_displayed_records >= config.stop_after_records)
1302 2 : break;
1303 : }
1304 :
1305 130 : if (config.stats == true && !config.quiet)
1306 4 : XLogDumpDisplayStats(&config, &stats);
1307 :
1308 130 : if (time_to_stop)
1309 0 : exit(0);
1310 :
1311 130 : if (errormsg)
1312 4 : pg_fatal("error in WAL record at %X/%X: %s",
1313 : LSN_FORMAT_ARGS(xlogreader_state->ReadRecPtr),
1314 : errormsg);
1315 :
1316 126 : XLogReaderFree(xlogreader_state);
1317 :
1318 126 : return EXIT_SUCCESS;
1319 :
1320 24 : bad_argument:
1321 24 : pg_log_error_hint("Try \"%s --help\" for more information.", progname);
1322 24 : return EXIT_FAILURE;
1323 : }
|