NS-3脚本的编译运行

原文地址：http://hi.baidu.com/czlaner/blog/item/77a0a4ce9903a90493457e06.html

-----------------------------------------------------------------------------------------------------------------

一、环境支持
如上文（NS-3入门[1]概念引入 ）所述，编译/运行NS-3脚本需要保证Linux环境的设置（gcc、waf、tcpdump等），详细的必要软件包安装过程参见http://www.nsnam.org/wiki/index.php/Installation

二、NS-3C++脚本的编写
如前所述，NS-3的脚本使用C++语言（也支持python），使用四种类型的网络构件（Node、NetDevice、Channel、Application）。一个简单的脚本一般有以下步骤：
1、创建节点Node（使用类NodeContainer::Create()方法）
2、使用链路Helper类来帮助设置链路（包括PointToPointHelper、CsmaHelper、WifiHelper等类型）。 Helper类虽然不属于上述四类的网络构件，但它却极大地方便了拓扑的搭建，它可以帮助我们处理实际中诸如在两个终端安装网卡、连网线、Modern、 配置上网方式、链路属性等底层工作，简化了仿真过程，使我们可以更专注于仿真的目的
3、安装IP协议栈（使用类InternetStackHelper::Install()方法）
4、设置IP地址（使用类Ipv4AddressHelper::SetBase()/Assign()方法）
5、在节点Node上安装应用程序（目前支持UdpServerServer、UdpEchoClient、PacketSink等）
6、设置仿真时间、启动仿真
===================================
一个简单的脚本（来自NS-3 Tutorial）及其解释
=========================================================================
#include "ns3/core-module.h"
#include "ns3/simulator-module.h
#include "ns3/node-module.h"
#include "ns3/helper-module.h"
using namespace ns3;

NS_LOG_COMPONENT_DEFINE ("Example"); 　　//定义名称为“Example”的日志模块

int
main (int argc, char *argv[])
{
　　 //以下两个语句启用UdpEcho应用程序的日志记录，其级别为LOG_LEVEL_INFO。关于NS-3的日志系统将在后续篇章进行介绍。
　　LogComponentEnable("UdpEchoClientApplication", LOG_LEVEL_INFO);
　　LogComponentEnable("UdpEchoServerApplication", LOG_LEVEL_INFO);

　　NodeContainer nodes; 　　//1、创建两个节点
　　nodes.Create (2);  

　　PointToPointHelper pointToPoint;　　//2、创建P2P类型的Helper
　　pointToPoint.SetDeviceAttribute ("DataRate", StringValue ("5Mbps"));   //使用Helper设置链路属性
　　pointToPoint.SetChannelAttribute ("Delay", StringValue ("2ms"));

　　NetDeviceContainer devices;
　　devices = pointToPoint.Install (nodes);　　//使用Helper将网卡安装到节点

　　InternetStackHelper stack;　　//3、安装IP协议栈
　　stack.Install (nodes);

　　Ipv4AddressHelper address;　　//4、分配IP地址
　　address.SetBase ("10.1.1.0", "255.255.255.0");
　　Ipv4InterfaceContainer interfaces = address.Assign (devices);　　//分配到网卡

　　UdpEchoServerHelper echoServer (9); 　　//5.1、安装UdpServer应用服务，9表示服务端口
　　ApplicationContainer serverApps = echoServer.Install (nodes.Get (1));
　　serverApps.Start (Seconds (1.0));
　　serverApps.Stop (Seconds (10.0));
　　serverApps.Start (Seconds (1.0)); 　　//6.1、Server启动时间
　　serverApps.Stop (Seconds (10.0));

　　UdpEchoClientHelper echoClient (interfaces.GetAddress (1), 9); 　　//5.2、安装UdpClient应用服务，需要指明服务器IP以及服务端口
　　echoClient.SetAttribute ("MaxPackets", UintegerValue (1));
　　echoClient.SetAttribute ("Interval", TimeValue (Seconds (1.)));
　　echoClient.SetAttribute ("PacketSize", UintegerValue (1024));
　　ApplicationContainer clientApps = echoClient.Install (nodes.Get (0));
　　clientApps.Start (Seconds (2.0)); 　　//6.2、Client启动时间
　　clientApps.Stop (Seconds (10.0));

　　Simulator::Run (); 　　//6.3、启动仿真
　　Simulator::Destroy ();
　　return 0;
}
=========================================================================

三、编译与运行
当我们装好NS-3的运行环境之后，在NS-3的程序目录下会有一个scratch目录，其性质类似于VC/VC++环境下的Debug目录。
将上述脚本文件保存为example.cc，复制到scratch下面，然后在NS-3目录下使用命令waf完成编译，然后运行。例如：
　　　　　　$~/NS-3.2.1 > ./waf
　　　　　　$~/NS-3.2.1 > ./waf --run scratch/example
可以看到程序输出：
　　　　Entering directory ‘~/NS-3.2.1/build’
　　　　Compilation finished successfully
　　　　Sent 1024 bytes to 10.1.1.2
　　　　Received 1024 bytes from 10.1.1.1
　　　　Received 1024 bytes from 10.1.1.2