sysv_shmem.c File Reference

#include "postgres.h"
#include <signal.h>
#include <unistd.h>
#include <sys/file.h>
#include <sys/ipc.h>
#include <sys/mman.h>
#include <sys/shm.h>
#include <sys/stat.h>
#include "miscadmin.h"
#include "port/pg_bitutils.h"
#include "portability/mem.h"
#include "storage/dsm.h"
#include "storage/fd.h"
#include "storage/ipc.h"
#include "storage/pg_shmem.h"
#include "utils/guc.h"
#include "utils/guc_hooks.h"
#include "utils/pidfile.h"

Include dependency graph for sysv_shmem.c:

Go to the source code of this file.

Typedefs
typedef key_t	IpcMemoryKey
typedef int	IpcMemoryId

Enumerations
enum	IpcMemoryState {   SHMSTATE_ANALYSIS_FAILURE , SHMSTATE_ATTACHED , SHMSTATE_ENOENT , SHMSTATE_FOREIGN ,   SHMSTATE_UNATTACHED }

Functions
static void *	InternalIpcMemoryCreate (IpcMemoryKey memKey, Size size)
static void	IpcMemoryDetach (int status, Datum shmaddr)
static void	IpcMemoryDelete (int status, Datum shmId)
static IpcMemoryState	PGSharedMemoryAttach (IpcMemoryId shmId, void *attachAt, PGShmemHeader **addr)
bool	PGSharedMemoryIsInUse (unsigned long id1, unsigned long id2)
void	GetHugePageSize (Size *hugepagesize, int *mmap_flags)
bool	check_huge_page_size (int *newval, void **extra, GucSource source)
static void *	CreateAnonymousSegment (Size *size)
static void	AnonymousShmemDetach (int status, Datum arg)
PGShmemHeader *	PGSharedMemoryCreate (Size size, PGShmemHeader **shim)
void	PGSharedMemoryDetach (void)

Variables
unsigned long	UsedShmemSegID = 0
void *	UsedShmemSegAddr = NULL
static Size	AnonymousShmemSize
static void *	AnonymousShmem = NULL

Typedef Documentation

IpcMemoryId

typedef int IpcMemoryId

Definition at line 71 of file sysv_shmem.c.

IpcMemoryKey

typedef key_t IpcMemoryKey

Definition at line 70 of file sysv_shmem.c.

Enumeration Type Documentation

IpcMemoryState

enum IpcMemoryState

Enumerator
SHMSTATE_ANALYSIS_FAILURE
SHMSTATE_ATTACHED
SHMSTATE_ENOENT
SHMSTATE_FOREIGN
SHMSTATE_UNATTACHED

Definition at line 84 of file sysv_shmem.c.

{
    SHMSTATE_ANALYSIS_FAILURE,  /* unexpected failure to analyze the ID */
    SHMSTATE_ATTACHED,          /* pertinent to DataDir, has attached PIDs */
    SHMSTATE_ENOENT,            /* no segment of that ID */
    SHMSTATE_FOREIGN,           /* exists, but not pertinent to DataDir */
    SHMSTATE_UNATTACHED,        /* pertinent to DataDir, no attached PIDs */
} IpcMemoryState;

Function Documentation

AnonymousShmemDetach()

static void AnonymousShmemDetach ( int  status, Datum  arg  )

static

Definition at line 675 of file sysv_shmem.c.

{
    /* Release anonymous shared memory block, if any. */
    if (AnonymousShmem != NULL)
    {
        if (munmap(AnonymousShmem, AnonymousShmemSize) < 0)
            elog(LOG, "munmap(%p, %zu) failed: %m",
                 AnonymousShmem, AnonymousShmemSize);
        AnonymousShmem = NULL;
    }
}

References AnonymousShmem, AnonymousShmemSize, elog, and LOG.

Referenced by PGSharedMemoryCreate().

check_huge_page_size()

bool check_huge_page_size	(	int *	newval,
		void **	extra,
		GucSource	source
	)

Definition at line 578 of file sysv_shmem.c.

{
#if !(defined(MAP_HUGE_MASK) && defined(MAP_HUGE_SHIFT))
    /* Recent enough Linux only, for now.  See GetHugePageSize(). */
    if (*newval != 0)
    {
        GUC_check_errdetail("\"huge_page_size\" must be 0 on this platform.");
        return false;
    }
#endif
    return true;
}

References GUC_check_errdetail, and newval.

CreateAnonymousSegment()

static void* CreateAnonymousSegment ( Size *  size )

static

Definition at line 599 of file sysv_shmem.c.

{
    Size        allocsize = *size;
    void       *ptr = MAP_FAILED;
    int         mmap_errno = 0;
 
#ifndef MAP_HUGETLB
    /* PGSharedMemoryCreate should have dealt with this case */
    Assert(huge_pages != HUGE_PAGES_ON);
#else
    if (huge_pages == HUGE_PAGES_ON || huge_pages == HUGE_PAGES_TRY)
    {
        /*
         * Round up the request size to a suitable large value.
         */
        Size        hugepagesize;
        int         mmap_flags;
 
        GetHugePageSize(&hugepagesize, &mmap_flags);
 
        if (allocsize % hugepagesize != 0)
            allocsize += hugepagesize - (allocsize % hugepagesize);
 
        ptr = mmap(NULL, allocsize, PROT_READ | PROT_WRITE,
                   PG_MMAP_FLAGS | mmap_flags, -1, 0);
        mmap_errno = errno;
        if (huge_pages == HUGE_PAGES_TRY && ptr == MAP_FAILED)
            elog(DEBUG1, "mmap(%zu) with MAP_HUGETLB failed, huge pages disabled: %m",
                 allocsize);
    }
#endif
 
    /*
     * Report whether huge pages are in use.  This needs to be tracked before
     * the second mmap() call if attempting to use huge pages failed
     * previously.
     */
    SetConfigOption("huge_pages_status", (ptr == MAP_FAILED) ? "off" : "on",
                    PGC_INTERNAL, PGC_S_DYNAMIC_DEFAULT);
 
    if (ptr == MAP_FAILED && huge_pages != HUGE_PAGES_ON)
    {
        /*
         * Use the original size, not the rounded-up value, when falling back
         * to non-huge pages.
         */
        allocsize = *size;
        ptr = mmap(NULL, allocsize, PROT_READ | PROT_WRITE,
                   PG_MMAP_FLAGS, -1, 0);
        mmap_errno = errno;
    }
 
    if (ptr == MAP_FAILED)
    {
        errno = mmap_errno;
        ereport(FATAL,
                (errmsg("could not map anonymous shared memory: %m"),
                 (mmap_errno == ENOMEM) ?
                 errhint("This error usually means that PostgreSQL's request "
                         "for a shared memory segment exceeded available memory, "
                         "swap space, or huge pages. To reduce the request size "
                         "(currently %zu bytes), reduce PostgreSQL's shared "
                         "memory usage, perhaps by reducing \"shared_buffers\" or "
                         "\"max_connections\".",
                         allocsize) : 0));
    }
 
    *size = allocsize;
    return ptr;
}

References Assert, DEBUG1, elog, ereport, errhint(), errmsg(), FATAL, GetHugePageSize(), huge_pages, HUGE_PAGES_ON, HUGE_PAGES_TRY, MAP_FAILED, PG_MMAP_FLAGS, PGC_INTERNAL, PGC_S_DYNAMIC_DEFAULT, SetConfigOption(), and size.

Referenced by PGSharedMemoryCreate().

GetHugePageSize()

void GetHugePageSize	(	Size *	hugepagesize,
		int *	mmap_flags
	)

Definition at line 479 of file sysv_shmem.c.

{
#ifdef MAP_HUGETLB
 
    Size        default_hugepagesize = 0;
    Size        hugepagesize_local = 0;
    int         mmap_flags_local = 0;
 
    /*
     * System-dependent code to find out the default huge page size.
     *
     * On Linux, read /proc/meminfo looking for a line like "Hugepagesize:
     * nnnn kB".  Ignore any failures, falling back to the preset default.
     */
#ifdef __linux__
 
    {
        FILE       *fp = AllocateFile("/proc/meminfo", "r");
        char        buf[128];
        unsigned int sz;
        char        ch;
 
        if (fp)
        {
            while (fgets(buf, sizeof(buf), fp))
            {
                if (sscanf(buf, "Hugepagesize: %u %c", &sz, &ch) == 2)
                {
                    if (ch == 'k')
                    {
                        default_hugepagesize = sz * (Size) 1024;
                        break;
                    }
                    /* We could accept other units besides kB, if needed */
                }
            }
            FreeFile(fp);
        }
    }
#endif                          /* __linux__ */
 
    if (huge_page_size != 0)
    {
        /* If huge page size is requested explicitly, use that. */
        hugepagesize_local = (Size) huge_page_size * 1024;
    }
    else if (default_hugepagesize != 0)
    {
        /* Otherwise use the system default, if we have it. */
        hugepagesize_local = default_hugepagesize;
    }
    else
    {
        /*
         * If we fail to find out the system's default huge page size, or no
         * huge page size is requested explicitly, assume it is 2MB. This will
         * work fine when the actual size is less.  If it's more, we might get
         * mmap() or munmap() failures due to unaligned requests; but at this
         * writing, there are no reports of any non-Linux systems being picky
         * about that.
         */
        hugepagesize_local = 2 * 1024 * 1024;
    }
 
    mmap_flags_local = MAP_HUGETLB;
 
    /*
     * On recent enough Linux, also include the explicit page size, if
     * necessary.
     */
#if defined(MAP_HUGE_MASK) && defined(MAP_HUGE_SHIFT)
    if (hugepagesize_local != default_hugepagesize)
    {
        int         shift = pg_ceil_log2_64(hugepagesize_local);
 
        mmap_flags_local |= (shift & MAP_HUGE_MASK) << MAP_HUGE_SHIFT;
    }
#endif
 
    /* assign the results found */
    if (mmap_flags)
        *mmap_flags = mmap_flags_local;
    if (hugepagesize)
        *hugepagesize = hugepagesize_local;
 
#else
 
    if (hugepagesize)
        *hugepagesize = 0;
    if (mmap_flags)
        *mmap_flags = 0;
 
#endif                          /* MAP_HUGETLB */
}

References AllocateFile(), buf, FreeFile(), huge_page_size, and pg_ceil_log2_64().

Referenced by CreateAnonymousSegment(), and InitializeShmemGUCs().

InternalIpcMemoryCreate()

static void * InternalIpcMemoryCreate ( IpcMemoryKey  memKey, Size  size  )

static

Definition at line 121 of file sysv_shmem.c.

{
    IpcMemoryId shmid;
    void       *requestedAddress = NULL;
    void       *memAddress;
 
    /*
     * Normally we just pass requestedAddress = NULL to shmat(), allowing the
     * system to choose where the segment gets mapped.  But in an EXEC_BACKEND
     * build, it's possible for whatever is chosen in the postmaster to not
     * work for backends, due to variations in address space layout.  As a
     * rather klugy workaround, allow the user to specify the address to use
     * via setting the environment variable PG_SHMEM_ADDR.  (If this were of
     * interest for anything except debugging, we'd probably create a cleaner
     * and better-documented way to set it, such as a GUC.)
     */
#ifdef EXEC_BACKEND
    {
        char       *pg_shmem_addr = getenv("PG_SHMEM_ADDR");
 
        if (pg_shmem_addr)
            requestedAddress = (void *) strtoul(pg_shmem_addr, NULL, 0);
        else
        {
#if defined(__darwin__) && SIZEOF_VOID_P == 8
            /*
             * Provide a default value that is believed to avoid problems with
             * ASLR on the current macOS release.
             */
            requestedAddress = (void *) 0x80000000000;
#endif
        }
    }
#endif
 
    shmid = shmget(memKey, size, IPC_CREAT | IPC_EXCL | IPCProtection);
 
    if (shmid < 0)
    {
        int         shmget_errno = errno;
 
        /*
         * Fail quietly if error indicates a collision with existing segment.
         * One would expect EEXIST, given that we said IPC_EXCL, but perhaps
         * we could get a permission violation instead?  Also, EIDRM might
         * occur if an old seg is slated for destruction but not gone yet.
         */
        if (shmget_errno == EEXIST || shmget_errno == EACCES
#ifdef EIDRM
            || shmget_errno == EIDRM
#endif
            )
            return NULL;
 
        /*
         * Some BSD-derived kernels are known to return EINVAL, not EEXIST, if
         * there is an existing segment but it's smaller than "size" (this is
         * a result of poorly-thought-out ordering of error tests). To
         * distinguish between collision and invalid size in such cases, we
         * make a second try with size = 0.  These kernels do not test size
         * against SHMMIN in the preexisting-segment case, so we will not get
         * EINVAL a second time if there is such a segment.
         */
        if (shmget_errno == EINVAL)
        {
            shmid = shmget(memKey, 0, IPC_CREAT | IPC_EXCL | IPCProtection);
 
            if (shmid < 0)
            {
                /* As above, fail quietly if we verify a collision */
                if (errno == EEXIST || errno == EACCES
#ifdef EIDRM
                    || errno == EIDRM
#endif
                    )
                    return NULL;
                /* Otherwise, fall through to report the original error */
            }
            else
            {
                /*
                 * On most platforms we cannot get here because SHMMIN is
                 * greater than zero.  However, if we do succeed in creating a
                 * zero-size segment, free it and then fall through to report
                 * the original error.
                 */
                if (shmctl(shmid, IPC_RMID, NULL) < 0)
                    elog(LOG, "shmctl(%d, %d, 0) failed: %m",
                         (int) shmid, IPC_RMID);
            }
        }
 
        /*
         * Else complain and abort.
         *
         * Note: at this point EINVAL should mean that either SHMMIN or SHMMAX
         * is violated.  SHMALL violation might be reported as either ENOMEM
         * (BSDen) or ENOSPC (Linux); the Single Unix Spec fails to say which
         * it should be.  SHMMNI violation is ENOSPC, per spec.  Just plain
         * not-enough-RAM is ENOMEM.
         */
        errno = shmget_errno;
        ereport(FATAL,
                (errmsg("could not create shared memory segment: %m"),
                 errdetail("Failed system call was shmget(key=%lu, size=%zu, 0%o).",
                           (unsigned long) memKey, size,
                           IPC_CREAT | IPC_EXCL | IPCProtection),
                 (shmget_errno == EINVAL) ?
                 errhint("This error usually means that PostgreSQL's request for a shared memory "
                         "segment exceeded your kernel's SHMMAX parameter, or possibly that "
                         "it is less than "
                         "your kernel's SHMMIN parameter.\n"
                         "The PostgreSQL documentation contains more information about shared "
                         "memory configuration.") : 0,
                 (shmget_errno == ENOMEM) ?
                 errhint("This error usually means that PostgreSQL's request for a shared "
                         "memory segment exceeded your kernel's SHMALL parameter.  You might need "
                         "to reconfigure the kernel with larger SHMALL.\n"
                         "The PostgreSQL documentation contains more information about shared "
                         "memory configuration.") : 0,
                 (shmget_errno == ENOSPC) ?
                 errhint("This error does *not* mean that you have run out of disk space.  "
                         "It occurs either if all available shared memory IDs have been taken, "
                         "in which case you need to raise the SHMMNI parameter in your kernel, "
                         "or because the system's overall limit for shared memory has been "
                         "reached.\n"
                         "The PostgreSQL documentation contains more information about shared "
                         "memory configuration.") : 0));
    }
 
    /* Register on-exit routine to delete the new segment */
    on_shmem_exit(IpcMemoryDelete, Int32GetDatum(shmid));
 
    /* OK, should be able to attach to the segment */
    memAddress = shmat(shmid, requestedAddress, PG_SHMAT_FLAGS);
 
    if (memAddress == (void *) -1)
        elog(FATAL, "shmat(id=%d, addr=%p, flags=0x%x) failed: %m",
             shmid, requestedAddress, PG_SHMAT_FLAGS);
 
    /* Register on-exit routine to detach new segment before deleting */
    on_shmem_exit(IpcMemoryDetach, PointerGetDatum(memAddress));
 
    /*
     * Store shmem key and ID in data directory lockfile.  Format to try to
     * keep it the same length always (trailing junk in the lockfile won't
     * hurt, but might confuse humans).
     */
    {
        char        line[64];
 
        sprintf(line, "%9lu %9lu",
                (unsigned long) memKey, (unsigned long) shmid);
        AddToDataDirLockFile(LOCK_FILE_LINE_SHMEM_KEY, line);
    }
 
    return memAddress;
}

References AddToDataDirLockFile(), EIDRM, elog, ereport, errdetail(), errhint(), errmsg(), FATAL, Int32GetDatum(), IPC_CREAT, IPC_EXCL, IPC_RMID, IpcMemoryDelete(), IpcMemoryDetach(), IPCProtection, LOCK_FILE_LINE_SHMEM_KEY, LOG, on_shmem_exit(), PG_SHMAT_FLAGS, PointerGetDatum(), size, and sprintf.

Referenced by PGSharedMemoryCreate().

IpcMemoryDelete()

static void IpcMemoryDelete ( int  status, Datum  shmId  )

static

Definition at line 298 of file sysv_shmem.c.

{
    if (shmctl(DatumGetInt32(shmId), IPC_RMID, NULL) < 0)
        elog(LOG, "shmctl(%d, %d, 0) failed: %m",
             DatumGetInt32(shmId), IPC_RMID);
}

References DatumGetInt32(), elog, IPC_RMID, and LOG.

Referenced by InternalIpcMemoryCreate().

IpcMemoryDetach()

static void IpcMemoryDetach ( int  status, Datum  shmaddr  )

static

Definition at line 286 of file sysv_shmem.c.

{
    /* Detach System V shared memory block. */
    if (shmdt((void *) DatumGetPointer(shmaddr)) < 0)
        elog(LOG, "shmdt(%p) failed: %m", DatumGetPointer(shmaddr));
}

References DatumGetPointer(), elog, and LOG.

Referenced by InternalIpcMemoryCreate().

PGSharedMemoryAttach()

static IpcMemoryState PGSharedMemoryAttach ( IpcMemoryId  shmId, void *  attachAt, PGShmemHeader **  addr  )

static

Definition at line 347 of file sysv_shmem.c.

{
    struct shmid_ds shmStat;
    struct stat statbuf;
    PGShmemHeader *hdr;
 
    *addr = NULL;
 
    /*
     * First, try to stat the shm segment ID, to see if it exists at all.
     */
    if (shmctl(shmId, IPC_STAT, &shmStat) < 0)
    {
        /*
         * EINVAL actually has multiple possible causes documented in the
         * shmctl man page, but we assume it must mean the segment no longer
         * exists.
         */
        if (errno == EINVAL)
            return SHMSTATE_ENOENT;
 
        /*
         * EACCES implies we have no read permission, which means it is not a
         * Postgres shmem segment (or at least, not one that is relevant to
         * our data directory).
         */
        if (errno == EACCES)
            return SHMSTATE_FOREIGN;
 
        /*
         * Some Linux kernel versions (in fact, all of them as of July 2007)
         * sometimes return EIDRM when EINVAL is correct.  The Linux kernel
         * actually does not have any internal state that would justify
         * returning EIDRM, so we can get away with assuming that EIDRM is
         * equivalent to EINVAL on that platform.
         */
#ifdef HAVE_LINUX_EIDRM_BUG
        if (errno == EIDRM)
            return SHMSTATE_ENOENT;
#endif
 
        /*
         * Otherwise, we had better assume that the segment is in use.  The
         * only likely case is (non-Linux, assumed spec-compliant) EIDRM,
         * which implies that the segment has been IPC_RMID'd but there are
         * still processes attached to it.
         */
        return SHMSTATE_ANALYSIS_FAILURE;
    }
 
    /*
     * Try to attach to the segment and see if it matches our data directory.
     * This avoids any risk of duplicate-shmem-key conflicts on machines that
     * are running several postmasters under the same userid.
     *
     * (When we're called from PGSharedMemoryCreate, this stat call is
     * duplicative; but since this isn't a high-traffic case it's not worth
     * trying to optimize.)
     */
    if (stat(DataDir, &statbuf) < 0)
        return SHMSTATE_ANALYSIS_FAILURE;   /* can't stat; be conservative */
 
    hdr = (PGShmemHeader *) shmat(shmId, attachAt, PG_SHMAT_FLAGS);
    if (hdr == (PGShmemHeader *) -1)
    {
        /*
         * Attachment failed.  The cases we're interested in are the same as
         * for the shmctl() call above.  In particular, note that the owning
         * postmaster could have terminated and removed the segment between
         * shmctl() and shmat().
         *
         * If attachAt isn't NULL, it's possible that EINVAL reflects a
         * problem with that address not a vanished segment, so it's best to
         * pass NULL when probing for conflicting segments.
         */
        if (errno == EINVAL)
            return SHMSTATE_ENOENT; /* segment disappeared */
        if (errno == EACCES)
            return SHMSTATE_FOREIGN;    /* must be non-Postgres */
#ifdef HAVE_LINUX_EIDRM_BUG
        if (errno == EIDRM)
            return SHMSTATE_ENOENT; /* segment disappeared */
#endif
        /* Otherwise, be conservative. */
        return SHMSTATE_ANALYSIS_FAILURE;
    }
    *addr = hdr;
 
    if (hdr->magic != PGShmemMagic ||
        hdr->device != statbuf.st_dev ||
        hdr->inode != statbuf.st_ino)
    {
        /*
         * It's either not a Postgres segment, or not one for my data
         * directory.
         */
        return SHMSTATE_FOREIGN;
    }
 
    /*
     * It does match our data directory, so now test whether any processes are
     * still attached to it.  (We are, now, but the shm_nattch result is from
     * before we attached to it.)
     */
    return shmStat.shm_nattch == 0 ? SHMSTATE_UNATTACHED : SHMSTATE_ATTACHED;
}

References DataDir, EIDRM, IPC_STAT, PG_SHMAT_FLAGS, PGShmemMagic, SHMSTATE_ANALYSIS_FAILURE, SHMSTATE_ATTACHED, SHMSTATE_ENOENT, SHMSTATE_FOREIGN, SHMSTATE_UNATTACHED, stat::st_dev, stat::st_ino, and stat.

Referenced by PGSharedMemoryCreate(), and PGSharedMemoryIsInUse().

PGSharedMemoryCreate()

PGShmemHeader* PGSharedMemoryCreate	(	Size	size,
		PGShmemHeader **	shim
	)

Definition at line 700 of file sysv_shmem.c.

{
    IpcMemoryKey NextShmemSegID;
    void       *memAddress;
    PGShmemHeader *hdr;
    struct stat statbuf;
    Size        sysvsize;
 
    /*
     * We use the data directory's ID info (inode and device numbers) to
     * positively identify shmem segments associated with this data dir, and
     * also as seeds for searching for a free shmem key.
     */
    if (stat(DataDir, &statbuf) < 0)
        ereport(FATAL,
                (errcode_for_file_access(),
                 errmsg("could not stat data directory \"%s\": %m",
                        DataDir)));
 
    /* Complain if hugepages demanded but we can't possibly support them */
#if !defined(MAP_HUGETLB)
    if (huge_pages == HUGE_PAGES_ON)
        ereport(ERROR,
                (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
                 errmsg("huge pages not supported on this platform")));
#endif
 
    /* For now, we don't support huge pages in SysV memory */
    if (huge_pages == HUGE_PAGES_ON && shared_memory_type != SHMEM_TYPE_MMAP)
        ereport(ERROR,
                (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
                 errmsg("huge pages not supported with the current \"shared_memory_type\" setting")));
 
    /* Room for a header? */
    Assert(size > MAXALIGN(sizeof(PGShmemHeader)));
 
    if (shared_memory_type == SHMEM_TYPE_MMAP)
    {
        AnonymousShmem = CreateAnonymousSegment(&size);
        AnonymousShmemSize = size;
 
        /* Register on-exit routine to unmap the anonymous segment */
        on_shmem_exit(AnonymousShmemDetach, (Datum) 0);
 
        /* Now we need only allocate a minimal-sized SysV shmem block. */
        sysvsize = sizeof(PGShmemHeader);
    }
    else
    {
        sysvsize = size;
 
        /* huge pages are only available with mmap */
        SetConfigOption("huge_pages_status", "off",
                        PGC_INTERNAL, PGC_S_DYNAMIC_DEFAULT);
    }
 
    /*
     * Loop till we find a free IPC key.  Trust CreateDataDirLockFile() to
     * ensure no more than one postmaster per data directory can enter this
     * loop simultaneously.  (CreateDataDirLockFile() does not entirely ensure
     * that, but prefer fixing it over coping here.)
     */
    NextShmemSegID = statbuf.st_ino;
 
    for (;;)
    {
        IpcMemoryId shmid;
        PGShmemHeader *oldhdr;
        IpcMemoryState state;
 
        /* Try to create new segment */
        memAddress = InternalIpcMemoryCreate(NextShmemSegID, sysvsize);
        if (memAddress)
            break;              /* successful create and attach */
 
        /* Check shared memory and possibly remove and recreate */
 
        /*
         * shmget() failure is typically EACCES, hence SHMSTATE_FOREIGN.
         * ENOENT, a narrow possibility, implies SHMSTATE_ENOENT, but one can
         * safely treat SHMSTATE_ENOENT like SHMSTATE_FOREIGN.
         */
        shmid = shmget(NextShmemSegID, sizeof(PGShmemHeader), 0);
        if (shmid < 0)
        {
            oldhdr = NULL;
            state = SHMSTATE_FOREIGN;
        }
        else
            state = PGSharedMemoryAttach(shmid, NULL, &oldhdr);
 
        switch (state)
        {
            case SHMSTATE_ANALYSIS_FAILURE:
            case SHMSTATE_ATTACHED:
                ereport(FATAL,
                        (errcode(ERRCODE_LOCK_FILE_EXISTS),
                         errmsg("pre-existing shared memory block (key %lu, ID %lu) is still in use",
                                (unsigned long) NextShmemSegID,
                                (unsigned long) shmid),
                         errhint("Terminate any old server processes associated with data directory \"%s\".",
                                 DataDir)));
                break;
            case SHMSTATE_ENOENT:
 
                /*
                 * To our surprise, some other process deleted since our last
                 * InternalIpcMemoryCreate().  Moments earlier, we would have
                 * seen SHMSTATE_FOREIGN.  Try that same ID again.
                 */
                elog(LOG,
                     "shared memory block (key %lu, ID %lu) deleted during startup",
                     (unsigned long) NextShmemSegID,
                     (unsigned long) shmid);
                break;
            case SHMSTATE_FOREIGN:
                NextShmemSegID++;
                break;
            case SHMSTATE_UNATTACHED:
 
                /*
                 * The segment pertains to DataDir, and every process that had
                 * used it has died or detached.  Zap it, if possible, and any
                 * associated dynamic shared memory segments, as well.  This
                 * shouldn't fail, but if it does, assume the segment belongs
                 * to someone else after all, and try the next candidate.
                 * Otherwise, try again to create the segment.  That may fail
                 * if some other process creates the same shmem key before we
                 * do, in which case we'll try the next key.
                 */
                if (oldhdr->dsm_control != 0)
                    dsm_cleanup_using_control_segment(oldhdr->dsm_control);
                if (shmctl(shmid, IPC_RMID, NULL) < 0)
                    NextShmemSegID++;
                break;
        }
 
        if (oldhdr && shmdt((void *) oldhdr) < 0)
            elog(LOG, "shmdt(%p) failed: %m", oldhdr);
    }
 
    /* Initialize new segment. */
    hdr = (PGShmemHeader *) memAddress;
    hdr->creatorPID = getpid();
    hdr->magic = PGShmemMagic;
    hdr->dsm_control = 0;
 
    /* Fill in the data directory ID info, too */
    hdr->device = statbuf.st_dev;
    hdr->inode = statbuf.st_ino;
 
    /*
     * Initialize space allocation status for segment.
     */
    hdr->totalsize = size;
    hdr->freeoffset = MAXALIGN(sizeof(PGShmemHeader));
    *shim = hdr;
 
    /* Save info for possible future use */
    UsedShmemSegAddr = memAddress;
    UsedShmemSegID = (unsigned long) NextShmemSegID;
 
    /*
     * If AnonymousShmem is NULL here, then we're not using anonymous shared
     * memory, and should return a pointer to the System V shared memory
     * block. Otherwise, the System V shared memory block is only a shim, and
     * we must return a pointer to the real block.
     */
    if (AnonymousShmem == NULL)
        return hdr;
    memcpy(AnonymousShmem, hdr, sizeof(PGShmemHeader));
    return (PGShmemHeader *) AnonymousShmem;
}

References AnonymousShmem, AnonymousShmemDetach(), AnonymousShmemSize, Assert, CreateAnonymousSegment(), PGShmemHeader::creatorPID, DataDir, PGShmemHeader::device, dsm_cleanup_using_control_segment(), PGShmemHeader::dsm_control, elog, ereport, errcode(), errcode_for_file_access(), errhint(), errmsg(), ERROR, FATAL, PGShmemHeader::freeoffset, huge_pages, HUGE_PAGES_ON, PGShmemHeader::inode, InternalIpcMemoryCreate(), IPC_RMID, LOG, PGShmemHeader::magic, MAXALIGN, on_shmem_exit(), PGC_INTERNAL, PGC_S_DYNAMIC_DEFAULT, PGSharedMemoryAttach(), PGShmemMagic, SetConfigOption(), shared_memory_type, SHMEM_TYPE_MMAP, SHMSTATE_ANALYSIS_FAILURE, SHMSTATE_ATTACHED, SHMSTATE_ENOENT, SHMSTATE_FOREIGN, SHMSTATE_UNATTACHED, size, stat::st_dev, stat::st_ino, stat, PGShmemHeader::totalsize, UsedShmemSegAddr, and UsedShmemSegID.

Referenced by CreateSharedMemoryAndSemaphores().

PGSharedMemoryDetach()

void PGSharedMemoryDetach

(

void

)

Definition at line 970 of file sysv_shmem.c.

{
    if (UsedShmemSegAddr != NULL)
    {
        if ((shmdt(UsedShmemSegAddr) < 0)
#if defined(EXEC_BACKEND) && defined(__CYGWIN__)
        /* Work-around for cygipc exec bug */
            && shmdt(NULL) < 0
#endif
            )
            elog(LOG, "shmdt(%p) failed: %m", UsedShmemSegAddr);
        UsedShmemSegAddr = NULL;
    }
 
    if (AnonymousShmem != NULL)
    {
        if (munmap(AnonymousShmem, AnonymousShmemSize) < 0)
            elog(LOG, "munmap(%p, %zu) failed: %m",
                 AnonymousShmem, AnonymousShmemSize);
        AnonymousShmem = NULL;
    }
}

References AnonymousShmem, AnonymousShmemSize, elog, LOG, and UsedShmemSegAddr.

Referenced by postmaster_child_launch().

PGSharedMemoryIsInUse()

bool PGSharedMemoryIsInUse	(	unsigned long	id1,
		unsigned long	id2
	)

Definition at line 317 of file sysv_shmem.c.

{
    PGShmemHeader *memAddress;
    IpcMemoryState state;
 
    state = PGSharedMemoryAttach((IpcMemoryId) id2, NULL, &memAddress);
    if (memAddress && shmdt((void *) memAddress) < 0)
        elog(LOG, "shmdt(%p) failed: %m", memAddress);
    switch (state)
    {
        case SHMSTATE_ENOENT:
        case SHMSTATE_FOREIGN:
        case SHMSTATE_UNATTACHED:
            return false;
        case SHMSTATE_ANALYSIS_FAILURE:
        case SHMSTATE_ATTACHED:
            return true;
    }
    return true;
}

References elog, LOG, PGSharedMemoryAttach(), SHMSTATE_ANALYSIS_FAILURE, SHMSTATE_ATTACHED, SHMSTATE_ENOENT, SHMSTATE_FOREIGN, and SHMSTATE_UNATTACHED.

Referenced by CreateLockFile().

Variable Documentation

AnonymousShmem

void* AnonymousShmem = NULL

static

Definition at line 98 of file sysv_shmem.c.

Referenced by AnonymousShmemDetach(), PGSharedMemoryCreate(), and PGSharedMemoryDetach().

AnonymousShmemSize

Size AnonymousShmemSize

static

Definition at line 97 of file sysv_shmem.c.

Referenced by AnonymousShmemDetach(), PGSharedMemoryCreate(), and PGSharedMemoryDetach().

UsedShmemSegAddr

void* UsedShmemSegAddr = NULL

Definition at line 95 of file sysv_shmem.c.

Referenced by PGSharedMemoryCreate(), and PGSharedMemoryDetach().

UsedShmemSegID

unsigned long UsedShmemSegID = 0

Definition at line 94 of file sysv_shmem.c.

Referenced by PGSharedMemoryCreate().