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
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
|
/* IBM_PROLOG_BEGIN_TAG */
/* This is an automatically generated prolog. */
/* */
/* $Source: src/include/sys/mm.h $ */
/* */
/* IBM CONFIDENTIAL */
/* */
/* COPYRIGHT International Business Machines Corp. 2011,2012 */
/* */
/* p1 */
/* */
/* Object Code Only (OCO) source materials */
/* Licensed Internal Code Source Materials */
/* IBM HostBoot Licensed Internal Code */
/* */
/* The source code for this program is not published or otherwise */
/* divested of its trade secrets, irrespective of what has been */
/* deposited with the U.S. Copyright Office. */
/* */
/* Origin: 30 */
/* */
/* IBM_PROLOG_END_TAG */
#ifndef __SYS_MM_H
#define __SYS_MM_H
#include <stdint.h>
#include <limits.h>
#include <sys/msg.h>
#ifdef __cplusplus
extern "C"
{
#endif
/**
* Page removal operations
*
* RELEASE : Writes dirty&write-tracked pages out to a storage device
* and removes other pages
* FLUSH : Only writes dirty&write-tracked pages out to a storage
* device
*/
enum PAGE_REMOVAL_OPS
{
RELEASE = 0,
FLUSH = 1,
};
/**
* Page permission types mapped to the same bits in the Shadow PTE
*/
enum PAGE_PERMISSIONS
{
READ_ONLY = 0x00000001,
WRITABLE = 0x000000002,
EXECUTABLE = 0x00000004,
WRITE_TRACKED = 0x00000008,
ALLOCATE_FROM_ZERO = 0x00000010,
NO_ALLOCATE_FROM_ZERO = 0x00000020,
NO_ACCESS = 0x00000040,
};
/** @fn mm_alloc_block()
* @brief System call to allocate virtual memory block in the base segment
*
* @param[in] mq - Message queue to be associated with the block
* @param[in] va - Page aligned base virtual address of the block
* to be allocated
* @param[in] size - Requested virtual memory size of the block
*
* @return int - 0 for successful block allocation, non-zero otherwise
*/
int mm_alloc_block(msg_q_t mq,void* va,uint64_t size);
/** @fn mm_remove_pages()
* @brief System call to remove pages by a specified operation
*
* @param[in] i_op - Page removal operation to perform
* @param[in] i_vaddr - Virtual address associated to page(s)
* @param[in] size - Size of memory to perform page removal on
*
* @return int - 0 for successful page removal, non-zero otherwise
*/
int mm_remove_pages(PAGE_REMOVAL_OPS i_op, void* i_vaddr, uint64_t i_size);
/** @fn mm_set_permission()
* @brief System call to set the page permissions
*
* @param[in] va - virtual address of the pages(s) to update permission
* @param[in] size - requested size of memory in bytes
* if size = 0 then only a single page will be updated.
* @param[in] access_type - Type of permission to be given to the page(s)
*
* @return int - 0 for successful update of permission, non-zero otherwise
*/
int mm_set_permission(void* va, uint64_t size, uint64_t access_type);
enum MM_EXTEND_SIZE
{
MM_EXTEND_FULL_CACHE, //< Extend memory to include full cache (8mb).
MM_EXTEND_REAL_MEMORY, //< Extend memory into real mainstore.
};
/** @fn mm_extend()
* @brief System call to extend memory.
*
* @param[in] i_size - Amount to extend memory by.
*
* @return int - 0 for successful extension of memory, non-zero otherwise
*/
int mm_extend(MM_EXTEND_SIZE i_size = MM_EXTEND_REAL_MEMORY);
/** @fn mm_linear_map()
* @brief Allocates a block of memory of the given size at a specified
* address (direct physical to virtual mapping)
* @param[in] i_paddr - physical address of the location for the block
* @param[in] size - size of the block requested
*
* @return int - 0 for successful add, non-zero otherwise
*/
int mm_linear_map(void *i_paddr, uint64_t i_size);
/** @fs mm_icache_invalidate()
* @brief Invalidate the ICACHE for the given memory
*
* @param[in] i_addr - Destination address
* @param[in] i_cpu_word_count - number of CPU_WORDs (uint64_t)
*/
void mm_icache_invalidate(void * i_addr, size_t i_cpu_word_count);
/** @fn mm_virt_to_phys()
* @brief System call to return the physical address backing a
* virtual address
*
* @param[in] i_vaddr - Virtual address to translate
*
* @return uint64_t - 0 if there is no associated address,
* physical address otherwise
*/
uint64_t mm_virt_to_phys( void* i_vaddr );
#ifdef __cplusplus
}
#endif
#endif
|
