syscache.c

Go to the documentation of this file.

/*-------------------------------------------------------------------------
 *
 * syscache.c
 *    System cache management routines
 *
 * Portions Copyright (c) 1996-2026, PostgreSQL Global Development Group
 * Portions Copyright (c) 1994, Regents of the University of California
 *
 *
 * IDENTIFICATION
 *    src/backend/utils/cache/syscache.c
 *
 * NOTES
 *    These routines allow the parser/planner/executor to perform
 *    rapid lookups on the contents of the system catalogs.
 *
 *    see utils/syscache.h for a list of the cache IDs
 *
 *-------------------------------------------------------------------------
 */
#include "postgres.h"
 
#include "access/htup_details.h"
#include "catalog/pg_db_role_setting_d.h"
#include "catalog/pg_depend_d.h"
#include "catalog/pg_description_d.h"
#include "catalog/pg_seclabel_d.h"
#include "catalog/pg_shdepend_d.h"
#include "catalog/pg_shdescription_d.h"
#include "catalog/pg_shseclabel_d.h"
#include "common/int.h"
#include "lib/qunique.h"
#include "miscadmin.h"
#include "storage/lmgr.h"
#include "utils/catcache.h"
#include "utils/inval.h"
#include "utils/lsyscache.h"
#include "utils/rel.h"
#include "utils/syscache.h"
 
/*---------------------------------------------------------------------------
 
    Adding system caches:
 
    There must be a unique index underlying each syscache (ie, an index
    whose key is the same as that of the cache).  If there is not one
    already, add the definition for it to include/catalog/pg_*.h using
    DECLARE_UNIQUE_INDEX.
    (Adding an index requires a catversion.h update, while simply
    adding/deleting caches only requires a recompile.)
 
    Add a MAKE_SYSCACHE call to the same pg_*.h file specifying the name of
    your cache, the underlying index, and the initial number of hash buckets.
 
    The number of hash buckets must be a power of 2.  It's reasonable to
    set this to the number of entries that might be in the particular cache
    in a medium-size database.
 
    Finally, any place your relation gets heap_insert() or
    heap_update() calls, use CatalogTupleInsert() or CatalogTupleUpdate()
    instead, which also update indexes.  The heap_* calls do not do that.
 
*---------------------------------------------------------------------------
*/
 
/*
 *      struct cachedesc: information defining a single syscache
 */
struct cachedesc
{
    Oid         reloid;         /* OID of the relation being cached */
    Oid         indoid;         /* OID of index relation for this cache */
    int         nkeys;          /* # of keys needed for cache lookup */
    int         key[4];         /* attribute numbers of key attrs */
    int         nbuckets;       /* number of hash buckets for this cache */
};
 
/* Macro to provide nkeys and key array with convenient syntax. */
#define KEY(...) VA_ARGS_NARGS(__VA_ARGS__), { __VA_ARGS__ }
 
#include "catalog/syscache_info.h"
 
StaticAssertDecl(lengthof(cacheinfo) == SysCacheSize,
                 "SysCacheSize does not match syscache.c's array");
 
static CatCache *SysCache[SysCacheSize];
 
static bool CacheInitialized = false;
 
/* Sorted array of OIDs of tables that have caches on them */
static Oid  SysCacheRelationOid[SysCacheSize];
static int  SysCacheRelationOidSize;
 
/* Sorted array of OIDs of tables and indexes used by caches */
static Oid  SysCacheSupportingRelOid[SysCacheSize * 2];
static int  SysCacheSupportingRelOidSize;
 
static int  oid_compare(const void *a, const void *b);
 
 
/*
 * InitCatalogCache - initialize the caches
 *
 * Note that no database access is done here; we only allocate memory
 * and initialize the cache structure.  Interrogation of the database
 * to complete initialization of a cache happens upon first use
 * of that cache.
 */
void
InitCatalogCache(void)
{
    SysCacheIdentifier cacheId;
 
    Assert(!CacheInitialized);
 
    SysCacheRelationOidSize = SysCacheSupportingRelOidSize = 0;
 
    for (cacheId = 0; cacheId < SysCacheSize; cacheId++)
    {
        /*
         * Assert that every enumeration value defined in syscache.h has been
         * populated in the cacheinfo array.
         */
        Assert(OidIsValid(cacheinfo[cacheId].reloid));
        Assert(OidIsValid(cacheinfo[cacheId].indoid));
        /* .nbuckets and .key[] are checked by InitCatCache() */
 
        SysCache[cacheId] = InitCatCache(cacheId,
                                         cacheinfo[cacheId].reloid,
                                         cacheinfo[cacheId].indoid,
                                         cacheinfo[cacheId].nkeys,
                                         cacheinfo[cacheId].key,
                                         cacheinfo[cacheId].nbuckets);
        if (!SysCache[cacheId])
            elog(ERROR, "could not initialize cache %u (%d)",
                 cacheinfo[cacheId].reloid, cacheId);
        /* Accumulate data for OID lists, too */
        SysCacheRelationOid[SysCacheRelationOidSize++] =
            cacheinfo[cacheId].reloid;
        SysCacheSupportingRelOid[SysCacheSupportingRelOidSize++] =
            cacheinfo[cacheId].reloid;
        SysCacheSupportingRelOid[SysCacheSupportingRelOidSize++] =
            cacheinfo[cacheId].indoid;
        /* see comments for RelationInvalidatesSnapshotsOnly */
        Assert(!RelationInvalidatesSnapshotsOnly(cacheinfo[cacheId].reloid));
    }
 
    Assert(SysCacheRelationOidSize <= lengthof(SysCacheRelationOid));
    Assert(SysCacheSupportingRelOidSize <= lengthof(SysCacheSupportingRelOid));
 
    /* Sort and de-dup OID arrays, so we can use binary search. */
    qsort(SysCacheRelationOid, SysCacheRelationOidSize,
          sizeof(Oid), oid_compare);
    SysCacheRelationOidSize =
        qunique(SysCacheRelationOid, SysCacheRelationOidSize, sizeof(Oid),
                oid_compare);
 
    qsort(SysCacheSupportingRelOid, SysCacheSupportingRelOidSize,
          sizeof(Oid), oid_compare);
    SysCacheSupportingRelOidSize =
        qunique(SysCacheSupportingRelOid, SysCacheSupportingRelOidSize,
                sizeof(Oid), oid_compare);
 
    CacheInitialized = true;
}
 
/*
 * InitCatalogCachePhase2 - finish initializing the caches
 *
 * Finish initializing all the caches, including necessary database
 * access.
 *
 * This is *not* essential; normally we allow syscaches to be initialized
 * on first use.  However, it is useful as a mechanism to preload the
 * relcache with entries for the most-commonly-used system catalogs.
 * Therefore, we invoke this routine when we need to write a new relcache
 * init file.
 */
void
InitCatalogCachePhase2(void)
{
    SysCacheIdentifier cacheId;
 
    Assert(CacheInitialized);
 
    for (cacheId = 0; cacheId < SysCacheSize; cacheId++)
        InitCatCachePhase2(SysCache[cacheId], true);
}
 
 
/*
 * SearchSysCache
 *
 *  A layer on top of SearchCatCache that does the initialization and
 *  key-setting for you.
 *
 *  Returns the cache copy of the tuple if one is found, NULL if not.
 *  The tuple is the 'cache' copy and must NOT be modified!
 *
 *  When the caller is done using the tuple, call ReleaseSysCache()
 *  to release the reference count grabbed by SearchSysCache().  If this
 *  is not done, the tuple will remain locked in cache until end of
 *  transaction, which is tolerable but not desirable.
 *
 *  CAUTION: The tuple that is returned must NOT be freed by the caller!
 */
HeapTuple
SearchSysCache(SysCacheIdentifier cacheId,
               Datum key1,
               Datum key2,
               Datum key3,
               Datum key4)
{
    Assert(cacheId >= 0 && cacheId < SysCacheSize && SysCache[cacheId]);
 
    return SearchCatCache(SysCache[cacheId], key1, key2, key3, key4);
}
 
HeapTuple
SearchSysCache1(SysCacheIdentifier cacheId,
                Datum key1)
{
    Assert(cacheId >= 0 && cacheId < SysCacheSize && SysCache[cacheId]);
    Assert(SysCache[cacheId]->cc_nkeys == 1);
 
    return SearchCatCache1(SysCache[cacheId], key1);
}
 
HeapTuple
SearchSysCache2(SysCacheIdentifier cacheId,
                Datum key1, Datum key2)
{
    Assert(cacheId >= 0 && cacheId < SysCacheSize && SysCache[cacheId]);
    Assert(SysCache[cacheId]->cc_nkeys == 2);
 
    return SearchCatCache2(SysCache[cacheId], key1, key2);
}
 
HeapTuple
SearchSysCache3(SysCacheIdentifier cacheId,
                Datum key1, Datum key2, Datum key3)
{
    Assert(cacheId >= 0 && cacheId < SysCacheSize && SysCache[cacheId]);
    Assert(SysCache[cacheId]->cc_nkeys == 3);
 
    return SearchCatCache3(SysCache[cacheId], key1, key2, key3);
}
 
HeapTuple
SearchSysCache4(SysCacheIdentifier cacheId,
                Datum key1, Datum key2, Datum key3, Datum key4)
{
    Assert(cacheId >= 0 && cacheId < SysCacheSize && SysCache[cacheId]);
    Assert(SysCache[cacheId]->cc_nkeys == 4);
 
    return SearchCatCache4(SysCache[cacheId], key1, key2, key3, key4);
}
 
/*
 * ReleaseSysCache
 *      Release previously grabbed reference count on a tuple
 */
void
ReleaseSysCache(HeapTuple tuple)
{
    ReleaseCatCache(tuple);
}
 
/*
 * SearchSysCacheLocked1
 *
 * Combine SearchSysCache1() with acquiring a LOCKTAG_TUPLE at mode
 * InplaceUpdateTupleLock.  This is a tool for complying with the
 * README.tuplock section "Locking to write inplace-updated tables".  After
 * the caller's heap_update(), it should UnlockTuple(InplaceUpdateTupleLock)
 * and ReleaseSysCache().
 *
 * The returned tuple may be the subject of an uncommitted update, so this
 * doesn't prevent the "tuple concurrently updated" error.
 */
HeapTuple
SearchSysCacheLocked1(SysCacheIdentifier cacheId,
                      Datum key1)
{
    CatCache   *cache = SysCache[cacheId];
    ItemPointerData tid;
    LOCKTAG     tag;
 
    /*----------
     * Since inplace updates may happen just before our LockTuple(), we must
     * return content acquired after LockTuple() of the TID we return.  If we
     * just fetched twice instead of looping, the following sequence would
     * defeat our locking:
     *
     * GRANT:   SearchSysCache1() = TID (1,5)
     * GRANT:   LockTuple(pg_class, (1,5))
     * [no more inplace update of (1,5) until we release the lock]
     * CLUSTER: SearchSysCache1() = TID (1,5)
     * CLUSTER: heap_update() = TID (1,8)
     * CLUSTER: COMMIT
     * GRANT:   SearchSysCache1() = TID (1,8)
     * GRANT:   return (1,8) from SearchSysCacheLocked1()
     * VACUUM:  SearchSysCache1() = TID (1,8)
     * VACUUM:  LockTuple(pg_class, (1,8))  # two TIDs now locked for one rel
     * VACUUM:  inplace update
     * GRANT:   heap_update() = (1,9)  # lose inplace update
     *
     * In the happy case, this takes two fetches, one to determine the TID to
     * lock and another to get the content and confirm the TID didn't change.
     *
     * This is valid even if the row gets updated to a new TID, the old TID
     * becomes LP_UNUSED, and the row gets updated back to its old TID.  We'd
     * still hold the right LOCKTAG_TUPLE and a copy of the row captured after
     * the LOCKTAG_TUPLE.
     */
    ItemPointerSetInvalid(&tid);
    for (;;)
    {
        HeapTuple   tuple;
        LOCKMODE    lockmode = InplaceUpdateTupleLock;
 
        tuple = SearchSysCache1(cacheId, key1);
        if (ItemPointerIsValid(&tid))
        {
            if (!HeapTupleIsValid(tuple))
            {
                LockRelease(&tag, lockmode, false);
                return tuple;
            }
            if (ItemPointerEquals(&tid, &tuple->t_self))
                return tuple;
            LockRelease(&tag, lockmode, false);
        }
        else if (!HeapTupleIsValid(tuple))
            return tuple;
 
        tid = tuple->t_self;
        ReleaseSysCache(tuple);
 
        /*
         * Do like LockTuple(rel, &tid, lockmode).  While cc_relisshared won't
         * change from one iteration to another, it may have been a temporary
         * "false" until our first SearchSysCache1().
         */
        SET_LOCKTAG_TUPLE(tag,
                          cache->cc_relisshared ? InvalidOid : MyDatabaseId,
                          cache->cc_reloid,
                          ItemPointerGetBlockNumber(&tid),
                          ItemPointerGetOffsetNumber(&tid));
        (void) LockAcquire(&tag, lockmode, false, false);
 
        /*
         * If an inplace update just finished, ensure we process the syscache
         * inval.
         *
         * If a heap_update() call just released its LOCKTAG_TUPLE, we'll
         * probably find the old tuple and reach "tuple concurrently updated".
         * If that heap_update() aborts, our LOCKTAG_TUPLE blocks inplace
         * updates while our caller works.
         */
        AcceptInvalidationMessages();
    }
}
 
/*
 * SearchSysCacheCopy
 *
 * A convenience routine that does SearchSysCache and (if successful)
 * returns a modifiable copy of the syscache entry.  The original
 * syscache entry is released before returning.  The caller should
 * heap_freetuple() the result when done with it.
 */
HeapTuple
SearchSysCacheCopy(SysCacheIdentifier cacheId,
                   Datum key1,
                   Datum key2,
                   Datum key3,
                   Datum key4)
{
    HeapTuple   tuple,
                newtuple;
 
    tuple = SearchSysCache(cacheId, key1, key2, key3, key4);
    if (!HeapTupleIsValid(tuple))
        return tuple;
    newtuple = heap_copytuple(tuple);
    ReleaseSysCache(tuple);
    return newtuple;
}
 
/*
 * SearchSysCacheLockedCopy1
 *
 * Meld SearchSysCacheLocked1 with SearchSysCacheCopy().  After the
 * caller's heap_update(), it should UnlockTuple(InplaceUpdateTupleLock) and
 * heap_freetuple().
 */
HeapTuple
SearchSysCacheLockedCopy1(SysCacheIdentifier cacheId,
                          Datum key1)
{
    HeapTuple   tuple,
                newtuple;
 
    tuple = SearchSysCacheLocked1(cacheId, key1);
    if (!HeapTupleIsValid(tuple))
        return tuple;
    newtuple = heap_copytuple(tuple);
    ReleaseSysCache(tuple);
    return newtuple;
}
 
/*
 * SearchSysCacheExists
 *
 * A convenience routine that just probes to see if a tuple can be found.
 * No lock is retained on the syscache entry.
 */
bool
SearchSysCacheExists(SysCacheIdentifier cacheId,
                     Datum key1,
                     Datum key2,
                     Datum key3,
                     Datum key4)
{
    HeapTuple   tuple;
 
    tuple = SearchSysCache(cacheId, key1, key2, key3, key4);
    if (!HeapTupleIsValid(tuple))
        return false;
    ReleaseSysCache(tuple);
    return true;
}
 
/*
 * GetSysCacheOid
 *
 * A convenience routine that does SearchSysCache and returns the OID in the
 * oidcol column of the found tuple, or InvalidOid if no tuple could be found.
 * No lock is retained on the syscache entry.
 */
Oid
GetSysCacheOid(SysCacheIdentifier cacheId,
               AttrNumber oidcol,
               Datum key1,
               Datum key2,
               Datum key3,
               Datum key4)
{
    HeapTuple   tuple;
    bool        isNull;
    Oid         result;
 
    tuple = SearchSysCache(cacheId, key1, key2, key3, key4);
    if (!HeapTupleIsValid(tuple))
        return InvalidOid;
    result = DatumGetObjectId(heap_getattr(tuple, oidcol,
                                           SysCache[cacheId]->cc_tupdesc,
                                           &isNull));
    Assert(!isNull);            /* columns used as oids should never be NULL */
    ReleaseSysCache(tuple);
    return result;
}
 
 
/*
 * SearchSysCacheAttName
 *
 * This routine is equivalent to SearchSysCache on the ATTNAME cache,
 * except that it will return NULL if the found attribute is marked
 * attisdropped.  This is convenient for callers that want to act as
 * though dropped attributes don't exist.
 */
HeapTuple
SearchSysCacheAttName(Oid relid, const char *attname)
{
    HeapTuple   tuple;
 
    tuple = SearchSysCache2(ATTNAME,
                            ObjectIdGetDatum(relid),
                            CStringGetDatum(attname));
    if (!HeapTupleIsValid(tuple))
        return NULL;
    if (((Form_pg_attribute) GETSTRUCT(tuple))->attisdropped)
    {
        ReleaseSysCache(tuple);
        return NULL;
    }
    return tuple;
}
 
/*
 * SearchSysCacheCopyAttName
 *
 * As above, an attisdropped-aware version of SearchSysCacheCopy.
 */
HeapTuple
SearchSysCacheCopyAttName(Oid relid, const char *attname)
{
    HeapTuple   tuple,
                newtuple;
 
    tuple = SearchSysCacheAttName(relid, attname);
    if (!HeapTupleIsValid(tuple))
        return tuple;
    newtuple = heap_copytuple(tuple);
    ReleaseSysCache(tuple);
    return newtuple;
}
 
/*
 * SearchSysCacheExistsAttName
 *
 * As above, an attisdropped-aware version of SearchSysCacheExists.
 */
bool
SearchSysCacheExistsAttName(Oid relid, const char *attname)
{
    HeapTuple   tuple;
 
    tuple = SearchSysCacheAttName(relid, attname);
    if (!HeapTupleIsValid(tuple))
        return false;
    ReleaseSysCache(tuple);
    return true;
}
 
 
/*
 * SearchSysCacheAttNum
 *
 * This routine is equivalent to SearchSysCache on the ATTNUM cache,
 * except that it will return NULL if the found attribute is marked
 * attisdropped.  This is convenient for callers that want to act as
 * though dropped attributes don't exist.
 */
HeapTuple
SearchSysCacheAttNum(Oid relid, int16 attnum)
{
    HeapTuple   tuple;
 
    tuple = SearchSysCache2(ATTNUM,
                            ObjectIdGetDatum(relid),
                            Int16GetDatum(attnum));
    if (!HeapTupleIsValid(tuple))
        return NULL;
    if (((Form_pg_attribute) GETSTRUCT(tuple))->attisdropped)
    {
        ReleaseSysCache(tuple);
        return NULL;
    }
    return tuple;
}
 
/*
 * SearchSysCacheCopyAttNum
 *
 * As above, an attisdropped-aware version of SearchSysCacheCopy.
 */
HeapTuple
SearchSysCacheCopyAttNum(Oid relid, int16 attnum)
{
    HeapTuple   tuple,
                newtuple;
 
    tuple = SearchSysCacheAttNum(relid, attnum);
    if (!HeapTupleIsValid(tuple))
        return NULL;
    newtuple = heap_copytuple(tuple);
    ReleaseSysCache(tuple);
    return newtuple;
}
 
 
/*
 * SysCacheGetAttr
 *
 *      Given a tuple previously fetched by SearchSysCache(),
 *      extract a specific attribute.
 *
 * This is equivalent to using heap_getattr() on a tuple fetched
 * from a non-cached relation.  Usually, this is only used for attributes
 * that could be NULL or variable length; the fixed-size attributes in
 * a system table are accessed just by mapping the tuple onto the C struct
 * declarations from include/catalog/.
 *
 * As with heap_getattr(), if the attribute is of a pass-by-reference type
 * then a pointer into the tuple data area is returned --- the caller must
 * not modify or pfree the datum!
 *
 * Note: it is legal to use SysCacheGetAttr() with a cacheId referencing
 * a different cache for the same catalog the tuple was fetched from.
 */
Datum
SysCacheGetAttr(SysCacheIdentifier cacheId, HeapTuple tup,
                AttrNumber attributeNumber,
                bool *isNull)
{
    /*
     * We just need to get the TupleDesc out of the cache entry, and then we
     * can apply heap_getattr().  Normally the cache control data is already
     * valid (because the caller recently fetched the tuple via this same
     * cache), but there are cases where we have to initialize the cache here.
     */
    if (cacheId < 0 || cacheId >= SysCacheSize || !SysCache[cacheId])
        elog(ERROR, "invalid cache ID: %d", cacheId);
    if (!SysCache[cacheId]->cc_tupdesc)
    {
        InitCatCachePhase2(SysCache[cacheId], false);
        Assert(SysCache[cacheId]->cc_tupdesc);
    }
 
    return heap_getattr(tup, attributeNumber,
                        SysCache[cacheId]->cc_tupdesc,
                        isNull);
}
 
/*
 * SysCacheGetAttrNotNull
 *
 * As above, a version of SysCacheGetAttr which knows that the attr cannot
 * be NULL.
 */
Datum
SysCacheGetAttrNotNull(SysCacheIdentifier cacheId, HeapTuple tup,
                       AttrNumber attributeNumber)
{
    bool        isnull;
    Datum       attr;
 
    attr = SysCacheGetAttr(cacheId, tup, attributeNumber, &isnull);
 
    if (isnull)
    {
        elog(ERROR,
             "unexpected null value in cached tuple for catalog %s column %s",
             get_rel_name(cacheinfo[cacheId].reloid),
             NameStr(TupleDescAttr(SysCache[cacheId]->cc_tupdesc, attributeNumber - 1)->attname));
    }
 
    return attr;
}
 
/*
 * GetSysCacheHashValue
 *
 * Get the hash value that would be used for a tuple in the specified cache
 * with the given search keys.
 *
 * The reason for exposing this as part of the API is that the hash value is
 * exposed in cache invalidation operations, so there are places outside the
 * catcache code that need to be able to compute the hash values.
 */
uint32
GetSysCacheHashValue(SysCacheIdentifier cacheId,
                     Datum key1,
                     Datum key2,
                     Datum key3,
                     Datum key4)
{
    if (cacheId < 0 || cacheId >= SysCacheSize || !SysCache[cacheId])
        elog(ERROR, "invalid cache ID: %d", cacheId);
 
    return GetCatCacheHashValue(SysCache[cacheId], key1, key2, key3, key4);
}
 
/*
 * List-search interface
 */
struct catclist *
SearchSysCacheList(SysCacheIdentifier cacheId, int nkeys,
                   Datum key1, Datum key2, Datum key3)
{
    if (cacheId < 0 || cacheId >= SysCacheSize || !SysCache[cacheId])
        elog(ERROR, "invalid cache ID: %d", cacheId);
 
    return SearchCatCacheList(SysCache[cacheId], nkeys,
                              key1, key2, key3);
}
 
/*
 * SysCacheInvalidate
 *
 *  Invalidate entries in the specified cache, given a hash value.
 *  See CatCacheInvalidate() for more info.
 *
 *  This routine is only quasi-public: it should only be used by inval.c.
 */
void
SysCacheInvalidate(SysCacheIdentifier cacheId, uint32 hashValue)
{
    if (cacheId < 0 || cacheId >= SysCacheSize)
        elog(ERROR, "invalid cache ID: %d", cacheId);
 
    /* if this cache isn't initialized yet, no need to do anything */
    if (!SysCache[cacheId])
        return;
 
    CatCacheInvalidate(SysCache[cacheId], hashValue);
}
 
/*
 * Certain relations that do not have system caches send snapshot invalidation
 * messages in lieu of catcache messages.  This is for the benefit of
 * GetCatalogSnapshot(), which can then reuse its existing MVCC snapshot
 * for scanning one of those catalogs, rather than taking a new one, if no
 * invalidation has been received.
 *
 * Relations that have syscaches need not (and must not) be listed here.  The
 * catcache invalidation messages will also flush the snapshot.  If you add a
 * syscache for one of these relations, remove it from this list.
 */
bool
RelationInvalidatesSnapshotsOnly(Oid relid)
{
    switch (relid)
    {
        case DbRoleSettingRelationId:
        case DependRelationId:
        case SharedDependRelationId:
        case DescriptionRelationId:
        case SharedDescriptionRelationId:
        case SecLabelRelationId:
        case SharedSecLabelRelationId:
            return true;
        default:
            break;
    }
 
    return false;
}
 
/*
 * Test whether a relation has a system cache.
 */
bool
RelationHasSysCache(Oid relid)
{
    int         low = 0,
                high = SysCacheRelationOidSize - 1;
 
    while (low <= high)
    {
        int         middle = low + (high - low) / 2;
 
        if (SysCacheRelationOid[middle] == relid)
            return true;
        if (SysCacheRelationOid[middle] < relid)
            low = middle + 1;
        else
            high = middle - 1;
    }
 
    return false;
}
 
/*
 * Test whether a relation supports a system cache, ie it is either a
 * cached table or the index used for a cache.
 */
bool
RelationSupportsSysCache(Oid relid)
{
    int         low = 0,
                high = SysCacheSupportingRelOidSize - 1;
 
    while (low <= high)
    {
        int         middle = low + (high - low) / 2;
 
        if (SysCacheSupportingRelOid[middle] == relid)
            return true;
        if (SysCacheSupportingRelOid[middle] < relid)
            low = middle + 1;
        else
            high = middle - 1;
    }
 
    return false;
}
 
 
/*
 * OID comparator for qsort
 */
static int
oid_compare(const void *a, const void *b)
{
    Oid         oa = *((const Oid *) a);
    Oid         ob = *((const Oid *) b);
 
    return pg_cmp_u32(oa, ob);
}