Main Page | Modules | Namespace List | Alphabetical List | Data Structures | Directories | File List | Data Fields | Globals | Related Pages | Examples

Shared Memory Routines


Typedefs

typedef 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_t * pool
const char * filename

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

APR_DECLARE (  apr_size_t   )  const
 

Retrieve the length of a shared memory segment in bytes.

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

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:
m The shared memory segment from which to retrieve the base address.

APR_DECLARE (  apr_status_t   ) 
 

Create and make accessable a shared memory segment.

Parameters:
m The shared memory structure to create.
reqsize The desired size of the segment.
filename The file to use for shared memory on platforms that require it.
pool the 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.

Definition at line 24 of file netware/dso.c.

APR_POOL_DECLARE_ACCESSOR (  shm   ) 
 

Get the pool used by this shared memory segment.

Variable Documentation

const char * filename
 

Definition at line 89 of file apr_shm.h.

Referenced by AP_DECLARE(), ap_proxy_send_dir_filter(), dav_fs_get_resource(), find_desc(), make_variant_list(), revision_suffix(), and translate_userdir().

const char* filename
 

Definition at line 89 of file apr_shm.h.

const char apr_pool_t* pool
 

Definition at line 89 of file apr_shm.h.

apr_size_t reqsize
 

Definition at line 101 of file apr_rmm.h.