ns-3 नेटवर्क सिम्युलेटर ट्यूटोरियल. प्रकरण 3

धडा 1,2

3 प्रारंभ करणे
3.1 विहंगावलोकन
3.2 पूर्वतयारी
3.2.1 स्रोत संग्रहण म्हणून ns-3 प्रकाशन डाउनलोड करणे
3.3 Git वापरून ns-3 डाउनलोड करणे
3.3.1 बेक वापरून ns-3 लोड करत आहे
3.4 विधानसभा ns-3
3.4.1 build.py सह इमारत
3.4.2 बेक सह इमारत
3.4.3 Waf सह तयार करा
3.5 चाचणी एनएस-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 साठी अधिक विस्तार लोड करण्यासाठी अतिरिक्त बिल्ड टूल्स वापरणे. साधने थोडी वेगळी असल्याने आम्ही प्रत्येकाकडे जाऊ.

अनुभवी लिनक्स वापरकर्त्यांना आश्चर्य वाटेल की पॅकेज मॅनेजर वापरणाऱ्या इतर लायब्ररींप्रमाणे ns-3 हे पॅकेज म्हणून का दिले जात नाही? विविध Linux वितरणांसाठी (उदा. डेबियन) बायनरी पॅकेजेस असली तरी, बहुतेक वापरकर्ते लायब्ररी संपादित करतात आणि ns-3 स्वतःच पुनर्बांधणी करतात, त्यामुळे स्त्रोत कोड उपलब्ध असणे सोपे आहे. या कारणास्तव, आम्ही स्त्रोतापासून स्थापित करण्यावर लक्ष केंद्रित करू.

बहुतेक अनुप्रयोगांसाठी ns-3 अधिकार मूळ आवश्यक नाही, विशेषाधिकार नसलेले वापरकर्ता खाते वापरण्याची शिफारस केली जाते.

3.2 पूर्वतयारी

उपलब्ध ns-3 लायब्ररींच्या संपूर्ण संचामध्ये थर्ड-पार्टी लायब्ररींवर अनेक अवलंबित्व आहेत, परंतु बहुतेक भागांसाठी ns-3 अनेक सामान्य (बहुतेकदा डीफॉल्टनुसार स्थापित) घटकांच्या समर्थनासह तयार आणि वापरले जाऊ शकते: एक C++ कंपाइलर, पायथन, स्त्रोत कोड संपादक (उदाहरणार्थ, शक्ती, emacs किंवा ग्रहण) आणि, जर डेव्हलपमेंट रेपॉजिटरीज वापरल्या गेल्या असतील तर, Git आवृत्ती नियंत्रण प्रणाली. बहुतेक प्रथम-वेळ वापरकर्त्यांना त्यांच्या कॉन्फिगरेशनमध्ये काही ns-3 प्रगत वैशिष्ट्ये गहाळ असल्यास काळजी करण्याची गरज नाही, परंतु ज्यांना पूर्ण स्थापना हवी आहे त्यांच्यासाठी प्रकल्प एक विकी प्रदान करतो ज्यामध्ये अनेक उपयुक्त टिपा आणि युक्त्या असलेली पृष्ठे समाविष्ट आहेत. असेच एक पान हे इन्स्टॉलेशन पेज आहे, ज्यामध्ये विविध सिस्टीमसाठी इन्स्टॉलेशन सूचना आहेत, येथे उपलब्ध आहेत: https://www.nsnam.org/wiki/Installation.

या विकीचा पूर्वापेक्षित विभाग स्पष्ट करतो की सामान्य ns-3 पर्यायांना समर्थन देण्यासाठी कोणती पॅकेजेस आवश्यक आहेत आणि Linux किंवा macOS च्या सामान्य फ्लेवर्सवर स्थापित करण्यासाठी वापरल्या जाणार्‍या कमांड देखील प्रदान करतात.

तुम्ही ns-3 विकी पेज किंवा मुख्य वेबसाइट एक्सप्लोर करण्यासाठी या संधीचा फायदा घेऊ शकता: https://www.nsnam.org, कारण तेथे बरीच माहिती आहे. ns-3 (ns-3.29) च्या नवीनतम आवृत्तीपासून सुरुवात करून, ns-3 चालवण्यासाठी खालील साधने आवश्यक आहेत:

टूल पॅकेज/आवृत्ती

• C++ कंपाइलर
  clang++ किंवा g++ (g++ आवृत्ती ४.९ किंवा उच्च)
• python ला
  python2 आवृत्ती >= 2.7.10, किंवा python3 आवृत्ती >=3.4
• Git
  कोणतीही नवीनतम आवृत्ती (GitLab.com वर ns-3 ऍक्सेस करण्यासाठी)
• टार
  कोणतीही नवीनतम आवृत्ती (NS‑3 रिलीझ अनपॅक करण्यासाठी)
• bunzip2
  कोणतीही नवीनतम आवृत्ती (ns‑3 रिलीझ अनपॅक करण्यासाठी)

पायथनची डीफॉल्ट आवृत्ती तपासण्यासाठी टाइप करा python -V. g++ आवृत्ती तपासण्यासाठी टाइप करा g++ -v. कोणतीही साधने गहाळ किंवा खूप जुनी असल्यास, कृपया ns-3 विकी पृष्ठावरील प्रतिष्ठापन मार्गदर्शक पहा.

आतापासून, आम्ही असे गृहीत धरतो की वाचक लिनक्स, मॅकओएस किंवा लिनक्स एमुलेटर चालवत आहे आणि त्याच्याकडे किमान वरील साधने आहेत.

3.2.1 स्रोत संग्रहण म्हणून ns-3 प्रकाशन डाउनलोड करणे

ns-3 च्या नवीनतम रिलीझ आणि पॅकेज आवृत्त्या डाउनलोड करून प्रयोग करू इच्छिणाऱ्या नवीन वापरकर्त्यासाठी ही कारवाई आहे. ns-3 प्रकाशन संकुचित स्त्रोत संग्रहण म्हणून प्रकाशित केले जातात, कधीकधी म्हणतात टारबॉल. टारबॉल हे एक विशेष सॉफ्टवेअर संग्रहण स्वरूप आहे ज्यामध्ये अनेक फाईल्स एकत्र जोडल्या जातात. संग्रहण सहसा संकुचित केले जाते. ns-3 बूट प्रक्रिया द्वारे टारबॉल सोपे आहे, तुम्हाला फक्त एक प्रकाशन निवडणे, डाउनलोड करणे आणि अनपॅक करणे आवश्यक आहे.

चला असे गृहीत धरू की, वापरकर्ता म्हणून, तुम्हाला स्थानिक निर्देशिकेत ns-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 

वर वापरलेल्या उपयुक्ततेकडे लक्ष द्या 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

कृपया लक्षात घ्या की एक स्क्रिप्ट आहे download.py, जे अतिरिक्तपणे ns-3 आणि सोबतचा स्त्रोत कोड काढेल. येथे तुमच्याकडे एक पर्याय आहे: एकतर नवीनतम ns-3 विकास स्नॅपशॉट डाउनलोड करा:

$ python download.py

किंवा ध्वज वापरून ns-3 रिलीझला प्राधान्य द्या -n प्रकाशन क्रमांक सूचित करण्यासाठी:

$ python download.py -n ns-3.29

या चरणानंतर निर्देशिकेत जा ns-3-एलिनोन अतिरिक्त भांडार डाउनलोड केले जातील ns-3, बेक करावे, pybindgen и netanim.

शेरा
स्वच्छ Ubuntu16.04 असलेल्या मशीनवर, मला कमांड बदलणे आवश्यक आहे: $ sudo python3 download.py -n ns-3.29 (यापुढे अनुवादकाच्या नोट्स).

3.3.1 बेक वापरून ns-3 लोड करत आहे

वरील दोन पद्धती (स्रोत संग्रहण किंवा भांडार ns-3-एलिनोन Git द्वारे) एकाधिक ऍडऑन्ससह सर्वात सोपी एनएस-3 इंस्टॉलेशन मिळविण्यासाठी उपयुक्त आहेत(pybindgen पायथन बाइंडिंग व्युत्पन्न करण्यासाठी netanim नेटवर्क अॅनिमेशनसाठी). ns-3-allinone मध्ये डीफॉल्टनुसार प्रदान केलेल्या तिसऱ्या रेपॉजिटरीला म्हणतात बेक करावे.

बेक करावे ns-3 प्रकल्पासाठी विकसित केलेल्या एकाधिक रिपॉझिटरीजमधील सॉफ्टवेअरच्या समन्वयित बिल्डिंगसाठी एक साधन आहे. बेक करावे ns-3 च्या डेव्हलपमेंट आवृत्त्या मिळविण्यासाठी, तसेच ns-3 वितरणाच्या बेस व्हर्जनचे विस्तार डाउनलोड करण्यासाठी आणि तयार करण्यासाठी वापरले जाऊ शकते, जसे की पर्यावरण डायरेक्ट कोड एक्झिक्यूशन, CradleNetwork सिम्युलेशन पाळणा, नवीन Python बाइंडिंग्ज आणि विविध ns-3 “apps” तयार करण्याची क्षमता.

शेरा
CradleNetwork Simulation Cradle हे एक फ्रेमवर्क आहे जे तुम्हाला नेटवर्क सिम्युलेटरमध्ये वास्तविक TCP/IP नेटवर्क स्टॅक वापरण्याची परवानगी देते.

तुम्ही तुमच्या ns-3 इंस्टॉलेशनमध्ये प्रगत किंवा अतिरिक्त वैशिष्ट्ये असण्याची अपेक्षा करत असल्यास, तुम्ही या इंस्टॉलेशन मार्गाचा अवलंब करू शकता.

नवीनतम ns-3 प्रकाशनांमध्ये बेक करावे टार रिलीझमध्ये जोडले गेले. रिलीझमध्ये कॉन्फिगरेशन फाइल समाविष्ट आहे जी तुम्हाला रिलीझच्या वेळी वर्तमान सॉफ्टवेअर आवृत्त्या डाउनलोड करण्याची परवानगी देते. म्हणजेच, उदाहरणार्थ, आवृत्ती बेक करावे, जे प्रकाशन ns-3.29 सह वितरीत केले जाते, ते ns-3 किंवा त्यापूर्वीच्या प्रकाशनासाठी घटक पुनर्प्राप्त करण्यासाठी वापरले जाऊ शकते, परंतु नंतरच्या प्रकाशनासाठी घटक पुनर्प्राप्त करण्यासाठी वापरले जाऊ शकत नाही (जर पॅकेज वर्णन फाइल bakeconf.xml अद्यतनित नाही).

आपण नवीनतम प्रत देखील मिळवू शकता बेक करावेतुमच्या लिनक्स कन्सोलमध्ये खालील आदेश प्रविष्ट करून (तुम्ही 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: प्रकाशनाशी संबंधित मॉड्यूल; ते टारबॉलमध्ये सोडल्यासारखे घटक डाउनलोड करेल;

2. ns-3-dev: एक समान मॉड्यूल, परंतु विकास वृक्षाचा कोड वापरून;

3. ns-allinone-3.29: एक मॉड्यूल ज्यामध्ये क्लिक रूटिंग आणि नेटवर्क सिम्युलेशन क्रॅडल, ns-3 साठी ओपनफ्लो यासारख्या इतर अतिरिक्त वैशिष्ट्यांचा समावेश आहे.

4. ns-3-एलिनोन: मॉड्यूलच्या प्रकाशन आवृत्तीसारखे सर्वसमाविष्ट, परंतु विकास कोडसाठी.

शेरा
क्लिक करा — राउटर तयार करण्यासाठी मॉड्यूलर सॉफ्टवेअर आर्किटेक्चर.

ओपनफ्लो हे सॉफ्टवेअर-परिभाषित नेटवर्क तंत्रज्ञानाची अंमलबजावणी करून, राउटर आणि स्विचद्वारे डेटा नेटवर्कवर प्रसारित केलेल्या डेटावर प्रक्रिया करण्याच्या प्रक्रियेचे व्यवस्थापन करण्यासाठी प्रोटोकॉल आहे.

सध्याचा विकास स्नॅपशॉट (नॉन-रिलीझ) ns-3 येथे आढळू शकतो:https://gitlab.com/nsnam/ns-3-dev.git.

डेव्हलपर या रिपॉझिटरीजला सातत्यपूर्ण कामकाजाच्या क्रमाने ठेवण्याचा प्रयत्न करतात, परंतु ते विकास क्षेत्रात आहेत आणि त्यात अप्रकाशित कोड आहे, त्यामुळे तुम्ही नवीन वैशिष्ट्ये वापरण्याची योजना करत नसल्यास, अधिकृत प्रकाशन निवडा.

रिपॉझिटरीजची सूची ब्राउझ करून किंवा ns-3 प्रकाशन वेब पृष्ठावर जाऊन तुम्ही कोडची नवीनतम आवृत्ती शोधू शकता:https://www.nsnam.org/releases/ आणि नवीनतम आवृत्ती दुव्यावर क्लिक करून. या उदाहरणात आपण ns-3.29 सह सुरू ठेवू.

आता, आम्हाला आवश्यक असलेले ns-3 घटक मिळविण्यासाठी, आम्ही साधन वापरू बेक करावे. चला कामाबद्दल काही प्रास्ताविक शब्द बोलूया बेक करावे.

डिरेक्टरीमध्ये पॅकेज स्रोत लोड करून बेक कार्य करते स्रोत आणि बिल्ड डिरेक्टरीमध्ये लायब्ररी स्थापित करणे. बेक करावे बायनरी संदर्भ देऊन चालवले जाऊ शकते, परंतु जर तुम्हाला चालवायचे असेल तर बेक करावे ज्या निर्देशिकेत ते डाउनलोड केले होते त्यामधून नाही, त्यात पथ जोडण्याचा सल्ला दिला जातो बेक करावे तुमच्या मार्गावर (PATH पर्यावरण व्हेरिएबल), उदाहरणार्थ खालीलप्रमाणे (लिनक्स बॅश शेलचे उदाहरण). "बेक" निर्देशिकेवर जा आणि नंतर खालील पर्यावरण व्हेरिएबल्स सेट करा:

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

हे कार्यक्रम ठेवेल bake.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 ...

विशेषतः, मर्क्युरिअल, सीव्हीएस, गिट आणि बाजार सारखी अपलोड साधने या चरणात आवश्यक आहेत कारण ते आम्हाला कोड मिळवण्याची परवानगी देतात. या टप्प्यावर, आपल्या सिस्टमसाठी नेहमीच्या पद्धतीने गहाळ साधने स्थापित करा (आपल्याला कसे माहित असल्यास) किंवा मदतीसाठी आपल्या सिस्टम प्रशासकाशी संपर्क साधा.

पुढे, सॉफ्टवेअर डाउनलोड करण्याचा प्रयत्न करा:

$ ./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 किंवा बेक द्वारे डाउनलोड केलेले नाही.

रिलीझ आर्काइव्हसह काम करताना टारबॉल, मध्ये ns-3-एलिनोन एक सुलभ स्क्रिप्ट आहे जी घटक एकत्र करणे सोपे करू शकते. त्याला build.py म्हणतात. हा प्रोग्राम तुमच्यासाठी सर्वात उपयुक्त मार्गाने प्रकल्प सेट करेल. तथापि, लक्षात घ्या की ns-3 सह अधिक प्रगत सेटअप आणि कार्यामध्ये सहसा ns-3 ची स्वतःची बिल्ड सिस्टीम, Waf वापरणे समाविष्ट असते, जे या ट्युटोरियलमध्ये नंतर सादर केले जाईल.

वापरून डाउनलोड केले असल्यास टारबॉल, नंतर तुमच्या निर्देशिकेत ~/कार्यक्षेत्र काहीतरी नाव असलेली निर्देशिका ns-allinone-3.29. खालील प्रविष्ट करा:

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

फोन केला असता build.py या ट्यूटोरियलमध्ये वापरलेली उदाहरणे आणि चाचण्या तयार करण्यासाठी आम्ही कमांड लाइन वितर्क वापरले, जे ns-3 मध्ये डीफॉल्टनुसार तयार केलेले नाहीत. डीफॉल्टनुसार, प्रोग्राम सर्व उपलब्ध मॉड्यूल देखील तयार करतो. मग, तुमची इच्छा असल्यास, तुम्ही उदाहरणे आणि चाचण्यांशिवाय ns-3 तयार करू शकता किंवा तुमच्या कामासाठी आवश्यक नसलेले मॉड्यूल वगळू शकता.

स्क्रिप्टद्वारे प्रदर्शित केलेले बरेच कंपाइलर आउटपुट संदेश तुम्हाला दिसतील कारण ते तुम्ही लोड केलेले विविध भाग तयार करते. प्रथम स्क्रिप्ट अॅनिमेटर तयार करण्याचा प्रयत्न करेल netanim, नंतर बंधनकारक जनरेटर pybindgen आणि शेवटी 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 deploy" वर कॉल करून एकाच वेळी डाउनलोड आणि बिल्ड स्टेप्स दोन्ही करू शकता.

सर्व घटक एकत्र करणे अयशस्वी होऊ शकते, परंतु घटक आवश्यक नसल्यास असेंब्ली सुरू राहील. उदाहरणार्थ, अलीकडील पोर्टेबिलिटी समस्या होती castxml साधनाद्वारे एकत्र केले जाऊ शकते बेक करावे सर्व प्लॅटफॉर्मवर नाही. या प्रकरणात, यासारखा संदेश दिसेल:

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

तथापि, castxml तुम्हाला अद्ययावत पायथन बाइंडिंग तयार करायचे असल्यासच आवश्यक आहे. बर्‍याच वापरकर्त्यांसाठी याची गरज नाही (किमान ते 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 फंक्शन सक्षम केले नसल्यास, एक संदेश प्रदर्शित केला जाईल. हे देखील लक्षात ठेवा की कमांड वापरणे शक्य आहे सुडो काही प्रोग्राम्ससाठी suid बिट सेट करण्यासाठी “रनटाइमवर ग्रुप आयडी सेट करा”. हे डीफॉल्टनुसार सक्षम केलेले नाही आणि म्हणून हे वैशिष्ट्य "सक्षम नाही" म्हणून दिसते. शेवटी, सक्षम पर्यायांची सूची मिळविण्यासाठी, वापरा वाफ पॅरामीटरसह --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

तथापि, विशेष ऑपरेटर - - द्वारे अतिरिक्त पॅरामीटर्स पास करण्यासाठी वापरला जाऊ शकतो वाफत्यामुळे वरील ऐवजी खालील कमांड कार्य करेल:

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

कारण ते मुख्य कमांड व्युत्पन्न करते ./waf कॉन्फिगर --disable-python. येथे काही अधिक परिचयात्मक टिपा आहेत वाफ.

बिल्ड त्रुटी हाताळणे

सामान्य Linux आणि MacOS वितरणांवर प्रकाशनाच्या वेळी उपलब्ध असलेल्या नवीनतम C++ कंपाइलर्सवर ns-3 प्रकाशनांची चाचणी केली जाते. तथापि, कालांतराने, नवीन संकलकांसह नवीन वितरणे जारी केली जातात आणि हे नवीन कंपाइलर्स चेतावणींबद्दल अधिक पेडेंटिक असतात. ns-3 त्याच्या बिल्डला सर्व इशाऱ्यांना त्रुटी मानण्यासाठी कॉन्फिगर करते, त्यामुळे काहीवेळा जर तुम्ही नवीन प्रणालीवर जुनी आवृत्ती चालवत असाल, तर कंपाइलर चेतावणी बिल्ड थांबवू शकते.

उदाहरणार्थ, पूर्वी Fedora 3.28 साठी ns‑28 चे प्रकाशन होते, ज्यामध्ये नवीन प्रमुख आवृत्ती समाविष्ट होती. जीसीसी (gcc-8). रिलीझ ns-3.28 किंवा Fedora 28 अंतर्गत पूर्वीच्या आवृत्त्या तयार करताना, Gtk2+ स्थापित केल्यावर, खालील त्रुटी उद्भवेल:

/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 इम्युलेशन वैशिष्ट्ये वापरायची असल्यास, तुम्ही बिट सेटिंग सक्षम करू शकता दक्षिण वापरत आहे सुडो, वर वर्णन केल्याप्रमाणे. हे कॉन्फिगरेशन स्टेप कमांड्स ओव्हरराइड करेल, आणि अशा प्रकारे तुम्ही खालील कमांड वापरून कॉन्फिगरेशन बदलू शकता, ज्यामध्ये उदाहरणे आणि चाचण्या देखील समाविष्ट आहेत.

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

संकलक आणि ध्वज

वरील उदाहरणांमध्ये वाफ 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 / स्थानिक, म्हणून ./waf इंस्टॉल मध्ये प्रोग्राम स्थापित करेल / usr / स्थानिक / बिन, मध्ये लायब्ररी / usr / स्थानिक / lib आणि हेडर फाइल्स मध्ये /usr/local/include. सुपरयुजर अधिकार सामान्यत: डीफॉल्ट उपसर्गासह सेट करणे आवश्यक आहे, त्यामुळे एक सामान्य कमांड असेल sudo ./waf स्थापित करा. लॉन्च केल्यावर, Waf प्रथम बिल्ड डिरेक्टरीमध्ये सामायिक लायब्ररी वापरणे निवडेल, नंतर स्थानिक वातावरणात कॉन्फिगर केलेल्या लायब्ररींच्या मार्गावर लायब्ररी शोधा. त्यामुळे सिस्टीमवर लायब्ररी स्थापित करताना, योग्य लायब्ररी वापरल्या जात आहेत की नाही हे तपासणे चांगले आहे. कॉन्फिगरेशन दरम्यान पर्याय पास करून वापरकर्ते वेगळ्या उपसर्गासह स्थापित करणे निवडू शकतात --prefix, उदाहरणार्थ:

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

नंतर, बिल्ड केल्यानंतर, वापरकर्ता प्रतिष्ठापन आदेश प्रविष्ट करतो ./waf, उपसर्ग वापरला जाईल /opt/स्थानिक.

संघ ./waf clean जर इंस्टॉलेशन वापरत असेल तर प्रकल्प पुन्हा कॉन्फिगर करण्यापूर्वी वापरणे आवश्यक आहे वाफ वेगळ्या उपसर्ग अंतर्गत.

त्यामुळे ns-3 वापरण्यासाठी कॉल करण्याची गरज नाही ./waf install. बहुतेक वापरकर्त्यांना या आदेशाची आवश्यकता नाही कारण वाफ बिल्ड डिरेक्ट्रीमधून वर्तमान लायब्ररी उचलतील, परंतु काही वापरकर्त्यांना त्यांच्या क्रियाकलापांमध्ये ns-3 निर्देशिकेच्या बाहेरील प्रोग्रामसह कार्य करणे समाविष्ट असल्यास हे उपयुक्त वाटू शकते.

वाफ सिंगल

ns-3 स्त्रोत वृक्षाच्या वरच्या स्तरावर, फक्त एक Waf स्क्रिप्ट आहे. एकदा तुम्ही काम सुरू केले की, तुमचा डिरेक्टरीमध्ये बराच वेळ जाईल scratch/ किंवा खोलवरsrc/... आणि त्याच वेळी धावणे आवश्यक आहे वाफ. तुम्ही कुठे आहात ते तुम्ही फक्त लक्षात ठेवू शकता आणि धावू शकता वाफ खालीलप्रमाणे:

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

परंतु हे कंटाळवाणे आणि त्रुटी प्रवण असेल, म्हणून चांगले उपाय आहेत. एक सामान्य मार्ग म्हणजे मजकूर संपादक वापरणे जसे की emacs किंवा शक्ती, ज्यामध्ये दोन टर्मिनल सत्र उघडले जातात, एक ns-3 तयार करण्यासाठी वापरले जाते आणि दुसरे स्त्रोत कोड संपादित करण्यासाठी वापरले जाते. जर तुमच्याकडे असेल तरच टारबॉल, तर पर्यावरण व्हेरिएबल मदत करू शकते:

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

$ cd scratch 
$ waff build

मॉड्युल डिरेक्टरीमध्ये क्षुल्लक waf स्क्रिप्ट सारखी जोडण्याचा मोह होऊ शकतो exec ../../waf. कृपया, असे करू नका. हे नवशिक्यांसाठी गोंधळात टाकणारे आहे आणि जेव्हा ते खराब केले जाते, तेव्हा ते शोधण्यास कठीण बिल्ड त्रुटी निर्माण करतात. वर दर्शविलेले उपाय हे वापरले पाहिजेत.

3.5 चाचणी एनएस-3

तुम्ही स्क्रिप्ट चालवून ns-3 वितरणाच्या युनिट चाचण्या चालवू शकता ./test.py:

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

ही कमांड सहसा वापरकर्त्यांद्वारे ns-3 वितरण योग्यरित्या तयार केले आहे याची त्वरित पडताळणी करण्यासाठी चालवली जाते. (लक्षात ठेवा की "PASS: ..." ओळींचा क्रम भिन्न असू शकतो, हे सामान्य आहे. महत्त्वाचे म्हणजे अहवालाच्या शेवटी सारांश ओळ दर्शवते की सर्व चाचण्या उत्तीर्ण झाल्या आहेत; कोणत्याही चाचण्या अयशस्वी किंवा क्रॅश झाल्या नाहीत.) आणि वाफआणि test.py मशीनच्या उपलब्ध प्रोसेसर कोरवर काम समांतर करेल.

3.6 स्क्रिप्ट चालवणे

आम्ही सहसा नियंत्रणाखाली स्क्रिप्ट चालवतो वाफ. हे सामायिक लायब्ररी पथ योग्यरित्या सेट केले आहेत आणि लायब्ररी रनटाइमवर उपलब्ध आहेत याची खात्री करण्यासाठी बिल्ड सिस्टमला अनुमती देते. प्रोग्राम चालविण्यासाठी, फक्त वापरा वाफ पॅरामीटरसह - -run. सर्वव्यापी प्रोग्रामचे ns-3 समतुल्य चालवू हॅलो जगातीलखालील टाइप करून:

$ ./waf --run hello-simulator

Waf प्रथम प्रोग्राम योग्यरित्या तयार केला आहे की नाही हे तपासेल आणि आवश्यक असल्यास तयार करेल. मग वाफ खालील आउटपुट तयार करणारा प्रोग्राम कार्यान्वित करेल.

Hello Simulator

अभिनंदन! तुम्ही आता ns-3 वापरकर्ता आहात!

मला परिणाम दिसत नसल्यास मी काय करावे?

जर तुम्हाला मेसेज दिसत असतील वाफबिल्ड यशस्वीरित्या पूर्ण झाल्याचे दर्शवत आहे, परंतु तुम्हाला आउटपुट दिसत नाही "हॅलो सिम्युलेटर", तर अशी शक्यता आहे की [Bild-with-Waf] विभागात तुम्ही तुमचा बिल्ड मोड स्विच केला आहे ऑप्टिमाइझ केलेले, परंतु मोडवर परत जाणे चुकले डीबग. या ट्युटोरियलमध्ये वापरलेले सर्व कन्सोल आउटपुट एक विशेष ns-3 घटक वापरते जे लॉगिंग करते आणि कन्सोलवर कस्टम संदेश मुद्रित करण्यासाठी वापरले जाते. जेव्हा ऑप्टिमाइझ केलेला कोड संकलित केला जातो तेव्हा या घटकाचे आउटपुट स्वयंचलितपणे अक्षम केले जाते - ते "ऑप्टिमाइझ केलेले" असते. तुम्हाला "हॅलो सिम्युलेटर" आउटपुट दिसत नसल्यास, खालील प्रविष्ट करा:

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

दुसरे विशेषतः उपयुक्त उदाहरण म्हणजे चाचणी सूट निवडकपणे चालवणे. मायटेस्ट नावाचा एक चाचणी संच आहे असे गृहीत धरू (खरेतर तेथे नाही). वर आम्ही ./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 प्रोग्राम्स दुसऱ्या युटिलिटी अंतर्गत चालवण्यासाठी, जसे की डीबगर (उदाहरणार्थ, जीडीबी) किंवा मेमरी चाचणी साधन (उदाहरणार्थ, valgrind), एक समान फॉर्म वापरा - -command-template = "…". उदाहरणार्थ, डीबगरमध्ये चालण्यासाठी जीडीबी तुमचा हॅलो-सिम्युलेटर एनएस-३ प्रोग्राम वितर्कांसह:

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

लक्षात घ्या की ns-3 प्रोग्रामचे नाव आर्ग्युमेंटसह येते - -run, आणि व्यवस्थापन उपयुक्तता (येथे जीडीबी) हे युक्तिवादातील पहिले टोकन आहे - -command-template. पर्याय - -args माहिती देतो जीडीबीउर्वरित कमांड लाइन "लोअर" प्रोग्रामशी संबंधित आहे. (काही आवृत्त्या जीडीबी पर्याय समजत नाही - -args. या प्रकरणात, पासून प्रोग्राम वितर्क काढा - -command-template आणि कमांड सेट वापरा जीडीबी args.) डीबगर अंतर्गत चाचणी चालविण्यासाठी आम्ही ही रेसिपी आणि मागील एक एकत्र करू शकतो:

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

3.6.3 कार्यरत निर्देशिका

वाफ ns-3 झाडाच्या शीर्षस्थानी असलेल्या स्थानावरून लाँच केले पाहिजे. हे फोल्डर कार्यरत निर्देशिका बनते जिथे आउटपुट फाइल्स लिहिल्या जातील. पण जर तुम्हाला या फाइल्स ns-3 सोर्स ट्रीच्या बाहेर ठेवायच्या असतील तर? युक्तिवाद वापरा - -cwd:

$ ./waf --cwd=...

तुमच्या कार्यरत निर्देशिकेत आउटपुट फाइल्स मिळवणे तुम्हाला अधिक सोयीचे वाटू शकते. या प्रकरणात, खालील अप्रत्यक्ष कृती मदत करू शकतात:

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

कमांडच्या मागील आवृत्तीची ही सजावट वर्तमान कार्यरत निर्देशिका जतन करते, निर्देशिकेत जाते वाफआणि नंतर सूचना देते वाफ प्रोग्रॅम सुरू करण्यापूर्वी जतन केलेल्या वर्तमान कार्यरत निर्देशिकेत कार्यरत निर्देशिका बदलण्यासाठी. आम्ही संघाचा उल्लेख करतो - -cwd पूर्णतेसाठी, बहुतेक वापरकर्ते फक्त उच्च-स्तरीय निर्देशिकेतून Waf चालवतात आणि तेथे आउटपुट फाइल्स तयार करतात.

चालू: अध्याय 4

स्त्रोत: www.habr.com