Водич за симулатор мреже нс-3. Поглавље 3

поглавље 1,2

3 Почетак рада
3.1 Преглед
3.2 Предуслови
3.2.1 Преузимање нс-3 издања као изворне архиве
3.3 Преузимање нс-3 користећи Гит
3.3.1 Учитавање нс-3 користећи Баке
3.4 Монтажа нс-3
3.4.1 Изградња са буилд.пи
3.4.2 Изградња са Баке
3.4.3 Направи са Ваф-ом
3.5 Тестирање нс-3
3.6 Покретање скрипте
3.6.1 Аргументи командне линије
3.6.2 Отклањање грешака
3.6.3 Радни именик

Поглавље КСНУМКС

Почетак

Ово поглавље има за циљ да припреми читаоца да почне са рачунаром који можда никада није инсталирао нс-3. Покрива подржане платформе, предуслове, како да добијете нс-3, како да направите нс-3 и како да тестирате своју изградњу и покренете једноставне програме.

3.1 Преглед

нс-3 симулатор је изграђен као систем библиотека софтвера за сарадњу. Током асемблера, код корисничких програма се повезује са овим библиотекама. Програмски језици Ц++ или Питхон се користе за писање прилагођених програма.

Нс-3 се дистрибуира као изворни код, што значи да циљни систем мора имати окружење за развој софтвера да би се прво изградиле библиотеке, а затим изградио кориснички програм. У принципу, нс-3 би се могли дистрибуирати као готове библиотеке за одређени систем, ау будућности би се могле дистрибуирати на овај начин. Али данас многи корисници заправо раде свој посао уређујући сам нс-3, тако да је корисно имати изворни код за прављење библиотека. Ако неко жели да преузме посао креирања готових библиотека и пакета за оперативне системе, нека се јави на мејлинг листу нс-програмери.

Затим ћемо погледати три начина за преузимање и прављење нс-3. Први је да преузмете и направите званично издање са главног сајта. Други је избор и склапање копија развојних верзија основне нс-3 инсталације. Треће је коришћење додатних алата за прављење за учитавање више екстензија за нс-3. Проћи ћемо кроз сваки јер се алати мало разликују.

Искусни корисници Линука могу се запитати зашто нс-3 није обезбеђен као пакет као већина других библиотека које користе менаџер пакета? Иако постоје бинарни пакети за различите Линук дистрибуције (нпр. Дебиан), већина корисника на крају уређује библиотеке и мора сами да поново изгради нс-3, тако да је доступност изворног кода згодна. Из тог разлога, фокусираћемо се на инсталацију из извора.

За већину апликација нс-3 права корен нису потребни, препоручује се коришћење непривилегованог корисничког налога.

3.2 Предуслови

Цео скуп доступних нс-3 библиотека има бројне зависности од библиотека трећих страна, али углавном нс-3 може да се направи и користи уз подршку за неколико уобичајених (често инсталираних подразумевано) компоненти: Ц++ компајлер, Питхон, уређивач изворног кода (нпр. енергија, емацс или Ецлипсе) и, ако се користе развојна спремишта, Гит системи за контролу верзија. Већина нових корисника неће морати да брине ако њихова конфигурација пријави да неке нс-3 напредне функције недостају, али за оне који желе потпуну инсталацију, пројекат обезбеђује вики који укључује странице са пуно корисних савета и трикова. Једна таква страница је страница за инсталацију, са упутствима за инсталацију за различите системе, доступна на: https://www.nsnam.org/wiki/Installation.

Одељак Предуслови на овом викију објашњава који су пакети потребни за подршку уобичајених нс-3 опција и такође пружа команде које се користе за њихову инсталацију на уобичајеним верзијама Линук-а или мацОС-а.

Можете искористити ову прилику да истражите нс-3 вики страницу или главну веб локацију: https://www.nsnam.org, јер тамо има много информација. Почевши од најновије верзије нс-3 (нс-3.29), следећи алати су потребни за покретање нс-3:

Пакет алата/верзија

• Ц++ компајлер
  цланг++ или г++ (г++ верзија 4.9 или новија)
• Питон
  питхон2 верзија >= 2.7.10, или верзија питхон3 >=3.4
• гит
  било коју најновију верзију (за приступ нс-3 на ГитЛаб.цом)
• катран
  било коју најновију верзију (за распакивање нс‑3 издања)
• бунзип2
  било коју најновију верзију (за распакивање нс‑3 издања)

Да бисте проверили подразумевану верзију Питхон-а, откуцајте python -V. Да бисте проверили верзију г++, откуцајте g++ -v. Ако неки алати недостају или су престари, погледајте водич за инсталацију на нс-3 вики страници.

Од сада, претпостављамо да читач користи Линук, МацОС или Линук емулатор и да има барем горе наведене алате.

3.2.1 Преузимање нс-3 издања као изворне архиве

Ово је ток акције за новог корисника који жели да преузме и експериментише са најновијим издањем и верзијама пакета нс-3. нс-3 издања се објављују као компресоване изворне архиве, које се понекад називају тарбалл. тарбалл је посебан формат софтверске архиве у којем се неколико датотека комбинује заједно. Архива је обично компримована. нс-3 процес покретања преко тарбалл је једноставно, само треба да изаберете издање, преузмете га и распакујете.

Претпоставимо да ви, као корисник, желите да направите нс-3 у локалном директоријуму под називом радни простор. Можете добити радну копију издања уношењем следећег у Линук конзолу (наравно, заменом одговарајућих бројева верзија)

$ 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 

Обратите пажњу на горе коришћени услужни програм вгет, који је алат командне линије за преузимање објеката са Интернета. Ако га нисте инсталирали, можете користити свој претраживач за ово.

Праћење ових корака одвешће вас до директоријума нс-аллиноне-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

Сада сте спремни да направите нс-3 базну дистрибуцију и можете да пређете на одељак о изградњи нс-3.

3.3 Преузимање нс-3 користећи Гит

нс-3 код је доступан у Гит репозиторијумима на ГитЛаб.цом на адреси https://gitlab.com/nsnam/... Група нснам обједињује различита спремишта која користи пројекат отвореног кода.

Најлакши начин да почнете да користите Гит спремишта је да рачвате или клонирате окружење нс-3-алинон. Ово је скуп скрипти који управља учитавањем и склапањем најчешће коришћених нс-3 подсистема. Ако сте нови у Гиту, термини „форк“ и „клон“ можда вам нису познати; ако јесте, препоручујемо вам да једноставно клонирате (направите сопствену копију) спремиште које се налази на ГитЛаб.цом овако:

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

У овој фази, приказ вашег именика нс-3-алинон мало другачији од горе описаног директоријума архиве издања. Требало би да изгледа отприлике овако:

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

Имајте на уму да постоји скрипта довнлоад.пи, који ће додатно издвојити нс-3 и пратећи изворни код. Овде имате избор: или преузмите најновији снимак развоја нс-3:

$ python download.py

или више волите нс-3 ослобађање користећи заставу -n да означите број издања:

$ python download.py -n ns-3.29

Након овог корака до директоријума нс-3-алинон биће преузета додатна спремишта нс-3, пећи, пибиндген и нетаним.

Приметити
На машини са чистим Убунту16.04, морао сам да променим команду на ову: $ sudo python3 download.py -n ns-3.29 (у даљем тексту напомене преводиоца).

3.3.1 Учитавање нс-3 користећи Баке

Горње две методе (изворна архива или спремиште нс-3-алинон преко Гита) корисни су за добијање најједноставније инсталације нс-3 са више додатака (пибиндген да генерише Питхон везе и нетаним за мрежну анимацију). Позива се треће спремиште које је подразумевано обезбеђено у нс-3-алинону пећи.

Пеците је алат за координисану изградњу софтвера из више складишта, развијен за нс-3 пројекат. Пеците може се користити за добијање развојних верзија нс-3, као и за преузимање и прављење екстензија основне верзије нс-3 дистрибуције, као што је окружење Директно извршавање кода, ЦрадлеНетворк Симулатион Црадле, могућност креирања нових Питхон веза и разних нс-3 „апликација“.

Приметити
ЦрадлеНетворк Симулатион Црадле је оквир који вам омогућава да користите праве ТЦП/ИП мрежне стекове унутар мрежног симулатора.

Ако очекујете да ваша нс-3 инсталација има напредне или додатне функције, можете пратити ову путању инсталације.

У најновијим нс-3 издањима Пеците је додат катранском издању. Издање укључује конфигурациону датотеку која вам омогућава да преузмете тренутне верзије софтвера у време издавања. То је, на пример, верзија Пеците, који се дистрибуира са издањем нс-3.29, може се користити за преузимање компоненти за то издање нс-3 или раније, али се не може користити за преузимање компоненти за каснија издања (ако је датотека описа пакета бакецонф.кмл није ажурирано).

Такође можете добити најновију копију пећиуносом следеће команде у вашу Линук конзолу (под претпоставком да имате инсталиран Гит):

$ cd 
$ mkdir workspace 
$ cd workspace 
$ git clone https://gitlab.com/nsnam/bake.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

Имајте на уму да сте учитали неколико Питхон скрипти, Питхон модул под називом пећи и КСМЛ конфигурациону датотеку. Следећи корак је коришћење ових скрипти за преузимање и прављење нс-3 дистрибуције по вашем избору. Доступно је неколико циљева прилагођавања:

1. нс-3.29: модул који одговара издању; преузимаће компоненте сличне издању у тарбалл-у;

2. нс-3-дев: сличан модул, али користећи код из развојног стабла;

3. нс-алинон-3.29: Модул који укључује друге додатне функције као што су усмеравање кликова и постоље за мрежну симулацију, Опенфлов за нс-3.

4. нс-3-алинон: слично изданој верзији модула уцело, али за развојни код.

Приметити
Kliknite — модуларна софтверска архитектура за креирање рутера.

Опенфлов је протокол за управљање процесом обраде података који се преносе преко мреже података путем рутера и свичева, имплементирајући софтверски дефинисану мрежну технологију.

Тренутни развојни снимак (без издања) нс-3 се може наћи на:https://gitlab.com/nsnam/ns-3-dev.git.

Програмери покушавају да ова спремишта одржавају у доследном радном реду, али она су у области развоја и садрже необјављени код, тако да ако не планирате да користите нове функције, изаберите званично издање.

Најновију верзију кода можете пронаћи тако што ћете прегледати листу спремишта или отићи на веб страницу нс-3 Релеасес:https://www.nsnam.org/releases/ и кликом на везу најновије верзије. У овом примеру наставићемо са нс-3.29.

Сада, да бисмо добили нс-3 компоненте које су нам потребне, користићемо алатку Пеците. Рецимо неколико уводних речи о делу Пеците.

Баке ради тако што учитава изворе пакета у директоријум извор и инсталирање библиотека у буилд директоријум. Пеците може се покренути позивањем на бинарни фајл, али ако желите да покренете Пеците не из директоријума у ​​који је преузето, препоручљиво је додати путању до пећи до ваше путање (ПАТХ променљива окружења), на пример на следећи начин (пример за Линук басх схелл). Идите у директоријум „баке“, а затим подесите следеће променљиве окружења:

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

Ово ће поставити програм баке.пи на путању љуске и омогућиће другим програмима да пронађу извршне датотеке и библиотеке које је креирао пећи. У неким случајевима употребе пећи, горе описана подешавања ПАТХ и ПИТХОНПАТХ нису потребна, али то обично захтева потпуна израда нс-3-алинона (са додатним пакетима).

Идите у свој радни директоријум и унесите следеће у конзолу:

$ ./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 ...

Конкретно, алати за отпремање као што су Мерцуриал, ЦВС, Гит и Базаар су неопходни у овом кораку јер нам омогућавају да добијемо код. У овом тренутку, инсталирајте алате који недостају на уобичајен начин за ваш систем (ако знате како) или се обратите администратору система за помоћ.

Затим покушајте да преузмете софтвер:

$ ./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

То ће значити да су преузета три извора. Сада идите у изворни директоријум и откуцајте лс; Требало би да видите:

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

Сада сте спремни да направите нс-3 дистрибуцију.

3.4 Монтажа нс-3

Као и код преузимања нс-3, постоји неколико начина за прављење нс-3. Главна ствар коју желимо да нагласимо је да је нс-3 направљен помоћу алата за прављење тзв Вафописано испод. Већина корисника ће радити са Ваф, али постоји неколико згодних скрипти које ће вам помоћи да започнете или организујете сложеније израде. Зато вас молим, пре него што прочитате о Ваф, Погледај буилд.пи и монтажа са пећи.

3.4.1 Изградња са буилд.пи

Упозорење! Овај корак изградње је доступан само из изворне архивске верзије добијене као што је горе описано; а не преузима се путем гит-а или баке-а.

Када радите са архивом издања тарбаллУ нс-3-алинон Постоји згодна скрипта која може олакшати састављање компоненти. Зове се буилд.пи. Овај програм ће поставити пројекат за вас на најкориснији начин. Међутим, имајте на уму да напредније подешавање и рад са нс-3 обично укључује коришћење нс-3 сопственог система изградње, Ваф, који ће бити представљен касније у овом водичу.

Ако сте преузели користећи тарбалл, а затим у вашем именику ~/радни простор директоријум са именом нешто попут нс-алинон-3.29. Унесите следеће:

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

Када се зове буилд.пи Користили смо аргументе командне линије да бисмо направили примере и тестове који се користе у овом водичу, а који нису подразумевано направљени у нс-3. Подразумевано, програм такође гради све доступне модуле. Затим, ако желите, можете да направите нс-3 без примера и тестова, или да искључите модуле који вам нису потребни за рад.

Видећете много излазних порука компајлера које приказује скрипта док гради различите делове које сте учитали. Прво ће сценарио покушати да направи аниматора нетаним, затим генератор везивања пибиндген и на крају нс-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

То једноставно значи да неки нс-3 модули који зависе од екстерних библиотека можда нису изграђени или да нису потребни да буду изграђени за ову конфигурацију. То не значи да симулатор није састављен или да склопљени модули неће радити исправно.

3.4.2 Изградња са Баке

Ако сте користили баке изнад да бисте добили изворни код из складишта пројекта, можете наставити да га користите за прављење нс-3. Позовите:

$ ./bake.py build

и требало би да видите нешто попут:

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

Тоолтип: Такође можете истовремено да урадите и кораке преузимања и прављења тако што ћете позвати „баке.пи деплои“.

Склапање свих компоненти можда неће успети, али састављање ће се наставити ако компонента није потребна. На пример, то је било недавно питање преносивости цасткмл може се саставити помоћу алата пећи не на свим платформама. У овом случају ће се појавити порука попут ове:

>> 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.

Али цасткмл потребно само ако желите да креирате ажуриране Питхон везе. За већину корисника за овим нема потребе (бар док не промене нс-3), па се таква упозорења за сада могу безбедно игнорисати.

Ако не успе, следећа команда ће вам дати наговештај о недостајућим зависностима:

$ ./bake.py show

Биће наведене различите зависности пакета које покушавате да направите.

3.4.3 Направи са Ваф-ом

До ове тачке, да бисмо почели да градимо нс-3, користили смо или скрипту буилд.пи, или алат пећи. Ови алати су корисни за прављење нс-3 и одржавање библиотека. У ствари, да би направили, покрећу алат за прављење Ваф из директоријума нс-3. Ваф инсталиран са нс-3 изворним кодом. Већина корисника брзо прелази на директну употребу за конфигурисање и склапање нс‑3 Ваф. Дакле, да бисте наставили, идите у нс-3 директоријум који сте првобитно креирали.

Ово у овом тренутку није стриктно потребно, али ће бити корисно да се мало вратите уназад и видите како да направите промене у конфигурацији пројекта. Вероватно најкориснија промена конфигурације коју можете да направите је да направите оптимизовану верзију кода. Подразумевано сте конфигурисали свој пројекат да направи верзију за отклањање грешака. Хајде да погледамо пројекат за креирање оптимизоване конструкције. Да бисте објаснили Ваф-у да треба да прави оптимизоване верзије које укључују примере и тестове, мораћете да покренете следеће команде:

$ ./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)

Обратите пажњу на последњи део листе изнад. Неке нс-3 опције нису подразумевано омогућене или им је потребна системска подршка да би исправно функционисале. На пример, да бисте омогућили КсмлТо, библиотека мора бити присутна на систему либкмл-2.0. Ако ова библиотека није пронађена и одговарајућа нс-3 функција није омогућена, биће приказана порука. Такође имајте на уму да је могуће користити команду судо да бисте подесили суид бит „подесите ИД групе у време извођења“ за одређене програме. Подразумевано није омогућена и стога се ова функција појављује као „није омогућена“. На крају, да бисте добили листу омогућених опција, користите Ваф са параметром --check-config.

Вратимо се сада и вратимо се на верзију за отклањање грешака која садржи примере и тестове.

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

Систем изградње је сада постављен и можете да направите верзије за отклањање грешака нс-3 програма једноставним уписивањем:

$ ./waf

Горе наведени кораци су вас можда натерали да два пута направите део нс-3 система, али сада знате како да промените конфигурацију и направите оптимизовани код.

Да бисте проверили који профил је активан за дату конфигурацију пројекта, постоји команда:

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

Горе наведени сценарио буилд.пи такође подржава аргументе --enable-examples и --enable-tests, али друге опције Ваф не подржава директно. На пример, ово неће радити:

$ ./build.py --disable-python

реакција ће бити оваква:

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

Међутим, специјални оператор -- може се користити за прослеђивање додатних параметара путем ВАФтако да ће уместо горе наведеног радити следећа команда:

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

јер генерише главну команду ./ваф цонфигуре --дисабле-питхон. Ево још неколико уводних савета о Ваф.

Руковање грешкама у изградњи

нс-3 издања су тестирана на најновијим Ц++ компајлерима доступним у време објављивања на уобичајеним дистрибуцијама Линука и МацОС-а. Међутим, током времена, нове дистрибуције се објављују са новим преводиоцима, а ови новији компајлери имају тенденцију да буду педантичнији у вези са упозорењима. нс-3 конфигурише своју верзију тако да сва упозорења третира као грешке, тако да понекад ако користите старију верзију на новијем систему, упозорење компајлера може зауставити изградњу.

На пример, раније је било издање нс‑3.28 за Федора 28, које је укључивало нову главну верзију ГЦЦ (гцц-8). Приликом прављења издања нс-3.28 или старијих верзија под Федора 28, са инсталираним Гтк2+, појавиће се следећа грешка:

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

У издањима која почињу од нс‑3.28.1, ин Ваф доступна је опција за решавање ових проблема. Онемогућава постављање ознаке "-Веррор" у г++ и цланг++. Ово је опција "--дисабле-веррор" и мора се применити током конфигурације:

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

Конфигуришите или саставите

Неке команде Ваф имају смисла само у фази конфигурације, а неки су важећи само у фази изградње. На пример, ако желите да користите функције емулације нс-3, можете омогућити подешавање бита Суид Користећи судо, као што је горе описано. Ово ће заменити команде фазе конфигурације, и стога можете променити конфигурацију користећи следећу команду, која такође укључује примере и тестове.

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

Ако урадите ово Ваф покренуће судода промените програме за креирање сокета за емулацију тако да се покрећу са дозволама корен. У Ваф Постоји много других доступних опција за кораке конфигурације и изградње. Да бисте истражили своје опције, унесите:

$ ./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

Компајлери и заставице

У наведеним примерима Ваф за прављење нс-3 користи се Ц++ компајлер из ГЦЦ ( г ++). Међутим, можете променити онај који користите Ваф Ц++ компајлер, дефинисањем ЦКСКС променљиве окружења. На пример, да користите Ц++ компајлер Цланг, цланг++,

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

На исти начин можете конфигурисати Ваф да користите дистрибуирану компилацију користећи дистцц:

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

Више информација о дистцц и дистрибуираној компилацији можете пронаћи на страници пројекта у одељку Документација. Да бисте додали заставице компајлера приликом конфигурисања нс-3, користите променљиву окружења ЦКСКСФЛАГС_ЕКСТРА.

Инсталација

Ваф може се користити за инсталирање библиотека на различитим местима у систему. Подразумевано, компајлиране библиотеке и извршни фајлови се налазе у директоријуму градити, а пошто Ваф зна локацију ових библиотека и извршних датотека, нема потребе да инсталирате библиотеке било где другде.

Ако корисници више воле да инсталирају ван директоријума за изградњу, могу покренути команду ./ваф инсталл. Подразумевани префикс за инсталацију је / уср / лоцалТако ./ваф инсталл ће инсталирати програме у / уср / лоцал / бин, библиотеке у ! / Уср / лоцал / либ и датотеке заглавља у /уср/лоцал/инцлуде. Права суперкорисника обично треба да буду постављена са подразумеваним префиксом, тако да би типична команда била судо ./ваф инсталл. Када се покрене, Ваф ће прво изабрати да користи дељене библиотеке у директоријуму за прављење, а затим ће потражити библиотеке дуж путање до библиотека конфигурисаних у локалном окружењу. Дакле, када инсталирате библиотеке на систем, добра је пракса да проверите да ли се користе праве библиотеке. Корисници могу изабрати да инсталирају са другим префиксом тако што ће проследити опцију током конфигурације --prefix, на пример:

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

Ако касније, након изградње, корисник унесе команду за инсталацију ./waf, користиће се префикс / опт / лоцал.

Тим ./waf clean мора се користити пре реконфигурисања пројекта ако ће се инсталација користити Ваф под другим префиксом.

Дакле, да бисте користили нс-3, нема потребе да позивате ./waf install. Већини корисника ова команда неће бити потребна јер Ваф ће преузети тренутне библиотеке из директоријума за прављење, али неким корисницима ово може бити корисно ако њихове активности укључују рад са програмима изван нс-3 директоријума.

Ваф сингле

На највишем нивоу нс-3 изворног стабла постоји само једна Ваф скрипта. Када почнете да радите, провешћете доста времена у именику scratch/ или дубље уsrc/... а у исто време морају да трче Ваф. Можете само да се сетите где сте и бежите Ваф како слиједи:

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

али ово ће бити заморно и подложно грешкама, тако да постоје боља решења. Један уобичајени начин је коришћење уређивача текста као што је емацс или енергија, у којој су отворене две терминалске сесије, једна се користи за прављење нс-3, а друга се користи за уређивање изворног кода. Ако само имате тарбалл, онда променљива окружења може помоћи:

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

$ cd scratch 
$ waff build

У директоријум модула може бити примамљиво додати тривијалну ваф скрипту као што је exec ../../waf. Молим те не ради то. Ово је збуњујуће за почетнике и, када се уради лоше, доводи до грешака у изградњи које је тешко открити. Горе приказана решења су пут који треба користити.

3.5 Тестирање нс-3

Можете покренути јединичне тестове нс-3 дистрибуције покретањем скрипте ./тест.пи:

$ ./test.py

Ови тестови се изводе паралелно са Ваф. На крају би требало да видите поруку која каже:

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

Ово је важна порука за идентификацију валгринд кварова, рушења или грешака, што указује на проблеме са кодом или некомпатибилност између алата и кода.

Такође ћете видети коначни излаз из Ваф и тестер који покреће сваки тест, што ће изгледати отприлике овако:

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)

Ову команду обично покрећу корисници како би брзо проверили да ли је нс-3 дистрибуција правилно направљена. (Имајте на уму да редослед редова „ПРОЛАЖИ: ...“ може бити другачији, то је нормално. Оно што је важно је да ред резимеа на крају извештаја показује да су сви тестови прошли; ниједан тест није неуспешан или пао.) И ВафИ тест.пи ће паралелизовати рад преко доступних процесорских језгара машине.

3.6 Покретање скрипте

Обично покрећемо скрипте под контролом Ваф. Ово омогућава систему изградње да осигура да су путање дељене библиотеке исправно постављене и да су библиотеке доступне у време извођења. Да бисте покренули програм, једноставно користите Ваф са параметром - -run. Хајде да покренемо нс-3 еквивалент свеприсутног програма хелло светуписивањем следећег:

$ ./waf --run hello-simulator

Ваф ће прво проверити да ли је програм правилно направљен и изградити ако је потребно. Онда Ваф ће извршити програм који производи следећи излаз.

Hello Simulator

Честитам! Сада сте нс-3 корисник!

Шта да радим ако не видим резултате?

Ако видите поруке Вафозначавајући да је градња успешно завршена, али не видите излаз "Здраво симулатор", онда постоји могућност да сте у одељку [Буилд-витх-Ваф] променили режим израде на оптимизовано, али је пропустио повратак на режим отклонити неисправност. Сав излаз конзоле који се користи у овом водичу користи посебну нс-3 компоненту која врши евидентирање и користи се за штампање прилагођених порука на конзоли. Излаз из ове компоненте је аутоматски онемогућен када се оптимизовани код компајлира – он је „оптимизован“. Ако не видите излаз „Хелло Симулатор“, унесите следеће:

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

прилагодити Ваф за прављење верзија за отклањање грешака нс-3 програма, које укључују примере и тестове. Затим би требало да поново направите тренутну верзију кода за отклањање грешака тако што ћете укуцати

$ ./waf

Сада ако покренете програм хелло-симулатор, требало би да видите очекивани резултат.

3.6.1 Аргументи командне линије

Да бисте проследили аргументе командне линије програму нс-3, користите следећи образац:

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

Замените именом вашег програма и аргументима. Расправа - -command-template за Ваф је у суштини рецепт за изградњу стварне командне линије Ваф користи се за извршавање програма. Ваф проверава да ли је градња завршена, поставља путање дељене библиотеке, затим користи достављени шаблон командне линије и замењује име програма за чувар места %с да позове извршни фајл. Ако сматрате да је ова синтакса компликована, постоји једноставнија верзија која укључује нс-3 програм и његове аргументе затворене у једноструке наводнике:

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

Још један посебно користан пример је селективно покретање тестних пакета. Претпоставимо да постоји тест пакет који се зове митест (у ствари, не постоји). Изнад смо користили скрипту ./тест.пи за паралелно покретање већег броја тестова, који више пута позива програм за тестирање тест-руннер. Цалл тест-руннер директно да покренете један тест:

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

Аргументи ће бити прослеђени програму тест-руннер. Пошто митест не постоји, биће генерисана порука о грешци. Да бисте одштампали доступне опције пробног покретања, унесите:

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

3.6.2 Отклањање грешака

Да бисте покренули нс-3 програме под другим услужним програмом, као што је дебагер (нпр. гдб) или алат за тестирање меморије (нпр. валгринд), користите сличан облик - -command-template = "…". На пример, за покретање у програму за отклањање грешака гдб ваш хелло-симулатор нс-3 програм са аргументима:

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

Имајте на уму да име програма нс-3 долази са аргументом - -run, и услужни програм за управљање (овде гдб) је прва лексема у аргументу - -command-template. Опција - -args извештаји гдбда остатак командне линије припада „нижем“ програму. (Неке верзије гдб не разумем опцију - -args. У овом случају, уклоните аргументе програма из - -command-template и користите скуп команди гдб аргс.) Можемо комбиновати овај рецепт и претходни да бисмо покренули тест под програмом за отклањање грешака:

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

3.6.3 Радни именик

Ваф би требало да се лансира са своје локације на врху нс-3 стабла. Ова фасцикла постаје радни директоријум у који ће бити уписане излазне датотеке. Али шта ако желите да ове датотеке задржите изван нс-3 изворног стабла? Користите аргумент - -cwd:

$ ./waf --cwd=...

Можда ће вам бити згодније да добијете излазне датотеке у свом радном директоријуму. У овом случају, следеће индиректне акције могу помоћи:

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

Ова декорација претходне верзије команде чува тренутни радни директоријум, иде у директоријум Вафа затим упућује Ваф да промените радни директоријум назад у тренутни радни директоријум сачуван пре покретања програма. Помињемо екипу - -cwd Ради потпуности, већина корисника једноставно покреће Ваф из директоријума највишег нивоа и тамо генерише излазне датотеке.

Наставак: Поглавље 4

Извор: ввв.хабр.цом