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
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
|
/* IBM_PROLOG_BEGIN_TAG */
/* This is an automatically generated prolog. */
/* */
/* $Source: src/include/kernel/basesegment.H $ */
/* */
/* OpenPOWER HostBoot Project */
/* */
/* Contributors Listed Below - COPYRIGHT 2011,2017 */
/* [+] International Business Machines Corp. */
/* */
/* */
/* Licensed under the Apache License, Version 2.0 (the "License"); */
/* you may not use this file except in compliance with the License. */
/* You may obtain a copy of the License at */
/* */
/* http://www.apache.org/licenses/LICENSE-2.0 */
/* */
/* Unless required by applicable law or agreed to in writing, software */
/* distributed under the License is distributed on an "AS IS" BASIS, */
/* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or */
/* implied. See the License for the specific language governing */
/* permissions and limitations under the License. */
/* */
/* IBM_PROLOG_END_TAG */
/** @file basesegment.H
* @brief Defines the base segment (0TB) class.
*/
#ifndef __KERNEL_BASESEGMENT_H
#define __KERNEL_BASESEGMENT_H
#include <kernel/segment.H>
//#include <kernel/vmmmgr.H>
// Forward declaration.
class MessageQueue;
class Block;
/** @class BaseSegment
* @brief Class to manage the base segment at 0 TB.
*
* Contains a chain of blocks associated with the first segment.
*/
class BaseSegment : public Segment
{
protected:
/**
* @brief Constructor.
* Initialize attributes and set base addresss of segment to 0 TB.
*/
BaseSegment() : Segment(0x0), iv_block(NULL), iv_physMemSize(0) {};
/**
* @brief Destructor
* Delete any blocks owned by this segment.
*/
~BaseSegment();
public:
/**
* @brief Initialize the segment by allocating initial blocks and
* adding to the segment manager.
*/
static void init();
/**
* @brief Implementation of the pure-virtual function from Segment.
*
* Calls block chain to deal with page fault.
*/
virtual bool handlePageFault(task_t* i_task, uint64_t i_addr,
bool i_store);
/**
* @brief Implementation of the pure-virtual function from Segment.
* Update LRU statistics on the block that owns the address
*
* @param[in] i_vaddr - Virtual Address of page
* @param[in] i_stats - Usage statistics
*/
virtual void updateRefCount( uint64_t i_vaddr,
PageTableManager::UsageStats_t i_stats );
/**
* @brief Allocates a block of virtual memory of the given size
* @param i_mq[in] - Message queue to be associated with the block
* @param i_va[in] - Page aligned base virtual address of the block
* to be allocated
* @param i_size[in] - Requested virtual memory size of the block
* @param i_mappedToPhy[in] - bool value assigned to the block to
* determine if this blocked is mapped directly to a physical
* address
* DEFAULT - FALSE
* @param i_SPTEaddr[in] - address of where the SPTE should be put.
* DEFAULT = NULL (no specific address)
* @return int - 0 for successful block allocation, non-zero otherwise
*/
static int mmAllocBlock(MessageQueue* i_mq,void* i_va,uint64_t i_size,
bool iv_mappedToPhy = false,
uint64_t *i_SPTEaddr = NULL );
/**
* @brief Locate the physical address of the given virtual address
* @param[in] i_vaddr virtual address
* @return the physical address bound to the virtual address, or
* -EFAULT if i_vaddr not found. @see errno.h
*/
virtual uint64_t findPhysicalAddress(uint64_t i_vaddr) const;
/**
* @brief Remove pages by a specified operation of the given size
* @param[in] i_op - Page removal operation to perform
* @param[in] i_vaddr - Virtual address associated to page(s)
* @param[in] i_size - Size of memory to perform page removal on
* @param[in] i_task - Task requesting page removal.
* @return int - 0 for successful page removal, non-zero otherwise
*/
static int mmRemovePages(VmmManager::PAGE_REMOVAL_OPS i_op,
void* i_vaddr, uint64_t i_size, task_t* i_task);
/**
* @brief Sets the page permissions for a given virtual address and size.
* @param i_va[in] - virtual address of the page(s) to set permissions
* @param i_size[in] - range of memory that needs permissions updated...
* if i_size equals 0 then we only need to update an
* individual page.
* @param i_access_type[in] - type of permission to set
* @return int - 0 for successful block allocation, non-zero otherwise
*/
static int mmSetPermission(void* i_va,
uint64_t i_size,
uint64_t i_access_type);
/**
* @brief Cast out older physical memory pages
* @param[in] castout Constraint
*/
virtual void castOutPages(uint64_t i_type);
/**
* @brief Allocates a block of virtual memory that extends the VMM
* space up to 48MEG of Mainstore.
*/
static int mmExtend(void);
/**
* @brief Allocates a block of memory of the given size to at a
* specified physical address.
* @param i_paddr[in] - physical address of the location of the block of
* memory
* @param i_size[in] - range of memory being created
* @return int - 0 for successful block allocation, non-zero otherwise
*/
static int mmLinearMap(void *i_paddr, uint64_t i_size);
private:
/**
* @brief Internal implementation of init function.
*/
void _init();
/** Block-chain associated with this Segment. */
Block* iv_block;
/** Physical memory byte size */
uint64_t iv_physMemSize;
/**
* @brief Allocates a block of virtual memory of the given size
* @param i_mq[in] - Message queue to be associated with the block
* @param i_va[in] - Base virtual address of the block to be allocated
* @param i_size[in] - Requested virtual memory size of the block
* @param i_mappedToPhy[in] - bool value assigned to the block to
* determine if this blocked is mapped directly to a physical
* address
* DEFAULT - FALSE
* @param i_SPTEaddr[in] - address of where the SPTE should be put.
* DEFAULT = NULL (no specific address)
* @return int - 0 for successful block allocation, non-zero otherwise
*/
int _mmAllocBlock(MessageQueue* i_mq,void* i_va,uint64_t i_size,
bool iv_mappedToPhy = false,
uint64_t *i_SPTEaddr = NULL);
/**
* @brief Sets the page permissions for a given virtual address and size.
* @param i_va[in] - virtual address of the page(s) to set permissions
* @param i_size[in] - range of memory that needs permissions updated...
* if i_size equals 0 then we only need to update an individual
* page.
* @param i_access_type[in] - type of permission to set
* @return int - 0 for successful block allocation, non-zero otherwise
*/
int _mmSetPermission(void* i_va,
uint64_t i_size,
uint64_t i_access_type);
/**
* @brief Remove pages by a specified operation of the given size
* @param[in] i_op - Page removal operation to perform
* @param[in] i_vaddr - Virtual address associated to page(s)
* @param[in] i_size - Size of memory to perform page removal on
* @param[in] i_task - Task requesting page removal.
* @return int - 0 for successful page removal, non-zero otherwise
*/
int _mmRemovePages(VmmManager::PAGE_REMOVAL_OPS i_op, void* i_vaddr,
uint64_t i_size, task_t* i_task);
/**
* @brief Allocates a block of virtual memory that extends the VMM
* space up to 48MEG of Mainstore.
*/
int _mmExtend(void);
/**
* @brief Allocates a block of memory of the given size to at a
* specified physical address.
* @param i_paddr[in] - physical address of the location of the block of
* memory
* @param i_size[in] - range of memory being created
* @return int - 0 for successful block allocation, non-zero otherwise
*/
int _mmLinearMap(void* i_paddr, uint64_t i_size);
};
#endif
|
