cs-policy-lru.cpp
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2014-2022, Regents of the University of California,
4  * Arizona Board of Regents,
5  * Colorado State University,
6  * University Pierre & Marie Curie, Sorbonne University,
7  * Washington University in St. Louis,
8  * Beijing Institute of Technology,
9  * The University of Memphis.
10  *
11  * This file is part of NFD (Named Data Networking Forwarding Daemon).
12  * See AUTHORS.md for complete list of NFD authors and contributors.
13  *
14  * NFD is free software: you can redistribute it and/or modify it under the terms
15  * of the GNU General Public License as published by the Free Software Foundation,
16  * either version 3 of the License, or (at your option) any later version.
17  *
18  * NFD is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
19  * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
20  * PURPOSE. See the GNU General Public License for more details.
21  *
22  * You should have received a copy of the GNU General Public License along with
23  * NFD, e.g., in COPYING.md file. If not, see <http://www.gnu.org/licenses/>.
24  */
25 
26 #include "cs-policy-lru.hpp"
27 #include "cs.hpp"
28 
29 namespace nfd::cs::lru {
30 
31 const std::string LruPolicy::POLICY_NAME = "lru";
33 
35  : Policy(POLICY_NAME)
36 {
37 }
38 
39 void
40 LruPolicy::doAfterInsert(EntryRef i)
41 {
42  this->insertToQueue(i, true);
43  this->evictEntries();
44 }
45 
46 void
47 LruPolicy::doAfterRefresh(EntryRef i)
48 {
49  this->insertToQueue(i, false);
50 }
51 
52 void
53 LruPolicy::doBeforeErase(EntryRef i)
54 {
55  m_queue.get<1>().erase(i);
56 }
57 
58 void
59 LruPolicy::doBeforeUse(EntryRef i)
60 {
61  this->insertToQueue(i, false);
62 }
63 
64 void
65 LruPolicy::evictEntries()
66 {
67  BOOST_ASSERT(this->getCs() != nullptr);
68  while (this->getCs()->size() > this->getLimit()) {
69  BOOST_ASSERT(!m_queue.empty());
70  EntryRef i = m_queue.front();
71  m_queue.pop_front();
72  emitSignal(beforeEvict, i);
73  }
74 }
75 
76 void
77 LruPolicy::insertToQueue(EntryRef i, bool isNewEntry)
78 {
79  // push_back only if i does not exist
80  auto [it, isNew] = m_queue.push_back(i);
81 
82  BOOST_ASSERT(isNew == isNewEntry);
83  if (!isNewEntry) {
84  m_queue.relocate(m_queue.end(), it);
85  }
86 }
87 
88 } // namespace nfd::cs::lru
Represents a CS replacement policy.
Definition: cs-policy.hpp:39
Cs * getCs() const noexcept
Returns a pointer to the associated CS instance.
Definition: cs-policy.hpp:77
Table::const_iterator EntryRef
A reference to a CS entry.
Definition: cs-policy.hpp:113
size_t getLimit() const noexcept
Gets hard limit (in number of entries).
Definition: cs-policy.hpp:95
signal::Signal< Policy, EntryRef > beforeEvict
Signal emitted when an entry is being evicted.
Definition: cs-policy.hpp:120
Least-Recently-Used (LRU) replacement policy.
static const std::string POLICY_NAME
#define NFD_REGISTER_CS_POLICY(P)
Registers a CS policy.
Definition: cs-policy.hpp:218