NS-3 based Named Data Networking (NDN) simulator
ndnSIM 2.5: NDN, CCN, CCNx, content centric networks
API Documentation
best-route-strategy2.cpp
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2014-2019, 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 "best-route-strategy2.hpp"
27 #include "algorithm.hpp"
28 #include "common/logger.hpp"
29 
30 namespace nfd {
31 namespace fw {
32 
35 
36 const time::milliseconds BestRouteStrategy2::RETX_SUPPRESSION_INITIAL(10);
37 const time::milliseconds BestRouteStrategy2::RETX_SUPPRESSION_MAX(250);
38 
40  : Strategy(forwarder)
41  , ProcessNackTraits(this)
42  , m_retxSuppression(RETX_SUPPRESSION_INITIAL,
43  RetxSuppressionExponential::DEFAULT_MULTIPLIER,
44  RETX_SUPPRESSION_MAX)
45 {
47  if (!parsed.parameters.empty()) {
48  NDN_THROW(std::invalid_argument("BestRouteStrategy2 does not accept parameters"));
49  }
50  if (parsed.version && *parsed.version != getStrategyName()[-1].toVersion()) {
51  NDN_THROW(std::invalid_argument(
52  "BestRouteStrategy2 does not support version " + to_string(*parsed.version)));
53  }
55 }
56 
57 const Name&
59 {
60  static Name strategyName("/localhost/nfd/strategy/best-route/%FD%05");
61  return strategyName;
62 }
63 
64 void
66  const shared_ptr<pit::Entry>& pitEntry)
67 {
68  RetxSuppressionResult suppression = m_retxSuppression.decidePerPitEntry(*pitEntry);
69  if (suppression == RetxSuppressionResult::SUPPRESS) {
70  NFD_LOG_DEBUG(interest << " from=" << ingress << " suppressed");
71  return;
72  }
73 
74  const fib::Entry& fibEntry = this->lookupFib(*pitEntry);
75  const fib::NextHopList& nexthops = fibEntry.getNextHops();
76  auto it = nexthops.end();
77 
78  if (suppression == RetxSuppressionResult::NEW) {
79  // forward to nexthop with lowest cost except downstream
80  it = std::find_if(nexthops.begin(), nexthops.end(), [&] (const auto& nexthop) {
81  return isNextHopEligible(ingress.face, interest, nexthop, pitEntry);
82  });
83 
84  if (it == nexthops.end()) {
85  NFD_LOG_DEBUG(interest << " from=" << ingress << " noNextHop");
86 
87  lp::NackHeader nackHeader;
88  nackHeader.setReason(lp::NackReason::NO_ROUTE);
89  this->sendNack(pitEntry, ingress, nackHeader);
90 
91  this->rejectPendingInterest(pitEntry);
92  return;
93  }
94 
95  auto egress = FaceEndpoint(it->getFace(), 0);
96  NFD_LOG_DEBUG(interest << " from=" << ingress << " newPitEntry-to=" << egress);
97  this->sendInterest(pitEntry, egress, interest);
98  return;
99  }
100 
101  // find an unused upstream with lowest cost except downstream
102  it = std::find_if(nexthops.begin(), nexthops.end(), [&] (const auto& nexthop) {
103  return isNextHopEligible(ingress.face, interest, nexthop, pitEntry, true, time::steady_clock::now());
104  });
105 
106  if (it != nexthops.end()) {
107  auto egress = FaceEndpoint(it->getFace(), 0);
108  this->sendInterest(pitEntry, egress, interest);
109  NFD_LOG_DEBUG(interest << " from=" << ingress << " retransmit-unused-to=" << egress);
110  return;
111  }
112 
113  // find an eligible upstream that is used earliest
114  it = findEligibleNextHopWithEarliestOutRecord(ingress.face, interest, nexthops, pitEntry);
115  if (it == nexthops.end()) {
116  NFD_LOG_DEBUG(interest << " from=" << ingress << " retransmitNoNextHop");
117  }
118  else {
119  auto egress = FaceEndpoint(it->getFace(), 0);
120  this->sendInterest(pitEntry, egress, interest);
121  NFD_LOG_DEBUG(interest << " from=" << ingress << " retransmit-retry-to=" << egress);
122  }
123 }
124 
125 void
127  const shared_ptr<pit::Entry>& pitEntry)
128 {
129  this->processNack(ingress.face, nack, pitEntry);
130 }
131 
132 } // namespace fw
133 } // namespace nfd
nfd::FaceEndpoint::face
Face & face
Definition: face-endpoint.hpp:46
nfd::fw::BestRouteStrategy2::getStrategyName
static const Name & getStrategyName()
Definition: best-route-strategy2.cpp:58
ndn::lp::NackHeader::setReason
NackHeader & setReason(NackReason reason)
set reason code
Definition: nack-header.cpp:135
ndn::lp::NackHeader
represents a Network NACK header
Definition: nack-header.hpp:58
nfd::fw::Strategy::sendInterest
void sendInterest(const shared_ptr< pit::Entry > &pitEntry, const FaceEndpoint &egress, const Interest &interest)
send Interest to egress
Definition: strategy.cpp:206
nfd::fw::NFD_REGISTER_STRATEGY
NFD_REGISTER_STRATEGY(AccessStrategy)
nfd::fw::ProcessNackTraits
Definition: process-nack-traits.hpp:71
nfd::fw::RetxSuppressionResult
RetxSuppressionResult
Definition: retx-suppression.hpp:34
nfd::fw::RetxSuppressionExponential
a retransmission suppression decision algorithm that suppresses retransmissions using exponential bac...
Definition: retx-suppression-exponential.hpp:42
ndn::Name
Represents an absolute name.
Definition: name.hpp:44
best-route-strategy2.hpp
nfd
Copyright (c) 2011-2015 Regents of the University of California.
Definition: ndn-common.hpp:40
nfd::fw::RetxSuppressionExponential::decidePerPitEntry
RetxSuppressionResult decidePerPitEntry(pit::Entry &pitEntry)
determines whether Interest is a retransmission per pit entry and if so, whether it shall be forwarde...
Definition: retx-suppression-exponential.cpp:70
nfd::fw::Strategy::setInstanceName
void setInstanceName(const Name &name)
set strategy instance name
Definition: strategy.hpp:395
NDN_THROW
#define NDN_THROW(e)
Definition: exception.hpp:61
nfd::fw::Strategy::sendNack
void sendNack(const shared_ptr< pit::Entry > &pitEntry, const FaceEndpoint &egress, const lp::NackHeader &header)
send Nack to egress
Definition: strategy.hpp:315
nfd::fib::Entry::getNextHops
const NextHopList & getNextHops() const
Definition: fib-entry.hpp:66
nfd::FaceEndpoint
Represents a face-endpoint pair in the forwarder.
Definition: face-endpoint.hpp:37
nfd::fw::BestRouteStrategy2::BestRouteStrategy2
BestRouteStrategy2(Forwarder &forwarder, const Name &name=getStrategyName())
Definition: best-route-strategy2.cpp:39
nfd::fw::Strategy::lookupFib
const fib::Entry & lookupFib(const pit::Entry &pitEntry) const
performs a FIB lookup, considering Link object if present
Definition: strategy.cpp:297
ndn::Interest
Represents an Interest packet.
Definition: interest.hpp:44
nfd::fw::Strategy::parseInstanceName
static ParsedInstanceName parseInstanceName(const Name &input)
parse a strategy instance name
Definition: strategy.cpp:123
nfd::fw::Strategy::rejectPendingInterest
void rejectPendingInterest(const shared_ptr< pit::Entry > &pitEntry)
schedule the PIT entry for immediate deletion
Definition: strategy.hpp:302
nfd::fib::NextHopList
std::vector< NextHop > NextHopList
Definition: fib-entry.hpp:49
nfd::fib::Entry
represents a FIB entry
Definition: fib-entry.hpp:54
nfd::fw::Strategy
represents a forwarding strategy
Definition: strategy.hpp:38
NFD_LOG_DEBUG
#define NFD_LOG_DEBUG
Definition: logger.hpp:38
nfd::Forwarder
Main class of NFD's forwarding engine.
Definition: forwarder.hpp:52
nfd::fw::findEligibleNextHopWithEarliestOutRecord
fib::NextHopList::const_iterator findEligibleNextHopWithEarliestOutRecord(const Face &inFace, const Interest &interest, const fib::NextHopList &nexthops, const shared_ptr< pit::Entry > &pitEntry)
pick an eligible NextHop with earliest out-record
Definition: algorithm.cpp:132
nfd::fw::ProcessNackTraitsBase::processNack
void processNack(const Face &inFace, const lp::Nack &nack, const shared_ptr< pit::Entry > &pitEntry)
Definition: process-nack-traits.cpp:35
ndn::lp::Nack
represents a Network Nack
Definition: nack.hpp:39
nfd::fw::BestRouteStrategy2::afterReceiveNack
void afterReceiveNack(const FaceEndpoint &ingress, const lp::Nack &nack, const shared_ptr< pit::Entry > &pitEntry) override
trigger after Nack is received
Definition: best-route-strategy2.cpp:126
ndn::to_string
std::string to_string(const T &val)
Definition: backports.hpp:102
algorithm.hpp
ndn::name
Definition: name-component-types.hpp:33
nfd::fw::Strategy::makeInstanceName
static Name makeInstanceName(const Name &input, const Name &strategyName)
construct a strategy instance name
Definition: strategy.cpp:134
nfd::fw::Strategy::ParsedInstanceName::version
optional< uint64_t > version
whether strategyName contains a version component
Definition: strategy.hpp:367
nfd::fw::Strategy::ParsedInstanceName::parameters
PartialName parameters
parameter components
Definition: strategy.hpp:368
nfd::fw::RetxSuppressionResult::SUPPRESS
@ SUPPRESS
Interest is retransmission and should be suppressed.
nfd::fw::BestRouteStrategy2
Best Route strategy version 4.
Definition: best-route-strategy2.hpp:57
nfd::fw::Strategy::ParsedInstanceName
Definition: strategy.hpp:365
NFD_LOG_INIT
#define NFD_LOG_INIT(name)
Definition: logger.hpp:31
nfd::fw::BestRouteStrategy2::afterReceiveInterest
void afterReceiveInterest(const FaceEndpoint &ingress, const Interest &interest, const shared_ptr< pit::Entry > &pitEntry) override
trigger after Interest is received
Definition: best-route-strategy2.cpp:65
logger.hpp
nfd::fw::RetxSuppressionResult::NEW
@ NEW
Interest is new (not a retransmission)