GME  13
Typedefs | Functions | Variables
Shared Memory Routines

Typedefs

typedef struct apr_shm_t apr_shm_t

Functions

 APR_DECLARE (apr_status_t) apr_shm_create(apr_shm_t **m
 APR_DECLARE (void *) apr_shm_baseaddr_get(const apr_shm_t *m)
 APR_DECLARE (apr_size_t) apr_shm_size_get(const apr_shm_t *m)
 APR_POOL_DECLARE_ACCESSOR (shm)

Variables

apr_size_t reqsize
apr_size_t const char * filename
apr_size_t const char apr_pool_tpool

Typedef Documentation

typedef struct apr_shm_t apr_shm_t

Private, platform-specific data struture representing a shared memory segment.

Definition at line 43 of file apr_shm.h.


Function Documentation

Create and make accessable a shared memory segment.

Parameters:
mThe shared memory structure to create.
reqsizeThe desired size of the segment.
filenameThe file to use for shared memory on platforms that require it.
poolthe pool from which to allocate the shared memory structure.
Remarks:
A note about Anonymous vs. Named shared memory segments: Not all plaforms support anonymous shared memory segments, but in some cases it is prefered over other types of shared memory implementations. Passing a NULL 'file' parameter to this function will cause the subsystem to use anonymous shared memory segments. If such a system is not available, APR_ENOTIMPL is returned.
A note about allocation sizes: On some platforms it is necessary to store some metainformation about the segment within the actual segment. In order to supply the caller with the requested size it may be necessary for the implementation to request a slightly greater segment length from the subsystem. In all cases, the apr_shm_baseaddr_get() function will return the first usable byte of memory.

Remove named resource associated with a shared memory segment, preventing attachments to the resource, but not destroying it.

Parameters:
filenameThe filename associated with shared-memory segment which needs to be removed
poolThe pool used for file operations
Remarks:
This function is only supported on platforms which support name-based shared memory segments, and will return APR_ENOTIMPL on platforms without such support. Removing the file while the shm is in use is not entirely portable, caller may use this to enhance obscurity of the resource, but be prepared for the the call to fail, and for concurrent attempts to create a resource of the same name to also fail. The pool cleanup of apr_shm_create (apr_shm_destroy) also removes the named resource.

Destroy a shared memory segment and associated memory.

Parameters:
mThe shared memory segment structure to destroy.

Attach to a shared memory segment that was created by another process.

Parameters:
mThe shared memory structure to create.
filenameThe file used to create the original segment. (This MUST match the original filename.)
poolthe pool from which to allocate the shared memory structure for this process.

Detach from a shared memory segment without destroying it.

Parameters:
mThe shared memory structure representing the segment to detach from.
APR_DECLARE ( void *  ) const

Retrieve the base address of the shared memory segment. NOTE: This address is only usable within the callers address space, since this API does not guarantee that other attaching processes will maintain the same address mapping.

Parameters:
mThe shared memory segment from which to retrieve the base address.
Returns:
address, aligned by APR_ALIGN_DEFAULT.
APR_DECLARE ( apr_size_t  ) const

Retrieve the length of a shared memory segment in bytes.

Parameters:
mThe shared memory segment from which to retrieve the segment length.

Get the pool used by this shared memory segment.


Variable Documentation

const char * filename

Definition at line 69 of file apr_shm.h.

const char apr_pool_t* pool

Definition at line 69 of file apr_shm.h.

apr_size_t reqsize

Definition at line 69 of file apr_shm.h.