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

धडा 1,2
धडा 3
धडा 4

5 सेटिंग्ज
5.1 लॉगिंग मॉड्यूल वापरणे
5.1.1 लॉगिंग विहंगावलोकन
5.1.2 लॉगिंग सक्षम करा
5.1.3 तुमच्या कोडमध्ये लॉगिंग जोडणे
5.2 कमांड लाइन वितर्क वापरणे
5.2.1 डीफॉल्ट विशेषता मूल्ये ओव्हरराइड करणे
5.2.2 तुमच्या स्वतःच्या आज्ञा कॅप्चर करणे
5.3 ट्रेसिंग सिस्टम वापरणे
5.3.1 ASCII ट्रेसिंग
ASCII ट्रेस पार्स करत आहे
5.3.2 PCAP ट्रेस

धडा 5

समायोजन

5.1 लॉगिंग मॉड्यूल वापरणे

आम्ही आधीच स्क्रिप्ट पाहून ns-3 लॉगिंग मॉड्यूल थोडक्यात पाहिले आहे प्रथम.सीसी. या प्रकरणात, आम्ही लॉगिंग उपप्रणालीच्या संभाव्य उपयोगांवर बारकाईने विचार करू.

5.1.1 लॉगिंग विहंगावलोकन

बऱ्याच मोठ्या प्रणाली काही प्रकारच्या संदेश लॉगिंग सुविधेला समर्थन देतात आणि ns-3 अपवाद नाही. काही प्रकरणांमध्ये, "ऑपरेटर कन्सोल" वर फक्त त्रुटी संदेश लिहिले जातात (जे सहसा युनिक्स-आधारित सिस्टमवर stderr असते). इतर प्रणालींवर, चेतावणी संदेश तसेच अधिक तपशीलवार माहिती प्रदर्शित केली जाऊ शकते. काही प्रकरणांमध्ये, लॉगिंग साधने डीबग संदेश आउटपुट करण्यासाठी वापरली जातात जी आउटपुट द्रुतपणे अस्पष्ट करू शकतात.

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

तुम्हाला हे समजले पाहिजे की आम्ही तुमच्या मॉडेल्समधून डेटा काढण्यासाठी एक सामान्य उद्देश यंत्रणा - ट्रेसिंग - प्रदान करतो, जे सिम्युलेशनसाठी पसंतीचे आउटपुट असावे (आमच्या ट्रेसिंग सिस्टमवरील अधिक माहितीसाठी, ट्यूटोरियल विभाग 5.3 पहा). डीबगिंग माहिती, इशारे, त्रुटी संदेश, किंवा कोणत्याही वेळी आपल्या स्क्रिप्ट किंवा मॉडेल्समधून संदेश द्रुतपणे आउटपुट करण्यासाठी लॉगिंग ही प्राधान्यीकृत पद्धत असावी.

सध्या, प्रणाली माहिती सामग्रीच्या वाढत्या क्रमाने लॉग संदेशांचे सात स्तर (प्रकार) परिभाषित करते.

• LOG_ERROR - लॉगिंग त्रुटी संदेश (संबंधित मॅक्रो: NS_LOG_ERROR);
• LOG_WARN - लॉग चेतावणी संदेश (संबंधित मॅक्रो: NS_LOG_WARN);
• LOG_DEBUG - तुलनेने दुर्मिळ विशेष डीबग संदेश लॉग करा (संबंधित मॅक्रो: NS_LOG_DEBUG);
• LOG_INFO - प्रोग्रामच्या प्रगतीबद्दल माहिती संदेशांची नोंदणी (संबंधित मॅक्रो: NS_LOG_INFO);
• LOG_FUNCTION - कॉल केलेल्या प्रत्येक फंक्शनचे वर्णन करणारे लॉग संदेश (दोन संबंधित मॅक्रो: NS_LOG_FUNCTION, सदस्य फंक्शन्ससाठी वापरलेले, आणि NS_LOG_FUNCTION_NOARGS, स्टॅटिक फंक्शन्ससाठी वापरलेले);
• LOG_LOGIC - फंक्शनमधील तार्किक प्रवाहाचे वर्णन करणारे संदेश लॉगिंग करणे (संबंधित मॅक्रो: NS_LOG_LOGIC);
• LOG_ALL - वर नमूद केलेल्या सर्व गोष्टी लॉग करा (संबंधित मॅक्रो नाही).
  प्रत्येक प्रकारासाठी (LOG_TYPE) एक LOG_LEVEL_TYPE देखील आहे जो वापरल्यास, त्याच्या स्वतःच्या स्तराव्यतिरिक्त वरील सर्व स्तरांना लॉग करण्याची परवानगी देतो. (परिणामस्वरूप, LOG_ERROR आणि LOG_LEVEL_ERROR, आणि LOG_ALL आणि LOG_LEVEL_ALL कार्यक्षमतेने समतुल्य आहेत.) उदाहरणार्थ, LOG_INFO सक्षम केल्याने केवळ NS_LOG_INFO मॅक्रोद्वारे प्रदान केलेल्या संदेशांना अनुमती मिळेल, तर LOG_LEVEL द्वारे प्रदान केलेल्या LOG_LEVEL_संदेशांना देखील सक्षम केले जाईल _LOG_WARN आणि NS_LOG_ERROR.

आम्ही एक बिनशर्त लॉगिंग मॅक्रो देखील प्रदान करतो जो नेहमी प्रदर्शित केला जातो, लॉगिंग पातळी किंवा निवड घटकाकडे दुर्लक्ष करून.

• NS_LOG_UNCOND - संबंधित संदेशाचे बिनशर्त लॉगिंग (संबंधित लॉगिंग स्तर नाही).

प्रत्येक स्तर स्वतंत्रपणे किंवा एकत्रितपणे विचारला जाऊ शकतो. लॉगिंग sh पर्यावरण व्हेरिएबल NS_LOG वापरून किंवा सिस्टम फंक्शन कॉल लॉग करून कॉन्फिगर केले जाऊ शकते. आधी दाखवल्याप्रमाणे, लॉगिंग सिस्टीममध्ये डॉक्सिजन दस्तऐवजीकरण आहे आणि जर तुमच्याकडे आधीपासून नसेल तर त्याचे पुनरावलोकन करण्याची ही चांगली वेळ आहे.

आता तुम्ही दस्तऐवजीकरण खूप तपशीलवार वाचले आहे, चला त्या ज्ञानाचा उपयोग उदाहरण स्क्रिप्टमधून काही मनोरंजक माहिती मिळविण्यासाठी करूया. scratch/myfirst.ccजे तुम्ही आधीच संकलित केले आहे.

5.1.2 लॉगिंग सक्षम करा

आणखी काही लॉग रन करण्यासाठी NS_LOG एन्व्हायर्नमेंट व्हेरिएबल वापरू, पण प्रथम, फक्त तुमचे बेअरिंग मिळवण्यासाठी, तुम्ही आधी केल्याप्रमाणे शेवटची स्क्रिप्ट चालवा,

$ ./waf --run scratch/myfirst

तुम्हाला पहिल्या ns-3 उदाहरण प्रोग्राममधून परिचित आउटपुट दिसले पाहिजे

$ Waf: Entering directory `/home/craigdo/repos/ns-3-allinone/ns-3-dev/build'
Waf: Leaving directory `/home/craigdo/repos/ns-3-allinone/ns-3-dev/build' 'build'
finished successfully (0.413s)
Sent 1024 bytes to 10.1.1.2
Received 1024 bytes from 10.1.1.1
Received 1024 bytes from 10.1.1.2

असे दिसून आले की आपण वर पाहिलेले "पाठवलेले" आणि "मिळलेले" संदेश प्रत्यक्षात कडून लॉग केलेले संदेश आहेत UdpEchoClientApplication и UdpEchoServerApplication. उदाहरणार्थ, आम्ही क्लायंट ऍप्लिकेशनला NS_LOG पर्यावरण व्हेरिएबलद्वारे लॉगिंग स्तर सेट करून अतिरिक्त माहिती मुद्रित करण्यास सांगू शकतो.

आतापासून, मी असे गृहीत धरणार आहे की तुम्ही sh-सारखे शेल वापरत आहात जे "variable=value" वाक्यरचना वापरते. जर तुम्ही csh-सारखे शेल वापरत असाल, तर तुम्हाला माझी उदाहरणे त्या शेल्ससाठी आवश्यक असलेल्या "सेटेनव्ह व्हेरिएबल व्हॅल्यू" सिंटॅक्समध्ये रूपांतरित करावी लागतील.

सध्या, UDP इको क्लायंट ऍप्लिकेशन खालील कोडच्या ओळीला प्रतिसाद देतो scratch/myfirst.cc,

LogComponentEnable("UdpEchoClientApplication", LOG_LEVEL_INFO);

हे लॉगिंग स्तर LOG_LEVEL_INFO सक्षम करते. जेव्हा आम्ही लॉगिंग स्तर ध्वज पास करतो, तेव्हा आम्ही प्रत्यक्षात ते स्तर आणि सर्व खालच्या स्तरांना सक्षम करतो. या प्रकरणात, आम्ही NS_LOG_INFO, NS_LOG_DEBUG, NS_LOG_WARN आणि NS_LOG_ERROR सक्षम केले आहेत. आम्ही खालीलप्रमाणे NS_LOG पर्यावरण व्हेरिएबल सेट करून, स्क्रिप्ट बदल आणि पुनर्संकलन न करता लॉगिंग पातळी वाढवू शकतो आणि अधिक माहिती मिळवू शकतो:

$ export NS_LOG=UdpEchoClientApplication=level_all

म्हणून आम्ही sh shell व्हेरिएबल NS_LOG खालील मूल्यावर सेट करतो,

UdpEchoClientApplication=level_all

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

Waf: Entering directory `/home/craigdo/repos/ns-3-allinone/ns-3-dev/build'
Waf: Leaving directory `/home/craigdo/repos/ns-3-allinone/ns-3-dev/build'
'build' finished successfully (0.404s)
UdpEchoClientApplication:UdpEchoClient()
UdpEchoClientApplication:SetDataSize(1024)
UdpEchoClientApplication:StartApplication()
UdpEchoClientApplication:ScheduleTransmit()
UdpEchoClientApplication:Send()
Sent 1024 bytes to 10.1.1.2
Received 1024 bytes from 10.1.1.1
UdpEchoClientApplication:HandleRead(0x6241e0, 0x624a20)
Received 1024 bytes from 10.1.1.2
UdpEchoClientApplication:StopApplication()
UdpEchoClientApplication:DoDispose()
UdpEchoClientApplication:~UdpEchoClient()

अनुप्रयोगाद्वारे प्रदान केलेली अतिरिक्त डीबगिंग माहिती आता NS_LOG_FUNCTION स्तरावर आहे. हे स्क्रिप्टच्या अंमलबजावणीदरम्यान फंक्शन कॉलचे प्रत्येक उदाहरण दर्शविते. सामान्य नियम म्हणून, पद्धती फंक्शन्समध्ये ते वापरणे श्रेयस्कर आहे (किमान)NS_LOG_FUNCTION (this)... वापरा NS_LOG_FUNCTION_NOARGS ()
फक्त स्थिर फंक्शन्समध्ये. तथापि, लक्षात घ्या की कोणत्याही लॉगिंग कार्यक्षमतेस समर्थन देण्यासाठी ns-3 प्रणाली आवश्यक नाही. किती माहिती रेकॉर्ड करायची याचा निर्णय वैयक्तिक मॉडेल डेव्हलपरवर सोडला जातो. इको ऍप्लिकेशन्सच्या बाबतीत, मोठ्या प्रमाणात लॉगिंग आउटपुट उपलब्ध आहे.

तुम्ही आता अनुप्रयोगाद्वारे केलेल्या फंक्शन कॉलचा लॉग पाहू शकता. तुम्ही बारकाईने पाहिल्यास, तुम्हाला रेषेदरम्यान एक कोलन दिसेल UdpEchoClientApplication आणि पद्धतीचे नाव, जिथे तुम्ही C++ स्कोप ऑपरेटर (: :) पाहण्याची अपेक्षा करू शकता. हे हेतुपुरस्सर आहे.

हे प्रत्यक्षात वर्गाचे नाव नाही तर लॉगिंग घटकाचे नाव आहे. जेव्हा स्त्रोत फाइल आणि वर्ग यांच्यात जुळते तेव्हा ते सहसा वर्गाचे नाव असते, परंतु तुम्हाला हे समजले पाहिजे की ते प्रत्यक्षात वर्गाचे नाव नाही आणि दुहेरी कोलनऐवजी एकच कोलन आहे. लॉगिंग बीनचे नाव क्लासच्या नावापासून तुलनेने सूक्ष्म पद्धतीने वेगळे करण्यात तुम्हाला मदत करण्याचा हा एक मार्ग आहे.

तथापि, काही प्रकरणांमध्ये लॉग संदेश प्रत्यक्षात कोणती पद्धत निर्माण करत आहे हे निर्धारित करणे कठीण होऊ शकते. जर तुम्ही वरील मजकूर पाहिला तर तुम्हाला प्रश्न पडला असेल की ही ओळ कुठे आहेReceived 1024 bytes from 10.1.1.2" आपण पातळी सेट करून ही समस्या सोडवू शकता prefix_func NS_LOG पर्यावरण व्हेरिएबलमध्ये. पुढील गोष्टी करून पहा:

$ export 'NS_LOG=UdpEchoClientApplication=level_all|prefix_func'

लक्षात घ्या की अवतरण चिन्ह आवश्यक आहेत कारण आम्ही OR ऑपरेशनचे प्रतिनिधित्व करण्यासाठी वापरत असलेली अनुलंब पट्टी देखील एक युनिक्स पाईप कनेक्टर आहे. आता तुम्ही स्क्रिप्ट चालवल्यास, तुम्हाला दिसेल की लॉगिंग सिस्टम हे सुनिश्चित करते की दिलेल्या लॉगमधील प्रत्येक संदेश घटकाच्या नावासह प्रीफिक्स केलेला आहे.

Waf: Entering directory `/home/craigdo/repos/ns-3-allinone/ns-3-dev/build'
Waf: Leaving directory `/home/craigdo/repos/ns-3-allinone/ns-3-dev/build'
'build' finished successfully (0.417s)
UdpEchoClientApplication:UdpEchoClient()
UdpEchoClientApplication:SetDataSize(1024)
UdpEchoClientApplication:StartApplication()
UdpEchoClientApplication:ScheduleTransmit()
UdpEchoClientApplication:Send()
UdpEchoClientApplication:Send(): Sent 1024 bytes to 10.1.1.2
Received 1024 bytes from 10.1.1.1
UdpEchoClientApplication:HandleRead(0x6241e0, 0x624a20)
UdpEchoClientApplication:HandleRead(): Received 1024 bytes from 10.1.1.2
UdpEchoClientApplication:StopApplication()
UdpEchoClientApplication:DoDispose()
UdpEchoClientApplication:~UdpEchoClient()

आता तुम्ही पाहू शकता की UDP इको क्लायंट ऍप्लिकेशन मधून येणारे सर्व संदेश जसे ओळखले जातात. संदेश "Received 1024 bytes from 10.1.1.2" आता स्पष्टपणे इको क्लायंट ऍप्लिकेशनमधून येत असल्याचे ओळखले जाते. उर्वरित संदेश UDP इको सर्व्हर ऍप्लिकेशनकडून येणे आवश्यक आहे. NS_LOG पर्यावरण व्हेरिएबलमधील घटकांची कोलन-विभक्त सूची प्रविष्ट करून आम्ही हा घटक सक्षम करू शकतो.

$ export 'NS_LOG=UdpEchoClientApplication=level_all|prefix_func:
               UdpEchoServerApplication=level_all|prefix_func'

चेतावणी: वरील उदाहरणातील मजकुरात, तुम्हाला कोलन (:) नंतरचे नवीन अक्षर काढावे लागेल, ते दस्तऐवजाचे स्वरूपन करण्यासाठी वापरले जाते. आता तुम्ही स्क्रिप्ट चालवल्यास, तुम्हाला क्लायंट आणि सर्व्हर इको ॲप्लिकेशन्सचे सर्व लॉग संदेश दिसतील. आपण पाहू शकता की डीबग करताना हे खूप उपयुक्त असू शकते.

Waf: Entering directory `/home/craigdo/repos/ns-3-allinone/ns-3-dev/build'
Waf: Leaving directory `/home/craigdo/repos/ns-3-allinone/ns-3-dev/build'
'build' finished successfully (0.406s)
UdpEchoServerApplication:UdpEchoServer()
UdpEchoClientApplication:UdpEchoClient()
UdpEchoClientApplication:SetDataSize(1024)
UdpEchoServerApplication:StartApplication()
UdpEchoClientApplication:StartApplication()
UdpEchoClientApplication:ScheduleTransmit()
UdpEchoClientApplication:Send()
UdpEchoClientApplication:Send(): Sent 1024 bytes to 10.1.1.2
UdpEchoServerApplication:HandleRead(): Received 1024 bytes from 10.1.1.1
UdpEchoServerApplication:HandleRead(): Echoing packet
UdpEchoClientApplication:HandleRead(0x624920, 0x625160)
UdpEchoClientApplication:HandleRead(): Received 1024 bytes from 10.1.1.2
UdpEchoServerApplication:StopApplication()
UdpEchoClientApplication:StopApplication()
UdpEchoClientApplication:DoDispose()
UdpEchoServerApplication:DoDispose()
UdpEchoClientApplication:~UdpEchoClient()
UdpEchoServerApplication:~UdpEchoServer()

लॉग मेसेज व्युत्पन्न झालेला सिम्युलेशन वेळ पाहण्यास सक्षम असणे देखील कधीकधी उपयुक्त असते. तुम्ही OR बिट जोडून हे करू शकता prefix_time:

$ export 'NS_LOG=UdpEchoClientApplication=level_all|prefix_func|prefix_time: UdpEchoServerApplication=level_all|prefix_func|prefix_time'

पुन्हा, तुम्हाला वरील नवीन वर्ण काढावा लागेल. तुम्ही आता स्क्रिप्ट चालवल्यास तुम्हाला खालील आउटपुट दिसेल:

Waf: Entering directory `/home/craigdo/repos/ns-3-allinone/ns-3-dev/build'
Waf: Leaving directory `/home/craigdo/repos/ns-3-allinone/ns-3-dev/build'
'build' finished successfully (0.418s)
0s UdpEchoServerApplication:UdpEchoServer()
0s UdpEchoClientApplication:UdpEchoClient()
0s UdpEchoClientApplication:SetDataSize(1024)
1s UdpEchoServerApplication:StartApplication()
2s UdpEchoClientApplication:StartApplication()
2s UdpEchoClientApplication:ScheduleTransmit()
2s UdpEchoClientApplication:Send()
2s UdpEchoClientApplication:Send(): Sent 1024 bytes to 10.1.1.2
2.00369s UdpEchoServerApplication:HandleRead(): Received 1024 bytes from 10.1.1.1
2.00369s UdpEchoServerApplication:HandleRead(): Echoing packet
2.00737s UdpEchoClientApplication:HandleRead(0x624290, 0x624ad0)
2.00737s UdpEchoClientApplication:HandleRead(): Received 1024 bytes from 10.1.1.2
10s UdpEchoServerApplication:StopApplication()
10s UdpEchoClientApplication:StopApplication()
UdpEchoClientApplication:DoDispose()
UdpEchoServerApplication:DoDispose()
UdpEchoClientApplication:~UdpEchoClient()
UdpEchoServerApplication:~UdpEchoServer()

कृपया लक्षात घ्या की कन्स्ट्रक्टर साठी UdpEchoServer सिम्युलेशन 0 सेकंद दरम्यान कॉल केला गेला. सिम्युलेशन सुरू होण्यापूर्वी हे प्रत्यक्षात घडते, परंतु वेळ शून्य सेकंद म्हणून दर्शविला जातो. कन्स्ट्रक्टर संदेशासाठी हेच खरे आहे UdpEchoClient.

Waf: Entering directory `/home/craigdo/repos/ns-3-allinone/ns-3-dev/build'
Waf: Leaving directory `/home/craigdo/repos/ns-3-allinone/ns-3-dev/build'
'build' finished successfully (0.418s)
0s UdpEchoServerApplication:UdpEchoServer()
0s UdpEchoClientApplication:UdpEchoClient()
0s UdpEchoClientApplication:SetDataSize(1024)
1s UdpEchoServerApplication:StartApplication()
2s UdpEchoClientApplication:StartApplication()
2s UdpEchoClientApplication:ScheduleTransmit()
2s UdpEchoClientApplication:Send()
2s UdpEchoClientApplication:Send(): Sent 1024 bytes to 10.1.1.2
2.00369s UdpEchoServerApplication:HandleRead(): Received 1024 bytes from 10.1.1.1
2.00369s UdpEchoServerApplication:HandleRead(): Echoing packet
2.00737s UdpEchoClientApplication:HandleRead(0x624290, 0x624ad0)
2.00737s UdpEchoClientApplication:HandleRead(): Received 1024 bytes from 10.1.1.2
10s UdpEchoServerApplication:StopApplication()
10s UdpEchoClientApplication:StopApplication()
UdpEchoClientApplication:DoDispose()
UdpEchoServerApplication:DoDispose()
UdpEchoClientApplication:~UdpEchoClient()
UdpEchoServerApplication:~UdpEchoServer()

स्क्रिप्ट आठवते scratch/first.cc सिम्युलेशन सुरू होण्याच्या एक सेकंद आधी इको सर्व्हर ऍप्लिकेशन सुरू केले. आता तुम्ही ती पद्धत पाहू शकता स्टार्ट ऍप्लिकेशन सर्व्हरला प्रत्यक्षात पहिल्या सेकंदात कॉल केला जातो. आपण स्क्रिप्टमध्ये विचारल्याप्रमाणे, इको क्लायंट सिम्युलेशनच्या दुसऱ्या सेकंदात सुरू होते हे देखील लक्षात येईल.

तुम्ही आता कॉलवर सिम्युलेशन प्रगती फॉलो करू शकता शेड्यूल ट्रान्समिट हँडलरीड कॉलबॅक कॉल करणाऱ्या क्लायंटमध्ये इको सर्व्हर ऍप्लिकेशनमध्ये पाठवा. लक्षात घ्या की पॉइंट-टू-पॉइंट लिंकवर पॅकेट पाठवण्यासाठी गेलेली वेळ 3,69 मिलीसेकंद आहे. तुम्ही पाहू शकता की इको सर्व्हरने पॅकेटला प्रतिसाद दिलेला संदेश लॉग केला आहे, आणि नंतर, चॅनेलच्या विलंबानंतर, तुम्हाला दिसेल की इको क्लायंटला त्याच्या हँडलरीड पद्धतीने इको पॅकेट मिळते.

या सिम्युलेशनमध्ये, आपण लक्षात न घेता बरेच काही घडते. परंतु आपण सिस्टममधील सर्व लॉगिंग घटक सक्षम करून संपूर्ण प्रक्रियेचा अगदी सहजपणे मागोवा घेऊ शकता. NS_LOG व्हेरिएबल खालील मूल्यावर सेट करण्याचा प्रयत्न करा,

$ export 'NS_LOG=*=level_all|prefix_func|prefix_time'

वरील तारांकन लॉगिंग घटकासाठी वाइल्डकार्ड वर्ण आहे. यामध्ये सिम्युलेशनमध्ये वापरलेल्या सर्व घटकांमधील सर्व नोंदी समाविष्ट असतील. मी येथे आउटपुट पुनरुत्पादित करणार नाही (लिहिण्याच्या वेळी ते एका इको पॅकेटसाठी आउटपुटच्या 1265 ओळी तयार करते), परंतु तुम्ही ही माहिती फाइलवर पुनर्निर्देशित करू शकता आणि तुमच्या आवडत्या संपादकामध्ये पाहू शकता.

$ ./waf --run scratch/myfirst > log.out 2>&1

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

5.1.3 तुमच्या कोडमध्ये लॉगिंग जोडणे

एकाधिक मॅक्रोवरून लॉग घटकावर कॉल करून तुम्ही तुमच्या सिम्युलेशनमध्ये नवीन नोंदी जोडू शकता. चला ते एका स्क्रिप्टमध्ये करूया myfirst.cc, जी आमच्याकडे "स्वच्छ" निर्देशिकेत आहे. लक्षात ठेवा की आम्ही या परिस्थितीमध्ये लॉगिंग घटक परिभाषित केला आहे:

NS_LOG_COMPONENT_DEFINE ("FirstScriptExample");

तुम्हाला माहिती आहे की तुम्ही वेगवेगळ्या स्तरांवर NS_LOG पर्यावरण व्हेरिएबल सेट करून या घटकातील सर्व संदेशांचे लॉगिंग सक्षम करू शकता. चला पुढे जाऊ आणि स्क्रिप्टमध्ये काही नोंदी जोडू. लॉगमध्ये माहिती स्तर संदेश जोडण्यासाठी वापरलेला मॅक्रो NS_LOG_INFO आहे. चला एक संदेश जोडूया (आम्ही नोड्स तयार करणे सुरू करण्यापूर्वी) जो तुम्हाला सांगेल की स्क्रिप्ट "टोपोलॉजी तयार करणे" टप्प्यात आहे. हे खालील कोड स्निपेटमध्ये केले आहे,
उघडा scratch/myfirst.cc तुमच्या आवडत्या संपादकात आणि ओळ जोडा,
NS_LOG_INFO ("Creating Topology");
ओळींच्या अगदी आधी,

NodeContainer nodes;
nodes.Create (2);

आता वापरून स्क्रिप्ट संकलित करा वाफ, आणि आम्ही पूर्वी सक्षम केलेला लॉगिंग प्रवाह अक्षम करण्यासाठी NS_LOG व्हेरिएबल साफ करा:

$ ./waf
$ export NS_LOG=
Теперь, если вы запустите скрипт,
$ ./waf --run scratch/myfirst

तुम्हाला नवीन संदेश दिसणार नाही कारण संबंधित लॉगिंग घटक (FirstScriptExample) सक्षम केलेला नाही. तुमचा संदेश पाहण्यासाठी तुम्हाला लॉगिंग घटक सक्षम करणे आवश्यक आहे फर्स्टस्क्रिप्ट उदाहरण NS_LOG_INFO पेक्षा कमी नसलेल्या पातळीसह. जर तुम्हाला ही विशिष्ट लॉगिंग पातळी पहायची असेल, तर तुम्ही ते याप्रमाणे सक्षम करू शकता,

$ export NS_LOG=FirstScriptExample=info

तुम्ही आत्ता स्क्रिप्ट चालवल्यास, तुम्हाला “Creating Topology” असा नवीन संदेश दिसेल,

Waf: Entering directory `/home/craigdo/repos/ns-3-allinone/ns-3-dev/build'
Waf: Leaving directory `/home/craigdo/repos/ns-3-allinone/ns-3-dev/build'
'build' finished successfully (0.404s)
Creating Topology
Sent 1024 bytes to 10.1.1.2
Received 1024 bytes from 10.1.1.1
Received 1024 bytes from 10.1.1.2

5.2 कमांड लाइन वितर्क वापरणे

5.2.1 डीफॉल्ट विशेषता मूल्ये ओव्हरराइड करणे

ns-3 स्क्रिप्ट्सचे वर्तन संपादित किंवा तयार न करता बदलण्याचा दुसरा मार्ग म्हणजे कमांड लाइन वितर्क वापरणे. आम्ही कमांड लाइन वितर्क पार्स करण्यासाठी आणि परिणामांवर आधारित स्थानिक आणि जागतिक व्हेरिएबल्स स्वयंचलितपणे सेट करण्यासाठी एक यंत्रणा प्रदान करतो.

कमांड लाइन आर्ग्युमेंट सिस्टम वापरण्याची पहिली पायरी म्हणजे कमांड लाइन पार्सर घोषित करणे. खालील कोडप्रमाणे (तुमच्या मुख्य प्रोग्राममध्ये) हे करणे अगदी सोपे आहे,

int
main (int argc, char *argv[])
{
...
CommandLine cmd;
cmd.Parse (argc, argv);
...
}

हे साधे दोन-ओळीचे स्निपेट स्वतःच खूप उपयुक्त आहे. हे ns-3 ग्लोबल व्हेरिएबल आणि विशेषता प्रणालीचे दरवाजे उघडते. मुख्य स्क्रिप्ट फंक्शनच्या सुरुवातीला कोडच्या दोन ओळी जोडू scratch/myfirst.cc. पुढे जाऊन, आम्ही स्क्रिप्ट संकलित करतो आणि ती चालवतो, लॉन्च झाल्यावर आम्ही खालीलप्रमाणे मदत विनंती करतो,

$ ./waf --run "scratch/myfirst --PrintHelp"

हा आदेश विचारेल वाफ स्क्रिप्ट चालवा स्क्रॅच/मायफर्स्ट आणि कमांड लाइन वितर्क पास करा -मुद्रित मदत. युक्तिवाद कोणत्या प्रोग्रामसाठी आहे हे सूचित करण्यासाठी अवतरण चिन्ह आवश्यक आहेत. कमांड लाइन पार्सर वितर्क शोधेल -मुद्रित मदत आणि उत्तर प्रदर्शित करेल,

Waf: Entering directory `/home/craigdo/repos/ns-3-allinone/ns-3-dev/build'
Waf: Leaving directory `/home/craigdo/repos/ns-3-allinone/ns-3-dev/build'
'build' finished successfully (0.413s)
TcpL4Protocol:TcpStateMachine()
CommandLine:HandleArgument(): Handle arg name=PrintHelp value=
--PrintHelp: Print this help message.
--PrintGroups: Print the list of groups.
--PrintTypeIds: Print all TypeIds.
--PrintGroup=[group]: Print all TypeIds of group.
--PrintAttributes=[typeid]: Print all attributes of typeid.
--PrintGlobals: Print the list of globals.

आता पर्याय पाहू -विशेषता छापणे. first.cc स्क्रिप्टचा अभ्यास करताना आम्ही ns-3 विशेषता प्रणालीचा उल्लेख आधीच केला आहे. आम्ही कोडच्या खालील ओळी पाहिल्या आहेत,

PointToPointHelper pointToPoint;
pointToPoint.SetDeviceAttribute ("DataRate", StringValue ("5Mbps"));
pointToPoint.SetChannelAttribute ("Delay", StringValue ("2ms"));

आणि ते म्हणाले डेटा दर प्रत्यक्षात एक गुणधर्म आहे PointToPointNetDevice. विशेषता पाहण्यासाठी कमांड लाइन आर्ग्युमेंट पार्सर वापरू PointToPointNetDevice. मदत यादीमध्ये आम्ही काय प्रदान केले पाहिजे ते सांगते TypeId. हे त्या वर्गाचे नाव आहे ज्यामध्ये स्वारस्यांचे गुणधर्म आहेत. आमच्या बाबतीत ते होईल ns3::PointToPointNetDevice. चला पुढे जाऊया, प्रविष्ट करूया,

$ ./waf --run "scratch/myfirst --PrintAttributes=ns3::PointToPointNetDevice"

सिस्टम या नेटवर्क उपकरण प्रकारातील सर्व गुणधर्म मुद्रित करेल. तुम्हाला दिसेल की सूचीतील गुणधर्मांपैकी हे आहेत,

--ns3::PointToPointNetDevice::DataRate=[32768bps]:
The default data rate for point to point links

हे डीफॉल्ट मूल्य आहे जे ऑब्जेक्ट तयार करताना सिस्टमद्वारे वापरले जाईल PointToPointNetDevice. आम्ही पॅरामीटर वापरून हे डीफॉल्ट मूल्य ओव्हरराइड करू विशेषता в PointToPointHelper उच्च. पॉइंट-टू-पॉइंट डिव्हाइसेस आणि चॅनेलसाठी डीफॉल्ट मूल्ये वापरू. हे करण्यासाठी, आम्ही कॉल हटवू SetDeviceAttribute и SetChannelAttribute पासून myfirst.cc, जी आमच्याकडे स्वच्छ निर्देशिकेत आहे.

तुमची स्क्रिप्ट आता फक्त घोषित करावी PointToPointHelper आणि खालील उदाहरणात दाखवल्याप्रमाणे कोणतेही इंस्टॉलेशन ऑपरेशन करू नका,

...
NodeContainer nodes;
nodes.Create (2);
PointToPointHelper pointToPoint;
NetDeviceContainer devices;
devices = pointToPoint.Install (nodes);
...

पुढे जा आणि एक नवीन स्क्रिप्ट तयार करा वाफ (./waff) आणि चला परत जाऊ आणि UDP इको सर्व्हर ऍप्लिकेशनमधील काही एंट्री समाविष्ट करू आणि वेळ उपसर्ग समाविष्ट करू.

$ export 'NS_LOG=UdpEchoServerApplication=level_all|prefix_time'

तुम्ही स्क्रिप्ट चालवल्यास तुम्हाला खालील आउटपुट दिसेल:

Waf: Entering directory `/home/craigdo/repos/ns-3-allinone/ns-3-dev/build'
Waf: Leaving directory `/home/craigdo/repos/ns-3-allinone/ns-3-dev/build'
'build' finished successfully (0.405s)
0s UdpEchoServerApplication:UdpEchoServer()
1s UdpEchoServerApplication:StartApplication()
Sent 1024 bytes to 10.1.1.2
2.25732s Received 1024 bytes from 10.1.1.1
2.25732s Echoing packet
Received 1024 bytes from 10.1.1.2
10s UdpEchoServerApplication:StopApplication()
UdpEchoServerApplication:DoDispose()
UdpEchoServerApplication:~UdpEchoServer()

आठवते की आम्ही शेवटच्या वेळी सिम्युलेशन टाइम पाहिला होता, ज्या क्षणी इको सर्व्हरने पॅकेट प्राप्त केले होते, तो 2,00369 सेकंद होता.

2.00369s UdpEchoServerApplication:HandleRead(): Received 1024 bytes from 10.1.1.1

आता त्याला 2.25732 सेकंदात पॅकेट मिळते. याचे कारण असे की आम्ही PointToPointNetDevice डेटा दर पाच मेगाबिट्स प्रति सेकंद वरून डीफॉल्ट मूल्यावर रीसेट करतो, जे 32768 बिट्स प्रति सेकंद आहे. जर आम्ही कमांड लाइन वापरून नवीन डेटारेट बदलत असू, तर आम्ही आमच्या सिम्युलेशनला पुन्हा गती देऊ शकतो. हेल्प एलिमेंटद्वारे निहित सूत्रानुसार आम्ही हे खालीलप्रमाणे करू:

$ ./waf --run "scratch/myfirst --ns3::PointToPointNetDevice::DataRate=5Mbps"

हे DataRate विशेषता त्याच्या डीफॉल्ट मूल्यावर पाच मेगाबिट प्रति सेकंद परत करेल. तुम्हाला निकालाने आश्चर्य वाटते का? असे दिसून आले की स्क्रिप्टचे मूळ वर्तन परत करण्यासाठी, आम्हाला प्रकाशाच्या गतीशी जुळण्यासाठी चॅनेल विलंब सेट करणे देखील आवश्यक आहे. आम्ही कमांड लाइन सिस्टमला चॅनेल विशेषता मुद्रित करण्यास सांगू शकतो, जसे आम्ही नेटवर्क डिव्हाइससाठी केले:

$ ./waf --run "scratch/myfirst --PrintAttributes=ns3::PointToPointChannel"

आम्हाला आढळेल की चॅनेल विलंब विशेषता खालीलप्रमाणे सेट केली आहे:

--ns3::PointToPointChannel::Delay=[0ns]:
Transmission delay through the channel

त्यानंतर आपण कमांड लाइन सिस्टीमद्वारे ही दोन्ही डिफॉल्ट व्हॅल्यू सेट करू शकतो.

$ ./waf --run "scratch/myfirst
--ns3::PointToPointNetDevice::DataRate=5Mbps
--ns3::PointToPointChannel::Delay=2ms"

या प्रकरणात आम्ही स्क्रिप्टमध्ये डेटा दर आणि विलंब स्पष्टपणे सेट केल्यावर आम्हाला मिळालेला वेळ आम्ही पुनर्संचयित करतो:

Waf: Entering directory `/home/craigdo/repos/ns-3-allinone/ns-3-dev/build'
Waf: Leaving directory `/home/craigdo/repos/ns-3-allinone/ns-3-dev/build'
'build' finished successfully (0.417s)
0s UdpEchoServerApplication:UdpEchoServer()
1s UdpEchoServerApplication:StartApplication()
Sent 1024 bytes to 10.1.1.2
2.00369s Received 1024 bytes from 10.1.1.1
2.00369s Echoing packet
Received 1024 bytes from 10.1.1.2
10s UdpEchoServerApplication:StopApplication()
UdpEchoServerApplication:DoDispose()
UdpEchoServerApplication:~UdpEchoServer()

लक्षात ठेवा की 2,00369 सेकंदांनंतर पॅकेट सर्व्हरद्वारे पुन्हा प्राप्त होईल. स्क्रिप्टमध्ये वापरलेली कोणतीही विशेषता आम्ही अशा प्रकारे सेट करू शकतो. विशेषतः, आम्ही मॅक्सपॅकेट्स विशेषता एक नसलेल्या मूल्यांवर सेट करू शकतो UdpEchoClient.

तुम्ही ते कसे वापराल? एकदा प्रयत्न कर. लक्षात ठेवा की आपण ज्या ठिकाणी डीफॉल्ट विशेषता मूल्य ओव्हरराइड करतो आणि स्पष्टपणे सेट केले आहे त्या ठिकाणी टिप्पणी करणे आवश्यक आहे MaxPackets स्क्रिप्ट मध्ये. मग आपण स्क्रिप्ट पुन्हा तयार करणे आवश्यक आहे. नवीन डीफॉल्ट विशेषता मूल्य सेट करण्यासाठी वाक्यरचना मदत मिळविण्यासाठी तुम्ही कमांड लाइन देखील वापरू शकता. एकदा तुम्हाला हे समजल्यानंतर, तुम्ही कमांड लाइनवर प्रदर्शित पॅकेजेसची संख्या नियंत्रित करू शकता. आम्ही अभ्यासू लोक असल्यामुळे आमची कमांड लाइन अशी दिसली पाहिजे:

$ ./waf --run "scratch/myfirst
--ns3::PointToPointNetDevice::DataRate=5Mbps
--ns3::PointToPointChannel::Delay=2ms
--ns3::UdpEchoClient::MaxPackets=2"

या सर्व गुणांचे अस्तित्व कसे जाणून घ्यावे हा या टप्प्यावर उद्भवणारा स्वाभाविक प्रश्न आहे. पुन्हा, कमांड लाइन सिस्टममध्ये या प्रकरणासाठी मदत कार्य आहे. आम्ही मदतीसाठी कमांड लाइन विचारल्यास, आम्ही हे पाहिले पाहिजे:

$ ./waf --run "scratch/myfirst --PrintHelp"
myfirst [Program Arguments] [General Arguments]
General Arguments:
--PrintGlobals: Print the list of globals.
--PrintGroups: Print the list of groups.
--PrintGroup=[group]: Print all TypeIds of group.
--PrintTypeIds: Print all TypeIds.
--PrintAttributes=[typeid]: Print all attributes of typeid.
--PrintHelp: Print this help message.

तुम्ही "मुद्रण गट" युक्तिवाद निवडल्यास, तुम्हाला सर्व नोंदणीकृत गटांची सूची दिसेल TypeId. गटांची नावे स्त्रोत निर्देशिकेतील मॉड्यूल्सच्या नावांशी सुसंगत आहेत (कॅपिटल केलेले असले तरी). सर्व माहिती एकाच वेळी मुद्रित करणे खूप मोठे असेल, म्हणून गटानुसार माहिती मुद्रित करण्यासाठी अतिरिक्त फिल्टर उपलब्ध आहे. तर, पुन्हा पॉइंट-टू-पॉइंट मॉड्यूलवर लक्ष केंद्रित करत आहे:

./waf --run "scratch/myfirst --PrintGroup=PointToPoint"
TypeIds in group PointToPoint:
ns3::PointToPointChannel
ns3::PointToPointNetDevice
ns3::PointToPointRemoteChannel
ns3::PppHeader

येथे तुम्ही विशेषता लुकअपसाठी उपलब्ध TypeId नावे शोधू शकता, उदाहरणार्थ मध्ये
--PrintAttributes = ns3 :: PointToPointChannelवर दाखवल्याप्रमाणे.

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

5.2.2 तुमच्या स्वतःच्या आज्ञा कॅप्चर करणे

तुम्ही कमांड लाइन सिस्टमद्वारे तुमचे स्वतःचे हुक देखील जोडू शकता. कमांड लाइन पार्सर पद्धत वापरून हे अगदी सोप्या पद्धतीने केले जाते AddValue.
या वैशिष्ट्याचा वापर पूर्णपणे वेगळ्या प्रकारे प्रदर्शित करण्यासाठी पॅकेजेसची संख्या निर्दिष्ट करण्यासाठी करूया. नावाचे लोकल व्हेरिएबल जोडू nपॅकेट्स फंक्शन मध्ये मुख्य. आमच्या पूर्वीच्या डीफॉल्ट वर्तनाशी जुळण्यासाठी आम्ही ते एका वर सेट करू. कमांड लाइन पार्सरला हे मूल्य बदलण्याची परवानगी देण्यासाठी, आम्हाला हे मूल्य पार्सरमध्ये कॅप्चर करावे लागेल. आम्ही कॉल जोडून हे करतो AddValue. जा आणि स्क्रिप्ट बदला scratch/myfirst.cc तर खालील कोडसह प्रारंभ करण्यासाठी,

int
main (int argc, char *argv[])
{
uint32_t nPackets = 1;
CommandLine cmd;
cmd.AddValue("nPackets", "Number of packets to echo", nPackets);
cmd.Parse (argc, argv);
...

स्क्रिप्टमधील बिंदूपर्यंत खाली स्क्रोल करा जिथे आम्ही MaxPackets विशेषता सेट करतो आणि ते बदलू शकतो जेणेकरून ते खाली दर्शविल्याप्रमाणे स्थिर 1 ऐवजी nPackets व्हेरिएबलवर सेट केले जाईल.

echoClient.SetAttribute ("MaxPackets", UintegerValue (nPackets));

आता तुम्ही स्क्रिप्ट चालवल्यास आणि -PrintHelp वितर्क पुरवल्यास, तुम्हाला नवीन वापरकर्ता युक्तिवाद दिसला पाहिजे. मदत प्रदर्शनावर सूचीबद्ध. प्रविष्ट करा,

$ ./waf --run "scratch/myfirst --PrintHelp"
Waf: Entering directory `/home/craigdo/repos/ns-3-allinone/ns-3-dev/build'
Waf: Leaving directory `/home/craigdo/repos/ns-3-allinone/ns-3-dev/build'
'build' finished successfully (0.403s)
--PrintHelp: Print this help message.
--PrintGroups: Print the list of groups.
--PrintTypeIds: Print all TypeIds.
--PrintGroup=[group]: Print all TypeIds of group.
--PrintAttributes=[typeid]: Print all attributes of typeid.
--PrintGlobals: Print the list of globals.
User Arguments:
--nPackets: Number of packets to echo

जर तुम्हाला प्रसारित केलेल्या पॅकेटची संख्या बदलायची असेल, तर तुम्ही कमांड लाइन आर्ग्युमेंट - -nPackets सेट करून तसे करू शकता.

$ ./waf --run "scratch/myfirst --nPackets=2"

आता बघायला हवं

Waf: Entering directory `/home/craigdo/repos/ns-3-allinone/ns-3-dev/build'
Waf: Leaving directory `/home/craigdo/repos/ns-3-allinone/ns-3-dev/build'
'build' finished successfully (0.404s)
0s UdpEchoServerApplication:UdpEchoServer()
1s UdpEchoServerApplication:StartApplication()
Sent 1024 bytes to 10.1.1.2
2.25732s Received 1024 bytes from 10.1.1.1
2.25732s Echoing packet
Received 1024 bytes from 10.1.1.2
Sent 1024 bytes to 10.1.1.2
3.25732s Received 1024 bytes from 10.1.1.1
3.25732s Echoing packet
Received 1024 bytes from 10.1.1.2
10s UdpEchoServerApplication:StopApplication()
UdpEchoServerApplication:DoDispose()
UdpEchoServerApplication:~UdpEchoServer()

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

5.3 ट्रेसिंग सिस्टम वापरणे

मॉडेलिंगचा संपूर्ण मुद्दा पुढील अभ्यासासाठी आउटपुट तयार करणे हा आहे आणि यासाठी ns-3 ट्रेस सिस्टम ही मुख्य यंत्रणा आहे. ns-3 हा C++ प्रोग्राम असल्याने, C++ प्रोग्रॅममधून आउटपुट निर्माण करण्याचे मानक साधन वापरले जाऊ शकते:

#include <iostream>
...
int main ()
{
...
std::cout << "The value of x is " << x << std::endl;
...
}

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

ns-3 ट्रेसिंग सिस्टमची मुख्य उद्दिष्टे आहेत:

• मूलभूत कार्यांसाठी, ट्रेसिंग सिस्टमने वापरकर्त्याला लोकप्रिय स्त्रोतांसाठी मानक ट्रेस व्युत्पन्न करण्याची आणि ट्रेस व्युत्पन्न करणारी वस्तू निवडण्याची परवानगी दिली पाहिजे;

• इंटरमीडिएट वापरकर्ते व्युत्पन्न आउटपुट स्वरूप बदलण्यासाठी किंवा सिम्युलेटर कोरमध्ये बदल न करता नवीन ट्रेस स्रोत समाविष्ट करण्यासाठी ट्रेसिंग सिस्टम वाढविण्यात सक्षम असावेत;

• नवीन ट्रेस स्रोत आणि सिंक जोडण्यासाठी प्रगत वापरकर्ते सिम्युलेटर कोर सुधारू शकतात. ns-3 ट्रेसिंग सिस्टीम स्वतंत्र ट्रॅकिंग स्त्रोत आणि रिसीव्हर्सच्या तत्त्वांवर तसेच ग्राहकांना स्त्रोत जोडण्यासाठी एक एकीकृत यंत्रणा तयार केली आहे.

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

सिंकद्वारे प्रदान केलेल्या माहितीसह प्रत्यक्षात काहीतरी उपयुक्त करणाऱ्या कोडच्या इतर भागांसह "जोडलेले" नसल्यास स्वतःच शोध स्त्रोत निरुपयोगी आहेत. ट्रेसर्स हे ट्रेस स्त्रोतांद्वारे प्रदान केलेल्या घटना आणि डेटाचे ग्राहक आहेत. उदाहरणार्थ, तुम्ही ट्रेस सिंक तयार करू शकता जे (मागील उदाहरणाच्या ट्रेस स्त्रोताशी जोडलेले असताना) प्राप्त झालेल्या पॅकेटमधील स्वारस्य असलेले भाग मुद्रित करेल.

सिम्युलेटर कोर संपादित आणि पुन्हा कंपाइल न करता वापरकर्त्यांना नवीन सिंक प्रकारांना विद्यमान ट्रेस स्त्रोतांशी जोडण्याची परवानगी देणे हे या स्पष्ट विभक्तीचे तर्क आहे. म्हणून वरील उदाहरणात, वापरकर्ता त्यांच्या स्क्रिप्टमध्ये नवीन ट्रेसर परिभाषित करू शकतो आणि केवळ वापरकर्ता स्क्रिप्ट संपादित करून सिम्युलेशन कोरमध्ये परिभाषित केलेल्या विद्यमान ट्रेस स्त्रोताशी कनेक्ट करू शकतो.

या ट्युटोरियलमध्ये, आम्ही काही पूर्वनिर्धारित स्त्रोत आणि सिंक पाहू आणि वापरकर्त्याच्या कमीतकमी प्रयत्नात ते कसे कॉन्फिगर केले जाऊ शकतात ते दाखवू. ट्रेस नेमस्पेस विस्तृत करणे आणि नवीन ट्रेस स्रोत तयार करणे यासह प्रगत ट्रेस कॉन्फिगरेशनच्या माहितीसाठी ns-3 मॅन्युअल किंवा कसे करायचे विभाग पहा.

5.3.1 ASCII ट्रेसिंग

ns-3 हेल्पर फंक्शनॅलिटी प्रदान करते जे साधे पॅकेट ट्रेस सेट करताना तपशीलांसह तुम्हाला मदत करण्यासाठी निम्न-स्तरीय ट्रेसिंग सिस्टम प्रदान करते. तुम्ही हे वैशिष्ट्य सक्षम केल्यास, तुम्हाला ASCII फाइल्समध्ये आउटपुट दिसेल. ns-2 आउटपुटशी परिचित असलेल्यांसाठी, या प्रकारचे ट्रेस सारखे आहे out.tr, जे अनेक स्क्रिप्टद्वारे व्युत्पन्न केले जाते.

चला व्यवसायात उतरू आणि काही ASCII ट्रेसिंग परिणाम आमच्या scratch/myfirst.cc स्क्रिप्टमध्ये जोडू. कॉलच्या आधी Simulator :: Run (), कोडच्या खालील ओळी जोडा:
AsciiTraceHelper ascii;

pointToPoint.EnableAsciiAll (ascii.CreateFileStream ("myfirst.tr"));

इतर अनेक ns-3 idioms प्रमाणे, हा कोड ASCII ट्रेस तयार करण्यासाठी हेल्पर ऑब्जेक्ट वापरतो. दुसऱ्या ओळीत दोन नेस्टेड मेथड कॉल्स आहेत. "आत" पद्धत फाइलस्ट्रीम तयार करा() स्टॅकवर (ऑब्जेक्टच्या नावाशिवाय) फाइल स्ट्रीम ऑब्जेक्ट तयार करण्यासाठी निनावी ऑब्जेक्ट आयडिओम वापरते आणि कॉल मेथडमध्ये पास करते. आम्ही भविष्यात याबद्दल अधिक खोलात जाऊ, परंतु या टप्प्यावर तुम्हाला फक्त हे माहित असणे आवश्यक आहे की तुम्ही एक ऑब्जेक्ट तयार करत आहात जी फाइलचे प्रतिनिधित्व करते myfirst.tr आणि ns-3 वर हस्तांतरित करा. आम्ही तयार केलेल्या ऑब्जेक्टची संपूर्ण आयुष्यभर काळजी घेण्यासाठी ns-3 ला सोपवतो, ज्या दरम्यान ते C++ स्ट्रीम ऑब्जेक्ट कॉपी कन्स्ट्रक्टरशी संबंधित अल्प-ज्ञात (हेतूपूर्वक) मर्यादेमुळे उद्भवलेल्या समस्यांचे निराकरण करते.

बाह्य कॉल सक्षमAsciiAll() सहाय्यकाला सांगते की तुम्ही सर्व पॉइंट-टू-पॉइंट डिव्हाइस कनेक्शनसाठी तुमच्या सिम्युलेशनमध्ये ASCII ट्रेसिंग समाविष्ट करू इच्छित आहात आणि तुम्हाला ASCII फॉरमॅटमध्ये पॅकेट हालचाली माहिती रेकॉर्ड करण्यासाठी (निर्दिष्ट केलेले) ट्रेस रिसीव्हर्स हवे आहेत.

ns-2 शी परिचित असलेल्यांसाठी, ट्रॅक केलेले इव्हेंट हे ज्ञात ट्रेसपॉइंट्सच्या समतुल्य आहेत जे इव्हेंट "+", "-", "d" आणि "r" लॉग करतात.
आता तुम्ही स्क्रिप्ट तयार करू शकता आणि कमांड लाइनवरून चालवू शकता:

$ ./waf --run scratch/myfirst

याआधी अनेकवेळा प्रमाणे, तुम्हाला Waf कडून अनेक संदेश दिसतील आणि नंतर चालू असलेल्या प्रोग्राममधील काही संदेशांसह "'बिल्ड' यशस्वीरित्या पूर्ण झाले".

चालू असताना, प्रोग्राम नावाची फाइल तयार करेल myfirst.tr. कामाच्या स्वरूपामुळे वाफ, डीफॉल्टनुसार फाइल स्थानिक निर्देशिकेत नाही तर रेपॉजिटरीच्या उच्च-स्तरीय निर्देशिकेत तयार केली जाते. जर तुम्हाला ट्रेस सेव्ह केलेला मार्ग बदलायचा असेल, तर तुम्ही ते निर्दिष्ट करण्यासाठी Waf पॅरामीटर वापरू शकता. --cwd. आम्ही हे केले नाही, म्हणून तुमच्या आवडत्या संपादकातील ASCII ट्रेस फाइल myfirst.tr पाहण्यासाठी, आम्हाला आमच्या भांडाराच्या उच्च-स्तरीय निर्देशिकेवर नेव्हिगेट करावे लागेल.

ASCII ट्रेस पार्स करत आहे

तेथे बरीच माहिती बऱ्यापैकी दाट स्वरूपात आहे, परंतु प्रथम आपण लक्षात घेणे आवश्यक आहे की फाइलमध्ये वैयक्तिक ओळी आहेत. तुम्ही व्ह्यूइंग विंडो विस्तृत केल्यास हे स्पष्टपणे दृश्यमान होईल.

फाइलमधील प्रत्येक ओळ ट्रेस इव्हेंटशी संबंधित आहे. या प्रकरणात, आम्ही सिम्युलेशनमधील प्रत्येक पॉइंट-टू-पॉइंट नेटवर्क डिव्हाइसमध्ये उपस्थित ट्रान्समिशन रांगेतील इव्हेंट्स ट्रेस करतो. ट्रान्समिशन रांग ही रांग आहे ज्यातून प्रत्येक पॅकेट पॉइंट-टू-पॉइंट लिंकसाठी पास होणे आवश्यक आहे. लक्षात घ्या की ट्रेस फाईलमधील प्रत्येक ओळ एका वर्णाने सुरू होते (आणि त्या नंतर एक जागा असते). या चिन्हाचा पुढील अर्थ असेल:

+: उपकरण रांगेत रांगेत ऑपरेशन झाले;
-: डिव्हाइस रांगेत घटक पुनर्प्राप्ती ऑपरेशन झाले;
d: पॅकेट टाकण्यात आले, सामान्यतः रांग भरलेली असल्यामुळे;
r: नेटवर्क उपकरणाद्वारे पॅकेट प्राप्त झाले.

चला ट्रेस फाइलमधील पहिल्या ओळीकडे जवळून पाहू. मी ते भागांमध्ये (स्पष्टतेसाठी इंडेंटेशनसह) आणि डावीकडील ओळ क्रमांकामध्ये खंडित करेन:

0 +
1 2
2 /NodeList/0/DeviceList/0/$ns3::PointToPointNetDevice/TxQueue/Enqueue
3 ns3::PppHeader (
4   Point-to-Point Protocol: IP (0x0021))
6   ns3::Ipv4Header (
7     tos 0x0 ttl 64 id 0 protocol 17 offset 0 flags [none]
8     length: 1052 10.1.1.1 > 10.1.1.2)
9     ns3::UdpHeader (
10      length: 1032 49153 > 9)
11      Payload (size=1024)

या विस्तारित ट्रेस इव्हेंटचा पहिला विभाग (ओळ 0) ऑपरेशन आहे. आमच्याकडे येथे + चिन्ह आहे, जे प्रसारणासाठी रांगेच्या ऑपरेशनशी संबंधित आहे. दुसरा विभाग (ओळ 1) सिम्युलेशन वेळ आहे, सेकंदांमध्ये व्यक्त केला जातो. आम्ही काय विचारले ते तुम्हाला आठवत असेल UdpEchoClientApplication दोन सेकंदात पॅकेट पाठवणे सुरू करा. येथे आम्ही पुष्टीकरण पाहतो की हे खरोखर घडत आहे.

ट्रेस उदाहरणाचा पुढील विभाग (ओळ 2 वरून) कोणत्या ट्रेस स्त्रोताने हा कार्यक्रम व्युत्पन्न केला हे दर्शविते (नेमस्पेस ट्रेस दर्शविते). तुम्ही फाईलसिस्टम नेमस्पेसप्रमाणे ट्रेस नेमस्पेसचा विचार करू शकता. नामस्थानाचे मूळ आहे नोडलिस्ट. हे मुख्य ns-3 कोडमध्ये व्यवस्थापित कंटेनरशी संबंधित आहे. यात स्क्रिप्टमध्ये तयार केलेल्या सर्व नोड्स आहेत. ज्याप्रमाणे फाइल सिस्टीमच्या मुळाशी डिरेक्टरी असू शकतात, नोडलिस्ट आपल्याकडे अनेक नोड्स असू शकतात. तर ओळ /NodeList/0 ही NodeList मधील null node चा संदर्भ देते, ज्याला आपण सहसा "node 0" असे समजतो. प्रत्येक नोडमध्ये स्थापित केलेल्या उपकरणांची सूची असते. ही यादी नेमस्पेसच्या पुढे आहे. आपण पाहू शकता की हा ट्रेस इव्हेंट येतो उपकरणसूची/0, जे नोडमध्ये स्थापित केलेले शून्य उपकरण आहे.

पुढील सबस्ट्रिंग, $ ns3 :: PointToPointNetDevice, कोणते डिव्हाइस शून्य स्थानावर आहे ते सांगते: नोड शून्याची डिव्हाइस सूची. स्मरण करा की ओळ 0 मध्ये आढळलेल्या + ऑपरेशनचा अर्थ डिव्हाइसच्या ट्रान्समिट रांगेत एक घटक जोडला गेला होता. हे "ट्रॅक पथ" च्या शेवटच्या विभागांमध्ये प्रतिबिंबित होते: TxQueue/Enqueue.

ट्रेसमधील उर्वरित विभाग बऱ्यापैकी अंतर्ज्ञानी असावेत. 3-4 ओळी सूचित करतात की पॅकेट पॉइंट-टू-पॉइंट प्रोटोकॉलमध्ये समाविष्ट केले आहे. ओळी 5-7 दर्शविते की पॅकेटमध्ये IP4 आवृत्ती शीर्षलेख आहे आणि ते IP पत्त्यावर उद्भवले आहे 10.1.1.1 आणि हेतू आहे 10.1.1.2. ओळी 8-9 दर्शविते की या पॅकेटमध्ये UDP शीर्षलेख आहे आणि शेवटी 10 रेषा दर्शविते की पेलोड अपेक्षित 1024 बाइट्स आहे.

ट्रेस फाइलमधील पुढील ओळ दर्शवते की समान पॅकेट समान नोडवरील ट्रान्समिशन रांगेतून खेचले गेले होते.

ट्रेस फाइलमधील तिसरी ओळ दर्शवते की इको सर्व्हर होस्टवरील नेटवर्क उपकरणाद्वारे पॅकेट प्राप्त झाले होते. मी खाली इव्हेंटचे पुनरुत्पादन केले आहे.

0 r
1 2.25732
2 /NodeList/1/DeviceList/0/$ns3::PointToPointNetDevice/MacRx
3   ns3::Ipv4Header (
4     tos 0x0 ttl 64 id 0 protocol 17 offset 0 flags [none]
5     length: 1052 10.1.1.1 > 10.1.1.2)
6     ns3::UdpHeader (
7       length: 1032 49153 > 9)
8       Payload (size=1024)

लक्षात घ्या की ट्रेस ऑपरेशन आता r आहे आणि सिम्युलेशन वेळ 2,25732 सेकंदांपर्यंत वाढवला गेला आहे. तुम्ही ट्यूटोरियल काळजीपूर्वक फॉलो केल्यास, याचा अर्थ तुम्ही नेटवर्क डिव्हाइसेसचा डेटारेट आणि लिंक विलंब त्यांच्या डीफॉल्ट मूल्यांवर सोडला आहे. आपण मागील विभागात पाहिल्याप्रमाणे हा काळ परिचित असावा.

ट्रेस सोर्स नेमस्पेस एंट्री (ओळ 2) सुधारित केली गेली आहे हे प्रतिबिंबित करण्यासाठी की हा कार्यक्रम नोड 1 (/नोडलिस्ट/1) आणि पॅकेट ट्रेस स्त्रोताद्वारे प्राप्त होते (/मॅकआरएक्स). फाईलमधील उर्वरित ट्रेस पाहून टोपोलॉजीद्वारे पॅकेटच्या हालचालीचे अनुसरण करणे आपल्यासाठी सोपे असावे.

5.3.2 PCAP ट्रेस

ns-3 डिव्हाइस हेल्परचा वापर .pcap फॉरमॅटमध्ये ट्रेस फाइल्स तयार करण्यासाठी देखील केला जाऊ शकतो. परिवर्णी शब्द pcap (सामान्यतः लोअरकेसमध्ये लिहिलेले) म्हणजे पॅकेट कॅप्चर आणि प्रत्यक्षात एक API आहे ज्यामध्ये .pcap फाइल स्वरूप परिभाषित करणे समाविष्ट आहे. हे स्वरूप वाचू आणि प्रदर्शित करू शकणारा सर्वात लोकप्रिय प्रोग्राम आहे वायरशार्क (पूर्वी म्हणतात ईथरेल). तथापि, असे अनेक ट्रॅफिक ट्रेस विश्लेषक आहेत जे हे पॅकेट स्वरूप वापरतात. आम्ही वापरकर्त्यांना pcap ट्रेसचे विश्लेषण करण्यासाठी उपलब्ध अनेक साधने वापरण्यास प्रोत्साहित करतो. या ट्युटोरियलमध्ये आपण pcap ट्रेस वापरून पाहण्यावर लक्ष केंद्रित करू tcpdump.

pcap ट्रेसिंग सक्षम करणे कोडच्या एका ओळीने केले जाते.

pointToPoint.EnablePcapAll ("myfirst");

आम्ही नुकताच जोडलेल्या ASCII ट्रेस कोडनंतर कोडची ही ओळ पेस्ट करा scratch/myfirst.cc. लक्षात घ्या की आम्ही फक्त "myfirst" स्ट्रिंग पास केली आहे, "myfirst.pcap" किंवा तत्सम काहीही नाही. कारण पॅरामीटर हा उपसर्ग आहे, पूर्ण फाइलनाव नाही. सिम्युलेशन दरम्यान, सहाय्यक प्रत्यक्षात प्रत्येक पॉइंट-टू-पॉइंट डिव्हाइससाठी ट्रेस फाइल तयार करेल. उपसर्ग, नोड क्रमांक, उपकरण क्रमांक आणि प्रत्यय वापरून फाइलची नावे तयार केली जातील.pcap».

आमच्या उदाहरण स्क्रिप्टसाठी, आम्ही शेवटी "नावाच्या फाइल्स पाहू.myfirst-0-0.pcap"आणि"myfirst-1-0.pcap", जे अनुक्रमे नोड 0-डिव्हाइस 0 आणि नोड 1-डिव्हाइस 0 साठी pcap ट्रेस आहेत. एकदा तुम्ही pcap ट्रेसिंग सक्षम करण्यासाठी कोडची ओळ जोडली की, तुम्ही नेहमीच्या पद्धतीने स्क्रिप्ट चालवू शकता:

$ ./waf --run scratch/myfirst

तुम्ही तुमच्या वितरणाच्या उच्च-स्तरीय निर्देशिकेत पाहिल्यास, तुम्हाला तीन फाइल्स दिसल्या पाहिजेत: एक ASCII ट्रेस फाइल myfirst.tr, ज्याचा आम्ही पूर्वी अभ्यास केला आहे, फाइल्स myfirst-0-0.pcap и myfirst-1-0.pcap - आम्ही नुकत्याच तयार केलेल्या नवीन pcap फाइल्स.

tcpdump सह आउटपुट वाचणे

सध्या, pcap फाइल्स पाहण्याचा सर्वात सोपा मार्ग म्हणजे tcpdump वापरणे.

$ tcpdump -nn -tt -r myfirst-0-0.pcap
reading from file myfirst-0-0.pcap, link-type PPP (PPP)
2.000000 IP 10.1.1.1.49153 > 10.1.1.2.9: UDP, length 1024
2.514648 IP 10.1.1.2.9 > 10.1.1.1.49153: UDP, length 1024
tcpdump -nn -tt -r myfirst-1-0.pcap
reading from file myfirst-1-0.pcap, link-type PPP (PPP)
2.257324 IP 10.1.1.1.49153 > 10.1.1.2.9: UDP, length 1024
2.257324 IP 10.1.1.2.9 > 10.1.1.1.49153: UDP, length 1024

डंप मध्ये myfirst-0-0.pcap (क्लायंट डिव्हाइस) सिम्युलेशनच्या 2 सेकंदांनंतर इको पॅकेट पाठवलेले आपण पाहू शकता. जर तुम्ही दुसरा डंप पाहिला तर (myfirst-1-0.pcap), तुम्हाला दिसेल की पॅकेट 2,257324 सेकंदांनी प्राप्त झाले आहे. तुम्हाला दुसऱ्या डंपमध्ये दिसेल की पॅकेट 2.257324 सेकंदात परत केले जाते आणि शेवटी क्लायंटला पहिल्या डंपमध्ये 2.514648 सेकंदात पॅकेट परत मिळाले.

वायरशार्कसह आउटपुट वाचणे

आपण परिचित नसल्यास वायरशार्क, एक वेबसाइट आहे जिथून तुम्ही प्रोग्राम आणि दस्तऐवज डाउनलोड करू शकता: http://www.wireshark.org/. वायरशार्क एक GUI आहे ज्याचा वापर या ट्रेस फाइल्स प्रदर्शित करण्यासाठी केला जाऊ शकतो. तुमच्याकडे वायरशार्क असल्यास, तुम्ही कोणतीही ट्रेस फाइल उघडू शकता आणि पॅकेट स्निफर वापरून पॅकेट्स कॅप्चर केल्याप्रमाणे सामग्री प्रदर्शित करू शकता.

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