ethernet-channel.cpp
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2014-2020, 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 "ethernet-channel.hpp"
27 #include "ethernet-protocol.hpp"
28 #include "face.hpp"
29 #include "generic-link-service.hpp"
31 #include "common/global.hpp"
32 
33 #include <boost/range/adaptor/map.hpp>
34 #include <pcap/pcap.h>
35 
36 namespace nfd {
37 namespace face {
38 
39 NFD_LOG_INIT(EthernetChannel);
40 
41 EthernetChannel::EthernetChannel(shared_ptr<const ndn::net::NetworkInterface> localEndpoint,
42  time::nanoseconds idleTimeout)
43  : m_localEndpoint(std::move(localEndpoint))
44  , m_isListening(false)
45  , m_socket(getGlobalIoService())
46  , m_pcap(m_localEndpoint->getName())
47  , m_idleFaceTimeout(idleTimeout)
48 #ifdef _DEBUG
49  , m_nDropped(0)
50 #endif
51 {
52  setUri(FaceUri::fromDev(m_localEndpoint->getName()));
53  NFD_LOG_CHAN_INFO("Creating channel");
54 }
55 
56 void
57 EthernetChannel::connect(const ethernet::Address& remoteEndpoint,
58  const FaceParams& params,
59  const FaceCreatedCallback& onFaceCreated,
60  const FaceCreationFailedCallback& onConnectFailed)
61 {
62  shared_ptr<Face> face;
63  try {
64  face = createFace(remoteEndpoint, params).second;
65  }
66  catch (const boost::system::system_error& e) {
67  NFD_LOG_CHAN_DEBUG("Face creation for " << remoteEndpoint << " failed: " << e.what());
68  if (onConnectFailed)
69  onConnectFailed(504, "Face creation failed: "s + e.what());
70  return;
71  }
72 
73  // Need to invoke the callback regardless of whether or not we had already
74  // created the face so that control responses and such can be sent
75  onFaceCreated(face);
76 }
77 
78 void
80  const FaceCreationFailedCallback& onFaceCreationFailed)
81 {
82  if (isListening()) {
83  NFD_LOG_CHAN_WARN("Already listening");
84  return;
85  }
86  m_isListening = true;
87 
88  try {
89  m_pcap.activate(DLT_EN10MB);
90  m_socket.assign(m_pcap.getFd());
91  }
92  catch (const PcapHelper::Error& e) {
93  NDN_THROW_NESTED(Error(e.what()));
94  }
95  updateFilter();
96 
97  asyncRead(onFaceCreated, onFaceCreationFailed);
98  NFD_LOG_CHAN_DEBUG("Started listening");
99 }
100 
101 void
102 EthernetChannel::asyncRead(const FaceCreatedCallback& onFaceCreated,
103  const FaceCreationFailedCallback& onReceiveFailed)
104 {
105  m_socket.async_read_some(boost::asio::null_buffers(),
106  [=] (const auto& e, auto) { this->handleRead(e, onFaceCreated, onReceiveFailed); });
107 }
108 
109 void
110 EthernetChannel::handleRead(const boost::system::error_code& error,
111  const FaceCreatedCallback& onFaceCreated,
112  const FaceCreationFailedCallback& onReceiveFailed)
113 {
114  if (error) {
115  if (error != boost::asio::error::operation_aborted) {
116  NFD_LOG_CHAN_DEBUG("Receive failed: " << error.message());
117  if (onReceiveFailed)
118  onReceiveFailed(500, "Receive failed: " + error.message());
119  }
120  return;
121  }
122 
123  const uint8_t* pkt;
124  size_t len;
125  std::string err;
126  std::tie(pkt, len, err) = m_pcap.readNextPacket();
127 
128  if (pkt == nullptr) {
129  NFD_LOG_CHAN_WARN("Read error: " << err);
130  }
131  else {
132  const ether_header* eh;
133  std::tie(eh, err) = ethernet::checkFrameHeader(pkt, len, m_localEndpoint->getEthernetAddress(),
134  m_localEndpoint->getEthernetAddress());
135  if (eh == nullptr) {
136  NFD_LOG_CHAN_DEBUG(err);
137  }
138  else {
139  ethernet::Address sender(eh->ether_shost);
140  pkt += ethernet::HDR_LEN;
141  len -= ethernet::HDR_LEN;
142  processIncomingPacket(pkt, len, sender, onFaceCreated, onReceiveFailed);
143  }
144  }
145 
146 #ifdef _DEBUG
147  size_t nDropped = m_pcap.getNDropped();
148  if (nDropped - m_nDropped > 0)
149  NFD_LOG_CHAN_DEBUG("Detected " << nDropped - m_nDropped << " dropped frame(s)");
150  m_nDropped = nDropped;
151 #endif
152 
153  asyncRead(onFaceCreated, onReceiveFailed);
154 }
155 
156 void
157 EthernetChannel::processIncomingPacket(const uint8_t* packet, size_t length,
158  const ethernet::Address& sender,
159  const FaceCreatedCallback& onFaceCreated,
160  const FaceCreationFailedCallback& onReceiveFailed)
161 {
162  NFD_LOG_CHAN_TRACE("New peer " << sender);
163 
164  bool isCreated = false;
165  shared_ptr<Face> face;
166  try {
167  FaceParams params;
168  params.persistency = ndn::nfd::FACE_PERSISTENCY_ON_DEMAND;
169  std::tie(isCreated, face) = createFace(sender, params);
170  }
171  catch (const EthernetTransport::Error& e) {
172  NFD_LOG_CHAN_DEBUG("Face creation for " << sender << " failed: " << e.what());
173  if (onReceiveFailed)
174  onReceiveFailed(504, "Face creation failed: "s + e.what());
175  return;
176  }
177 
178  if (isCreated)
179  onFaceCreated(face);
180  else
181  NFD_LOG_CHAN_DEBUG("Received frame for existing face");
182 
183  // dispatch the packet to the face for processing
184  auto* transport = static_cast<UnicastEthernetTransport*>(face->getTransport());
185  transport->receivePayload(packet, length, sender);
186 }
187 
188 std::pair<bool, shared_ptr<Face>>
189 EthernetChannel::createFace(const ethernet::Address& remoteEndpoint,
190  const FaceParams& params)
191 {
192  auto it = m_channelFaces.find(remoteEndpoint);
193  if (it != m_channelFaces.end()) {
194  // we already have a face for this endpoint, so reuse it
195  NFD_LOG_CHAN_TRACE("Reusing existing face for " << remoteEndpoint);
196  return {false, it->second};
197  }
198 
199  // else, create a new face
201  options.allowFragmentation = true;
202  options.allowReassembly = true;
204  if (params.mtu) {
205  options.overrideMtu = *params.mtu;
206  }
207 
208  auto linkService = make_unique<GenericLinkService>(options);
209  auto transport = make_unique<UnicastEthernetTransport>(*m_localEndpoint, remoteEndpoint,
210  params.persistency, m_idleFaceTimeout);
211  auto face = make_shared<Face>(std::move(linkService), std::move(transport));
212  face->setChannel(shared_from_this()); // use weak_from_this() in C++17
213 
214  m_channelFaces[remoteEndpoint] = face;
215  connectFaceClosedSignal(*face, [this, remoteEndpoint] {
216  m_channelFaces.erase(remoteEndpoint);
217  updateFilter();
218  });
219  updateFilter();
220 
221  return {true, face};
222 }
223 
224 void
225 EthernetChannel::updateFilter()
226 {
227  if (!isListening())
228  return;
229 
230  std::string filter = "(ether proto " + to_string(ethernet::ETHERTYPE_NDN) +
231  ") && (ether dst " + m_localEndpoint->getEthernetAddress().toString() + ")";
232  for (const auto& addr : m_channelFaces | boost::adaptors::map_keys) {
233  filter += " && (not ether src " + addr.toString() + ")";
234  }
235  // "not vlan" must appear last in the filter expression, or the
236  // rest of the filter won't work as intended, see pcap-filter(7)
237  filter += " && (not vlan)";
238 
239  NFD_LOG_CHAN_TRACE("Updating filter: " << filter);
240  m_pcap.setPacketFilter(filter.data());
241 }
242 
243 } // namespace face
244 } // namespace nfd
size_t getNDropped() const
Get the number of packets dropped by the kernel, as reported by libpcap.
void listen(const FaceCreatedCallback &onFaceCreated, const FaceCreationFailedCallback &onFaceCreationFailed)
Start listening.
bool isEnabled
enables link-layer reliability
STL namespace.
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:78
void setPacketFilter(const char *filter) const
Install a BPF filter on the receiving socket.
Parameters used to set Transport properties or LinkService options on a newly created face...
Definition: face-common.hpp:78
void connectFaceClosedSignal(Face &face, std::function< void()> f)
Invokes a callback when a face is closed.
Definition: channel.cpp:41
std::tuple< const uint8_t *, size_t, std::string > readNextPacket() const
Read the next packet captured on the interface.
EthernetChannel-related error.
#define NFD_LOG_CHAN_INFO(msg)
Log a message at INFO level.
Definition: channel-log.hpp:52
Copyright (c) 2014-2015, Regents of the University of California, Arizona Board of Regents...
Definition: algorithm.hpp:32
void receivePayload(const uint8_t *payload, size_t length, const ethernet::Address &sender)
Processes the payload of an incoming frame.
EthernetChannel(shared_ptr< const ndn::net::NetworkInterface > localEndpoint, time::nanoseconds idleTimeout)
Create an Ethernet channel on the given localEndpoint (network interface)
optional< ssize_t > mtu
Definition: face-common.hpp:83
std::pair< const ether_header *, std::string > checkFrameHeader(const uint8_t *packet, size_t length, const Address &localAddr, const Address &destAddr)
ndn::nfd::FacePersistency persistency
Definition: face-common.hpp:80
int getFd() const
Obtain a file descriptor that can be used in calls such as select(2) and poll(2). ...
Definition: pcap-helper.cpp:87
void activate(int dlt)
Start capturing packets.
Definition: pcap-helper.cpp:64
void setUri(const FaceUri &uri)
Definition: channel.cpp:35
A unicast Transport that uses raw Ethernet II frames.
#define NFD_LOG_INIT(name)
Definition: logger.hpp:31
void connect(const ethernet::Address &remoteEndpoint, const FaceParams &params, const FaceCreatedCallback &onFaceCreated, const FaceCreationFailedCallback &onConnectFailed)
Create a unicast Ethernet face toward remoteEndpoint.
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:74
#define NFD_LOG_CHAN_TRACE(msg)
Log a message at TRACE level.
Definition: channel-log.hpp:46
bool isListening() const override
Returns whether the channel is listening.
#define NFD_LOG_CHAN_WARN(msg)
Log a message at WARN level.
Definition: channel-log.hpp:55
#define NFD_LOG_CHAN_DEBUG(msg)
Log a message at DEBUG level.
Definition: channel-log.hpp:49
boost::asio::io_service & getGlobalIoService()
Returns the global io_service instance for the calling thread.
Definition: global.cpp:36