summaryrefslogtreecommitdiffhomepage
path: root/dev/Kernel/KernelKit/Heap.h
blob: ac6cac4187b53c63ca15aa685727619366821aae (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
/* -------------------------------------------

	Copyright (C) 2024, Amlal EL Mahrouss, all rights reserved.

------------------------------------------- */

#ifndef INC_KERNEL_HEAP_H
#define INC_KERNEL_HEAP_H

/// @date 30/01/24
/// @file: Heap.h
/// @brief: heap allocation support.

#include <NewKit/KernelPanic.h>
#include <KernelKit/LPC.h>
#include <Hints/CompilerHint.h>

namespace Kernel
{
	/// @brief Declare pointer as free.
	/// @param heap_ptr the pointer.
	/// @return a status code regarding the deallocation.
	Int32 mm_delete_heap(VoidPtr heap_ptr);

	/// @brief Declare a new size for heap_ptr.
	/// @param heap_ptr the pointer.
	/// @return unsupported always returns nullptr.
	VoidPtr mm_realloc_heap(VoidPtr heap_ptr, SizeT new_sz);

	/// @brief Check if pointer is a valid Kernel pointer.
	/// @param heap_ptr the pointer
	/// @return if it exists it returns true.
	Boolean mm_is_valid_heap(VoidPtr heap_ptr);

	/// @brief Allocate chunk of memory.
	/// @param sz Size of pointer
	/// @param wr Read Write bit.
	/// @param user User enable bit.
	/// @return The newly allocated pointer, or nullptr.
	VoidPtr mm_new_heap(const SizeT sz, const Bool wr, const Bool user);

	/// @brief Protect the heap with a CRC value.
	/// @param heap_ptr pointer.
	/// @return if it valid: point has crc now., otherwise fail.
	Boolean mm_protect_heap(VoidPtr heap_ptr);

	/// @brief Makes a Kernel page.
	/// @param heap_ptr the page pointer.
	/// @return status code
	Int32 mm_make_page(VoidPtr heap_ptr);

	/// @brief Overwrites and set the flags of a heap header.
	/// @param heap_ptr the pointer to update.
	/// @param flags the flags to set.
	Int32 mm_make_flags(VoidPtr heap_ptr, UInt64 flags);

	/// @brief Gets the flags of a heap header.
	/// @param heap_ptr the pointer to get.
	UInt64 mm_get_flags(VoidPtr heap_ptr);

	/// @brief Allocate C++ class.
	/// @param cls The class to allocate.
	/// @param args The args to pass.
	template <typename T, typename... Args>
	inline Void mm_new_class(_Input _Output T** cls, _Input Args&&... args)
	{
		if (*cls)
		{
			err_global_get() = Kernel::kErrorInvalidData;
			return;
		}

		*cls = new T(move(args)...);
	}

	/// @brief Delete and nullify C++ class.
	/// @param cls The class to delete.
	template <typename T>
	inline Void mm_delete_class(_Input _Output T** cls)
	{
		delete *cls;
		*cls = nullptr;
	}
} // namespace Kernel

#endif // !INC_KERNEL_HEAP_H