face-module.hpp
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2014-2023, 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_TOOLS_NFDC_FACE_MODULE_HPP
27 #define NFD_TOOLS_NFDC_FACE_MODULE_HPP
28 
29 #include "module.hpp"
30 #include "command-parser.hpp"
31 #include "format-helpers.hpp"
32 
33 #include <ndn-cxx/mgmt/nfd/face-status.hpp>
34 
35 namespace nfd::tools::nfdc {
36 
37 using ndn::nfd::FaceStatus;
38 
43 class FaceModule : public Module, boost::noncopyable
44 {
45 public:
48  static void
50 
53  static void
54  list(ExecuteContext& ctx);
55 
58  static void
59  show(ExecuteContext& ctx);
60 
63  static void
64  create(ExecuteContext& ctx);
65 
68  static void
69  destroy(ExecuteContext& ctx);
70 
71  void
72  fetchStatus(ndn::nfd::Controller& controller,
73  const std::function<void()>& onSuccess,
74  const ndn::nfd::DatasetFailureCallback& onFailure,
75  const CommandOptions& options) override;
76 
77  void
78  formatStatusXml(std::ostream& os) const override;
79 
84  void
85  formatItemXml(std::ostream& os, const FaceStatus& item) const;
86 
87  void
88  formatStatusText(std::ostream& os) const override;
89 
95  static void
96  formatItemText(std::ostream& os, const FaceStatus& item, bool wantMultiLine);
97 
103  static void
104  printSuccess(std::ostream& os, const std::string& actionSummary, const ControlParameters& resp);
105 
111  static void
112  printFaceParams(std::ostream& os, text::ItemAttributes& ia, const ControlParameters& resp);
113 
114 private:
115  std::vector<FaceStatus> m_status;
116 };
117 
118 } // namespace nfd::tools::nfdc
119 
120 #endif // NFD_TOOLS_NFDC_FACE_MODULE_HPP
Context for command execution.
Provides access to NFD face management.
Definition: face-module.hpp:44
static void printFaceParams(std::ostream &os, text::ItemAttributes &ia, const ControlParameters &resp)
Print face response parameters to specified ostream.
void formatItemXml(std::ostream &os, const FaceStatus &item) const
Format a single status item as XML.
void formatStatusText(std::ostream &os) const override
Format collected status as text.
static void destroy(ExecuteContext &ctx)
The 'face destroy' command.
static void registerCommands(CommandParser &parser)
Register 'face list', 'face show', 'face create', 'face destroy' commands.
Definition: face-module.cpp:36
void formatStatusXml(std::ostream &os) const override
Format collected status as XML.
void fetchStatus(ndn::nfd::Controller &controller, const std::function< void()> &onSuccess, const ndn::nfd::DatasetFailureCallback &onFailure, const CommandOptions &options) override
Collect status from NFD.
static void formatItemText(std::ostream &os, const FaceStatus &item, bool wantMultiLine)
Format a single status item as text.
static void printSuccess(std::ostream &os, const std::string &actionSummary, const ControlParameters &resp)
Print face action success message to specified ostream.
static void list(ExecuteContext &ctx)
The 'face list' command.
Definition: face-module.cpp:74
static void show(ExecuteContext &ctx)
The 'face show' command.
static void create(ExecuteContext &ctx)
The 'face create' command.
Provides access to an NFD management module.
Definition: module.hpp:44
Print attributes of an item.