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

अध्याय 1,2

3 आरंभ करना
3.1 सिंहावलोकन
3.2 पूर्वापेक्षाएँ
3.2.1 एनएस-3 रिलीज को स्रोत संग्रह के रूप में डाउनलोड करना
3.3 Git का उपयोग करके ns-3 डाउनलोड करना
3.3.1 बेक का उपयोग करके एनएस-3 लोड करना
3.4 असेंबली एनएस-3
3.4.1 build.py के साथ बिल्डिंग
3.4.2 बेक के साथ बिल्डिंग
3.4.3 वफ़ के साथ निर्माण करें
3.5 परीक्षण एनएस-3
3.6 स्क्रिप्ट चलाना
3.6.1 कमांड लाइन तर्क
3.6.2 डिबगिंग
3.6.3 कार्यशील निर्देशिका

अध्याय 3

शुरू करना

इस अध्याय का उद्देश्य पाठक को ऐसे कंप्यूटर के साथ शुरुआत करने के लिए तैयार करना है जिसने कभी भी एनएस-3 स्थापित नहीं किया हो। इसमें समर्थित प्लेटफ़ॉर्म, पूर्वापेक्षाएँ, एनएस-3 कैसे प्राप्त करें, एनएस-3 कैसे बनाएं, और अपने निर्माण का परीक्षण कैसे करें और सरल प्रोग्राम कैसे चलाएं, शामिल हैं।

3.1 सिंहावलोकन

एनएस-3 सिम्युलेटर को सहयोगी सॉफ्टवेयर लाइब्रेरी की एक प्रणाली के रूप में बनाया गया है। असेंबली के दौरान यूजर प्रोग्राम के कोड को इन लाइब्रेरीज़ के साथ जोड़ा जाता है। कस्टम प्रोग्राम लिखने के लिए C++ या Python प्रोग्रामिंग भाषाओं का उपयोग किया जाता है।

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

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

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

अधिकांश अनुप्रयोगों के लिए एनएस-3 अधिकार जड़ की आवश्यकता नहीं है, एक अविशेषाधिकार प्राप्त उपयोगकर्ता खाते का उपयोग करने की अनुशंसा की जाती है।

3.2 पूर्वापेक्षाएँ

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

इस विकि का पूर्वापेक्षा अनुभाग बताता है कि सामान्य एनएस-3 विकल्पों का समर्थन करने के लिए कौन से पैकेज की आवश्यकता है और उन्हें लिनक्स या मैकओएस के सामान्य फ्लेवर पर स्थापित करने के लिए उपयोग किए जाने वाले कमांड भी प्रदान करता है।

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

टूल पैकेज/संस्करण

• सी++ कंपाइलर
  क्लैंग++ या जी++ (जी++ संस्करण 4.9 या उच्चतर)
• अजगर
  Python2 संस्करण >= 2.7.10, या Python3 संस्करण >=3.4
• जाना
  कोई भी नवीनतम संस्करण (GitLab.com पर ns-3 तक पहुंचने के लिए)
• टार
  कोई भी नवीनतम संस्करण (एनएस‑3 रिलीज़ को अनपैक करने के लिए)
• बंज़िप2
  कोई भी नवीनतम संस्करण (ns‑3 रिलीज़ को अनपैक करने के लिए)

पायथन के डिफ़ॉल्ट संस्करण की जांच करने के लिए, टाइप करें python -V. g++ संस्करण जांचने के लिए टाइप करें g++ -v. यदि कोई उपकरण गायब है या बहुत पुराना है, तो कृपया एनएस-3 विकी पेज पर इंस्टॉलेशन गाइड देखें।

अब से, हम मानते हैं कि रीडर लिनक्स, मैकओएस, या लिनक्स एमुलेटर चला रहा है, और उसके पास कम से कम उपरोक्त उपकरण हैं।

3.2.1 एनएस-3 रिलीज को स्रोत संग्रह के रूप में डाउनलोड करना

यह एक नए उपयोगकर्ता के लिए कार्रवाई का तरीका है जो एनएस-3 के नवीनतम रिलीज और पैकेज संस्करणों को डाउनलोड करना और प्रयोग करना चाहता है। एनएस-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

अब आप एनएस-3 आधार वितरण बनाने के लिए तैयार हैं और एनएस-3 के निर्माण अनुभाग पर आगे बढ़ सकते हैं।

3.3 Git का उपयोग करके ns-3 डाउनलोड करना

ns-3 कोड GitLab.com पर Git रिपॉजिटरी में उपलब्ध है https://gitlab.com/nsnam/. समूह nsnam एक ओपन सोर्स प्रोजेक्ट द्वारा उपयोग की जाने वाली विभिन्न रिपॉजिटरी को एक साथ लाता है।

Git रिपॉजिटरी का उपयोग शुरू करने का सबसे आसान तरीका पर्यावरण को फोर्क या क्लोन करना है एनएस-3-एलिनोन. यह स्क्रिप्ट का एक सेट है जो सबसे अधिक उपयोग किए जाने वाले एनएस-3 सबसिस्टम की लोडिंग और असेंबली का प्रबंधन करता है। यदि आप Git में नए हैं, तो "कांटा" और "क्लोन" शब्द आपके लिए अपरिचित हो सकते हैं; यदि ऐसा है, तो हम अनुशंसा करते हैं कि आप GitLab.com पर स्थित रिपॉजिटरी को इस तरह क्लोन करें (अपनी प्रतिलिपि बनाएं):

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

इस स्तर पर, आपकी निर्देशिका का दृश्य एनएस-3-एलिनोन ऊपर वर्णित रिलीज़ संग्रह निर्देशिका से थोड़ा अलग। यह कुछ इस तरह दिखना चाहिए:

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

कृपया ध्यान दें कि एक स्क्रिप्ट है डाउनलोड.py, जो अतिरिक्त रूप से ns-3 और संबंधित स्रोत कोड को निकालेगा। यहां आपके पास एक विकल्प है: या तो नवीनतम एनएस-3 विकास स्नैपशॉट डाउनलोड करें:

$ python download.py

या ध्वज का उपयोग करके ns-3 रिलीज़ को प्राथमिकता दें -n रिलीज़ संख्या दर्शाने के लिए:

$ python download.py -n ns-3.29

निर्देशिका के लिए इस कदम के बाद एनएस-3-एलिनोन अतिरिक्त रिपॉजिटरी डाउनलोड की जाएंगी एनएस -3, सेंकना, pybindgen и नेतनिम.

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

3.3.1 बेक का उपयोग करके एनएस-3 लोड करना

उपरोक्त दो विधियाँ (स्रोत संग्रह या रिपॉजिटरी एनएस-3-एलिनोन Git के माध्यम से) एकाधिक ऐडऑन के साथ सरलतम ns-3 इंस्टालेशन प्राप्त करने के लिए उपयोगी हैं(pybindgen पायथन बाइंडिंग उत्पन्न करने के लिए और नेतनिम नेटवर्क एनीमेशन के लिए)। ns-3-allinone में डिफ़ॉल्ट रूप से प्रदान की गई तीसरी रिपॉजिटरी को कहा जाता है सेंकना.

सेंकना एनएस-3 प्रोजेक्ट के लिए विकसित कई रिपॉजिटरी से सॉफ्टवेयर के समन्वित निर्माण के लिए एक उपकरण है। सेंकना एनएस-3 के विकास संस्करणों को प्राप्त करने के साथ-साथ पर्यावरण जैसे एनएस-3 वितरण के आधार संस्करण के एक्सटेंशन को डाउनलोड करने और बनाने के लिए उपयोग किया जा सकता है। प्रत्यक्ष कोड निष्पादन, क्रैडलनेटवर्क सिमुलेशन क्रैडल, नई पायथन बाइंडिंग और विभिन्न ns-3 "ऐप्स" बनाने की क्षमता।

नोट
क्रैडलनेटवर्क सिमुलेशन क्रैडल एक ढांचा है जो आपको नेटवर्क सिम्युलेटर के अंदर वास्तविक टीसीपी/आईपी नेटवर्क स्टैक का उपयोग करने की अनुमति देता है।

यदि आप उम्मीद करते हैं कि आपके ns-3 इंस्टालेशन में उन्नत या अतिरिक्त सुविधाएँ होंगी, तो आप इस इंस्टालेशन पथ का अनुसरण कर सकते हैं।

नवीनतम एनएस-3 रिलीज़ में सेंकना टार रिलीज में जोड़ा गया था। रिलीज़ में एक कॉन्फ़िगरेशन फ़ाइल शामिल है जो आपको रिलीज़ के समय वर्तमान सॉफ़्टवेयर संस्करण डाउनलोड करने की अनुमति देती है। उदाहरण के लिए, वह संस्करण है सेंकना, जिसे रिलीज़ ns-3.29 के साथ वितरित किया जाता है, का उपयोग ns-3 या उससे पहले के रिलीज़ के लिए घटकों को पुनः प्राप्त करने के लिए किया जा सकता है, लेकिन बाद के रिलीज़ के लिए घटकों को पुनः प्राप्त करने के लिए इसका उपयोग नहीं किया जा सकता है (यदि पैकेज विवरण फ़ाइल बेककॉन्फ.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 कॉन्फ़िगरेशन फ़ाइल. अगला कदम अपनी पसंद के एनएस-3 वितरण को डाउनलोड करने और बनाने के लिए इन स्क्रिप्ट का उपयोग करना है। कई अनुकूलन लक्ष्य उपलब्ध हैं:

1. एनएस -3.29: रिलीज के अनुरूप मॉड्यूल; यह टारबॉल में रिलीज़ के समान घटकों को डाउनलोड करेगा;

2. एनएस-3-देव: एक समान मॉड्यूल, लेकिन विकास वृक्ष से कोड का उपयोग करना;

3. एनएस-एलिनोन-3.29: एक मॉड्यूल जिसमें क्लिक रूटिंग और नेटवर्क सिमुलेशन क्रैडल, एनएस-3 के लिए ओपनफ्लो जैसी अन्य अतिरिक्त सुविधाएं शामिल हैं।

4. एनएस-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

इसमें कार्यक्रम रखा जाएगा बेक.पी.ई शेल पथ पर और अन्य प्रोग्रामों को उसके द्वारा बनाए गए निष्पादन योग्य और लाइब्रेरीज़ को ढूंढने की अनुमति देगा सेंकना. कुछ उपयोग के मामलों में सेंकना, ऊपर वर्णित 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 असेंबली एनएस-3

एनएस-3 डाउनलोड करने की तरह, एनएस-3 बनाने के भी कई तरीके हैं। मुख्य बात जिस पर हम जोर देना चाहते हैं वह यह है कि ns-3 नामक बिल्ड टूल का उपयोग करके बनाया गया है wafनीचे वर्णित। अधिकांश उपयोगकर्ताओं के साथ काम करेंगे waf, लेकिन आरंभ करने या अधिक जटिल बिल्ड को व्यवस्थित करने में आपकी सहायता के लिए कुछ उपयोगी स्क्रिप्ट हैं। तो कृपया, इससे पहले कि आप इसके बारे में पढ़ें waf, पर एक नज़र डालें बिल्ड.py और असेंबली के साथ सेंकना.

3.4.1 build.py के साथ बिल्डिंग

चेतावनी! यह निर्माण चरण केवल ऊपर वर्णित अनुसार प्राप्त स्रोत संग्रह संस्करण से उपलब्ध है; और गिट या बेक के माध्यम से डाउनलोड नहीं किया गया।

रिलीज़ संग्रह के साथ काम करते समय टारबॉलमें एनएस-3-एलिनोन एक आसान स्क्रिप्ट है जो घटकों को असेंबल करना आसान बना सकती है। इसे build.py कहा जाता है. यह प्रोग्राम आपके लिए सबसे उपयोगी तरीके से प्रोजेक्ट स्थापित करेगा। हालाँकि, ध्यान दें कि अधिक उन्नत सेटअप और ns-3 के साथ काम करने में आमतौर पर ns-3 के स्वयं के बिल्ड सिस्टम, Waf का उपयोग करना शामिल होता है, जिसे बाद में इस ट्यूटोरियल में पेश किया जाएगा।

यदि आपने इसका उपयोग करके डाउनलोड किया है टारबॉल, फिर आपकी निर्देशिका में ~/कार्यक्षेत्र एक निर्देशिका जिसका नाम कुछ इस प्रकार है एनएस-एलिनोन-3.29. निम्नलिखित दर्ज करें:

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

जब बुलाया गया बिल्ड.py हमने इस ट्यूटोरियल में उपयोग किए गए उदाहरणों और परीक्षणों को बनाने के लिए कमांड लाइन तर्कों का उपयोग किया, जो एनएस-3 में डिफ़ॉल्ट रूप से नहीं बनाए गए हैं। डिफ़ॉल्ट रूप से, प्रोग्राम सभी उपलब्ध मॉड्यूल भी बनाता है। फिर, यदि आप चाहें, तो आप उदाहरणों और परीक्षणों के बिना एनएस-3 बना सकते हैं, या उन मॉड्यूल को बाहर कर सकते हैं जिनकी आपके काम के लिए आवश्यकता नहीं है।

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

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

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

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

सूची की अंतिम तीन पंक्तियों में हम उन मॉड्यूल के बारे में एक संदेश देखते हैं जो निर्मित नहीं हुए थे:

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

इसका सीधा मतलब यह है कि कुछ एनएस-3 मॉड्यूल जो बाहरी पुस्तकालयों पर निर्भर हैं, नहीं बनाए गए हैं, या इस कॉन्फ़िगरेशन के लिए उन्हें बनाने की आवश्यकता नहीं है। इसका मतलब यह नहीं है कि सिम्युलेटर असेंबल नहीं किया गया है या असेंबल किए गए मॉड्यूल सही ढंग से काम नहीं करेंगे।

3.4.2 बेक के साथ बिल्डिंग

यदि आपने प्रोजेक्ट रिपॉजिटरी से स्रोत कोड प्राप्त करने के लिए उपरोक्त बेक का उपयोग किया है, तो आप एनएस-3 बनाने के लिए इसका उपयोग जारी रख सकते हैं। डायल करें:

$ ./bake.py build

और आपको कुछ इस तरह देखना चाहिए:

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

मदद: आप "bake.py Deploy" पर कॉल करके डाउनलोड और बिल्ड दोनों चरण एक साथ कर सकते हैं।

सभी घटकों की असेंबली विफल हो सकती है, लेकिन यदि घटक की आवश्यकता नहीं है तो असेंबली जारी रहेगी। उदाहरण के लिए, हाल ही में एक पोर्टेबिलिटी समस्या थी कास्टxml टूल द्वारा असेंबल किया जा सकता है सेंकना सभी प्लेटफ़ॉर्म पर नहीं. इस स्थिति में, इस तरह एक संदेश दिखाई देगा:

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

लेकिन कास्टxml केवल तभी आवश्यक है जब आप अद्यतन पायथन बाइंडिंग बनाना चाहते हैं। अधिकांश उपयोगकर्ताओं के लिए इसकी कोई आवश्यकता नहीं है (कम से कम जब तक वे ns-3 नहीं बदलते हैं), इसलिए ऐसी चेतावनियों को अभी सुरक्षित रूप से अनदेखा किया जा सकता है।

यदि यह विफल रहता है, तो निम्न आदेश आपको लापता निर्भरता के बारे में संकेत देगा:

$ ./bake.py show

आप जिन पैकेजों को बनाने का प्रयास कर रहे हैं उनकी विभिन्न निर्भरताएँ सूचीबद्ध की जाएंगी।

3.4.3 वफ़ के साथ निर्माण करें

इस बिंदु तक, एनएस-3 का निर्माण शुरू करने के लिए, हमने या तो स्क्रिप्ट का उपयोग किया था बिल्ड.py, या उपकरण सेंकना. ये उपकरण एनएस-3 के निर्माण और पुस्तकालयों के रखरखाव के लिए उपयोगी हैं। दरअसल, निर्माण के लिए वे बिल्ड टूल चलाते हैं waf निर्देशिका एनएस-3 से। waf ns-3 स्रोत कोड के साथ स्थापित किया गया। अधिकांश उपयोगकर्ता ns‑3 को कॉन्फ़िगर और असेंबल करने के लिए तुरंत सीधे उपयोग की ओर बढ़ जाते हैं waf. इसलिए, जारी रखने के लिए, कृपया उस ns-3 निर्देशिका पर जाएँ जिसे आपने मूल रूप से बनाया था।

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

$ ./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 कुछ कार्यक्रमों के लिए सुइड बिट "रनटाइम पर समूह आईडी सेट करें" सेट करने के लिए। यह डिफ़ॉल्ट रूप से सक्षम नहीं है और इसलिए यह सुविधा "सक्षम नहीं" के रूप में दिखाई देती है। अंत में, सक्षम विकल्पों की सूची प्राप्त करने के लिए, उपयोग करें waf पैरामीटर के साथ --check-config.

अब वापस जाएं और उदाहरणों और परीक्षणों वाले डिबग बिल्ड पर वापस जाएं।

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

बिल्ड सिस्टम अब सेट हो गया है और आप बस टाइप करके एनएस-3 प्रोग्राम के डिबग संस्करण बना सकते हैं:

$ ./waf

उपरोक्त चरणों ने आपको दो बार एनएस-3 सिस्टम का हिस्सा बनाने के लिए मजबूर किया होगा, लेकिन अब आप जानते हैं कि कॉन्फ़िगरेशन कैसे बदलें और अनुकूलित कोड कैसे बनाएं।

यह जांचने के लिए कि किसी दिए गए प्रोजेक्ट कॉन्फ़िगरेशन के लिए कौन सी प्रोफ़ाइल सक्रिय है, एक कमांड है:

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

उपरोक्त परिदृश्य बिल्ड.py तर्कों का भी समर्थन करता है --enable-examples и --enable-tests, लेकिन अन्य विकल्प waf यह सीधे समर्थन नहीं करता. उदाहरण के लिए, यह काम नहीं करेगा:

$ ./build.py --disable-python

प्रतिक्रिया इस प्रकार होगी:

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

हालाँकि, विशेष ऑपरेटर - - का उपयोग अतिरिक्त मापदंडों को पारित करने के लिए किया जा सकता है WAFइसलिए उपरोक्त के बजाय निम्न आदेश काम करेगा:

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

क्योंकि यह मुख्य कमांड उत्पन्न करता है ./waf कॉन्फ़िगर --अक्षम-पायथन. यहां इसके बारे में कुछ और परिचयात्मक सुझाव दिए गए हैं waf.

निर्माण त्रुटियों को संभालना

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

उदाहरण के लिए, पहले Fedora 3.28 के लिए ns‑28 की रिलीज़ हुई थी, जिसमें एक नया प्रमुख संस्करण शामिल था जीसीसी (जीसीसी-8). Gtk3.28+ स्थापित होने पर Fedora 28 के अंतर्गत रिलीज़ ns-2 या पुराने संस्करणों का निर्माण करते समय, निम्न त्रुटि उत्पन्न होगी:

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

एनएस‑3.28.1 से प्रारंभ होने वाली रिलीज़ों में waf इन समस्याओं के समाधान के लिए एक विकल्प उपलब्ध है। यह g++ और clang++ में "-Werror" ध्वज सेट करना अक्षम कर देता है। यह "--disable-werror" विकल्प है और इसे कॉन्फ़िगरेशन के दौरान लागू किया जाना चाहिए:

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

कॉन्फ़िगर करें या इकट्ठा करें

कुछ आदेश waf केवल कॉन्फ़िगरेशन चरण में ही समझ में आता है, और कुछ केवल निर्माण चरण में ही मान्य होते हैं। उदाहरण के लिए, यदि आप ns-3 इम्यूलेशन सुविधाओं का उपयोग करना चाहते हैं, तो आप बिट सेटिंग सक्षम कर सकते हैं SUID का उपयोग करते हुए 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++ कंपाइलर का उपयोग करता है ( जी ++). हालाँकि, आप जिसे उपयोग करते हैं उसे बदल सकते हैं waf C++ कंपाइलर, CXX पर्यावरण चर को परिभाषित करके। उदाहरण के लिए, C++ कंपाइलर Clang, clang++ का उपयोग करने के लिए,

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

इसी तरह आप कॉन्फिगर कर सकते हैं waf वितरित संकलन का उपयोग करने के लिए व्याकुल करना:

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

Distcc और वितरित संकलन के बारे में अधिक जानकारी दस्तावेज़ीकरण अनुभाग में प्रोजेक्ट पृष्ठ पर पाई जा सकती है। ns-3 को कॉन्फ़िगर करते समय कंपाइलर फ़्लैग जोड़ने के लिए, CXXFLAGS_EXTRA पर्यावरण चर का उपयोग करें।

स्थापना

waf सिस्टम पर विभिन्न स्थानों पर लाइब्रेरी स्थापित करने के लिए इसका उपयोग किया जा सकता है। डिफ़ॉल्ट रूप से, संकलित लाइब्रेरी और निष्पादन योग्य निर्देशिका में स्थित होते हैं निर्माण, और चूँकि Waf इन पुस्तकालयों और निष्पादनयोग्यों का स्थान जानता है, इसलिए पुस्तकालयों को कहीं और स्थापित करने की कोई आवश्यकता नहीं है।

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

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

यदि बाद में, निर्माण के बाद, उपयोगकर्ता इंस्टॉलेशन कमांड दर्ज करता है ./waf, उपसर्ग का उपयोग किया जाएगा /ऑप्ट/स्थानीय.

टीम ./waf clean यदि इंस्टॉलेशन का उपयोग किया जाएगा तो प्रोजेक्ट को पुन: कॉन्फ़िगर करने से पहले इसका उपयोग किया जाना चाहिए waf एक अलग उपसर्ग के तहत.

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

वफ़ सिंगल

एनएस-3 स्रोत वृक्ष के शीर्ष स्तर पर, केवल एक वफ़ स्क्रिप्ट है। एक बार जब आप काम करना शुरू कर देंगे, तो आप निर्देशिका में बहुत समय बिताएंगे scratch/ या गहराई मेंsrc/... और साथ ही भागना भी पड़ता है waf. आप बस यह याद रख सकते हैं कि आप कहां हैं और दौड़ सकते हैं waf निम्नानुसार है:

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

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

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

$ cd scratch 
$ waff build

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

3.5 परीक्षण एनएस-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)

यह कमांड आमतौर पर उपयोगकर्ताओं द्वारा यह सत्यापित करने के लिए चलाया जाता है कि एनएस-3 वितरण सही ढंग से बनाया गया है। (ध्यान दें कि "पास: ..." पंक्तियों का क्रम भिन्न हो सकता है, यह सामान्य है। महत्वपूर्ण बात यह है कि रिपोर्ट के अंत में सारांश पंक्ति दर्शाती है कि सभी परीक्षण उत्तीर्ण हुए; कोई भी परीक्षण विफल या क्रैश नहीं हुआ।) और wafऔर test.py मशीन के उपलब्ध प्रोसेसर कोर में काम को समानांतर बना देगा।

3.6 स्क्रिप्ट चलाना

हम आमतौर पर स्क्रिप्ट को नियंत्रण में चलाते हैं waf. यह बिल्ड सिस्टम को यह सुनिश्चित करने की अनुमति देता है कि साझा लाइब्रेरी पथ सही ढंग से सेट हैं और लाइब्रेरी रनटाइम पर उपलब्ध हैं। प्रोग्राम को चलाने के लिए, बस उपयोग करें waf पैरामीटर के साथ - -run. आइए सर्वव्यापी प्रोग्राम के समतुल्य ns-3 चलाएँ हैलो दुनियानिम्नलिखित टाइप करके:

$ ./waf --run hello-simulator

वफ़ पहले जाँच करेगा कि प्रोग्राम सही ढंग से बनाया गया है और यदि आवश्यक हो तो निर्माण करेगा। तब waf एक प्रोग्राम निष्पादित करेगा जो निम्नलिखित आउटपुट उत्पन्न करेगा।

Hello Simulator

बधाई हो! अब आप एनएस-3 उपयोगकर्ता हैं!

यदि मुझे परिणाम न दिखें तो मुझे क्या करना चाहिए?

यदि आप संदेश देखते हैं wafयह दर्शाता है कि निर्माण सफलतापूर्वक पूरा हुआ, लेकिन आपको आउटपुट नहीं दिख रहा है "हैलो सिम्युलेटर", तो ऐसी संभावना है कि आपने [बिल्ड-विथ-वाफ़] अनुभाग में अपना बिल्ड मोड स्विच कर दिया है अनुकूलित, लेकिन मोड पर वापस स्विच करने से चूक गया डिबग. इस ट्यूटोरियल में उपयोग किए गए सभी कंसोल आउटपुट एक विशेष एनएस -3 घटक का उपयोग करते हैं जो लॉगिंग करता है और कंसोल पर कस्टम संदेशों को प्रिंट करने के लिए उपयोग किया जाता है। अनुकूलित कोड संकलित होने पर इस घटक से आउटपुट स्वचालित रूप से अक्षम हो जाता है - यह "अनुकूलित" होता है। यदि आपको "हैलो सिम्युलेटर" आउटपुट नहीं दिखता है, तो निम्नलिखित दर्ज करें:

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

कॉन्फिगर करना waf एनएस-3 प्रोग्राम के डिबग संस्करण बनाने के लिए, जिसमें उदाहरण और परीक्षण शामिल हैं। फिर आपको टाइप करके कोड के वर्तमान डिबग संस्करण को फिर से बनाना चाहिए

$ ./waf

अब यदि आप प्रोग्राम चलाते हैं हैलो-सिम्युलेटर, आपको अपेक्षित परिणाम देखना चाहिए।

3.6.1 कमांड लाइन तर्क

एनएस-3 प्रोग्राम में कमांड लाइन तर्क पारित करने के लिए, निम्नलिखित पैटर्न का उपयोग करें:

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

प्रतिस्थापित करें आपके प्रोग्राम के नाम और तर्कों के लिए। तर्क - -command-template के लिए waf यह मूलतः वास्तविक कमांड लाइन बनाने का एक नुस्खा है waf प्रोग्राम को निष्पादित करने के लिए उपयोग किया जाता है। Waf जाँच करता है कि बिल्ड पूरा हो गया है, साझा लाइब्रेरी पथ सेट करता है, फिर दिए गए कमांड लाइन टेम्पलेट का उपयोग करता है और निष्पादन योग्य को कॉल करने के लिए %s प्लेसहोल्डर के लिए प्रोग्राम नाम प्रतिस्थापित करता है। यदि आपको यह वाक्यविन्यास जटिल लगता है, तो एक सरल संस्करण है जिसमें एनएस-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 डिबगिंग

किसी अन्य उपयोगिता, जैसे डिबगर (उदाहरण के लिए,) के तहत एनएस-3 प्रोग्राम चलाने के लिए जी.डी.बी.) या एक मेमोरी परीक्षण उपकरण (उदाहरण के लिए, वालग्रिंड), एक समान फॉर्म का उपयोग करें - -command-template = "…". उदाहरण के लिए, डिबगर में चलाने के लिए जी.डी.बी. आपका हैलो-सिम्युलेटर एनएस-3 प्रोग्राम तर्कों के साथ:

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

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

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

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

वफ़ को एनएस-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