ns-3 võrgusimulatori õpetus. Peatükk 3

peatükid 1,2

3 Alustamine
3.1 Ülevaade
3.2 Eeltingimused
3.2.1 ns-3 väljaande allalaadimine lähtekoodi arhiivina
3.3 ns-3 allalaadimine Gitiga
3.3.1 ns-3 allalaadimine Bake'i abiga
3.4 ns-3 koostamine
3.4.1 Koostamine build.py abil
3.4.2 Koostamine Bake'i abil
3.4.3 Koostamine Wafi abil
3.5 ns-3 testimine
3.6 Skripti käivitamine
3.6.1 Käskluste argumendid
3.6.2 Silumine
3.6.3 Töökaust

Lühipeatükk 3

Alustamine

See peatükk on suunatud selleks, et valmistada lugejat ette tööks arvutiga, kuhu ns-3 võib-olla kunagi pole installitud. Ülevaade katab toetatud platvormid, eeltingimused, ns-3 saamise meetodid, ns-3 koostamise meetodid ja teie koostamise kontrollimise ning lihtsate programmide käivitamise meetodid.

3.1 Ülevaade

Simulaator ns-3 on üles ehitatud kui töötavate tarkvararaamatukogude süsteem. Koostamise ajal lingitakse kasutaja programmide kood nende raamatukogudega. Kasutajate programmide kirjutamiseks kasutatakse programmeerimiskeeli C++ või Python.

Ns-3 levitatakse lähtekoodina, mis tähendab, et sihtsüsteem peab omama tarkvaraarenduse keskkonda, et esmalt raamatukogusid koostada ja seejärel kasutajaprogrammi koostada. Üldiselt võib ns-3 levitada valmis raamatukogudena konkreetse süsteemi jaoks, ning tulevikus võib neid levitada sellisel viisil. Kuid praegu tegelevad paljud kasutajad oma töö tegemisega ns-3 enda redigeerimise kaudu, seega on kasulik omada lähtekoodi raamatukogude koostamiseks. Kui keegi soovib võtta enda peale valmis raamatukogude ja pakettide loomise tööde tegemise, palun võtke ühendust meililisti. ns-developers.

Järgmisena vaatame kolme viisi ns-3 allalaadimiseks ja koostamiseks. Esimene on allalaadimine ja ametliku versiooni koostamine põhisaidilt. Teine on arendusversioonide koopia valimine ja koostamine ns-3 baaskeskkonnast. Kolmas on lisakogumise tööriistade kasutamine, et laadida alla rohkem laiendusi ns-3 jaoks. Läbime igaühe, kuna tööriistad erinevad veidi.

Kogenud Linuxi kasutajad võivad küsida, miks ns‑3 ei esitatakse pakendidena nagu enamik teisi teegid, mis kasutavad paketihalduri? Hoolimata sellest, et olemas on binaarpakendid erinevate Linuxi distributsioonide jaoks (nt Debian), lõppkokkuvõttes kohandavad enamik kasutajaid teeke ja peavad ns‑3 ise ümber kompileerima, mistõttu lähtekoodi kättesaadavus on mugav. Seetõttu keskendume me lähtekoodist installimisele.

Enamik ns‑3 rakendusi ei vaja õigusi, soovitatakse kasutada privileegita kasutajakontot. root Kogu ns‑3 teekide komplekt sõltub mõnest kolmanda osapoole teegist, kuid enamasti on ns‑3 võimalik kompileerida ja kasutada mitmete levinud (tihti vaikimisi installitud) komponentidega: C++ kompilaator, Python, lähtekoodi toimetaja (nt.

3.2 Eeltingimused

emacs vim-is., ) ja kui kasutatakse arendusrepo, siis versioonihaldussüsteem Git. Enamik algajaid kasutajaid ei pea muretsema, kui nende seadistus teatab, et teatud täiendavad funktsioonid ns‑3 on puudu, kuid neile, kes soovivad täielikku installimist, pakub projekt wiki, mis sisaldab lehekülgi, mis pakuvad palju kasulikke nõuandeid ja näpunäiteid. Üks selline leht on «Installimine» leht, kus on installimisjuhised erinevatele süsteemidele, mis on saadaval aadressil: või EclipseSelle wiki lehe jaotises „Eeltingimused“ selgitatakse, milliseid pakette on vaja ns‑3 tavaliste valikute toetamiseks ning antakse käsud nende installimiseks levinud Linuxi või macOS versioonides. https://www.nsnam.org/wiki/Installation.

Te saate kasutada võimalust uurida ns‑3 wiki lehte või põhiveebilehte:

, kuna seal on palju teavet. Alates ns‑3 viimasest versioonist (ns‑3.29) on ns‑3 käivitamiseks vajalikud järgmised tööriistad: https://www.nsnam.orgTööriist Pakett/versioon

C++ kompilaator

• clang++ või g++ (g++ versioon 4.9 või suurem)
  python2 versioon >= 2.7.10, või python3 versioon >=3.4
• Python
  mis tahes viimane versioon (ns‑3 ligipääsuks GitLab.com)
• Git
  mis tahes viimane versioon (ns‑3 vabastuse lahtipakkimiseks)
• tar
  bunzip2
• mis tahes värske versioon (ns‑3 vabastuse lahtipakkimiseks)
  Kuna kontrollida vaikimisi installitud Python versiooni, sisestage

python -V python -V. Versiooni g++ kontrollimiseks sisestage g++ -v. Kui mõned tööriistad puuduvad või on liiga vanad, vaadake ns‑3 installatsiooni juhendit wikipahel.

Oletame, et lugeja töötab Linuxis, MacOS-is või Linuxi keskkonna emulaatoris ning tal on vähemalt ülaltoodud tööriistad.

3.2.1 ns-3 väljaande allalaadimine lähtekoodi arhiivina

See on uus kasutaja käitumine, kes soovib alla laadida ja katsetada viimaseid ns‑3 versioonide ja paketiga seotud versioone. ns‑3 väljalasked avaldatakse kokku pakitud allikaarhivide kujul, mida mõnikord nimetatakse tarball. tarball — see on spetsiaalne programmispakettide formaat, kus mitu faili on kokku koondatud. Arhiiv on tavaliselt kokku pakitud. ns‑3 laadimine tarball on lihtne, peate lihtsalt valima versiooni, alla laadima ja selle lahti pakkima.

Oletame, et soovite kommenteerida näidatud nimiga kohaliku kausta workspace. Te saate versiooni töökoopia, sisestades Linuxi konsooli järgmise (loomulikult asendades asjakohased versiooninumbrid)

$ 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 

Pange tähele, et eespool kasutatud utiliit wget, on käsurea tööriist objektide Internetist allalaadimiseks. Kui te seda ei ole paigaldanud, võite kasutada oma brauserit.

Järgides neid samme, liigute ns-allinone-3.29 katalooge, kus peaksite nägema mitmeid faile ja katalooge

$ 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

Nüüd olete valmis tsentraalse ns‑3 ja võite liikuda ns‑3 kogumise jaotisse.

3.3 ns-3 allalaadimine Gitiga

ns‑3 kood on saadaval Git repos GitLab.com aadressil https://gitlab.com/nsnam/. Rühm nsnam koondab erinevaid reposid, mida avatud lähtekoodiga projekt kasutab.

Lihtsaim viis Git-reposid kasutada on teha fork või kloonida keskkonda ns‑3-allinone. See on skriptide kogum, mis haldab kõige sagedamini kasutatavate ns‑3 subsüsteemide allalaadimist ja kogumist. Kui olete Git-is uus, võivad "fork" ja "kloonimine" olla teile tundmatud; kui see on nii, soovitame teil lihtsalt kloonida (luua oma koopia) ladust, mis asub GitLab.com-is, järgides järgmist:

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

Selles etapis näete oma katalooge ns‑3-allinone veidi erineb eespool kirjeldatud vabastamise arhiivi direktorist. See peaks välja nägema umbes nii:

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

Pange tähele skripti olemasolu download.py, mis täiendavalt väljub ns‑3 ja sellega seotud allikakoodis. Siin on teil valida: laadige alla kõige viimane arendusversioon ns‑3:

$ python download.py

või eelistage ns‑3 versiooni, kasutades lippu -n versiooni numbri määramiseks:

$ python download.py -n ns-3.29

Pärast seda sammu laaditakse kausta ns‑3-allinone täiendavad hoidlad ns‑3, bake, pybindgen ja netanim.

Märkus
Puhta Ubuntu16.04 masina peal pidin ma käsu muutma järgmiseks: $ sudo python3 download.py -n ns-3.29 (edasi ja edasi tõlkija märkmed).

3.3.1 ns-3 allalaadimine Bake'i abiga

Kaks eelnevalt mainitud meetodit (allika arhiv või hoidla ns‑3-allinone Git'i kaudu) on kasulikud ns‑3 kõige lihtsama paigaldamise omamiseks koos mitme lisaga (pybindgen Python'i sidemete genereerimiseks ja netanim võrgu animatsiooniks). Kolmas hoidla, mis on vaikimisi saadaval ns‑3-allinone, nimega bake.

Bake — see on tööriist koordineeritud tarkvara ehitamiseks mitmest hoidlast, mis on välja töötatud ns‑3 projekti jaoks. Bake võib kasutada ns‑3 arendusteenuste saamiseks ning lisada ja komplitseerida ns‑3 baasversiooni jaotust, näiteks keskkonnana Otse Koodiga Täitmine, CradleNetwork Simulatsiooni Cradle, uus Python'i sidemete loomise võimalus ja mitmesugused „rakendused” ns‑3.

Märkus
CradleNetwork Simulatsiooni Cradle on raamistik, mis võimaldab reaalseid TCP/IP võrgu stekke kasutada võrgu simulatsiooni all.

Kui arvate, et teie ns‑3 paigaldus peaks praeguse versiooniga olema laiendatud või täiendav, saate järgida seda paigaldusteed.

Viimastel ns‑3 versioonidel Bake on tar-vabastusse lisatud. Vabastusse on lisatud konfigureerimisfail, mis võimaldab alla laadida tarkvara versioone, mis on vabastamise loomise hetkeks ajakohased. Teisisõnu, näiteks versioon Bake, mis on seotud vabastusega ns‑3.29, võib kasutada selle ns‑3 vabastuse või varasema jaoks vajalikest komponentidest, kuid ei saa kasutada komponentide hankimiseks hilisemate vabastuste jaoks (kui pakendi kirjeldifaili bakeconf.xml ei ole uuendatud).

Samuti võite saada kõige värskema koopia bake, sisestades järgmise käsu oma Linuxi konsooli (olemasoleva Git'i puhul):

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

Kui käivitatakse git käsk, peaksite nägema midagi sellist:

Kloonimine 'bake'...
remote: Objektide loendamine: 2086, valmis. 
remote: Objektide arv: 100% (2086/2086), valmis. 
remote: Objektide tihendamine: 100% (649/649), valmis. 
remote: Kokku 2086 (delta 1404), kasutatud 2078 (delta 1399) 
Vastuvõtmine: 100% (2086/2086), 2.68 MiB | 3.82 MiB/s, valmis. 
Delta lahendamine: 100% (1404/1404), valmis.

Pärast käsu lõpetamist clone peate nägema kausta nimega bake, mille sisu peaks välja nägema umbes nii:

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

Pange tähele, et olete alla laadinud mitu Python skripti, Python mooduli nimega bake ja XML konfiguratsioonifaili. Järgmiseks sammuks on nende skriptide kasutamine ns-3 distributsiooni allalaadimiseks ja ehitamiseks, millest olete huvitatud. Saadaval on mitu seadistuse sihti:

1. ns-3.29: moodul, mis vastab väljaandele; see laadib alla komponente, mis sarnanevad väljaandele tarballis;

2. ns-3-dev: sarnane moodul, kuid kasutades koodi arendushuast;

3. ns-allinone-3.29: moodul, mis sisaldab mitmeid lisafunktsioone, näiteks Click suunamine ja Network Simulation Cradle, Openflow ns-3 jaoks.

4. ns‑3-allinone: sarnane väljaande versioonile mooduli allinone, kuid arenduskoodile.

Märkus
Click — modulaarne tarkvaraarhitektuur ruuteri loomise jaoks.

Openflow — andmeprotsesside juhtimise protokoll, mis võimaldab andmete edastamist ruuterite ja lülitite kaudu, rakendades programmiga konfigureeritud võrgu tehnoloogiat.

Praegust arenduse snapshot'i (väljaandmata) ns-3 kohta saab leida aadressilt:https://gitlab.com/nsnam/ns-3-dev.git.

Arendajad püüavad neid hoidlaid ühesugusel töökorras hoida, kuid need asuvad arenduse valdkonnas ja sisaldavad väljaandmata koodi, seega, kui te ei plaani uusi funktsioone kasutada, valige ametlik väljaanne.

Viimase koodi versiooni leiate, vaadates hoidlate nimekirja või külastades veebilehte 'ns-3 Releases':https://www.nsnam.org/releases/ ja klikkides viimase versiooni lingile. Selles näites jätkame ns-3.29-ga.

Nüüd, et saada vajalikud ns-3 komponendid, rakendame tööriista Bake. Räägime natuke selle tööprotsessist. Bake.

Bake töötab allalaadides pakettide lähtekoodid kausta source ja installides bibliotekid ehituskausta. Bake saab käivitada, viidates binaarfailile, kuid kui soovite käivitada Bake mitte ei ole kausta, kuhu see üles laaditi, soovitav on lisada tee bake teie teele (keskkonnamuutuja PATH), näiteks järgmiselt (näide Linux bash'i shell'i jaoks). Minge kausta „bake” ja seadke järgmised keskkonnamuutujad:

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

See lisab programmi bake.py selle shelli teele, võimaldades teistel programmidele leida käivitatavad failid ja raamatukogud, millel on loodud bake. Mõningatel juhtudel, kui bake, eelnevalt kirjeldatud PATH ja PYTHONPATH seadistust ei nõuta, kuid ns‑3-allinone täieliku kogumise (lisapakettide korral) jaoks on see tavaliselt vajalik.

Minge töökausta ja sisestage terminali järgmine:

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

Järgmisena palume Bake kontrollida, kas meil on piisavalt tööriistu erinevate komponentide allalaadimiseks. Sisestage:

$ ./bake.py check

Te peaksite nägema midagi sellist:

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

Eriti allalaadimistööriistad nagu Mercurial, CVS, Git ja Bazaar on sellel etapil hädavajalikud, kuna need permetavad meil koodi hankimist. Sel etapil installige puuduvad tööriistad teie süsteemile sobival viisil (kui oskate) või pöörduge abi saamiseks oma süsteemi administraatori poole.

Järgmisena proovige alla laadida tarkvara:

$ ./bake.py download

tulemus peaks olema midagi sellist:

>> Otsitakse süsteemi sõltuvust setuptools - OK 
>> Otsitakse süsteemi sõltuvust libgoocanvas2 - OK 
>> Otsitakse süsteemi sõltuvust gi-cairo - OK 
>> Otsitakse süsteemi sõltuvust pygobject - OK 
>> Otsitakse süsteemi sõltuvust pygraphviz - OK 
>> Otsitakse süsteemi sõltuvust python-dev - OK 
>> Otsitakse süsteemi sõltuvust qt - OK 
>> Otsitakse süsteemi sõltuvust g++ - OK 
>> Laadimine pybindgen-0.19.0.post4+ng823d8b2 (sihtkaust: pybindgen) - OK 
>> Laadimine netanim-3.108 - OK 
>> Laadimine ns-3.29 - OK

See tähendab, et kolm allikat on alla laaditud. Nüüd minge kausta source ja sisestage ls; peaksite nägema:

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

Nüüd olete valmis ns-3 distributsiooni koostamiseks.

3.4 ns-3 koostamine

Nii nagu ns-3 allalaadimisel, on ns-3 koostamiseks mitu viisi. Peamine, mida me tahame rõhutada, on, et ns-3 on koostatud kasutades koostamisriistu, mida on kirjeldatud allpool. Enamik kasutajaid töötavad Waf, описанного ниже. Большинство пользователей будут работать с Waf, aga on mitmeid mugavaid skripte, mis aitavad teil alustada või korraldada keerukamaid kogumikke. Seetõttu, palun enne lugemist, Waf, vaadake build.py ja kogumisega bake.

3.4.1 Koostamine build.py abil

Tähelepanu! See kogumisüke on saadaval ainult allalaaditud lähtearhivi versioonist, nagu on ülalpool kirjeldatud; mitte git-i või bake kaudu alla laaditud.

Töötades välja andmefailiga tarball, in ns‑3‑allinone on olemas mugav skript, mis võib lihtsustada komponentide koostamist. Selle nimi on build.py. See programm seadistab projekti teie jaoks kõige kasulikumal viisil. Siiski, pange tähele, et keerulisemad seadistused ja töötamine ns‑3 abil hõlmavad tavaliselt ns‑3 enda koostamissüsteemi, Waf, millest räägitakse hiljem selles juhendis.

Kui olete laadinud alla tarball, siis peaks teie kataloogis ~/workspace olema kataloog, mille nimi on midagi sellist nagu ns-allinone-3.29. Sisestage järgmine käsk:

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

Päringu tegemisel, mis sisaldab teavet protokollide kohta, näeme järgmist: build.py oleme rakendanud käskude argumendid, et koguda juhendis kasutatavaid näiteid ja teste, mis ns‑3 puhul ei koguta vaikimisi. Vaikimisi koostab programm ka kõik saadaval olevad moodulid. Seejärel, kui soovite, saate koguda ns‑3 ilma näidiste ja testideta või välistada moodulid, mida teie tööks ei vajata.

Näete palju kompilatsiooni väljundite sõnumeid, mida skript kuvab erinevate allalaaditud osade koostamise ajal. Esmalt proovib skript koguda animaatorit netanim, seejärel sidumismoodulit pybindgen ja lõpuks ns‑3. Protsessi lõppedes peaksite nägema järgmist:

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

Moodulid on koostatud:
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 

Moodulid, mis ei ole koostatud (vt selgituse saamiseks ns-3 juhendist):
brite                  click                    openflow 
Leaving directory ./ns-3.29

Viimases kolmes real sisendist näeme teadet moodulite kohta, mis ei olnud koostatud:

Moodulid, mis ei ole koostatud (vt selgituse saamiseks ns-3 juhendist):
brite                     click

See lihtsalt tähendab, et mõned ns-3 moodulid, mis sõltuvad välistest teekidest, võivad olla kokkupanemata või et nende koostamine antud konfiguratsioonis ei ole vajalik. See ei tähenda, et simulaator ei ole kokku pandud või et kokku pandud moodulid töötavad valesti.

3.4.2 Koostamine Bake'i abil

Kui ülaltoodud teabe saamiseks projekti reposid saite bake'i kasutades, võite jätkata selle kasutamist ka ns-3 koostamiseks. Tippige:

$ ./bake.py build

ja peaksite nägema midagi sellist:

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

Vihje.: saate samuti korraga täita mõlemat sammu, laadides ja koostades, kutsudes esile "bake.py deploy".

Kuni kõigi komponentide koostamiseni võivad esineda tõrked, kuid koostamine jätkub, kui komponent ei ole kohustuslik. Näiteks oli hiljuti probleem ülekantavuses see, et castxml võib kokkupanna vahendiga bake mitte kõikidel platvormidel. Sel juhul kuvatakse teade, mis ütleb:

>> Koostatakse castxml - Probleem 
> Probleem: Valikuline sõltuvus, moodul "castxml" ebaõnnestus
See võib vähendada lõpliku koostise funktsionaalsust.
Kuid bake jätkab, kuna "castxml" ei ole hädavajalik sõltuvus.
Rohkem teavet saamiseks kutsuge bake välja -v või -vvv, et saada täielikku üksikasjalikku režiimi.

analüüs castxml on vajalik ainult juhul, kui soovite luua uuendatud Python'i sidumisi. Enamikul kasutajatest pole selleks vajadust (kuni nad ei hakka ns-3 muutma), seega selliseid hoiatuseid võib praegu ohutult ignoreerida.

Kui tõrge ilmneb, siis järgmine käsk annab teile vihjeid puuduolevate sõltuvuste kohta:

$ ./bake.py show

Loetletakse erinevad pakettide sõltuvused, mida proovite kokku panna.

3.4.3 Koostamine Wafi abil

Kuni sellele hetkele, et alustada ns-3 kokkupanekut, oleme kasutanud kas skripti build.py, või tööriista bake. Need tööriistad on kasulikud ns-3 koostamiseks ja teekide toetamiseks. Tegelikult käivitavad nad koostamisvahendi Waf ns-3 kataloogist. Waf mis paigaldatakse koos ns-3 allika koodiga. Enamik kasutajaid, kes seadistavad ja koostavad ns-3, liiguvad kiiresti otse Waf. Jätkamiseks palun minge ns-3 katalooge, mille olete algselt loonud.

Praegu ei ole see rangelt vajalik, kuid on kasulik teha väike kõrvalepõige ja vaadata, kuidas projekti konfiguratsiooni muudatusi sisse viia. Tõenäoliselt kõige kasulikum muutus, mida saate konfiguratsioonis teha, on optimeeritud koodi versiooni loomine. Vaikimisi on teie projekt seadistatud koostama silumisversiooni. Vaatame projekti optimeeritud kogumise loomiseks. Et selgitada Wafile, mida ta peab tegema optimeeritud kogumiste jaoks, mis sisaldavad näiteid ja teste, peate täitma järgmised käsud:

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

See käivitab Waf väljas kohaliku kausta (teie mugavuse huvides). Esimene käsk puhastab eelmise kogumise, see ei ole tavaliselt rangelt vajalik, kuid see on hea praktika (vt ka allpool koostamisprofiile); see eemaldab varasemad loodud teegid ja objekti failid, mis asuvad kaustas build\/. Kui projekt on ümber seadistatud ja ehitussüsteem kontrollib erinevaid sõltuvusi, peaksite nägema järgmist tüüpi väljundit:

Seadme tipp: /home/ns3user/workspace/bake/source/ns-3-dev
Seadme väljund: /home/ns3user/workspace/bake/source/ns-3-dev/build
Kontrollin 'gcc' (C kompilaator): /usr/bin/gcc
Kontrollin cc versiooni: 7.3.0
Kontrollin 'g++' (C++ kompilaator): /usr/bin/g++
Kontrollin kompileerimislipikut -march=native tugi: ok
Kontrollin kompileerimislipikut -Wl,--soname=foo tugi: ok
Kontrollin kompileerimislipikut -std=c++11 tugi: ok
Kontrollin boosti kaasandeid: päiseid ei leitud, palun,!esitage --boost-includes argument (vt abi)
Kontrollin boosti kaasandeid: päiseid ei leitud, palun,!esitage --boost-includes argument (vt abi)
Kontrollin programmi 'python': /usr/bin/python
Kontrollin python versiooni >= 2.3: 2.7.15 python-config: /usr/bin/python-config
Küsin python-configilt pyembed '--cflags --libs --ldflags' lipikut: jah
Testin pyembed konfiguratsiooni: jah
Küsin python-configilt pyext '--cflags --libs --ldflags' lipikut: jah
Testin pyext konfiguratsiooni: jah

Kontrollin kompileerimislipikut -fvisibility=hidden tugi: ok
Kontrollin kompileerimislipikut -Wno-array-bounds tugi: ok
Kontrollin pybindgen asukohta: ../pybindgen,!(arvatud)
Kontrollin python moodulit 'pybindgen': 0.19.0.,!post4+g823d8b2
Kontrollin pybindgen versiooni: 0.19.0.,!post4+g823d8b2
Kontrollin koodilõiku: jah
Kontrollin tüüpide uint64_t ja unsigned long võrdset: ei
Kontrollin koodilõiku: ei
Kontrollin tüüpide uint64_t ja unsigned long long võrdset: jah
Kontrollin apidefse, mida saab kasutada Python sidumiste jaoks: gcc-LP64
Kontrollin sisemist GCC cxxabi: täielik
Kontrollin python moodulit 'pygccxml': ei leitud
Kontrollin kliki asukohta: ei leitud
Kontrollin programmi 'pkg-config': /usr/bin/pkg-,!config
Kontrollin 'gtk+-3.0': ei leitud
Kontrollin 'libxml-2.0': jah
Kontrollin uint128_t: ei leitud
Kontrollin __uint128_t: jah
Kontrollin kõrge täpsusega rakendust: 128-bitine täisarv,!(vaikimisi)
Kontrollin pealkirja stdint.h: jah
Kontrollin pealkirja inttypes.h: jah
Kontrollin pealkirja sys/inttypes.h: ei leitud
Kontrollin pealkirja sys/types.h: jah
Kontrollin pealkirja sys/stat.h: jah
Kontrollin pealkirja dirent.h: jah
Kontrollin pealkirja stdlib.h: jah
Kontrollin pealkirja signal.h: jah
Kontrollin pealkirja pthread.h: jah
Kontrollin pealkirja stdint.h: jah
Kontrollin pealkirja inttypes.h: jah
Kontrollin pealkirja sys/inttypes.h: ei leitud
Kontrollin raamatukogu rt: jah
Kontrollin pealkirja sys/ioctl.h: jah
Kontrollin pealkirja net/if.h: jah
Kontrollin pealkirja net/ethernet.h: jah
Kontrollin pealkirja linux/if_tun.h: jah
Kontrollin pealkirja netpacket/packet.h: jah
Kontrollin NSC asukohta: ei leitud
Kontrollin 'sqlite3': ei leitud
Kontrollin pealkirja linux/if_tun.h: jah
Kontrollin python moodulit 'gi': 3.26.1
Kontrollin python moodulit 'gi.repository.GObject': ok
Kontrollin python moodulit 'cairo': ok
Kontrollin python moodulit 'pygraphviz': 1.4rc1
Kontrollin python moodulit 'gi.repository.Gtk': ok
Kontrollin python moodulit 'gi.repository.Gdk': ok
Kontrollin python moodulit 'gi.repository.Pango': ok
Kontrollin python moodulit 'gi.repository.GooCanvas': ok
Kontrollin programmi 'sudo': /usr/bin/sudo
Kontrollin programmi 'valgrind': ei leitud
Kontrollin 'gsl': ei leitud python-config: ei leitud
Kontrollin kompileerimislipikut -fstrict-aliasing tugi: ok
Kontrollin kompileerimislipikut -fstrict-aliasing tugi: ok
Kontrollin kompileerimislipikut -Wstrict-aliasing tugi: ok
Kontrollin kompileerimislipikut -Wstrict-aliasing tugi: ok
Kontrollin programmi 'doxygen': /usr/bin/doxygen
---- Kokkuvõte valikulistest ns-3 funktsioonidest:
Ehitusprofiil: optimeeritud
Ehituskaust:
BRITE integreerimine: ei ole lubatud (BRITE ei ole lubatud (vt valikut --with-,!brite))
DESi metrikate sündmuste kogumine: ei ole lubatud (vaikimisi keelatud)
Emulatsioon FdNetDevice: lubatud
Näidised: lubatud
Faili descriptor NetDevice: lubatud
GNU teaduslik raamatukogu (GSL): ei ole lubatud (GSL ei leitud)
Gcrypt raamatukogu: ei ole lubatud
(libgcrypt ei leitud: saate kasutada ,!libgcrypt-config, et leida selle asukoht.) GtkConfigStore: ei ole lubatud (raamatukogu 'gtk+-3.0 >= 3.0' ei leitud)
MPI tugi: ei ole lubatud (valik --enable-mpi ei ole valitud)
ns-3 Click integreerimine: ei ole lubatud (nsclick ei ole lubatud (vt valikut --with-,!nsclick))
ns-3 OpenFlow integreerimine: ei ole lubatud (nõutavad boost raamatukogud ei leitud)
Võrgu simuleerimise kest: ei ole lubatud (NSC ei leitud (vt valikut --with-nsc))
PlanetLab FdNetDevice: ei ole lubatud (PlanetLab operatsioonisüsteemi ei leitud ,!(vt valikut --force-planetlab)) PyViz visualiseerija: lubatud
Python API skaneerimise tugi: ei ole lubatud (puudu 'pygccxml' Python moodul)
Python sidumised: lubatud
Reaalaegne simulaator: lubatud
SQlite statistikaandmete väljund: ei ole lubatud (raamatukogu 'sqlite3' ei leitud)
Tap sild: lubatud
Tap FdNetDevice: lubatud
Testid: lubatud
Käthread primitiivid: lubatud
Kasutage sudo, et seadistada suid bitti: ei ole lubatud (valik --enable-sudo ei ole valitud)
XmlIo: lubatud
'configure' lõpetatud edukalt (6.387s)

Pange tähele ülaltoodud loendi viimast osa. Mõned ns‑3 valikud ei ole vaikimisi sisse lülitatud või vajavad süsteemi tugiteenuseid õigeks töötamiseks. Näiteks XmlTo lubamiseks peab süsteemis olema olemas teek libxml-2.0. Kui seda teeki ei leitud ja vastav ns‑3 funktsioon ei oleks sisse lülitatud, kuvatakse sõnum. Pange tähele, et on võimalik kasutada käsku sudo teatud programmide suid ‘käitamise ajal grupi ID seadistamine’ seadmise lubamiseks. See ei ole vaikimisi sisse lülitatud ning seetõttu kuvatakse see funktsioon kui ‘mitte sisse lülitatud’ (‘not enabled’). Lõpuks, et saada nimekiri sisse lülitatud valikutest, kasutage Waf parameetriga --check-config.

Nüüd naaseme ja lülitame tagasi silumisversioonile, mis sisaldab näidisprojekte ja teste.

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

Kogumissüsteem on nüüd seadistatud ning saate ns‑3 silumise versioone kokku panna, lihtsalt sisestades:

$ ./waf

Võib-olla panid ülaltoodud sammud teid koguma osa ns‑3 süsteemist kaks korda, kuid nüüd teate, kuidas konfigureerida ja koostada optimeeritud koodi.

Aktsepteeritud projekti konfiguratsiooni aktiivse profiili kontrollimiseks on olemas käsk:

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

Ülaltoodud stseen build.py toetab samuti argumente --enable-examples ja --enable-tests, kuid muid võimalusi Waf ei toetata otseselt. Näiteks ei toimi see:

$ ./build.py --disable-python

reaktsioon oleks selline:

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

Siiski võib eriline operaator - - kasutada täiendavate parameetrite edastamiseks läbi waf, seega töötab järgmine käsk selle asemel:

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

kuna see genereerib põhikäskuse ./waf configure --disable-python. Siin on veel mõned sissejuhatused teabe kogumise kohta Waf.

Kogumise vigade töötlemine

ns-3 versioonid on testitud kõige uuemate C++ kompilaatoritega, mis olid saadaval väljaandmise ajal levinud Linuxi ja MacOS jaotustes. Kuid aja jooksul vabastatakse uusi jaotusi koos uute kompilaatoritega, ja need uuemad kompilaatorid on tavaliselt hoolikamud hoiatuste osas. ns-3 konfigureerib oma koostamise nii, et kõik hoiatused käituvad nagu vead, seega mõnikord, kui kasutate vanemat versiooni uuemas süsteemis, võib kompilaatori hoiatus takistada koostamist.

Näiteks oli varem väljaanne ns-3.28 Fedora 28 jaoks, mis sisaldas uut peamist versiooni gcc (gcc-8). ns-3.28 või varasemate versioonide koostamine Fedora 28 all, kui Gtk2+ on installitud, võib põhjustada järgmise vea:

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

Versioonidest alates ns-3.28.1 on Waf saadaval valik nende probleemide lahendamiseks. See keelab g++ ja clang++ jaoks lipu „-Werror” seadistamise. See valik on „--disable-werror”, see tuleb rakendada konfigureerimise ajal:

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

Konfigureerida või koostada

Mõned käsud Waf on mõttekad ainult konfigureerimise faasis, samas kui mõned toimivad ainult koostamise faasis. Näiteks, kui soovite kasutada ns-3 emulatsioonifunktsioone, saate lubada bitil suid kasutades sudo, nagu ülalpool kirjeldatud. See tühistab konfigureerimise etapi käsud, ja seega saate konfigureerimist muuta järgmist käsku kasutades, mis hõlmab ka näiteid ja teste.

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

Kui teete nii, Waf käivitab sudo, et muuta emulatsioonikoodi soklite loomise programme käituma privileegidega root. Failis Waf saadaval on mitmeid muid valikuid konfigureerimise ja koostamisetappide jaoks. Valikute tutvumiseks tippige:

$ ./waf --help

Järgmises jaotises kasutame mõningaid testimisega seotud valikuid.

Koostamisprofiilid

Oleme juba näinud, kuidas saab seadistada Waf koostamisteks debug ja optimeeritud:

$ ./waf --build-profile=debug

Samuti on olemas vahepealne koostamisprofiil, release. Valik -d on sünonüüm --build-profile. Koostamisprofiil haldab logimise, väidete (assertions) ja kompilaatori optimeerimisvõtmete kasutamist:

Nagu näha, on logimine ja väidetavused saadaval ainult silumiskogudes. Soovitatav praktika on arendada oma skripti silumismoodulis ja seejärel teha korduvjookseid (statistika või parameetrite muutmiseks) optimeeritud kogumiprofiilis.

Kui teil on kood, mida tuleb käitada ainult teatud kogumiprofiilides, kasutage makroühenduse makrot:

NS_BUILD_DEBUG (std::cout << "Osa väljundi reast..." << std::flush; timer.Start ,!()); DoLongInvolvedComputation (); 
NS_BUILD_DEBUG (timer.Stop (); std::cout << "Valmis: " << timer << std::endl;)

Vaikimisi, Waf paneb kogumise artefaktid kogumise kataloogi. Saate määrata teise väljundkatalooge, kasutades võimalust - -out, näiteks:

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

Kombineerides seda kogumiprofiilidega, saate kergesti vahetada erinevate kompileerimise parameetrite vahel:

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

Mis võimaldab teil töötada mitme kogumisega, ilma et peaksite iga kord viimast kogumist kirjutama. Kui vahetate teisele profilile, Waf kompileeritakse ainult see, ilma täieliku taaskompileerimiseta.

Kui vahetate kogumiprofiile, on oluline erinevatel kordadel anda sama konfiguratsiooni parameetrid. Vead saavad vältida, kui määrate mitu keskkonnamuutujat:

$ 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

Kompilaatorid ja lipud

Ülaltoodud näidetes Waf ns-3 kogumisel kasutatakse GCC C++ kompilaatorit ( g++). Siiski on võimalik muuta kasutatavat Waf C++ kompilaatorit, määrates keskkonnamuutujat CXX. Näiteks, et kasutada C++ kompilaatorit Clang, clang++,

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

Sama moodi saab seadistada Waf jaotatud kompileerimise kasutamiseks distcc:

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

Kaugemaid andmeid distcc ja jaotatud kompileerimise kohta leiate projekti dokumendi rubriigist. Nii kohandage ns-3 konfiguratsiooni lisades kompilaatori lipud, kasutage keskkonnamuutujat CXXFLAGS_EXTRA.

Paigaldamine

Waf võib kasutada süsteemis raamatute installimiseks erinevatesse kohtadesse. Vaikimisi asuvad koostatud raamatukogud ja täidiseid failid kaustas build, ja kuna Waf teab nende raamatukogude ja täitmisfailide asukohta, ei ole vaja raamatukogusid kuhugi mujal installida.

Kui kasutajad eelistavad installida väljaspool koostamise kausta, saavad nad käivitada käsu .\/waf install. Vaikimisi installimise eelistus on /usr/local, seega .\/waf install paigaldab programmid kausta /usr/local/bin, raamatukogud kausta /usr/local/lib ja päiste failid kausta /usr/local/include. Superkasutaja õigused on tavaliselt vajalikud vaikimisi eelistusega installimise korral, seega tüüpiline käsk on sudo .\/waf install. Käivitamisel eelistab Waf kõigepealt kasutada koostamise kaustas olevaid üldisi raamatukogusid, seejärel otsib see raamatukogusid lokaalsetes keskkondades seadistatud raamatukogude teel. Seega, kui installitakse raamatukogusid süsteemi, on hea praktika kontrollida, et kasutatakse õigeid raamatukogusid. Kasutajad saavad valida installimise teise eelistuse, edastades konfigureerimise ajal valiku --prefix, näiteks:

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

Kui hiljem, pärast koostamist, sisestab kasutaja installimise käsu ./waf, kasutatakse eelistust /opt/local.

Meeskond .\/waf clean tuleb kasutada enne projekti ümberkonfigureerimist, kui installimine toimub Waf teise eelistusega.

Seega ei pea ns‑3 kasutamiseks kutse sisse kutsuma .\/waf install. Enamik kasutajaid ei vaja seda käsku, kuna Waf võtab praegused raamatukogud koostamise kaustast, kuid mõned kasutajad võivad seda leida kasulikuna, kui nende tegevus hõlmab töö tegemist programmidega väljaspool ns‑3 kausta.

Waf on ainus

ns‑3 allika puu ülemisel tasemel on ainult üks Waf-skripti. Tööd alustades veedate palju aega kaustas scratch\/ või sügavamal, kaustassrc\/... ja sellega kaasneb vajadus käivitada Waf. Saate lihtsalt meeles pidada, kus te viibite, ja käivitada Waf järgmiselt:

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

, kuid see on väsitav ja vigadele kalduv, seega on paremaid lahendusi. Üks levinumaid viise on kasutada tekstiredaktorit, nagu ) ja kui kasutatakse arendusrepo, siis versioonihaldussüsteem Git. Enamik algajaid kasutajaid ei pea muretsema, kui nende seadistus teatab, et teatud täiendavad funktsioonid ns‑3 on puudu, kuid neile, kes soovivad täielikku installimist, pakub projekt wiki, mis sisaldab lehekülgi, mis pakuvad palju kasulikke nõuandeid ja näpunäiteid. Üks selline leht on «Installimine» leht, kus on installimisjuhised erinevatele süsteemidele, mis on saadaval aadressil: või vim-is., kus avatakse kaks terminali seanssi, üks ns‑3 koostamiseks ja teine allika koodi redigeerimiseks. Kui teil on ainult tarball, siis võib abiks olla keskkonnamuutuja:

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

$ cd scratch 
$ waff build

Mooduli kataloogis võib tunduda ahvatlev lisada triviaalne waf skript näite põhjal exec ..\/..\/waf. Palun ärge tehke seda. See segadusse ajab algajaid ja võib halvasti teostamisel viia raskesti tuvastatavate koostamisvigadeni. Ülaltoodud lahendused on tee, mida tuleks kasutada.

3.5 ns-3 testimine

Saate käivitada ns-3 jaotise moodulitestid, käivitades skripti .\/test.py:

$ .\/test.py

Need testid käivitatakse paralleelselt Waf. Lõpuks peaksite nägema teadet, et

92 92stest õnnestus (92 õnnestus, 0 ebaõnnestus, 0 kokkuvarisemist, 0 valgrind viga)

See on oluline teadet, et tuvastada rikkeid, kokkuvarisemisi või valgrind vigu, mis viitab koodi probleemidele või tööriistade ja koodi ühilduvusprobleemidele.

Reeglina näete ka lõppväljundit Waf ja testijalt, kes käivitab iga testi, mis näeb välja umbes nii:

Waf: Sisenemine katalooge `\/path\/to\/workspace\/ns-3-allinone\/ns-3-dev\/build' 
Waf: Lahkumine katalooge `\/path\/to\/workspace\/ns-3-allinone\/ns-3-dev\/build' 
'build' lõpetatud edukalt (1.799s) 

Ehitatud moodulid:
aodv           rakendused          sild
click          konfiguratsiooni-pood          tuum
csma           csma-kujundus           dsdv
emu            energia                voogude-jälgimine
internet       lte                   mesh
mobiliteet       mpi                   netanim
võrgud        nix-vektori-suunamine    ns3tcp
ns3wifi        olsr                  openflow
punkt-punkt punkt-punkt-kujundus levik
spekter       statistika                 tap-sild
template       test                  tööriistad
topoloogia-lugemine  uan                   virtuaal-võrguseade
visualiseerija     wifi                  wimax

PASS: TestSuite ns3-wifi-häired
PASS: TestSuite histogram 

...

PASS: TestSuite objekt
PASS: TestSuite juhuslike-arvude-generaatorid
92 92stest õnnestus (92 õnnestus, 0 ebaõnnestus, 0 kokkuvarisemist, 0 valgrind viga)

See käsk käivitatakse tavaliselt kasutajate poolt ns-3 jaotise koostamise kiireks kontrollimiseks. (Pange tähele, et "PASS: ..." ridade järjekord võib erineda, see on okei. Oluline on, et lõpparve rea lõpus on kõik kontrollid läbitud; ükski test ei ebaõnnestunud ega kokku varisenud.) Ja Waf, ja test.py jagavad töökoormust saadaval olevatele protsessori tuumadele.

3.6 Skripti käivitamine

Reeglina käivitame skripte kontrolli all Waf. See tagab, et kogukogu tee on õigesti seadistatud ja et raamatukogud on käitamise ajal kergesti kättesaadavad. Programmi käivitamiseks kasutage lihtsalt Waf parameetriga - -run. Käivitame ns-3 jaoks ühesuguse programmi ekvivalendi, tere maailmsisenemine, sisestades järgmist:

$ .\/waf --run hello-simulator

Waf kontrollib esmalt, et programm on õigesti kokku pandud, ja vajadusel teostab kokkupaneku. Seejärel Waf jaotab programmi, mis tagab järgmise väljundi.

Hello Simulator

Palju õnne! Nüüd olete ns‑3 kasutaja!

Mida teha, kui ma ei näe tulemust?

Kui näete sõnumeid Waf, mis näitavad, et kokkupanek oli edukalt lõpetatud, kuid ei näe väljundit «Hello Simulator», on tõenäoline, et olete [Kokkupanek Wafiga] vahetanud oma kokkupaneku režiimi optimeeritud, kuid jätnud vahetamata tagasi režiimi debug. Kõik selles juhendis kasutatavad konsooli väljundid kasutavad spetsiaalset ns‑3 komponenti, mis teostab logimisfunktsiooni ja on mõeldud kasutajateadetega konsooli printimiseks. Selle komponendi väljund on automaatselt keelatud optimeeritud koodi kompileerimisel — see on "optimeeritud". Kui te ei näe väljundit "Hello Simulator", sisestage järgmine käsk:

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

et seadistada Waf ns‑3 programmide silumisversioonide kokkupanek, mis hõlmab näite ja testide. Peale selle peate uuesti kompileerima värskelt silumisversiooni koodi, sisestades

$ ./waf

Nüüd, kui käitate programmi hello-simulator, peaksite nägema oodatud tulemust.

3.6.1 Käskluste argumendid

Käskargumentide edastamiseks ns‑3 programmi kasutage järgmist mallivormingut:

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

Asendage oma programmi nimega ja argumentidega. Argument - -command-template jaoks Waf on põhimõtteliselt retsept tegeliku käsuviiva loomiseks Waf programmi käitamiseks. Waf kontrollib, et kokkupanek on lõpule viidud, määrab üldiste raamatukogude teed ja seejärel kasutab esitatud käsuviida malliga, asendades programmi nime kohatäitega %s, käivitab täidetava faili. Kui selline süntaks tundub keeruline, on olemas lihtsam variant, mis sisaldab ns‑3 programmi ja selle argumente ühesugustes üksikutes jutumärkides:

$ . /waf --run ' --arg1=value1 --arg2=value2 ...'

Teine, eriti kasulik näide on testide kogumite valikuline käivitamine. Oletame, et olemas on testikomplekt (suite) mytest (tegelikult seda ei ole). Ülaltoodud näites kasutasime skripti . /test.py, et paralleelselt käivitada terve hulk teste, mis korduvad testimisprogrammi kutsumisega test-runner. Kutsumine test-runner otse otse testimise täitmiseks:

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

Argumente antakse programmile test-runner. Kuna mytest ei eksisteeri, genereeritakse veateade. Saate test-runneri saadaval olevate parameetrite jaoks sisestada:

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

3.6.2 Silumine

Et käivitada ns-3 programme mõne teise utiliidi, näiteks siluri (näiteks gdb) või mäluehituspoliitika tööriist (nt valgrind), kasutage sarnast vormi - -command-template = "…". Näiteks et käivitada siluris gdb oma programmi hello-simulator ns-3 argumentidega:

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

Pange tähele, et ns-3 programmi nimi tuleb argumendiga - -run, ja juhtimise utiliit (siin gdb) on esimene token argumentides - -command-template. Valik - -args teatab gdb, mis tähendab, et ülejäänud käsuviib on "madalam" programm. (Mõned versioonid gdb ei toeta valikut - -args. Sellisel juhul eemalda argumendid programmist - -command-template , ja kasuta käskude komplekti gdb args.) Saame ühendada selle retsepti ja eelneva siluri all testimise käivitamiseks:

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

3.6.3 Töökaust

Waf peaks käivitama oma asukohast ns-3 puu tipus. See kaust muutub töökaustaks, kuhu salvestatakse väljundfailid. Aga mida teha, kui soovite neid faile hoida väljaspool ns-3 lähtekoode puu? Kasutage argumenti - -cwd:

$ .\/waf --cwd=...

Võib-olla on mugavam saada väljundfailid oma töökaustas. Sel juhul võib selline kaudne tegevus aidata:

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

Selline eelmine versioon käsust hoiab praeguse töökausta, liigub kausta Waf, ja seejärel instructs Waf tagasi pöörduma salvestatud töökausta enne programmi käivitamist. Mainime käsku - -cwd täielikkuse huvides, kuna enamik kasutajaid käivitab Wafi lihtsalt ülemise taseme kataloogist ja generatiivsed väljundfailid seal.

Jätkub: peatükk 4

Allikas: habr.com