ns-3 नेटवर्क सिम्युलेटर ट्यूटोरियल। अध्याय ३

अध्याय 1,2

3 सुरु गर्दै
३.१ अवलोकन
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 परीक्षण ns-3
3.6 स्क्रिप्ट चलाउँदै
3.6.1 आदेश रेखा तर्कहरू
३.६.२ डिबगिङ
3.6.3 कार्य निर्देशिका

अध्याय 3

सुरु गर्दै

यो अध्याय ns-3 स्थापना नगरेको कम्प्युटरबाट सुरु गर्न पाठकलाई तयार पार्ने उद्देश्यले गरिएको हो। यसले समर्थित प्लेटफर्महरू, पूर्वतयारीहरू, कसरी ns-3 प्राप्त गर्ने, कसरी ns-3 निर्माण गर्ने, र कसरी तपाईंको निर्माण र सरल कार्यक्रमहरू चलाउने परीक्षण गर्ने समावेश गर्दछ।

३.१ अवलोकन

ns-3 सिम्युलेटर सहयोगी सफ्टवेयर पुस्तकालयहरूको प्रणालीको रूपमा बनाइएको छ। सभाको समयमा, प्रयोगकर्ता कार्यक्रमहरूको कोड यी पुस्तकालयहरूसँग जोडिएको छ। C++ वा पाइथन प्रोग्रामिङ भाषाहरू अनुकूलन कार्यक्रमहरू लेख्न प्रयोग गरिन्छ।

Ns-3 लाई स्रोत कोडको रूपमा वितरण गरिएको छ, जसको मतलब यो हो कि लक्षित प्रणालीमा पहिले पुस्तकालयहरू निर्माण गर्न र त्यसपछि प्रयोगकर्ता कार्यक्रम निर्माण गर्न सफ्टवेयर विकास वातावरण हुनुपर्छ। सिद्धान्तमा, ns-3 लाई निश्चित प्रणालीको लागि तयार पुस्तकालयहरूको रूपमा वितरण गर्न सकिन्छ, र भविष्यमा तिनीहरू यसरी वितरण गर्न सकिन्छ। तर आजकल धेरै प्रयोगकर्ताहरूले वास्तवमा ns-3 सम्पादन गरेर आफ्नो काम गर्छन्, त्यसैले पुस्तकालयहरू निर्माण गर्न स्रोत कोड हुनु उपयोगी छ। यदि कोही तयार पुस्तकालयहरू र अपरेटिङ सिस्टमहरूको लागि प्याकेजहरू सिर्जना गर्ने काममा लिन चाहनुहुन्छ भने, कृपया मेलिङ सूचीमा सम्पर्क गर्नुहोस्। ns-विकासकर्ताहरू.

अर्को, हामी ns-3 डाउनलोड र निर्माण गर्ने तीन तरिकाहरू हेर्नेछौं। पहिलो डाउनलोड र मुख्य साइटबाट आधिकारिक रिलीज निर्माण गर्न छ। दोस्रो आधारभूत ns-3 स्थापनाको विकास संस्करणहरूको प्रतिलिपिहरूको चयन र संयोजन हो। तेस्रो ns-3 को लागि थप विस्तारहरू लोड गर्न थप निर्माण उपकरणहरू प्रयोग गर्नु हो। उपकरणहरू थोरै फरक भएकाले हामी प्रत्येकमा जानेछौं।

अनुभवी लिनक्स प्रयोगकर्ताहरूले किन ns-3 प्याकेज प्रबन्धक प्रयोग गर्ने अन्य पुस्तकालयहरू जस्तै प्याकेजको रूपमा प्रदान गरिएको छैन भनेर सोच्न सक्छन्? यद्यपि त्यहाँ विभिन्न लिनक्स वितरणहरू (जस्तै डेबियन) को लागि बाइनरी प्याकेजहरू छन्, धेरै प्रयोगकर्ताहरूले पुस्तकालयहरू सम्पादन गर्न र ns-3 आफैंलाई पुन: निर्माण गर्नुपर्ने हुन्छ, त्यसैले स्रोत कोड उपलब्ध हुनु सजिलो छ। यस कारणको लागि, हामी स्रोतबाट स्थापनामा ध्यान केन्द्रित गर्नेछौं।

धेरै अनुप्रयोगहरूको लागि ns-3 अधिकारहरू मूल आवश्यक छैन, यो एक विशेषाधिकार प्रयोगकर्ता खाता प्रयोग गर्न सिफारिस गरिएको छ।

3.2 पूर्व शर्तहरू

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

यस विकिको पूर्वानुभूति खण्डले सामान्य ns-3 विकल्पहरूलाई समर्थन गर्न कुन प्याकेजहरू आवश्यक छ भनी व्याख्या गर्दछ र लिनक्स वा macOS को साझा स्वादहरूमा स्थापना गर्न प्रयोग गरिएका आदेशहरू पनि प्रदान गर्दछ।

तपाईंले ns-3 विकि पृष्ठ वा मुख्य वेबसाइट अन्वेषण गर्न यो अवसरको फाइदा लिन सक्नुहुन्छ: https://www.nsnam.org, किनभने त्यहाँ धेरै जानकारी छ। ns-3 (ns-3.29) को नवीनतम संस्करणबाट सुरु गर्दै, ns-3 चलाउन निम्न उपकरणहरू आवश्यक छन्:

उपकरण प्याकेज/संस्करण

• C++ कम्पाइलर
  clang++ वा g++ (g++ संस्करण ४.९ वा उच्च)
• अजगर
  python2 संस्करण >= 2.7.10, वा python3 संस्करण >=3.4
• Git
  कुनै पनि नवीनतम संस्करण (GitLab.com मा ns-3 पहुँच गर्न)
• tar
  कुनै पनि नवीनतम संस्करण (NS-3 रिलिज अनप्याक गर्न को लागी)
• bunzip2
  कुनै पनि नवीनतम संस्करण (ns-3 रिलिज अनप्याक गर्न को लागी)

पाइथनको पूर्वनिर्धारित संस्करण जाँच गर्न, टाइप गर्नुहोस् python -V। G++ संस्करण जाँच गर्न, टाइप गर्नुहोस् g++ -v। यदि कुनै उपकरण हराइरहेको छ वा धेरै पुरानो छ भने, कृपया ns-3 विकि पृष्ठमा स्थापना गाइडलाई सन्दर्भ गर्नुहोस्।

अब देखि, हामी मान्दछौं कि पाठकले लिनक्स, MacOS, वा लिनक्स इमुलेटर चलाउँदैछ, र कम्तिमा माथिका उपकरणहरू छन्।

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 

माथि प्रयोग गरिएको उपयोगितामा ध्यान दिनुहोस् विजेट, जुन इन्टरनेटबाट वस्तुहरू डाउनलोड गर्नको लागि कमाण्ड लाइन उपकरण हो। यदि तपाईंले यसलाई स्थापना गर्नुभएको छैन भने, तपाईं यसको लागि आफ्नो ब्राउजर प्रयोग गर्न सक्नुहुन्छ।

यी चरणहरू पछ्याउँदा तपाईंलाई 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-allinone। यो स्क्रिप्टहरूको सेट हो जसले प्रायः प्रयोग हुने 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-allinone माथि वर्णन गरिएको रिलीज संग्रह डाइरेक्टरी भन्दा थोरै फरक। यो यस्तो केहि देखिनु पर्छ:

$ 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-allinone थप भण्डारहरू डाउनलोड गरिनेछ ns-3, बेक, pybindgen и netanim.

भन्नु
सफा Ubuntu16.04 को साथ मेसिनमा, मैले यसमा आदेश परिवर्तन गर्न आवश्यक छ: $ sudo python3 download.py -n ns-3.29 (यसपछि अनुवादकका नोटहरू)।

3.3.1 बेक प्रयोग गरेर ns-3 लोड गर्दै

माथिका दुई विधिहरू (स्रोत अभिलेख वा भण्डार ns-3-allinone Git मार्फत) धेरै एडअनहरूसँग सरल ns-3 स्थापना प्राप्त गर्नका लागि उपयोगी छ।pybindgen पाइथन बाइन्डिङहरू उत्पन्न गर्न र netanim नेटवर्क एनिमेसनको लागि)। ns-3-allinone मा पूर्वनिर्धारित रूपमा प्रदान गरिएको तेस्रो भण्डार भनिन्छ बेक.

बेक गर्नुहोस् ns-3 परियोजनाको लागि विकसित बहु भण्डारहरूबाट सफ्टवेयरको समन्वयित निर्माणको लागि एउटा उपकरण हो। बेक गर्नुहोस् ns-3 को विकास संस्करणहरू प्राप्त गर्न, साथै ns-3 वितरणको आधार संस्करणको विस्तारहरू डाउनलोड गर्न र निर्माण गर्न प्रयोग गर्न सकिन्छ, जस्तै वातावरण प्रत्यक्ष कोड कार्यान्वयन, CradleNetwork सिमुलेशन पालना, नयाँ पाइथन बाइन्डिङहरू र विभिन्न ns-3 "अनुप्रयोगहरू" सिर्जना गर्ने क्षमता।

भन्नु
CradleNetwork सिमुलेशन 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

नोट गर्नुहोस् कि तपाईंले धेरै पाइथन स्क्रिप्टहरू लोड गर्नुभएको छ, नामको पाइथन मोड्युल बेक र XML कन्फिगरेसन फाइल। अर्को चरण यी स्क्रिप्टहरू डाउनलोड गर्न र तपाईंको मनपर्ने ns-3 वितरण निर्माण गर्न प्रयोग गर्नु हो। धेरै अनुकूलन लक्ष्यहरू उपलब्ध छन्:

1. ns-3.29: विमोचन अनुरूप मोड्युल; यसले टारबलमा रिलीज जस्तै घटकहरू डाउनलोड गर्नेछ;

2. ns-3-dev: समान मोड्युल, तर विकास रूखबाट कोड प्रयोग गर्दै;

3. ns-allinone-3.29: एउटा मोड्युल जसले अन्य अतिरिक्त सुविधाहरू समावेश गर्दछ जस्तै क्लिक राउटिङ र नेटवर्क सिमुलेशन क्र्याडल, ns-3 को लागि ओपनफ्लो।

4. ns-3-allinone: मोड्युलको रिलीज संस्करण जस्तै allinoneतर विकास कोडको लागि।

भन्नु
क्लिक गर्नुहोस् - राउटरहरू सिर्जना गर्न मोड्युलर सफ्टवेयर वास्तुकला।

Openflow राउटरहरू र स्विचहरू द्वारा डाटा नेटवर्कमा प्रसारित डाटा प्रशोधन गर्ने प्रक्रिया प्रबन्ध गर्नको लागि एक प्रोटोकल हो, सफ्टवेयर-परिभाषित नेटवर्क टेक्नोलोजी लागू गर्दै।

हालको विकास स्न्यापसट (गैर-रिलीज) 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 ...

विशेष गरी, Mercurial, CVS, Git र बजार जस्ता अपलोड उपकरणहरू यस चरणमा आवश्यक छन् किनभने तिनीहरूले हामीलाई कोड प्राप्त गर्न अनुमति दिन्छ। यस बिन्दुमा, हराएको उपकरणहरू तपाइँको प्रणालीको लागि सामान्य तरिकामा स्थापना गर्नुहोस् (यदि तपाइँ कसरी थाहा छ) वा मद्दतको लागि तपाइँको प्रणाली प्रशासकलाई सम्पर्क गर्नुहोस्।

अर्को, सफ्टवेयर डाउनलोड गर्ने प्रयास गर्नुहोस्:

$ ./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 भनिने निर्माण उपकरण प्रयोग गरेर बनाइएको हो Wafतल वर्णन गरिएको छ। धेरै प्रयोगकर्ताहरूले काम गर्नेछन् Waf, तर तपाइँलाई सुरु गर्न वा थप जटिल निर्माणहरू व्यवस्थित गर्न मद्दत गर्न केही उपयोगी स्क्रिप्टहरू छन्। त्यसैले कृपया, तपाईंले पढ्नु अघि Waf, एक नजर लिनुहोस् build.py र संग सभा बेक.

3.4.1 build.py को साथ भवन

सावधानी यो निर्माण चरण माथि वर्णन गरिए अनुसार प्राप्त स्रोत संग्रह संस्करणबाट मात्र उपलब्ध छ; र git वा बेक मार्फत डाउनलोड गरिएको छैन।

रिलीज अभिलेख संग काम गर्दा टारबलभित्र ns-3-allinone त्यहाँ एक उपयोगी स्क्रिप्ट छ जसले कम्पोनेन्टहरू सजिलो बनाउन सक्छ। यसलाई 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 निर्माण गर्न र पुस्तकालयहरू कायम राख्न उपयोगी छन्। वास्तवमा, निर्माण गर्न तिनीहरू निर्माण उपकरण चलाउँछन् Waf डाइरेक्टरी ns-3 बाट। Waf ns-3 स्रोत कोड संग स्थापित। धेरैजसो प्रयोगकर्ताहरू ns‑3 कन्फिगर र एसेम्बल गर्नको लागि सीधा प्रयोगमा छिट्टै अगाडि बढ्छन् Waf। त्यसोभए, जारी राख्न, कृपया तपाईंले सुरुमा सिर्जना गर्नुभएको ns-3 डाइरेक्टरीमा जानुहोस्।

यो यस समयमा कडाइका साथ आवश्यक छैन, तर यो थोरै ब्याकट्र्याक गर्न र परियोजना कन्फिगरेसनमा परिवर्तनहरू कसरी गर्ने भनेर हेर्न उपयोगी हुनेछ। सायद तपाईले गर्न सक्ने सबैभन्दा उपयोगी कन्फिगरेसन परिवर्तन कोडको अनुकूलित संस्करण सिर्जना गर्नु हो। पूर्वनिर्धारित रूपमा, तपाईंले डिबग संस्करण निर्माण गर्न आफ्नो परियोजना कन्फिगर गर्नुभएको छ। एक अप्टिमाइज्ड बिल्ड सिर्जना गर्नको लागि एउटा परियोजनालाई हेरौं। Waf लाई व्याख्या गर्नको लागि कि यसले उदाहरण र परीक्षणहरू समावेश गर्ने अनुकूलित निर्माणहरू बनाउनु पर्छ, तपाईंले निम्न आदेशहरू चलाउन आवश्यक हुनेछ:

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

यो सुरु हुनेछ Waf स्थानीय डाइरेक्टरी बाहिर (तपाईंको सुविधाको लागि)। पहिलो आदेशले अघिल्लो निर्माणबाट सफा गर्छ, यो सामान्यतया सख्त रूपमा आवश्यक छैन, तर यो राम्रो अभ्यास हो (तल निर्माण प्रोफाइलहरू पनि हेर्नुहोस्); यसले डाइरेक्टरीमा अवस्थित पहिले सिर्जना गरिएका पुस्तकालयहरू र वस्तु फाइलहरू मेटाउनेछ निर्माण/। जब परियोजना पुन: कन्फिगर हुन्छ र निर्माण प्रणालीले विभिन्न निर्भरताहरू जाँच गर्दछ, तपाईंले निम्नसँग मिल्दोजुल्दो आउटपुट देख्नुपर्छ:

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

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

कृपया माथिको सूचीको अन्तिम भागलाई ध्यान दिनुहोस्। केहि ns-3 विकल्पहरू पूर्वनिर्धारित रूपमा सक्षम छैनन् वा राम्रोसँग काम गर्न प्रणाली समर्थन आवश्यक छ। उदाहरणका लागि, XmlTo सक्षम गर्न, पुस्तकालय प्रणालीमा उपस्थित हुनुपर्छ libxml-2.0। यदि यो पुस्तकालय फेला परेन र सम्बन्धित ns-3 प्रकार्य सक्षम गरिएको थिएन भने, सन्देश प्रदर्शित हुनेछ। यो पनि आदेश प्रयोग गर्न सम्भव छ कि नोट गर्नुहोस् sudo suid बिट सेट गर्न "रनटाइममा समूह आईडी सेट गर्नुहोस्" निश्चित कार्यक्रमहरूको लागि। यो पूर्वनिर्धारित रूपमा सक्षम गरिएको छैन र त्यसैले यो सुविधा "सक्षम गरिएको छैन" को रूपमा देखिन्छ। अन्तमा, सक्षम विकल्पहरूको सूची प्राप्त गर्न, प्रयोग गर्नुहोस् Waf प्यारामिटर संग --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, तर अन्य विकल्पहरू Waf यसले प्रत्यक्ष समर्थन गर्दैन। उदाहरणका लागि, यसले काम गर्दैन:

$ ./build.py --disable-python

प्रतिक्रिया यस्तो हुनेछ:

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

यद्यपि, विशेष अपरेटर - - मार्फत थप प्यारामिटरहरू पास गर्न प्रयोग गर्न सकिन्छ wafत्यसैले माथिको सट्टा निम्न आदेशले काम गर्नेछ:

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

किनभने यसले मुख्य आदेश उत्पन्न गर्दछ ./waf कन्फिगर --disable-python। यहाँ केहि थप परिचयात्मक सुझावहरू छन् Waf.

निर्माण त्रुटिहरू ह्यान्डल गर्दै

ns-3 रिलीजहरू सामान्य लिनक्स र MacOS वितरणहरूमा रिलीजको समयमा उपलब्ध नवीनतम C++ कम्पाइलरहरूमा परीक्षण गरिन्छ। जे होस्, समयको साथ, नयाँ वितरणहरू नयाँ कम्पाइलरहरूसँग जारी हुन्छन्, र यी नयाँ कम्पाइलरहरू चेतावनीहरूको बारेमा बढी पेडेन्टिक हुन्छन्। ns-3 ले सबै चेतावनीहरूलाई त्रुटिहरूको रूपमा व्यवहार गर्न यसको निर्माण कन्फिगर गर्दछ, त्यसैले कहिलेकाहीँ यदि तपाइँ नयाँ प्रणालीमा पुरानो संस्करण चलाउँदै हुनुहुन्छ भने, कम्पाइलर चेतावनीले निर्माण रोक्न सक्छ।

उदाहरण को लागी, फेडोरा 3.28 को लागी पहिले ns‑28 को रिलीज थियो, जसमा नयाँ प्रमुख संस्करण शामिल थियो। gcc (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 बाट सुरु हुने रिलीजहरूमा, in Waf यी समस्याहरू समाधान गर्न विकल्प उपलब्ध छ। यसले g++ र clang++ मा "-Werror" झण्डा सेट गर्न असक्षम पार्छ। यो "--disable-werror" विकल्प हो र कन्फिगरेसनको समयमा लागू गर्नुपर्छ:

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

कन्फिगर वा भेला गर्नुहोस्

केही आदेशहरू Waf कन्फिगरेसन चरणमा मात्र अर्थ हुन्छ, र केही निर्माण चरणमा मात्र मान्य हुन्छन्। उदाहरणका लागि, यदि तपाइँ ns-3 इमुलेशन सुविधाहरू प्रयोग गर्न चाहनुहुन्छ भने, तपाइँ बिट सेटिङ सक्षम गर्न सक्नुहुन्छ दक्षिण प्रयोग गर्दै sudo, माथि वर्णन गरिए अनुसार। यसले कन्फिगरेसन चरण आदेशहरूलाई ओभरराइड गर्नेछ, र यसरी तपाईंले निम्न आदेश प्रयोग गरेर कन्फिगरेसन परिवर्तन गर्न सक्नुहुन्छ, जसमा उदाहरण र परीक्षणहरू पनि समावेश छन्।

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

यदि तपाइँ यो गर्नुहुन्छ भने Waf सुरु हुनेछ sudoइमुलेशन कोड सकेट सिर्जना कार्यक्रम अनुमति संग चलाउन परिवर्तन गर्न मूल। को Waf कन्फिगरेसन र निर्माण चरणहरूको लागि त्यहाँ धेरै अन्य विकल्पहरू उपलब्ध छन्। आफ्नो विकल्पहरू अन्वेषण गर्न, प्रविष्ट गर्नुहोस्:

$ ./waf --help

अर्को खण्डमा हामी केही परीक्षण सम्बन्धित विकल्पहरू प्रयोग गर्नेछौं।

विधानसभा प्रोफाइल

हामीले पहिले नै देखेका छौं कि तपाइँ कसरी कन्फिगर गर्न सक्नुहुन्छ Waf सभाहरूको लागि डिबग и अनुकूलित:

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

पूर्वनिर्धारित, Waf बिल्ड डाइरेक्टरीमा कलाकृतिहरू निर्माण गर्दछ। तपाईले विकल्प प्रयोग गरेर फरक आउटपुट डाइरेक्टरी निर्दिष्ट गर्न सक्नुहुन्छ - -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
...

जसले तपाइँलाई प्रत्येक पटक भर्खरको असेंबलीलाई पुन: लेख्न बिना धेरै सम्मेलनहरूसँग काम गर्न अनुमति दिन्छ। जब तपाइँ अर्को प्रोफाइलमा स्विच गर्नुहुन्छ, Waf यसलाई मात्र कम्पाइल गर्नेछ, पूर्ण रूपमा सबै कुरा पुन: कम्पाइल नगरी।

जब तपाइँ यस तरिकाले निर्माण प्रोफाइलहरू स्विच गर्नुहुन्छ, तपाइँ प्रत्येक पटक समान कन्फिगरेसन विकल्पहरू दिन सावधान हुन आवश्यक छ। धेरै वातावरणीय चरहरू परिभाषित गर्नाले तपाईंलाई गल्तीहरूबाट बच्न मद्दत गर्नेछ:

$ 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

कम्पाइलर र झण्डा

माथिका उदाहरणहरूमा Waf ns-3 निर्माण गर्न GCC बाट C++ कम्पाइलर प्रयोग गर्दछ ( g ++)। जे होस्, तपाईंले प्रयोग गर्नुभएको एउटा परिवर्तन गर्न सक्नुहुन्छ Waf C++ कम्पाइलर, CXX वातावरण चर परिभाषित गरेर। उदाहरण को लागी, C++ कम्पाइलर Clang, clang++ को उपयोग गर्न को लागी,

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

त्यसै गरी तपाइँ कन्फिगर गर्न सक्नुहुन्छ Waf प्रयोग गरी वितरित संकलन प्रयोग गर्न distcc:

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

distcc र वितरण गरिएको संकलनको बारेमा थप जानकारी कागजात खण्डको परियोजना पृष्ठमा पाउन सकिन्छ। ns-3 कन्फिगर गर्दा कम्पाइलर फ्ल्यागहरू थप्न, CXXFLAGS_EXTRA वातावरण चर प्रयोग गर्नुहोस्।

सेटिङ

Waf प्रणालीमा विभिन्न स्थानहरूमा पुस्तकालयहरू स्थापना गर्न प्रयोग गर्न सकिन्छ। पूर्वनिर्धारित रूपमा, संकलित पुस्तकालयहरू र कार्यान्वयनयोग्यहरू डाइरेक्टरीमा अवस्थित छन् निर्माण, र Waf लाई यी पुस्तकालयहरू र कार्यान्वयनयोग्यहरूको स्थान थाहा भएकोले, त्यहाँ पुस्तकालयहरू अन्यत्र स्थापना गर्न आवश्यक छैन।

यदि प्रयोगकर्ताहरूले निर्माण डाइरेक्टरी बाहिर स्थापना गर्न रुचाउँछन् भने, तिनीहरूले आदेश चलाउन सक्छन् ./waf स्थापना। स्थापनाको लागि पूर्वनिर्धारित उपसर्ग हो / usr / स्थानीयत्यसकारण ./waf स्थापना मा प्रोग्रामहरू स्थापना गर्नेछ / usr / local / bin, पुस्तकालयहरु मा / usr / local / lib र हेडर फाइलहरू मा /usr/local/include। सुपर प्रयोगकर्ता अधिकारहरू सामान्यतया पूर्वनिर्धारित उपसर्गको साथ सेट गर्न आवश्यक छ, त्यसैले एक सामान्य आदेश हुनेछ sudo ./waf स्थापना गर्नुहोस्। जब सुरु हुन्छ, Waf ले पहिले निर्माण डाइरेक्टरीमा साझा पुस्तकालयहरू प्रयोग गर्न छनौट गर्नेछ, त्यसपछि स्थानीय वातावरणमा कन्फिगर गरिएका पुस्तकालयहरूको मार्गमा पुस्तकालयहरू खोज्नेछ। त्यसोभए प्रणालीमा पुस्तकालयहरू स्थापना गर्दा, सही पुस्तकालयहरू प्रयोग भइरहेको छ कि छैन भनी जाँच्नु राम्रो अभ्यास हो। प्रयोगकर्ताहरूले कन्फिगरेसनको समयमा विकल्प पास गरेर फरक उपसर्गसँग स्थापना गर्न छनौट गर्न सक्छन् --prefix, उदाहरणका लागि:

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

यदि पछि, निर्माण पछि, प्रयोगकर्ताले स्थापना आदेश प्रविष्ट गर्दछ ./waf, उपसर्ग प्रयोग गरिनेछ /opt/local.

टोली ./waf clean यदि स्थापना प्रयोग हुनेछ भने परियोजना पुन: कन्फिगर गर्नु अघि प्रयोग गर्नुपर्छ Waf फरक उपसर्ग अन्तर्गत।

तसर्थ, ns-3 प्रयोग गर्न कल गर्न आवश्यक छैन ./waf install। धेरै प्रयोगकर्ताहरूलाई यो आदेश आवश्यक पर्दैन किनभने Waf बिल्ड डाइरेक्टरीबाट हालको पुस्तकालयहरू उठाउनेछ, तर केही प्रयोगकर्ताहरूले यो उपयोगी पाउन सक्छन् यदि तिनीहरूका गतिविधिहरूले ns-3 डाइरेक्टरी बाहिरका कार्यक्रमहरूसँग काम गर्ने समावेश गर्दछ।

Waf एकल

ns-3 स्रोत रूखको शीर्ष तहमा, त्यहाँ एउटा मात्र Waf लिपि छ। एकपटक तपाईंले काम सुरु गरेपछि, तपाईंले डाइरेक्टरीमा धेरै समय खर्च गर्नुहुनेछ scratch/ वा गहिरो माsrc/... र एकै समयमा दौडनु पर्छ Waf। तपाईं कहाँ हुनुहुन्छ सम्झना र भाग्न सक्नुहुन्छ Waf निम्न अनुसार:

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

तर यो कठिन र त्रुटि प्रवण हुनेछ, त्यसैले त्यहाँ राम्रो समाधानहरू छन्। एउटा सामान्य तरिका भनेको पाठ सम्पादक जस्तै प्रयोग गर्नु हो emacs वा vim, जसमा दुई टर्मिनल सत्रहरू खोलिन्छन्, एउटा ns-3 निर्माण गर्न प्रयोग गरिन्छ, र दोस्रो स्रोत कोड सम्पादन गर्न प्रयोग गरिन्छ। यदि तपाईंसँग मात्र छ टारबल, त्यसपछि वातावरण चरले मद्दत गर्न सक्छ:

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

$ cd scratch 
$ waff build

मोड्युल डाइरेक्टरीमा यो सानो वाफ स्क्रिप्ट जस्तै थप्न प्रलोभन हुन सक्छ exec ../../waf। कृपया, त्यसो नगर्नुहोस्। यो नवजातिका लागि भ्रामक छ र, खराब तरिकाले गर्दा, निर्माण त्रुटिहरू पत्ता लगाउन गाह्रो हुन्छ। माथि देखाइएका समाधानहरू प्रयोग गरिनु पर्ने मार्ग हो।

3.5 परीक्षण ns-3

तपाईंले स्क्रिप्ट चलाएर ns-3 वितरणको एकाइ परीक्षणहरू चलाउन सक्नुहुन्छ ./test.py:

$ ./test.py

यी परीक्षणहरू समानान्तर रूपमा चलाइन्छ Waf। अन्ततः तपाईंले एउटा सन्देश देख्नुपर्छ:

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

यो भ्याल्ग्रिन्ड क्र्यास, क्र्यास वा त्रुटिहरू पहिचान गर्नको लागि महत्त्वपूर्ण सन्देश हो, कोडसँग समस्या वा उपकरण र कोड बीचको असंगततालाई संकेत गर्दछ।

तपाईले अन्तिम आउटपुट पनि देख्नुहुनेछ Waf र प्रत्येक परीक्षण चलाउने एक परीक्षक, जुन केहि यस्तो देखिन्छ:

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: ..." रेखाहरूको क्रम फरक हुन सक्छ, यो सामान्य हो। के महत्त्वपूर्ण छ कि रिपोर्टको अन्त्यमा सारांश रेखाले सबै परीक्षणहरू उत्तीर्ण भएको देखाउँछ; कुनै पनि परीक्षण असफल वा क्र्यास भएको छैन।) र Wafर test.py मेसिनको उपलब्ध प्रोसेसर कोरहरूमा कामलाई समानान्तर बनाउनेछ।

3.6 स्क्रिप्ट चलाउँदै

हामी सामान्यतया नियन्त्रणमा लिपिहरू चलाउँछौं Waf। यसले निर्माण प्रणालीलाई साझा पुस्तकालय मार्गहरू सही रूपमा सेट गरिएको छ र पुस्तकालयहरू रनटाइममा उपलब्ध छन् भनी सुनिश्चित गर्न अनुमति दिन्छ। कार्यक्रम चलाउन, बस प्रयोग गर्नुहोस् Waf प्यारामिटर संग - -run। सर्वव्यापी कार्यक्रमको ns-3 समतुल्य चलाउनुहोस् नमस्कार संसारनिम्न टाइप गरेर:

$ ./waf --run hello-simulator

Waf ले पहिले कार्यक्रम ठीकसँग बनाइएको छ कि छैन जाँच गर्नेछ र आवश्यक भएमा निर्माण गर्नेछ। त्यसपछि Waf निम्न आउटपुट उत्पादन गर्ने कार्यक्रम कार्यान्वयन गर्नेछ।

Hello Simulator

बधाई छ! तपाईं अब ns-3 प्रयोगकर्ता हुनुहुन्छ!

मैले नतिजा नदेखेमा के गर्नुपर्छ?

यदि तपाइँ सन्देशहरू देख्नुहुन्छ Wafनिर्माण सफलतापूर्वक सम्पन्न भएको संकेत गर्दै, तर तपाईंले आउटपुट देख्नुभएन "नमस्ते सिम्युलेटर", त्यसपछि त्यहाँ सम्भव छ कि [Build-with-Waf] खण्डमा तपाईंले आफ्नो निर्माण मोड स्विच गर्नुभयो अनुकूलित, तर मोडमा फिर्ता स्विच गर्न छुटेको छ डिबग। यस ट्यूटोरियलमा प्रयोग गरिएका सबै कन्सोल आउटपुटले लगिङ गर्ने र कन्सोलमा अनुकूलन सन्देशहरू प्रिन्ट गर्न प्रयोग गर्ने विशेष ns-3 कम्पोनेन्ट प्रयोग गर्दछ। यस कम्पोनेन्टबाट आउटपुट स्वतः अक्षम हुन्छ जब अनुकूलित कोड कम्पाइल हुन्छ - यो "अप्टिमाइज" हुन्छ। यदि तपाईंले "हेलो सिम्युलेटर" आउटपुट देख्नुभएन भने, निम्न प्रविष्ट गर्नुहोस्:

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

अनुकूलन गर्न Waf ns-3 कार्यक्रमहरूको डिबग संस्करणहरू निर्माण गर्न, जसमा उदाहरणहरू र परीक्षणहरू समावेश छन्। तपाईंले टाइप गरेर कोडको हालको डिबग संस्करण पुन: निर्माण गर्नुपर्छ

$ ./waf

अब यदि तपाइँ कार्यक्रम चलाउनुहुन्छ नमस्कार-सिम्युलेटर, तपाईंले अपेक्षित परिणाम देख्नुपर्छ।

3.6.1 आदेश रेखा तर्कहरू

ns-3 कार्यक्रममा आदेश रेखा तर्कहरू पास गर्न, निम्न ढाँचा प्रयोग गर्नुहोस्:

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

प्रतिस्थापन गर्नुहोस् तपाईंको कार्यक्रमको नाम र तर्कहरूमा। तर्क - -command-template लागि Waf अनिवार्य रूपमा वास्तविक आदेश रेखा निर्माणको लागि एक नुस्खा हो Waf कार्यक्रम कार्यान्वयन गर्न प्रयोग गरिन्छ। Waf ले निर्माण पूरा भएको जाँच गर्छ, साझा पुस्तकालय मार्गहरू सेट गर्छ, त्यसपछि प्रदान गरिएको कमाण्ड लाइन टेम्प्लेट प्रयोग गर्दछ र कार्यान्वयनयोग्य कल गर्न %s प्लेसहोल्डरको लागि कार्यक्रम नाम प्रतिस्थापन गर्दछ। यदि तपाईंले यो वाक्यविन्यास जटिल पाउनुभयो भने, त्यहाँ एक सरल संस्करण छ जसमा ns-3 कार्यक्रम र यसको तर्कहरू एकल उद्धरणहरूमा संलग्न छन्:

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

अर्को विशेष उपयोगी उदाहरण छनोट रूपमा परीक्षण सुइटहरू चलिरहेको छ। मानौं त्यहाँ एक परीक्षण सूट छ जसलाई mytest भनिन्छ (वास्तवमा त्यहाँ छैन)। माथि हामीले ./test.py स्क्रिप्टलाई समानान्तरमा धेरै परीक्षणहरू चलाउन प्रयोग गर्यौं, जसले बारम्बार परीक्षण कार्यक्रमलाई कल गर्छ। परीक्षण धावक। कल गर्नुहोस् परीक्षण धावक सीधा एक परीक्षण चलाउन:

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

कार्यक्रममा तर्कहरू पारित गरिनेछ परीक्षण धावक। Mytest अवस्थित नभएकोले, त्रुटि सन्देश उत्पन्न हुनेछ। उपलब्ध परीक्षण-धावक विकल्पहरू छाप्न, प्रविष्ट गर्नुहोस्:

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

३.६.२ डिबगिङ

ns-3 प्रोग्रामहरू अर्को उपयोगिता अन्तर्गत चलाउन, जस्तै डिबगर (उदाहरणका लागि, gdb) वा मेमोरी परीक्षण उपकरण (उदाहरणका लागि, valgrind), समान फारम प्रयोग गर्नुहोस् - -command-template = "…"। उदाहरणका लागि, डिबगरमा चलाउन gdb तर्क संग तपाईको नमस्कार-सिम्युलेटर ns-3 कार्यक्रम:

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

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

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

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

Waf लाई ns-3 रूखको शीर्षमा यसको स्थानबाट सुरु गर्नुपर्छ। यो फोल्डर कार्य निर्देशिका बन्छ जहाँ आउटपुट फाइलहरू लेखिनेछ। तर के यदि तपाइँ यी फाइलहरू ns-3 स्रोत रूख बाहिर राख्न चाहनुहुन्छ भने? तर्क प्रयोग गर्नुहोस् - -cwd:

$ ./waf --cwd=...

तपाईले आफ्नो काम गर्ने डाइरेक्टरीमा आउटपुट फाइलहरू प्राप्त गर्न यो अझ सुविधाजनक पाउन सक्नुहुन्छ। यस अवस्थामा, निम्न अप्रत्यक्ष कार्यले मद्दत गर्न सक्छ:

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

आदेशको अघिल्लो संस्करणको यो सजावटले हालको काम गर्ने डाइरेक्टरीलाई सुरक्षित गर्दछ, डाइरेक्टरीमा जान्छ Wafर त्यसपछि निर्देशन दिन्छ Waf काम गर्ने डाइरेक्टरीलाई हालको काम गर्ने डाइरेक्टरीमा परिवर्तन गर्नको लागि कार्यक्रम सुरु गर्नु अघि बचत गरिएको छ। हामी टोली उल्लेख गर्छौं - -cwd पूर्णताको लागि, धेरै प्रयोगकर्ताहरूले केवल शीर्ष-स्तर डाइरेक्टरीबाट Waf चलाउँछन् र त्यहाँ आउटपुट फाइलहरू उत्पन्न गर्छन्।

जारी: अध्याय 4

स्रोत: www.habr.com