websocket-transport.cpp
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2014-2022, 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 "websocket-transport.hpp"
27 #include "common/global.hpp"
28 
29 namespace nfd::face {
30 
31 NFD_LOG_INIT(WebSocketTransport);
32 
33 static bool
34 isLoopback(const boost::asio::ip::address& addr)
35 {
36  if (addr.is_loopback()) {
37  return true;
38  }
39  // Workaround for loopback IPv4-mapped IPv6 addresses
40  // see https://svn.boost.org/trac/boost/ticket/9084
41  else if (addr.is_v6()) {
42  auto addr6 = addr.to_v6();
43  if (addr6.is_v4_mapped()) {
44  return addr6.to_v4().is_loopback();
45  }
46  }
47 
48  return false;
49 }
50 
51 WebSocketTransport::WebSocketTransport(websocketpp::connection_hdl hdl,
52  websocket::Server& server,
53  time::milliseconds pingInterval)
54  : m_handle(hdl)
55  , m_server(server)
56  , m_pingInterval(pingInterval)
57 {
58  const auto& sock = m_server.get_con_from_hdl(hdl)->get_socket();
59  this->setLocalUri(FaceUri(sock.local_endpoint(), "ws"));
60  this->setRemoteUri(FaceUri(sock.remote_endpoint(), "wsclient"));
61 
62  if (isLoopback(sock.local_endpoint().address()) &&
63  isLoopback(sock.remote_endpoint().address())) {
64  this->setScope(ndn::nfd::FACE_SCOPE_LOCAL);
65  }
66  else {
67  this->setScope(ndn::nfd::FACE_SCOPE_NON_LOCAL);
68  }
69 
70  this->setPersistency(ndn::nfd::FACE_PERSISTENCY_ON_DEMAND);
71  this->setLinkType(ndn::nfd::LINK_TYPE_POINT_TO_POINT);
72  this->setMtu(MTU_UNLIMITED);
73 
74  this->schedulePing();
75 
76  NFD_LOG_FACE_DEBUG("Creating transport");
77 }
78 
79 void
80 WebSocketTransport::doSend(const Block& packet)
81 {
82  NFD_LOG_FACE_TRACE(__func__);
83 
84  websocketpp::lib::error_code error;
85  m_server.send(m_handle, packet.data(), packet.size(),
86  websocketpp::frame::opcode::binary, error);
87  if (error)
88  return processErrorCode(error);
89 
90  NFD_LOG_FACE_TRACE("Successfully sent: " << packet.size() << " bytes");
91 }
92 
93 void
94 WebSocketTransport::receiveMessage(const std::string& msg)
95 {
96  NFD_LOG_FACE_TRACE("Received: " << msg.size() << " bytes");
97 
98  bool isOk = false;
99  Block element;
100  std::tie(isOk, element) = Block::fromBuffer({reinterpret_cast<const uint8_t*>(msg.data()), msg.size()});
101  if (!isOk) {
102  NFD_LOG_FACE_WARN("Failed to parse message payload");
103  return;
104  }
105 
106  this->receive(element);
107 }
108 
109 void
110 WebSocketTransport::schedulePing()
111 {
112  m_pingEventId = getScheduler().schedule(m_pingInterval, [this] { sendPing(); });
113 }
114 
115 void
116 WebSocketTransport::sendPing()
117 {
118  NFD_LOG_FACE_TRACE(__func__);
119 
120  websocketpp::lib::error_code error;
121  m_server.ping(m_handle, "NFD-WebSocket", error);
122  if (error)
123  return processErrorCode(error);
124 
125  ++this->nOutPings;
126 
127  this->schedulePing();
128 }
129 
130 void
132 {
133  NFD_LOG_FACE_TRACE(__func__);
134 
135  ++this->nInPongs;
136 }
137 
138 void
140 {
141  NFD_LOG_FACE_ERROR("Pong timeout");
143  doClose();
144 }
145 
146 void
147 WebSocketTransport::processErrorCode(const websocketpp::lib::error_code& error)
148 {
149  NFD_LOG_FACE_TRACE(__func__);
150 
154  // transport is shutting down, ignore any errors
155  return;
156 
157  NFD_LOG_FACE_ERROR("Send or ping operation failed: " << error.message());
159  doClose();
160 }
161 
162 void
164 {
165  NFD_LOG_FACE_TRACE(__func__);
166 
167  m_pingEventId.cancel();
168 
169  // use the non-throwing variant and ignore errors, if any
170  websocketpp::lib::error_code error;
171  m_server.close(m_handle, websocketpp::close::status::normal, "closed by NFD", error);
172 
174 }
175 
176 } // namespace nfd::face
void setScope(ndn::nfd::FaceScope scope) noexcept
Definition: transport.hpp:346
void receive(const Block &packet, const EndpointId &endpoint={})
Pass a received link-layer packet to the upper layer for further processing.
Definition: transport.cpp:101
void setPersistency(ndn::nfd::FacePersistency newPersistency)
Changes the persistency setting of the transport.
Definition: transport.cpp:152
void setMtu(ssize_t mtu) noexcept
Definition: transport.cpp:114
TransportState getState() const noexcept
Returns the current transport state.
Definition: transport.hpp:291
void setState(TransportState newState)
Set transport state.
Definition: transport.cpp:175
void setLocalUri(const FaceUri &uri) noexcept
Definition: transport.hpp:334
void setLinkType(ndn::nfd::LinkType linkType) noexcept
Definition: transport.hpp:352
void setRemoteUri(const FaceUri &uri) noexcept
Definition: transport.hpp:340
PacketCounter nInPongs
Count of incoming pongs.
PacketCounter nOutPings
Count of outgoing pings.
void doClose() final
Performs Transport specific operations to close the transport.
WebSocketTransport(websocketpp::connection_hdl hdl, websocket::Server &server, time::milliseconds pingInterval)
void receiveMessage(const std::string &msg)
Translates a message into a Block and delivers it to the link service.
#define NFD_LOG_FACE_ERROR(msg)
Log a message at ERROR level.
#define NFD_LOG_FACE_DEBUG(msg)
Log a message at DEBUG level.
#define NFD_LOG_FACE_WARN(msg)
Log a message at WARN level.
#define NFD_LOG_FACE_TRACE(msg)
Log a message at TRACE level.
#define NFD_LOG_INIT(name)
Definition: logger.hpp:31
static bool isLoopback(const boost::asio::ip::address &addr)
@ CLOSED
the transport is closed, and can be safely deallocated
@ CLOSING
the transport is being closed gracefully, either by the peer or by a call to close()
@ FAILED
the transport is being closed due to a failure
constexpr ssize_t MTU_UNLIMITED
Indicates that the transport has no limit on payload size.
Definition: transport.hpp:92
websocketpp::server< websocketpp::config::asio > Server
Definition: websocketpp.hpp:47
Scheduler & getScheduler()
Returns the global Scheduler instance for the calling thread.
Definition: global.cpp:45