base.hh revision 13225
112600Sodanrc@yahoo.com.br/** 212600Sodanrc@yahoo.com.br * Copyright (c) 2018 Inria 312600Sodanrc@yahoo.com.br * All rights reserved. 412600Sodanrc@yahoo.com.br * 512600Sodanrc@yahoo.com.br * Redistribution and use in source and binary forms, with or without 612600Sodanrc@yahoo.com.br * modification, are permitted provided that the following conditions are 712600Sodanrc@yahoo.com.br * met: redistributions of source code must retain the above copyright 812600Sodanrc@yahoo.com.br * notice, this list of conditions and the following disclaimer; 912600Sodanrc@yahoo.com.br * redistributions in binary form must reproduce the above copyright 1012600Sodanrc@yahoo.com.br * notice, this list of conditions and the following disclaimer in the 1112600Sodanrc@yahoo.com.br * documentation and/or other materials provided with the distribution; 1212600Sodanrc@yahoo.com.br * neither the name of the copyright holders nor the names of its 1312600Sodanrc@yahoo.com.br * contributors may be used to endorse or promote products derived from 1412600Sodanrc@yahoo.com.br * this software without specific prior written permission. 1512600Sodanrc@yahoo.com.br * 1612600Sodanrc@yahoo.com.br * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 1712600Sodanrc@yahoo.com.br * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 1812600Sodanrc@yahoo.com.br * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 1912600Sodanrc@yahoo.com.br * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 2012600Sodanrc@yahoo.com.br * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 2112600Sodanrc@yahoo.com.br * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 2212600Sodanrc@yahoo.com.br * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 2312600Sodanrc@yahoo.com.br * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 2412600Sodanrc@yahoo.com.br * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 2512600Sodanrc@yahoo.com.br * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 2612600Sodanrc@yahoo.com.br * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 2712600Sodanrc@yahoo.com.br * 2812600Sodanrc@yahoo.com.br * Authors: Daniel Carvalho 2912600Sodanrc@yahoo.com.br */ 3012600Sodanrc@yahoo.com.br 3112600Sodanrc@yahoo.com.br#ifndef __MEM_CACHE_REPLACEMENT_POLICIES_BASE_HH__ 3212600Sodanrc@yahoo.com.br#define __MEM_CACHE_REPLACEMENT_POLICIES_BASE_HH__ 3312600Sodanrc@yahoo.com.br 3412684Sodanrc@yahoo.com.br#include <memory> 3512684Sodanrc@yahoo.com.br 3613225Sodanrc@yahoo.com.br#include "mem/cache/replacement_policies/replaceable_entry.hh" 3712600Sodanrc@yahoo.com.br#include "params/BaseReplacementPolicy.hh" 3812600Sodanrc@yahoo.com.br#include "sim/sim_object.hh" 3912600Sodanrc@yahoo.com.br 4012600Sodanrc@yahoo.com.br/** 4112600Sodanrc@yahoo.com.br * Replacement candidates as chosen by the indexing policy. 4212600Sodanrc@yahoo.com.br */ 4312684Sodanrc@yahoo.com.brtypedef std::vector<ReplaceableEntry*> ReplacementCandidates; 4412600Sodanrc@yahoo.com.br 4512600Sodanrc@yahoo.com.br/** 4612600Sodanrc@yahoo.com.br * A common base class of cache replacement policy objects. 4712600Sodanrc@yahoo.com.br */ 4812600Sodanrc@yahoo.com.brclass BaseReplacementPolicy : public SimObject 4912600Sodanrc@yahoo.com.br{ 5012600Sodanrc@yahoo.com.br public: 5112600Sodanrc@yahoo.com.br /** 5212600Sodanrc@yahoo.com.br * Convenience typedef. 5312600Sodanrc@yahoo.com.br */ 5412600Sodanrc@yahoo.com.br typedef BaseReplacementPolicyParams Params; 5512600Sodanrc@yahoo.com.br 5612600Sodanrc@yahoo.com.br /** 5712600Sodanrc@yahoo.com.br * Construct and initiliaze this replacement policy. 5812600Sodanrc@yahoo.com.br */ 5912684Sodanrc@yahoo.com.br BaseReplacementPolicy(const Params *p) : SimObject(p) {} 6012600Sodanrc@yahoo.com.br 6112600Sodanrc@yahoo.com.br /** 6212600Sodanrc@yahoo.com.br * Destructor. 6312600Sodanrc@yahoo.com.br */ 6412600Sodanrc@yahoo.com.br virtual ~BaseReplacementPolicy() {} 6512600Sodanrc@yahoo.com.br 6612600Sodanrc@yahoo.com.br /** 6712684Sodanrc@yahoo.com.br * Invalidate replacement data to set it as the next probable victim. 6812600Sodanrc@yahoo.com.br * 6912684Sodanrc@yahoo.com.br * @param replacement_data Replacement data to be invalidated. 7012600Sodanrc@yahoo.com.br */ 7112684Sodanrc@yahoo.com.br virtual void invalidate(const std::shared_ptr<ReplacementData>& 7212684Sodanrc@yahoo.com.br replacement_data) const = 0; 7312600Sodanrc@yahoo.com.br 7412600Sodanrc@yahoo.com.br /** 7512684Sodanrc@yahoo.com.br * Update replacement data. 7612600Sodanrc@yahoo.com.br * 7712684Sodanrc@yahoo.com.br * @param replacement_data Replacement data to be touched. 7812684Sodanrc@yahoo.com.br */ 7912684Sodanrc@yahoo.com.br virtual void touch(const std::shared_ptr<ReplacementData>& 8012684Sodanrc@yahoo.com.br replacement_data) const = 0; 8112684Sodanrc@yahoo.com.br 8212684Sodanrc@yahoo.com.br /** 8312684Sodanrc@yahoo.com.br * Reset replacement data. Used when it's holder is inserted/validated. 8412600Sodanrc@yahoo.com.br * 8512684Sodanrc@yahoo.com.br * @param replacement_data Replacement data to be reset. 8612600Sodanrc@yahoo.com.br */ 8712684Sodanrc@yahoo.com.br virtual void reset(const std::shared_ptr<ReplacementData>& 8812684Sodanrc@yahoo.com.br replacement_data) const = 0; 8912600Sodanrc@yahoo.com.br 9012600Sodanrc@yahoo.com.br /** 9112600Sodanrc@yahoo.com.br * Find replacement victim among candidates. 9212600Sodanrc@yahoo.com.br * 9312600Sodanrc@yahoo.com.br * @param candidates Replacement candidates, selected by indexing policy. 9412684Sodanrc@yahoo.com.br * @return Replacement entry to be replaced. 9512600Sodanrc@yahoo.com.br */ 9612684Sodanrc@yahoo.com.br virtual ReplaceableEntry* getVictim( 9712684Sodanrc@yahoo.com.br const ReplacementCandidates& candidates) const = 0; 9812684Sodanrc@yahoo.com.br 9912684Sodanrc@yahoo.com.br /** 10012684Sodanrc@yahoo.com.br * Instantiate a replacement data entry. 10112684Sodanrc@yahoo.com.br * 10212684Sodanrc@yahoo.com.br * @return A shared pointer to the new replacement data. 10312684Sodanrc@yahoo.com.br */ 10412684Sodanrc@yahoo.com.br virtual std::shared_ptr<ReplacementData> instantiateEntry() = 0; 10512600Sodanrc@yahoo.com.br}; 10612600Sodanrc@yahoo.com.br 10712600Sodanrc@yahoo.com.br#endif // __MEM_CACHE_REPLACEMENT_POLICIES_BASE_HH__ 108