PoolManager.h File Reference

Headers of pool manager. More...

Go to the source code of this file.

Classes
struct	_POOL_TABLE
	Table of holding pools detail structure. More...
struct	_REQUEST_NEW_ALLOCATION
	Manage the requests for new allocations. More...

Macros
#define	MaximumRequestsQueueDepth   300
	Maximum Pool Requests (while not allocated)
#define	NumberOfPreAllocatedBuffers   10

Typedefs
typedef struct _POOL_TABLE	POOL_TABLE
	Table of holding pools detail structure.
typedef struct _POOL_TABLE *	PPOOL_TABLE
typedef struct _REQUEST_NEW_ALLOCATION	REQUEST_NEW_ALLOCATION
	Manage the requests for new allocations.
typedef struct _REQUEST_NEW_ALLOCATION *	PREQUEST_NEW_ALLOCATION

Functions
BOOLEAN	PoolManagerInitialize ()
	Initializes the Pool Manager and pre-allocate some pools.
VOID	PoolManagerUninitialize ()
	De-allocate all the allocated pools.

Variables
REQUEST_NEW_ALLOCATION *	g_RequestNewAllocation
	If sb wants allocation from vmx root, adds it's request to this structure.
volatile LONG	LockForRequestAllocation
	Request allocation Spinlock.
volatile LONG	LockForReadingPool
	Spinlock for reading pool.
BOOLEAN	g_IsNewRequestForAllocationReceived
	We set it when there is a new allocation.
BOOLEAN	g_IsNewRequestForDeAllocation
	We set it when there is a new allocation.
LIST_ENTRY	g_ListOfAllocatedPoolsHead
	Create a list from all pools.

Detailed Description

Headers of pool manager.

Author

Sina Karvandi (sina@.nosp@m.hype.nosp@m.rdbg..nosp@m.org)

Version

0.1

Date

2020-04-11

Copyright

This project is released under the GNU Public License v3.

Macro Definition Documentation

MaximumRequestsQueueDepth

#define MaximumRequestsQueueDepth   300

Maximum Pool Requests (while not allocated)

NumberOfPreAllocatedBuffers

#define NumberOfPreAllocatedBuffers   10

Typedef Documentation

POOL_TABLE

typedef struct _POOL_TABLE POOL_TABLE

Table of holding pools detail structure.

PPOOL_TABLE

typedef struct _POOL_TABLE * PPOOL_TABLE

PREQUEST_NEW_ALLOCATION

typedef struct _REQUEST_NEW_ALLOCATION * PREQUEST_NEW_ALLOCATION

REQUEST_NEW_ALLOCATION

typedef struct _REQUEST_NEW_ALLOCATION REQUEST_NEW_ALLOCATION

Manage the requests for new allocations.

Function Documentation

PoolManagerInitialize()

BOOLEAN PoolManagerInitialize

(

)

Initializes the Pool Manager and pre-allocate some pools.

Returns

BOOLEAN

Initializes the Pool Manager and pre-allocate some pools.

Returns

BOOLEAN

{
    //
    // Allocate global requesting variable
    //
    SIZE_T BufferSize = MaximumRequestsQueueDepth * sizeof(REQUEST_NEW_ALLOCATION);
    if (!PlmgrAllocateRequestNewAllocation(BufferSize))
    {
        LogError("Err, insufficient memory");
        return FALSE;
    }
 
    //
    // Initialize list head
    //
    InitializeListHead(&g_ListOfAllocatedPoolsHead);
 
    //
    // Nothing to deallocate
    //
    g_IsNewRequestForDeAllocation = FALSE;
 
    //
    // Initialized successfully
    //
    return TRUE;
}

PoolManagerUninitialize()

VOID PoolManagerUninitialize

(

)

De-allocate all the allocated pools.

Returns

VOID

De-allocate all the allocated pools.

Returns

VOID

{
    PLIST_ENTRY ListTemp = 0;
    ListTemp             = &g_ListOfAllocatedPoolsHead;
 
    SpinlockLock(&LockForReadingPool);
 
    while (&g_ListOfAllocatedPoolsHead != ListTemp->Flink)
    {
        ListTemp = ListTemp->Flink;
 
        //
        // Get the head of the record
        //
        PPOOL_TABLE PoolTable = (PPOOL_TABLE)CONTAINING_RECORD(ListTemp, POOL_TABLE, PoolsList);
 
        //
        // Free the alloocated buffer (if not already changed)
        //
        if (!PoolTable->AlreadyFreed)
        {
            PlatformMemFreePool((PVOID)PoolTable->Address);
        }
 
        //
        // Unlink the PoolTable
        //
        RemoveEntryList(&PoolTable->PoolsList);
 
        //
        // Free the record itself
        //
        PlatformMemFreePool(PoolTable);
    }
 
    SpinlockUnlock(&LockForReadingPool);
 
    PlmgrFreeRequestNewAllocation();
}

Variable Documentation

g_IsNewRequestForAllocationReceived

BOOLEAN g_IsNewRequestForAllocationReceived

We set it when there is a new allocation.

g_IsNewRequestForDeAllocation

BOOLEAN g_IsNewRequestForDeAllocation

We set it when there is a new allocation.

g_ListOfAllocatedPoolsHead

LIST_ENTRY g_ListOfAllocatedPoolsHead

Create a list from all pools.

g_RequestNewAllocation

REQUEST_NEW_ALLOCATION* g_RequestNewAllocation

If sb wants allocation from vmx root, adds it's request to this structure.

LockForReadingPool

volatile LONG LockForReadingPool

Spinlock for reading pool.

LockForRequestAllocation

volatile LONG LockForRequestAllocation

Request allocation Spinlock.