NS-3 based Named Data Networking (NDN) simulator
ndnSIM 2.5: NDN, CCN, CCNx, content centric networks
API Documentation
udp-channel.hpp
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2014-2021, 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_UDP_CHANNEL_HPP
27 #define NFD_DAEMON_FACE_UDP_CHANNEL_HPP
28 
29 #include "channel.hpp"
30 #include "udp-protocol.hpp"
31 
32 #include <array>
33 
34 namespace nfd {
35 namespace face {
36 
40 class UdpChannel final : public Channel
41 {
42 public:
50  UdpChannel(const udp::Endpoint& localEndpoint,
51  time::nanoseconds idleTimeout,
52  bool wantCongestionMarking,
53  size_t defaultMtu);
54 
55  bool
56  isListening() const final
57  {
58  return m_socket.is_open();
59  }
60 
61  size_t
62  size() const final
63  {
64  return m_channelFaces.size();
65  }
66 
70  void
71  connect(const udp::Endpoint& remoteEndpoint,
72  const FaceParams& params,
73  const FaceCreatedCallback& onFaceCreated,
74  const FaceCreationFailedCallback& onConnectFailed);
75 
87  void
88  listen(const FaceCreatedCallback& onFaceCreated,
89  const FaceCreationFailedCallback& onFaceCreationFailed);
90 
91 private:
92  void
93  waitForNewPeer(const FaceCreatedCallback& onFaceCreated,
94  const FaceCreationFailedCallback& onReceiveFailed);
95 
100  void
101  handleNewPeer(const boost::system::error_code& error,
102  size_t nBytesReceived,
103  const FaceCreatedCallback& onFaceCreated,
104  const FaceCreationFailedCallback& onReceiveFailed);
105 
106  std::pair<bool, shared_ptr<Face>>
107  createFace(const udp::Endpoint& remoteEndpoint,
108  const FaceParams& params);
109 
110 private:
111  const udp::Endpoint m_localEndpoint;
112  udp::Endpoint m_remoteEndpoint;
114  std::array<uint8_t, ndn::MAX_NDN_PACKET_SIZE> m_receiveBuffer;
115  std::map<udp::Endpoint, shared_ptr<Face>> m_channelFaces;
116  const time::nanoseconds m_idleFaceTimeout;
117  bool m_wantCongestionMarking;
118 };
119 
120 } // namespace face
121 } // namespace nfd
122 
123 #endif // NFD_DAEMON_FACE_UDP_CHANNEL_HPP
bool isListening() const final
Returns whether the channel is listening.
Definition: udp-channel.hpp:56
void connect(const udp::Endpoint &remoteEndpoint, const FaceParams &params, const FaceCreatedCallback &onFaceCreated, const FaceCreationFailedCallback &onConnectFailed)
Create a unicast UDP face toward remoteEndpoint.
Definition: udp-channel.cpp:54
Represents a channel that listens on a local endpoint.
Definition: channel.hpp:41
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:90
UdpChannel(const udp::Endpoint &localEndpoint, time::nanoseconds idleTimeout, bool wantCongestionMarking, size_t defaultMtu)
Create a UDP channel on the given localEndpoint.
Definition: udp-channel.cpp:39
Copyright (c) 2011-2015 Regents of the University of California.
Definition: ndn-common.hpp:39
boost::asio::ip::udp::endpoint Endpoint
size_t size() const final
Returns the number of faces in the channel.
Definition: udp-channel.hpp:62
void listen(const FaceCreatedCallback &onFaceCreated, const FaceCreationFailedCallback &onFaceCreationFailed)
Start listening.
Definition: udp-channel.cpp:76
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:86
Catch-all error for socket component errors that don&#39;t fit in other categories.
Definition: base.hpp:83
boost::chrono::nanoseconds nanoseconds
Definition: time.hpp:50
Parameters used to set Transport properties or LinkService options on a newly created face...
Definition: face-common.hpp:78
Class implementing UDP-based channel to create faces.
Definition: udp-channel.hpp:40