ndnSIM Release Notes

This file contains ndnSIM release notes.

All of the ndnSIM documentation is accessible from the ndnSIM website.

Release 2.2 (Changes since release 2.1)

Release date: November 11, 2016


  • The submodules of NFD and ndn-cxx have been both upgraded to version 0.4.1 (Issue #3560).

    Features of NFD:

    • Face system is refactored.
    • Data Retrieval using full names is fixed.
    • Allow setting CS capacity to 0.
    • LinkService provides an “adaptation” layer to translate between NDN packets and data blocks communicated through Transport.
    • Face provides combines Transport and LinkServices, providing high-level interface to work with Interest/Data/Nack packets inside NFD.
    • Networking NACK in pipelines and best-route strategy.
    • Refactored implementation of NFD management.
    • Interest forwarding processes Link included in interest packets.

    Features of ndn-cxx:

    • LocalControlHeader for special signaling between application and NFD has been replaced with NDNLPv2 signaling.
    • NDNLPv2 Network NACK support in Face abstraction.
    • New API in Face class to remove all pending Interests.


    In order to retrieve the marked versions of ndn-cxx and NFD, use --recursive option to the git clone command or run git submodule update --init after clone, pull, or merge.

  • Replace NetDeviceFace with NetDeviceFaceLinkService and AppFace with AppFaceModel to match NFD’s v0.4+ Face model (Issue #3560).

    ndnSIM (for now) intentionally uses LinkService instead of Transport for optimization purposes and in order to preserve ns3::Packet Tags. This may be fixed in the future when there is a different mechanism to propagate ns3 Tags.


    This version of dnSIM does not include support for NDNLPv2 and, thus, cannot yet be used to simulate network-level NACKs across the simulated nodes. This will be addressed in the next release of ndnSIM.

  • ndnSIM no longer officially support Ubuntu Linux 12.04, as it now requires a more modern compiler version and dependent libraries.

New features

  • The NetDevice address is now represented as a LocalUri instance for NetDevice-based Faces (Issue #2665).

  • Enable configurability of NFD’s managers (Issue #3328).

    The managers of NFD can be enabled/disabled as specified in a simulation scenario.

Improvements and bug fixes

  • Bugfix in RandomPolicy for the “old-style” ContentStore implementation.

  • Updates of the ndnSIM 2 Technical Report

    Technical Report became up-to-date with the latest version of ndnSIM. Please see report’s change-log for more detailed information.

  • Updates of the ndnSIM documentation (Issue #3835)

    • Updated out-dated statements about NFD’s CS implementation (Issue #3827).
    • Added explanation about the limited support of NDNLPv2 and its implications.
    • Fixed description of the ConsumerBatches application.
    • Added homebrew instructions for dependency installation on OS X.
    • Added specification of ndn::CsTracer output format.

Release 2.1 (Changes since release 2.0)

Release date: September 4, 2015


New features

  • ndnSIM-specific version of ndn::Face (Issue #2370)

    The updated version of ndn::Face specially designed to allow writing simulation applications in the same way as real applications. It is also possible to directly use codebase of the existing applications to drive simulations, provided that the codebase meets or can be adjusted to meet the requirements listed in Simulating real NDN applications.

  • Full support for NFD’S RIB manager (Issue #2370)


    RIB manager support is currently available only for applications based on ndn-cxx. FibHelper::AddRoute() and FibHelper::RemoveRoute() used by ndn::Producer and ndn::GlobalRoutingHelper are currently interacting directly with NFD’s FIB manager. This issue will be resolved in the next release of ndnSIM (Issue #3121)

  • Tutorial and example on how to speed up simulations with MPI module of NS-3: http://ndnsim.net/2.0/parallel-simulations.html

  • Two new helpers to simplify writing basic simulation scenarios:

    • ScenarioHelper leverages C++11 constructs to write scenarios. Example:

      ScenarioHelper helper;
          {"1", "2"},
          {"2", "3"}
          {"1", "2", "/prefix", 1},
          {"2", "3", "/prefix", 1}
          {"1", "ns3::ndn::ConsumerCbr",
              {{"Prefix", "/prefix"}, {"Frequency", "1"}},
              "0s", "100s"},
          {"3", "ns3::ndn::Producer",
              {{"Prefix", "/prefix"}, {"PayloadSize", "1024"}},
              "0s", "100s"}
    • FactoryCallbackApp simplifies creation of basic apps without creating a separate class that is derived from ns3::Applications. Example:

      class SomeApp
        SomeApp(size_t initParameter);
      FactoryCallbackApp::Install(node, [] () -> shared_ptr<void> {
          return make_shared<SomeApp>(42);

Improvements and bug fixes

Release 2.0 (Changes since release 1.0)

Release date: January 13, 2015


ndnSIM 2.0 is a new release of NS-3 based Named Data Networking (NDN) simulator that went through extensive refactoring and rewriting. The key new features of the new version:

Note RIB Manager is not yet available in ndnSIM.

New Features

  • Integration with NFD codebase.
  • A realistic behavior is added to the simulations.
  • Forwarding plane extensions can be used in both ndnSIM simulations and real NFD deployment.
  • Per namespace forwarding strategies for different namespaces (one strategy per namespace).
  • New examples:
  • ndn-load-balancer
  • ndn-grid-multiple-strategies
  • ndn-different-strategy-per-prefix
  • Basic examples using python bindings: ndn-simple.py and ndn-grid.py
  • Use of the the full-featured NDN packet format.
  • Full-featured support for Interest selectors.
  • Full-featured crypto operations can be simulated (disabled by default).
  • FibHelper to manage FIB entries.
  • StrategyChoiceHelper to manage per-namespace forwarding strategy selection.


  • HopCount tracing now includes only one way network-level hop count (e.g., the number of physical links traversed by a packet). Previously, this tracing was round-trip and included applications hops.
  • Python bindings have changed and, due to limitations of pybindgen, currently cover a smaller subset of C++ code (Task #2341).
  • LinkControlHelper now uses ErrorRate to simulate link failure/recovery. Previously it was relying on Up/Down flag on NDN level.
  • The Face abstraction of NFD is now used.

Bug fixes

  • Fix processing files with customized LossRate or Queue model in AnnotatedTopologyReader Bug #2354.


  • PyNDN emulation
  • (temporarily) ApiFace. Will be replaced with emulation of ndn-cxx ndn::Face in future releases (Issue #2370).
  • (temporarily) UdpFace, TcpFace (Issue #2371).
  • Limits, LimitsWindow, LimitsRate.
  • PIT, FIB with “replacement” policies.
  • Old deprecated packet formats.