measurements.cpp
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2014-2017, 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 "measurements.hpp"
27 #include "name-tree.hpp"
28 #include "pit-entry.hpp"
29 #include "fib-entry.hpp"
30 
31 namespace nfd {
32 namespace measurements {
33 
34 Measurements::Measurements(NameTree& nameTree)
35  : m_nameTree(nameTree)
36  , m_nItems(0)
37 {
38 }
39 
40 Entry&
42 {
43  BOOST_ASSERT(nte.getName().size() <= NameTree::getMaxDepth());
44 
45  Entry* entry = nte.getMeasurementsEntry();
46  if (entry != nullptr) {
47  return *entry;
48  }
49 
50  nte.setMeasurementsEntry(make_unique<Entry>(nte.getName()));
51  ++m_nItems;
52  entry = nte.getMeasurementsEntry();
53 
54  entry->m_expiry = time::steady_clock::now() + getInitialLifetime();
55  entry->m_cleanup = scheduler::schedule(getInitialLifetime(),
56  bind(&Measurements::cleanup, this, ref(*entry)));
57 
58  return *entry;
59 }
60 
61 Entry&
62 Measurements::get(const Name& name)
63 {
64  name_tree::Entry& nte = m_nameTree.lookup(name, true);
65  return this->get(nte);
66 }
67 
68 Entry&
69 Measurements::get(const fib::Entry& fibEntry)
70 {
71  name_tree::Entry& nte = m_nameTree.lookup(fibEntry.getPrefix(), true);
72  return this->get(nte);
73 }
74 
75 Entry&
76 Measurements::get(const pit::Entry& pitEntry)
77 {
78  name_tree::Entry& nte = m_nameTree.lookup(pitEntry.getName(), true);
79  return this->get(nte);
80 }
81 
82 Entry*
84 {
85  if (child.getName().empty()) { // the root entry
86  return nullptr;
87  }
88 
89  name_tree::Entry* nteChild = m_nameTree.getEntry(child);
90  name_tree::Entry* nte = nteChild->getParent();
91  BOOST_ASSERT(nte != nullptr);
92  return &this->get(*nte);
93 }
94 
95 template<typename K>
96 Entry*
97 Measurements::findLongestPrefixMatchImpl(const K& key, const EntryPredicate& pred) const
98 {
99  name_tree::Entry* match = m_nameTree.findLongestPrefixMatch(key,
100  [&pred] (const name_tree::Entry& nte) {
101  const Entry* entry = nte.getMeasurementsEntry();
102  return entry != nullptr && pred(*entry);
103  });
104  if (match != nullptr) {
105  return match->getMeasurementsEntry();
106  }
107  return nullptr;
108 }
109 
110 Entry*
111 Measurements::findLongestPrefixMatch(const Name& name, const EntryPredicate& pred) const
112 {
113  return this->findLongestPrefixMatchImpl(name.getPrefix(NameTree::getMaxDepth()), pred);
114 }
115 
116 Entry*
118 {
119  return this->findLongestPrefixMatch(pitEntry.getName(), pred);
120 }
121 
122 Entry*
123 Measurements::findExactMatch(const Name& name) const
124 {
125  const name_tree::Entry* nte = m_nameTree.findExactMatch(name);
126  return nte == nullptr ? nullptr : nte->getMeasurementsEntry();
127 }
128 
129 void
130 Measurements::extendLifetime(Entry& entry, const time::nanoseconds& lifetime)
131 {
132  BOOST_ASSERT(m_nameTree.getEntry(entry) != nullptr);
133 
134  time::steady_clock::TimePoint expiry = time::steady_clock::now() + lifetime;
135  if (entry.m_expiry >= expiry) {
136  // has longer lifetime, not extending
137  return;
138  }
139 
140  scheduler::cancel(entry.m_cleanup);
141  entry.m_expiry = expiry;
142  entry.m_cleanup = scheduler::schedule(lifetime, bind(&Measurements::cleanup, this, ref(entry)));
143 }
144 
145 void
146 Measurements::cleanup(Entry& entry)
147 {
148  name_tree::Entry* nte = m_nameTree.getEntry(entry);
149  BOOST_ASSERT(nte != nullptr);
150 
151  nte->setMeasurementsEntry(nullptr);
152  m_nameTree.eraseIfEmpty(nte);
153  --m_nItems;
154 }
155 
156 } // namespace measurements
157 } // namespace nfd
const Name & getName() const
Entry & get(const Name &name)
find or insert a Measurements entry for name
represents a Measurements entry
void cancel(const EventId &eventId)
cancel a scheduled event
Definition: scheduler.cpp:53
void setMeasurementsEntry(unique_ptr< measurements::Entry > measurementsEntry)
represents a FIB entry
Definition: fib-entry.hpp:51
Entry * findLongestPrefixMatch(const Name &name, const EntryPredicate &pred=AnyEntry()) const
perform a longest prefix match for name
std::function< bool(const Entry &)> EntryPredicate
a predicate that accepts or rejects an entry
Entry * findExactMatch(const Name &name) const
perform an exact match
Entry * getParent(const Entry &child)
find or insert a Measurements entry for child&#39;s parent
Entry * getParent() const
an Interest table entry
Definition: pit-entry.hpp:57
static time::nanoseconds getInitialLifetime()
const Name & getPrefix() const
Definition: fib-entry.hpp:58
Copyright (c) 2014-2015, Regents of the University of California, Arizona Board of Regents...
Definition: algorithm.hpp:32
Measurements(NameTree &nametree)
an entry in the name tree
measurements::Entry * getMeasurementsEntry() const
EventId schedule(time::nanoseconds after, const EventCallback &event)
schedule an event
Definition: scheduler.cpp:47
const Name & getName() const
const Name & getName() const
Definition: pit-entry.hpp:77
void extendLifetime(Entry &entry, const time::nanoseconds &lifetime)
extend lifetime of an entry