1#include "ns3/core-module.h"   //内核模块
 2#include "ns3/network-module.h"
 3#include "ns3/internet-module.h"
 4#include "ns3/point-to-point-module.h"   //p2p模块
 5#include "ns3/applications-module.h"   //应用程序
 6
 7using namespace ns3;   
 8/*命名空间，NS3工程是在一个叫做ns3的C++命名空间中实现的。这把所有与ns3相关的声明，集中在一个与全局命名空间相区别的命名空间中。
 9我们希望这样会给ns3与其他代码的集成带来好处。C++用“using”语句用来把ns-3namespace引入到当前的（全局的）作用域中。
10这个声明就是说，你不用为了使用ns-3的代码而必须在所有的ns-3代码前打上ns3::作用域操作符。*/
11
12NS_LOG_COMPONENT_DEFINE ("FirstScriptExample");   
13/*声明一个叫"FirstScriptExample"的日志组件，通过引用FirstScriptExample这个名字的操作，
14可以实现打开或者关闭控制台日志的输出。*/

1int
2main (int argc, char *argv[])  //主函数
3{ 
4//日志输出设定
5  Time::SetResolution (Time::NS);  //时间分辨率设定为纳秒（系统默认）
6  /*服务端输出和客户端输出的级别为INFO，是设置在日志里显示的信息种类的，
7  这个脚本是被内建在UdpEchoClientApplication和UdpEchoServerApplication两个应用中的*/
8  LogComponentEnable ("UdpEchoClientApplication", LOG_LEVEL_INFO);
9  LogComponentEnable ("UdpEchoServerApplication", LOG_LEVEL_INFO);

1//用NodeContainer类，创建两个节点
2  NodeContainer nodes;
3  nodes.Create (2);

1//构建p2p信道模型（就是点对点）
2
3  /*用到了拓扑辅助工具的helper类，在这个脚本中使用了PointToPointHelper
4  来配置和连接网络设备PointToPointNetDevice和信道PointToPointChannel对象*/
5  PointToPointHelper pointToPoint;   //产生一个对象pointToPoint
6  pointToPoint.SetDeviceAttribute ("DataRate", StringValue ("5Mbps"));   //用这个对象设置设备属性——数据速率为5Mbps
7  pointToPoint.SetChannelAttribute ("Delay", StringValue ("2ms"));    //用这个对象设置信道属性——时延为2ns

 1//用NetDeviceContainer类，创建网络设备
 2
 3  NetDeviceContainer devices;   
 4  devices = pointToPoint.Install (nodes);  
 5  /*在Install()方法内，以一个NodeContainer对象作为一个参数（nodes），一个NetDeviceContainer
 6  被创建了。对于在NodeContainer对象中的每一个节点（对于一个点到点链路必须明确有两个节点)，都将
 7      ①有一个PointToPointNetDevice被创建和保存在设备容器内；
 8      ②有一个PointToPointChannel对象被创建，两个PointToPointNetDevices与之连接。
 9  并且，当PointToPointHelper对象创建时，那些在helper中被预先设置的属性被用来初始化对象对应的属性值。
10  因为nodes是两个节点，所以这条语句的作用是：
11      ①用两个nodes生成两个NodeContainer对象，保存在设备容器devices内；
12      ②用两个nodes创建一个PointToPointChannel对象；
13      ③上面的两个PointToPointNetDevices与PointToPointChannel连接；
14	  ④把生成的devices安装到nodes结点上。*/

1//我们现在已经配置了节点和设备，但是我们还没有在节点上安装任何协议栈。下面两行代码完成这个任务
2
3  /*类InternetStackHelper是一个辅助安装网络协议栈的helper类，和pointToPointHelper类
4  一样，首先产生类的对象stack，然后用这个类的install()，install的对象同样是NodeContainer对象，
5  它会为节点容器中的每一个节点安装一个网络协议栈（TCP,UDP,IP等）*/
6  InternetStackHelper stack;
7  stack.Install (nodes);

1//下面我们需要为节点上的设备设置IP地址。
2
3  /*Ipv4AddressHelper类是用来管理IP地址的分配的。当执行实际的地址分配时唯一用户可见的API
4  是设置IP地址和子网掩码,网络层采用ipv4分配ip，并且告诉它应该开始从10.1.1.0开始以子网掩码
5  为255.255.255.0分配地址。地址分配默认是从1开始并单调的增长，所以在这个基础上第一个分配的
6  地址会是10.1.1.1，紧跟着是10.1.1.2等等。底层NS3系统事实上会记住所有分配的IP地址，如果你
7  无意导致了相同IP地址的产生，这将是一个致命的错误。*/
8  Ipv4AddressHelper address;
9  address.SetBase ("10.1.1.0", "255.255.255.0"); 

1  Ipv4InterfaceContainer interfaces = address.Assign (devices);  
2  /*最后这行代码实现给devices分配地址，将一个IP地址同一个网络设备关联起来。正如我们有时候需
3  要一个网络设备列表一样，我们有时候需要一个Ipv4Interface对象的列表。Ipv4InterfaceContainer
4  提供了这样的功能。*/

 1//现在我们有了一个安装了协议栈，配置了IP地址的点到点的网络。剩下的所要做的事情是运用它来产生数据通信
 2
 3  /*NS3系统的另一个核心抽象是Application类。在这个脚本中我们用两个特定的Application类：
 4UdpEchoServerApplication（UDP 回显服务应用）和UdpEchoClientApplication（UDP 回显客
 5户应用）。正如我们先前声明过的一样，我们使用helper对象来帮助配置和管理潜在的对象。在这里，
 6我们用UdpEchoServerHelper和UdpEchoClientHelper对象来使我们的工作更加容易点。
 7  首先用Helper类创建一个应用echoServer，像往常一样，这个并非应用本身，这是一个用来帮助创
 8  建真正应用的helper对象。我们约定在helper类的对象中放置必需的属性。本例中，我们告知helper
 9  对象服务器和客户端所共知的一个端口号9，否则这个helper对象是不会起任何作用的。*/
10  UdpEchoServerHelper echoServer (9); 
11  
12  /*echoServer.Install将会在管理节点的NodeContainer容器nodes索引号为1的机节点上安装一个
13  UdpEchoServerApplication。安装会返回一个容器，这个容器中包含了指向所有被helper对象创建
14  的应用指针。*/
15  ApplicationContainer serverApps = echoServer.Install (nodes.Get (1));
16  
17  /*应用程序对象需要一个时间参数来“开始”产生数据通信并且可能在一个可选的时间点“停止”。我们
18  提供了开始和停止的两个参数。这些时间点是用ApplicationContainer的方法Start和Stop来设置的。
19  这些方法以”Time”对象为参数。本例中，我们传递了double类型对象1.0到Seconds的一个方法，通过
20  seconds()方法，把它转换到ns-3的Time对象。*/
21  serverApps.Start (Seconds (1.0));  //起始时间（仿真）
22  serverApps.Stop (Seconds (10.0));  //停止时间
23
24//与上面类似，生成UdpEchoClientApplication（UDP 回显客户应用）
25
26  /*设置这个客户helper类对象的属性，告诉它设置客户端的远端地址为服务器节点的IP地址
27  interfaces.GetAddress (1)。我们同样告诉它准备发送数据包到端口9。*/
28  UdpEchoClientHelper echoClient (interfaces.GetAddress (1), 9);  
29//设置发包属性
30  echoClient.SetAttribute ("MaxPackets", UintegerValue (1));  
31  //“MaxPackets”属性告诉客户端我们所允许它在模拟期间所能发送的最大数据包个数
32  echoClient.SetAttribute ("Interval", TimeValue (Seconds (1.0)));  
33  //“Interval”属性告诉客户端在两个数据包之间要等待多长时间。
34  echoClient.SetAttribute ("PacketSize", UintegerValue (1024));  
35  //“PacketSize”属性告诉客户端它的数据包应该承载多少数据。本例中，我们让客户端发送一个1024字节的数据包。
36 
37  /*同理，echoClient.Install将会在管理节点的NodeContainer容器nodes索引号为0的机节点上安装一个
38  UdpEchoClientApplication。安装会返回一个容器，这个容器中包含了指向所有被helper对象创建的应用指针。*/
39  ApplicationContainer clientApps = echoClient.Install (nodes.Get (0));   //将Node0作为客户机

 1  clientApps.Start (Seconds (2.0));  //起始、停止时间
 2  clientApps.Stop (Seconds (10.0));
 3
 4 
 5   /*下面我们所需要做的就是运行模拟器，这是用全局函数Simulator::Run.来做到的。
 6  当Simulator::Run被调用时，系统会开始遍历预设事件的列表并执行。首先它会在1.0s时
 7  运行事件，这个事件会使echo服务端应用生效（这个事件会预设更多的其他事件）。接下来
 8  仿真器会运行在t=2.0s时的事件，即让echo客户端应用开始。同样的，这个事件可能会预定
 9  更多的其他事件。在echo客户端应用中的开始事件的执行会通过给服务端传送一个数据包来
10  开始仿真的数据传送阶段。*/
11  Simulator::Run ();    //运行仿真
12
13   /*下面剩下的事情就是清理了。这个通过调用全局函数Simulator::Destroy来完成。
14  当该方法被执行后，模拟器中所有创建的对象将被销毁。你自己并不需要追踪任何对象，
15  你所需要做的仅仅是调用Simulator::Destroy并且退出。ns-3系统会帮你料理这些繁
16  杂的任务。*/
17  Simulator::Destroy ();   //结束仿真
18  return 0;
19}

1./waf     //编译
2./waf --run myfirst   //运行文件

1vim scratch/myfirst.cc   
2gedit scratch/myfirst.cc   //用文本编辑器打开文件

1gnuplot

 1set termianl png //设置输出图片格式，如png,gif,jpg等 
 2set size width,height //设备图片宽度，高度 
 3set output “图片名称” //设置保存图片名称。
 4plot title “标题名” //设置图片标题名称，一般用英文，有时不支持中文字符 
 5plot “数据.dat” using 1:2 with linespoints //把数据文件”数据.dat”输出图像， using 1:2,使用第1,2列数据输出. 
 6with linespoints //点用符号，点与点之间用线连接
 7a plot “数据.dat” //只输出数据点 
 8b plot “数据.dat” with lines //把点连起来，成线。 
 9c plot “数据.dat” with linespoints //点用符号，点与点之间用线连接 
10d plot ‘file.dat’ using 1:3 with linespoints //使用1,3列绘图 
11e plot ‘file.dat’ using 1:($3/2) with linespoints //使用第一列与第三列的二分之一绘图

 1GnuplotCollection gnuplots ("main-propagation-loss.pdf");
 2  //GnuplotCollection可以将多个图放在一个文件中，和Gnuplot没有什么区别
 3  
 4  {//第一个图
 5    Ptr<FriisPropagationLossModel> friis = CreateObject<FriisPropagationLossModel> ();
 6    Gnuplot plot = TestDeterministic (friis); //生成一个plot对象
 7    plot.SetTitle ("xxx"); //设置plot标题
 8    gnuplots.AddPlot (plot);//往gnuplots 图集合中增加一个图
 9  }
10 //定义文件：
11  std::ofstream plotFile(“propagation_loss.plt”);
12  //用这个声明的流对象作为GenerateOutput的参数,就是把上面GnuplotCollection类的gnuplots输出放进文件里
13  gnuplots.GenerateOutput(plotFile);
14  // produce clean valgrind
15  Simulator::Destroy ();
16  return 0;
17}

1gnuplot propagation_loss.plt

 1#include <fstream>   //使得程序能够将仿真结果输出到文件中以便后续绘图和分析。
 2
 3int main (int argc, char *argv[])
 4{
 5  CommandLine cmd;
 6  cmd.Parse (argc, argv);
 7  
 8  GnuplotCollection gnuplots ("main-propagation-loss.pdf");
 9  //GNUplot是一个将数据图形化的库，GnuplotCollection可以将多个图放在一个文件中
10  
11  {//第一个图
12    Ptr<FriisPropagationLossModel> friis = CreateObject<FriisPropagationLossModel> ();
13	//testDeterministic方法是计算相应信道模型功率和距离的对应关系
14    Gnuplot plot = TestDeterministic (friis); //生成一个plot对象
15    plot.SetTitle ("ns3::FriisPropagationLossModel (Default Parameters)"); //设置plot标题
16    gnuplots.AddPlot (plot);//往gnuplots 图集合中增加一个图
17  }
18
19  {//第二个图
20    Ptr<LogDistancePropagationLossModel> log = CreateObject<LogDistancePropagationLossModel> ();
21    log->SetAttribute ("Exponent", DoubleValue (2.5));
22    Gnuplot plot = TestDeterministic (log);
23    plot.SetTitle ("ns3::LogDistancePropagationLossModel (Exponent = 2.5)");
24    gnuplots.AddPlot (plot);
25  }
26
27  {//第三个图
28    Ptr<RandomPropagationLossModel> random = CreateObject<RandomPropagationLossModel> ();
29    Ptr<ExponentialRandomVariable> expVar = CreateObjectWithAttributes<ExponentialRandomVariable> ("Mean", DoubleValue (50.0));
30    random->SetAttribute ("Variable", PointerValue (expVar));
31
32    Gnuplot plot = TestDeterministic (random);
33    plot.SetTitle ("ns3::RandomPropagationLossModel with Exponential Distribution");
34    gnuplots.AddPlot (plot);
35  }
36  ...一共九个图
37
38  //定义文件：
39  std::ofstream plotFile(“propagation_loss.plt”);
40  //用这个声明的流对象作为GenerateOutput的参数,就是把上面GnuplotCollection类的gnuplots输出放进文件里
41  gnuplots.GenerateOutput(plotFile);
42  // produce clean valgrind
43  Simulator::Destroy ();
44  return 0;
45}

1gnuplot propagation_loss.plt

1#include "ns3/netanim-module.h"

1  AnimationInterface anim("random_walk.xml");

1./NetAnim

 1int
 2main (int argc, char *argv[])
 3{
 4...
 5/*RITE需要一个配置文件来构建它的图。默认情况下，这个例子将使用TD_ASBarabasi_RTWaxman.conf文件。
 6它结合了Barabasi的AS拓扑和Waxman的RT拓扑生成算法，形成了层次化拓扑结构。
 7在BRITE/conf_files目录中还可以找到许多其他文件*/
 8std::string confFile = "src/brite/examples/conf_files/TD_ASBarabasi_RTWaxman.conf";
 9
10...
11
12/*调用BriteTopologyHelper并传入一个BRITE配置文件和一个种子文件。这将使用BRITE来构建一个图，我们可以从中构建ns-3拓扑*/
13BriteTopologyHelper bth (confFile);
14bth.AssignStreams (3);
15
16...
17Ipv4AddressHelper address; //IPv4Helper对象
18address.SetBase ("10.0.0.0", "255.255.255.252");//基地址和子网掩码
19
20bth.BuildBriteTopology (stack); //建立拓扑，并安装指定的协议栈
21bth.AssignIpv4Addresses (address); //分配IP地址
22
23
24/*BRITE拓扑生成器生成路由器的拓扑。在这里，我们创建了两个子网络，并将其
25连接到由BRITE生成的路由器叶节点。任何NS3拓扑都可以用于连接到BRITE叶节点，
26但在这里，我们只使用一个节点*/
27
28NodeContainer client; //客户端对象
29NodeContainer server; //服务器对象
30
31client.Create (1); //创建1个客户端
32stack.Install (client);//为客户端安装协议栈
33
34//将客户端指定到生成的拓扑结构AS0的最后一个叶子节点
35int numLeafNodesInAsZero = bth.GetNLeafNodesForAs (0); 
36client.Add (bth.GetLeafNodeForAs (0, numLeafNodesInAsZero - 1));
37
38server.Create (1); //创建一个服务器
39stack.Install (server);//为服务器安装协议栈
40
41//将服务器指定到生成的拓扑结构AS1的最后一个节点
42int numLeafNodesInAsOne = bth.GetNLeafNodesForAs (1); //将服务器指定倒AS1的最后一个节点
43server.Add (bth.GetLeafNodeForAs (1, numLeafNodesInAsOne - 1));
44
45...
46
47// Run the simulator
48Simulator::Stop (Seconds (6.0));
49Simulator::Run ();
50Simulator::Destroy ();
51
52return 0;
53}

1ls   //列出文件夹下所有文件
2locate core-module.h     //查询这个文件的位置
3cd  A/B //修改文件目录（和windows一样）
4cd ..   //返回上一层文件目录
5cp A/B/first.cc A/C/myfirst.cc   //复制
6gedit A/C/myfirst.cc   //用文本编辑器打开文件

1./waf

1./waf --run scratch/myfirst      //运行myfirst_2.cc文件，注意命令行没有后缀
2sudo ./waf --run scratch/myfirst     //如果需要权限，加上sudo前缀

1./waf --run “scratch/three-gpp-http-example --SimulationTime=30”    //注意双引号，注意格式

1export NS_LOG=ThreeGppHttpServer=level_all

 1int
 2main (int argc, char *argv[])
 3{
 4  double simTimeSec = 300;
 5  CommandLine cmd;  //支持命令行参数功能
 6  cmd.AddValue ("SimulationTime", "Length of simulation in seconds.", simTimeSec);  //添加所支持的命令行参数
 7  cmd.Parse (argc, argv);  //命令行参数解析
 8
 9  Time::SetResolution (Time::NS);  //设置时间分辨率
10  LogComponentEnableAll (LOG_PREFIX_TIME);//log前打上时间
11  //LogComponentEnableAll (LOG_PREFIX_FUNC);
12  //LogComponentEnable ("ThreeGppHttpClient", LOG_INFO);
13  ///LogComponentEnable ("ThreeGppHttpServer", LOG_INFO);
14  LogComponentEnable ("ThreeGppHttpExample", LOG_INFO); 
15
16  // Setup two nodes
17  NodeContainer nodes;  //节点容器
18  nodes.Create (2); //创建2个节点
19
20  PointToPointHelper pointToPoint; //点对点拓扑
21  pointToPoint.SetDeviceAttribute ("DataRate", StringValue ("5Mbps"));
22  pointToPoint.SetChannelAttribute ("Delay", StringValue ("2ms"));
23//设置链路参数
24  NetDeviceContainer devices;//设备容器
25  devices = pointToPoint.Install (nodes);
26
27  InternetStackHelper stack; //协议栈
28  stack.Install (nodes); //在两个节点上安装协议栈
29
30  Ipv4AddressHelper address;
31  address.SetBase ("10.1.1.0", "255.255.255.0");//IP基地址和子网掩码
32
33  Ipv4InterfaceContainer interfaces = address.Assign (devices);为两个设备分配地址
34  Ipv4Address serverAddress = interfaces.GetAddress (1);
35
36//服务器端地址
37  // Create HTTP server helper
38  ThreeGppHttpServerHelper serverHelper (serverAddress);
39  //创建3GPP HTTP Server
40  // Install HTTP server
41  ApplicationContainer serverApps = serverHelper.Install (nodes.Get (1)); //安装Http server
42  Ptr<ThreeGppHttpServer> httpServer = serverApps.Get (0)->GetObject<ThreeGppHttpServer> (); //获得Server指针
43
44  // Example of connecting to the trace sources
45  httpServer->TraceConnectWithoutContext ("ConnectionEstablished",
46                                          MakeCallback (&ServerConnectionEstablished));
47  httpServer->TraceConnectWithoutContext ("MainObject", MakeCallback (&MainObjectGenerated));
48  httpServer->TraceConnectWithoutContext ("EmbeddedObject", MakeCallback (&EmbeddedObjectGenerated));
49  httpServer->TraceConnectWithoutContext ("Tx", MakeCallback (&ServerTx));
50
51  // Setup HTTP variables for the server
52  PointerValue varPtr;
53  httpServer->GetAttribute ("Variables", varPtr);
54  Ptr<ThreeGppHttpVariables> httpVariables = varPtr.Get<ThreeGppHttpVariables> ();
55  httpVariables->SetMainObjectSizeMean (102400); // 100kB
56  httpVariables->SetMainObjectSizeStdDev (40960); // 40kB
57//设置HTTP模型有关的变量：主对象大小均值和标准差
58  // Create HTTP client helper
59  ThreeGppHttpClientHelper clientHelper (serverAddress);
60
61  // Install HTTP client
62  ApplicationContainer clientApps = clientHelper.Install (nodes.Get (0));
63  Ptr<ThreeGppHttpClient> httpClient = clientApps.Get (0)->GetObject<ThreeGppHttpClient> ();
64//生成客户端，绑定到另一节点，并获取对象指针
65  // Example of connecting to the trace sources
66  httpClient->TraceConnectWithoutContext ("RxMainObject", MakeCallback (&ClientMainObjectReceived));
67  httpClient->TraceConnectWithoutContext ("RxEmbeddedObject", MakeCallback (&ClientEmbeddedObjectReceived));
68  httpClient->TraceConnectWithoutContext ("Rx", MakeCallback (&ClientRx));
69
70  // Stop browsing after 30 minutes
71  clientApps.Stop (Seconds (simTimeSec));
72
73  Simulator::Run ();
74  Simulator::Destroy ();
75  return 0;
76}