ethernet-factory.hpp
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2014-2023, 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 #ifndef NFD_DAEMON_FACE_ETHERNET_FACTORY_HPP
27 #define NFD_DAEMON_FACE_ETHERNET_FACTORY_HPP
28 
29 #include "protocol-factory.hpp"
30 #include "ethernet-channel.hpp"
31 #include "network-predicate.hpp"
32 
33 namespace nfd::face {
34 
38 class EthernetFactory final : public ProtocolFactory
39 {
40 public:
41  static const std::string&
42  getId() noexcept;
43 
44  explicit
45  EthernetFactory(const CtorParams& params);
46 
57  shared_ptr<EthernetChannel>
58  createChannel(const shared_ptr<const ndn::net::NetworkInterface>& localEndpoint,
59  time::nanoseconds idleTimeout);
60 
72  shared_ptr<Face>
73  createMulticastFace(const ndn::net::NetworkInterface& localEndpoint,
74  const ethernet::Address& group);
75 
76 private:
77  void
78  doProcessConfig(OptionalConfigSection configSection,
79  FaceSystem::ConfigContext& context) final;
80 
81  void
82  doCreateFace(const CreateFaceRequest& req,
83  const FaceCreatedCallback& onCreated,
84  const FaceCreationFailedCallback& onFailure) final;
85 
86  std::vector<shared_ptr<const Channel>>
87  doGetChannels() const final;
88 
93  shared_ptr<EthernetChannel>
94  applyUnicastConfigToNetif(const shared_ptr<const ndn::net::NetworkInterface>& netif);
95 
100  shared_ptr<Face>
101  applyMcastConfigToNetif(const ndn::net::NetworkInterface& netif);
102 
103  void
104  applyConfig(const FaceSystem::ConfigContext& context);
105 
106 private:
107  // ifname => channel
108  std::map<std::string, shared_ptr<EthernetChannel>> m_channels;
109 
110  struct UnicastConfig
111  {
112  bool isEnabled = false;
113  bool wantListen = false;
114  time::nanoseconds idleTimeout = 10_min;
115  };
116  UnicastConfig m_unicastConfig;
117 
118  struct MulticastConfig
119  {
120  bool isEnabled = false;
121  ethernet::Address group = ethernet::getDefaultMulticastAddress();
122  ndn::nfd::LinkType linkType = ndn::nfd::LINK_TYPE_MULTI_ACCESS;
123  NetworkInterfacePredicate netifPredicate;
124  };
125  MulticastConfig m_mcastConfig;
126 
127  // [ifname, group] => face
128  std::map<std::pair<std::string, ethernet::Address>, shared_ptr<Face>> m_mcastFaces;
129 
130  signal::ScopedConnection m_netifAddConn;
131 };
132 
133 } // namespace nfd::face
134 
135 #endif // NFD_DAEMON_FACE_ETHERNET_FACTORY_HPP
Protocol factory for Ethernet.
EthernetFactory(const CtorParams &params)
static const std::string & getId() noexcept
shared_ptr< Face > createMulticastFace(const ndn::net::NetworkInterface &localEndpoint, const ethernet::Address &group)
Create a face to communicate on the given Ethernet multicast group.
shared_ptr< EthernetChannel > createChannel(const shared_ptr< const ndn::net::NetworkInterface > &localEndpoint, time::nanoseconds idleTimeout)
Create Ethernet-based channel on the specified network interface.
Context for processing a config section in ProtocolFactory.
Represents a predicate to accept or reject a ndn::net::NetworkInterface.
Provides support for an underlying protocol.
std::function< void(uint32_t status, const std::string &reason)> FaceCreationFailedCallback
Prototype for the callback that is invoked when a face fails to be created.
Definition: channel.hpp:94
std::function< void(const shared_ptr< Face > &)> FaceCreatedCallback
Prototype for the callback that is invoked when a face is created (in response to an incoming connect...
Definition: channel.hpp:90
boost::optional< const ConfigSection & > OptionalConfigSection
An optional configuration file section.
Definition: config-file.hpp:46
Encapsulates a face creation request and all its parameters.
Parameters to ProtocolFactory constructor.