multicast-discovery.cpp
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2014-2024, 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 "multicast-discovery.hpp"
27 
28 #include <boost/lexical_cast.hpp>
29 
30 #include <ndn-cxx/encoding/tlv-nfd.hpp>
31 #include <ndn-cxx/mgmt/nfd/status-dataset.hpp>
32 
33 namespace ndn::autoconfig {
34 
35 using nfd::ControlParameters;
36 
37 const Name HUB_DISCOVERY_PREFIX{"/localhop/ndn-autoconf/hub"};
38 constexpr uint64_t HUB_DISCOVERY_ROUTE_COST = 1;
39 constexpr time::milliseconds HUB_DISCOVERY_ROUTE_EXPIRATION = 30_s;
40 constexpr time::milliseconds HUB_DISCOVERY_INTEREST_LIFETIME = 4_s;
41 
42 MulticastDiscovery::MulticastDiscovery(Face& face, nfd::Controller& controller)
43  : m_face(face)
44  , m_controller(controller)
45 {
46 }
47 
48 void
49 MulticastDiscovery::doStart()
50 {
51  nfd::FaceQueryFilter filter;
52  filter.setLinkType(nfd::LINK_TYPE_MULTI_ACCESS);
53 
54  m_controller.fetch<nfd::FaceQueryDataset>(
55  filter,
56  [this] (const auto& dataset) { registerHubDiscoveryPrefix(dataset); },
57  [this] (uint32_t code, const std::string& reason) {
58  fail("Error " + std::to_string(code) + " when querying multi-access faces: " + reason);
59  });
60 }
61 
62 void
63 MulticastDiscovery::registerHubDiscoveryPrefix(const std::vector<nfd::FaceStatus>& dataset)
64 {
65  if (dataset.empty()) {
66  fail("No multi-access faces available");
67  return;
68  }
69 
70  m_nRegs = dataset.size();
71  m_nRegSuccess = 0;
72  m_nRegFailure = 0;
73 
74  for (const auto& faceStatus : dataset) {
75  ControlParameters parameters;
76  parameters.setName(HUB_DISCOVERY_PREFIX)
77  .setFaceId(faceStatus.getFaceId())
78  .setCost(HUB_DISCOVERY_ROUTE_COST)
79  .setExpirationPeriod(HUB_DISCOVERY_ROUTE_EXPIRATION);
80 
81  m_controller.start<nfd::RibRegisterCommand>(
82  parameters,
83  [this] (const auto&) {
84  ++m_nRegSuccess;
85  afterReg();
86  },
87  [this, faceStatus] (const auto& resp) {
88  std::cerr << "Error " << resp.getCode() << " when registering hub discovery prefix "
89  << "for face " << faceStatus.getFaceId() << " (" << faceStatus.getRemoteUri()
90  << "): " << resp.getText() << std::endl;
91  ++m_nRegFailure;
92  afterReg();
93  });
94  }
95 }
96 
97 void
98 MulticastDiscovery::afterReg()
99 {
100  if (m_nRegSuccess + m_nRegFailure < m_nRegs) {
101  return; // continue waiting
102  }
103  if (m_nRegSuccess > 0) {
104  setStrategy();
105  }
106  else {
107  fail("Cannot register hub discovery prefix for any face");
108  }
109 }
110 
111 void
112 MulticastDiscovery::setStrategy()
113 {
114  ControlParameters parameters;
115  parameters.setName(HUB_DISCOVERY_PREFIX)
116  .setStrategy("/localhost/nfd/strategy/multicast");
117 
118  m_controller.start<nfd::StrategyChoiceSetCommand>(
119  parameters,
120  [this] (const auto&) { requestHubData(); },
121  [this] (const auto& resp) {
122  fail("Error " + std::to_string(resp.getCode()) + " when setting multicast strategy: " + resp.getText());
123  });
124 }
125 
126 void
127 MulticastDiscovery::requestHubData()
128 {
129  Interest interest(HUB_DISCOVERY_PREFIX);
130  interest.setCanBePrefix(true);
131  interest.setMustBeFresh(true);
132  interest.setInterestLifetime(HUB_DISCOVERY_INTEREST_LIFETIME);
133 
134  m_face.expressInterest(interest,
135  [this] (const Interest&, const Data& data) {
136  const Block& content = data.getContent();
137  content.parse();
138 
139  auto i = content.find(tlv::nfd::Uri);
140  if (i == content.elements_end()) {
141  fail("Malformed hub Data: missing Uri element");
142  return;
143  }
144 
145  provideHubFaceUri(std::string(reinterpret_cast<const char*>(i->value()), i->value_size()));
146  },
147  [this] (const Interest&, const lp::Nack& nack) {
148  fail("Nack-" + boost::lexical_cast<std::string>(nack.getReason()) + " when retrieving hub Data");
149  },
150  [this] (const Interest&) {
151  fail("Timeout when retrieving hub Data");
152  });
153 }
154 
155 } // namespace ndn::autoconfig
MulticastDiscovery(Face &face, nfd::Controller &controller)
void provideHubFaceUri(const std::string &s)
Parse HUB FaceUri from string and declare success.
Definition: stage.cpp:43
void fail(const std::string &msg)
Definition: stage.cpp:63
constexpr uint64_t HUB_DISCOVERY_ROUTE_COST
const Name HUB_DISCOVERY_PREFIX
constexpr time::milliseconds HUB_DISCOVERY_INTEREST_LIFETIME
constexpr time::milliseconds HUB_DISCOVERY_ROUTE_EXPIRATION