/* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
/*
* Copyright (c) 2014-2023, Regents of the University of California,
* Arizona Board of Regents,
* Colorado State University,
* University Pierre & Marie Curie, Sorbonne University,
* Washington University in St. Louis,
* Beijing Institute of Technology,
* The University of Memphis.
*
* This file is part of NFD (Named Data Networking Forwarding Daemon).
* See AUTHORS.md for complete list of NFD authors and contributors.
*
* NFD is free software: you can redistribute it and/or modify it under the terms
* of the GNU General Public License as published by the Free Software Foundation,
* either version 3 of the License, or (at your option) any later version.
*
* NFD is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
* without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
* PURPOSE. See the GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License along with
* NFD, e.g., in COPYING.md file. If not, see .
*/
#include "face-module.hpp"
#include "face-helpers.hpp"
#include
#include
namespace nfd::tools::nfdc {
void
FaceModule::registerCommands(CommandParser& parser)
{
CommandDefinition defFaceList("face", "list");
defFaceList
.setTitle("print face list")
.addArg("remote", ArgValueType::FACE_URI, Required::NO, Positional::YES)
.addArg("local", ArgValueType::FACE_URI, Required::NO, Positional::NO)
.addArg("scheme", ArgValueType::STRING, Required::NO, Positional::NO, "scheme");
parser.addCommand(defFaceList, &FaceModule::list);
parser.addAlias("face", "list", "");
CommandDefinition defFaceShow("face", "show");
defFaceShow
.setTitle("show face information")
.addArg("id", ArgValueType::UNSIGNED, Required::YES, Positional::YES);
parser.addCommand(defFaceShow, &FaceModule::show);
CommandDefinition defFaceCreate("face", "create");
defFaceCreate
.setTitle("create a face")
.addArg("remote", ArgValueType::FACE_URI, Required::YES, Positional::YES)
.addArg("persistency", ArgValueType::FACE_PERSISTENCY, Required::NO, Positional::YES)
.addArg("local", ArgValueType::FACE_URI, Required::NO, Positional::NO)
.addArg("reliability", ArgValueType::BOOLEAN, Required::NO, Positional::NO)
.addArg("congestion-marking", ArgValueType::BOOLEAN, Required::NO, Positional::NO)
.addArg("congestion-marking-interval", ArgValueType::UNSIGNED, Required::NO, Positional::NO)
.addArg("default-congestion-threshold", ArgValueType::UNSIGNED, Required::NO, Positional::NO)
.addArg("mtu", ArgValueType::STRING, Required::NO, Positional::NO);
parser.addCommand(defFaceCreate, &FaceModule::create);
CommandDefinition defFaceDestroy("face", "destroy");
defFaceDestroy
.setTitle("destroy a face")
.addArg("face", ArgValueType::FACE_ID_OR_URI, Required::YES, Positional::YES);
parser.addCommand(defFaceDestroy, &FaceModule::destroy);
}
void
FaceModule::list(ExecuteContext& ctx)
{
auto remoteUri = ctx.args.getOptional("remote");
auto localUri = ctx.args.getOptional("local");
auto uriScheme = ctx.args.getOptional("scheme");
FaceQueryFilter filter;
if (remoteUri) {
filter.setRemoteUri(remoteUri->toString());
}
if (localUri) {
filter.setLocalUri(localUri->toString());
}
if (uriScheme) {
filter.setUriScheme(*uriScheme);
}
FindFace findFace(ctx);
FindFace::Code res = findFace.execute(filter, true);
ctx.exitCode = static_cast(res);
switch (res) {
case FindFace::Code::OK:
for (const FaceStatus& item : findFace.getResults()) {
formatItemText(ctx.out, item, false);
ctx.out << '\n';
}
break;
case FindFace::Code::ERROR:
case FindFace::Code::NOT_FOUND:
case FindFace::Code::CANONIZE_ERROR:
ctx.err << findFace.getErrorReason() << '\n';
break;
default:
BOOST_ASSERT_MSG(false, "unexpected FindFace result");
break;
}
}
void
FaceModule::show(ExecuteContext& ctx)
{
uint64_t faceId = ctx.args.get("id");
FindFace findFace(ctx);
FindFace::Code res = findFace.execute(faceId);
ctx.exitCode = static_cast(res);
switch (res) {
case FindFace::Code::OK:
formatItemText(ctx.out, findFace.getFaceStatus(), true);
break;
case FindFace::Code::ERROR:
case FindFace::Code::NOT_FOUND:
ctx.err << findFace.getErrorReason() << '\n';
break;
default:
BOOST_ASSERT_MSG(false, "unexpected FindFace result");
break;
}
}
/** \brief Order persistency in NONE < ON_DEMAND < PERSISTENCY < PERMANENT.
*/
static bool
persistencyLessThan(FacePersistency x, FacePersistency y)
{
switch (x) {
case FacePersistency::FACE_PERSISTENCY_NONE:
return y != FacePersistency::FACE_PERSISTENCY_NONE;
case FacePersistency::FACE_PERSISTENCY_ON_DEMAND:
return y == FacePersistency::FACE_PERSISTENCY_PERSISTENT ||
y == FacePersistency::FACE_PERSISTENCY_PERMANENT;
case FacePersistency::FACE_PERSISTENCY_PERSISTENT:
return y == FacePersistency::FACE_PERSISTENCY_PERMANENT;
case FacePersistency::FACE_PERSISTENCY_PERMANENT:
return false;
}
return static_cast(x) < static_cast(y);
}
void
FaceModule::create(ExecuteContext& ctx)
{
auto remoteUri = ctx.args.get("remote");
auto localUri = ctx.args.getOptional("local");
auto persistency = ctx.args.get("persistency", FacePersistency::FACE_PERSISTENCY_PERSISTENT);
auto lpReliability = ctx.args.getTribool("reliability");
auto congestionMarking = ctx.args.getTribool("congestion-marking");
auto baseCongestionMarkingIntervalMs = ctx.args.getOptional("congestion-marking-interval");
auto defaultCongestionThreshold = ctx.args.getOptional("default-congestion-threshold");
auto mtuArg = ctx.args.getOptional("mtu");
// MTU is nominally a uint64_t, but can be the string value 'auto' to unset an override MTU
std::optional mtu;
if (mtuArg == "auto") {
mtu = std::numeric_limits::max();
}
else if (mtuArg) {
// boost::lexical_cast will accept negative numbers
int64_t v = -1;
if (!boost::conversion::try_lexical_convert(*mtuArg, v) || v < 0) {
ctx.exitCode = 2;
ctx.err << "MTU must either be a non-negative integer or 'auto'\n";
return;
}
mtu = static_cast(v);
}
std::optional canonicalRemote;
std::optional canonicalLocal;
auto updateFace = [&] (ControlParameters respParams, ControlParameters resp) {
// faces/update response does not have FaceUris, copy from faces/create response
resp.setLocalUri(respParams.getLocalUri())
.setUri(respParams.getUri());
printSuccess(ctx.out, "face-updated", resp);
};
auto handle409 = [&] (const ControlResponse& resp) {
ControlParameters respParams(resp.getBody());
if (respParams.getUri() != canonicalRemote->toString()) {
// we are conflicting with a different face, which is a general error
return false;
}
bool isChangingParams = false;
ControlParameters params;
params.setFaceId(respParams.getFaceId());
if (mtu && (!respParams.hasMtu() || respParams.getMtu() != *mtu)) {
isChangingParams = true;
params.setMtu(*mtu);
}
if (persistencyLessThan(respParams.getFacePersistency(), persistency)) {
isChangingParams = true;
params.setFacePersistency(persistency);
}
if (!boost::logic::indeterminate(lpReliability) &&
lpReliability != respParams.getFlagBit(ndn::nfd::BIT_LP_RELIABILITY_ENABLED)) {
isChangingParams = true;
params.setFlagBit(ndn::nfd::BIT_LP_RELIABILITY_ENABLED, bool(lpReliability));
}
if (!boost::logic::indeterminate(congestionMarking) &&
congestionMarking != respParams.getFlagBit(ndn::nfd::BIT_CONGESTION_MARKING_ENABLED)) {
isChangingParams = true;
params.setFlagBit(ndn::nfd::BIT_CONGESTION_MARKING_ENABLED, bool(congestionMarking));
}
if (baseCongestionMarkingIntervalMs) {
isChangingParams = true;
params.setBaseCongestionMarkingInterval(time::milliseconds(*baseCongestionMarkingIntervalMs));
}
if (defaultCongestionThreshold) {
isChangingParams = true;
params.setDefaultCongestionThreshold(*defaultCongestionThreshold);
}
if (isChangingParams) {
ctx.controller.start(
params,
[=, &updateFace] (const auto& cp) { updateFace(respParams, cp); },
ctx.makeCommandFailureHandler("updating face"),
ctx.makeCommandOptions());
}
else {
// don't do anything
printSuccess(ctx.out, "face-exists", respParams);
}
return true;
};
auto doCreateFace = [&] {
ControlParameters params;
params.setUri(canonicalRemote->toString());
if (canonicalLocal) {
params.setLocalUri(canonicalLocal->toString());
}
params.setFacePersistency(persistency);
if (!boost::logic::indeterminate(lpReliability)) {
params.setFlagBit(ndn::nfd::BIT_LP_RELIABILITY_ENABLED, bool(lpReliability));
}
if (!boost::logic::indeterminate(congestionMarking)) {
params.setFlagBit(ndn::nfd::BIT_CONGESTION_MARKING_ENABLED, bool(congestionMarking));
}
if (baseCongestionMarkingIntervalMs) {
params.setBaseCongestionMarkingInterval(time::milliseconds(*baseCongestionMarkingIntervalMs));
}
if (defaultCongestionThreshold) {
params.setDefaultCongestionThreshold(*defaultCongestionThreshold);
}
if (mtu) {
params.setMtu(*mtu);
}
ctx.controller.start(
params,
[&] (const ControlParameters& resp) {
printSuccess(ctx.out, "face-created", resp);
},
[&] (const ControlResponse& resp) {
if (resp.getCode() == 409 && handle409(resp)) {
return;
}
ctx.makeCommandFailureHandler("creating face")(resp); // invoke general error handler
},
ctx.makeCommandOptions());
};
std::string error;
std::tie(canonicalRemote, error) = canonize(ctx, remoteUri);
if (canonicalRemote) {
// RemoteUri canonization successful
if (localUri) {
std::tie(canonicalLocal, error) = canonize(ctx, *localUri);
if (canonicalLocal) {
// LocalUri canonization successful
doCreateFace();
}
else {
// LocalUri canonization failure
auto canonizationError = canonizeErrorHelper(*localUri, error, "local FaceUri");
ctx.exitCode = static_cast(canonizationError.first);
ctx.err << canonizationError.second << '\n';
}
}
else {
doCreateFace();
}
}
else {
// RemoteUri canonization failure
auto canonizationError = canonizeErrorHelper(remoteUri, error, "remote FaceUri");
ctx.exitCode = static_cast(canonizationError.first);
ctx.err << canonizationError.second << '\n';
}
ctx.face.processEvents();
}
void
FaceModule::destroy(ExecuteContext& ctx)
{
FindFace findFace(ctx);
FindFace::Code res = findFace.execute(ctx.args.at("face"));
ctx.exitCode = static_cast(res);
switch (res) {
case FindFace::Code::OK:
break;
case FindFace::Code::ERROR:
case FindFace::Code::CANONIZE_ERROR:
case FindFace::Code::NOT_FOUND:
ctx.err << findFace.getErrorReason() << '\n';
return;
case FindFace::Code::AMBIGUOUS:
ctx.err << "Multiple faces match specified remote FaceUri. Re-run the command with a FaceId:";
findFace.printDisambiguation(ctx.err, FindFace::DisambiguationStyle::LOCAL_URI);
ctx.err << '\n';
return;
default:
BOOST_ASSERT_MSG(false, "unexpected FindFace result");
return;
}
const FaceStatus& face = findFace.getFaceStatus();
ctx.controller.start(
ControlParameters().setFaceId(face.getFaceId()),
[&] (const ControlParameters& resp) {
// We can't use printSuccess because some face attributes come from FaceStatus not ControlResponse
ctx.out << "face-destroyed ";
text::ItemAttributes ia;
ctx.out << ia("id") << face.getFaceId()
<< ia("local") << face.getLocalUri()
<< ia("remote") << face.getRemoteUri()
<< ia("persistency") << face.getFacePersistency();
printFaceParams(ctx.out, ia, resp);
},
ctx.makeCommandFailureHandler("destroying face"),
ctx.makeCommandOptions());
ctx.face.processEvents();
}
void
FaceModule::fetchStatus(ndn::nfd::Controller& controller,
const std::function& onSuccess,
const ndn::nfd::DatasetFailureCallback& onFailure,
const CommandOptions& options)
{
controller.fetch(
[this, onSuccess] (const auto& result) {
m_status = result;
onSuccess();
},
onFailure, options);
}
void
FaceModule::formatStatusXml(std::ostream& os) const
{
os << "";
for (const FaceStatus& item : m_status) {
this->formatItemXml(os, item);
}
os << "";
}
void
FaceModule::formatItemXml(std::ostream& os, const FaceStatus& item) const
{
os << "";
os << "" << item.getFaceId() << "";
os << "" << xml::Text{item.getRemoteUri()} << "";
os << "" << xml::Text{item.getLocalUri()} << "";
if (item.hasExpirationPeriod()) {
os << "" << xml::formatDuration(item.getExpirationPeriod())
<< "";
}
os << "" << item.getFaceScope() << "";
os << "" << item.getFacePersistency() << "";
os << "" << item.getLinkType() << "";
if (!item.hasBaseCongestionMarkingInterval() && !item.hasDefaultCongestionThreshold()) {
os << "";
}
else {
os << "";
if (item.hasBaseCongestionMarkingInterval()) {
os << "" << xml::formatDuration(item.getBaseCongestionMarkingInterval())
<< "";
}
if (item.hasDefaultCongestionThreshold()) {
os << "" << item.getDefaultCongestionThreshold() << "";
}
os << "";
}
if (item.hasMtu()) {
os << "" << item.getMtu() << "";
}
if (item.getFlags() == 0) {
os << "";
}
else {
os << "";
os << xml::Flag{"localFieldsEnabled", item.getFlagBit(ndn::nfd::BIT_LOCAL_FIELDS_ENABLED)};
os << xml::Flag{"lpReliabilityEnabled", item.getFlagBit(ndn::nfd::BIT_LP_RELIABILITY_ENABLED)};
os << xml::Flag{"congestionMarkingEnabled", item.getFlagBit(ndn::nfd::BIT_CONGESTION_MARKING_ENABLED)};
os << "";
}
os << "";
os << ""
<< "" << item.getNInInterests() << ""
<< "" << item.getNInData() << ""
<< "" << item.getNInNacks() << ""
<< "";
os << ""
<< "" << item.getNOutInterests() << ""
<< "" << item.getNOutData() << ""
<< "" << item.getNOutNacks() << ""
<< "";
os << "";
os << "";
os << "" << item.getNInBytes() << "";
os << "" << item.getNOutBytes() << "";
os << "";
os << "";
}
void
FaceModule::formatStatusText(std::ostream& os) const
{
os << "Faces:\n";
for (const FaceStatus& item : m_status) {
os << " ";
formatItemText(os, item, false);
os << '\n';
}
}
void
FaceModule::formatItemText(std::ostream& os, const FaceStatus& item, bool wantMultiLine)
{
text::ItemAttributes ia(wantMultiLine, 10);
os << ia("faceid") << item.getFaceId();
os << ia("remote") << item.getRemoteUri();
os << ia("local") << item.getLocalUri();
if (item.hasExpirationPeriod()) {
os << ia("expires") << text::formatDuration(item.getExpirationPeriod());
}
if (item.hasBaseCongestionMarkingInterval() || item.hasDefaultCongestionThreshold()) {
os << ia("congestion") << "{";
text::Separator congestionSep("", " ");
if (item.hasBaseCongestionMarkingInterval()) {
os << congestionSep << "base-marking-interval="
<< text::formatDuration(item.getBaseCongestionMarkingInterval());
}
if (item.hasDefaultCongestionThreshold()) {
os << congestionSep << "default-threshold=" << item.getDefaultCongestionThreshold() << "B";
}
os << "}";
}
if (item.hasMtu()) {
os << ia("mtu") << item.getMtu();
}
os << ia("counters")
<< "{in={"
<< item.getNInInterests() << "i "
<< item.getNInData() << "d "
<< item.getNInNacks() << "n "
<< item.getNInBytes() << "B} "
<< "out={"
<< item.getNOutInterests() << "i "
<< item.getNOutData() << "d "
<< item.getNOutNacks() << "n "
<< item.getNOutBytes() << "B}}";
os << ia("flags") << '{';
text::Separator flagSep("", " ");
os << flagSep << item.getFaceScope();
os << flagSep << item.getFacePersistency();
os << flagSep << item.getLinkType();
if (item.getFlagBit(ndn::nfd::BIT_LOCAL_FIELDS_ENABLED)) {
os << flagSep << "local-fields";
}
if (item.getFlagBit(ndn::nfd::BIT_LP_RELIABILITY_ENABLED)) {
os << flagSep << "lp-reliability";
}
if (item.getFlagBit(ndn::nfd::BIT_CONGESTION_MARKING_ENABLED)) {
os << flagSep << "congestion-marking";
}
os << '}';
os << ia.end();
}
void
FaceModule::printSuccess(std::ostream& os,
const std::string& actionSummary,
const ControlParameters& resp)
{
text::ItemAttributes ia;
os << actionSummary << ' '
<< ia("id") << resp.getFaceId()
<< ia("local") << resp.getLocalUri()
<< ia("remote") << resp.getUri()
<< ia("persistency") << resp.getFacePersistency();
printFaceParams(os, ia, resp);
}
void
FaceModule::printFaceParams(std::ostream& os, text::ItemAttributes& ia, const ControlParameters& resp)
{
os << ia("reliability") << text::OnOff{resp.getFlagBit(ndn::nfd::BIT_LP_RELIABILITY_ENABLED)}
<< ia("congestion-marking") << text::OnOff{resp.getFlagBit(ndn::nfd::BIT_CONGESTION_MARKING_ENABLED)};
if (resp.hasBaseCongestionMarkingInterval()) {
os << ia("congestion-marking-interval")
<< text::formatDuration(resp.getBaseCongestionMarkingInterval());
}
if (resp.hasDefaultCongestionThreshold()) {
os << ia("default-congestion-threshold") << resp.getDefaultCongestionThreshold() << "B";
}
if (resp.hasMtu()) {
os << ia("mtu") << resp.getMtu();
}
os << '\n';
}
} // namespace nfd::tools::nfdc