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-2023, 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 
32 
34  : Policy(POLICY_NAME)
35 {
36 }
37 
38 void
39 LruPolicy::doAfterInsert(EntryRef i)
40 {
41  this->insertToQueue(i, true);
42  this->evictEntries();
43 }
44 
45 void
46 LruPolicy::doAfterRefresh(EntryRef i)
47 {
48  this->insertToQueue(i, false);
49 }
50 
51 void
52 LruPolicy::doBeforeErase(EntryRef i)
53 {
54  m_queue.get<1>().erase(i);
55 }
56 
57 void
58 LruPolicy::doBeforeUse(EntryRef i)
59 {
60  this->insertToQueue(i, false);
61 }
62 
63 void
64 LruPolicy::evictEntries()
65 {
66  BOOST_ASSERT(this->getCs() != nullptr);
67  while (this->getCs()->size() > this->getLimit()) {
68  BOOST_ASSERT(!m_queue.empty());
69  EntryRef i = m_queue.front();
70  m_queue.pop_front();
71  emitSignal(beforeEvict, i);
72  }
73 }
74 
75 void
76 LruPolicy::insertToQueue(EntryRef i, bool isNewEntry)
77 {
78  // push_back only if i does not exist
79  auto [it, isNew] = m_queue.push_back(i);
80 
81  BOOST_ASSERT(isNew == isNewEntry);
82  if (!isNewEntry) {
83  m_queue.relocate(m_queue.end(), it);
84  }
85 }
86 
87 } // namespace nfd::cs::lru
Represents a CS replacement policy.
Definition: cs-policy.hpp:43
Cs * getCs() const noexcept
Returns a pointer to the associated CS instance.
Definition: cs-policy.hpp:81
Table::const_iterator EntryRef
A reference to a CS entry.
Definition: cs-policy.hpp:117
size_t getLimit() const noexcept
Gets hard limit (in number of entries).
Definition: cs-policy.hpp:99
signal::Signal< Policy, EntryRef > beforeEvict
Signal emitted when an entry is being evicted.
Definition: cs-policy.hpp:124
Least-Recently-Used (LRU) replacement policy.
#define NFD_REGISTER_CS_POLICY(P)
Registers a CS policy.
Definition: cs-policy.hpp:222