face-manager.hpp
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2014-2024, 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_MGMT_FACE_MANAGER_HPP
27 #define NFD_DAEMON_MGMT_FACE_MANAGER_HPP
28 
29 #include "manager-base.hpp"
30 #include "face/face.hpp"
31 #include "face/face-system.hpp"
32 
33 #include <map>
34 
35 namespace nfd {
36 
41 class FaceManager final : public ManagerBase
42 {
43 public:
44  FaceManager(FaceSystem& faceSystem,
45  Dispatcher& dispatcher, CommandAuthenticator& authenticator);
46 
47 private: // ControlCommand
48  void
49  createFace(const ControlParameters& parameters,
50  const ndn::mgmt::CommandContinuation& done);
51 
52  void
53  updateFace(const Interest& interest,
54  const ControlParameters& parameters,
55  const ndn::mgmt::CommandContinuation& done);
56 
57  void
58  destroyFace(const ControlParameters& parameters,
59  const ndn::mgmt::CommandContinuation& done);
60 
61 private: // helpers for ControlCommand
62  void
63  afterCreateFaceSuccess(const shared_ptr<Face>& face,
64  const ControlParameters& parameters,
65  const ndn::mgmt::CommandContinuation& done);
66 
67 private: // StatusDataset
68  void
69  listFaces(ndn::mgmt::StatusDatasetContext& context);
70 
71  void
72  listChannels(ndn::mgmt::StatusDatasetContext& context);
73 
74  void
75  queryFaces(const Interest& interest, ndn::mgmt::StatusDatasetContext& context);
76 
77 private: // NotificationStream
78  void
79  notifyFaceEvent(const Face& face, ndn::nfd::FaceEventKind kind);
80 
81  void
82  connectFaceStateChangeSignal(const Face& face);
83 
84 private:
85  FaceSystem& m_faceSystem;
86  FaceTable& m_faceTable;
87  ndn::mgmt::PostNotification m_postNotification;
88  signal::ScopedConnection m_faceAddConn;
89  signal::ScopedConnection m_faceRemoveConn;
90 
92  std::map<FaceId, signal::ScopedConnection> m_faceStateChangeConn;
93 };
94 
95 } // namespace nfd
96 
97 #endif // NFD_DAEMON_MGMT_FACE_MANAGER_HPP
Provides ControlCommand authorization according to NFD's configuration file.
Implements the Face Management of NFD Management Protocol.
FaceManager(FaceSystem &faceSystem, Dispatcher &dispatcher, CommandAuthenticator &authenticator)
Container of all faces.
Definition: face-table.hpp:42
A collection of common functions shared by all NFD managers, such as communicating with the dispatche...
Generalization of a network interface.
Definition: face.hpp:118
Entry point of NFD's face system.
Definition: face-system.hpp:55
#define NFD_PUBLIC_WITH_TESTS_ELSE_PRIVATE
Definition: common.hpp:41
-status-http-server
Definition: common.hpp:71