#include <MemoryMappedFile.h>

Inheritance diagram for MemoryMapManager:

Collaboration diagram for MemoryMapManager:

Public Member Functions
MemoryMappedObject *	mapFile (File *pFile, uintptr_t &address, size_t length, MemoryMappedObject::Permissions perms, size_t offset=0, bool bCopyOnWrite=true)

MemoryMappedObject *	mapAnon (uintptr_t &address, size_t length, MemoryMappedObject::Permissions perms)

void	clone (Process *pTarget)

size_t	remove (uintptr_t base, size_t length)

size_t	setPermissions (uintptr_t base, size_t length, MemoryMappedObject::Permissions perms)

bool	contains (uintptr_t base, size_t length)

void	sync (uintptr_t base, size_t length, bool async)

void	invalidate (uintptr_t base, size_t length)

void	unmap (MemoryMappedObject *pObj)

void	unmapAll ()

virtual bool	trap (InterruptState &state, uintptr_t address, bool bIsWrite)

virtual bool	compact ()

virtual const String	getMemoryPressureDescription ()

Static Public Member Functions
static MemoryMapManager &	instance ()

Protected Member Functions
void	unmapAllUnlocked ()

bool	acquireLock ()

void	releaseLock ()

Private Types
enum	Ops { Sync, Invalidate }

typedef List< MemoryMappedObject * >	MmObjectList

Private Member Functions
	MemoryMapManager ()

bool	sanitiseAddress (uintptr_t &address, size_t length)

void	op (Ops what, uintptr_t base, size_t length, bool async)

Private Attributes
Tree< VirtualAddressSpace , MmObjectList >	m_MmObjectLists

Spinlock	m_Lock

Static Private Attributes
static MemoryMapManager	m_Instance

Friends
class	PosixSubsystem

Detailed Description

This class is a multiplexing trap handler, to handle traps for MemoryMappedObjects, dispatching them to the right place.

Definition at line 397 of file MemoryMappedFile.h.

Constructor & Destructor Documentation

MemoryMapManager::MemoryMapManager ( )

private

Default and only constructor. Registers with PageFaultHandler.

Definition at line 956 of file MemoryMappedFile.cc.

References PageFaultHandler::instance(), PageFaultHandler::registerHandler(), MemoryPressureManager::registerHandler(), and MemoryPressureManager::removeHandler().

Member Function Documentation

bool MemoryMapManager::acquireLock ( )

protected

Acquire the manager's lock.

Take this to be able to call unmapAllUnlocked; this could be used for cases where a caller cannot be rescheduled but needs to be able to unmap all mappings. That caller could acquire this lock, then become un-scheduleable, then perform the needed actions. Without this, the caller could fail if the manager's lock is taken already.

Definition at line 1670 of file MemoryMappedFile.cc.

References Spinlock::acquire(), and m_Lock.

void MemoryMapManager::clone ( Process * pTarget )

Registers the current address space's mappings with the target process.

Parameters

pTarget The process to clone into.

Definition at line 1059 of file MemoryMappedFile.cc.

References List< T, nodePoolSize >::begin(), MemoryMappedObject::clone(), List< T, nodePoolSize >::end(), Process::getAddressSpace(), Processor::information(), m_Lock, m_MmObjectLists, and List< T, nodePoolSize >::pushBack().

bool MemoryMapManager::compact ( )

virtual

Trigger a compact in all address spaces.

This may switch in and out of several address spaces.

Implements MemoryPressureHandler.

Definition at line 1606 of file MemoryMappedFile.cc.

References Processor::information(), m_MmObjectLists, NOTICE, and Processor::switchAddressSpace().

bool MemoryMapManager::contains	(	uintptr_t	base,
		size_t	length
	)

Returns true if at least one memory mapped object is in the range given, false otherwise.

Definition at line 1396 of file MemoryMappedFile.cc.

References Spinlock::acquire(), List< T, nodePoolSize >::begin(), List< T, nodePoolSize >::end(), PhysicalMemoryManager::getPageSize(), Processor::information(), MemoryMappedObject::invalidate(), m_Lock, m_MmObjectLists, MemoryMappedObject::matches(), Spinlock::release(), MemoryMappedObject::sync(), and WARNING.

static MemoryMapManager& MemoryMapManager::instance ( )

inlinestatic

Singleton instance

Definition at line 404 of file MemoryMappedFile.h.

References MemoryMappedObject::address(), MemoryMappedObject::clone(), MemoryMappedObject::compact(), MemoryMappedObject::invalidate(), MemoryMappedObject::length(), MemoryMappedObject::setPermissions(), MemoryMappedObject::sync(), MemoryMappedObject::trap(), and MemoryMappedObject::unmap().

Referenced by PosixSubsystem::checkAddress(), PosixSubsystem::exit(), PosixSubsystem::invoke(), PosixSubsystem::loadElf(), DynamicLinker::loadObject(), DynamicLinker::loadProgram(), and PosixSubsystem::~PosixSubsystem().

Here is the caller graph for this function:

void MemoryMapManager::invalidate	(	uintptr_t	base,
		size_t	length
	)

Takes any pages that differ from the backing file (ie, copied on write) and restores them to point to the backing file.

Definition at line 1471 of file MemoryMappedFile.cc.

MemoryMappedObject * MemoryMapManager::mapAnon	(	uintptr_t &	address,
		size_t	length,
		MemoryMappedObject::Permissions	perms
	)

Create a new anonymous memory mapping.

Definition at line 1016 of file MemoryMappedFile.cc.

References PhysicalMemoryManager::getPageSize(), Processor::information(), m_Lock, m_MmObjectLists, NOTICE, List< T, nodePoolSize >::pushBack(), and sanitiseAddress().

Referenced by PosixSubsystem::invoke(), and PosixSubsystem::loadElf().

Here is the caller graph for this function:

MemoryMappedObject * MemoryMapManager::mapFile	(	File *	pFile,
		uintptr_t &	address,
		size_t	length,
		MemoryMappedObject::Permissions	perms,
		size_t	offset = `0`,
		bool	bCopyOnWrite = `true`
	)