base.cc revision 12725
1/*
2 * Copyright (c) 2012-2013, 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
42 */
43
44/**
45 * @file
46 * Definition of BaseCache functions.
47 */
48
49#include "mem/cache/base.hh"
50
51#include "base/compiler.hh"
52#include "base/logging.hh"
53#include "debug/Cache.hh"
54#include "debug/CachePort.hh"
55#include "debug/CacheVerbose.hh"
56#include "mem/cache/mshr.hh"
57#include "mem/cache/prefetch/base.hh"
58#include "mem/cache/queue_entry.hh"
59#include "params/BaseCache.hh"
60#include "sim/core.hh"
61
62class BaseMasterPort;
63class BaseSlavePort;
64
65using namespace std;
66
67BaseCache::CacheSlavePort::CacheSlavePort(const std::string &_name,
68                                          BaseCache *_cache,
69                                          const std::string &_label)
70    : QueuedSlavePort(_name, _cache, queue), queue(*_cache, *this, _label),
71      blocked(false), mustSendRetry(false),
72      sendRetryEvent([this]{ processSendRetry(); }, _name)
73{
74}
75
76BaseCache::BaseCache(const BaseCacheParams *p, unsigned blk_size)
77    : MemObject(p),
78      cpuSidePort (p->name + ".cpu_side", this, "CpuSidePort"),
79      memSidePort(p->name + ".mem_side", this, "MemSidePort"),
80      mshrQueue("MSHRs", p->mshrs, 0, p->demand_mshr_reserve), // see below
81      writeBuffer("write buffer", p->write_buffers, p->mshrs), // see below
82      tags(p->tags),
83      prefetcher(p->prefetcher),
84      prefetchOnAccess(p->prefetch_on_access),
85      writebackClean(p->writeback_clean),
86      tempBlockWriteback(nullptr),
87      writebackTempBlockAtomicEvent([this]{ writebackTempBlockAtomic(); },
88                                    name(), false,
89                                    EventBase::Delayed_Writeback_Pri),
90      blkSize(blk_size),
91      lookupLatency(p->tag_latency),
92      dataLatency(p->data_latency),
93      forwardLatency(p->tag_latency),
94      fillLatency(p->data_latency),
95      responseLatency(p->response_latency),
96      numTarget(p->tgts_per_mshr),
97      forwardSnoops(true),
98      clusivity(p->clusivity),
99      isReadOnly(p->is_read_only),
100      blocked(0),
101      order(0),
102      noTargetMSHR(nullptr),
103      missCount(p->max_miss_count),
104      addrRanges(p->addr_ranges.begin(), p->addr_ranges.end()),
105      system(p->system)
106{
107    // the MSHR queue has no reserve entries as we check the MSHR
108    // queue on every single allocation, whereas the write queue has
109    // as many reserve entries as we have MSHRs, since every MSHR may
110    // eventually require a writeback, and we do not check the write
111    // buffer before committing to an MSHR
112
113    // forward snoops is overridden in init() once we can query
114    // whether the connected master is actually snooping or not
115
116    tempBlock = new CacheBlk();
117    tempBlock->data = new uint8_t[blkSize];
118
119    tags->setCache(this);
120    if (prefetcher)
121        prefetcher->setCache(this);
122}
123
124BaseCache::~BaseCache()
125{
126    delete [] tempBlock->data;
127    delete tempBlock;
128}
129
130void
131BaseCache::CacheSlavePort::setBlocked()
132{
133    assert(!blocked);
134    DPRINTF(CachePort, "Port is blocking new requests\n");
135    blocked = true;
136    // if we already scheduled a retry in this cycle, but it has not yet
137    // happened, cancel it
138    if (sendRetryEvent.scheduled()) {
139        owner.deschedule(sendRetryEvent);
140        DPRINTF(CachePort, "Port descheduled retry\n");
141        mustSendRetry = true;
142    }
143}
144
145void
146BaseCache::CacheSlavePort::clearBlocked()
147{
148    assert(blocked);
149    DPRINTF(CachePort, "Port is accepting new requests\n");
150    blocked = false;
151    if (mustSendRetry) {
152        // @TODO: need to find a better time (next cycle?)
153        owner.schedule(sendRetryEvent, curTick() + 1);
154    }
155}
156
157void
158BaseCache::CacheSlavePort::processSendRetry()
159{
160    DPRINTF(CachePort, "Port is sending retry\n");
161
162    // reset the flag and call retry
163    mustSendRetry = false;
164    sendRetryReq();
165}
166
167void
168BaseCache::init()
169{
170    if (!cpuSidePort.isConnected() || !memSidePort.isConnected())
171        fatal("Cache ports on %s are not connected\n", name());
172    cpuSidePort.sendRangeChange();
173    forwardSnoops = cpuSidePort.isSnooping();
174}
175
176BaseMasterPort &
177BaseCache::getMasterPort(const std::string &if_name, PortID idx)
178{
179    if (if_name == "mem_side") {
180        return memSidePort;
181    }  else {
182        return MemObject::getMasterPort(if_name, idx);
183    }
184}
185
186BaseSlavePort &
187BaseCache::getSlavePort(const std::string &if_name, PortID idx)
188{
189    if (if_name == "cpu_side") {
190        return cpuSidePort;
191    } else {
192        return MemObject::getSlavePort(if_name, idx);
193    }
194}
195
196bool
197BaseCache::inRange(Addr addr) const
198{
199    for (const auto& r : addrRanges) {
200        if (r.contains(addr)) {
201            return true;
202       }
203    }
204    return false;
205}
206
207void
208BaseCache::handleTimingReqHit(PacketPtr pkt, CacheBlk *blk, Tick request_time)
209{
210    if (pkt->needsResponse()) {
211        pkt->makeTimingResponse();
212        // @todo: Make someone pay for this
213        pkt->headerDelay = pkt->payloadDelay = 0;
214
215        // In this case we are considering request_time that takes
216        // into account the delay of the xbar, if any, and just
217        // lat, neglecting responseLatency, modelling hit latency
218        // just as lookupLatency or or the value of lat overriden
219        // by access(), that calls accessBlock() function.
220        cpuSidePort.schedTimingResp(pkt, request_time, true);
221    } else {
222        DPRINTF(Cache, "%s satisfied %s, no response needed\n", __func__,
223                pkt->print());
224
225        // queue the packet for deletion, as the sending cache is
226        // still relying on it; if the block is found in access(),
227        // CleanEvict and Writeback messages will be deleted
228        // here as well
229        pendingDelete.reset(pkt);
230    }
231}
232
233void
234BaseCache::handleTimingReqMiss(PacketPtr pkt, MSHR *mshr, CacheBlk *blk,
235                               Tick forward_time, Tick request_time)
236{
237    if (mshr) {
238        /// MSHR hit
239        /// @note writebacks will be checked in getNextMSHR()
240        /// for any conflicting requests to the same block
241
242        //@todo remove hw_pf here
243
244        // Coalesce unless it was a software prefetch (see above).
245        if (pkt) {
246            assert(!pkt->isWriteback());
247            // CleanEvicts corresponding to blocks which have
248            // outstanding requests in MSHRs are simply sunk here
249            if (pkt->cmd == MemCmd::CleanEvict) {
250                pendingDelete.reset(pkt);
251            } else if (pkt->cmd == MemCmd::WriteClean) {
252                // A WriteClean should never coalesce with any
253                // outstanding cache maintenance requests.
254
255                // We use forward_time here because there is an
256                // uncached memory write, forwarded to WriteBuffer.
257                allocateWriteBuffer(pkt, forward_time);
258            } else {
259                DPRINTF(Cache, "%s coalescing MSHR for %s\n", __func__,
260                        pkt->print());
261
262                assert(pkt->req->masterId() < system->maxMasters());
263                mshr_hits[pkt->cmdToIndex()][pkt->req->masterId()]++;
264
265                // We use forward_time here because it is the same
266                // considering new targets. We have multiple
267                // requests for the same address here. It
268                // specifies the latency to allocate an internal
269                // buffer and to schedule an event to the queued
270                // port and also takes into account the additional
271                // delay of the xbar.
272                mshr->allocateTarget(pkt, forward_time, order++,
273                                     allocOnFill(pkt->cmd));
274                if (mshr->getNumTargets() == numTarget) {
275                    noTargetMSHR = mshr;
276                    setBlocked(Blocked_NoTargets);
277                    // need to be careful with this... if this mshr isn't
278                    // ready yet (i.e. time > curTick()), we don't want to
279                    // move it ahead of mshrs that are ready
280                    // mshrQueue.moveToFront(mshr);
281                }
282            }
283        }
284    } else {
285        // no MSHR
286        assert(pkt->req->masterId() < system->maxMasters());
287        mshr_misses[pkt->cmdToIndex()][pkt->req->masterId()]++;
288
289        if (pkt->isEviction() || pkt->cmd == MemCmd::WriteClean) {
290            // We use forward_time here because there is an
291            // writeback or writeclean, forwarded to WriteBuffer.
292            allocateWriteBuffer(pkt, forward_time);
293        } else {
294            if (blk && blk->isValid()) {
295                // If we have a write miss to a valid block, we
296                // need to mark the block non-readable.  Otherwise
297                // if we allow reads while there's an outstanding
298                // write miss, the read could return stale data
299                // out of the cache block... a more aggressive
300                // system could detect the overlap (if any) and
301                // forward data out of the MSHRs, but we don't do
302                // that yet.  Note that we do need to leave the
303                // block valid so that it stays in the cache, in
304                // case we get an upgrade response (and hence no
305                // new data) when the write miss completes.
306                // As long as CPUs do proper store/load forwarding
307                // internally, and have a sufficiently weak memory
308                // model, this is probably unnecessary, but at some
309                // point it must have seemed like we needed it...
310                assert((pkt->needsWritable() && !blk->isWritable()) ||
311                       pkt->req->isCacheMaintenance());
312                blk->status &= ~BlkReadable;
313            }
314            // Here we are using forward_time, modelling the latency of
315            // a miss (outbound) just as forwardLatency, neglecting the
316            // lookupLatency component.
317            allocateMissBuffer(pkt, forward_time);
318        }
319    }
320}
321
322void
323BaseCache::recvTimingReq(PacketPtr pkt)
324{
325    // anything that is merely forwarded pays for the forward latency and
326    // the delay provided by the crossbar
327    Tick forward_time = clockEdge(forwardLatency) + pkt->headerDelay;
328
329    // We use lookupLatency here because it is used to specify the latency
330    // to access.
331    Cycles lat = lookupLatency;
332    CacheBlk *blk = nullptr;
333    bool satisfied = false;
334    {
335        PacketList writebacks;
336        // Note that lat is passed by reference here. The function
337        // access() calls accessBlock() which can modify lat value.
338        satisfied = access(pkt, blk, lat, writebacks);
339
340        // copy writebacks to write buffer here to ensure they logically
341        // proceed anything happening below
342        doWritebacks(writebacks, forward_time);
343    }
344
345    // Here we charge the headerDelay that takes into account the latencies
346    // of the bus, if the packet comes from it.
347    // The latency charged it is just lat that is the value of lookupLatency
348    // modified by access() function, or if not just lookupLatency.
349    // In case of a hit we are neglecting response latency.
350    // In case of a miss we are neglecting forward latency.
351    Tick request_time = clockEdge(lat) + pkt->headerDelay;
352    // Here we reset the timing of the packet.
353    pkt->headerDelay = pkt->payloadDelay = 0;
354    // track time of availability of next prefetch, if any
355    Tick next_pf_time = MaxTick;
356
357    if (satisfied) {
358        // if need to notify the prefetcher we have to do it before
359        // anything else as later handleTimingReqHit might turn the
360        // packet in a response
361        if (prefetcher &&
362            (prefetchOnAccess || (blk && blk->wasPrefetched()))) {
363            if (blk)
364                blk->status &= ~BlkHWPrefetched;
365
366            // Don't notify on SWPrefetch
367            if (!pkt->cmd.isSWPrefetch()) {
368                assert(!pkt->req->isCacheMaintenance());
369                next_pf_time = prefetcher->notify(pkt);
370            }
371        }
372
373        handleTimingReqHit(pkt, blk, request_time);
374    } else {
375        handleTimingReqMiss(pkt, blk, forward_time, request_time);
376
377        // We should call the prefetcher reguardless if the request is
378        // satisfied or not, reguardless if the request is in the MSHR
379        // or not. The request could be a ReadReq hit, but still not
380        // satisfied (potentially because of a prior write to the same
381        // cache line. So, even when not satisfied, there is an MSHR
382        // already allocated for this, we need to let the prefetcher
383        // know about the request
384
385        // Don't notify prefetcher on SWPrefetch or cache maintenance
386        // operations
387        if (prefetcher && pkt &&
388            !pkt->cmd.isSWPrefetch() &&
389            !pkt->req->isCacheMaintenance()) {
390            next_pf_time = prefetcher->notify(pkt);
391        }
392    }
393
394    if (next_pf_time != MaxTick) {
395        schedMemSideSendEvent(next_pf_time);
396    }
397}
398
399void
400BaseCache::handleUncacheableWriteResp(PacketPtr pkt)
401{
402    Tick completion_time = clockEdge(responseLatency) +
403        pkt->headerDelay + pkt->payloadDelay;
404
405    // Reset the bus additional time as it is now accounted for
406    pkt->headerDelay = pkt->payloadDelay = 0;
407
408    cpuSidePort.schedTimingResp(pkt, completion_time, true);
409}
410
411void
412BaseCache::recvTimingResp(PacketPtr pkt)
413{
414    assert(pkt->isResponse());
415
416    // all header delay should be paid for by the crossbar, unless
417    // this is a prefetch response from above
418    panic_if(pkt->headerDelay != 0 && pkt->cmd != MemCmd::HardPFResp,
419             "%s saw a non-zero packet delay\n", name());
420
421    const bool is_error = pkt->isError();
422
423    if (is_error) {
424        DPRINTF(Cache, "%s: Cache received %s with error\n", __func__,
425                pkt->print());
426    }
427
428    DPRINTF(Cache, "%s: Handling response %s\n", __func__,
429            pkt->print());
430
431    // if this is a write, we should be looking at an uncacheable
432    // write
433    if (pkt->isWrite()) {
434        assert(pkt->req->isUncacheable());
435        handleUncacheableWriteResp(pkt);
436        return;
437    }
438
439    // we have dealt with any (uncacheable) writes above, from here on
440    // we know we are dealing with an MSHR due to a miss or a prefetch
441    MSHR *mshr = dynamic_cast<MSHR*>(pkt->popSenderState());
442    assert(mshr);
443
444    if (mshr == noTargetMSHR) {
445        // we always clear at least one target
446        clearBlocked(Blocked_NoTargets);
447        noTargetMSHR = nullptr;
448    }
449
450    // Initial target is used just for stats
451    MSHR::Target *initial_tgt = mshr->getTarget();
452    int stats_cmd_idx = initial_tgt->pkt->cmdToIndex();
453    Tick miss_latency = curTick() - initial_tgt->recvTime;
454
455    if (pkt->req->isUncacheable()) {
456        assert(pkt->req->masterId() < system->maxMasters());
457        mshr_uncacheable_lat[stats_cmd_idx][pkt->req->masterId()] +=
458            miss_latency;
459    } else {
460        assert(pkt->req->masterId() < system->maxMasters());
461        mshr_miss_latency[stats_cmd_idx][pkt->req->masterId()] +=
462            miss_latency;
463    }
464
465    PacketList writebacks;
466
467    bool is_fill = !mshr->isForward &&
468        (pkt->isRead() || pkt->cmd == MemCmd::UpgradeResp);
469
470    CacheBlk *blk = tags->findBlock(pkt->getAddr(), pkt->isSecure());
471
472    if (is_fill && !is_error) {
473        DPRINTF(Cache, "Block for addr %#llx being updated in Cache\n",
474                pkt->getAddr());
475
476        blk = handleFill(pkt, blk, writebacks, mshr->allocOnFill());
477        assert(blk != nullptr);
478    }
479
480    if (blk && blk->isValid() && pkt->isClean() && !pkt->isInvalidate()) {
481        // The block was marked not readable while there was a pending
482        // cache maintenance operation, restore its flag.
483        blk->status |= BlkReadable;
484    }
485
486    if (blk && blk->isWritable() && !pkt->req->isCacheInvalidate()) {
487        // If at this point the referenced block is writable and the
488        // response is not a cache invalidate, we promote targets that
489        // were deferred as we couldn't guarrantee a writable copy
490        mshr->promoteWritable();
491    }
492
493    serviceMSHRTargets(mshr, pkt, blk, writebacks);
494
495    if (mshr->promoteDeferredTargets()) {
496        // avoid later read getting stale data while write miss is
497        // outstanding.. see comment in timingAccess()
498        if (blk) {
499            blk->status &= ~BlkReadable;
500        }
501        mshrQueue.markPending(mshr);
502        schedMemSideSendEvent(clockEdge() + pkt->payloadDelay);
503    } else {
504        // while we deallocate an mshr from the queue we still have to
505        // check the isFull condition before and after as we might
506        // have been using the reserved entries already
507        const bool was_full = mshrQueue.isFull();
508        mshrQueue.deallocate(mshr);
509        if (was_full && !mshrQueue.isFull()) {
510            clearBlocked(Blocked_NoMSHRs);
511        }
512
513        // Request the bus for a prefetch if this deallocation freed enough
514        // MSHRs for a prefetch to take place
515        if (prefetcher && mshrQueue.canPrefetch()) {
516            Tick next_pf_time = std::max(prefetcher->nextPrefetchReadyTime(),
517                                         clockEdge());
518            if (next_pf_time != MaxTick)
519                schedMemSideSendEvent(next_pf_time);
520        }
521    }
522
523    // if we used temp block, check to see if its valid and then clear it out
524    if (blk == tempBlock && tempBlock->isValid()) {
525        evictBlock(blk, writebacks);
526    }
527
528    const Tick forward_time = clockEdge(forwardLatency) + pkt->headerDelay;
529    // copy writebacks to write buffer
530    doWritebacks(writebacks, forward_time);
531
532    DPRINTF(CacheVerbose, "%s: Leaving with %s\n", __func__, pkt->print());
533    delete pkt;
534}
535
536
537Tick
538BaseCache::recvAtomic(PacketPtr pkt)
539{
540    // We are in atomic mode so we pay just for lookupLatency here.
541    Cycles lat = lookupLatency;
542
543    // follow the same flow as in recvTimingReq, and check if a cache
544    // above us is responding
545    if (pkt->cacheResponding() && !pkt->isClean()) {
546        assert(!pkt->req->isCacheInvalidate());
547        DPRINTF(Cache, "Cache above responding to %s: not responding\n",
548                pkt->print());
549
550        // if a cache is responding, and it had the line in Owned
551        // rather than Modified state, we need to invalidate any
552        // copies that are not on the same path to memory
553        assert(pkt->needsWritable() && !pkt->responderHadWritable());
554        lat += ticksToCycles(memSidePort.sendAtomic(pkt));
555
556        return lat * clockPeriod();
557    }
558
559    // should assert here that there are no outstanding MSHRs or
560    // writebacks... that would mean that someone used an atomic
561    // access in timing mode
562
563    CacheBlk *blk = nullptr;
564    PacketList writebacks;
565    bool satisfied = access(pkt, blk, lat, writebacks);
566
567    if (pkt->isClean() && blk && blk->isDirty()) {
568        // A cache clean opearation is looking for a dirty
569        // block. If a dirty block is encountered a WriteClean
570        // will update any copies to the path to the memory
571        // until the point of reference.
572        DPRINTF(CacheVerbose, "%s: packet %s found block: %s\n",
573                __func__, pkt->print(), blk->print());
574        PacketPtr wb_pkt = writecleanBlk(blk, pkt->req->getDest(), pkt->id);
575        writebacks.push_back(wb_pkt);
576        pkt->setSatisfied();
577    }
578
579    // handle writebacks resulting from the access here to ensure they
580    // logically proceed anything happening below
581    doWritebacksAtomic(writebacks);
582    assert(writebacks.empty());
583
584    if (!satisfied) {
585        lat += handleAtomicReqMiss(pkt, blk, writebacks);
586    }
587
588    // Note that we don't invoke the prefetcher at all in atomic mode.
589    // It's not clear how to do it properly, particularly for
590    // prefetchers that aggressively generate prefetch candidates and
591    // rely on bandwidth contention to throttle them; these will tend
592    // to pollute the cache in atomic mode since there is no bandwidth
593    // contention.  If we ever do want to enable prefetching in atomic
594    // mode, though, this is the place to do it... see timingAccess()
595    // for an example (though we'd want to issue the prefetch(es)
596    // immediately rather than calling requestMemSideBus() as we do
597    // there).
598
599    // do any writebacks resulting from the response handling
600    doWritebacksAtomic(writebacks);
601
602    // if we used temp block, check to see if its valid and if so
603    // clear it out, but only do so after the call to recvAtomic is
604    // finished so that any downstream observers (such as a snoop
605    // filter), first see the fill, and only then see the eviction
606    if (blk == tempBlock && tempBlock->isValid()) {
607        // the atomic CPU calls recvAtomic for fetch and load/store
608        // sequentuially, and we may already have a tempBlock
609        // writeback from the fetch that we have not yet sent
610        if (tempBlockWriteback) {
611            // if that is the case, write the prevoius one back, and
612            // do not schedule any new event
613            writebackTempBlockAtomic();
614        } else {
615            // the writeback/clean eviction happens after the call to
616            // recvAtomic has finished (but before any successive
617            // calls), so that the response handling from the fill is
618            // allowed to happen first
619            schedule(writebackTempBlockAtomicEvent, curTick());
620        }
621
622        tempBlockWriteback = evictBlock(blk);
623    }
624
625    if (pkt->needsResponse()) {
626        pkt->makeAtomicResponse();
627    }
628
629    return lat * clockPeriod();
630}
631
632void
633BaseCache::functionalAccess(PacketPtr pkt, bool from_cpu_side)
634{
635    Addr blk_addr = pkt->getBlockAddr(blkSize);
636    bool is_secure = pkt->isSecure();
637    CacheBlk *blk = tags->findBlock(pkt->getAddr(), is_secure);
638    MSHR *mshr = mshrQueue.findMatch(blk_addr, is_secure);
639
640    pkt->pushLabel(name());
641
642    CacheBlkPrintWrapper cbpw(blk);
643
644    // Note that just because an L2/L3 has valid data doesn't mean an
645    // L1 doesn't have a more up-to-date modified copy that still
646    // needs to be found.  As a result we always update the request if
647    // we have it, but only declare it satisfied if we are the owner.
648
649    // see if we have data at all (owned or otherwise)
650    bool have_data = blk && blk->isValid()
651        && pkt->checkFunctional(&cbpw, blk_addr, is_secure, blkSize,
652                                blk->data);
653
654    // data we have is dirty if marked as such or if we have an
655    // in-service MSHR that is pending a modified line
656    bool have_dirty =
657        have_data && (blk->isDirty() ||
658                      (mshr && mshr->inService && mshr->isPendingModified()));
659
660    bool done = have_dirty ||
661        cpuSidePort.checkFunctional(pkt) ||
662        mshrQueue.checkFunctional(pkt, blk_addr) ||
663        writeBuffer.checkFunctional(pkt, blk_addr) ||
664        memSidePort.checkFunctional(pkt);
665
666    DPRINTF(CacheVerbose, "%s: %s %s%s%s\n", __func__,  pkt->print(),
667            (blk && blk->isValid()) ? "valid " : "",
668            have_data ? "data " : "", done ? "done " : "");
669
670    // We're leaving the cache, so pop cache->name() label
671    pkt->popLabel();
672
673    if (done) {
674        pkt->makeResponse();
675    } else {
676        // if it came as a request from the CPU side then make sure it
677        // continues towards the memory side
678        if (from_cpu_side) {
679            memSidePort.sendFunctional(pkt);
680        } else if (cpuSidePort.isSnooping()) {
681            // if it came from the memory side, it must be a snoop request
682            // and we should only forward it if we are forwarding snoops
683            cpuSidePort.sendFunctionalSnoop(pkt);
684        }
685    }
686}
687
688
689void
690BaseCache::cmpAndSwap(CacheBlk *blk, PacketPtr pkt)
691{
692    assert(pkt->isRequest());
693
694    uint64_t overwrite_val;
695    bool overwrite_mem;
696    uint64_t condition_val64;
697    uint32_t condition_val32;
698
699    int offset = pkt->getOffset(blkSize);
700    uint8_t *blk_data = blk->data + offset;
701
702    assert(sizeof(uint64_t) >= pkt->getSize());
703
704    overwrite_mem = true;
705    // keep a copy of our possible write value, and copy what is at the
706    // memory address into the packet
707    pkt->writeData((uint8_t *)&overwrite_val);
708    pkt->setData(blk_data);
709
710    if (pkt->req->isCondSwap()) {
711        if (pkt->getSize() == sizeof(uint64_t)) {
712            condition_val64 = pkt->req->getExtraData();
713            overwrite_mem = !std::memcmp(&condition_val64, blk_data,
714                                         sizeof(uint64_t));
715        } else if (pkt->getSize() == sizeof(uint32_t)) {
716            condition_val32 = (uint32_t)pkt->req->getExtraData();
717            overwrite_mem = !std::memcmp(&condition_val32, blk_data,
718                                         sizeof(uint32_t));
719        } else
720            panic("Invalid size for conditional read/write\n");
721    }
722
723    if (overwrite_mem) {
724        std::memcpy(blk_data, &overwrite_val, pkt->getSize());
725        blk->status |= BlkDirty;
726    }
727}
728
729QueueEntry*
730BaseCache::getNextQueueEntry()
731{
732    // Check both MSHR queue and write buffer for potential requests,
733    // note that null does not mean there is no request, it could
734    // simply be that it is not ready
735    MSHR *miss_mshr  = mshrQueue.getNext();
736    WriteQueueEntry *wq_entry = writeBuffer.getNext();
737
738    // If we got a write buffer request ready, first priority is a
739    // full write buffer, otherwise we favour the miss requests
740    if (wq_entry && (writeBuffer.isFull() || !miss_mshr)) {
741        // need to search MSHR queue for conflicting earlier miss.
742        MSHR *conflict_mshr =
743            mshrQueue.findPending(wq_entry->blkAddr,
744                                  wq_entry->isSecure);
745
746        if (conflict_mshr && conflict_mshr->order < wq_entry->order) {
747            // Service misses in order until conflict is cleared.
748            return conflict_mshr;
749
750            // @todo Note that we ignore the ready time of the conflict here
751        }
752
753        // No conflicts; issue write
754        return wq_entry;
755    } else if (miss_mshr) {
756        // need to check for conflicting earlier writeback
757        WriteQueueEntry *conflict_mshr =
758            writeBuffer.findPending(miss_mshr->blkAddr,
759                                    miss_mshr->isSecure);
760        if (conflict_mshr) {
761            // not sure why we don't check order here... it was in the
762            // original code but commented out.
763
764            // The only way this happens is if we are
765            // doing a write and we didn't have permissions
766            // then subsequently saw a writeback (owned got evicted)
767            // We need to make sure to perform the writeback first
768            // To preserve the dirty data, then we can issue the write
769
770            // should we return wq_entry here instead?  I.e. do we
771            // have to flush writes in order?  I don't think so... not
772            // for Alpha anyway.  Maybe for x86?
773            return conflict_mshr;
774
775            // @todo Note that we ignore the ready time of the conflict here
776        }
777
778        // No conflicts; issue read
779        return miss_mshr;
780    }
781
782    // fall through... no pending requests.  Try a prefetch.
783    assert(!miss_mshr && !wq_entry);
784    if (prefetcher && mshrQueue.canPrefetch()) {
785        // If we have a miss queue slot, we can try a prefetch
786        PacketPtr pkt = prefetcher->getPacket();
787        if (pkt) {
788            Addr pf_addr = pkt->getBlockAddr(blkSize);
789            if (!tags->findBlock(pf_addr, pkt->isSecure()) &&
790                !mshrQueue.findMatch(pf_addr, pkt->isSecure()) &&
791                !writeBuffer.findMatch(pf_addr, pkt->isSecure())) {
792                // Update statistic on number of prefetches issued
793                // (hwpf_mshr_misses)
794                assert(pkt->req->masterId() < system->maxMasters());
795                mshr_misses[pkt->cmdToIndex()][pkt->req->masterId()]++;
796
797                // allocate an MSHR and return it, note
798                // that we send the packet straight away, so do not
799                // schedule the send
800                return allocateMissBuffer(pkt, curTick(), false);
801            } else {
802                // free the request and packet
803                delete pkt->req;
804                delete pkt;
805            }
806        }
807    }
808
809    return nullptr;
810}
811
812void
813BaseCache::satisfyRequest(PacketPtr pkt, CacheBlk *blk, bool, bool)
814{
815    assert(pkt->isRequest());
816
817    assert(blk && blk->isValid());
818    // Occasionally this is not true... if we are a lower-level cache
819    // satisfying a string of Read and ReadEx requests from
820    // upper-level caches, a Read will mark the block as shared but we
821    // can satisfy a following ReadEx anyway since we can rely on the
822    // Read requester(s) to have buffered the ReadEx snoop and to
823    // invalidate their blocks after receiving them.
824    // assert(!pkt->needsWritable() || blk->isWritable());
825    assert(pkt->getOffset(blkSize) + pkt->getSize() <= blkSize);
826
827    // Check RMW operations first since both isRead() and
828    // isWrite() will be true for them
829    if (pkt->cmd == MemCmd::SwapReq) {
830        cmpAndSwap(blk, pkt);
831    } else if (pkt->isWrite()) {
832        // we have the block in a writable state and can go ahead,
833        // note that the line may be also be considered writable in
834        // downstream caches along the path to memory, but always
835        // Exclusive, and never Modified
836        assert(blk->isWritable());
837        // Write or WriteLine at the first cache with block in writable state
838        if (blk->checkWrite(pkt)) {
839            pkt->writeDataToBlock(blk->data, blkSize);
840        }
841        // Always mark the line as dirty (and thus transition to the
842        // Modified state) even if we are a failed StoreCond so we
843        // supply data to any snoops that have appended themselves to
844        // this cache before knowing the store will fail.
845        blk->status |= BlkDirty;
846        DPRINTF(CacheVerbose, "%s for %s (write)\n", __func__, pkt->print());
847    } else if (pkt->isRead()) {
848        if (pkt->isLLSC()) {
849            blk->trackLoadLocked(pkt);
850        }
851
852        // all read responses have a data payload
853        assert(pkt->hasRespData());
854        pkt->setDataFromBlock(blk->data, blkSize);
855    } else if (pkt->isUpgrade()) {
856        // sanity check
857        assert(!pkt->hasSharers());
858
859        if (blk->isDirty()) {
860            // we were in the Owned state, and a cache above us that
861            // has the line in Shared state needs to be made aware
862            // that the data it already has is in fact dirty
863            pkt->setCacheResponding();
864            blk->status &= ~BlkDirty;
865        }
866    } else {
867        assert(pkt->isInvalidate());
868        invalidateBlock(blk);
869        DPRINTF(CacheVerbose, "%s for %s (invalidation)\n", __func__,
870                pkt->print());
871    }
872}
873
874/////////////////////////////////////////////////////
875//
876// Access path: requests coming in from the CPU side
877//
878/////////////////////////////////////////////////////
879
880bool
881BaseCache::access(PacketPtr pkt, CacheBlk *&blk, Cycles &lat,
882                  PacketList &writebacks)
883{
884    // sanity check
885    assert(pkt->isRequest());
886
887    chatty_assert(!(isReadOnly && pkt->isWrite()),
888                  "Should never see a write in a read-only cache %s\n",
889                  name());
890
891    // Here lat is the value passed as parameter to accessBlock() function
892    // that can modify its value.
893    blk = tags->accessBlock(pkt->getAddr(), pkt->isSecure(), lat);
894
895    DPRINTF(Cache, "%s for %s %s\n", __func__, pkt->print(),
896            blk ? "hit " + blk->print() : "miss");
897
898    if (pkt->req->isCacheMaintenance()) {
899        // A cache maintenance operation is always forwarded to the
900        // memory below even if the block is found in dirty state.
901
902        // We defer any changes to the state of the block until we
903        // create and mark as in service the mshr for the downstream
904        // packet.
905        return false;
906    }
907
908    if (pkt->isEviction()) {
909        // We check for presence of block in above caches before issuing
910        // Writeback or CleanEvict to write buffer. Therefore the only
911        // possible cases can be of a CleanEvict packet coming from above
912        // encountering a Writeback generated in this cache peer cache and
913        // waiting in the write buffer. Cases of upper level peer caches
914        // generating CleanEvict and Writeback or simply CleanEvict and
915        // CleanEvict almost simultaneously will be caught by snoops sent out
916        // by crossbar.
917        WriteQueueEntry *wb_entry = writeBuffer.findMatch(pkt->getAddr(),
918                                                          pkt->isSecure());
919        if (wb_entry) {
920            assert(wb_entry->getNumTargets() == 1);
921            PacketPtr wbPkt = wb_entry->getTarget()->pkt;
922            assert(wbPkt->isWriteback());
923
924            if (pkt->isCleanEviction()) {
925                // The CleanEvict and WritebackClean snoops into other
926                // peer caches of the same level while traversing the
927                // crossbar. If a copy of the block is found, the
928                // packet is deleted in the crossbar. Hence, none of
929                // the other upper level caches connected to this
930                // cache have the block, so we can clear the
931                // BLOCK_CACHED flag in the Writeback if set and
932                // discard the CleanEvict by returning true.
933                wbPkt->clearBlockCached();
934                return true;
935            } else {
936                assert(pkt->cmd == MemCmd::WritebackDirty);
937                // Dirty writeback from above trumps our clean
938                // writeback... discard here
939                // Note: markInService will remove entry from writeback buffer.
940                markInService(wb_entry);
941                delete wbPkt;
942            }
943        }
944    }
945
946    // Writeback handling is special case.  We can write the block into
947    // the cache without having a writeable copy (or any copy at all).
948    if (pkt->isWriteback()) {
949        assert(blkSize == pkt->getSize());
950
951        // we could get a clean writeback while we are having
952        // outstanding accesses to a block, do the simple thing for
953        // now and drop the clean writeback so that we do not upset
954        // any ordering/decisions about ownership already taken
955        if (pkt->cmd == MemCmd::WritebackClean &&
956            mshrQueue.findMatch(pkt->getAddr(), pkt->isSecure())) {
957            DPRINTF(Cache, "Clean writeback %#llx to block with MSHR, "
958                    "dropping\n", pkt->getAddr());
959            return true;
960        }
961
962        if (!blk) {
963            // need to do a replacement
964            blk = allocateBlock(pkt->getAddr(), pkt->isSecure(), writebacks);
965            if (!blk) {
966                // no replaceable block available: give up, fwd to next level.
967                incMissCount(pkt);
968                return false;
969            }
970            tags->insertBlock(pkt, blk);
971
972            blk->status |= (BlkValid | BlkReadable);
973        }
974        // only mark the block dirty if we got a writeback command,
975        // and leave it as is for a clean writeback
976        if (pkt->cmd == MemCmd::WritebackDirty) {
977            // TODO: the coherent cache can assert(!blk->isDirty());
978            blk->status |= BlkDirty;
979        }
980        // if the packet does not have sharers, it is passing
981        // writable, and we got the writeback in Modified or Exclusive
982        // state, if not we are in the Owned or Shared state
983        if (!pkt->hasSharers()) {
984            blk->status |= BlkWritable;
985        }
986        // nothing else to do; writeback doesn't expect response
987        assert(!pkt->needsResponse());
988        pkt->writeDataToBlock(blk->data, blkSize);
989        DPRINTF(Cache, "%s new state is %s\n", __func__, blk->print());
990        incHitCount(pkt);
991        // populate the time when the block will be ready to access.
992        blk->whenReady = clockEdge(fillLatency) + pkt->headerDelay +
993            pkt->payloadDelay;
994        return true;
995    } else if (pkt->cmd == MemCmd::CleanEvict) {
996        if (blk) {
997            // Found the block in the tags, need to stop CleanEvict from
998            // propagating further down the hierarchy. Returning true will
999            // treat the CleanEvict like a satisfied write request and delete
1000            // it.
1001            return true;
1002        }
1003        // We didn't find the block here, propagate the CleanEvict further
1004        // down the memory hierarchy. Returning false will treat the CleanEvict
1005        // like a Writeback which could not find a replaceable block so has to
1006        // go to next level.
1007        return false;
1008    } else if (pkt->cmd == MemCmd::WriteClean) {
1009        // WriteClean handling is a special case. We can allocate a
1010        // block directly if it doesn't exist and we can update the
1011        // block immediately. The WriteClean transfers the ownership
1012        // of the block as well.
1013        assert(blkSize == pkt->getSize());
1014
1015        if (!blk) {
1016            if (pkt->writeThrough()) {
1017                // if this is a write through packet, we don't try to
1018                // allocate if the block is not present
1019                return false;
1020            } else {
1021                // a writeback that misses needs to allocate a new block
1022                blk = allocateBlock(pkt->getAddr(), pkt->isSecure(),
1023                                    writebacks);
1024                if (!blk) {
1025                    // no replaceable block available: give up, fwd to
1026                    // next level.
1027                    incMissCount(pkt);
1028                    return false;
1029                }
1030                tags->insertBlock(pkt, blk);
1031
1032                blk->status |= (BlkValid | BlkReadable);
1033            }
1034        }
1035
1036        // at this point either this is a writeback or a write-through
1037        // write clean operation and the block is already in this
1038        // cache, we need to update the data and the block flags
1039        assert(blk);
1040        // TODO: the coherent cache can assert(!blk->isDirty());
1041        if (!pkt->writeThrough()) {
1042            blk->status |= BlkDirty;
1043        }
1044        // nothing else to do; writeback doesn't expect response
1045        assert(!pkt->needsResponse());
1046        pkt->writeDataToBlock(blk->data, blkSize);
1047        DPRINTF(Cache, "%s new state is %s\n", __func__, blk->print());
1048
1049        incHitCount(pkt);
1050        // populate the time when the block will be ready to access.
1051        blk->whenReady = clockEdge(fillLatency) + pkt->headerDelay +
1052            pkt->payloadDelay;
1053        // if this a write-through packet it will be sent to cache
1054        // below
1055        return !pkt->writeThrough();
1056    } else if (blk && (pkt->needsWritable() ? blk->isWritable() :
1057                       blk->isReadable())) {
1058        // OK to satisfy access
1059        incHitCount(pkt);
1060        satisfyRequest(pkt, blk);
1061        maintainClusivity(pkt->fromCache(), blk);
1062
1063        return true;
1064    }
1065
1066    // Can't satisfy access normally... either no block (blk == nullptr)
1067    // or have block but need writable
1068
1069    incMissCount(pkt);
1070
1071    if (!blk && pkt->isLLSC() && pkt->isWrite()) {
1072        // complete miss on store conditional... just give up now
1073        pkt->req->setExtraData(0);
1074        return true;
1075    }
1076
1077    return false;
1078}
1079
1080void
1081BaseCache::maintainClusivity(bool from_cache, CacheBlk *blk)
1082{
1083    if (from_cache && blk && blk->isValid() && !blk->isDirty() &&
1084        clusivity == Enums::mostly_excl) {
1085        // if we have responded to a cache, and our block is still
1086        // valid, but not dirty, and this cache is mostly exclusive
1087        // with respect to the cache above, drop the block
1088        invalidateBlock(blk);
1089    }
1090}
1091
1092CacheBlk*
1093BaseCache::handleFill(PacketPtr pkt, CacheBlk *blk, PacketList &writebacks,
1094                      bool allocate)
1095{
1096    assert(pkt->isResponse() || pkt->cmd == MemCmd::WriteLineReq);
1097    Addr addr = pkt->getAddr();
1098    bool is_secure = pkt->isSecure();
1099#if TRACING_ON
1100    CacheBlk::State old_state = blk ? blk->status : 0;
1101#endif
1102
1103    // When handling a fill, we should have no writes to this line.
1104    assert(addr == pkt->getBlockAddr(blkSize));
1105    assert(!writeBuffer.findMatch(addr, is_secure));
1106
1107    if (!blk) {
1108        // better have read new data...
1109        assert(pkt->hasData());
1110
1111        // only read responses and write-line requests have data;
1112        // note that we don't write the data here for write-line - that
1113        // happens in the subsequent call to satisfyRequest
1114        assert(pkt->isRead() || pkt->cmd == MemCmd::WriteLineReq);
1115
1116        // need to do a replacement if allocating, otherwise we stick
1117        // with the temporary storage
1118        blk = allocate ? allocateBlock(addr, is_secure, writebacks) : nullptr;
1119
1120        if (!blk) {
1121            // No replaceable block or a mostly exclusive
1122            // cache... just use temporary storage to complete the
1123            // current request and then get rid of it
1124            assert(!tempBlock->isValid());
1125            blk = tempBlock;
1126            tempBlock->set = tags->extractSet(addr);
1127            tempBlock->tag = tags->extractTag(addr);
1128            DPRINTF(Cache, "using temp block for %#llx (%s)\n", addr,
1129                    is_secure ? "s" : "ns");
1130        } else {
1131            tags->insertBlock(pkt, blk);
1132        }
1133
1134        // we should never be overwriting a valid block
1135        assert(!blk->isValid());
1136    } else {
1137        // existing block... probably an upgrade
1138        assert(blk->tag == tags->extractTag(addr));
1139        // either we're getting new data or the block should already be valid
1140        assert(pkt->hasData() || blk->isValid());
1141        // don't clear block status... if block is already dirty we
1142        // don't want to lose that
1143    }
1144
1145    if (is_secure)
1146        blk->status |= BlkSecure;
1147    blk->status |= BlkValid | BlkReadable;
1148
1149    // sanity check for whole-line writes, which should always be
1150    // marked as writable as part of the fill, and then later marked
1151    // dirty as part of satisfyRequest
1152    if (pkt->cmd == MemCmd::WriteLineReq) {
1153        assert(!pkt->hasSharers());
1154    }
1155
1156    // here we deal with setting the appropriate state of the line,
1157    // and we start by looking at the hasSharers flag, and ignore the
1158    // cacheResponding flag (normally signalling dirty data) if the
1159    // packet has sharers, thus the line is never allocated as Owned
1160    // (dirty but not writable), and always ends up being either
1161    // Shared, Exclusive or Modified, see Packet::setCacheResponding
1162    // for more details
1163    if (!pkt->hasSharers()) {
1164        // we could get a writable line from memory (rather than a
1165        // cache) even in a read-only cache, note that we set this bit
1166        // even for a read-only cache, possibly revisit this decision
1167        blk->status |= BlkWritable;
1168
1169        // check if we got this via cache-to-cache transfer (i.e., from a
1170        // cache that had the block in Modified or Owned state)
1171        if (pkt->cacheResponding()) {
1172            // we got the block in Modified state, and invalidated the
1173            // owners copy
1174            blk->status |= BlkDirty;
1175
1176            chatty_assert(!isReadOnly, "Should never see dirty snoop response "
1177                          "in read-only cache %s\n", name());
1178        }
1179    }
1180
1181    DPRINTF(Cache, "Block addr %#llx (%s) moving from state %x to %s\n",
1182            addr, is_secure ? "s" : "ns", old_state, blk->print());
1183
1184    // if we got new data, copy it in (checking for a read response
1185    // and a response that has data is the same in the end)
1186    if (pkt->isRead()) {
1187        // sanity checks
1188        assert(pkt->hasData());
1189        assert(pkt->getSize() == blkSize);
1190
1191        pkt->writeDataToBlock(blk->data, blkSize);
1192    }
1193    // We pay for fillLatency here.
1194    blk->whenReady = clockEdge() + fillLatency * clockPeriod() +
1195        pkt->payloadDelay;
1196
1197    return blk;
1198}
1199
1200CacheBlk*
1201BaseCache::allocateBlock(Addr addr, bool is_secure, PacketList &writebacks)
1202{
1203    // Find replacement victim
1204    CacheBlk *blk = tags->findVictim(addr);
1205
1206    // It is valid to return nullptr if there is no victim
1207    if (!blk)
1208        return nullptr;
1209
1210    if (blk->isValid()) {
1211        Addr repl_addr = tags->regenerateBlkAddr(blk);
1212        MSHR *repl_mshr = mshrQueue.findMatch(repl_addr, blk->isSecure());
1213        if (repl_mshr) {
1214            // must be an outstanding upgrade or clean request
1215            // on a block we're about to replace...
1216            assert((!blk->isWritable() && repl_mshr->needsWritable()) ||
1217                   repl_mshr->isCleaning());
1218            // too hard to replace block with transient state
1219            // allocation failed, block not inserted
1220            return nullptr;
1221        } else {
1222            DPRINTF(Cache, "replacement: replacing %#llx (%s) with %#llx "
1223                    "(%s): %s\n", repl_addr, blk->isSecure() ? "s" : "ns",
1224                    addr, is_secure ? "s" : "ns",
1225                    blk->isDirty() ? "writeback" : "clean");
1226
1227            if (blk->wasPrefetched()) {
1228                unusedPrefetches++;
1229            }
1230            evictBlock(blk, writebacks);
1231            replacements++;
1232        }
1233    }
1234
1235    return blk;
1236}
1237
1238void
1239BaseCache::invalidateBlock(CacheBlk *blk)
1240{
1241    if (blk != tempBlock)
1242        tags->invalidate(blk);
1243    blk->invalidate();
1244}
1245
1246PacketPtr
1247BaseCache::writebackBlk(CacheBlk *blk)
1248{
1249    chatty_assert(!isReadOnly || writebackClean,
1250                  "Writeback from read-only cache");
1251    assert(blk && blk->isValid() && (blk->isDirty() || writebackClean));
1252
1253    writebacks[Request::wbMasterId]++;
1254
1255    Request *req = new Request(tags->regenerateBlkAddr(blk), blkSize, 0,
1256                               Request::wbMasterId);
1257    if (blk->isSecure())
1258        req->setFlags(Request::SECURE);
1259
1260    req->taskId(blk->task_id);
1261
1262    PacketPtr pkt =
1263        new Packet(req, blk->isDirty() ?
1264                   MemCmd::WritebackDirty : MemCmd::WritebackClean);
1265
1266    DPRINTF(Cache, "Create Writeback %s writable: %d, dirty: %d\n",
1267            pkt->print(), blk->isWritable(), blk->isDirty());
1268
1269    if (blk->isWritable()) {
1270        // not asserting shared means we pass the block in modified
1271        // state, mark our own block non-writeable
1272        blk->status &= ~BlkWritable;
1273    } else {
1274        // we are in the Owned state, tell the receiver
1275        pkt->setHasSharers();
1276    }
1277
1278    // make sure the block is not marked dirty
1279    blk->status &= ~BlkDirty;
1280
1281    pkt->allocate();
1282    pkt->setDataFromBlock(blk->data, blkSize);
1283
1284    return pkt;
1285}
1286
1287PacketPtr
1288BaseCache::writecleanBlk(CacheBlk *blk, Request::Flags dest, PacketId id)
1289{
1290    Request *req = new Request(tags->regenerateBlkAddr(blk), blkSize, 0,
1291                               Request::wbMasterId);
1292    if (blk->isSecure()) {
1293        req->setFlags(Request::SECURE);
1294    }
1295    req->taskId(blk->task_id);
1296
1297    PacketPtr pkt = new Packet(req, MemCmd::WriteClean, blkSize, id);
1298
1299    if (dest) {
1300        req->setFlags(dest);
1301        pkt->setWriteThrough();
1302    }
1303
1304    DPRINTF(Cache, "Create %s writable: %d, dirty: %d\n", pkt->print(),
1305            blk->isWritable(), blk->isDirty());
1306
1307    if (blk->isWritable()) {
1308        // not asserting shared means we pass the block in modified
1309        // state, mark our own block non-writeable
1310        blk->status &= ~BlkWritable;
1311    } else {
1312        // we are in the Owned state, tell the receiver
1313        pkt->setHasSharers();
1314    }
1315
1316    // make sure the block is not marked dirty
1317    blk->status &= ~BlkDirty;
1318
1319    pkt->allocate();
1320    pkt->setDataFromBlock(blk->data, blkSize);
1321
1322    return pkt;
1323}
1324
1325
1326void
1327BaseCache::memWriteback()
1328{
1329    CacheBlkVisitorWrapper visitor(*this, &BaseCache::writebackVisitor);
1330    tags->forEachBlk(visitor);
1331}
1332
1333void
1334BaseCache::memInvalidate()
1335{
1336    CacheBlkVisitorWrapper visitor(*this, &BaseCache::invalidateVisitor);
1337    tags->forEachBlk(visitor);
1338}
1339
1340bool
1341BaseCache::isDirty() const
1342{
1343    CacheBlkIsDirtyVisitor visitor;
1344    tags->forEachBlk(visitor);
1345
1346    return visitor.isDirty();
1347}
1348
1349bool
1350BaseCache::writebackVisitor(CacheBlk &blk)
1351{
1352    if (blk.isDirty()) {
1353        assert(blk.isValid());
1354
1355        Request request(tags->regenerateBlkAddr(&blk),
1356                        blkSize, 0, Request::funcMasterId);
1357        request.taskId(blk.task_id);
1358        if (blk.isSecure()) {
1359            request.setFlags(Request::SECURE);
1360        }
1361
1362        Packet packet(&request, MemCmd::WriteReq);
1363        packet.dataStatic(blk.data);
1364
1365        memSidePort.sendFunctional(&packet);
1366
1367        blk.status &= ~BlkDirty;
1368    }
1369
1370    return true;
1371}
1372
1373bool
1374BaseCache::invalidateVisitor(CacheBlk &blk)
1375{
1376    if (blk.isDirty())
1377        warn_once("Invalidating dirty cache lines. " \
1378                  "Expect things to break.\n");
1379
1380    if (blk.isValid()) {
1381        assert(!blk.isDirty());
1382        invalidateBlock(&blk);
1383    }
1384
1385    return true;
1386}
1387
1388Tick
1389BaseCache::nextQueueReadyTime() const
1390{
1391    Tick nextReady = std::min(mshrQueue.nextReadyTime(),
1392                              writeBuffer.nextReadyTime());
1393
1394    // Don't signal prefetch ready time if no MSHRs available
1395    // Will signal once enoguh MSHRs are deallocated
1396    if (prefetcher && mshrQueue.canPrefetch()) {
1397        nextReady = std::min(nextReady,
1398                             prefetcher->nextPrefetchReadyTime());
1399    }
1400
1401    return nextReady;
1402}
1403
1404
1405bool
1406BaseCache::sendMSHRQueuePacket(MSHR* mshr)
1407{
1408    assert(mshr);
1409
1410    // use request from 1st target
1411    PacketPtr tgt_pkt = mshr->getTarget()->pkt;
1412
1413    DPRINTF(Cache, "%s: MSHR %s\n", __func__, tgt_pkt->print());
1414
1415    CacheBlk *blk = tags->findBlock(mshr->blkAddr, mshr->isSecure);
1416
1417    // either a prefetch that is not present upstream, or a normal
1418    // MSHR request, proceed to get the packet to send downstream
1419    PacketPtr pkt = createMissPacket(tgt_pkt, blk, mshr->needsWritable());
1420
1421    mshr->isForward = (pkt == nullptr);
1422
1423    if (mshr->isForward) {
1424        // not a cache block request, but a response is expected
1425        // make copy of current packet to forward, keep current
1426        // copy for response handling
1427        pkt = new Packet(tgt_pkt, false, true);
1428        assert(!pkt->isWrite());
1429    }
1430
1431    // play it safe and append (rather than set) the sender state,
1432    // as forwarded packets may already have existing state
1433    pkt->pushSenderState(mshr);
1434
1435    if (pkt->isClean() && blk && blk->isDirty()) {
1436        // A cache clean opearation is looking for a dirty block. Mark
1437        // the packet so that the destination xbar can determine that
1438        // there will be a follow-up write packet as well.
1439        pkt->setSatisfied();
1440    }
1441
1442    if (!memSidePort.sendTimingReq(pkt)) {
1443        // we are awaiting a retry, but we
1444        // delete the packet and will be creating a new packet
1445        // when we get the opportunity
1446        delete pkt;
1447
1448        // note that we have now masked any requestBus and
1449        // schedSendEvent (we will wait for a retry before
1450        // doing anything), and this is so even if we do not
1451        // care about this packet and might override it before
1452        // it gets retried
1453        return true;
1454    } else {
1455        // As part of the call to sendTimingReq the packet is
1456        // forwarded to all neighbouring caches (and any caches
1457        // above them) as a snoop. Thus at this point we know if
1458        // any of the neighbouring caches are responding, and if
1459        // so, we know it is dirty, and we can determine if it is
1460        // being passed as Modified, making our MSHR the ordering
1461        // point
1462        bool pending_modified_resp = !pkt->hasSharers() &&
1463            pkt->cacheResponding();
1464        markInService(mshr, pending_modified_resp);
1465
1466        if (pkt->isClean() && blk && blk->isDirty()) {
1467            // A cache clean opearation is looking for a dirty
1468            // block. If a dirty block is encountered a WriteClean
1469            // will update any copies to the path to the memory
1470            // until the point of reference.
1471            DPRINTF(CacheVerbose, "%s: packet %s found block: %s\n",
1472                    __func__, pkt->print(), blk->print());
1473            PacketPtr wb_pkt = writecleanBlk(blk, pkt->req->getDest(),
1474                                             pkt->id);
1475            PacketList writebacks;
1476            writebacks.push_back(wb_pkt);
1477            doWritebacks(writebacks, 0);
1478        }
1479
1480        return false;
1481    }
1482}
1483
1484bool
1485BaseCache::sendWriteQueuePacket(WriteQueueEntry* wq_entry)
1486{
1487    assert(wq_entry);
1488
1489    // always a single target for write queue entries
1490    PacketPtr tgt_pkt = wq_entry->getTarget()->pkt;
1491
1492    DPRINTF(Cache, "%s: write %s\n", __func__, tgt_pkt->print());
1493
1494    // forward as is, both for evictions and uncacheable writes
1495    if (!memSidePort.sendTimingReq(tgt_pkt)) {
1496        // note that we have now masked any requestBus and
1497        // schedSendEvent (we will wait for a retry before
1498        // doing anything), and this is so even if we do not
1499        // care about this packet and might override it before
1500        // it gets retried
1501        return true;
1502    } else {
1503        markInService(wq_entry);
1504        return false;
1505    }
1506}
1507
1508void
1509BaseCache::serialize(CheckpointOut &cp) const
1510{
1511    bool dirty(isDirty());
1512
1513    if (dirty) {
1514        warn("*** The cache still contains dirty data. ***\n");
1515        warn("    Make sure to drain the system using the correct flags.\n");
1516        warn("    This checkpoint will not restore correctly " \
1517             "and dirty data in the cache will be lost!\n");
1518    }
1519
1520    // Since we don't checkpoint the data in the cache, any dirty data
1521    // will be lost when restoring from a checkpoint of a system that
1522    // wasn't drained properly. Flag the checkpoint as invalid if the
1523    // cache contains dirty data.
1524    bool bad_checkpoint(dirty);
1525    SERIALIZE_SCALAR(bad_checkpoint);
1526}
1527
1528void
1529BaseCache::unserialize(CheckpointIn &cp)
1530{
1531    bool bad_checkpoint;
1532    UNSERIALIZE_SCALAR(bad_checkpoint);
1533    if (bad_checkpoint) {
1534        fatal("Restoring from checkpoints with dirty caches is not "
1535              "supported in the classic memory system. Please remove any "
1536              "caches or drain them properly before taking checkpoints.\n");
1537    }
1538}
1539
1540void
1541BaseCache::regStats()
1542{
1543    MemObject::regStats();
1544
1545    using namespace Stats;
1546
1547    // Hit statistics
1548    for (int access_idx = 0; access_idx < MemCmd::NUM_MEM_CMDS; ++access_idx) {
1549        MemCmd cmd(access_idx);
1550        const string &cstr = cmd.toString();
1551
1552        hits[access_idx]
1553            .init(system->maxMasters())
1554            .name(name() + "." + cstr + "_hits")
1555            .desc("number of " + cstr + " hits")
1556            .flags(total | nozero | nonan)
1557            ;
1558        for (int i = 0; i < system->maxMasters(); i++) {
1559            hits[access_idx].subname(i, system->getMasterName(i));
1560        }
1561    }
1562
1563// These macros make it easier to sum the right subset of commands and
1564// to change the subset of commands that are considered "demand" vs
1565// "non-demand"
1566#define SUM_DEMAND(s) \
1567    (s[MemCmd::ReadReq] + s[MemCmd::WriteReq] + s[MemCmd::WriteLineReq] + \
1568     s[MemCmd::ReadExReq] + s[MemCmd::ReadCleanReq] + s[MemCmd::ReadSharedReq])
1569
1570// should writebacks be included here?  prior code was inconsistent...
1571#define SUM_NON_DEMAND(s) \
1572    (s[MemCmd::SoftPFReq] + s[MemCmd::HardPFReq])
1573
1574    demandHits
1575        .name(name() + ".demand_hits")
1576        .desc("number of demand (read+write) hits")
1577        .flags(total | nozero | nonan)
1578        ;
1579    demandHits = SUM_DEMAND(hits);
1580    for (int i = 0; i < system->maxMasters(); i++) {
1581        demandHits.subname(i, system->getMasterName(i));
1582    }
1583
1584    overallHits
1585        .name(name() + ".overall_hits")
1586        .desc("number of overall hits")
1587        .flags(total | nozero | nonan)
1588        ;
1589    overallHits = demandHits + SUM_NON_DEMAND(hits);
1590    for (int i = 0; i < system->maxMasters(); i++) {
1591        overallHits.subname(i, system->getMasterName(i));
1592    }
1593
1594    // Miss statistics
1595    for (int access_idx = 0; access_idx < MemCmd::NUM_MEM_CMDS; ++access_idx) {
1596        MemCmd cmd(access_idx);
1597        const string &cstr = cmd.toString();
1598
1599        misses[access_idx]
1600            .init(system->maxMasters())
1601            .name(name() + "." + cstr + "_misses")
1602            .desc("number of " + cstr + " misses")
1603            .flags(total | nozero | nonan)
1604            ;
1605        for (int i = 0; i < system->maxMasters(); i++) {
1606            misses[access_idx].subname(i, system->getMasterName(i));
1607        }
1608    }
1609
1610    demandMisses
1611        .name(name() + ".demand_misses")
1612        .desc("number of demand (read+write) misses")
1613        .flags(total | nozero | nonan)
1614        ;
1615    demandMisses = SUM_DEMAND(misses);
1616    for (int i = 0; i < system->maxMasters(); i++) {
1617        demandMisses.subname(i, system->getMasterName(i));
1618    }
1619
1620    overallMisses
1621        .name(name() + ".overall_misses")
1622        .desc("number of overall misses")
1623        .flags(total | nozero | nonan)
1624        ;
1625    overallMisses = demandMisses + SUM_NON_DEMAND(misses);
1626    for (int i = 0; i < system->maxMasters(); i++) {
1627        overallMisses.subname(i, system->getMasterName(i));
1628    }
1629
1630    // Miss latency statistics
1631    for (int access_idx = 0; access_idx < MemCmd::NUM_MEM_CMDS; ++access_idx) {
1632        MemCmd cmd(access_idx);
1633        const string &cstr = cmd.toString();
1634
1635        missLatency[access_idx]
1636            .init(system->maxMasters())
1637            .name(name() + "." + cstr + "_miss_latency")
1638            .desc("number of " + cstr + " miss cycles")
1639            .flags(total | nozero | nonan)
1640            ;
1641        for (int i = 0; i < system->maxMasters(); i++) {
1642            missLatency[access_idx].subname(i, system->getMasterName(i));
1643        }
1644    }
1645
1646    demandMissLatency
1647        .name(name() + ".demand_miss_latency")
1648        .desc("number of demand (read+write) miss cycles")
1649        .flags(total | nozero | nonan)
1650        ;
1651    demandMissLatency = SUM_DEMAND(missLatency);
1652    for (int i = 0; i < system->maxMasters(); i++) {
1653        demandMissLatency.subname(i, system->getMasterName(i));
1654    }
1655
1656    overallMissLatency
1657        .name(name() + ".overall_miss_latency")
1658        .desc("number of overall miss cycles")
1659        .flags(total | nozero | nonan)
1660        ;
1661    overallMissLatency = demandMissLatency + SUM_NON_DEMAND(missLatency);
1662    for (int i = 0; i < system->maxMasters(); i++) {
1663        overallMissLatency.subname(i, system->getMasterName(i));
1664    }
1665
1666    // access formulas
1667    for (int access_idx = 0; access_idx < MemCmd::NUM_MEM_CMDS; ++access_idx) {
1668        MemCmd cmd(access_idx);
1669        const string &cstr = cmd.toString();
1670
1671        accesses[access_idx]
1672            .name(name() + "." + cstr + "_accesses")
1673            .desc("number of " + cstr + " accesses(hits+misses)")
1674            .flags(total | nozero | nonan)
1675            ;
1676        accesses[access_idx] = hits[access_idx] + misses[access_idx];
1677
1678        for (int i = 0; i < system->maxMasters(); i++) {
1679            accesses[access_idx].subname(i, system->getMasterName(i));
1680        }
1681    }
1682
1683    demandAccesses
1684        .name(name() + ".demand_accesses")
1685        .desc("number of demand (read+write) accesses")
1686        .flags(total | nozero | nonan)
1687        ;
1688    demandAccesses = demandHits + demandMisses;
1689    for (int i = 0; i < system->maxMasters(); i++) {
1690        demandAccesses.subname(i, system->getMasterName(i));
1691    }
1692
1693    overallAccesses
1694        .name(name() + ".overall_accesses")
1695        .desc("number of overall (read+write) accesses")
1696        .flags(total | nozero | nonan)
1697        ;
1698    overallAccesses = overallHits + overallMisses;
1699    for (int i = 0; i < system->maxMasters(); i++) {
1700        overallAccesses.subname(i, system->getMasterName(i));
1701    }
1702
1703    // miss rate formulas
1704    for (int access_idx = 0; access_idx < MemCmd::NUM_MEM_CMDS; ++access_idx) {
1705        MemCmd cmd(access_idx);
1706        const string &cstr = cmd.toString();
1707
1708        missRate[access_idx]
1709            .name(name() + "." + cstr + "_miss_rate")
1710            .desc("miss rate for " + cstr + " accesses")
1711            .flags(total | nozero | nonan)
1712            ;
1713        missRate[access_idx] = misses[access_idx] / accesses[access_idx];
1714
1715        for (int i = 0; i < system->maxMasters(); i++) {
1716            missRate[access_idx].subname(i, system->getMasterName(i));
1717        }
1718    }
1719
1720    demandMissRate
1721        .name(name() + ".demand_miss_rate")
1722        .desc("miss rate for demand accesses")
1723        .flags(total | nozero | nonan)
1724        ;
1725    demandMissRate = demandMisses / demandAccesses;
1726    for (int i = 0; i < system->maxMasters(); i++) {
1727        demandMissRate.subname(i, system->getMasterName(i));
1728    }
1729
1730    overallMissRate
1731        .name(name() + ".overall_miss_rate")
1732        .desc("miss rate for overall accesses")
1733        .flags(total | nozero | nonan)
1734        ;
1735    overallMissRate = overallMisses / overallAccesses;
1736    for (int i = 0; i < system->maxMasters(); i++) {
1737        overallMissRate.subname(i, system->getMasterName(i));
1738    }
1739
1740    // miss latency formulas
1741    for (int access_idx = 0; access_idx < MemCmd::NUM_MEM_CMDS; ++access_idx) {
1742        MemCmd cmd(access_idx);
1743        const string &cstr = cmd.toString();
1744
1745        avgMissLatency[access_idx]
1746            .name(name() + "." + cstr + "_avg_miss_latency")
1747            .desc("average " + cstr + " miss latency")
1748            .flags(total | nozero | nonan)
1749            ;
1750        avgMissLatency[access_idx] =
1751            missLatency[access_idx] / misses[access_idx];
1752
1753        for (int i = 0; i < system->maxMasters(); i++) {
1754            avgMissLatency[access_idx].subname(i, system->getMasterName(i));
1755        }
1756    }
1757
1758    demandAvgMissLatency
1759        .name(name() + ".demand_avg_miss_latency")
1760        .desc("average overall miss latency")
1761        .flags(total | nozero | nonan)
1762        ;
1763    demandAvgMissLatency = demandMissLatency / demandMisses;
1764    for (int i = 0; i < system->maxMasters(); i++) {
1765        demandAvgMissLatency.subname(i, system->getMasterName(i));
1766    }
1767
1768    overallAvgMissLatency
1769        .name(name() + ".overall_avg_miss_latency")
1770        .desc("average overall miss latency")
1771        .flags(total | nozero | nonan)
1772        ;
1773    overallAvgMissLatency = overallMissLatency / overallMisses;
1774    for (int i = 0; i < system->maxMasters(); i++) {
1775        overallAvgMissLatency.subname(i, system->getMasterName(i));
1776    }
1777
1778    blocked_cycles.init(NUM_BLOCKED_CAUSES);
1779    blocked_cycles
1780        .name(name() + ".blocked_cycles")
1781        .desc("number of cycles access was blocked")
1782        .subname(Blocked_NoMSHRs, "no_mshrs")
1783        .subname(Blocked_NoTargets, "no_targets")
1784        ;
1785
1786
1787    blocked_causes.init(NUM_BLOCKED_CAUSES);
1788    blocked_causes
1789        .name(name() + ".blocked")
1790        .desc("number of cycles access was blocked")
1791        .subname(Blocked_NoMSHRs, "no_mshrs")
1792        .subname(Blocked_NoTargets, "no_targets")
1793        ;
1794
1795    avg_blocked
1796        .name(name() + ".avg_blocked_cycles")
1797        .desc("average number of cycles each access was blocked")
1798        .subname(Blocked_NoMSHRs, "no_mshrs")
1799        .subname(Blocked_NoTargets, "no_targets")
1800        ;
1801
1802    avg_blocked = blocked_cycles / blocked_causes;
1803
1804    unusedPrefetches
1805        .name(name() + ".unused_prefetches")
1806        .desc("number of HardPF blocks evicted w/o reference")
1807        .flags(nozero)
1808        ;
1809
1810    writebacks
1811        .init(system->maxMasters())
1812        .name(name() + ".writebacks")
1813        .desc("number of writebacks")
1814        .flags(total | nozero | nonan)
1815        ;
1816    for (int i = 0; i < system->maxMasters(); i++) {
1817        writebacks.subname(i, system->getMasterName(i));
1818    }
1819
1820    // MSHR statistics
1821    // MSHR hit statistics
1822    for (int access_idx = 0; access_idx < MemCmd::NUM_MEM_CMDS; ++access_idx) {
1823        MemCmd cmd(access_idx);
1824        const string &cstr = cmd.toString();
1825
1826        mshr_hits[access_idx]
1827            .init(system->maxMasters())
1828            .name(name() + "." + cstr + "_mshr_hits")
1829            .desc("number of " + cstr + " MSHR hits")
1830            .flags(total | nozero | nonan)
1831            ;
1832        for (int i = 0; i < system->maxMasters(); i++) {
1833            mshr_hits[access_idx].subname(i, system->getMasterName(i));
1834        }
1835    }
1836
1837    demandMshrHits
1838        .name(name() + ".demand_mshr_hits")
1839        .desc("number of demand (read+write) MSHR hits")
1840        .flags(total | nozero | nonan)
1841        ;
1842    demandMshrHits = SUM_DEMAND(mshr_hits);
1843    for (int i = 0; i < system->maxMasters(); i++) {
1844        demandMshrHits.subname(i, system->getMasterName(i));
1845    }
1846
1847    overallMshrHits
1848        .name(name() + ".overall_mshr_hits")
1849        .desc("number of overall MSHR hits")
1850        .flags(total | nozero | nonan)
1851        ;
1852    overallMshrHits = demandMshrHits + SUM_NON_DEMAND(mshr_hits);
1853    for (int i = 0; i < system->maxMasters(); i++) {
1854        overallMshrHits.subname(i, system->getMasterName(i));
1855    }
1856
1857    // MSHR miss statistics
1858    for (int access_idx = 0; access_idx < MemCmd::NUM_MEM_CMDS; ++access_idx) {
1859        MemCmd cmd(access_idx);
1860        const string &cstr = cmd.toString();
1861
1862        mshr_misses[access_idx]
1863            .init(system->maxMasters())
1864            .name(name() + "." + cstr + "_mshr_misses")
1865            .desc("number of " + cstr + " MSHR misses")
1866            .flags(total | nozero | nonan)
1867            ;
1868        for (int i = 0; i < system->maxMasters(); i++) {
1869            mshr_misses[access_idx].subname(i, system->getMasterName(i));
1870        }
1871    }
1872
1873    demandMshrMisses
1874        .name(name() + ".demand_mshr_misses")
1875        .desc("number of demand (read+write) MSHR misses")
1876        .flags(total | nozero | nonan)
1877        ;
1878    demandMshrMisses = SUM_DEMAND(mshr_misses);
1879    for (int i = 0; i < system->maxMasters(); i++) {
1880        demandMshrMisses.subname(i, system->getMasterName(i));
1881    }
1882
1883    overallMshrMisses
1884        .name(name() + ".overall_mshr_misses")
1885        .desc("number of overall MSHR misses")
1886        .flags(total | nozero | nonan)
1887        ;
1888    overallMshrMisses = demandMshrMisses + SUM_NON_DEMAND(mshr_misses);
1889    for (int i = 0; i < system->maxMasters(); i++) {
1890        overallMshrMisses.subname(i, system->getMasterName(i));
1891    }
1892
1893    // MSHR miss latency statistics
1894    for (int access_idx = 0; access_idx < MemCmd::NUM_MEM_CMDS; ++access_idx) {
1895        MemCmd cmd(access_idx);
1896        const string &cstr = cmd.toString();
1897
1898        mshr_miss_latency[access_idx]
1899            .init(system->maxMasters())
1900            .name(name() + "." + cstr + "_mshr_miss_latency")
1901            .desc("number of " + cstr + " MSHR miss cycles")
1902            .flags(total | nozero | nonan)
1903            ;
1904        for (int i = 0; i < system->maxMasters(); i++) {
1905            mshr_miss_latency[access_idx].subname(i, system->getMasterName(i));
1906        }
1907    }
1908
1909    demandMshrMissLatency
1910        .name(name() + ".demand_mshr_miss_latency")
1911        .desc("number of demand (read+write) MSHR miss cycles")
1912        .flags(total | nozero | nonan)
1913        ;
1914    demandMshrMissLatency = SUM_DEMAND(mshr_miss_latency);
1915    for (int i = 0; i < system->maxMasters(); i++) {
1916        demandMshrMissLatency.subname(i, system->getMasterName(i));
1917    }
1918
1919    overallMshrMissLatency
1920        .name(name() + ".overall_mshr_miss_latency")
1921        .desc("number of overall MSHR miss cycles")
1922        .flags(total | nozero | nonan)
1923        ;
1924    overallMshrMissLatency =
1925        demandMshrMissLatency + SUM_NON_DEMAND(mshr_miss_latency);
1926    for (int i = 0; i < system->maxMasters(); i++) {
1927        overallMshrMissLatency.subname(i, system->getMasterName(i));
1928    }
1929
1930    // MSHR uncacheable statistics
1931    for (int access_idx = 0; access_idx < MemCmd::NUM_MEM_CMDS; ++access_idx) {
1932        MemCmd cmd(access_idx);
1933        const string &cstr = cmd.toString();
1934
1935        mshr_uncacheable[access_idx]
1936            .init(system->maxMasters())
1937            .name(name() + "." + cstr + "_mshr_uncacheable")
1938            .desc("number of " + cstr + " MSHR uncacheable")
1939            .flags(total | nozero | nonan)
1940            ;
1941        for (int i = 0; i < system->maxMasters(); i++) {
1942            mshr_uncacheable[access_idx].subname(i, system->getMasterName(i));
1943        }
1944    }
1945
1946    overallMshrUncacheable
1947        .name(name() + ".overall_mshr_uncacheable_misses")
1948        .desc("number of overall MSHR uncacheable misses")
1949        .flags(total | nozero | nonan)
1950        ;
1951    overallMshrUncacheable =
1952        SUM_DEMAND(mshr_uncacheable) + SUM_NON_DEMAND(mshr_uncacheable);
1953    for (int i = 0; i < system->maxMasters(); i++) {
1954        overallMshrUncacheable.subname(i, system->getMasterName(i));
1955    }
1956
1957    // MSHR miss latency statistics
1958    for (int access_idx = 0; access_idx < MemCmd::NUM_MEM_CMDS; ++access_idx) {
1959        MemCmd cmd(access_idx);
1960        const string &cstr = cmd.toString();
1961
1962        mshr_uncacheable_lat[access_idx]
1963            .init(system->maxMasters())
1964            .name(name() + "." + cstr + "_mshr_uncacheable_latency")
1965            .desc("number of " + cstr + " MSHR uncacheable cycles")
1966            .flags(total | nozero | nonan)
1967            ;
1968        for (int i = 0; i < system->maxMasters(); i++) {
1969            mshr_uncacheable_lat[access_idx].subname(
1970                i, system->getMasterName(i));
1971        }
1972    }
1973
1974    overallMshrUncacheableLatency
1975        .name(name() + ".overall_mshr_uncacheable_latency")
1976        .desc("number of overall MSHR uncacheable cycles")
1977        .flags(total | nozero | nonan)
1978        ;
1979    overallMshrUncacheableLatency =
1980        SUM_DEMAND(mshr_uncacheable_lat) +
1981        SUM_NON_DEMAND(mshr_uncacheable_lat);
1982    for (int i = 0; i < system->maxMasters(); i++) {
1983        overallMshrUncacheableLatency.subname(i, system->getMasterName(i));
1984    }
1985
1986#if 0
1987    // MSHR access formulas
1988    for (int access_idx = 0; access_idx < MemCmd::NUM_MEM_CMDS; ++access_idx) {
1989        MemCmd cmd(access_idx);
1990        const string &cstr = cmd.toString();
1991
1992        mshrAccesses[access_idx]
1993            .name(name() + "." + cstr + "_mshr_accesses")
1994            .desc("number of " + cstr + " mshr accesses(hits+misses)")
1995            .flags(total | nozero | nonan)
1996            ;
1997        mshrAccesses[access_idx] =
1998            mshr_hits[access_idx] + mshr_misses[access_idx]
1999            + mshr_uncacheable[access_idx];
2000    }
2001
2002    demandMshrAccesses
2003        .name(name() + ".demand_mshr_accesses")
2004        .desc("number of demand (read+write) mshr accesses")
2005        .flags(total | nozero | nonan)
2006        ;
2007    demandMshrAccesses = demandMshrHits + demandMshrMisses;
2008
2009    overallMshrAccesses
2010        .name(name() + ".overall_mshr_accesses")
2011        .desc("number of overall (read+write) mshr accesses")
2012        .flags(total | nozero | nonan)
2013        ;
2014    overallMshrAccesses = overallMshrHits + overallMshrMisses
2015        + overallMshrUncacheable;
2016#endif
2017
2018    // MSHR miss rate formulas
2019    for (int access_idx = 0; access_idx < MemCmd::NUM_MEM_CMDS; ++access_idx) {
2020        MemCmd cmd(access_idx);
2021        const string &cstr = cmd.toString();
2022
2023        mshrMissRate[access_idx]
2024            .name(name() + "." + cstr + "_mshr_miss_rate")
2025            .desc("mshr miss rate for " + cstr + " accesses")
2026            .flags(total | nozero | nonan)
2027            ;
2028        mshrMissRate[access_idx] =
2029            mshr_misses[access_idx] / accesses[access_idx];
2030
2031        for (int i = 0; i < system->maxMasters(); i++) {
2032            mshrMissRate[access_idx].subname(i, system->getMasterName(i));
2033        }
2034    }
2035
2036    demandMshrMissRate
2037        .name(name() + ".demand_mshr_miss_rate")
2038        .desc("mshr miss rate for demand accesses")
2039        .flags(total | nozero | nonan)
2040        ;
2041    demandMshrMissRate = demandMshrMisses / demandAccesses;
2042    for (int i = 0; i < system->maxMasters(); i++) {
2043        demandMshrMissRate.subname(i, system->getMasterName(i));
2044    }
2045
2046    overallMshrMissRate
2047        .name(name() + ".overall_mshr_miss_rate")
2048        .desc("mshr miss rate for overall accesses")
2049        .flags(total | nozero | nonan)
2050        ;
2051    overallMshrMissRate = overallMshrMisses / overallAccesses;
2052    for (int i = 0; i < system->maxMasters(); i++) {
2053        overallMshrMissRate.subname(i, system->getMasterName(i));
2054    }
2055
2056    // mshrMiss latency formulas
2057    for (int access_idx = 0; access_idx < MemCmd::NUM_MEM_CMDS; ++access_idx) {
2058        MemCmd cmd(access_idx);
2059        const string &cstr = cmd.toString();
2060
2061        avgMshrMissLatency[access_idx]
2062            .name(name() + "." + cstr + "_avg_mshr_miss_latency")
2063            .desc("average " + cstr + " mshr miss latency")
2064            .flags(total | nozero | nonan)
2065            ;
2066        avgMshrMissLatency[access_idx] =
2067            mshr_miss_latency[access_idx] / mshr_misses[access_idx];
2068
2069        for (int i = 0; i < system->maxMasters(); i++) {
2070            avgMshrMissLatency[access_idx].subname(
2071                i, system->getMasterName(i));
2072        }
2073    }
2074
2075    demandAvgMshrMissLatency
2076        .name(name() + ".demand_avg_mshr_miss_latency")
2077        .desc("average overall mshr miss latency")
2078        .flags(total | nozero | nonan)
2079        ;
2080    demandAvgMshrMissLatency = demandMshrMissLatency / demandMshrMisses;
2081    for (int i = 0; i < system->maxMasters(); i++) {
2082        demandAvgMshrMissLatency.subname(i, system->getMasterName(i));
2083    }
2084
2085    overallAvgMshrMissLatency
2086        .name(name() + ".overall_avg_mshr_miss_latency")
2087        .desc("average overall mshr miss latency")
2088        .flags(total | nozero | nonan)
2089        ;
2090    overallAvgMshrMissLatency = overallMshrMissLatency / overallMshrMisses;
2091    for (int i = 0; i < system->maxMasters(); i++) {
2092        overallAvgMshrMissLatency.subname(i, system->getMasterName(i));
2093    }
2094
2095    // mshrUncacheable latency formulas
2096    for (int access_idx = 0; access_idx < MemCmd::NUM_MEM_CMDS; ++access_idx) {
2097        MemCmd cmd(access_idx);
2098        const string &cstr = cmd.toString();
2099
2100        avgMshrUncacheableLatency[access_idx]
2101            .name(name() + "." + cstr + "_avg_mshr_uncacheable_latency")
2102            .desc("average " + cstr + " mshr uncacheable latency")
2103            .flags(total | nozero | nonan)
2104            ;
2105        avgMshrUncacheableLatency[access_idx] =
2106            mshr_uncacheable_lat[access_idx] / mshr_uncacheable[access_idx];
2107
2108        for (int i = 0; i < system->maxMasters(); i++) {
2109            avgMshrUncacheableLatency[access_idx].subname(
2110                i, system->getMasterName(i));
2111        }
2112    }
2113
2114    overallAvgMshrUncacheableLatency
2115        .name(name() + ".overall_avg_mshr_uncacheable_latency")
2116        .desc("average overall mshr uncacheable latency")
2117        .flags(total | nozero | nonan)
2118        ;
2119    overallAvgMshrUncacheableLatency =
2120        overallMshrUncacheableLatency / overallMshrUncacheable;
2121    for (int i = 0; i < system->maxMasters(); i++) {
2122        overallAvgMshrUncacheableLatency.subname(i, system->getMasterName(i));
2123    }
2124
2125    replacements
2126        .name(name() + ".replacements")
2127        .desc("number of replacements")
2128        ;
2129}
2130
2131///////////////
2132//
2133// CpuSidePort
2134//
2135///////////////
2136bool
2137BaseCache::CpuSidePort::recvTimingSnoopResp(PacketPtr pkt)
2138{
2139    // Snoops shouldn't happen when bypassing caches
2140    assert(!cache->system->bypassCaches());
2141
2142    assert(pkt->isResponse());
2143
2144    // Express snoop responses from master to slave, e.g., from L1 to L2
2145    cache->recvTimingSnoopResp(pkt);
2146    return true;
2147}
2148
2149
2150bool
2151BaseCache::CpuSidePort::tryTiming(PacketPtr pkt)
2152{
2153    if (cache->system->bypassCaches() || pkt->isExpressSnoop()) {
2154        // always let express snoop packets through even if blocked
2155        return true;
2156    } else if (blocked || mustSendRetry) {
2157        // either already committed to send a retry, or blocked
2158        mustSendRetry = true;
2159        return false;
2160    }
2161    mustSendRetry = false;
2162    return true;
2163}
2164
2165bool
2166BaseCache::CpuSidePort::recvTimingReq(PacketPtr pkt)
2167{
2168    assert(pkt->isRequest());
2169
2170    if (cache->system->bypassCaches()) {
2171        // Just forward the packet if caches are disabled.
2172        // @todo This should really enqueue the packet rather
2173        bool M5_VAR_USED success = cache->memSidePort.sendTimingReq(pkt);
2174        assert(success);
2175        return true;
2176    } else if (tryTiming(pkt)) {
2177        cache->recvTimingReq(pkt);
2178        return true;
2179    }
2180    return false;
2181}
2182
2183Tick
2184BaseCache::CpuSidePort::recvAtomic(PacketPtr pkt)
2185{
2186    if (cache->system->bypassCaches()) {
2187        // Forward the request if the system is in cache bypass mode.
2188        return cache->memSidePort.sendAtomic(pkt);
2189    } else {
2190        return cache->recvAtomic(pkt);
2191    }
2192}
2193
2194void
2195BaseCache::CpuSidePort::recvFunctional(PacketPtr pkt)
2196{
2197    if (cache->system->bypassCaches()) {
2198        // The cache should be flushed if we are in cache bypass mode,
2199        // so we don't need to check if we need to update anything.
2200        cache->memSidePort.sendFunctional(pkt);
2201        return;
2202    }
2203
2204    // functional request
2205    cache->functionalAccess(pkt, true);
2206}
2207
2208AddrRangeList
2209BaseCache::CpuSidePort::getAddrRanges() const
2210{
2211    return cache->getAddrRanges();
2212}
2213
2214
2215BaseCache::
2216CpuSidePort::CpuSidePort(const std::string &_name, BaseCache *_cache,
2217                         const std::string &_label)
2218    : CacheSlavePort(_name, _cache, _label), cache(_cache)
2219{
2220}
2221
2222///////////////
2223//
2224// MemSidePort
2225//
2226///////////////
2227bool
2228BaseCache::MemSidePort::recvTimingResp(PacketPtr pkt)
2229{
2230    cache->recvTimingResp(pkt);
2231    return true;
2232}
2233
2234// Express snooping requests to memside port
2235void
2236BaseCache::MemSidePort::recvTimingSnoopReq(PacketPtr pkt)
2237{
2238    // Snoops shouldn't happen when bypassing caches
2239    assert(!cache->system->bypassCaches());
2240
2241    // handle snooping requests
2242    cache->recvTimingSnoopReq(pkt);
2243}
2244
2245Tick
2246BaseCache::MemSidePort::recvAtomicSnoop(PacketPtr pkt)
2247{
2248    // Snoops shouldn't happen when bypassing caches
2249    assert(!cache->system->bypassCaches());
2250
2251    return cache->recvAtomicSnoop(pkt);
2252}
2253
2254void
2255BaseCache::MemSidePort::recvFunctionalSnoop(PacketPtr pkt)
2256{
2257    // Snoops shouldn't happen when bypassing caches
2258    assert(!cache->system->bypassCaches());
2259
2260    // functional snoop (note that in contrast to atomic we don't have
2261    // a specific functionalSnoop method, as they have the same
2262    // behaviour regardless)
2263    cache->functionalAccess(pkt, false);
2264}
2265
2266void
2267BaseCache::CacheReqPacketQueue::sendDeferredPacket()
2268{
2269    // sanity check
2270    assert(!waitingOnRetry);
2271
2272    // there should never be any deferred request packets in the
2273    // queue, instead we resly on the cache to provide the packets
2274    // from the MSHR queue or write queue
2275    assert(deferredPacketReadyTime() == MaxTick);
2276
2277    // check for request packets (requests & writebacks)
2278    QueueEntry* entry = cache.getNextQueueEntry();
2279
2280    if (!entry) {
2281        // can happen if e.g. we attempt a writeback and fail, but
2282        // before the retry, the writeback is eliminated because
2283        // we snoop another cache's ReadEx.
2284    } else {
2285        // let our snoop responses go first if there are responses to
2286        // the same addresses
2287        if (checkConflictingSnoop(entry->blkAddr)) {
2288            return;
2289        }
2290        waitingOnRetry = entry->sendPacket(cache);
2291    }
2292
2293    // if we succeeded and are not waiting for a retry, schedule the
2294    // next send considering when the next queue is ready, note that
2295    // snoop responses have their own packet queue and thus schedule
2296    // their own events
2297    if (!waitingOnRetry) {
2298        schedSendEvent(cache.nextQueueReadyTime());
2299    }
2300}
2301
2302BaseCache::MemSidePort::MemSidePort(const std::string &_name,
2303                                    BaseCache *_cache,
2304                                    const std::string &_label)
2305    : CacheMasterPort(_name, _cache, _reqQueue, _snoopRespQueue),
2306      _reqQueue(*_cache, *this, _snoopRespQueue, _label),
2307      _snoopRespQueue(*_cache, *this, _label), cache(_cache)
2308{
2309}
2310