dsm_registry.c File Reference

#include "postgres.h"
#include "funcapi.h"
#include "lib/dshash.h"
#include "storage/dsm_registry.h"
#include "storage/lwlock.h"
#include "storage/shmem.h"
#include "utils/builtins.h"
#include "utils/memutils.h"

Include dependency graph for dsm_registry.c:

Go to the source code of this file.

Data Structures
struct	DSMRegistryCtxStruct
struct	NamedDSMState
struct	NamedDSAState
struct	NamedDSHState
struct	DSMRegistryEntry

Typedefs
typedef struct DSMRegistryCtxStruct	DSMRegistryCtxStruct
typedef struct NamedDSMState	NamedDSMState
typedef struct NamedDSAState	NamedDSAState
typedef struct NamedDSHState	NamedDSHState
typedef enum DSMREntryType	DSMREntryType
typedef struct DSMRegistryEntry	DSMRegistryEntry

Enumerations
enum	DSMREntryType { DSMR_ENTRY_TYPE_DSM , DSMR_ENTRY_TYPE_DSA , DSMR_ENTRY_TYPE_DSH }

Functions
Size	DSMRegistryShmemSize (void)
void	DSMRegistryShmemInit (void)
static void	init_dsm_registry (void)
void *	GetNamedDSMSegment (const char *name, size_t size, void(*init_callback)(void *ptr), bool *found)
dsa_area *	GetNamedDSA (const char *name, bool *found)
dshash_table *	GetNamedDSHash (const char *name, const dshash_parameters *params, bool *found)
Datum	pg_get_dsm_registry_allocations (PG_FUNCTION_ARGS)

Variables
static DSMRegistryCtxStruct *	DSMRegistryCtx
static const char *const	DSMREntryTypeNames []
static const dshash_parameters	dsh_params
static dsa_area *	dsm_registry_dsa
static dshash_table *	dsm_registry_table

Typedef Documentation

DSMRegistryCtxStruct

typedef struct DSMRegistryCtxStruct DSMRegistryCtxStruct

DSMRegistryEntry

typedef struct DSMRegistryEntry DSMRegistryEntry

DSMREntryType

typedef enum DSMREntryType DSMREntryType

NamedDSAState

typedef struct NamedDSAState NamedDSAState

NamedDSHState

typedef struct NamedDSHState NamedDSHState

NamedDSMState

typedef struct NamedDSMState NamedDSMState

Enumeration Type Documentation

DSMREntryType

enum DSMREntryType

Enumerator
DSMR_ENTRY_TYPE_DSM
DSMR_ENTRY_TYPE_DSA
DSMR_ENTRY_TYPE_DSH

Definition at line 78 of file dsm_registry.c.

{
    DSMR_ENTRY_TYPE_DSM,
    DSMR_ENTRY_TYPE_DSA,
    DSMR_ENTRY_TYPE_DSH,
} DSMREntryType;

Function Documentation

DSMRegistryShmemInit()

void DSMRegistryShmemInit

(

void

)

Definition at line 124 of file dsm_registry.c.

{
    bool        found;
 
    DSMRegistryCtx = (DSMRegistryCtxStruct *)
        ShmemInitStruct("DSM Registry Data",
                        DSMRegistryShmemSize(),
                        &found);
 
    if (!found)
    {
        DSMRegistryCtx->dsah = DSA_HANDLE_INVALID;
        DSMRegistryCtx->dshh = DSHASH_HANDLE_INVALID;
    }
}

References DSA_HANDLE_INVALID, DSMRegistryCtxStruct::dsah, DSHASH_HANDLE_INVALID, DSMRegistryCtxStruct::dshh, DSMRegistryCtx, DSMRegistryShmemSize(), and ShmemInitStruct().

Referenced by CreateOrAttachShmemStructs().

DSMRegistryShmemSize()

Size DSMRegistryShmemSize

(

void

)

Definition at line 118 of file dsm_registry.c.

{
    return MAXALIGN(sizeof(DSMRegistryCtxStruct));
}

References MAXALIGN.

Referenced by CalculateShmemSize(), and DSMRegistryShmemInit().

GetNamedDSA()

dsa_area * GetNamedDSA	(	const char *	name,
		bool *	found
	)

Definition at line 282 of file dsm_registry.c.

{
    DSMRegistryEntry *entry;
    MemoryContext oldcontext;
    dsa_area   *ret;
 
    Assert(found);
 
    if (!name || *name == '\0')
        ereport(ERROR,
                (errmsg("DSA name cannot be empty")));
 
    if (strlen(name) >= offsetof(DSMRegistryEntry, type))
        ereport(ERROR,
                (errmsg("DSA name too long")));
 
    /* Be sure any local memory allocated by DSM/DSA routines is persistent. */
    oldcontext = MemoryContextSwitchTo(TopMemoryContext);
 
    /* Connect to the registry. */
    init_dsm_registry();
 
    entry = dshash_find_or_insert(dsm_registry_table, name, found);
    if (!(*found))
    {
        NamedDSAState *state = &entry->dsa;
 
        entry->type = DSMR_ENTRY_TYPE_DSA;
        entry->initialized = false;
 
        /* Initialize the LWLock tranche for the DSA. */
        state->tranche = LWLockNewTrancheId(name);
 
        /* Initialize the DSA. */
        ret = dsa_create(state->tranche);
        dsa_pin(ret);
        dsa_pin_mapping(ret);
 
        /* Store handle for other backends to use. */
        state->handle = dsa_get_handle(ret);
 
        entry->initialized = true;
    }
    else if (entry->type != DSMR_ENTRY_TYPE_DSA)
        ereport(ERROR,
                (errmsg("requested DSA \"%s\" does not match type of existing entry",
                        name)));
    else if (!entry->initialized)
        ereport(ERROR,
                (errmsg("requested DSA \"%s\" failed initialization",
                        name)));
    else
    {
        NamedDSAState *state = &entry->dsa;
 
        if (dsa_is_attached(state->handle))
            ereport(ERROR,
                    (errmsg("requested DSA already attached to current process")));
 
        /* Attach to existing DSA. */
        ret = dsa_attach(state->handle);
        dsa_pin_mapping(ret);
    }
 
    dshash_release_lock(dsm_registry_table, entry);
    MemoryContextSwitchTo(oldcontext);
 
    return ret;
}

References Assert(), DSMRegistryEntry::dsa, dsa_attach(), dsa_create, dsa_get_handle(), dsa_is_attached(), dsa_pin(), dsa_pin_mapping(), dshash_find_or_insert(), dshash_release_lock(), dsm_registry_table, DSMR_ENTRY_TYPE_DSA, ereport, errmsg(), ERROR, init_dsm_registry(), DSMRegistryEntry::initialized, LWLockNewTrancheId(), MemoryContextSwitchTo(), name, TopMemoryContext, DSMRegistryEntry::type, and type.

Referenced by tdr_attach_shmem().

GetNamedDSHash()

dshash_table * GetNamedDSHash	(	const char *	name,
		const dshash_parameters *	params,
		bool *	found
	)

Definition at line 362 of file dsm_registry.c.

{
    DSMRegistryEntry *entry;
    MemoryContext oldcontext;
    dshash_table *ret;
 
    Assert(params);
    Assert(found);
 
    if (!name || *name == '\0')
        ereport(ERROR,
                (errmsg("DSHash name cannot be empty")));
 
    if (strlen(name) >= offsetof(DSMRegistryEntry, type))
        ereport(ERROR,
                (errmsg("DSHash name too long")));
 
    /* Be sure any local memory allocated by DSM/DSA routines is persistent. */
    oldcontext = MemoryContextSwitchTo(TopMemoryContext);
 
    /* Connect to the registry. */
    init_dsm_registry();
 
    entry = dshash_find_or_insert(dsm_registry_table, name, found);
    if (!(*found))
    {
        NamedDSHState *dsh_state = &entry->dsh;
        dshash_parameters params_copy;
        dsa_area   *dsa;
 
        entry->type = DSMR_ENTRY_TYPE_DSH;
        entry->initialized = false;
 
        /* Initialize the LWLock tranche for the hash table. */
        dsh_state->tranche = LWLockNewTrancheId(name);
 
        /* Initialize the DSA for the hash table. */
        dsa = dsa_create(dsh_state->tranche);
        dsa_pin(dsa);
        dsa_pin_mapping(dsa);
 
        /* Initialize the dshash table. */
        memcpy(&params_copy, params, sizeof(dshash_parameters));
        params_copy.tranche_id = dsh_state->tranche;
        ret = dshash_create(dsa, &params_copy, NULL);
 
        /* Store handles for other backends to use. */
        dsh_state->dsa_handle = dsa_get_handle(dsa);
        dsh_state->dsh_handle = dshash_get_hash_table_handle(ret);
 
        entry->initialized = true;
    }
    else if (entry->type != DSMR_ENTRY_TYPE_DSH)
        ereport(ERROR,
                (errmsg("requested DSHash \"%s\" does not match type of existing entry",
                        name)));
    else if (!entry->initialized)
        ereport(ERROR,
                (errmsg("requested DSHash \"%s\" failed initialization",
                        name)));
    else
    {
        NamedDSHState *dsh_state = &entry->dsh;
        dsa_area   *dsa;
 
        /* XXX: Should we verify params matches what table was created with? */
 
        if (dsa_is_attached(dsh_state->dsa_handle))
            ereport(ERROR,
                    (errmsg("requested DSHash already attached to current process")));
 
        /* Attach to existing DSA for the hash table. */
        dsa = dsa_attach(dsh_state->dsa_handle);
        dsa_pin_mapping(dsa);
 
        /* Attach to existing dshash table. */
        ret = dshash_attach(dsa, params, dsh_state->dsh_handle, NULL);
    }
 
    dshash_release_lock(dsm_registry_table, entry);
    MemoryContextSwitchTo(oldcontext);
 
    return ret;
}

References Assert(), dsa_attach(), dsa_create, dsa_get_handle(), NamedDSHState::dsa_handle, dsa_is_attached(), dsa_pin(), dsa_pin_mapping(), DSMRegistryEntry::dsh, NamedDSHState::dsh_handle, dshash_attach(), dshash_create(), dshash_find_or_insert(), dshash_get_hash_table_handle(), dshash_release_lock(), dsm_registry_table, DSMR_ENTRY_TYPE_DSH, ereport, errmsg(), ERROR, init_dsm_registry(), DSMRegistryEntry::initialized, LWLockNewTrancheId(), MemoryContextSwitchTo(), name, TopMemoryContext, NamedDSHState::tranche, dshash_parameters::tranche_id, DSMRegistryEntry::type, and type.

Referenced by tdr_attach_shmem().

GetNamedDSMSegment()

void * GetNamedDSMSegment	(	const char *	name,
		size_t	size,
		void(*)(void *ptr)	init_callback,
		bool *	found
	)

Definition at line 186 of file dsm_registry.c.

{
    DSMRegistryEntry *entry;
    MemoryContext oldcontext;
    void       *ret;
 
    Assert(found);
 
    if (!name || *name == '\0')
        ereport(ERROR,
                (errmsg("DSM segment name cannot be empty")));
 
    if (strlen(name) >= offsetof(DSMRegistryEntry, type))
        ereport(ERROR,
                (errmsg("DSM segment name too long")));
 
    if (size == 0)
        ereport(ERROR,
                (errmsg("DSM segment size must be nonzero")));
 
    /* Be sure any local memory allocated by DSM/DSA routines is persistent. */
    oldcontext = MemoryContextSwitchTo(TopMemoryContext);
 
    /* Connect to the registry. */
    init_dsm_registry();
 
    entry = dshash_find_or_insert(dsm_registry_table, name, found);
    if (!(*found))
    {
        NamedDSMState *state = &entry->dsm;
        dsm_segment *seg;
 
        entry->type = DSMR_ENTRY_TYPE_DSM;
        entry->initialized = false;
 
        /* Initialize the segment. */
        seg = dsm_create(size, 0);
 
        dsm_pin_segment(seg);
        dsm_pin_mapping(seg);
        state->handle = dsm_segment_handle(seg);
        state->size = size;
        ret = dsm_segment_address(seg);
 
        if (init_callback)
            (*init_callback) (ret);
 
        entry->initialized = true;
    }
    else if (entry->type != DSMR_ENTRY_TYPE_DSM)
        ereport(ERROR,
                (errmsg("requested DSM segment \"%s\" does not match type of existing entry",
                        name)));
    else if (!entry->initialized)
        ereport(ERROR,
                (errmsg("requested DSM segment \"%s\" failed initialization",
                        name)));
    else if (entry->dsm.size != size)
        ereport(ERROR,
                (errmsg("requested DSM segment \"%s\" does not match size of existing entry",
                        name)));
    else
    {
        NamedDSMState *state = &entry->dsm;
        dsm_segment *seg;
 
        /* If the existing segment is not already attached, attach it now. */
        seg = dsm_find_mapping(state->handle);
        if (seg == NULL)
        {
            seg = dsm_attach(state->handle);
            if (seg == NULL)
                elog(ERROR, "could not map dynamic shared memory segment");
 
            dsm_pin_mapping(seg);
        }
 
        ret = dsm_segment_address(seg);
    }
 
    dshash_release_lock(dsm_registry_table, entry);
    MemoryContextSwitchTo(oldcontext);
 
    return ret;
}

References Assert(), dshash_find_or_insert(), dshash_release_lock(), DSMRegistryEntry::dsm, dsm_attach(), dsm_create(), dsm_find_mapping(), dsm_pin_mapping(), dsm_pin_segment(), dsm_registry_table, dsm_segment_address(), dsm_segment_handle(), DSMR_ENTRY_TYPE_DSM, elog, ereport, errmsg(), ERROR, init_dsm_registry(), DSMRegistryEntry::initialized, MemoryContextSwitchTo(), name, NamedDSMState::size, TopMemoryContext, DSMRegistryEntry::type, and type.

Referenced by apw_init_shmem(), injection_init_shmem(), tdr_attach_shmem(), test_dsa_basic(), and test_dsa_resowners().

init_dsm_registry()

static void init_dsm_registry ( void  )

static

Definition at line 146 of file dsm_registry.c.

{
    /* Quick exit if we already did this. */
    if (dsm_registry_table)
        return;
 
    /* Otherwise, use a lock to ensure only one process creates the table. */
    LWLockAcquire(DSMRegistryLock, LW_EXCLUSIVE);
 
    if (DSMRegistryCtx->dshh == DSHASH_HANDLE_INVALID)
    {
        /* Initialize dynamic shared hash table for registry. */
        dsm_registry_dsa = dsa_create(LWTRANCHE_DSM_REGISTRY_DSA);
        dsa_pin(dsm_registry_dsa);
        dsa_pin_mapping(dsm_registry_dsa);
        dsm_registry_table = dshash_create(dsm_registry_dsa, &dsh_params, NULL);
 
        /* Store handles in shared memory for other backends to use. */
        DSMRegistryCtx->dsah = dsa_get_handle(dsm_registry_dsa);
        DSMRegistryCtx->dshh = dshash_get_hash_table_handle(dsm_registry_table);
    }
    else
    {
        /* Attach to existing dynamic shared hash table. */
        dsm_registry_dsa = dsa_attach(DSMRegistryCtx->dsah);
        dsa_pin_mapping(dsm_registry_dsa);
        dsm_registry_table = dshash_attach(dsm_registry_dsa, &dsh_params,
                                           DSMRegistryCtx->dshh, NULL);
    }
 
    LWLockRelease(DSMRegistryLock);
}

References dsa_attach(), dsa_create, dsa_get_handle(), dsa_pin(), dsa_pin_mapping(), DSMRegistryCtxStruct::dsah, dsh_params, dshash_attach(), dshash_create(), dshash_get_hash_table_handle(), DSHASH_HANDLE_INVALID, DSMRegistryCtxStruct::dshh, dsm_registry_dsa, dsm_registry_table, DSMRegistryCtx, LW_EXCLUSIVE, LWLockAcquire(), and LWLockRelease().

Referenced by GetNamedDSA(), GetNamedDSHash(), GetNamedDSMSegment(), and pg_get_dsm_registry_allocations().

pg_get_dsm_registry_allocations()

Datum pg_get_dsm_registry_allocations

(

PG_FUNCTION_ARGS

)

Definition at line 448 of file dsm_registry.c.

{
    ReturnSetInfo *rsinfo = (ReturnSetInfo *) fcinfo->resultinfo;
    DSMRegistryEntry *entry;
    MemoryContext oldcontext;
    dshash_seq_status status;
 
    InitMaterializedSRF(fcinfo, MAT_SRF_USE_EXPECTED_DESC);
 
    /* Be sure any local memory allocated by DSM/DSA routines is persistent. */
    oldcontext = MemoryContextSwitchTo(TopMemoryContext);
    init_dsm_registry();
    MemoryContextSwitchTo(oldcontext);
 
    dshash_seq_init(&status, dsm_registry_table, false);
    while ((entry = dshash_seq_next(&status)) != NULL)
    {
        Datum       vals[3];
        bool        nulls[3] = {0};
 
        vals[0] = CStringGetTextDatum(entry->name);
        vals[1] = CStringGetTextDatum(DSMREntryTypeNames[entry->type]);
 
        /*
         * Since we can't know the size of DSA/dshash entries without first
         * attaching to them, return NULL for those.
         */
        if (entry->type == DSMR_ENTRY_TYPE_DSM)
            vals[2] = Int64GetDatum(entry->dsm.size);
        else
            nulls[2] = true;
 
        tuplestore_putvalues(rsinfo->setResult, rsinfo->setDesc, vals, nulls);
    }
    dshash_seq_term(&status);
 
    return (Datum) 0;
}

References CStringGetTextDatum, dshash_seq_init(), dshash_seq_next(), dshash_seq_term(), dsm_registry_table, DSMR_ENTRY_TYPE_DSM, DSMREntryTypeNames, init_dsm_registry(), InitMaterializedSRF(), Int64GetDatum(), MAT_SRF_USE_EXPECTED_DESC, MemoryContextSwitchTo(), ReturnSetInfo::setDesc, ReturnSetInfo::setResult, TopMemoryContext, and tuplestore_putvalues().

Variable Documentation

dsh_params

const dshash_parameters dsh_params

static

Initial value:

= {
    offsetof(DSMRegistryEntry, type),
    sizeof(DSMRegistryEntry),
    dshash_strcmp,
    dshash_strhash,
    dshash_strcpy,
    LWTRANCHE_DSM_REGISTRY_HASH
}

Definition at line 105 of file dsm_registry.c.

Referenced by init_dsm_registry().

dsm_registry_dsa

dsa_area* dsm_registry_dsa

static

Definition at line 114 of file dsm_registry.c.

Referenced by init_dsm_registry().

dsm_registry_table

dshash_table* dsm_registry_table

static

Definition at line 115 of file dsm_registry.c.

Referenced by GetNamedDSA(), GetNamedDSHash(), GetNamedDSMSegment(), init_dsm_registry(), and pg_get_dsm_registry_allocations().

DSMRegistryCtx

DSMRegistryCtxStruct* DSMRegistryCtx

static

Definition at line 57 of file dsm_registry.c.

Referenced by DSMRegistryShmemInit(), and init_dsm_registry().

DSMREntryTypeNames

const char* const DSMREntryTypeNames[]

static

Initial value:

=
{
    [DSMR_ENTRY_TYPE_DSM] = "segment",
    [DSMR_ENTRY_TYPE_DSA] = "area",
    [DSMR_ENTRY_TYPE_DSH] = "hash",
}

Definition at line 85 of file dsm_registry.c.

Referenced by pg_get_dsm_registry_allocations().