conf-parameter.hpp

Go to the documentation of this file.

/* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
/*
 * Copyright (c) 2014-2024,  The University of Memphis,
 *                           Regents of the University of California,
 *                           Arizona Board of Regents.
 *
 * This file is part of NLSR (Named-data Link State Routing).
 * See AUTHORS.md for complete list of NLSR authors and contributors.
 *
 * NLSR 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.
 *
 * NLSR 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
 * NLSR, e.g., in COPYING.md file.  If not, see <http://www.gnu.org/licenses/>.
 */
 
#ifndef NLSR_CONF_PARAMETER_HPP
#define NLSR_CONF_PARAMETER_HPP
 
#include "common.hpp"
#include "test-access-control.hpp"
#include "adjacency-list.hpp"
#include "name-prefix-list.hpp"
 
#include <ndn-cxx/face.hpp>
#include <ndn-cxx/security/validator-config.hpp>
#include <ndn-cxx/security/certificate-fetcher-direct-fetch.hpp>
 
#include <optional>
 
namespace nlsr {
 
enum class SyncProtocol {
  CHRONOSYNC,
  PSYNC,
  SVS,
};
 
enum {
  LSA_REFRESH_TIME_MIN = 240,
  LSA_REFRESH_TIME_DEFAULT = 1800,
  LSA_REFRESH_TIME_MAX = 7200
};
 
enum {
  LSA_INTEREST_LIFETIME_MIN = 1,
  LSA_INTEREST_LIFETIME_DEFAULT = 4,
  LSA_INTEREST_LIFETIME_MAX = 60
};
 
enum {
  ADJ_LSA_BUILD_INTERVAL_MIN = 5,
  ADJ_LSA_BUILD_INTERVAL_DEFAULT = 10,
  ADJ_LSA_BUILD_INTERVAL_MAX = 30
};
 
enum {
  ROUTING_CALC_INTERVAL_MIN = 0,
  ROUTING_CALC_INTERVAL_DEFAULT = 15,
  ROUTING_CALC_INTERVAL_MAX = 15
};
 
 
enum {
  FACE_DATASET_FETCH_TRIES_MIN = 1,
  FACE_DATASET_FETCH_TRIES_MAX = 10,
  FACE_DATASET_FETCH_TRIES_DEFAULT = 3
};
 
enum {
  FACE_DATASET_FETCH_INTERVAL_MIN = 1800,
  FACE_DATASET_FETCH_INTERVAL_MAX = 5400,
  FACE_DATASET_FETCH_INTERVAL_DEFAULT = 3600
};
 
enum {
  HELLO_RETRIES_MIN = 1,
  HELLO_RETRIES_DEFAULT = 3,
  HELLO_RETRIES_MAX = 15
};
 
enum {
  HELLO_TIMEOUT_MIN = 1,
  HELLO_TIMEOUT_DEFAULT = 1,
  HELLO_TIMEOUT_MAX = 15
};
 
enum {
  HELLO_INTERVAL_MIN = 30,
  HELLO_INTERVAL_DEFAULT = 60,
  HELLO_INTERVAL_MAX =90
};
 
enum {
  MAX_FACES_PER_PREFIX_MIN = 0,
  MAX_FACES_PER_PREFIX_DEFAULT = 0,
  MAX_FACES_PER_PREFIX_MAX = 60
};
 
enum HyperbolicState {
  HYPERBOLIC_STATE_OFF = 0,
  HYPERBOLIC_STATE_ON = 1,
  HYPERBOLIC_STATE_DRY_RUN = 2,
  HYPERBOLIC_STATE_DEFAULT = 0
};
 
enum {
  SYNC_INTEREST_LIFETIME_MIN = 1000,
  SYNC_INTEREST_LIFETIME_DEFAULT = 60000,
  SYNC_INTEREST_LIFETIME_MAX = 120000,
};
 
class ConfParameter
{
public:
  ConfParameter(ndn::Face& face, ndn::KeyChain& keyChain,
                const std::string& confFileName = "nlsr.conf");
 
  const std::string&
  getConfFileName()
  {
    return m_confFileName;
  }
 
  void
  setNetwork(const ndn::Name& networkName);
 
  const ndn::Name&
  getNetwork() const
  {
    return m_network;
  }
 
  void
  setRouterName(const ndn::Name& routerName)
  {
    m_routerName = routerName;
  }
 
  const ndn::Name&
  getRouterName() const
  {
    return m_routerName;
  }
 
  void
  setSiteName(const ndn::Name& siteName)
  {
    m_siteName = siteName;
  }
 
  const ndn::Name&
  getSiteName() const
  {
    return m_siteName;
  }
 
  void
  buildRouterAndSyncUserPrefix()
  {
    m_routerPrefix = m_network;
    m_routerPrefix.append(m_siteName);
    m_routerPrefix.append(m_routerName);
 
    m_syncUserPrefix = m_lsaPrefix;
    m_syncUserPrefix.append(m_siteName);
    m_syncUserPrefix.append(m_routerName);
  }
 
  const ndn::Name&
  getRouterPrefix() const
  {
    return m_routerPrefix;
  }
 
  const ndn::Name&
  getSyncUserPrefix() const
  {
    return m_syncUserPrefix;
  }
 
  const ndn::Name&
  getSyncPrefix() const
  {
    return m_syncPrefix;
  }
 
  const ndn::Name&
  getLsaPrefix() const
  {
    return m_lsaPrefix;
  }
 
  void
  setLsaRefreshTime(uint32_t lrt)
  {
    m_lsaRefreshTime = lrt;
  }
 
  SyncProtocol
  getSyncProtocol() const
  {
    return m_syncProtocol;
  }
 
  void
  setSyncProtocol(SyncProtocol syncProtocol)
  {
    m_syncProtocol = syncProtocol;
  }
 
  uint32_t
  getLsaRefreshTime() const
  {
    return m_lsaRefreshTime;
  }
 
  void
  setLsaInterestLifetime(const ndn::time::seconds& lifetime)
  {
    m_lsaInterestLifetime = lifetime;
  }
 
  const ndn::time::seconds&
  getLsaInterestLifetime() const
  {
    return m_lsaInterestLifetime;
  }
 
  void
  setAdjLsaBuildInterval(uint32_t interval)
  {
    m_adjLsaBuildInterval = interval;
  }
 
  uint32_t
  getAdjLsaBuildInterval() const
  {
    return m_adjLsaBuildInterval;
  }
 
  void
  setRoutingCalcInterval(uint32_t interval)
  {
    m_routingCalcInterval = interval;
  }
 
  uint32_t
  getRoutingCalcInterval() const
  {
    return m_routingCalcInterval;
  }
 
  void
  setRouterDeadInterval(uint32_t rdt)
  {
    m_routerDeadInterval = rdt;
  }
 
  uint32_t
  getRouterDeadInterval() const
  {
    return m_routerDeadInterval;
  }
 
  void
  setFaceDatasetFetchTries(uint32_t count)
  {
    m_faceDatasetFetchTries = count;
  }
 
  uint32_t
  getFaceDatasetFetchTries() const
  {
    return m_faceDatasetFetchTries;
  }
 
  void
  setFaceDatasetFetchInterval(uint32_t interval)
  {
    m_faceDatasetFetchInterval = ndn::time::seconds(interval);
  }
 
  const ndn::time::seconds
  getFaceDatasetFetchInterval() const
  {
    return m_faceDatasetFetchInterval;
  }
 
  void
  setInterestRetryNumber(uint32_t irn)
  {
    m_interestRetryNumber = irn;
  }
 
  uint32_t
  getInterestRetryNumber() const
  {
    return m_interestRetryNumber;
  }
 
  void
  setInterestResendTime(uint32_t irt)
  {
    m_interestResendTime = irt;
  }
 
  uint32_t
  getInterestResendTime() const
  {
    return m_interestResendTime;
  }
 
  uint32_t
  getInfoInterestInterval() const
  {
    return m_infoInterestInterval;
  }
 
  void
  setInfoInterestInterval(uint32_t iii)
  {
    m_infoInterestInterval = iii;
  }
 
  void
  setHyperbolicState(HyperbolicState ihc)
  {
    m_hyperbolicState = ihc;
  }
 
  HyperbolicState
  getHyperbolicState() const
  {
    return m_hyperbolicState;
  }
 
  bool
  setCorR(double cr)
  {
    if ( cr >= 0 ) {
     m_corR = cr;
     return true;
    }
    return false;
  }
 
  double
  getCorR() const
  {
    return m_corR;
  }
 
  void
  setCorTheta(const std::vector<double>& ct)
  {
    m_corTheta = ct;
  }
 
  std::vector<double>
  getCorTheta() const
  {
    return m_corTheta;
  }
 
  void
  setMaxFacesPerPrefix(uint32_t mfpp)
  {
    m_maxFacesPerPrefix = mfpp;
  }
 
  uint32_t
  getMaxFacesPerPrefix() const
  {
    return m_maxFacesPerPrefix;
  }
 
  void
  setStateFileDir(const std::string& ssfd)
  {
    m_stateFileDir = ssfd;
  }
 
  const std::string&
  getStateFileDir() const
  {
    return m_stateFileDir;
  }
 
  void
  setConfFileNameDynamic(const std::string& confFileDynamic)
  {
    m_confFileNameDynamic = confFileDynamic;
  }
 
  const std::string&
  getConfFileNameDynamic() const
  {
    return m_confFileNameDynamic;
  }
 
  void
  setSyncInterestLifetime(uint32_t syncInterestLifetime)
  {
    m_syncInterestLifetime = ndn::time::milliseconds(syncInterestLifetime);
  }
 
  const ndn::time::milliseconds&
  getSyncInterestLifetime() const
  {
    return m_syncInterestLifetime;
  }
 
  AdjacencyList&
  getAdjacencyList()
  {
    return m_adjl;
  }
 
  NamePrefixList&
  getNamePrefixList()
  {
    return m_npl;
  }
 
  ndn::security::ValidatorConfig&
  getValidator()
  {
    return m_validator;
  }
 
  ndn::security::ValidatorConfig&
  getPrefixUpdateValidator()
  {
    return m_prefixUpdateValidator;
  }
 
  const ndn::security::SigningInfo&
  getSigningInfo() const
  {
    return m_signingInfo;
  }
 
  void
  addCertPath(const std::string& certPath)
  {
    m_certs.insert(certPath);
  }
 
  const std::unordered_set<std::string>&
  getIdCerts() const
  {
    return m_certs;
  }
 
  const ndn::KeyChain&
  getKeyChain() const
  {
    return m_keyChain;
  }
 
  std::optional<ndn::security::Certificate>
  initializeKey();
 
  void
  loadCertToValidator(const ndn::security::Certificate& cert);
 
  void
  writeLog();
 
PUBLIC_WITH_TESTS_ELSE_PRIVATE:
  std::string m_confFileName;
  std::string m_confFileNameDynamic;
 
private:
  ndn::Name m_routerName;
  ndn::Name m_siteName;
  ndn::Name m_network;
 
  ndn::Name m_routerPrefix;
  ndn::Name m_syncUserPrefix;
 
  ndn::Name m_syncPrefix;
  ndn::Name m_lsaPrefix;
 
  uint32_t  m_lsaRefreshTime;
 
  uint32_t m_adjLsaBuildInterval;
  uint32_t m_routingCalcInterval;
 
  uint32_t m_faceDatasetFetchTries;
  ndn::time::seconds m_faceDatasetFetchInterval;
 
  ndn::time::seconds m_lsaInterestLifetime;
  uint32_t  m_routerDeadInterval;
 
  uint32_t m_interestRetryNumber;
  uint32_t m_interestResendTime;
 
  uint32_t m_infoInterestInterval;
 
  HyperbolicState m_hyperbolicState;
  double m_corR;
  std::vector<double> m_corTheta;
 
  uint32_t m_maxFacesPerPrefix;
 
  std::string m_stateFileDir;
 
  ndn::time::milliseconds m_syncInterestLifetime;
 
  SyncProtocol m_syncProtocol = SyncProtocol::PSYNC;
 
PUBLIC_WITH_TESTS_ELSE_PRIVATE:
  // must be incremented when breaking changes are made to sync
  static constexpr uint64_t SYNC_VERSION = 12;
 
  AdjacencyList m_adjl;
  NamePrefixList m_npl;
  ndn::security::ValidatorConfig m_validator;
  ndn::security::ValidatorConfig m_prefixUpdateValidator;
  ndn::security::SigningInfo m_signingInfo;
  std::unordered_set<std::string> m_certs;
  ndn::KeyChain& m_keyChain;
};
 
} // namespace nlsr
 
#endif // NLSR_CONF_PARAMETER_HPP