examples: Adding new example to illustrate use of L2Tracer to trace aggregate packet drop rate on nodes
diff --git a/docs/source/_static/l2-rate-tracer.png b/docs/source/_static/l2-rate-tracer.png
new file mode 100644
index 0000000..c930bd4
--- /dev/null
+++ b/docs/source/_static/l2-rate-tracer.png
Binary files differ
diff --git a/docs/source/_static/topo-tree-25-node.png b/docs/source/_static/topo-tree-25-node.png
new file mode 100644
index 0000000..ba39687
--- /dev/null
+++ b/docs/source/_static/topo-tree-25-node.png
Binary files differ
diff --git a/examples/ndn-tree-with-l2tracer.cc b/examples/ndn-tree-with-l2tracer.cc
new file mode 100644
index 0000000..d3e262e
--- /dev/null
+++ b/examples/ndn-tree-with-l2tracer.cc
@@ -0,0 +1,145 @@
+// ndn-simple-withl2tracer.cc
+
+#include "ns3/core-module.h"
+#include "ns3/network-module.h"
+#include "ns3/ndnSIM-module.h"
+
+// for ndn::L2RateTracer
+#include <ns3/ndnSIM/utils/tracers/l2-rate-tracer.h>
+
+using namespace ns3;
+
+int
+main (int argc, char *argv[])
+{
+ CommandLine cmd;
+ cmd.Parse (argc, argv);
+
+ AnnotatedTopologyReader topologyReader ("", 10);
+ topologyReader.SetFileName ("src/ndnSIM/examples/topologies/topo-tree-25-node.txt");
+ topologyReader.Read ();
+
+ /****************************************************************************/
+ // Install CCNx stack on all nodes
+ ndn::StackHelper ccnxHelper;
+ ccnxHelper.SetContentStore ("ns3::ndn::cs::Lru", "MaxSize", "1000");
+ ccnxHelper.SetForwardingStrategy ("ns3::ndn::fw::BestRoute");
+ ccnxHelper.InstallAll ();
+ /****************************************************************************/
+ // Installing global routing interface on all nodes
+ ndn::GlobalRoutingHelper ccnxGlobalRoutingHelper;
+ ccnxGlobalRoutingHelper.InstallAll ();
+ /****************************************************************************/
+ // Getting containers for the consumer/producer
+ Ptr<Node> consumer1 = Names::Find<Node> ("Src1");
+ Ptr<Node> consumer2 = Names::Find<Node> ("Src2");
+ Ptr<Node> consumer3 = Names::Find<Node> ("Src3");
+ Ptr<Node> consumer4 = Names::Find<Node> ("Src4");
+ Ptr<Node> consumer5 = Names::Find<Node> ("Src5");
+ Ptr<Node> consumer6 = Names::Find<Node> ("Src6");
+ Ptr<Node> consumer7 = Names::Find<Node> ("Src7");
+ Ptr<Node> consumer8 = Names::Find<Node> ("Src8");
+ Ptr<Node> consumer9 = Names::Find<Node> ("Src9");
+
+ Ptr<Node> producer1 = Names::Find<Node> ("Dst1");
+ Ptr<Node> producer2 = Names::Find<Node> ("Dst2");
+ Ptr<Node> producer3 = Names::Find<Node> ("Dst3");
+ Ptr<Node> producer4 = Names::Find<Node> ("Dst4");
+ Ptr<Node> producer5 = Names::Find<Node> ("Dst5");
+ Ptr<Node> producer6 = Names::Find<Node> ("Dst6");
+ Ptr<Node> producer7 = Names::Find<Node> ("Dst7");
+ Ptr<Node> producer8 = Names::Find<Node> ("Dst8");
+ Ptr<Node> producer9 = Names::Find<Node> ("Dst9");
+ /****************************************************************************/
+ ndn::AppHelper consumerHelper ("ns3::ndn::ConsumerCbr");
+ consumerHelper.SetAttribute ("Frequency", StringValue ("1000"));//interests per Second
+ consumerHelper.SetAttribute ("Randomize", StringValue ("uniform"));
+ /****************************************************************************/
+ // on the first to ninth consumer node install a Consumer application
+ // that will express interests in /dst1 to /dst9 namespace
+ consumerHelper.SetPrefix ("/dst9");
+ consumerHelper.Install (consumer1);
+
+ consumerHelper.SetPrefix ("/dst8");
+ consumerHelper.Install (consumer2);
+
+ consumerHelper.SetPrefix ("/dst7");
+ consumerHelper.Install (consumer3);
+
+ consumerHelper.SetPrefix ("/dst6");
+ consumerHelper.Install (consumer4);
+
+ consumerHelper.SetPrefix ("/dst5");
+ consumerHelper.Install (consumer5);
+
+ consumerHelper.SetPrefix ("/dst4");
+ consumerHelper.Install (consumer6);
+
+ consumerHelper.SetPrefix ("/dst3");
+ consumerHelper.Install (consumer7);
+
+ consumerHelper.SetPrefix ("/dst2");
+ consumerHelper.Install (consumer8);
+
+ consumerHelper.SetPrefix ("/dst1");
+ consumerHelper.Install (consumer9);
+
+ /****************************************************************************/
+ ndn::AppHelper producerHelper ("ns3::ndn::Producer");
+ producerHelper.SetAttribute ("PayloadSize", StringValue("1024"));
+ /****************************************************************************/
+ // Register /dst1 to /dst9 prefix with global routing controller and
+ // install producer that will satisfy Interests in /dst1 to /dst9 namespace
+ ccnxGlobalRoutingHelper.AddOrigins ("/dst1", producer1);
+ producerHelper.SetPrefix ("/dst1");
+ producerHelper.Install (producer1);
+
+ ccnxGlobalRoutingHelper.AddOrigins ("/dst2", producer2);
+ producerHelper.SetPrefix ("/dst2");
+ producerHelper.Install (producer2);
+
+ ccnxGlobalRoutingHelper.AddOrigins ("/dst3", producer3);
+ producerHelper.SetPrefix ("/dst3");
+ producerHelper.Install (producer3);
+
+ ccnxGlobalRoutingHelper.AddOrigins ("/dst4", producer4);
+ producerHelper.SetPrefix ("/dst4");
+ producerHelper.Install (producer4);
+
+ ccnxGlobalRoutingHelper.AddOrigins ("/dst5", producer5);
+ producerHelper.SetPrefix ("/dst5");
+ producerHelper.Install (producer5);
+
+ ccnxGlobalRoutingHelper.AddOrigins ("/dst6", producer6);
+ producerHelper.SetPrefix ("/dst6");
+ producerHelper.Install (producer6);
+
+ ccnxGlobalRoutingHelper.AddOrigins ("/dst7", producer7);
+ producerHelper.SetPrefix ("/dst7");
+ producerHelper.Install (producer7);
+
+ ccnxGlobalRoutingHelper.AddOrigins ("/dst8", producer8);
+ producerHelper.SetPrefix ("/dst8");
+ producerHelper.Install (producer8);
+
+ ccnxGlobalRoutingHelper.AddOrigins ("/dst9", producer9);
+ producerHelper.SetPrefix ("/dst9");
+ producerHelper.Install (producer9);
+
+ /*****************************************************************************/
+ // Calculate and install FIBs
+ ccnxGlobalRoutingHelper.CalculateRoutes ();
+
+ Simulator::Stop (Seconds (10.0));
+
+ /****************************************************************************/
+ //Tracer:
+
+ boost::tuple< boost::shared_ptr<std::ostream>, std::list<Ptr<L2RateTracer> > >
+ l2tracers = L2RateTracer::InstallAll ("drop-trace.txt", Seconds (0.5));
+
+ Simulator::Run ();
+ Simulator::Destroy ();
+
+ return 0;
+}
diff --git a/examples/topologies/topo-tree-25-node.txt b/examples/topologies/topo-tree-25-node.txt
new file mode 100644
index 0000000..7b328f4
--- /dev/null
+++ b/examples/topologies/topo-tree-25-node.txt
@@ -0,0 +1,58 @@
+#Topology.Scenario3.txt
+
+router
+
+# node comment yPos xPos
+Rtr1 NA 3 9
+Rtr2 NA 9 9
+Rtr3 NA 15 9
+Rtr7 NA 9 15
+Rtr4 NA 3 21
+Rtr5 NA 9 21
+Rtr6 NA 15 21
+Src1 NA 1 3
+Src2 NA 3 3
+Src3 NA 5 3
+Src4 NA 7 3
+Src5 NA 9 3
+Src6 NA 11 3
+Src7 NA 13 3
+Src8 NA 15 3
+Src9 NA 17 3
+Dst1 NA 1 27
+Dst2 NA 3 27
+Dst3 NA 5 27
+Dst4 NA 7 27
+Dst5 NA 9 27
+Dst6 NA 11 27
+Dst7 NA 13 27
+Dst8 NA 15 27
+Dst9 NA 17 27
+
+link
+# srcNode dstNode bandwidth metric delay queue
+Src1 Rtr1 100Mbps 1 10ms 10
+Src2 Rtr1 100Mbps 1 10ms 10
+Src3 Rtr1 100Mbps 1 10ms 10
+Src4 Rtr2 100Mbps 1 10ms 10
+Src5 Rtr2 100Mbps 1 10ms 10
+Src6 Rtr2 100Mbps 1 10ms 10
+Src7 Rtr3 100Mbps 1 10ms 10
+Src8 Rtr3 100Mbps 1 10ms 10
+Src9 Rtr3 100Mbps 1 10ms 10
+Rtr1 Rtr7 10Mbps 1 10ms 10
+Rtr2 Rtr7 10Mbps 1 10ms 10
+Rtr3 Rtr7 10Mbps 1 10ms 10
+Rtr4 Rtr7 10Mbps 1 10ms 10
+Rtr5 Rtr7 10Mbps 1 10ms 10
+Rtr6 Rtr7 10Mbps 1 10ms 10
+Dst1 Rtr4 100Mbps 1 10ms 10
+Dst2 Rtr4 100Mbps 1 10ms 10
+Dst3 Rtr4 100Mbps 1 10ms 10
+Dst4 Rtr5 100Mbps 1 10ms 10
+Dst5 Rtr5 100Mbps 1 10ms 10
+Dst6 Rtr5 100Mbps 1 10ms 10
+Dst7 Rtr6 100Mbps 1 10ms 10
+Dst8 Rtr6 100Mbps 1 10ms 10
+Dst9 Rtr6 100Mbps 1 10ms 10
+