memorymap Class Reference

Inherits object.

Public Member Functions
	memorymap ()
	~memorymap ()
bool	attach (int32_t fd, off64_t offset, size_t size, int32_t protection, int32_t flags)
bool	detach ()
void *	getData ()
size_t	getSize ()
bool	sync (bool immediate, bool invalidate)
bool	sync (off64_t offset, size_t size, bool immediate, bool invalidate)
Public Member Functions inherited from object
virtual	~object ()

Static Public Member Functions
static bool	isSupported ()

Detailed Description

The memorymap class provides methods for mapping a file (or file descriptor) to a region of memory and manipulating the mapped region.

Constructor & Destructor Documentation

memorymap()

memorymap::memorymap

(

)

Creates an instance of the memorymap class.

~memorymap()

memorymap::~memorymap

(

)

Deletes this instance of the memorymap class, calling detach() if necessary.

Member Function Documentation

attach()

bool memorymap::attach	(	int32_t	fd,
		off64_t	offset,
		size_t	size,
		int32_t	protection,
		int32_t	flags
	)

Attaches the memorymap to file descriptor "fd" at "offset" for "size" bytes.

"protection" may be: PROT_NONE - pages may not be accessed or an or'ed combination of the following: PROT_EXEC - pages may be excuted PROT_READ - pages may be read PROT_WRITE - pages may be written "protection" may not conflict with the open mode of the file. (eg. if the file was opened readonly then PROT_WRITE may not be used).

flags may be: MAP_SHARED or MAP_PRIVATE and an or'ed combination of the following: MAP_FIXED MAP_DENYWRITE MAP_EXECUTABLE MAP_NORESERVE MAP_LOCKED MAP_GROWSDOWN MAP_ANONYMOUS MAP_ANON MAP_32BIT MAP_AUTOGROW MAP_AUTORESRV MAP_COPY MAP_LOCAL

Note that not all filesystems support all of those options.

Returns true on success and false on failure.

detach()

bool memorymap::detach

(

)

detaches the memory map from the file descriptor

Returns true on success and false on failure.

getData()

void* memorymap::getData

(

)

Returns a pointer to the region of memory that the file is mapped into.

getSize()

size_t memorymap::getSize

(

)

Returns the number of bytes in the region of memory that the file is mapped into.

isSupported()

static bool memorymap::isSupported ( )

static

Returns true if the platform supports memory mapping and false otherwise.

sync() [1/2]

bool memorymap::sync	(	bool	immediate,
		bool	invalidate
	)

Make sure that changes made to the memory map have been copied to the storage mediam that the mapped file resides on.

If "immediate" is true, the method will not return until the synchronization has finished, if it is false, the synchronization will occur in the background.

If "invalidate" is true, all other mappings of the file will be invalidated.

Returns true on success and false on failure.

sync() [2/2]

bool memorymap::sync	(	off64_t	offset,
		size_t	size,
		bool	immediate,
		bool	invalidate
	)

Make sure that changes made to the memory map for "size" bytes, starting at "offset" have been copied to the storage mediam that the mapped file resides on.

If "immediate" is true, the method will not return until the synchronization has finished, if it is false, the synchronization will occur in the background.

If "invalidate" is true, all other mappings of the file will be invalidated.

Returns true on success and false on failure.