LCOV - code coverage report
Current view: top level - src/bin/pg_waldump - pg_waldump.c (source / functions) Hit Total Coverage
Test: PostgreSQL 18devel Lines: 449 531 84.6 %
Date: 2024-12-02 21:15:08 Functions: 18 19 94.7 %
Legend: Lines: hit not hit

          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             : }

Generated by: LCOV version 1.14