Line data    Source code

       1             : /*-------------------------------------------------------------------------
       2             :  *
       3             :  * standbydesc.c
       4             :  *    rmgr descriptor routines for storage/ipc/standby.c
       5             :  *
       6             :  * Portions Copyright (c) 1996-2025, PostgreSQL Global Development Group
       7             :  * Portions Copyright (c) 1994, Regents of the University of California
       8             :  *
       9             :  *
      10             :  * IDENTIFICATION
      11             :  *    src/backend/access/rmgrdesc/standbydesc.c
      12             :  *
      13             :  *-------------------------------------------------------------------------
      14             :  */
      15             : #include "postgres.h"
      16             : 
      17             : #include "storage/standbydefs.h"
      18             : 
      19             : static void
      20          18 : standby_desc_running_xacts(StringInfo buf, xl_running_xacts *xlrec)
      21             : {
      22             :     int         i;
      23             : 
      24          18 :     appendStringInfo(buf, "nextXid %u latestCompletedXid %u oldestRunningXid %u",
      25             :                      xlrec->nextXid,
      26             :                      xlrec->latestCompletedXid,
      27             :                      xlrec->oldestRunningXid);
      28          18 :     if (xlrec->xcnt > 0)
      29             :     {
      30           0 :         appendStringInfo(buf, "; %d xacts:", xlrec->xcnt);
      31           0 :         for (i = 0; i < xlrec->xcnt; i++)
      32           0 :             appendStringInfo(buf, " %u", xlrec->xids[i]);
      33             :     }
      34             : 
      35          18 :     if (xlrec->subxid_overflow)
      36           0 :         appendStringInfoString(buf, "; subxid overflowed");
      37             : 
      38          18 :     if (xlrec->subxcnt > 0)
      39             :     {
      40           0 :         appendStringInfo(buf, "; %d subxacts:", xlrec->subxcnt);
      41           0 :         for (i = 0; i < xlrec->subxcnt; i++)
      42           0 :             appendStringInfo(buf, " %u", xlrec->xids[xlrec->xcnt + i]);
      43             :     }
      44          18 : }
      45             : 
      46             : void
      47          28 : standby_desc(StringInfo buf, XLogReaderState *record)
      48             : {
      49          28 :     char       *rec = XLogRecGetData(record);
      50          28 :     uint8       info = XLogRecGetInfo(record) & ~XLR_INFO_MASK;
      51             : 
      52          28 :     if (info == XLOG_STANDBY_LOCK)
      53             :     {
      54           8 :         xl_standby_locks *xlrec = (xl_standby_locks *) rec;
      55             :         int         i;
      56             : 
      57          16 :         for (i = 0; i < xlrec->nlocks; i++)
      58           8 :             appendStringInfo(buf, "xid %u db %u rel %u ",
      59             :                              xlrec->locks[i].xid, xlrec->locks[i].dbOid,
      60             :                              xlrec->locks[i].relOid);
      61             :     }
      62          20 :     else if (info == XLOG_RUNNING_XACTS)
      63             :     {
      64          18 :         xl_running_xacts *xlrec = (xl_running_xacts *) rec;
      65             : 
      66          18 :         standby_desc_running_xacts(buf, xlrec);
      67             :     }
      68           2 :     else if (info == XLOG_INVALIDATIONS)
      69             :     {
      70           2 :         xl_invalidations *xlrec = (xl_invalidations *) rec;
      71             : 
      72           2 :         standby_desc_invalidations(buf, xlrec->nmsgs, xlrec->msgs,
      73             :                                    xlrec->dbId, xlrec->tsId,
      74           2 :                                    xlrec->relcacheInitFileInval);
      75             :     }
      76          28 : }
      77             : 
      78             : const char *
      79          28 : standby_identify(uint8 info)
      80             : {
      81          28 :     const char *id = NULL;
      82             : 
      83          28 :     switch (info & ~XLR_INFO_MASK)
      84             :     {
      85           8 :         case XLOG_STANDBY_LOCK:
      86           8 :             id = "LOCK";
      87           8 :             break;
      88          18 :         case XLOG_RUNNING_XACTS:
      89          18 :             id = "RUNNING_XACTS";
      90          18 :             break;
      91           2 :         case XLOG_INVALIDATIONS:
      92           2 :             id = "INVALIDATIONS";
      93           2 :             break;
      94             :     }
      95             : 
      96          28 :     return id;
      97             : }
      98             : 
      99             : /* also used by non-standby records having analogous invalidation fields */
     100             : void
     101          56 : standby_desc_invalidations(StringInfo buf,
     102             :                            int nmsgs, SharedInvalidationMessage *msgs,
     103             :                            Oid dbId, Oid tsId,
     104             :                            bool relcacheInitFileInval)
     105             : {
     106             :     int         i;
     107             : 
     108             :     /* Do nothing if there are no invalidation messages */
     109          56 :     if (nmsgs <= 0)
     110          14 :         return;
     111             : 
     112          42 :     if (relcacheInitFileInval)
     113           2 :         appendStringInfo(buf, "; relcache init file inval dbid %u tsid %u",
     114             :                          dbId, tsId);
     115             : 
     116          42 :     appendStringInfoString(buf, "; inval msgs:");
     117         950 :     for (i = 0; i < nmsgs; i++)
     118             :     {
     119         908 :         SharedInvalidationMessage *msg = &msgs[i];
     120             : 
     121         908 :         if (msg->id >= 0)
     122         728 :             appendStringInfo(buf, " catcache %d", msg->id);
     123         180 :         else if (msg->id == SHAREDINVALCATALOG_ID)
     124           0 :             appendStringInfo(buf, " catalog %u", msg->cat.catId);
     125         180 :         else if (msg->id == SHAREDINVALRELCACHE_ID)
     126         114 :             appendStringInfo(buf, " relcache %u", msg->rc.relId);
     127             :         /* not expected, but print something anyway */
     128          66 :         else if (msg->id == SHAREDINVALSMGR_ID)
     129           0 :             appendStringInfoString(buf, " smgr");
     130             :         /* not expected, but print something anyway */
     131          66 :         else if (msg->id == SHAREDINVALRELMAP_ID)
     132           0 :             appendStringInfo(buf, " relmap db %u", msg->rm.dbId);
     133          66 :         else if (msg->id == SHAREDINVALSNAPSHOT_ID)
     134          66 :             appendStringInfo(buf, " snapshot %u", msg->sn.relId);
     135           0 :         else if (msg->id == SHAREDINVALRELSYNC_ID)
     136           0 :             appendStringInfo(buf, " relsync %u", msg->rs.relid);
     137             :         else
     138           0 :             appendStringInfo(buf, " unrecognized id %d", msg->id);
     139             :     }
     140             : }