ns-3 네트워크 시뮬레이터 튜토리얼. 제3장

1,2 장

3 시작하기
3.1 개요
3.2 전제조건
3.2.1 ns-3 릴리스를 소스 아카이브로 다운로드
3.3 Git을 사용하여 ns-3 다운로드
3.3.1 Bake를 사용하여 ns-3 로드
3.4 ns-3 조립
3.4.1 build.py로 빌드하기
3.4.2 베이크로 만들기
3.4.3 Waf로 구축
3.5 ns-3 테스트
3.6 스크립트 실행
3.6.1 명령줄 인수
3.6.2 디버깅
3.6.3 작업 디렉토리

장 3

시작하기

이 장은 ns-3을 한 번도 설치한 적이 없는 컴퓨터에서 시작하도록 독자를 준비시키기 위한 것입니다. 지원되는 플랫폼, 전제 조건, ns-3을 얻는 방법, ns-3을 빌드하는 방법, 빌드를 테스트하고 간단한 프로그램을 실행하는 방법을 다룹니다.

3.1 개요

ns-3 시뮬레이터는 협업 소프트웨어 라이브러리 시스템으로 구축되었습니다. 조립하는 동안 사용자 프로그램의 코드는 이러한 라이브러리와 연결됩니다. C++ 또는 Python 프로그래밍 언어는 사용자 정의 프로그램을 작성하는 데 사용됩니다.

Ns-3은 소스코드로 배포되는데, 이는 먼저 라이브러리를 구축한 후 사용자 프로그램을 구축하기 위해서는 대상 시스템에 소프트웨어 개발 환경이 있어야 함을 의미합니다. 원칙적으로 ns-3은 특정 시스템을 위한 기성 라이브러리로 배포될 수 있으며, 향후에는 이러한 방식으로 배포될 수도 있습니다. 그러나 요즘에는 실제로 많은 사용자가 ns-3 자체를 편집하여 작업을 수행하므로 라이브러리를 빌드하기 위한 소스 코드가 있는 것이 유용합니다. 운영체제용 기성 라이브러리 및 패키지 제작 작업을 맡고 싶은 분은 메일링 리스트에 문의해 주세요. ns 개발자.

다음으로 ns-3를 다운로드하고 빌드하는 세 가지 방법을 살펴보겠습니다. 첫 번째는 메인 사이트에서 공식 릴리스를 다운로드하고 빌드하는 것입니다. 두 번째는 기본 ns-3 설치의 개발 버전 사본을 선택하고 조립하는 것입니다. 세 번째는 추가 빌드 도구를 사용하여 ns-3에 대한 더 많은 확장을 로드하는 것입니다. 도구가 조금씩 다르기 때문에 하나씩 살펴보겠습니다.

숙련된 Linux 사용자는 왜 ns-3가 패키지 관리자를 사용하는 대부분의 다른 라이브러리처럼 패키지로 제공되지 않는지 궁금해할 수 있습니다. 다양한 Linux 배포판(예: Debian)을 위한 바이너리 패키지가 있지만 대부분의 사용자는 결국 라이브러리를 편집하고 ns-3을 직접 다시 빌드해야 하므로 소스 코드를 사용할 수 있는 것이 편리합니다. 이러한 이유로 우리는 소스에서 설치하는 데 중점을 둘 것입니다.

대부분의 애플리케이션에 대한 ns-3 권한 뿌리 필요하지 않은 경우 권한이 없는 사용자 계정을 사용하는 것이 좋습니다.

3.2 전제조건

사용 가능한 ns-3 라이브러리 전체 세트에는 타사 라이브러리에 대한 여러 가지 종속성이 있지만 대부분의 경우 ns-3은 C++ 컴파일러, C++ 컴파일러, 소스 코드 편집기인 Python(예: 정력, 이맥스 또는 식) 및 개발 리포지토리를 사용하는 경우 Git 버전 제어 시스템. 대부분의 최초 사용자는 구성에서 일부 ns-3 고급 기능이 누락되었다고 보고하더라도 걱정할 필요가 없지만 전체 설치를 원하는 사용자를 위해 프로젝트에서는 유용한 팁과 요령이 많이 포함된 페이지가 포함된 위키를 제공합니다. 그러한 페이지 중 하나는 다양한 시스템에 대한 설치 지침이 포함된 설치 페이지입니다. https://www.nsnam.org/wiki/Installation.

이 Wiki의 전제 조건 섹션에서는 일반적인 ns-3 옵션을 지원하는 데 필요한 패키지를 설명하고 일반적인 Linux 또는 macOS에 패키지를 설치하는 데 사용되는 명령도 제공합니다.

이 기회를 활용하여 ns-3 위키 페이지 또는 기본 웹사이트를 탐색할 수 있습니다. https://www.nsnam.org, 거기에는 많은 정보가 있기 때문입니다. 최신 버전의 ns-3(ns-3.29)부터 ns-3을 실행하려면 다음 도구가 필요합니다.

도구 패키지/버전

• C++ 컴파일러
  clang++ 또는 g++(g++ 버전 4.9 이상)
• Python
  python2 버전 >= 2.7.10 또는 python3 버전 >=3.4
• 힘내
  모든 최신 버전(GitLab.com의 ns-3에 액세스하기 위해)
• 타르
  모든 최신 버전(ns‑3 릴리스 압축 풀기용)
• 번지2
  모든 최신 버전(ns‑3 릴리스 압축 풀기용)

Python의 기본 버전을 확인하려면 다음을 입력하십시오. python -V. g++ 버전을 확인하려면 다음을 입력하세요. g++ -v. 도구가 없거나 너무 오래된 경우 ns-3 위키 페이지의 설치 가이드를 참조하세요.

이제부터는 독자가 Linux, MacOS 또는 Linux 에뮬레이터를 실행하고 있고 최소한 위의 도구가 있다고 가정합니다.

3.2.1 ns-3 릴리스를 소스 아카이브로 다운로드

이는 ns-3의 최신 릴리스 및 패키지 버전을 다운로드하고 실험하려는 신규 사용자를 위한 조치 과정입니다. ns-3 릴리스는 압축된 소스 아카이브로 게시됩니다. 타르볼. 타르볼 여러 파일을 함께 결합하는 특수 소프트웨어 아카이브 형식입니다. 아카이브는 일반적으로 압축됩니다. ns-3 부팅 프로세스를 통해 타르볼 간단합니다. 릴리스를 선택하고 다운로드하여 압축을 풀면 됩니다.

사용자로서 다음과 같은 로컬 디렉토리에 ns-3을 빌드한다고 가정해 보겠습니다. 작업 공간. Linux 콘솔에 다음을 입력하여 릴리스의 작업 복사본을 얻을 수 있습니다(물론 적절한 버전 번호로 대체).

$ cd 
$ mkdir workspace 
$ cd workspace 
$ wget https://www.nsnam.org/release/ns-allinone-3.29.tar.bz2 
$ tar xjf ns-allinone-3.29.tar.bz2 

위에 사용된 유틸리티에 주의하세요. wget는 인터넷에서 개체를 다운로드하기 위한 명령줄 도구입니다. 설치하지 않은 경우 브라우저를 사용하여 이를 수행할 수 있습니다.

다음 단계에 따라 ns-allinone-3.29 디렉토리로 이동하면 여러 파일과 디렉토리가 표시됩니다.

$ cd ns-allinone-3.29
$ ls
bake constants.py ns-3.29 README
build.py netanim-3.108 pybindgen-0.17.0.post58+ngcf00cc0 util.py

이제 ns-3 기본 배포판을 구축할 준비가 되었으며 ns-3 구축 섹션으로 이동할 수 있습니다.

3.3 Git을 사용하여 ns-3 다운로드

ns-3 코드는 GitLab.com의 Git 리포지토리에서 사용할 수 있습니다. https://gitlab.com/nsnam/. 그룹 nsnam 오픈 소스 프로젝트에서 사용되는 다양한 리포지토리를 통합합니다.

Git 리포지토리 사용을 시작하는 가장 쉬운 방법은 환경을 포크하거나 복제하는 것입니다. ns-3-알리논. 이는 가장 일반적으로 사용되는 ns-3 하위 시스템의 로드 및 어셈블리를 관리하는 스크립트 세트입니다. Git을 처음 사용하는 경우 "포크"와 "복제"라는 용어가 낯설 수도 있습니다. 그렇다면 다음과 같이 GitLab.com에 있는 저장소를 간단히 복제(자신만의 복사본 만들기)하는 것이 좋습니다.

$ cd 
$ mkdir workspace 
$ cd workspace 
$ git clone https://gitlab.com/nsnam/ns-3-allinone.git 
$ cd ns-3-allinone 

이 단계에서 디렉터리 보기는 ns-3-알리논 위에서 설명한 릴리스 아카이브 디렉토리와 약간 다릅니다. 다음과 같아야 합니다.

$ ls
build.py constants.py download.py README util.py

스크립트가 있으니 참고해주세요 다운로드.py, 그러면 ns-3 및 그에 수반되는 소스 코드가 추가로 추출됩니다. 여기서는 최신 ns-3 개발 스냅샷을 다운로드하거나 다음 중 하나를 선택할 수 있습니다.

$ python download.py

또는 플래그를 사용하여 ns-3 릴리스를 선호합니다. -n 릴리스 번호를 표시하려면 다음을 수행하십시오.

$ python download.py -n ns-3.29

이 단계 후에 디렉토리로 ns-3-알리논 추가 저장소가 다운로드됩니다 ns-3, 굽​​다, 피빈젠 и 네타님.

주의
Ubuntu16.04가 깨끗한 시스템에서는 명령을 다음과 같이 변경해야 했습니다. $ sudo python3 download.py -n ns-3.29 (이하 번역자 주).

3.3.1 Bake를 사용하여 ns-3 로드

위의 두 가지 방법(소스 아카이브 또는 저장소 ns-3-알리논 Git을 통해)는 여러 애드온을 사용하여 가장 간단한 ns-3 설치를 얻는 데 유용합니다(피빈젠 Python 바인딩을 생성하고 네타님 네트워크 애니메이션의 경우). ns-3-allinone에서 기본적으로 제공되는 세 번째 저장소는 다음과 같습니다. 굽​​다.

빵 굽기 ns-3 프로젝트를 위해 개발된 여러 저장소의 소프트웨어를 공동으로 구축하기 위한 도구입니다. 빵 굽기 ns-3의 개발 버전을 구하는 데 사용할 수 있을 뿐만 아니라 환경과 같은 ns-3 배포판의 기본 버전 확장을 다운로드하고 빌드하는 데에도 사용할 수 있습니다. 직접 코드 실행, CradleNetwork 시뮬레이션 크래들, 새로운 Python 바인딩 및 다양한 ns-3 "앱"을 생성하는 기능입니다.

주의
CradleNetwork 시뮬레이션 Cradle은 네트워크 시뮬레이터 내에서 실제 TCP/IP 네트워크 스택을 사용할 수 있게 해주는 프레임워크입니다.

ns-3 설치에 고급 기능이나 추가 기능이 필요한 경우 이 설치 경로를 따를 수 있습니다.

최신 ns-3 릴리스 빵 굽기 tar 릴리스에 추가되었습니다. 릴리스에는 릴리스 당시의 최신 소프트웨어 버전을 다운로드할 수 있는 구성 파일이 포함되어 있습니다. 예를 들어 버전입니다. 빵 굽기ns-3.29 릴리스와 함께 배포되는 ns-3 이하 릴리스의 구성 요소를 검색하는 데 사용할 수 있지만 이후 릴리스의 구성 요소를 검색하는 데는 사용할 수 없습니다(패키지 설명 파일이 bakingconf.xml 업데이트되지 않았습니다).

최신 사본을 얻을 수도 있습니다. 굽​​다Linux 콘솔에 다음 명령을 입력합니다(Git가 설치되어 있다고 가정).

$ cd 
$ mkdir workspace 
$ cd workspace 
$ git clone https://gitlab.com/nsnam/bake.git

git 명령을 실행하면 다음과 같은 내용이 표시됩니다.

Cloning into 'bake'...
remote: Enumerating objects: 2086, done. 
remote: Counting objects: 100% (2086/2086), done. 
remote: Compressing objects: 100% (649/649), done. 
remote: Total 2086 (delta 1404), reused 2078 (delta 1399) 
Receiving objects: 100% (2086/2086), 2.68 MiB | 3.82 MiB/s, done. 
Resolving deltas: 100% (1404/1404), done.

명령이 완료된 후 복제 이름이 지정된 디렉토리가 있어야 합니다. 굽​​다, 그 내용은 다음과 같습니다.

$ cd bake
$ ls
bake bakeconf.xml bake.py doc examples generate-binary.py test TODO

여러 Python 스크립트, 즉 Python 모듈이라는 이름을 로드했습니다. 굽​​다 및 XML 구성 파일. 다음 단계는 이 스크립트를 사용하여 원하는 ns-3 배포판을 다운로드하고 빌드하는 것입니다. 여러 가지 사용자 정의 대상을 사용할 수 있습니다:

1. ns-3.29: 릴리스에 해당하는 모듈; tarball의 릴리스와 유사한 구성 요소를 다운로드합니다.

2. ns-3-dev: 유사한 모듈이지만 개발 트리의 코드를 사용합니다.

3. ns-알리논-3.29: Click Routing, Network Simulation Cradle, Openflow for ns-3 등 기타 추가 기능을 포함하는 모듈입니다.

4. ns-3-알리논: 모듈의 릴리스 버전과 유사 allinone, 그러나 개발 코드용입니다.

주의
— 라우터 생성을 위한 모듈식 소프트웨어 아키텍처.

오픈플로우(Openflow)는 라우터와 스위치 등이 데이터 네트워크를 통해 전송되는 데이터를 처리하는 과정을 관리하는 프로토콜로, 소프트웨어 정의 네트워크 기술을 구현한다.

현재 개발 스냅샷(비릴리스) ns-3은 다음에서 찾을 수 있습니다.https://gitlab.com/nsnam/ns-3-dev.git.

개발자는 이러한 리포지토리를 일관된 작업 순서로 유지하려고 노력하지만 이는 개발 영역에 있고 릴리스되지 않은 코드를 포함하므로 새로운 기능을 사용할 계획이 없다면 공식 릴리스를 선택하십시오.

리포지토리 목록을 검색하거나 ns-3 릴리스 웹 페이지로 이동하여 최신 버전의 코드를 찾을 수 있습니다.https://www.nsnam.org/releases/ 최신 버전 링크를 클릭하세요. 이 예에서는 ns-3.29를 계속 사용하겠습니다.

이제 필요한 ns-3 구성요소를 얻기 위해 도구를 사용하겠습니다. 빵 굽기. 작품에 대한 몇 가지 소개를 해보자. 빵 굽기.

Bake는 패키지 소스를 디렉터리에 로드하는 방식으로 작동합니다. 빌드 디렉터리에 라이브러리를 설치합니다. 빵 굽기 바이너리를 참조하여 실행할 수 있지만 실행하려는 경우 빵 굽기 다운로드된 디렉토리가 아닌 다음 경로를 추가하는 것이 좋습니다. 굽​​다 예를 들어 다음과 같이 경로(PATH 환경 변수)에 추가합니다(Linux bash 셸의 예). "bake" 디렉터리로 이동한 후 다음 환경 변수를 설정합니다.

$ export BAKE_HOME=`pwd` 
$ export PATH=$PATH:$BAKE_HOME:$BAKE_HOME/build/bin 
$ export PYTHONPATH=$PYTHONPATH:$BAKE_HOME:$BAKE_HOME/build/lib

그러면 프로그램이 배치됩니다. baking.py 쉘 경로에 추가하고 다른 프로그램이 자신이 생성한 실행 파일과 라이브러리를 찾을 수 있도록 허용합니다. 굽​​다. 일부 사용 사례에서는 굽​​다, 위에서 설명한 PATH 및 PYTHONPATH 설정은 필요하지 않지만 일반적으로 ns-3-allinone(추가 패키지 포함)의 전체 빌드에는 필요합니다.

작업 디렉터리로 이동하여 콘솔에 다음을 입력합니다.

$ ./bake.py configure -e ns-3.29

다음으로 물어보겠습니다. 빵 굽기 다양한 구성 요소를 로드할 수 있는 충분한 도구가 있는지 확인하세요. 다이얼:

$ ./bake.py check

다음과 같은 내용이 표시됩니다.

> Python - OK 
> GNU C++ compiler - OK 
> Mercurial - OK 
> Git - OK 
> Tar tool - OK 
> Unzip tool - OK 
> Make - OK 
> cMake - OK 
> patch tool - OK 
> Path searched for tools: /usr/local/sbin /usr/local/bin /usr/sbin /usr/bin /sbin /bin ...

특히 Mercurial, CVS, Git 및 Bazaar와 같은 업로드 도구를 사용하면 코드를 얻을 수 있으므로 이 단계에서 필수적입니다. 이 단계에서는 시스템에 일반적인 방법으로 누락된 도구를 설치하거나(방법을 알고 있는 경우) 시스템 관리자에게 도움을 요청하십시오.

다음으로 소프트웨어를 다운로드해 보세요.

$ ./bake.py download

결과는 다음과 같아야 합니다.

>> Searching for system dependency setuptools - OK 
>> Searching for system dependency libgoocanvas2 - OK 
>> Searching for system dependency gi-cairo - OK 
>> Searching for system dependency pygobject - OK 
>> Searching for system dependency pygraphviz - OK 
>> Searching for system dependency python-dev - OK 
>> Searching for system dependency qt - OK 
>> Searching for system dependency g++ - OK 
>> Downloading pybindgen-0.19.0.post4+ng823d8b2 (target directory:pybindgen) - OK 
>> Downloading netanim-3.108 - OK 
>> Downloading ns-3.29 - OK

이는 세 개의 소스가 다운로드되었음을 의미합니다. 이제 소스 디렉터리로 이동하여 ls를 입력합니다. 넌 봐야 해:

$ cd source 
$ ls
netanim-3.108 ns-3.29 pybindgen

이제 ns-3 배포판을 구축할 준비가 되었습니다.

3.4 ns-3 조립

ns-3을 다운로드할 때와 마찬가지로 ns-3을 빌드하는 방법에는 여러 가지가 있습니다. 우리가 강조하고 싶은 가장 중요한 점은 ns-3이 다음이라는 빌드 도구를 사용하여 구축된다는 것입니다. 와프아래에서 묘사 되어진. 대부분의 사용자는 와프하지만 더 복잡한 빌드를 시작하거나 구성하는 데 도움이 되는 몇 가지 편리한 스크립트가 있습니다. 그러니 이 내용을 읽기 전에 와프, 보세요 build.py 그리고 조립 굽​​다.

3.4.1 build.py로 빌드하기

경고! 이 빌드 단계는 위에서 설명한 대로 얻은 소스 아카이브 버전에서만 사용할 수 있습니다. git이나 baking을 통해 다운로드되지 않았습니다.

릴리스 아카이브로 작업할 때 타르볼에 ns-3-알리논 구성 요소를 더 쉽게 조립할 수 있는 편리한 스크립트가 있습니다. build.py라고 합니다. 이 프로그램은 가장 유용한 방식으로 프로젝트를 설정합니다. 그러나 ns-3을 사용한 고급 설정 및 작업에는 일반적으로 이 튜토리얼의 뒷부분에서 소개할 ns-3의 자체 빌드 시스템인 Waf를 사용하는 것이 포함됩니다.

다음을 사용하여 다운로드한 경우 타르볼, 그런 다음 디렉터리에 ~/작업 공간 다음과 같은 이름을 가진 디렉토리 ns-알리논-3.29. 다음을 입력:

$ ./build.py --enable-examples --enable-tests

전화할 때 build.py 이 튜토리얼에서 사용된 예제와 테스트를 빌드하기 위해 명령줄 인수를 사용했는데, 이는 ns-3에서는 기본적으로 빌드되지 않습니다. 기본적으로 프로그램은 사용 가능한 모든 모듈도 빌드합니다. 그런 다음 원한다면 예제나 테스트 없이 ns-3을 구축하거나 작업에 필요하지 않은 모듈을 제외할 수 있습니다.

로드한 다양한 부분을 빌드할 때 스크립트에 의해 표시되는 많은 컴파일러 출력 메시지를 볼 수 있습니다. 먼저 스크립트는 애니메이터를 구축하려고 시도합니다. 네타님, 바인딩 생성기 피빈젠 마지막으로 ns-3입니다. 프로세스가 완료되면 다음이 표시됩니다.

Waf: Leaving directory '/path/to/workspace/ns-allinone-3.29/ns-3.29/build'
'build' finished successfully (6m25.032s) 

Modules built:
antenna                aodv                     applications
bridge                 buildings                config-store
core                   csma                     csma-layout
dsdv                   dsr                      energy 
fd-net-device          flow-monitor             internet
internet-apps          lr-wpan                  lte
mesh                   mobility                 mpi
netanim (no Python)    network                  nix-vector-routing 
olsr                   point-to-point           point-to-point-layout 
propagation            sixlowpan                spectrum 
stats                  tap-bridge               test (no Python) 
topology-read          traffic-control          uan 
virtual-net-device     visualizer               wave 
wifi                   wimax 

Modules not built (see ns-3 tutorial for explanation):
brite                  click                    openflow 
Leaving directory ./ns-3.29

목록의 마지막 세 줄에는 빌드되지 않은 모듈에 대한 메시지가 표시됩니다.

Modules not built (see ns-3 tutorial for explanation):
brite                     click

이는 단순히 외부 라이브러리에 의존하는 일부 ns-3 모듈이 구축되지 않았거나 이 구성을 위해 구축할 필요가 없음을 의미합니다. 이는 시뮬레이터가 조립되지 않았거나 조립된 모듈이 올바르게 작동하지 않는다는 의미는 아닙니다.

3.4.2 베이크로 만들기

위에서 베이킹을 사용하여 프로젝트 저장소에서 소스 코드를 가져온 경우 이를 계속 사용하여 ns-3을 빌드할 수 있습니다. 다이얼:

$ ./bake.py build

그러면 다음과 같은 내용이 표시됩니다.

>> Building pybindgen-0.19.0.post4+ng823d8b2 - OK 
>> Building netanim-3.108 - OK 
>> Building ns-3.29 - OK

툴팁: "bake.py 배포"를 호출하여 다운로드와 빌드 단계를 동시에 수행할 수도 있습니다.

모든 구성 요소를 조립하는 데 실패할 수 있지만 구성 요소가 필요하지 않으면 조립이 계속됩니다. 예를 들어, 최근 이식성 문제는 다음과 같습니다. 캐스트xml 도구로 조립 가능 굽​​다 모든 플랫폼에 있는 것은 아닙니다. 이 경우 다음과 같은 메시지가 나타납니다.

>> Building castxml - Problem 
> Problem: Optional dependency, module "castxml" failed
This may reduce the functionality of the final build.
However, bake will continue since "castxml" is not an essential dependency.
For more information call bake with -v or -vvv, for full verbose mode.

하지만 캐스트xml 업데이트된 Python 바인딩을 생성하려는 경우에만 필요합니다. 대부분의 사용자에게는 이 작업이 필요하지 않으므로(적어도 ns-3을 변경할 때까지는) 현재로서는 그러한 경고를 무시해도 됩니다.

실패할 경우 다음 명령은 누락된 종속성에 대한 힌트를 제공합니다.

$ ./bake.py show

빌드하려는 패키지의 다양한 종속성이 나열됩니다.

3.4.3 Waf로 구축

지금까지 ns-3 구축을 시작하기 위해 우리는 다음 중 하나의 스크립트를 사용했습니다. build.py, 또는 도구 굽​​다. 이러한 도구는 ns-3을 구축하고 라이브러리를 유지하는 데 유용합니다. 실제로 빌드하기 위해 빌드 도구를 실행합니다. 와프 ns-3 디렉토리에서. 와프 ns-3 소스 코드와 함께 설치됩니다. 대부분의 사용자는 ns‑3를 구성하고 조립하는 데 빠르게 직접 사용하게 됩니다. 와프. 계속하려면 원래 생성한 ns-3 디렉터리로 이동하세요.

현재로서는 이것이 꼭 필요한 것은 아니지만, 조금 되돌아가서 프로젝트 구성을 변경하는 방법을 알아보는 것이 유용할 것입니다. 아마도 가장 유용한 구성 변경은 코드의 최적화된 버전을 만드는 것일 것입니다. 기본적으로 디버그 버전을 빌드하도록 프로젝트를 구성했습니다. 최적화된 빌드를 생성하기 위한 프로젝트를 살펴보겠습니다. 예제와 테스트를 포함하는 최적화된 빌드를 만들어야 함을 Waf에 설명하려면 다음 명령을 실행해야 합니다.

$ ./waf clean 
$ ./waf configure --build-profile=optimized --enable-examples --enable-tests

시작됩니다 와프 (귀하의 편의를 위해) 로컬 디렉토리 외부에 있습니다. 첫 번째 명령은 이전 빌드에서 정리합니다. 이는 일반적으로 꼭 필요한 것은 아니지만 좋은 습관입니다(아래 빌드 프로필도 참조). 이렇게 하면 이전에 생성된 라이브러리와 디렉터리에 있는 개체 파일이 삭제됩니다. 짓다/. 프로젝트가 재구성되고 빌드 시스템이 다양한 종속성을 확인하면 다음과 유사한 출력이 표시됩니다.

Setting top to      : /home/ns3user/workspace/bake/source/ns-3-dev
Setting out to      : /home/ns3user/workspace/bake/source/ns-3-dev/build
Checking for 'gcc' (C compiler)        : /usr/bin/gcc 
Checking for cc version                : 7.3.0 
Checking for 'g++' (C++ compiler)      : /usr/bin/g++ 
Checking for compilation flag -march=native support : ok 
Checking for compilation flag -Wl,--soname=foo support : ok 
Checking for compilation flag -std=c++11 support       : ok 
Checking boost includes   : headers not found, please ,!provide a --boost-includes argument (see help) 
Checking boost includes   : headers not found, please ,!provide a --boost-includes argument (see help) 
Checking for program 'python'            : /usr/bin/python 
Checking for python version >= 2.3       : 2.7.15 python-config                                                                     : /usr/bin/python-config
Asking python-config for pyembed '--cflags --libs --ldflags' flags : yes
Testing pyembed configuration                                      : yes
Asking python-config for pyext '--cflags --libs --ldflags' flags   : yes
Testing pyext configuration                                        : yes

Checking for compilation flag -fvisibility=hidden support          : ok 
Checking for compilation flag -Wno-array-bounds support            : ok 
Checking for pybindgen location          : ../pybindgen ,!(guessed) 
Checking for python module 'pybindgen'   : 0.19.0. ,!post4+g823d8b2 
Checking for pybindgen version           : 0.19.0. ,!post4+g823d8b2 
Checking for code snippet                : yes 
Checking for types uint64_t and unsigned long equivalence : no 
Checking for code snippet                                 : no 
Checking for types uint64_t and unsigned long long equivalence     : yes 
Checking for the apidefs that can be used for Python bindings                       : gcc-LP64 
Checking for internal GCC cxxabi         : complete 
Checking for python module 'pygccxml'    : not found 
Checking for click location              : not found 
Checking for program 'pkg-config'        : /usr/bin/pkg- ,!config 
Checking for 'gtk+-3.0'                  : not found 
Checking for 'libxml-2.0'                : yes 
checking for uint128_t                   : not found 
checking for __uint128_t                 : yes 
Checking high precision implementation   : 128-bit integer ,!(default) 
Checking for header stdint.h             : yes 
Checking for header inttypes.h           : yes 
Checking for header sys/inttypes.h       : not found 
Checking for header sys/types.h          : yes 
Checking for header sys/stat.h           : yes 
Checking for header dirent.h             : yes 
Checking for header stdlib.h             : yes 
Checking for header signal.h             : yes 
Checking for header pthread.h            : yes 
Checking for header stdint.h             : yes 
Checking for header inttypes.h           : yes 
Checking for header sys/inttypes.h       : not found
Checking for library rt                  : yes 
Checking for header sys/ioctl.h          : yes 
Checking for header net/if.h             : yes 
Checking for header net/ethernet.h       : yes 
Checking for header linux/if_tun.h       : yes 
Checking for header netpacket/packet.h   : yes 
Checking for NSC location                : not found 
Checking for 'sqlite3'                   : not found 
Checking for header linux/if_tun.h       : yes 
Checking for python module 'gi'          : 3.26.1 
Checking for python module 'gi.repository.GObject'      : ok 
Checking for python module 'cairo'                      : ok 
Checking for python module 'pygraphviz'                 : 1.4rc1 
Checking for python module 'gi.repository.Gtk'          : ok 
Checking for python module 'gi.repository.Gdk'          : ok 
Checking for python module 'gi.repository.Pango'        : ok 
Checking for python module 'gi.repository.GooCanvas'    : ok 
Checking for program 'sudo'                             : /usr/bin/sudo 
Checking for program 'valgrind'                         : not found 
Checking for 'gsl' : not found python-config            : not found 
Checking for compilation flag -fstrict-aliasing support : ok 
Checking for compilation flag -fstrict-aliasing support : ok 
Checking for compilation flag -Wstrict-aliasing support : ok 
Checking for compilation flag -Wstrict-aliasing support : ok 
Checking for program 'doxygen'                          : /usr/bin/doxygen
---- Summary of optional ns-3 features:
Build profile : optimized
Build directory : 
BRITE Integration : not enabled (BRITE not enabled (see option --with- ,!brite)) 
DES Metrics event collection : not enabled (defaults to disabled) 
Emulation FdNetDevice        : enabled 
Examples                     : enabled 
File descriptor NetDevice    : enabled 
GNU Scientific Library (GSL) : not enabled (GSL not found) 
Gcrypt library               : not enabled
(libgcrypt not found: you can use ,!libgcrypt-config to find its location.) GtkConfigStore               : not enabled (library 'gtk+-3.0 >= 3.0' not fou   nd)
MPI Support                  : not enabled (option --enable-mpi not selected)
ns-3 Click Integration       : not enabled (nsclick not enabled (see option --with- ,!nsclick))
ns-3 OpenFlow Integration   : not enabled (Required boost libraries not found) 
Network Simulation Cradle    : not enabled (NSC not found (see option --with-nsc))
PlanetLab FdNetDevice         : not enabled (PlanetLab operating system not detected ,!(see option --force-planetlab)) PyViz visualizer : enabled 
Python API Scanning Support   : not enabled (Missing 'pygccxml' Python module)
Python Bindings : enabled 
Real Time Simulator           : enabled 
SQlite stats data output      : not enabled (library 'sqlite3' not found)
Tap Bridge                    : enabled 
Tap FdNetDevice               : enabled
Tests                         : enabled 
Threading Primitives          : enabled 
Use sudo to set suid bit   : not enabled (option --enable-sudo not selected)
XmlIo                         : enabled
'configure' finished successfully (6.387s)

위 목록의 마지막 부분을 참고하세요. 일부 ns-3 옵션은 기본적으로 활성화되어 있지 않거나 제대로 작동하려면 시스템 지원이 필요합니다. 예를 들어 XmlTo를 활성화하려면 라이브러리가 시스템에 있어야 합니다. libxml-2.0. 이 라이브러리를 찾을 수 없고 해당 ns-3 기능이 활성화되지 않은 경우 메시지가 표시됩니다. 또한 명령을 사용할 수 있습니다. sudo는 특정 프로그램에 대해 suid 비트 "런타임에 그룹 ID 설정"을 설정합니다. 기본적으로 활성화되어 있지 않으므로 이 기능은 "활성화되지 않음"으로 표시됩니다. 마지막으로 활성화된 옵션 목록을 얻으려면 다음을 사용하세요. 와프 매개변수 포함 --check-config.

이제 예제와 테스트가 포함된 디버그 빌드로 다시 전환해 보겠습니다.

$ ./waf clean 
$ ./waf configure --build-profile=debug --enable-examples --enable-tests

이제 빌드 시스템이 설정되었으며 다음을 입력하기만 하면 ns-3 프로그램의 디버그 버전을 빌드할 수 있습니다.

$ ./waf

위의 단계로 인해 ns-3 시스템의 일부를 두 번 빌드해야 했을 수도 있지만 이제 구성을 변경하고 최적화된 코드를 빌드하는 방법을 알게 되었습니다.

특정 프로젝트 구성에 대해 어떤 프로필이 활성화되어 있는지 확인하려면 다음 명령이 있습니다.

$ ./waf --check-profile 
Waf: Entering directory `/path/to/ns-3-allinone/ns-3.29/build' 
Build profile: debug

위의 시나리오 build.py 인수도 지원합니다 --enable-examples и --enable-tests, 그러나 다른 옵션 와프 직접적으로 지원하지는 않습니다. 예를 들어 다음은 작동하지 않습니다.

$ ./build.py --disable-python

반응은 다음과 같습니다.

build.py: error: no such option: --disable-python

그러나 특수 연산자 - -를 사용하면 다음을 통해 추가 매개변수를 전달할 수 있습니다. waf따라서 위의 명령 대신 다음 명령이 작동합니다.

$ ./build.py -- --disable-python

기본 명령을 생성하기 때문에 ./waf 구성 --disable-python. 여기에 대한 몇 가지 추가 소개 팁이 있습니다. 와프.

빌드 오류 처리

ns-3 릴리스는 일반적인 Linux 및 MacOS 배포판에서 릴리스 당시 사용 가능한 최신 C++ 컴파일러에서 테스트되었습니다. 그러나 시간이 지남에 따라 새로운 컴파일러와 함께 새로운 배포판이 출시되며 이러한 최신 컴파일러는 경고에 대해 더욱 현학적 인 경향이 있습니다. ns-3은 모든 경고를 오류로 처리하도록 빌드를 구성하므로 때로는 최신 시스템에서 이전 버전을 실행하는 경우 컴파일러 경고로 인해 빌드가 중지될 수 있습니다.

예를 들어, 이전에 새로운 주요 버전이 포함된 Fedora 3.28용 ns‑28 릴리스가 있었습니다. GCC (gcc-8). Gtk3.28+가 설치된 Fedora 28에서 릴리스 ns-2 또는 이전 버전을 빌드하면 다음 오류가 발생합니다.

/usr/include/gtk-2.0/gtk/gtkfilechooserbutton.h:59:8: error: unnecessary parentheses ,!in declaration of ‘__gtk_reserved1’ [-Werror=parentheses] void (*__gtk_reserved1);

ns‑3.28.1부터 시작하는 릴리스에서는 와프 이러한 문제를 해결하기 위한 옵션이 있습니다. g++ 및 clang++에서 "-Werror" 플래그 설정을 비활성화합니다. 이는 "--disable-werror" 옵션이며 구성 중에 적용해야 합니다.

$ ./waf configure --disable-werror --enable-examples --enable-tests

구성 또는 조립

일부 명령 와프 구성 단계에서만 의미가 있으며 일부는 빌드 단계에서만 유효합니다. 예를 들어, ns-3 에뮬레이션 기능을 사용하려면 비트 설정을 활성화하면 됩니다. SUID 사용 sudo는, 위에서 설명한대로. 이는 구성 단계 명령을 재정의하므로 예제와 테스트도 포함된 다음 명령을 사용하여 구성을 변경할 수 있습니다.

$ ./waf configure --enable-sudo --enable-examples --enable-tests

이렇게 하면 와프 시작할 것이다 sudo는권한으로 실행되도록 에뮬레이션 코드 소켓 생성 프로그램을 변경하려면 뿌리. 에 와프 구성 및 빌드 단계에 사용할 수 있는 다른 옵션이 많이 있습니다. 옵션을 살펴보려면 다음을 입력하세요.

$ ./waf --help

다음 섹션에서는 몇 가지 테스트 관련 옵션을 사용하겠습니다.

어셈블리 프로파일

우리는 이미 구성 방법을 살펴보았습니다. 와프 어셈블리용 디버그 и 최적화:

$ ./waf --build-profile=debug

중간 조립 프로파일도 있고, 공개. 옵션 -d 와 동의어입니다 --build-profile. 빌드 프로필은 로깅, 어설션 및 컴파일러 최적화 스위치의 사용을 제어합니다.

보시다시피 로깅 및 어설션은 디버그 빌드에서만 사용할 수 있습니다. 권장되는 방법은 디버그 모드에서 스크립트를 개발한 다음 최적화된 빌드 프로필에서 반복 실행(통계 또는 매개변수 변경을 위해)을 수행하는 것입니다.

특정 빌드 프로필에서만 실행해야 하는 코드가 있는 경우 코드 래퍼 매크로를 사용하세요.

NS_BUILD_DEBUG (std::cout << "Part of an output line..." << std::flush; timer.Start ,!()); DoLongInvolvedComputation ();
NS_BUILD_DEBUG (timer.Stop (); std::cout << "Done: " << timer << std::endl;)

기본, 와프 빌드 디렉토리에 빌드 아티팩트를 배치합니다. 옵션을 사용하여 다른 출력 디렉터리를 지정할 수 있습니다. - -out예 :

$ ./waf configure --out=my-build-dir

이를 빌드 프로필과 결합하면 다양한 컴파일 옵션 간에 쉽게 전환할 수 있습니다.

$ ./waf configure --build-profile=debug --out=build/debug
$ ./waf build
... 
$ ./waf configure --build-profile=optimized --out=build/optimized 
$ ./waf build
...

이를 통해 매번 최신 어셈블리를 다시 작성할 필요 없이 여러 어셈블리로 작업할 수 있습니다. 다른 프로필로 전환하면 와프 모든 것을 완전히 다시 컴파일하지 않고 그것만 컴파일합니다.

이러한 방식으로 빌드 프로필을 전환하는 경우 매번 동일한 구성 옵션을 제공하도록 주의해야 합니다. 여러 환경 변수를 정의하면 실수를 방지하는 데 도움이 됩니다.

$ export NS3CONFIG="--enable-examples --enable-tests" 
$ export NS3DEBUG="--build-profile=debug --out=build/debug"
$ export NS3OPT=="--build-profile=optimized --out=build/optimized" 

$ ./waf configure $NS3CONFIG $NS3DEBUG
$ ./waf build 
... 
$ ./waf configure $NS3CONFIG $NS3OPT
$ ./waf build

컴파일러 및 플래그

위의 예에서는 와프 ns-3을 빌드하려면 GCC의 C++ 컴파일러를 사용합니다( g ++). 그러나 사용하는 것을 변경할 수 있습니다 와프 C++ 컴파일러(CXX 환경 변수 정의) 예를 들어 C++ 컴파일러 Clang, clang++,

$ CXX="clang++" ./waf configure 
$ ./waf build 

같은 방법으로 구성할 수 있습니다. 와프 다음을 사용하여 분산 컴파일을 사용하려면 distcc:

$ CXX="distcc g++" ./waf configure 
$ ./waf build

distcc 및 분산 컴파일에 대한 자세한 내용은 문서 섹션의 프로젝트 페이지에서 확인할 수 있습니다. ns-3을 구성할 때 컴파일러 플래그를 추가하려면 CXXFLAGS_EXTRA 환경 변수를 사용하십시오.

설치

와프 시스템의 다른 위치에 라이브러리를 설치하는 데 사용할 수 있습니다. 기본적으로 컴파일된 라이브러리와 실행 파일은 디렉터리에 있습니다. 빌드, Waf는 이러한 라이브러리와 실행 파일의 위치를 ​​알고 있으므로 다른 곳에 라이브러리를 설치할 필요가 없습니다.

사용자가 빌드 디렉터리 외부에 설치하려는 경우 다음 명령을 실행할 수 있습니다. ./waf 설치. 설치를 위한 기본 접두사는 다음과 같습니다. / usr / local그래서 ./waf 설치 프로그램을 설치할 것입니다 / usr / local / bin, 도서관 / usr / local / lib 및 헤더 파일 /usr/로컬/포함. 수퍼유저 권한은 일반적으로 기본 접두사를 사용하여 설정해야 하므로 일반적인 명령은 다음과 같습니다. sudo ./waf 설치. Waf는 시작되면 먼저 빌드 디렉터리의 공유 라이브러리를 사용하도록 선택한 다음 로컬 환경에 구성된 라이브러리의 경로를 따라 라이브러리를 찾습니다. 따라서 시스템에 라이브러리를 설치할 때 올바른 라이브러리가 사용되고 있는지 확인하는 것이 좋습니다. 사용자는 구성 중에 옵션을 전달하여 다른 접두사로 설치하도록 선택할 수 있습니다. --prefix예 :

./waf configure --prefix=/opt/local

나중에 빌드 후 사용자가 설치 명령을 입력하는 경우 ./waf, 접두사가 사용됩니다 /선택/로컬.

팀 ./waf clean 설치에서 사용할 경우 프로젝트를 재구성하기 전에 사용해야 합니다. 와프 다른 접두사로.

따라서 ns-3을 사용하기 위해 호출할 필요가 없습니다. ./waf install. 대부분의 사용자에게는 이 명령이 필요하지 않습니다. 와프 는 빌드 디렉토리에서 현재 라이브러리를 선택하지만 일부 사용자는 활동이 ns-3 디렉토리 외부의 프로그램 작업과 관련된 경우 이 기능이 유용할 수 있습니다.

와프 싱글

ns-3 소스 트리의 최상위 수준에는 Waf 스크립트가 하나만 있습니다. 일단 작업을 시작하면 디렉토리에서 많은 시간을 보내게 됩니다. scratch/ 아니면 더 깊게src/... 동시에 달려야 한다 와프. 자신이 어디에 있는지 기억하고 달려가면 됩니다. 와프 다음과 같이

$ ../../../waf ...

하지만 이는 지루하고 오류가 발생하기 쉬우므로 더 나은 솔루션이 있습니다. 일반적인 방법 중 하나는 다음과 같은 텍스트 편집기를 사용하는 것입니다. 이맥스 또는 정력, 두 개의 터미널 세션이 열려 있는데, 하나는 ns-3을 빌드하는 데 사용되고 두 번째는 소스 코드를 편집하는 데 사용됩니다. 당신이 가지고 있다면 타르볼, 환경 변수가 도움이 될 수 있습니다.

$ export NS3DIR="$PWD" 
$ function waff { cd $NS3DIR && ./waf $* ; } 

$ cd scratch 
$ waff build

모듈 디렉토리에 다음과 같은 간단한 waf 스크립트를 추가하고 싶을 수도 있습니다. exec ../../waf. 하지 마세요. 이는 초보자에게는 혼란스럽고 제대로 수행되지 않으면 감지하기 어려운 빌드 오류로 이어집니다. 위에 표시된 솔루션은 사용해야 하는 경로입니다.

3.5 ns-3 테스트

스크립트를 실행하여 ns-3 배포판의 단위 테스트를 실행할 수 있습니다. ./test.py:

$ ./test.py

이러한 테스트는 다음과 동시에 실행됩니다. 와프. 결국 다음과 같은 메시지가 표시됩니다.

92 of 92 tests passed (92 passed, 0 failed, 0 crashed, 0 valgrind errors)

이는 valgrind 충돌, 충돌 또는 오류를 식별하고 코드 문제 또는 도구와 코드 간의 비호환성을 나타내는 중요한 메시지입니다.

또한 다음의 최종 출력도 볼 수 있습니다. 와프 각 테스트를 실행하는 테스터는 다음과 같습니다.

Waf: Entering directory `/path/to/workspace/ns-3-allinone/ns-3-dev/build' 
Waf: Leaving directory `/path/to/workspace/ns-3-allinone/ns-3-dev/build' 
'build' finished successfully (1.799s) 

Modules built:
aodv           applications          bridge
click          config-store          core
csma           csma-layout           dsdv
emu            energy                flow-monitor
internet       lte                   mesh
mobility       mpi                   netanim
network        nix-vector-routing    ns3tcp
ns3wifi        olsr                  openflow
point-to-point point-to-point-layout propagation
spectrum       stats                 tap-bridge
template       test                  tools
topology-read  uan                   virtual-net-device
visualizer     wifi                  wimax

PASS: TestSuite ns3-wifi-interference
PASS: TestSuite histogram 

...

PASS: TestSuite object
PASS: TestSuite random-number-generators
92 of 92 tests passed (92 passed, 0 failed, 0 crashed, 0 valgrind errors)

이 명령은 일반적으로 사용자가 ns-3 배포판이 올바르게 빌드되었는지 신속하게 확인하기 위해 실행됩니다. ("PASS: ..." 줄의 순서는 다를 수 있지만 이는 정상입니다. 중요한 것은 보고서 끝의 요약 줄에 모든 테스트가 통과했음을 표시한다는 것입니다. 어떤 테스트도 실패하거나 충돌하지 않았습니다.) 그리고 와프과 test.py 시스템의 사용 가능한 프로세서 코어 전체에서 작업을 병렬화합니다.

3.6 스크립트 실행

우리는 일반적으로 통제하에 스크립트를 실행합니다. 와프. 이를 통해 빌드 시스템은 공유 라이브러리 경로가 올바르게 설정되었는지, 런타임 시 라이브러리를 사용할 수 있는지 확인할 수 있습니다. 프로그램을 실행하려면 다음을 사용하십시오. 와프 매개변수 포함 - -run. 유비쿼터스 프로그램에 해당하는 ns-3을 실행해 보겠습니다. 안녕하세요다음을 입력하여:

$ ./waf --run hello-simulator

Waf는 먼저 프로그램이 올바르게 빌드되었는지 확인하고 필요한 경우 빌드합니다. 그 다음에 와프 다음 출력을 생성하는 프로그램을 실행합니다.

Hello Simulator

축하해요! 이제 ns-3 사용자가 되셨습니다!

결과가 보이지 않으면 어떻게 해야 합니까?

메시지가 표시되는 경우 와프빌드가 성공적으로 완료되었음을 나타내지만 출력이 표시되지 않습니다. "안녕 시뮬레이터", [Build-with-Waf] 섹션에서 빌드 모드를 다음으로 전환했을 가능성이 있습니다. 최적화, 그러나 모드로 다시 전환하는 것을 놓쳤습니다. 디버그. 이 자습서에 사용된 모든 콘솔 출력은 로깅을 수행하고 사용자 지정 메시지를 콘솔에 인쇄하는 데 사용되는 특수 ns-3 구성 요소를 사용합니다. 최적화된 코드가 컴파일되면 이 구성 요소의 출력이 자동으로 비활성화됩니다. 즉, "최적화"됩니다. "Hello Simulator" 출력이 표시되지 않으면 다음을 입력합니다.

$ ./waf configure --build-profile=debug --enable-examples --enable-tests

구성하다 와프 예제와 테스트가 포함된 ns-3 프로그램의 디버그 버전을 구축합니다. 그런 다음 다음을 입력하여 코드의 현재 디버그 버전을 다시 빌드해야 합니다.

$ ./waf

이제 프로그램을 실행하면 안녕하세요 시뮬레이터, 예상된 결과가 표시되어야 합니다.

3.6.1 명령줄 인수

ns-3 프로그램에 명령줄 인수를 전달하려면 다음 패턴을 사용합니다.

$ ./waf --run <ns3-program> --command-template="%s <args>"

바꾸다 프로그램 이름과 인수에. 논쟁 - -command-template 에 와프 본질적으로 실제 명령줄을 작성하기 위한 레시피입니다. 와프 프로그램을 실행하는데 사용됩니다. Waf는 빌드가 완료되었는지 확인하고 공유 라이브러리 경로를 설정한 다음 제공된 명령줄 템플릿을 사용하고 %s 자리 표시자를 프로그램 이름으로 대체하여 실행 파일을 호출합니다. 이 구문이 복잡하다고 생각되면 ns-3 프로그램과 작은따옴표로 묶인 인수를 포함하는 더 간단한 버전이 있습니다.

$ ./waf --run '<ns3-program> --arg1=value1 --arg2=value2 ...'

특히 유용한 또 다른 예는 테스트 스위트를 선택적으로 실행하는 것입니다. mytest라는 테스트 스위트가 있다고 가정해 봅시다(실제로는 없습니다). 위에서는 ./test.py 스크립트를 사용하여 테스트 프로그램을 반복적으로 호출하는 여러 테스트를 병렬로 실행했습니다. 테스트 러너. 부르다 테스트 러너 하나의 테스트를 직접 실행하려면 다음을 수행하세요.

$ ./waf --run test-runner --command-template="%s --suite=mytest --verbose"

인수는 프로그램에 전달됩니다. 테스트 러너. mytest가 존재하지 않으므로 오류 메시지가 생성됩니다. 사용 가능한 테스트 실행기 옵션을 인쇄하려면 다음을 입력하십시오.

$ ./waf --run test-runner --command-template="%s --help"

3.6.2 디버깅

디버거와 같은 다른 유틸리티에서 ns-3 프로그램을 실행하려면(예: gdb) 또는 메모리 테스트 도구(예: Valgrind), 유사한 형식을 사용하십시오. - -command-template = "…". 예를 들어 디버거에서 실행하려면 gdb 인수가 포함된 hello-simulator ns-3 프로그램:

$ ./waf --run=hello-simulator --command-template="gdb %s --args <args>"

ns-3 프로그램 이름은 인수와 함께 제공됩니다. - -run및 관리 유틸리티(여기 gdb)는 인수의 첫 번째 토큰입니다. - -command-template. 옵션 - -args 보고서 gdb나머지 명령줄은 "하위" 프로그램에 속합니다. (일부 버전 gdb 옵션을 이해하지 못함 - -args. 이 경우 프로그램 인수를 제거하십시오. - -command-template 명령 세트를 사용하십시오 gdb 인수.) 이 레시피와 이전 레시피를 결합하여 디버거에서 테스트를 실행할 수 있습니다.

$ ./waf --run test-runner --command-template="gdb %s --args --suite=mytest --verbose"

3.6.3 작업 디렉토리

Waf는 ns-3 트리 상단에 있는 위치에서 시작되어야 합니다. 이 폴더는 출력 파일이 기록되는 작업 디렉터리가 됩니다. 하지만 이러한 파일을 ns-3 소스 트리 외부에 보관하려면 어떻게 해야 할까요? 인수 사용 - -cwd:

$ ./waf --cwd=...

작업 디렉터리에 출력 파일을 가져오는 것이 더 편리할 수 있습니다. 이 경우 다음과 같은 간접적인 조치가 도움이 될 수 있습니다.

$ function waff {
CWD="$PWD" 
cd $NS3DIR >/dev/null 
./waf --cwd="$CWD" $*
cd - >/dev/null 
}

이전 버전의 명령 장식은 현재 작업 디렉터리를 유지하고 다음 디렉터리로 이동합니다. 와프그리고는 지시한다 와프 프로그램을 시작하기 전에 저장된 현재 작업 디렉토리로 작업 디렉토리를 다시 변경합니다. 우리는 팀을 언급합니다 - -cwd 완전성을 위해 대부분의 사용자는 단순히 최상위 디렉터리에서 Waf를 실행하고 거기에서 출력 파일을 생성합니다.

계속: 4장

출처 : habr.com