ns3 ./waf快速上手

最新推荐文章于 2024-10-24 14:17:57 发布

荷西·H

最新推荐文章于 2024-10-24 14:17:57 发布

阅读量2.6k

点赞数 1

分类专栏： ns3 文章标签： waf

本文链接：https://blog.youkuaiyun.com/Hesy_H/article/details/89291825

版权

ns3 专栏收录该内容

24 篇文章

订阅专栏

项目的大致目录结构

$ tree
|-- src
|   `-- wscript
`-- wscript

主目录下有一个主的wscript脚本，要编译的子目录src目录下也有一个wscript脚本（每个wscript是python脚本）

#! /usr/bin/env python
# encoding: utf-8
	// 这里的注释应该是井号的 
	// 说明: 设置top目录为当前路径，输出路径为当前目录的build目录
top = '.'			
out = 'build'
 
def configure(ctx):
	print(' -> configureing the project in ' + ctx.path.abspath())
 
def ping(ctx):
	print('-> ping from ' + ctx.path.abspath())
	ctx.recurse('src')

小tip:最前面这行是使用python编译这个脚本的意思。就象有些bash脚本里面是#!bash 表示这是命令行的脚本文件一样。

#! /usr/bin/env python
#encoding: utf-8
def ping(ctx):
	print('-> ping from ' + ctx.path.abspath())

./waf 函数讲解

（1）首先执行

$  waf configure
Setting top to                           : /home/fcx/share/test/waf_learn/simple_test
Setting out to                           : /home/fcx/share/test/waf_learn/simple_test/build
 -> configureing the project in /home/fcx/share/test/waf_learn/simple_test
'configure' finished successfully (0.036s)

于是在新建的build目录会生成一下配置文件

|-- build
|   |-- c4che
|   |   |-- build.config.py
|   |   `-- _cache.py
|   `-- config.log
|--.lock-wafbuild
|-- src
|   `-- wscript
`-- wscript

其中配置数据存储在build/c4che/目录下，命令行选项和环境变量存储在build.config.py中。用户的配置设置存储在_cache.py中。

（2）然后执行：

$  waf ping
-> ping from /home/fcx/share/test/waf_learn/simple_test
-> ping from /home/fcx/share/test/waf_learn/simple_test/src
'ping' finished successfully (0.002s)

（3）waf dist命令
创建一个发布压缩包,包含源代码目录中的所有文件。默认将会把项目代码打包为一个名为noname-1.0.tar.bz2的压缩包，如果要自己命名，则在主wscript脚本的top命令前添加如：

#! /usr/bin/env python
#encoding: utf-8
APPNAME = 'waf_learn'
VERSION = '1.0.0'
top = '.'
out = 'build'
def configure(ctx):
	print(' -> configureing the project in ' + ctx.path.abspath())

def ping(ctx):
	print('-> ping from ' + ctx.path.abspath())
	ctx.recurse('src')

这样生成的压缩包名为：waf_learn-1.0.0.tar.bz2

（4）waf distclean 命令
如果执行 waf distclean 将会删除build的目录。distclean函数不需要在主wscript脚本中定义，如果你自己定义了该函数，则默认的distclean函数调用将会被你定义的函数覆盖。

更多的可以见这个blog https://blog.youkuaiyun.com/rical730/article/details/71514404

默认配置

有一个文件记录了默认的配置信息，可以修改它的默认参数，即默认的是激活examples and tests 还是锁死：
文件名叫utils/ .ns3rc文件 $ vim .ns3rc

禁止：

#Set this equal to true if you want examples to be run.
examples_enabled = False
#Set this equal to true if you want tests to be run.
tests_enabled = False

允许：

#Set this equal to true if you want examples to be run.
examples_enabled = True
#Set this equal to true if you want tests to be run.
tests_enabled = True