face-common.hpp
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 #ifndef NFD_DAEMON_FACE_FACE_COMMON_HPP
27 #define NFD_DAEMON_FACE_FACE_COMMON_HPP
28 
29 #include "ethernet-protocol.hpp"
30 #include "udp-protocol.hpp"
31 #include "common/logger.hpp"
32 
33 #include <ndn-cxx/encoding/nfd-constants.hpp>
34 
35 #include <boost/logic/tribool.hpp>
36 #include <variant>
37 
38 namespace nfd {
39 namespace face {
40 
41 class Face;
42 class LinkService;
43 
47 using FaceId = uint64_t;
48 
50 inline constexpr FaceId INVALID_FACEID = ndn::nfd::INVALID_FACE_ID;
52 inline constexpr FaceId FACEID_INTERNAL_FACE = 1;
54 inline constexpr FaceId FACEID_CONTENT_STORE = 254;
56 inline constexpr FaceId FACEID_NULL = 255;
58 inline constexpr FaceId FACEID_RESERVED_MAX = 255;
59 
65 inline constexpr ssize_t MIN_MTU = 64;
66 
77 using EndpointId = std::variant<std::monostate, ethernet::Address, udp::Endpoint>;
78 
84 struct FaceParams
85 {
86  ndn::nfd::FacePersistency persistency = ndn::nfd::FACE_PERSISTENCY_PERSISTENT;
87  std::optional<time::nanoseconds> baseCongestionMarkingInterval;
88  std::optional<uint64_t> defaultCongestionThreshold;
89  std::optional<ssize_t> mtu;
90  bool wantLocalFields = false;
91  bool wantLpReliability = false;
92  boost::logic::tribool wantCongestionMarking = boost::logic::indeterminate;
93 };
94 
103 template<typename T>
105 {
106 public:
107  explicit
108  FaceLogHelper(const T& obj1) noexcept
109  : obj(obj1)
110  {
111  }
112 
113 public:
114  const T& obj;
115 };
116 
117 } // namespace face
118 
119 using face::EndpointId;
120 using face::FaceId;
121 
122 } // namespace nfd
123 
134 // implementation detail
135 #define NFD_LOG_FACE(level, msg) NFD_LOG_##level( \
136  ::nfd::face::FaceLogHelper< \
137  std::remove_cv_t<std::remove_reference_t<decltype(*this)>> \
138  >(*this) \
139  << msg)
143 #define NFD_LOG_FACE_TRACE(msg) NFD_LOG_FACE(TRACE, msg)
144 
146 #define NFD_LOG_FACE_DEBUG(msg) NFD_LOG_FACE(DEBUG, msg)
147 
149 #define NFD_LOG_FACE_INFO(msg) NFD_LOG_FACE(INFO, msg)
150 
152 #define NFD_LOG_FACE_WARN(msg) NFD_LOG_FACE(WARN, msg)
153 
155 #define NFD_LOG_FACE_ERROR(msg) NFD_LOG_FACE(ERROR, msg)
156 
159 #endif // NFD_DAEMON_FACE_FACE_COMMON_HPP
For internal use by FaceLogging macros.
FaceLogHelper(const T &obj1) noexcept
constexpr FaceId FACEID_NULL
Identifies the NullFace that drops every packet.
Definition: face-common.hpp:56
constexpr FaceId INVALID_FACEID
Indicates an invalid FaceId.
Definition: face-common.hpp:50
constexpr FaceId FACEID_CONTENT_STORE
Identifies a packet comes from the ContentStore.
Definition: face-common.hpp:54
std::variant< std::monostate, ethernet::Address, udp::Endpoint > EndpointId
Identifies a remote endpoint on the link.
Definition: face-common.hpp:77
constexpr FaceId FACEID_INTERNAL_FACE
Identifies the InternalFace used in management.
Definition: face-common.hpp:52
constexpr FaceId FACEID_RESERVED_MAX
Upper bound of reserved FaceIds.
Definition: face-common.hpp:58
constexpr ssize_t MIN_MTU
Minimum MTU that may be set.
Definition: face-common.hpp:65
uint64_t FaceId
Identifies a face.
Definition: face-common.hpp:47
Definition: common.hpp:77
Parameters used to set Transport properties or LinkService options on a newly created face.
Definition: face-common.hpp:85
std::optional< uint64_t > defaultCongestionThreshold
Definition: face-common.hpp:88
std::optional< time::nanoseconds > baseCongestionMarkingInterval
Definition: face-common.hpp:87
std::optional< ssize_t > mtu
Definition: face-common.hpp:89
ndn::nfd::FacePersistency persistency
Definition: face-common.hpp:86
boost::logic::tribool wantCongestionMarking
Definition: face-common.hpp:92