该页面主要包括以下主要资料：
Tutorial:
初步介绍NS-3的相关知识，以及下载及安装，简单使用。
Manual:
更深一步讲解NS-3的相关知识以及NS-3的编码风格。
Model Library: 主要介绍NS-3的相关模块。用户可以选择自己实际需要的模块学习，不需要全部看。
3.
http://www.nsnam.org/doxygen/index.html该页面上提供了NS-3系统架构的更为详细的信息。在编写自己的模块时，查询类的成员函数，类的属性等，要经常用到这个链接。
4.维基百科
网页http://www.nsnam.org/wiki可以作为NS-3主站点的补充。
5.NS-3的源码可以在
http://code.nsnam.org
找到。读者也可以在名为ns3-dev的源码仓库找到当前的NS-3开发树。还有NS-3的之前发行版本和最新测试版本的代码。
2 下载安装NS3
2.1 下载NS3软件包
我们以Ubuntu Linux环境为例，下载安装NS-3，并通过运行简单的脚本，来验证是否安装成功。
- 新建目录，用于存放下载的NS3软件包。目录名可自取。如新建名为ns3_install的目录：
mkdir
ns3_install
- 进入ns3_install目录，下载最新版本的NS3源代码到该目录下，并解压缩。以下载ns-3.15版本源代码为例：
cd
ns3_install
wget
https://www.nsnam.org/release/ns-allinone-3.15.tar.bz2
tar xjfns-allinone-3.15.tar.bz2
解压缩之后的目录名为ns-allinone-3.15/。
2.2 编译NS3软件包
2.2.1 使用build.py编译
第一次编译NS3软件包，建议用./build.py --enable-examples
--enable-tests命令，对下载的源代码进行整体编译。
首先切换到上文解压缩后的目录下：
cd
ns-allinone-3.15
键入如下的命令，编译脚本开始编译，初次编译用时较长，请耐心等待：
./build.py --enable-examples --enable-tests
编译脚本开始编译下载的ns3时，会看到大量常见的编译器输入信息。最后会看到编译成功的消息：
‘build’ finished successfully (40m30.586s)
编译完成之后，在当前目录(ns-allinone-3.15)下会产生一个名为ns-3.15/的目录，切换到该目录下
cd ns-3.15
2.2.2使用waf编译
除了以上介绍的方法，我们也可以用waf进行NS3源代码的编译。在用waf进行编译之前，先来认识一下waf。
读者下载NS3的源码之后，需要对源码进行编译来生成可执行程序。正如源码管理方式多种多样，编译源码也有多种工具。最常用的工具是make。Make的不足在于，它可能是编译大型和高可配置型系统最难的一种方法。因此，有很多替代工具被开发出来。最近，大型高可配置系统的编译工具大多选择用Python语言来开发。
NS3的编译系统采用了Waf。它是用Python开发的新一代编译管理系统。读者不必掌握python，即可编译现有的NS3项目。如果读者想要扩展现有的NS3系统，大多数情况只需了解Python知识的很少且非常直观的一个子集。
更多关于Waf的细节，可以通过
http://code.google.com/p/waf/获取。
然后进入本节的主题，开始使用waf来配置和编译NS3软件包。
使用waf对NS3源代码进行编译时，可以分为优化编译和调试编译两种情况。默认情况将进行调试编译。
为了通知waf进行优化编译，你需要执行如下的命令：
./waf clean
./waf -d optimized --enable-examples --enable-tests configure
为防止重复编译可能带来的错误，第一条命令首先清空以前编译的内容(编译过的内容位于ns-3.15/build/目录下)。该命令不是必须的，但这样做是一个好的习惯。键入第二条命令后，编译系统开始检查各种依存关系，并进行编译。你可以看到类似如下的输出：
Checking for program g++ : ok /usr/bin/g++
Checking for program cpp : ok /usr/bin/cpp
Checking for program ar : ok /usr/bin/ar
Checking for program ranlib : ok /usr/bin/ranlib
Checking for g++ : ok
………………
‘configure’ finished successfully (2.870s)
最后一条语句表明，顺利编译完成。
在编译时需要注意的是，部分ns-3特性默认并不是开启的，需要底层系统的支持才能够顺利运行。例如：为了运行XmlTo,
系统必须安装libxml-2.0库,如果没有发现这个库，相应的ns-3特性就不会被激活，这会以消息显示出来。另一个需要注意的地方是：对于一些特定的程序，需要使用sudo命令来设置该程序，而这些程序默认可能设置为关闭的，所以此性质会显示出未激活。
同样，我们也可以进行调试编译(为后续说明的方便，建议编译时选择调试编译模式)：
./waf clean
./waf -d debug --enable-examples --enable-tests configure
此外可以通过参数-o，更改编译的目标目录，默认编译目录为build/。可以通过如下命令，更改编译的目标目录为build/debug/
./waf -d debug -o build/debug --enable-examples --enable-tests
configure
在waf中还有许多其它的配置和编译选项可用。可以通过以下命令察看更多的选项：
./waf
--help
2.3 对编译的正确性进行测试
在编译完成之后，可以通过运行“./test.py -c core”脚本进行ns-3软件包的正确性测试,
./test.py -c core
这些测试可以被waf并行执行，最后可以看到如下的结果：
136 of 139 tests passed (136 passed, 3 skipped, 0 failed, 0
crashed, 0 valgrind errors)
在测试的过程中，可以看到类似于如下的信息：
Waf: Entering directory
‘/home/……/ns-allinone-3.15/ns-3.15/build’
Waf: Leaving directory
‘/home/……/ns-allinone-3.15/ns-3.15/build’
‘build’ finished successfully (1.799s)
PASS: TestSuite ns3-wifi-interference
PASS: TestSuite ipv4-address-helper
PASS: TestSuite devices-wifi
PASS: TestSuite propagation-loss-model
...
136 of 139 tests passed (136 passed, 3 skipped, 0 failed, 0
crashed, 0 valgrind errors)
用户通常可以运行此命令来检查NS3软件包是否正确编译了。
2.4 运行第一个脚本
我们通常使用waf运行脚本程序。在正确编译了NS3软件包之后，如果要运行一个程序，只需在waf后加入--run选项即可。让我们在ns-3环境下运行常见的Hello
Simulator程序，该程序就相当于学习一门语言时的Hello World程序:
./waf --run hello-simulator
Waf会首先检查程序正确编译了，而且还可以根据需要重新执行编译。Waf执行了此程序，并输出如下信息：
Hello Simulator
如果没有看到输出“Hello
Simulator”，说明你是在优化编译模式下进行的编译，在优化编译模式下，默认将关闭控制台输出。可以通过以下命令：
./waf clean
./waf -d debug --enable-examples --enable-tests configure
在调试编译模式下进行重新编译。
到现在为止，我们顺利的下载编译了NS3软件包，并通过测试和运行Hello
Simulator脚本程序来验证了软件包正确性。如果想在其他工具下如gdb或者valgrind下运行程序，可参见Wiki条目。
3 NS3快速入门
本章节通过阅读分析一个例子程序(first.cc)的源代码，并通过运行该例子程序，快速理解ns3中的几个概念。
3.1 NS3中的几个关键概念
3.1.1 节点Node
在网络术语中，任何一台连接到网络的计算设备被称为主机，亦称为终端。NS3是一个网络模拟器，而非一个专门的因特网模拟器，为此我们避开术语“主机”，因为这个词太容易让人联想到因特网和及其相关协议。因此，我们选用了一个来源于图论，在其他网络模拟器中亦广泛使用的术语：节点。
NS3中基本计算设备被抽象为节点。节点由用C++编写的Node类来描述。Node类提供了用于管理计算设备的各种方法。
可以将节点设想为一台可以添加各种功能的计算机。为了使一台计算机有效地工作，我们可以给它添加应用程序，协议栈，外设卡及驱动程序等。NS3采用了与此相同的模型。
3.1.2 信道
在现实世界中，人们可以把计算机连接到网络上。通常我们把网络中数据流流过的媒介称为信道。当你把以太网线插入到墙壁上的插孔时，你正通过信道将计算机与以太网连接。在NS3中，可以把节点连接到代表数据交换信道的对象上。在这里，基本的通信子网这一抽象概念被称为信道，用C++编写的Channel类来描述。
Channel类提供了管理通信子网对象和把节点连接至信道的各种方法。信道类同样可以由开发者以面向对象的方法自定义。一个信道实例可以模拟一条简单的线缆（wire），也可以模拟一个复杂的巨型以太网交换机，甚至无线网络中充满障碍物的三维空间。
在本章中我们将使用几个信道模型的实例，包括：CsmaChannel,
PointToPointChannel和WifiChannel。举例来说，CsmaChannel信道模拟了用于一个可以实现载波侦听多路访问的信道，这个信道具有和以太网相似的功能。
3.1.3 网络设备
如果想把一台计算机连接到网络上，必须在计算机上安装有网卡。一张网卡如果缺少控制硬件的软件驱动是不能工作的。在Unix/Linux系统中，外围硬件被划为“设备”。设备通过驱动程序来控制，而网卡通过网卡驱动程序来控制。在Unix/Linux系统中，网卡被称为像eth0这样的名字。
在NS3中，网络设备这一抽象概念相当于硬件设备和软件驱动的总和。NS3仿真环境中，网络设备相当于安装在节点上，使得节点通过信道和其他节点通信。像真实的计算机一样，一个节点可以通过多个网络设备同时连接到多条信道上。
网络设备由用C++编写的NetDevice类来描述。NetDevice类提供了管理连接其他节点和信道对象的各种方法，并且允许开发者以面向对象的方法来自定义。我们在本教程中将使用几个特定的网络设备的实例，它们分别是CsmaNetDevice,
PointToPointNetDevice, 和
WifiNetDevice。正如以太网卡被设计成在以太网中工作一样，CsmaNetDevice被设计成在csma信道中工作，而PointToPointNetDevice
在PointToPoint信道中工作，WifiNetNevice在wifi信道中工作。
3.1.4 应用程序
计算机软件通常可分为两大类：系统软件和应用软件。系统软件根据计算模型配置，并管理计算机中的各种资源，如内存，处理器周期，硬盘，网络等。系统软件通常并不直接使用这些资源来完成用户任务。用户往往需要运行应用程序来完成一些特定的任务，而应用程序需要使用由系统软件控制的资源。
通常，系统软件和应用软件的界线表现为特权级别的变化，而这种变化是通过操作系统的自陷功能（operating system
traps）来实现的。在NS3中并没有真正的操作系统的概念，更没有特权级别或者系统调用的概念。然而，我们有应用程序的概念。正如“现实世界”中在计算机上运行应用程序以执行各种任务一样，NS3仿真环境中的应用程序在节点上运行来驱动模拟过程。
在NS3中，需要被仿真的用户程序被抽象为应用。用Application类来描述。这个类提供了管理仿真过程中用户层应用的各种方法。开发者应当用面向对象的方法自定义和创建新的应用。在本教程中，我们会使用Application类的两个实例：UdpEchoClientApplication
和UdpEchoServerApplication
。这些应用程序包含了一个client应用和一个server应用来发送和回应仿真网络中的数据包。
3.2 分析例子程序first.cc的源代码
进入ns-3.15/examples/tutorial目录。你会发现一个叫first.cc的文件。这一个脚本会在两个节点间创建一个简单的点到点的连接，并且在这两个节点之间传送一个数据包。为方便后续分许，先将first.cc的源代码粘贴如下：
#include 'ns3/core-module.h'
#include 'ns3/network-module.h'
#include 'ns3/internet-module.h'
#include 'ns3/point-to-point-module.h'
#include 'ns3/applications-module.h'
using namespace ns3;
NS_LOG_COMPONENT_DEFINE ('FirstScriptExample');
intmain (int argc, char *argv[])
{
LogComponentEnable ('UdpEchoClientApplication
',
LOG_LEVEL_INFO);
LogComponentEnable ('UdpEchoServerApplication
',
LOG_LEVEL_INFO);
NodeContainer nodes;
nodes.Create (2);
PointToPointHelper pointToPoint;
pointToPoint.SetDeviceAttribute ('DataRate', StringValue
('5Mbps'));
pointToPoint.SetChannelAttribute ('Delay', StringValue
('2ms'));
NetDeviceContainer devices;
devices = pointToPoint.Install (nodes);
InternetStackHelper stack;
stack.Install (nodes);
Ipv4AddressHelper address;
address.SetBase ('10.1.1.0', '255.255.255.0');
Ipv4InterfaceContainer interfaces = address.Assign (devices);
UdpEchoServerHelper echoServer (9);
ApplicationContainer serverApps = echoServer.Install (nodes.Get
(1));
serverApps.Start (Seconds (1.0));
serverApps.Stop (Seconds (10.0));
UdpEchoClientHelper echoClient (interfaces.GetAddress (1),
9);
echoClient.SetAttribute ('MaxPackets', UintegerValue (1));
echoClient.SetAttribute ('Interval', TimeValue (Seconds
(1.0)));
echoClient.SetAttribute ('PacketSize', UintegerValue (1024));
ApplicationContainer clientApps = echoClient.Install (nodes.Get
(0));
clientApps.Start (Seconds (2.0));
clientApps.Stop (Seconds (10.0));
Simulator::Run ();
Simulator::Destroy ();
return 0;
}
3.2.1 模块包含
代码一般是以一系列的include声明开始的：
#include 'ns3/core-module.h'
#include 'ns3/simulator-module.h'
#include 'ns3/node-module.h'
#include 'ns3/helper-module.h'
为了帮助高层的脚本用户处理大量的系统中的include文件，我们把所有的包含文件，根据模块功能，进行了大致的分类。我们提供了一个单独的include文件，这个文件会递归加载所有会在每个模块中会被使用的include文件。NS3提供了按大致功能分类的一组include文件，在使用时只需选择包含这几个包含文件(include文件)，而不用考虑复杂的依赖关系，省去在寻找所需要的头文件上花费的不必要的时间。这不是最有效地方法但很明显让编写脚本文件容易多了。
在编译的过程中，每一个ns-3的include文件被放在build目录下一个叫ns3的目录中，这样做可以避免include文件名的冲突。ns3/core-module.h与src/core目录下的模块相对应。查看ns3目录会发现大量的头文件。当你编译时，Waf会根据配置把在ns3目录下的公共的头文件放到build/debug
或者build/optimized目录下。Waf也会自动产生一个模块include文件来加载所有的公共头文件。
当然，如果遵循着这个手册走的话，你可能已经使用过如下命令：
./waf -d debug --enable-examples --enable-tests configure
来配置工程以完成调试工作。你可能同样使用了如下命令：
./waf
来编译ns-3。现在如果你进入../../build/debug/ns3
目录的话你会发现本节开头提到的四个头文件。仔细看一下这些文件的内容，会发现它们包含了相关模块中的所有的include文件。
3.2.2 命名空间
在first.cc脚本的下一行是namespace的声明。
using namespace ns3;
NS3工程是在一个叫做ns3的C++
命名空间中实现的。这把所有与ns3相关的声明，集中在一个与全局命名空间相区别的命名空间中。我们希望这样会给ns3与其他代码的集成带来好处。C++用“using”语句用来把ns-3
namespace引入到当前的（全局的）作用域中。这个声明就是说，你不用为了使用ns-3的代码而必须在所有的ns-3代码前打上ns3::
作用域操作符。如果对命名空间并不熟悉，可以查阅任何的C++手册并比较ns3命名空间和标准”std”命名空间的使用。
3.2.3 日志
下一句脚本如下：
NS_LOG_COMPONENT_DEFINE ('FirstScriptExample');
这一行声明了一个叫FirstScriptExample的日志组件，通过引用FirstScriptExample这个名字的操作，可以实现打开或者关闭控制台日志的输出。
3.2.4 Main函数
下面的脚本是：
int
main (int argc, char *argv[])
{
这就是你的脚本程序的主函数的声明。正如任何其它C++程序一样，你需要定义一个会被第一个执行的主函数。你的ns-3脚本没有什么特别的，就和一个普通的C++程序一样。
再接下来两行脚本是用来使两个日志组件生效的。它们被内建在Echo Client
和Echo Server
应用中：
LogComponentEnable('UdpEchoClientApplication
