nfd-autoreg.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 
27 #include "core/network.hpp"
28 #include "core/version.hpp"
29 
30 #include <ndn-cxx/face.hpp>
31 #include <ndn-cxx/name.hpp>
32 #include <ndn-cxx/encoding/buffer-stream.hpp>
33 #include <ndn-cxx/mgmt/nfd/controller.hpp>
34 #include <ndn-cxx/mgmt/nfd/face-monitor.hpp>
35 #include <ndn-cxx/mgmt/nfd/face-status.hpp>
36 #include <ndn-cxx/net/address-converter.hpp>
37 #include <ndn-cxx/net/face-uri.hpp>
38 #include <ndn-cxx/security/key-chain.hpp>
39 
40 #include <boost/program_options/options_description.hpp>
41 #include <boost/program_options/variables_map.hpp>
42 #include <boost/program_options/parsers.hpp>
43 
44 #include <iostream>
45 
46 namespace ndn {
47 namespace nfd_autoreg {
48 
49 using ::nfd::Network;
50 
51 class AutoregServer : boost::noncopyable
52 {
53 public:
54  AutoregServer()
55  : m_controller(m_face, m_keyChain)
56  , m_faceMonitor(m_face)
57  , m_cost(255)
58  {
59  }
60 
61  void
62  onRegisterCommandSuccess(uint64_t faceId, const Name& prefix)
63  {
64  std::cerr << "SUCCEED: register " << prefix << " on face " << faceId << std::endl;
65  }
66 
67  void
68  onRegisterCommandFailure(uint64_t faceId, const Name& prefix,
69  const nfd::ControlResponse& response)
70  {
71  std::cerr << "FAILED: register " << prefix << " on face " << faceId
72  << " (code: " << response.getCode() << ", reason: " << response.getText() << ")"
73  << std::endl;
74  }
75 
79  static bool
80  hasAllowedSchema(const FaceUri& uri)
81  {
82  const std::string& scheme = uri.getScheme();
83  return scheme == "udp4" || scheme == "tcp4" ||
84  scheme == "udp6" || scheme == "tcp6";
85  }
86 
90  bool
91  isBlacklisted(const boost::asio::ip::address& address) const
92  {
93  return std::any_of(m_blackList.begin(), m_blackList.end(),
94  bind(&Network::doesContain, _1, address));
95  }
96 
100  bool
101  isWhitelisted(const boost::asio::ip::address& address) const
102  {
103  return std::any_of(m_whiteList.begin(), m_whiteList.end(),
104  bind(&Network::doesContain, _1, address));
105  }
106 
107  void
108  registerPrefixesForFace(uint64_t faceId, const std::vector<Name>& prefixes)
109  {
110  for (const Name& prefix : prefixes) {
111  m_controller.start<nfd::RibRegisterCommand>(
112  nfd::ControlParameters()
113  .setName(prefix)
114  .setFaceId(faceId)
115  .setOrigin(nfd::ROUTE_ORIGIN_AUTOREG)
116  .setCost(m_cost)
117  .setExpirationPeriod(time::milliseconds::max()),
118  bind(&AutoregServer::onRegisterCommandSuccess, this, faceId, prefix),
119  bind(&AutoregServer::onRegisterCommandFailure, this, faceId, prefix, _1));
120  }
121  }
122 
123  void
124  registerPrefixesIfNeeded(uint64_t faceId, const FaceUri& uri, nfd::FacePersistency facePersistency)
125  {
126  if (hasAllowedSchema(uri)) {
127  boost::system::error_code ec;
128  boost::asio::ip::address address = ndn::ip::addressFromString(uri.getHost(), ec);
129 
130  if (!address.is_multicast()) {
131  // register all-face prefixes
132  registerPrefixesForFace(faceId, m_allFacesPrefixes);
133 
134  // register autoreg prefixes if new face is on-demand and not blacklisted and whitelisted
135  if (facePersistency == nfd::FACE_PERSISTENCY_ON_DEMAND &&
136  !isBlacklisted(address) && isWhitelisted(address)) {
137  registerPrefixesForFace(faceId, m_autoregPrefixes);
138  }
139  }
140  }
141  }
142 
143  void
144  onNotification(const nfd::FaceEventNotification& notification)
145  {
146  if (notification.getKind() == nfd::FACE_EVENT_CREATED &&
147  notification.getFaceScope() != nfd::FACE_SCOPE_LOCAL) {
148  std::cerr << "PROCESSING: " << notification << std::endl;
149 
150  registerPrefixesIfNeeded(notification.getFaceId(), FaceUri(notification.getRemoteUri()),
151  notification.getFacePersistency());
152  }
153  else {
154  std::cerr << "IGNORED: " << notification << std::endl;
155  }
156  }
157 
158  void
159  signalHandler()
160  {
161  m_face.shutdown();
162  }
163 
164  static void
165  usage(std::ostream& os,
166  const boost::program_options::options_description& desc,
167  const char* programName)
168  {
169  os << "Usage: " << programName << " [--prefix=</autoreg/prefix>]... [options]\n"
170  << "\n"
171  << desc;
172  }
173 
174  void
175  startProcessing()
176  {
177  std::cerr << "AUTOREG prefixes: " << std::endl;
178  for (const Name& prefix : m_autoregPrefixes) {
179  std::cout << " " << prefix << std::endl;
180  }
181  std::cerr << "ALL-FACES-AUTOREG prefixes: " << std::endl;
182  for (const Name& prefix : m_allFacesPrefixes) {
183  std::cout << " " << prefix << std::endl;
184  }
185 
186  if (!m_blackList.empty()) {
187  std::cerr << "Blacklisted networks: " << std::endl;
188  for (const Network& network : m_blackList) {
189  std::cout << " " << network << std::endl;
190  }
191  }
192 
193  std::cerr << "Whitelisted networks: " << std::endl;
194  for (const Network& network : m_whiteList) {
195  std::cout << " " << network << std::endl;
196  }
197 
198  m_faceMonitor.onNotification.connect(bind(&AutoregServer::onNotification, this, _1));
199  m_faceMonitor.start();
200 
201  boost::asio::signal_set signalSet(m_face.getIoService(), SIGINT, SIGTERM);
202  signalSet.async_wait(bind(&AutoregServer::signalHandler, this));
203 
204  m_face.processEvents();
205  }
206 
207  void
208  startFetchingFaceStatusDataset()
209  {
210  m_controller.fetch<nfd::FaceDataset>(
211  [this] (const std::vector<nfd::FaceStatus>& faces) {
212  for (const auto& faceStatus : faces) {
213  registerPrefixesIfNeeded(faceStatus.getFaceId(), FaceUri(faceStatus.getRemoteUri()),
214  faceStatus.getFacePersistency());
215  }
216  },
217  [] (uint32_t code, const std::string& reason) {});
218  }
219 
220  int
221  main(int argc, char* argv[])
222  {
223  namespace po = boost::program_options;
224 
225  po::options_description optionsDesc("Options");
226  optionsDesc.add_options()
227  ("help,h", "print this message and exit")
228  ("version,V", "show version information and exit")
229  ("prefix,i", po::value<std::vector<Name>>(&m_autoregPrefixes)->composing(),
230  "prefix that should be automatically registered when a new non-local face is created")
231  ("all-faces-prefix,a", po::value<std::vector<Name>>(&m_allFacesPrefixes)->composing(),
232  "prefix that should be automatically registered for all TCP and UDP non-local faces "
233  "(blacklists and whitelists do not apply to this prefix)")
234  ("cost,c", po::value<uint64_t>(&m_cost)->default_value(255),
235  "FIB cost that should be assigned to autoreg nexthops")
236  ("whitelist,w", po::value<std::vector<Network>>(&m_whiteList)->composing(),
237  "Whitelisted network, e.g., 192.168.2.0/24 or ::1/128")
238  ("blacklist,b", po::value<std::vector<Network>>(&m_blackList)->composing(),
239  "Blacklisted network, e.g., 192.168.2.32/30 or ::1/128")
240  ;
241 
242  po::variables_map options;
243  try {
244  po::store(po::parse_command_line(argc, argv, optionsDesc), options);
245  po::notify(options);
246  }
247  catch (const std::exception& e) {
248  std::cerr << "ERROR: " << e.what() << std::endl << std::endl;
249  usage(std::cerr, optionsDesc, argv[0]);
250  return 2;
251  }
252 
253  if (options.count("help") > 0) {
254  usage(std::cout, optionsDesc, argv[0]);
255  return 0;
256  }
257 
258  if (options.count("version") > 0) {
259  std::cout << NFD_VERSION_BUILD_STRING << std::endl;
260  return 0;
261  }
262 
263  if (m_autoregPrefixes.empty() && m_allFacesPrefixes.empty()) {
264  std::cerr << "ERROR: at least one --prefix or --all-faces-prefix must be specified"
265  << std::endl << std::endl;
266  usage(std::cerr, optionsDesc, argv[0]);
267  return 2;
268  }
269 
270  if (m_whiteList.empty()) {
271  // Allow everything
272  m_whiteList.push_back(Network::getMaxRangeV4());
273  m_whiteList.push_back(Network::getMaxRangeV6());
274  }
275 
276  try {
277  startFetchingFaceStatusDataset();
278  startProcessing();
279  }
280  catch (const std::exception& e) {
281  std::cerr << "ERROR: " << ::nfd::getExtendedErrorMessage(e) << std::endl;
282  return 1;
283  }
284 
285  return 0;
286  }
287 
288 private:
289  Face m_face;
290  KeyChain m_keyChain;
291  nfd::Controller m_controller;
292  nfd::FaceMonitor m_faceMonitor;
293  std::vector<Name> m_autoregPrefixes;
294  std::vector<Name> m_allFacesPrefixes;
295  uint64_t m_cost;
296  std::vector<Network> m_whiteList;
297  std::vector<Network> m_blackList;
298 };
299 
300 } // namespace nfd_autoreg
301 } // namespace ndn
302 
303 int
304 main(int argc, char* argv[])
305 {
306  ndn::nfd_autoreg::AutoregServer server;
307  return server.main(argc, argv);
308 }
static void usage(std::ostream &os, const po::options_description &opts, const char *programName)
Definition: main.cpp:59
Copyright (c) 2014-2017, Regents of the University of California, Arizona Board of Regents...
std::string getExtendedErrorMessage(const E &exception)
int main(int argc, char *argv[])