fa_lru.cc (13164:da6240a1ccfb) fa_lru.cc (13165:d52afbf4cdfe)
1/*
1/*
2 * Copyright (c) 2018 Inria
2 * Copyright (c) 2013,2016-2018 ARM Limited
3 * All rights reserved.
4 *
5 * The license below extends only to copyright in the software and shall
6 * not be construed as granting a license to any other intellectual
7 * property including but not limited to intellectual property relating
8 * to a hardware implementation of the functionality of the software
9 * licensed hereunder. You may use the software subject to the license
10 * terms below provided that you ensure that this notice is replicated
11 * unmodified and in its entirety in all distributions of the software,
12 * modified or unmodified, in source code or in binary form.
13 *
14 * Copyright (c) 2003-2005 The Regents of The University of Michigan
15 * All rights reserved.
16 *
17 * Redistribution and use in source and binary forms, with or without
18 * modification, are permitted provided that the following conditions are
19 * met: redistributions of source code must retain the above copyright
20 * notice, this list of conditions and the following disclaimer;
21 * redistributions in binary form must reproduce the above copyright
22 * notice, this list of conditions and the following disclaimer in the
23 * documentation and/or other materials provided with the distribution;
24 * neither the name of the copyright holders nor the names of its
25 * contributors may be used to endorse or promote products derived from
26 * this software without specific prior written permission.
27 *
28 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
29 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
30 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
31 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
32 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
33 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
34 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
35 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
36 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
37 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
38 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
39 *
40 * Authors: Erik Hallnor
41 * Nikos Nikoleris
3 * Copyright (c) 2013,2016-2018 ARM Limited
4 * All rights reserved.
5 *
6 * The license below extends only to copyright in the software and shall
7 * not be construed as granting a license to any other intellectual
8 * property including but not limited to intellectual property relating
9 * to a hardware implementation of the functionality of the software
10 * licensed hereunder. You may use the software subject to the license
11 * terms below provided that you ensure that this notice is replicated
12 * unmodified and in its entirety in all distributions of the software,
13 * modified or unmodified, in source code or in binary form.
14 *
15 * Copyright (c) 2003-2005 The Regents of The University of Michigan
16 * All rights reserved.
17 *
18 * Redistribution and use in source and binary forms, with or without
19 * modification, are permitted provided that the following conditions are
20 * met: redistributions of source code must retain the above copyright
21 * notice, this list of conditions and the following disclaimer;
22 * redistributions in binary form must reproduce the above copyright
23 * notice, this list of conditions and the following disclaimer in the
24 * documentation and/or other materials provided with the distribution;
25 * neither the name of the copyright holders nor the names of its
26 * contributors may be used to endorse or promote products derived from
27 * this software without specific prior written permission.
28 *
29 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
30 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
31 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
32 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
33 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
34 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
35 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
36 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
37 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
38 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
39 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
40 *
41 * Authors: Erik Hallnor
42 * Nikos Nikoleris
43 * Daniel Carvalho
42 */
43
44/**
45 * @file
46 * Definitions a fully associative LRU tagstore.
47 */
48
49#include "mem/cache/tags/fa_lru.hh"
50
51#include <cassert>
52#include <sstream>
53
54#include "base/intmath.hh"
55#include "base/logging.hh"
56#include "mem/cache/base.hh"
57
58FALRU::FALRU(const Params *p)
59 : BaseTags(p),
60
61 cacheTracking(p->min_tracked_cache_size, size, blkSize)
62{
63 if (!isPowerOf2(blkSize))
64 fatal("cache block size (in bytes) `%d' must be a power of two",
65 blkSize);
66 if (!isPowerOf2(size))
67 fatal("Cache Size must be power of 2 for now");
68
69 blks = new FALRUBlk[numBlocks];
70
71 head = &(blks[0]);
72 head->prev = nullptr;
73 head->next = &(blks[1]);
74 head->set = 0;
75 head->way = 0;
76 head->data = &dataBlks[0];
77
78 for (unsigned i = 1; i < numBlocks - 1; i++) {
79 blks[i].prev = &(blks[i-1]);
80 blks[i].next = &(blks[i+1]);
81 blks[i].set = 0;
82 blks[i].way = i;
83
84 // Associate a data chunk to the block
85 blks[i].data = &dataBlks[blkSize*i];
86 }
87
88 tail = &(blks[numBlocks - 1]);
89 tail->prev = &(blks[numBlocks - 2]);
90 tail->next = nullptr;
91 tail->set = 0;
92 tail->way = numBlocks - 1;
93 tail->data = &dataBlks[(numBlocks - 1) * blkSize];
94
95 cacheTracking.init(head, tail);
96}
97
98FALRU::~FALRU()
99{
100 delete[] blks;
101}
102
103void
104FALRU::regStats()
105{
106 BaseTags::regStats();
107 cacheTracking.regStats(name());
108}
109
110void
111FALRU::invalidate(CacheBlk *blk)
112{
44 */
45
46/**
47 * @file
48 * Definitions a fully associative LRU tagstore.
49 */
50
51#include "mem/cache/tags/fa_lru.hh"
52
53#include <cassert>
54#include <sstream>
55
56#include "base/intmath.hh"
57#include "base/logging.hh"
58#include "mem/cache/base.hh"
59
60FALRU::FALRU(const Params *p)
61 : BaseTags(p),
62
63 cacheTracking(p->min_tracked_cache_size, size, blkSize)
64{
65 if (!isPowerOf2(blkSize))
66 fatal("cache block size (in bytes) `%d' must be a power of two",
67 blkSize);
68 if (!isPowerOf2(size))
69 fatal("Cache Size must be power of 2 for now");
70
71 blks = new FALRUBlk[numBlocks];
72
73 head = &(blks[0]);
74 head->prev = nullptr;
75 head->next = &(blks[1]);
76 head->set = 0;
77 head->way = 0;
78 head->data = &dataBlks[0];
79
80 for (unsigned i = 1; i < numBlocks - 1; i++) {
81 blks[i].prev = &(blks[i-1]);
82 blks[i].next = &(blks[i+1]);
83 blks[i].set = 0;
84 blks[i].way = i;
85
86 // Associate a data chunk to the block
87 blks[i].data = &dataBlks[blkSize*i];
88 }
89
90 tail = &(blks[numBlocks - 1]);
91 tail->prev = &(blks[numBlocks - 2]);
92 tail->next = nullptr;
93 tail->set = 0;
94 tail->way = numBlocks - 1;
95 tail->data = &dataBlks[(numBlocks - 1) * blkSize];
96
97 cacheTracking.init(head, tail);
98}
99
100FALRU::~FALRU()
101{
102 delete[] blks;
103}
104
105void
106FALRU::regStats()
107{
108 BaseTags::regStats();
109 cacheTracking.regStats(name());
110}
111
112void
113FALRU::invalidate(CacheBlk *blk)
114{
115 // Erase block entry reference in the hash table
116 auto num_erased = tagHash.erase(std::make_pair(blk->tag, blk->isSecure()));
117
118 // Sanity check; only one block reference should be erased
119 assert(num_erased == 1);
120
121 // Invalidate block entry. Must be done after the hash is erased
113 BaseTags::invalidate(blk);
114
115 // Decrease the number of tags in use
116 tagsInUse--;
117
118 // Move the block to the tail to make it the next victim
119 moveToTail((FALRUBlk*)blk);
122 BaseTags::invalidate(blk);
123
124 // Decrease the number of tags in use
125 tagsInUse--;
126
127 // Move the block to the tail to make it the next victim
128 moveToTail((FALRUBlk*)blk);
120
121 // Erase block entry in the hash table
122 tagHash.erase(std::make_pair(blk->tag, blk->isSecure()));
123}
124
125CacheBlk*
126FALRU::accessBlock(Addr addr, bool is_secure, Cycles &lat)
127{
128 return accessBlock(addr, is_secure, lat, 0);
129}
130
131CacheBlk*
132FALRU::accessBlock(Addr addr, bool is_secure, Cycles &lat,
133 CachesMask *in_caches_mask)
134{
135 CachesMask mask = 0;
136 FALRUBlk* blk = static_cast<FALRUBlk*>(findBlock(addr, is_secure));
137
138 if (blk && blk->isValid()) {
139 // If a cache hit
140 lat = accessLatency;
141 // Check if the block to be accessed is available. If not,
142 // apply the accessLatency on top of block->whenReady.
143 if (blk->whenReady > curTick() &&
144 cache->ticksToCycles(blk->whenReady - curTick()) >
145 accessLatency) {
146 lat = cache->ticksToCycles(blk->whenReady - curTick()) +
147 accessLatency;
148 }
149 mask = blk->inCachesMask;
150
151 moveToHead(blk);
152 } else {
153 // If a cache miss
154 lat = lookupLatency;
155 }
156 if (in_caches_mask) {
157 *in_caches_mask = mask;
158 }
159
160 cacheTracking.recordAccess(blk);
161
162 return blk;
163}
164
165CacheBlk*
166FALRU::findBlock(Addr addr, bool is_secure) const
167{
168 FALRUBlk* blk = nullptr;
169
170 Addr tag = extractTag(addr);
171 auto iter = tagHash.find(std::make_pair(tag, is_secure));
172 if (iter != tagHash.end()) {
173 blk = (*iter).second;
174 }
175
176 if (blk && blk->isValid()) {
177 assert(blk->tag == tag);
178 assert(blk->isSecure() == is_secure);
179 }
180
181 return blk;
182}
183
184ReplaceableEntry*
185FALRU::findBlockBySetAndWay(int set, int way) const
186{
187 assert(set == 0);
188 return &blks[way];
189}
190
191CacheBlk*
192FALRU::findVictim(Addr addr, const bool is_secure,
193 std::vector<CacheBlk*>& evict_blks) const
194{
195 // The victim is always stored on the tail for the FALRU
196 FALRUBlk* victim = tail;
197
198 // There is only one eviction for this replacement
199 evict_blks.push_back(victim);
200
201 return victim;
202}
203
204void
205FALRU::insertBlock(const PacketPtr pkt, CacheBlk *blk)
206{
207 FALRUBlk* falruBlk = static_cast<FALRUBlk*>(blk);
208
209 // Make sure block is not present in the cache
210 assert(falruBlk->inCachesMask == 0);
211
212 // Do common block insertion functionality
213 BaseTags::insertBlock(pkt, blk);
214
215 // Increment tag counter
216 tagsInUse++;
217
218 // New block is the MRU
219 moveToHead(falruBlk);
220
221 // Insert new block in the hash table
222 tagHash[std::make_pair(blk->tag, blk->isSecure())] = falruBlk;
223}
224
225void
226FALRU::moveToHead(FALRUBlk *blk)
227{
228 // If block is not already head, do the moving
229 if (blk != head) {
230 cacheTracking.moveBlockToHead(blk);
231 // If block is tail, set previous block as new tail
232 if (blk == tail){
233 assert(blk->next == nullptr);
234 tail = blk->prev;
235 tail->next = nullptr;
236 // Inform block's surrounding blocks that it has been moved
237 } else {
238 blk->prev->next = blk->next;
239 blk->next->prev = blk->prev;
240 }
241
242 // Swap pointers
243 blk->next = head;
244 blk->prev = nullptr;
245 head->prev = blk;
246 head = blk;
247
248 cacheTracking.check(head, tail);
249 }
250}
251
252void
253FALRU::moveToTail(FALRUBlk *blk)
254{
255 // If block is not already tail, do the moving
256 if (blk != tail) {
257 cacheTracking.moveBlockToTail(blk);
258 // If block is head, set next block as new head
259 if (blk == head){
260 assert(blk->prev == nullptr);
261 head = blk->next;
262 head->prev = nullptr;
263 // Inform block's surrounding blocks that it has been moved
264 } else {
265 blk->prev->next = blk->next;
266 blk->next->prev = blk->prev;
267 }
268
269 // Swap pointers
270 blk->prev = tail;
271 blk->next = nullptr;
272 tail->next = blk;
273 tail = blk;
274
275 cacheTracking.check(head, tail);
276 }
277}
278
279FALRU *
280FALRUParams::create()
281{
282 return new FALRU(this);
283}
284
285void
286FALRU::CacheTracking::check(const FALRUBlk *head, const FALRUBlk *tail) const
287{
288#ifdef FALRU_DEBUG
289 const FALRUBlk* blk = head;
290 unsigned curr_size = 0;
291 unsigned tracked_cache_size = minTrackedSize;
292 CachesMask in_caches_mask = inAllCachesMask;
293 int j = 0;
294
295 while (blk) {
296 panic_if(blk->inCachesMask != in_caches_mask, "Expected cache mask "
297 "%x found %x", blk->inCachesMask, in_caches_mask);
298
299 curr_size += blkSize;
300 if (curr_size == tracked_cache_size && blk != tail) {
301 panic_if(boundaries[j] != blk, "Unexpected boundary for the %d-th "
302 "cache", j);
303 tracked_cache_size <<= 1;
304 // from this point, blocks fit only in the larger caches
305 in_caches_mask &= ~(1U << j);
306 ++j;
307 }
308 blk = blk->next;
309 }
310#endif // FALRU_DEBUG
311}
312
313void
314FALRU::CacheTracking::init(FALRUBlk *head, FALRUBlk *tail)
315{
316 // early exit if we are not tracking any extra caches
317 FALRUBlk* blk = numTrackedCaches ? head : nullptr;
318 unsigned curr_size = 0;
319 unsigned tracked_cache_size = minTrackedSize;
320 CachesMask in_caches_mask = inAllCachesMask;
321 int j = 0;
322
323 while (blk) {
324 blk->inCachesMask = in_caches_mask;
325
326 curr_size += blkSize;
327 if (curr_size == tracked_cache_size && blk != tail) {
328 boundaries[j] = blk;
329
330 tracked_cache_size <<= 1;
331 // from this point, blocks fit only in the larger caches
332 in_caches_mask &= ~(1U << j);
333 ++j;
334 }
335 blk = blk->next;
336 }
337}
338
339
340void
341FALRU::CacheTracking::moveBlockToHead(FALRUBlk *blk)
342{
343 // Get the mask of all caches, in which the block didn't fit
344 // before moving it to the head
345 CachesMask update_caches_mask = inAllCachesMask ^ blk->inCachesMask;
346
347 for (int i = 0; i < numTrackedCaches; i++) {
348 CachesMask current_cache_mask = 1U << i;
349 if (current_cache_mask & update_caches_mask) {
350 // if the ith cache didn't fit the block (before it is moved to
351 // the head), move the ith boundary 1 block closer to the
352 // MRU
353 boundaries[i]->inCachesMask &= ~current_cache_mask;
354 boundaries[i] = boundaries[i]->prev;
355 } else if (boundaries[i] == blk) {
356 // Make sure the boundary doesn't point to the block
357 // we are about to move
358 boundaries[i] = blk->prev;
359 }
360 }
361
362 // Make block reside in all caches
363 blk->inCachesMask = inAllCachesMask;
364}
365
366void
367FALRU::CacheTracking::moveBlockToTail(FALRUBlk *blk)
368{
369 CachesMask update_caches_mask = blk->inCachesMask;
370
371 for (int i = 0; i < numTrackedCaches; i++) {
372 CachesMask current_cache_mask = 1U << i;
373 if (current_cache_mask & update_caches_mask) {
374 // if the ith cache fitted the block (before it is moved to
375 // the tail), move the ith boundary 1 block closer to the
376 // LRU
377 boundaries[i] = boundaries[i]->next;
378 if (boundaries[i] == blk) {
379 // Make sure the boundary doesn't point to the block
380 // we are about to move
381 boundaries[i] = blk->next;
382 }
383 boundaries[i]->inCachesMask |= current_cache_mask;
384 }
385 }
386
387 // The block now fits only in the actual cache
388 blk->inCachesMask = 0;
389}
390
391void
392FALRU::CacheTracking::recordAccess(FALRUBlk *blk)
393{
394 for (int i = 0; i < numTrackedCaches; i++) {
395 if (blk && ((1U << i) & blk->inCachesMask)) {
396 hits[i]++;
397 } else {
398 misses[i]++;
399 }
400 }
401
402 // Record stats for the actual cache too
403 if (blk && blk->isValid()) {
404 hits[numTrackedCaches]++;
405 } else {
406 misses[numTrackedCaches]++;
407 }
408
409 accesses++;
410}
411
412void
413printSize(std::ostream &stream, size_t size)
414{
415 static const char *SIZES[] = { "B", "kB", "MB", "GB", "TB", "ZB" };
416 int div = 0;
417 while (size >= 1024 && div < (sizeof SIZES / sizeof *SIZES)) {
418 div++;
419 size >>= 10;
420 }
421 stream << size << SIZES[div];
422}
423
424void
425FALRU::CacheTracking::regStats(std::string name)
426{
427 hits
428 .init(numTrackedCaches + 1)
429 .name(name + ".falru_hits")
430 .desc("The number of hits in each cache size.")
431 ;
432 misses
433 .init(numTrackedCaches + 1)
434 .name(name + ".falru_misses")
435 .desc("The number of misses in each cache size.")
436 ;
437 accesses
438 .name(name + ".falru_accesses")
439 .desc("The number of accesses to the FA LRU cache.")
440 ;
441
442 for (unsigned i = 0; i < numTrackedCaches + 1; ++i) {
443 std::stringstream size_str;
444 printSize(size_str, minTrackedSize << i);
445 hits.subname(i, size_str.str());
446 hits.subdesc(i, "Hits in a " + size_str.str() + " cache");
447 misses.subname(i, size_str.str());
448 misses.subdesc(i, "Misses in a " + size_str.str() + " cache");
449 }
450}
129}
130
131CacheBlk*
132FALRU::accessBlock(Addr addr, bool is_secure, Cycles &lat)
133{
134 return accessBlock(addr, is_secure, lat, 0);
135}
136
137CacheBlk*
138FALRU::accessBlock(Addr addr, bool is_secure, Cycles &lat,
139 CachesMask *in_caches_mask)
140{
141 CachesMask mask = 0;
142 FALRUBlk* blk = static_cast<FALRUBlk*>(findBlock(addr, is_secure));
143
144 if (blk && blk->isValid()) {
145 // If a cache hit
146 lat = accessLatency;
147 // Check if the block to be accessed is available. If not,
148 // apply the accessLatency on top of block->whenReady.
149 if (blk->whenReady > curTick() &&
150 cache->ticksToCycles(blk->whenReady - curTick()) >
151 accessLatency) {
152 lat = cache->ticksToCycles(blk->whenReady - curTick()) +
153 accessLatency;
154 }
155 mask = blk->inCachesMask;
156
157 moveToHead(blk);
158 } else {
159 // If a cache miss
160 lat = lookupLatency;
161 }
162 if (in_caches_mask) {
163 *in_caches_mask = mask;
164 }
165
166 cacheTracking.recordAccess(blk);
167
168 return blk;
169}
170
171CacheBlk*
172FALRU::findBlock(Addr addr, bool is_secure) const
173{
174 FALRUBlk* blk = nullptr;
175
176 Addr tag = extractTag(addr);
177 auto iter = tagHash.find(std::make_pair(tag, is_secure));
178 if (iter != tagHash.end()) {
179 blk = (*iter).second;
180 }
181
182 if (blk && blk->isValid()) {
183 assert(blk->tag == tag);
184 assert(blk->isSecure() == is_secure);
185 }
186
187 return blk;
188}
189
190ReplaceableEntry*
191FALRU::findBlockBySetAndWay(int set, int way) const
192{
193 assert(set == 0);
194 return &blks[way];
195}
196
197CacheBlk*
198FALRU::findVictim(Addr addr, const bool is_secure,
199 std::vector<CacheBlk*>& evict_blks) const
200{
201 // The victim is always stored on the tail for the FALRU
202 FALRUBlk* victim = tail;
203
204 // There is only one eviction for this replacement
205 evict_blks.push_back(victim);
206
207 return victim;
208}
209
210void
211FALRU::insertBlock(const PacketPtr pkt, CacheBlk *blk)
212{
213 FALRUBlk* falruBlk = static_cast<FALRUBlk*>(blk);
214
215 // Make sure block is not present in the cache
216 assert(falruBlk->inCachesMask == 0);
217
218 // Do common block insertion functionality
219 BaseTags::insertBlock(pkt, blk);
220
221 // Increment tag counter
222 tagsInUse++;
223
224 // New block is the MRU
225 moveToHead(falruBlk);
226
227 // Insert new block in the hash table
228 tagHash[std::make_pair(blk->tag, blk->isSecure())] = falruBlk;
229}
230
231void
232FALRU::moveToHead(FALRUBlk *blk)
233{
234 // If block is not already head, do the moving
235 if (blk != head) {
236 cacheTracking.moveBlockToHead(blk);
237 // If block is tail, set previous block as new tail
238 if (blk == tail){
239 assert(blk->next == nullptr);
240 tail = blk->prev;
241 tail->next = nullptr;
242 // Inform block's surrounding blocks that it has been moved
243 } else {
244 blk->prev->next = blk->next;
245 blk->next->prev = blk->prev;
246 }
247
248 // Swap pointers
249 blk->next = head;
250 blk->prev = nullptr;
251 head->prev = blk;
252 head = blk;
253
254 cacheTracking.check(head, tail);
255 }
256}
257
258void
259FALRU::moveToTail(FALRUBlk *blk)
260{
261 // If block is not already tail, do the moving
262 if (blk != tail) {
263 cacheTracking.moveBlockToTail(blk);
264 // If block is head, set next block as new head
265 if (blk == head){
266 assert(blk->prev == nullptr);
267 head = blk->next;
268 head->prev = nullptr;
269 // Inform block's surrounding blocks that it has been moved
270 } else {
271 blk->prev->next = blk->next;
272 blk->next->prev = blk->prev;
273 }
274
275 // Swap pointers
276 blk->prev = tail;
277 blk->next = nullptr;
278 tail->next = blk;
279 tail = blk;
280
281 cacheTracking.check(head, tail);
282 }
283}
284
285FALRU *
286FALRUParams::create()
287{
288 return new FALRU(this);
289}
290
291void
292FALRU::CacheTracking::check(const FALRUBlk *head, const FALRUBlk *tail) const
293{
294#ifdef FALRU_DEBUG
295 const FALRUBlk* blk = head;
296 unsigned curr_size = 0;
297 unsigned tracked_cache_size = minTrackedSize;
298 CachesMask in_caches_mask = inAllCachesMask;
299 int j = 0;
300
301 while (blk) {
302 panic_if(blk->inCachesMask != in_caches_mask, "Expected cache mask "
303 "%x found %x", blk->inCachesMask, in_caches_mask);
304
305 curr_size += blkSize;
306 if (curr_size == tracked_cache_size && blk != tail) {
307 panic_if(boundaries[j] != blk, "Unexpected boundary for the %d-th "
308 "cache", j);
309 tracked_cache_size <<= 1;
310 // from this point, blocks fit only in the larger caches
311 in_caches_mask &= ~(1U << j);
312 ++j;
313 }
314 blk = blk->next;
315 }
316#endif // FALRU_DEBUG
317}
318
319void
320FALRU::CacheTracking::init(FALRUBlk *head, FALRUBlk *tail)
321{
322 // early exit if we are not tracking any extra caches
323 FALRUBlk* blk = numTrackedCaches ? head : nullptr;
324 unsigned curr_size = 0;
325 unsigned tracked_cache_size = minTrackedSize;
326 CachesMask in_caches_mask = inAllCachesMask;
327 int j = 0;
328
329 while (blk) {
330 blk->inCachesMask = in_caches_mask;
331
332 curr_size += blkSize;
333 if (curr_size == tracked_cache_size && blk != tail) {
334 boundaries[j] = blk;
335
336 tracked_cache_size <<= 1;
337 // from this point, blocks fit only in the larger caches
338 in_caches_mask &= ~(1U << j);
339 ++j;
340 }
341 blk = blk->next;
342 }
343}
344
345
346void
347FALRU::CacheTracking::moveBlockToHead(FALRUBlk *blk)
348{
349 // Get the mask of all caches, in which the block didn't fit
350 // before moving it to the head
351 CachesMask update_caches_mask = inAllCachesMask ^ blk->inCachesMask;
352
353 for (int i = 0; i < numTrackedCaches; i++) {
354 CachesMask current_cache_mask = 1U << i;
355 if (current_cache_mask & update_caches_mask) {
356 // if the ith cache didn't fit the block (before it is moved to
357 // the head), move the ith boundary 1 block closer to the
358 // MRU
359 boundaries[i]->inCachesMask &= ~current_cache_mask;
360 boundaries[i] = boundaries[i]->prev;
361 } else if (boundaries[i] == blk) {
362 // Make sure the boundary doesn't point to the block
363 // we are about to move
364 boundaries[i] = blk->prev;
365 }
366 }
367
368 // Make block reside in all caches
369 blk->inCachesMask = inAllCachesMask;
370}
371
372void
373FALRU::CacheTracking::moveBlockToTail(FALRUBlk *blk)
374{
375 CachesMask update_caches_mask = blk->inCachesMask;
376
377 for (int i = 0; i < numTrackedCaches; i++) {
378 CachesMask current_cache_mask = 1U << i;
379 if (current_cache_mask & update_caches_mask) {
380 // if the ith cache fitted the block (before it is moved to
381 // the tail), move the ith boundary 1 block closer to the
382 // LRU
383 boundaries[i] = boundaries[i]->next;
384 if (boundaries[i] == blk) {
385 // Make sure the boundary doesn't point to the block
386 // we are about to move
387 boundaries[i] = blk->next;
388 }
389 boundaries[i]->inCachesMask |= current_cache_mask;
390 }
391 }
392
393 // The block now fits only in the actual cache
394 blk->inCachesMask = 0;
395}
396
397void
398FALRU::CacheTracking::recordAccess(FALRUBlk *blk)
399{
400 for (int i = 0; i < numTrackedCaches; i++) {
401 if (blk && ((1U << i) & blk->inCachesMask)) {
402 hits[i]++;
403 } else {
404 misses[i]++;
405 }
406 }
407
408 // Record stats for the actual cache too
409 if (blk && blk->isValid()) {
410 hits[numTrackedCaches]++;
411 } else {
412 misses[numTrackedCaches]++;
413 }
414
415 accesses++;
416}
417
418void
419printSize(std::ostream &stream, size_t size)
420{
421 static const char *SIZES[] = { "B", "kB", "MB", "GB", "TB", "ZB" };
422 int div = 0;
423 while (size >= 1024 && div < (sizeof SIZES / sizeof *SIZES)) {
424 div++;
425 size >>= 10;
426 }
427 stream << size << SIZES[div];
428}
429
430void
431FALRU::CacheTracking::regStats(std::string name)
432{
433 hits
434 .init(numTrackedCaches + 1)
435 .name(name + ".falru_hits")
436 .desc("The number of hits in each cache size.")
437 ;
438 misses
439 .init(numTrackedCaches + 1)
440 .name(name + ".falru_misses")
441 .desc("The number of misses in each cache size.")
442 ;
443 accesses
444 .name(name + ".falru_accesses")
445 .desc("The number of accesses to the FA LRU cache.")
446 ;
447
448 for (unsigned i = 0; i < numTrackedCaches + 1; ++i) {
449 std::stringstream size_str;
450 printSize(size_str, minTrackedSize << i);
451 hits.subname(i, size_str.str());
452 hits.subdesc(i, "Hits in a " + size_str.str() + " cache");
453 misses.subname(i, size_str.str());
454 misses.subdesc(i, "Misses in a " + size_str.str() + " cache");
455 }
456}