NS-3 based Named Data Networking (NDN) simulator
ndnSIM 2.5: NDN, CCN, CCNx, content centric networks
API Documentation
stream-transport.hpp
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2014-2018, 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_STREAM_TRANSPORT_HPP
27 #define NFD_DAEMON_FACE_STREAM_TRANSPORT_HPP
28 
29 #include "transport.hpp"
30 #include "socket-utils.hpp"
31 #include "core/global-io.hpp"
32 
33 #include <queue>
34 
35 namespace nfd {
36 namespace face {
37 
42 template<class Protocol>
43 class StreamTransport : public Transport
44 {
45 public:
46  typedef Protocol protocol;
47 
52  explicit
53  StreamTransport(typename protocol::socket&& socket);
54 
55  ssize_t
56  getSendQueueLength() override;
57 
58 protected:
59  void
60  doClose() override;
61 
62  void
63  deferredClose();
64 
65  void
66  doSend(Transport::Packet&& packet) override;
67 
68  void
69  sendFromQueue();
70 
71  void
72  handleSend(const boost::system::error_code& error,
73  size_t nBytesSent);
74 
75  void
76  startReceive();
77 
78  void
79  handleReceive(const boost::system::error_code& error,
80  size_t nBytesReceived);
81 
82  void
83  processErrorCode(const boost::system::error_code& error);
84 
85  virtual void
86  handleError(const boost::system::error_code& error);
87 
88  void
90 
91  void
93 
94  size_t
95  getSendQueueBytes() const;
96 
97 protected:
98  typename protocol::socket m_socket;
99 
101 
102 private:
103  uint8_t m_receiveBuffer[ndn::MAX_NDN_PACKET_SIZE];
104  size_t m_receiveBufferSize;
105  std::queue<Block> m_sendQueue;
106  size_t m_sendQueueBytes;
107 };
108 
109 
110 template<class T>
111 StreamTransport<T>::StreamTransport(typename StreamTransport::protocol::socket&& socket)
112  : m_socket(std::move(socket))
113  , m_receiveBufferSize(0)
114  , m_sendQueueBytes(0)
115 {
116  // No queue capacity is set because there is no theoretical limit to the size of m_sendQueue.
117  // Therefore, protecting against send queue overflows is less critical than in other transport
118  // types. Instead, we use the default threshold specified in the GenericLinkService options.
119 
120  startReceive();
121 }
122 
123 template<class T>
124 ssize_t
126 {
127  ssize_t queueLength = getTxQueueLength(m_socket.native_handle());
128  if (queueLength == QUEUE_ERROR) {
129  NFD_LOG_FACE_WARN("Failed to obtain send queue length from socket: " << std::strerror(errno));
130  }
131  return getSendQueueBytes() + std::max<ssize_t>(0, queueLength);
132 }
133 
134 template<class T>
135 void
137 {
138  NFD_LOG_FACE_TRACE(__func__);
139 
140  if (m_socket.is_open()) {
141  // Cancel all outstanding operations and shutdown the socket
142  // so that no further sends or receives are possible.
143  // Use the non-throwing variants and ignore errors, if any.
144  boost::system::error_code error;
145  m_socket.cancel(error);
146  m_socket.shutdown(protocol::socket::shutdown_both, error);
147  }
148 
149  // Ensure that the Transport stays alive at least until
150  // all pending handlers are dispatched
151  getGlobalIoService().post([this] { deferredClose(); });
152 
153  // Some bug or feature of Boost.Asio (see https://redmine.named-data.net/issues/1856):
154  //
155  // When doClose is called from a socket event handler (e.g., from handleReceive),
156  // m_socket.shutdown() does not trigger the cancellation of the handleSend callback.
157  // Instead, handleSend is invoked as nothing bad happened.
158  //
159  // In order to prevent the assertion in handleSend from failing, we clear the queue
160  // and close the socket in deferredClose, i.e., after all callbacks scheduled up to
161  // this point have been executed. If more send operations are scheduled after this
162  // point, they will fail because the socket has been shutdown, and their callbacks
163  // will be invoked with error code == asio::error::shut_down.
164 }
165 
166 template<class T>
167 void
169 {
170  NFD_LOG_FACE_TRACE(__func__);
171 
172  resetSendQueue();
173 
174  // use the non-throwing variant and ignore errors, if any
175  boost::system::error_code error;
176  m_socket.close(error);
177 
178  this->setState(TransportState::CLOSED);
179 }
180 
181 template<class T>
182 void
184 {
185  NFD_LOG_FACE_TRACE(__func__);
186 
187  if (getState() != TransportState::UP)
188  return;
189 
190  bool wasQueueEmpty = m_sendQueue.empty();
191  m_sendQueue.push(packet.packet);
192  m_sendQueueBytes += packet.packet.size();
193 
194  if (wasQueueEmpty)
195  sendFromQueue();
196 }
197 
198 template<class T>
199 void
201 {
202  boost::asio::async_write(m_socket, boost::asio::buffer(m_sendQueue.front()),
203  [this] (auto&&... args) { this->handleSend(std::forward<decltype(args)>(args)...); });
204 }
205 
206 template<class T>
207 void
208 StreamTransport<T>::handleSend(const boost::system::error_code& error,
209  size_t nBytesSent)
210 {
211  if (error)
212  return processErrorCode(error);
213 
214  NFD_LOG_FACE_TRACE("Successfully sent: " << nBytesSent << " bytes");
215 
216  BOOST_ASSERT(!m_sendQueue.empty());
217  BOOST_ASSERT(m_sendQueue.front().size() == nBytesSent);
218  m_sendQueueBytes -= nBytesSent;
219  m_sendQueue.pop();
220 
221  if (!m_sendQueue.empty())
222  sendFromQueue();
223 }
224 
225 template<class T>
226 void
228 {
229  BOOST_ASSERT(getState() == TransportState::UP);
230 
231  m_socket.async_receive(boost::asio::buffer(m_receiveBuffer + m_receiveBufferSize,
232  ndn::MAX_NDN_PACKET_SIZE - m_receiveBufferSize),
233  [this] (auto&&... args) { this->handleReceive(std::forward<decltype(args)>(args)...); });
234 }
235 
236 template<class T>
237 void
238 StreamTransport<T>::handleReceive(const boost::system::error_code& error,
239  size_t nBytesReceived)
240 {
241  if (error)
242  return processErrorCode(error);
243 
244  NFD_LOG_FACE_TRACE("Received: " << nBytesReceived << " bytes");
245 
246  m_receiveBufferSize += nBytesReceived;
247  size_t offset = 0;
248  bool isOk = true;
249  while (m_receiveBufferSize - offset > 0) {
250  Block element;
251  std::tie(isOk, element) = Block::fromBuffer(m_receiveBuffer + offset, m_receiveBufferSize - offset);
252  if (!isOk)
253  break;
254 
255  offset += element.size();
256  BOOST_ASSERT(offset <= m_receiveBufferSize);
257 
258  this->receive(Transport::Packet(std::move(element)));
259  }
260 
261  if (!isOk && m_receiveBufferSize == ndn::MAX_NDN_PACKET_SIZE && offset == 0) {
262  NFD_LOG_FACE_ERROR("Failed to parse incoming packet or packet too large to process");
263  this->setState(TransportState::FAILED);
264  doClose();
265  return;
266  }
267 
268  if (offset > 0) {
269  if (offset != m_receiveBufferSize) {
270  std::copy(m_receiveBuffer + offset, m_receiveBuffer + m_receiveBufferSize, m_receiveBuffer);
271  m_receiveBufferSize -= offset;
272  }
273  else {
274  m_receiveBufferSize = 0;
275  }
276  }
277 
278  startReceive();
279 }
280 
281 template<class T>
282 void
283 StreamTransport<T>::processErrorCode(const boost::system::error_code& error)
284 {
285  NFD_LOG_FACE_TRACE(__func__);
286 
287  if (getState() == TransportState::CLOSING ||
288  getState() == TransportState::FAILED ||
289  getState() == TransportState::CLOSED ||
290  error == boost::asio::error::operation_aborted || // when cancel() is called
291  error == boost::asio::error::shut_down) // after shutdown() is called
292  // transport is shutting down, ignore any errors
293  return;
294 
295  handleError(error);
296 }
297 
298 template<class T>
299 void
300 StreamTransport<T>::handleError(const boost::system::error_code& error)
301 {
302  if (error == boost::asio::error::eof) {
303  this->setState(TransportState::CLOSING);
304  }
305  else {
306  NFD_LOG_FACE_ERROR("Send or receive operation failed: " << error.message());
307  this->setState(TransportState::FAILED);
308  }
309  doClose();
310 }
311 
312 template<class T>
313 void
315 {
316  m_receiveBufferSize = 0;
317 }
318 
319 template<class T>
320 void
322 {
323  std::queue<Block> emptyQueue;
324  std::swap(emptyQueue, m_sendQueue);
325  m_sendQueueBytes = 0;
326 }
327 
328 template<class T>
329 size_t
331 {
332  return m_sendQueueBytes;
333 }
334 
335 } // namespace face
336 } // namespace nfd
337 
338 #endif // NFD_DAEMON_FACE_STREAM_TRANSPORT_HPP
void swap(any &x, any &y) any_noexcept
Definition: any.hpp:544
void doClose() override
performs Transport specific operations to close the transport
void processErrorCode(const boost::system::error_code &error)
#define NFD_LOG_FACE_TRACE(msg)
Log a message at TRACE level.
Definition: face-log.hpp:79
virtual void handleError(const boost::system::error_code &error)
#define NFD_LOG_FACE_ERROR(msg)
Log a message at ERROR level.
Definition: face-log.hpp:91
stores a packet along with the remote endpoint
Definition: transport.hpp:122
const ssize_t QUEUE_ERROR
indicates that the transport was unable to retrieve the queue capacity/length
Definition: transport.hpp:108
detail::SimulatorIo & getGlobalIoService()
Definition: global-io.cpp:48
Represents a TLV element of NDN packet format.
Definition: block.hpp:42
Implements Transport for stream-based protocols.
size_t size() const
Get size of encoded wire, including Type-Length-Value.
Definition: block.cpp:298
Copyright (c) 2011-2015 Regents of the University of California.
Definition: ndn-common.hpp:40
void post(const std::function< void()> &callback)
Definition: global-io.cpp:34
StreamTransport(typename protocol::socket &&socket)
Construct stream transport.
void doSend(Transport::Packet &&packet) override
performs Transport specific operations to send a packet
ssize_t getTxQueueLength(int fd)
obtain send queue length from a specified system socket
void handleReceive(const boost::system::error_code &error, size_t nBytesReceived)
CFReleaser< CFStringRef > fromBuffer(const uint8_t *buf, size_t buflen)
Create a CFString by copying bytes from a raw buffer.
void handleSend(const boost::system::error_code &error, size_t nBytesSent)
ssize_t getSendQueueLength() override
the lower part of a Face
Definition: transport.hpp:113
#define NFD_LOG_FACE_WARN(msg)
Log a message at WARN level.
Definition: face-log.hpp:88
const size_t MAX_NDN_PACKET_SIZE
practical limit of network layer packet size
Definition: tlv.hpp:41