Main Page   Class Hierarchy   Alphabetical List   Compound List   File List   Compound Members   File Members   Related Pages  

ACE_Pagefile_Memory_Pool Class Reference

Make a memory pool that is based on "anonymous" memory regions allocated from the Win32 page file. More...

#include <Memory_Pool.h>

Collaboration diagram for ACE_Pagefile_Memory_Pool:

Collaboration graph
[legend]
List of all members.

Public Types

typedef ACE_Pagefile_Memory_Pool_Options OPTIONS

Public Methods

 ACE_Pagefile_Memory_Pool (const ACE_TCHAR *backing_store_name = 0, const OPTIONS *options = 0)
 Initialize the pool.

void* init_acquire (size_t nbytes, size_t &rounded_bytes, int &first_time)
 Ask system for initial chunk of shared memory.

void* acquire (size_t nbytes, size_t &rounded_bytes)
 Acquire at least <nbytes> from the memory pool. <rounded_bytes> is the actual number of bytes allocated.

int release (void)
 Instruct the memory pool to release all of its resources.

virtual int seh_selector (void *)
int remap (void *addr)
size_t round_to_page_size (size_t nbytes)
 Round up to system page size.

size_t round_to_chunk_size (size_t nbytes)
 Round up to the chunk size required by the operation system.

int sync (ssize_t = -1, int = MS_SYNC)
int sync (void *, size_t, int = MS_SYNC)
int protect (ssize_t = -1, int = PROT_RDWR)
int protect (void *, size_t, int = PROT_RDWR)
void dump (void) const

Protected Methods

int map (int &firstTime, int appendBytes = 0)
int unmap (void)
 Release the mapping.


Private Attributes

Control_Block local_cb_
 Description of what our process mapped.

Control_Blockshared_cb_
 Shared memory pool statistics.

ACE_HANDLE object_handle_
 File mapping handle.

size_t page_size_
 System page size.

ACE_TCHAR backing_store_name_ [MAXPATHLEN]
 Name of the backing store where the shared memory pool is kept.


Detailed Description

Make a memory pool that is based on "anonymous" memory regions allocated from the Win32 page file.


Member Typedef Documentation

typedef ACE_Pagefile_Memory_Pool_Options ACE_Pagefile_Memory_Pool::OPTIONS
 


Constructor & Destructor Documentation

ACE_Pagefile_Memory_Pool::ACE_Pagefile_Memory_Pool ( const ACE_TCHAR * backing_store_name = 0,
const OPTIONS * options = 0 )
 

Initialize the pool.


Member Function Documentation

void * ACE_Pagefile_Memory_Pool::acquire ( size_t nbytes,
size_t & rounded_bytes )
 

Acquire at least <nbytes> from the memory pool. <rounded_bytes> is the actual number of bytes allocated.

void ACE_Pagefile_Memory_Pool::dump ( void ) const [inline]
 

void * ACE_Pagefile_Memory_Pool::init_acquire ( size_t nbytes,
size_t & rounded_bytes,
int & first_time )
 

Ask system for initial chunk of shared memory.

int ACE_Pagefile_Memory_Pool::map ( int & firstTime,
int appendBytes = 0 ) [protected]
 

Map portions or the entire pool into the local virtual address space. To do this, we compute the new <file_offset> of the backing store and commit the memory.

int ACE_Pagefile_Memory_Pool::protect ( void *,
size_t,
int = PROT_RDWR )
 

int ACE_Pagefile_Memory_Pool::protect ( ssize_t = -1,
int = PROT_RDWR )
 

int ACE_Pagefile_Memory_Pool::release ( void )
 

Instruct the memory pool to release all of its resources.

int ACE_Pagefile_Memory_Pool::remap ( void * addr )
 

Try to extend the virtual address space so that is now covered by the address mapping. The method succeeds and returns 0 if the backing store has adequate memory to cover this address. Otherwise, it returns -1. This method is typically called by an exception handler for a Win32 structured exception when another process has grown the backing store (and its mapping) and our process now incurs a fault because our mapping isn't in range (yet).

size_t ACE_Pagefile_Memory_Pool::round_to_chunk_size ( size_t nbytes )
 

Round up to the chunk size required by the operation system.

size_t ACE_Pagefile_Memory_Pool::round_to_page_size ( size_t nbytes )
 

Round up to system page size.

int ACE_Pagefile_Memory_Pool::seh_selector ( void * ep ) [virtual]
 

Win32 Structural exception selector. The return value decides how to handle memory pool related structural exceptions. Returns 1, 0, or , -1.

int ACE_Pagefile_Memory_Pool::sync ( void *,
size_t,
int = MS_SYNC )
 

int ACE_Pagefile_Memory_Pool::sync ( ssize_t = -1,
int = MS_SYNC )
 

int ACE_Pagefile_Memory_Pool::unmap ( void ) [protected]
 

Release the mapping.


Member Data Documentation

ACE_TCHAR ACE_Pagefile_Memory_Pool::backing_store_name_[MAXPATHLEN] [private]
 

Name of the backing store where the shared memory pool is kept.

Control_Block ACE_Pagefile_Memory_Pool::local_cb_ [private]
 

Description of what our process mapped.

ACE_HANDLE ACE_Pagefile_Memory_Pool::object_handle_ [private]
 

File mapping handle.

size_t ACE_Pagefile_Memory_Pool::page_size_ [private]
 

System page size.

Control_Block * ACE_Pagefile_Memory_Pool::shared_cb_ [private]
 

Shared memory pool statistics.


The documentation for this class was generated from the following files:
Generated at Sat Dec 1 11:03:39 2001 for ACE by doxygen1.2.3 written by Dimitri van Heesch, © 1997-2000