NS-3 based Named Data Networking (NDN) simulator
ndnSIM 2.5: NDN, CCN, CCNx, content centric networks
API Documentation
manager-base.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 "manager-base.hpp"
27 
28 namespace nfd {
29 
30 ManagerBase::ManagerBase(const std::string& module, Dispatcher& dispatcher)
31  : m_module(module)
32  , m_dispatcher(dispatcher)
33 {
34 }
35 
36 ManagerBase::ManagerBase(const std::string& module, Dispatcher& dispatcher,
37  CommandAuthenticator& authenticator)
38  : m_module(module)
39  , m_dispatcher(dispatcher)
40  , m_authenticator(&authenticator)
41 {
42 }
43 
44 ManagerBase::~ManagerBase() = default;
45 
46 void
48  const ndn::mgmt::StatusDatasetHandler& handler)
49 {
50  m_dispatcher.addStatusDataset(makeRelPrefix(verb),
52  handler);
53 }
54 
57 {
58  return m_dispatcher.addNotificationStream(makeRelPrefix(verb));
59 }
60 
61 void
63 {
64  const Name& interestName = interest.getName();
65 
66  try {
68  if (!sigInfo.hasKeyLocator() || sigInfo.getKeyLocator().getType() != tlv::Name) {
69  return accept("");
70  }
71 
72  accept(sigInfo.getKeyLocator().getName().toUri());
73  }
74  catch (const tlv::Error&) {
75  accept("");
76  }
77 }
78 
80 ManagerBase::makeAuthorization(const std::string& verb)
81 {
82  BOOST_ASSERT(m_authenticator != nullptr);
83  return m_authenticator->makeAuthorization(m_module, verb);
84 }
85 
86 bool
87 ManagerBase::validateParameters(const ControlCommand& command,
88  const ndn::mgmt::ControlParameters& parameters)
89 {
90  BOOST_ASSERT(dynamic_cast<const ControlParameters*>(&parameters) != nullptr);
91 
92  try {
93  command.validateRequest(static_cast<const ControlParameters&>(parameters));
94  }
95  catch (const ControlCommand::ArgumentError&) {
96  return false;
97  }
98  return true;
99 }
100 
101 void
102 ManagerBase::handleCommand(shared_ptr<ControlCommand> command,
103  const ControlCommandHandler& handler,
104  const Name& prefix, const Interest& interest,
105  const ndn::mgmt::ControlParameters& params,
107 {
108  BOOST_ASSERT(dynamic_cast<const ControlParameters*>(&params) != nullptr);
109 
110  ControlParameters parameters = static_cast<const ControlParameters&>(params);
111  command->applyDefaultsToRequest(parameters);
112  handler(*command, prefix, interest, parameters, done);
113 }
114 
115 } // namespace nfd
ndn::Block::blockFromValue
Block blockFromValue() const
Definition: block.cpp:314
ndn::mgmt::AcceptContinuation
std::function< void(const std::string &requester)> AcceptContinuation
a function to be called if authorization is successful
Definition: dispatcher.hpp:45
nfd::CommandAuthenticator::makeAuthorization
ndn::mgmt::Authorization makeAuthorization(const std::string &module, const std::string &verb)
Definition: command-authenticator.cpp:205
ndn::tlv::Interest
@ Interest
Definition: tlv.hpp:65
ndn::mgmt::CommandContinuation
std::function< void(const ControlResponse &resp)> CommandContinuation
a function to be called after ControlCommandHandler completes
Definition: dispatcher.hpp:95
ndn::KeyLocator::getType
uint32_t getType() const
Definition: key-locator.cpp:118
ndn::mgmt::StatusDatasetHandler
std::function< void(const Name &prefix, const Interest &interest, StatusDatasetContext &context)> StatusDatasetHandler
a function to handle a StatusDataset request
Definition: dispatcher.hpp:118
nfd::ManagerBase::registerStatusDatasetHandler
void registerStatusDatasetHandler(const std::string &verb, const ndn::mgmt::StatusDatasetHandler &handler)
Definition: manager-base.cpp:47
ndn::mgmt::PostNotification
std::function< void(const Block &notification)> PostNotification
a function to post a notification
Definition: dispatcher.hpp:124
ndn::mgmt::ControlParameters
base class for a struct that contains ControlCommand parameters
Definition: control-parameters.hpp:33
nfd::ManagerBase::ManagerBase
ManagerBase(const std::string &module, Dispatcher &dispatcher)
Definition: manager-base.cpp:30
ndn::mgmt::Dispatcher::addStatusDataset
void addStatusDataset(const PartialName &relPrefix, Authorization authorize, StatusDatasetHandler handle)
register a StatusDataset or a prefix under which StatusDatasets can be requested
Definition: dispatcher.cpp:223
ndn::Name
Represents an absolute name.
Definition: name.hpp:44
ns3::ndn::Name
Name
Definition: ndn-common.cpp:25
nfd
Copyright (c) 2011-2015 Regents of the University of California.
Definition: ndn-common.hpp:40
ndn::SignatureInfo::getKeyLocator
const KeyLocator & getKeyLocator() const
Get KeyLocator.
Definition: signature-info.cpp:152
nfd::ManagerBase::registerNotificationStream
ndn::mgmt::PostNotification registerNotificationStream(const std::string &verb)
Definition: manager-base.cpp:56
ndn::SignatureInfo
Represents a SignatureInfo TLV element.
Definition: signature-info.hpp:35
ndn::mgmt::makeAcceptAllAuthorization
Authorization makeAcceptAllAuthorization()
return an Authorization that accepts all Interests, with empty string as requester
Definition: dispatcher.cpp:34
ndn::mgmt::Authorization
std::function< void(const Name &prefix, const Interest &interest, const ControlParameters *params, const AcceptContinuation &accept, const RejectContinuation &reject)> Authorization
a function that performs authorization
Definition: dispatcher.hpp:77
ndn::tlv::nfd::ControlParameters
@ ControlParameters
Definition: tlv-nfd.hpp:35
ndn::signed_interest::POS_SIG_INFO
const ssize_t POS_SIG_INFO
Definition: security-common.hpp:32
manager-base.hpp
ndn::Interest
Represents an Interest packet.
Definition: interest.hpp:44
ndn::Name::toUri
void toUri(std::ostream &os, name::UriFormat format=name::UriFormat::DEFAULT) const
Write URI representation of the name to the output stream.
Definition: name.cpp:348
ndn::Name::at
const Component & at(ssize_t i) const
Returns an immutable reference to the component at the specified index, with bounds checking.
Definition: name.cpp:171
ndn::mgmt::ControlCommandHandler
std::function< void(const Name &prefix, const Interest &interest, const ControlParameters &params, const CommandContinuation &done)> ControlCommandHandler
a function to handle an authorized ControlCommand
Definition: dispatcher.hpp:106
nfd::ManagerBase::~ManagerBase
virtual ~ManagerBase()
ndn::mgmt::Dispatcher
represents a dispatcher on server side of NFD Management protocol
Definition: dispatcher.hpp:131
ndn::mgmt::Dispatcher::addNotificationStream
PostNotification addNotificationStream(const PartialName &relPrefix)
register a NotificationStream
Definition: dispatcher.cpp:300
ndn::KeyLocator::getName
const Name & getName() const
Get nested Name element.
Definition: key-locator.cpp:143
ndn::Interest::getName
const Name & getName() const noexcept
Definition: interest.hpp:121
nfd::CommandAuthenticator
Provides ControlCommand authorization according to NFD configuration file.
Definition: command-authenticator.hpp:46
ndn::tlv::Error
represents an error in TLV encoding or decoding
Definition: tlv.hpp:53
nfd::ManagerBase::extractRequester
void extractRequester(const Interest &interest, ndn::mgmt::AcceptContinuation accept)
Extracts the requester from a ControlCommand request.
Definition: manager-base.cpp:62
ndn::SignatureInfo::hasKeyLocator
bool hasKeyLocator() const
Check if KeyLocator exists.
Definition: signature-info.hpp:98