ns-3 ການສອນ simulator ເຄືອຂ່າຍ. ບົດທີ 3

ບົດທີ 1,2

3 ການເລີ່ມຕົ້ນ
3.1 ພາບລວມ
3.2 ເງື່ອນໄຂເບື້ອງຕົ້ນ
3.2.1 ການດາວໂຫຼດການປ່ອຍ ns-3 ເປັນການຮວບຮວມແຫຼ່ງ
3.3 ການດາວໂຫຼດ ns-3 ໂດຍໃຊ້ Git
3.3.1 ການໂຫຼດ ns-3 ໂດຍໃຊ້ Bake
3.4 ສະພານ ns-3
3.4.1 ການກໍ່ສ້າງດ້ວຍ build.py
3.4.2 ການກໍ່ສ້າງດ້ວຍ Bake
3.4.3 ສ້າງດ້ວຍ Waf
3.5 ການທົດສອບ ns-3
3.6 ແລ່ນສະຄຣິບ
3.6.1 ການໂຕ້ຖຽງແຖວຄໍາສັ່ງ
3.6.2 ການດີບັກ
3.6.3 ເອກະສານການເຮັດວຽກ

ບົດທີ 3

ເລີ່ມຕົ້ນ

ບົດນີ້ແມ່ນມີຈຸດປະສົງເພື່ອກະກຽມຜູ້ອ່ານເພື່ອເລີ່ມຕົ້ນດ້ວຍຄອມພິວເຕີທີ່ອາດຈະບໍ່ເຄີຍຕິດຕັ້ງ ns-3. ມັນກວມເອົາແພລະຕະຟອມທີ່ສະຫນັບສະຫນູນ, ເງື່ອນໄຂເບື້ອງຕົ້ນ, ວິທີການໄດ້ຮັບ ns-3, ວິທີການສ້າງ ns-3, ແລະວິທີການທົດສອບການສ້າງແລະດໍາເນີນໂຄງການງ່າຍໆຂອງທ່ານ.

3.1 ພາບລວມ

ns-3 simulator ຖືກສ້າງຂຶ້ນເປັນລະບົບຂອງຫ້ອງສະຫມຸດຊອບແວຮ່ວມມື. ໃນລະຫວ່າງການປະກອບ, ລະຫັດຂອງໂປລແກລມຜູ້ໃຊ້ໄດ້ຖືກເຊື່ອມໂຍງກັບຫ້ອງສະຫມຸດເຫຼົ່ານີ້. ພາສາການຂຽນໂປລແກລມ C++ ຫຼື Python ຖືກນໍາໃຊ້ເພື່ອຂຽນໂປຼແກຼມທີ່ກໍາຫນົດເອງ.

Ns-3 ຖືກແຈກຢາຍເປັນລະຫັດແຫຼ່ງ, ຊຶ່ງຫມາຍຄວາມວ່າລະບົບເປົ້າຫມາຍຕ້ອງມີສະພາບແວດລ້ອມການພັດທະນາຊອບແວເພື່ອທໍາອິດສ້າງຫ້ອງສະຫມຸດແລະຫຼັງຈາກນັ້ນສ້າງໂຄງການຜູ້ໃຊ້. ໃນຫຼັກການ, ns-3 ສາມາດຖືກແຈກຢາຍເປັນຫ້ອງສະຫມຸດທີ່ກຽມພ້ອມສໍາລັບລະບົບສະເພາະ, ແລະໃນອະນາຄົດພວກເຂົາອາດຈະຖືກແຈກຢາຍດ້ວຍວິທີນີ້. ແຕ່ໃນປັດຈຸບັນຜູ້ໃຊ້ຫຼາຍຄົນກໍ່ເຮັດວຽກຂອງພວກເຂົາໂດຍການດັດແກ້ ns-3 ຕົວຂອງມັນເອງ, ດັ່ງນັ້ນມັນເປັນປະໂຫຍດທີ່ຈະມີລະຫັດແຫຼ່ງເພື່ອສ້າງຫ້ອງສະຫມຸດ. ຖ້າ​ຫາກ​ວ່າ​ຜູ້​ໃດ​ທີ່​ຕ້ອງ​ການ​ໃນ​ການ​ເຮັດ​ວຽກ​ຂອງ​ການ​ສ້າງ​ຫ້ອງ​ສະ​ຫມຸດ​ແລະ​ການ​ຫຸ້ມ​ຫໍ່​ສໍາ​ລັບ​ລະ​ບົບ​ປະ​ຕິ​ບັດ​ການ​, ກະ​ລຸ​ນາ​ຕິດ​ຕໍ່​ຫາ​ບັນ​ຊີ​ລາຍ​ຊື່​ທາງ​ໄປສະນີ ns-ນັກພັດທະນາ.

ຕໍ່ໄປ, ພວກເຮົາຈະເບິ່ງສາມວິທີທີ່ຈະດາວໂຫລດແລະສ້າງ ns-3. ທໍາອິດແມ່ນເພື່ອດາວໂຫລດແລະສ້າງການປ່ອຍຢ່າງເປັນທາງການຈາກເວັບໄຊທ໌ຕົ້ນຕໍ. ອັນທີສອງແມ່ນການຄັດເລືອກແລະການປະກອບສໍາເນົາຂອງສະບັບການພັດທະນາຂອງການຕິດຕັ້ງພື້ນຖານ ns-3. ທີສາມແມ່ນການນໍາໃຊ້ເຄື່ອງມືການກໍ່ສ້າງເພີ່ມເຕີມເພື່ອໂຫລດສ່ວນຂະຫຍາຍເພີ່ມເຕີມສໍາລັບ ns-3. ພວກເຮົາຈະຜ່ານແຕ່ລະອັນນັບຕັ້ງແຕ່ເຄື່ອງມືແມ່ນແຕກຕ່າງກັນເລັກນ້ອຍ.

ຜູ້ໃຊ້ Linux ທີ່ມີປະສົບການອາດຈະສົງໄສວ່າເປັນຫຍັງ ns-3 ບໍ່ໄດ້ຖືກສະຫນອງໃຫ້ເປັນແພັກເກັດຄືກັບຫ້ອງສະຫມຸດອື່ນໆສ່ວນໃຫຍ່ທີ່ໃຊ້ຕົວຈັດການຊຸດ? ເຖິງແມ່ນວ່າມີແພັກເກັດຄູ່ສໍາລັບການແຈກຢາຍ Linux ຕ່າງໆ (ເຊັ່ນ: Debian), ຜູ້ໃຊ້ສ່ວນໃຫຍ່ຈະແກ້ໄຂຫ້ອງສະຫມຸດແລະຕ້ອງສ້າງ ns-3 ດ້ວຍຕົນເອງ, ດັ່ງນັ້ນການມີລະຫັດແຫຼ່ງທີ່ມີຢູ່ແມ່ນມີປະໂຫຍດ. ສໍາລັບເຫດຜົນນີ້, ພວກເຮົາຈະສຸມໃສ່ການຕິດຕັ້ງຈາກແຫຼ່ງ.

ສໍາລັບຄໍາຮ້ອງສະຫມັກສ່ວນໃຫຍ່ສິດທິ ns-3 ຮາກ ບໍ່ຈໍາເປັນ, ແນະນໍາໃຫ້ໃຊ້ບັນຊີຜູ້ໃຊ້ທີ່ບໍ່ມີສິດທິພິເສດ.

3.2 ເງື່ອນໄຂເບື້ອງຕົ້ນ

ຊຸດທັງຫມົດຂອງຫ້ອງສະຫມຸດ ns-3 ທີ່ມີຢູ່ມີຈໍານວນຂອງການຂຶ້ນກັບຫ້ອງສະຫມຸດພາກສ່ວນທີສາມ, ແຕ່ສໍາລັບສ່ວນໃຫຍ່ ns-3 ສາມາດສ້າງແລະນໍາໃຊ້ກັບສະຫນັບສະຫນູນສໍາລັບອົງປະກອບທົ່ວໄປຫຼາຍ (ມັກຈະຕິດຕັ້ງໂດຍຄ່າເລີ່ມຕົ້ນ) ເປັນ: compiler C ++, Python, ບັນນາທິການລະຫັດແຫຼ່ງ (ຕົວຢ່າງ, vim, emacs ຫຼື ອຸປະລາຄາ) ແລະ, ຖ້າບ່ອນເກັບຂໍ້ມູນການພັດທະນາຖືກນໍາໃຊ້, ລະບົບການຄວບຄຸມເວີຊັນ Git. ຜູ້ໃຊ້ຄັ້ງທໍາອິດສ່ວນໃຫຍ່ຈະບໍ່ຈໍາເປັນຕ້ອງກັງວົນຖ້າການຕັ້ງຄ່າຂອງພວກເຂົາລາຍງານບາງລັກສະນະຂັ້ນສູງ ns-3 ຫາຍໄປ, ແຕ່ສໍາລັບຜູ້ທີ່ຕ້ອງການການຕິດຕັ້ງຢ່າງເຕັມທີ່, ໂຄງການສະຫນອງ wiki ທີ່ປະກອບມີຫນ້າທີ່ມີຄໍາແນະນໍາແລະຄໍາແນະນໍາທີ່ເປັນປະໂຫຍດຫຼາຍ. ຫນ້າຫນຶ່ງດັ່ງກ່າວແມ່ນຫນ້າການຕິດຕັ້ງ, ມີຄໍາແນະນໍາການຕິດຕັ້ງສໍາລັບລະບົບຕ່າງໆ, ມີຢູ່: https://www.nsnam.org/wiki/Installation.

ພາກສ່ວນເງື່ອນໄຂເບື້ອງຕົ້ນຂອງ wiki ນີ້ອະທິບາຍວ່າຊຸດໃດຕ້ອງການເພື່ອສະຫນັບສະຫນູນທາງເລືອກ ns-3 ທົ່ວໄປແລະຍັງສະຫນອງຄໍາສັ່ງທີ່ໃຊ້ໃນການຕິດຕັ້ງພວກມັນໃນລົດຊາດທົ່ວໄປຂອງ Linux ຫຼື macOS.

ທ່ານສາມາດໃຊ້ເວລາປະໂຫຍດຈາກໂອກາດນີ້ເພື່ອຄົ້ນຫາຫນ້າ wiki ns-3 ຫຼືເວັບໄຊທ໌ຕົ້ນຕໍ: https://www.nsnam.org, ເນື່ອງຈາກວ່າມີຂໍ້ມູນຈໍານວນຫລາຍຢູ່ທີ່ນັ້ນ. ໂດຍເລີ່ມຈາກເວີຊັນຫຼ້າສຸດຂອງ ns-3 (ns-3.29), ເຄື່ອງມືຕໍ່ໄປນີ້ແມ່ນຕ້ອງການເພື່ອແລ່ນ ns-3:

ຊຸດເຄື່ອງມື / ຮຸ່ນ

• C++ compiler
  clang++ ຫຼື g++ (g++ ລຸ້ນ 4.9 ຫຼືສູງກວ່າ)
• Python
  ລຸ້ນ python2 >= 2.7.10, ຫຼື ເວີຊັ່ນ python3 >=3.4
• Git
  ເວີຊັນຫຼ້າສຸດ (ເພື່ອເຂົ້າເຖິງ ns-3 ໃນ GitLab.com)
• tar
  ເວີຊັນຫຼ້າສຸດໃດໆກໍຕາມ (ສໍາລັບການ unpacking ns‑3 release)
• bunzip2
  ເວີຊັນຫຼ້າສຸດໃດໆກໍຕາມ (ສຳລັບການຖອດອອກລຸ້ນ ns‑3)

ເພື່ອກວດເບິ່ງເວີຊັນເລີ່ມຕົ້ນຂອງ Python, ພິມ python -V. ເພື່ອກວດເບິ່ງເວີຊັນ g++, ພິມ g++ -v. ຖ້າເຄື່ອງມືໃດຂາດຫາຍໄປ ຫຼືເກົ່າເກີນໄປ, ກະລຸນາເບິ່ງຄູ່ມືການຕິດຕັ້ງຢູ່ໃນໜ້າ wiki ns-3.

ຈາກນີ້, ພວກເຮົາສົມມຸດວ່າຜູ້ອ່ານກໍາລັງໃຊ້ Linux, MacOS, ຫຼື Linux emulator, ແລະມີຢ່າງຫນ້ອຍເຄື່ອງມືຂ້າງເທິງ.

3.2.1 ການດາວໂຫຼດການປ່ອຍ ns-3 ເປັນການຮວບຮວມແຫຼ່ງ

ນີ້ແມ່ນຫຼັກສູດການປະຕິບັດສໍາລັບຜູ້ໃຊ້ໃຫມ່ທີ່ຕ້ອງການດາວໂຫລດແລະທົດລອງກັບຮຸ່ນຫຼ້າສຸດແລະຊຸດຂອງ ns-3. ns-3 ປ່ອຍອອກມາເມື່ອຖືກຈັດພິມເປັນບ່ອນເກັບມ້ຽນແຫຼ່ງທີ່ຖືກບີບອັດ, ບາງຄັ້ງເອີ້ນວ່າ ໝາກ ບານ. ໝາກ ບານ ແມ່ນຮູບແບບການຈັດເກັບຊອບແວພິເສດທີ່ຫຼາຍໄຟລ໌ຖືກລວມເຂົ້າກັນ. ປົກກະຕິແລ້ວການຈັດເກັບຈະຖືກບີບອັດ. ns-3 ຂະບວນການ boot ຜ່ານ ໝາກ ບານ ແມ່ນງ່າຍດາຍ, ທ່ານພຽງແຕ່ຕ້ອງການທີ່ຈະເລືອກເອົາການປ່ອຍ, ດາວນ໌ໂຫລດແລະ unpack ມັນ.

ໃຫ້ສົມມຸດວ່າທ່ານເປັນຜູ້ໃຊ້ຕ້ອງການສ້າງ ns-3 ໃນໄດເລກະທໍລີທ້ອງຖິ່ນທີ່ເອີ້ນວ່າ ພື້ນທີ່ເຮັດວຽກ. ທ່ານສາມາດໄດ້ຮັບສໍາເນົາທີ່ເຮັດວຽກຂອງການປ່ອຍອອກມາໂດຍການໃສ່ສິ່ງຕໍ່ໄປນີ້ເຂົ້າໄປໃນ console Linux (ການທົດແທນຕົວເລກທີ່ເຫມາະສົມ, ແນ່ນອນ)

$ cd 
$ mkdir workspace 
$ cd workspace 
$ wget https://www.nsnam.org/release/ns-allinone-3.29.tar.bz2 
$ tar xjf ns-allinone-3.29.tar.bz2 

ເອົາໃຈໃສ່ກັບຜົນປະໂຫຍດທີ່ໃຊ້ຂ້າງເທິງ wget, ເຊິ່ງເປັນເຄື່ອງມືບັນທັດຄໍາສັ່ງສໍາລັບການດາວໂຫຼດວັດຖຸຈາກອິນເຕີເນັດ. ຖ້າທ່ານບໍ່ໄດ້ຕິດຕັ້ງມັນ, ທ່ານສາມາດນໍາໃຊ້ຕົວທ່ອງເວັບຂອງທ່ານສໍາລັບການນີ້.

ການປະຕິບັດຕາມຂັ້ນຕອນເຫຼົ່ານີ້ຈະນໍາທ່ານໄປຫາໄດເລກະທໍລີ ns-allinone-3.29, ຢູ່ທີ່ນັ້ນທ່ານຄວນຈະເຫັນໄຟລ໌ແລະໄດເລກະທໍລີຫຼາຍອັນ.

$ cd ns-allinone-3.29
$ ls
bake constants.py ns-3.29 README
build.py netanim-3.108 pybindgen-0.17.0.post58+ngcf00cc0 util.py

ຕອນນີ້ເຈົ້າພ້ອມແລ້ວທີ່ຈະສ້າງການແຈກຢາຍພື້ນຖານ ns-3 ແລະສາມາດຍ້າຍໄປທີ່ພາກສ່ວນກ່ຽວກັບການກໍ່ສ້າງ ns-3.

3.3 ການດາວໂຫຼດ ns-3 ໂດຍໃຊ້ Git

ລະຫັດ ns-3 ແມ່ນມີຢູ່ໃນບ່ອນເກັບມ້ຽນ Git ໃນ GitLab.com ທີ່ https://gitlab.com/nsnam/. ກຸ່ມ ນາມສະກຸນ ເອົາ repositories ຕ່າງໆທີ່ໃຊ້ໂດຍໂຄງການແຫຼ່ງເປີດ.

ວິທີທີ່ງ່າຍທີ່ສຸດທີ່ຈະເລີ່ມຕົ້ນການນໍາໃຊ້ບ່ອນເກັບມ້ຽນ Git ແມ່ນການສ້ອມແຊມຫຼືໂຄນສະພາບແວດລ້ອມ ns-3-allinone. ນີ້ແມ່ນຊຸດຂອງສະຄິບທີ່ຈັດການການໂຫຼດແລະການປະກອບຂອງລະບົບຍ່ອຍ ns-3 ທີ່ໃຊ້ທົ່ວໄປທີ່ສຸດ. ຖ້າທ່ານໃຫມ່ກັບ Git, ຄໍາວ່າ "fork" ແລະ "clone" ອາດຈະບໍ່ຄຸ້ນເຄີຍກັບທ່ານ; ຖ້າເປັນດັ່ງນັ້ນ, ພວກເຮົາແນະນໍາໃຫ້ທ່ານພຽງແຕ່ clone (ເຮັດສໍາເນົາຂອງທ່ານເອງ) repository ທີ່ຕັ້ງຢູ່ໃນ 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

ກະລຸນາສັງເກດວ່າມີ script download.py, ເຊິ່ງນອກຈາກນັ້ນຈະສະກັດ ns-3 ແລະລະຫັດແຫຼ່ງທີ່ມາ. ໃນ​ທີ່​ນີ້​ທ່ານ​ມີ​ທາງ​ເລືອກ​: ທັງ​ດາວ​ນ​໌​ໂຫລດ​ຮູບ​ພາບ​ການ​ພັດ​ທະ​ນາ ns-3 ຫລ້າ​ສຸດ​:

$ python download.py

ຫຼືມັກການປ່ອຍ ns-3 ໂດຍໃຊ້ທຸງ -n ເພື່ອຊີ້ບອກຕົວເລກການປ່ອຍ:

$ python download.py -n ns-3.29

ຫຼັງຈາກຂັ້ນຕອນນີ້ໄປຫາໄດເລກະທໍລີ ns-3-allinone repositories ເພີ່ມເຕີມຈະຖືກດາວໂຫຼດ ns-3, bake, pybindgen и ເນຕັນນິມ.

Примечание
ໃນເຄື່ອງທີ່ມີ Ubuntu16.04 ທີ່ສະອາດ, ຂ້ອຍຈໍາເປັນຕ້ອງປ່ຽນຄໍາສັ່ງນີ້: $ sudo python3 download.py -n ns-3.29 (ຕໍ່ໄປນີ້ແມ່ນບັນທຶກຂອງຜູ້ແປ).

3.3.1 ການໂຫຼດ ns-3 ໂດຍໃຊ້ Bake

ສອງວິທີຂ້າງເທິງ (ບ່ອນເກັບມ້ຽນແຫຼ່ງຫຼື repository ns-3-allinone ຜ່ານ Git) ແມ່ນເປັນປະໂຫຍດສໍາລັບການໄດ້ຮັບການຕິດຕັ້ງ ns-3 ທີ່ງ່າຍດາຍທີ່ສຸດທີ່ມີ addons ຫຼາຍ (pybindgen ເພື່ອສ້າງການຜູກມັດ Python ແລະ ເນຕັນນິມ ສໍາ​ລັບ​ການ​ເຄື່ອນ​ໄຫວ​ເຄືອ​ຂ່າຍ​)​. ບ່ອນເກັບມ້ຽນທີສາມທີ່ສະຫນອງໃຫ້ໂດຍຄ່າເລີ່ມຕົ້ນໃນ ns-3-allinone ຖືກເອີ້ນວ່າ bake.

ອົບ ເປັນ​ເຄື່ອງ​ມື​ສໍາ​ລັບ​ການ​ປະ​ສານ​ງານ​ການ​ກໍ່​ສ້າງ​ຂອງ​ຊອບ​ແວ​ຈາກ repositories ຫຼາຍ​, ການ​ພັດ​ທະ​ນາ​ສໍາ​ລັບ​ໂຄງ​ການ ns​-3​. ອົບ ສາມາດໃຊ້ເພື່ອຮັບລຸ້ນພັດທະນາຂອງ ns-3, ເຊັ່ນດຽວກັນກັບການດາວໂຫຼດ ແລະສ້າງສ່ວນຂະຫຍາຍຂອງເວີຊັນພື້ນຖານຂອງການແຈກຢາຍ ns-3, ເຊັ່ນ: ສະພາບແວດລ້ອມ. ການປະຕິບັດລະຫັດໂດຍກົງ, CradleNetwork Simulation Cradle, ຄວາມສາມາດໃນການສ້າງການຜູກມັດ Python ໃຫມ່ແລະ "ແອັບຯ" ns-3 ຕ່າງໆ.

Примечание
CradleNetwork Simulation Cradle ແມ່ນກອບທີ່ອະນຸຍາດໃຫ້ທ່ານໃຊ້ stacks ເຄືອຂ່າຍ TCP / IP ທີ່ແທ້ຈິງພາຍໃນ simulator ເຄືອຂ່າຍ.

ຖ້າທ່ານຄາດຫວັງວ່າການຕິດຕັ້ງ ns-3 ຂອງທ່ານຈະມີຄຸນສົມບັດຂັ້ນສູງຫຼືເພີ່ມເຕີມ, ທ່ານສາມາດປະຕິບັດຕາມເສັ້ນທາງການຕິດຕັ້ງນີ້.

ໃນການປ່ອຍ ns-3 ຫຼ້າສຸດ ອົບ ໄດ້ຖືກເພີ່ມເຂົ້າໃນການປ່ອຍ tar. ການປ່ອຍຕົວປະກອບມີໄຟລ໌ການຕັ້ງຄ່າທີ່ຊ່ວຍໃຫ້ທ່ານສາມາດດາວໂຫລດເວີຊັນຂອງຊອບແວໃນປະຈຸບັນໃນເວລາອອກ. ນັ້ນແມ່ນ, ສໍາລັບການຍົກຕົວຢ່າງ, ສະບັບ ອົບ, ເຊິ່ງຖືກແຈກຢາຍກັບການປ່ອຍ ns-3.29, ສາມາດໃຊ້ເພື່ອດຶງເອົາອົງປະກອບສໍາລັບການເປີດຕົວຂອງ ns-3 ຫຼືກ່ອນຫນ້ານັ້ນ, ແຕ່ບໍ່ສາມາດຖືກນໍາໃຊ້ເພື່ອດຶງເອົາອົງປະກອບສໍາລັບການອອກຕໍ່ມາ (ຖ້າໄຟລ໌ຄໍາອະທິບາຍຊຸດ. bakeconf.xml ບໍ່​ໄດ້​ປັບ​ປຸງ).

ນອກນັ້ນທ່ານຍັງສາມາດໄດ້ຮັບສໍາເນົາຫລ້າສຸດ bakeໂດຍການໃສ່ຄໍາສັ່ງຕໍ່ໄປນີ້ເຂົ້າໄປໃນ console Linux ຂອງທ່ານ (ສົມມຸດວ່າທ່ານໄດ້ຕິດຕັ້ງ 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.

ຫຼັງຈາກຄໍາສັ່ງສໍາເລັດ clone ທ່ານຄວນມີຊື່ໄດເລກະທໍລີ bake, ເນື້ອໃນຂອງສິ່ງທີ່ຄວນຈະມີລັກສະນະເຊັ່ນນີ້:

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

ໃຫ້ສັງເກດວ່າທ່ານໄດ້ໂຫລດສະຄິບ Python ຫຼາຍອັນ, ໂມດູນ Python ຊື່ bake ແລະໄຟລ໌ການຕັ້ງຄ່າ XML. ຂັ້ນຕອນຕໍ່ໄປແມ່ນການໃຊ້ສະຄິບເຫຼົ່ານີ້ເພື່ອດາວໂຫລດແລະສ້າງການແຈກຢາຍ ns-3 ທີ່ທ່ານເລືອກ. ເປົ້າໝາຍການປັບແຕ່ງຫຼາຍອັນສາມາດໃຊ້ໄດ້:

1. ns-3.29: ໂມດູນທີ່ສອດຄ່ອງກັບການປ່ອຍ; ມັນຈະດາວໂຫລດອົງປະກອບທີ່ຄ້າຍຄືກັນກັບການປ່ອຍໃນ tarball;

2. ns-3-dev: ໂມດູນທີ່ຄ້າຍຄືກັນ, ແຕ່ໃຊ້ລະຫັດຈາກຕົ້ນໄມ້ພັດທະນາ;

3. ns-allinone-3.29: ໂມດູນທີ່ປະກອບມີຄຸນສົມບັດເພີ່ມເຕີມອື່ນໆເຊັ່ນ: ເສັ້ນທາງຄລິກ ແລະເຄືອຂ່າຍຈຳລອງ Cradle, Openflow ສໍາລັບ ns-3.

4. ns-3-allinone: ຄ້າຍຄືກັນກັບລຸ້ນລຸ້ນຂອງໂມດູນ Allinone, ແຕ່ສໍາລັບລະຫັດການພັດທະນາ.

Примечание
ກົດ — ສະ​ຖາ​ປັດ​ຕະ​ຍະ​ການ​ຊອບ​ແວ modular ສໍາ​ລັບ​ການ​ສ້າງ routers​.

Openflow ແມ່ນໂປໂຕຄອນສໍາລັບການຄຸ້ມຄອງຂະບວນການປະມວນຜົນຂໍ້ມູນທີ່ຖືກສົ່ງຜ່ານເຄືອຂ່າຍຂໍ້ມູນໂດຍ routers ແລະ switches, ການປະຕິບັດເຕັກໂນໂລຢີເຄືອຂ່າຍທີ່ກໍານົດໂດຍຊອບແວ.

ພາບຖ່າຍການພັດທະນາໃນປະຈຸບັນ (ທີ່ບໍ່ແມ່ນການປ່ອຍ) ns-3 ສາມາດພົບໄດ້ທີ່:https://gitlab.com/nsnam/ns-3-dev.git.

ນັກພັດທະນາພະຍາຍາມຮັກສາ repositories ເຫຼົ່ານີ້ຢູ່ໃນຄໍາສັ່ງທີ່ເຮັດວຽກທີ່ສອດຄ່ອງ, ແຕ່ພວກເຂົາຢູ່ໃນພື້ນທີ່ການພັດທະນາແລະມີລະຫັດທີ່ຍັງບໍ່ໄດ້ປ່ອຍອອກມາ, ດັ່ງນັ້ນຖ້າທ່ານບໍ່ໄດ້ວາງແຜນທີ່ຈະໃຊ້ຄຸນສົມບັດໃຫມ່, ຫຼັງຈາກນັ້ນເລືອກການປ່ອຍຢ່າງເປັນທາງການ.

ທ່ານ​ສາ​ມາດ​ຊອກ​ຫາ​ສະ​ບັບ​ຫລ້າ​ສຸດ​ຂອງ​ລະ​ຫັດ​ໂດຍ​ການ​ຊອກ​ຫາ​ລາຍ​ຊື່​ຂອງ repositories​, ຫຼື​ໂດຍ​ການ​ໄປ​ທີ່​ຫນ້າ​ເວັບ​ໄຊ​ຕ​໌ ns-3 Releases​:https://www.nsnam.org/releases/ ແລະຄລິກໃສ່ການເຊື່ອມຕໍ່ສະບັບຫລ້າສຸດ. ໃນຕົວຢ່າງນີ້ພວກເຮົາຈະສືບຕໍ່ກັບ ns-3.29.

ໃນປັດຈຸບັນ, ເພື່ອໃຫ້ໄດ້ຮັບອົງປະກອບ ns-3 ທີ່ພວກເຮົາຕ້ອງການ, ພວກເຮົາຈະນໍາໃຊ້ເຄື່ອງມື ອົບ. ໃຫ້ເວົ້າວ່າຄໍາແນະນໍາຈໍານວນຫນ້ອຍກ່ຽວກັບວຽກງານ ອົບ.

Bake ເຮັດວຽກໂດຍການໂຫລດແຫຼ່ງແພັກເກັດເຂົ້າໄປໃນໄດເລກະທໍລີ ແຫຼ່ງ ແລະການຕິດຕັ້ງຫ້ອງສະຫມຸດເຂົ້າໄປໃນ build directory. ອົບ ສາມາດດໍາເນີນການໄດ້ໂດຍການອ້າງອິງ binary, ແຕ່ຖ້າຫາກວ່າທ່ານຕ້ອງການທີ່ຈະດໍາເນີນການ ອົບ ບໍ່ແມ່ນຈາກໄດເລກະທໍລີທີ່ມັນຖືກດາວໂຫຼດ, ຄວນເພີ່ມເສັ້ນທາງໄປຫາ bake ໄປສູ່ເສັ້ນທາງຂອງທ່ານ (ຕົວແປສະພາບແວດລ້ອມ PATH), ຕົວຢ່າງຕໍ່ໄປນີ້ (ຕົວຢ່າງສໍາລັບ Linux bash shell). ໄປທີ່ໄດເລກະທໍລີ "bake" ແລະຫຼັງຈາກນັ້ນກໍານົດຕົວແປສະພາບແວດລ້ອມຕໍ່ໄປນີ້:

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

ນີ້ຈະຈັດວາງໂຄງການ bake.py ໄປສູ່ເສັ້ນທາງ shell ແລະຈະອະນຸຍາດໃຫ້ໂຄງການອື່ນໆຊອກຫາ executables ແລະຫ້ອງສະຫມຸດທີ່ມັນສ້າງ bake. ໃນບາງກໍລະນີການນໍາໃຊ້ bake, ການຕັ້ງຄ່າ PATH ແລະ PYTHONPATH ທີ່ອະທິບາຍຂ້າງເທິງແມ່ນບໍ່ຈໍາເປັນ, ແຕ່ການກໍ່ສ້າງທີ່ສົມບູນຂອງ ns-3-allinone (ມີຊຸດເພີ່ມເຕີມ) ປົກກະຕິແລ້ວຕ້ອງການມັນ.

ໄປທີ່ໄດເລກະທໍລີທີ່ເຮັດວຽກຂອງທ່ານແລະໃສ່ສິ່ງຕໍ່ໄປນີ້ໃນ console:

$ ./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 ແລະ Bazaar ແມ່ນມີຄວາມຈໍາເປັນໃນຂັ້ນຕອນນີ້ຍ້ອນວ່າພວກເຂົາອະນຸຍາດໃຫ້ພວກເຮົາໄດ້ຮັບລະຫັດ. ໃນຈຸດນີ້, ຕິດຕັ້ງເຄື່ອງມືທີ່ຂາດຫາຍໄປໃນແບບປົກກະຕິສໍາລັບລະບົບຂອງທ່ານ (ຖ້າທ່ານຮູ້ວິທີ) ຫຼືຕິດຕໍ່ຜູ້ເບິ່ງແຍງລະບົບຂອງທ່ານເພື່ອຂໍຄວາມຊ່ວຍເຫຼືອ.

ຕໍ່ໄປ, ລອງດາວໂຫລດຊອບແວ:

$ ./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 ແລະປະກອບກັບ bake.

3.4.1 ການກໍ່ສ້າງດ້ວຍ build.py

ລະ​ມັດ​ລະ​ວັງ ຂັ້ນຕອນການກໍ່ສ້າງນີ້ແມ່ນມີພຽງແຕ່ຈາກສະບັບ archive ແຫຼ່ງທີ່ໄດ້ອະທິບາຍຂ້າງເທິງນີ້; ແລະບໍ່ໄດ້ດາວໂຫຼດຜ່ານ git ຫຼື bake.

ເມື່ອເຮັດວຽກກັບບ່ອນເກັບມ້ຽນການປ່ອຍ ໝາກ ບານ, ໃນ 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 ໂດຍບໍ່ມີຕົວຢ່າງແລະການທົດສອບ, ຫຼືຍົກເວັ້ນໂມດູນທີ່ບໍ່ຈໍາເປັນສໍາລັບວຽກງານຂອງທ່ານ.

ທ່ານ​ຈະ​ເຫັນ​ຫຼາຍ​ຂໍ້​ຄວາມ​ຜົນ​ຜະ​ລິດ compiler ສະ​ແດງ​ໂດຍ script ດັ່ງ​ທີ່​ມັນ​ສ້າງ​ພາກ​ສ່ວນ​ຕ່າງໆ​ທີ່​ທ່ານ​ໄດ້​ໂຫຼດ​. ທໍາອິດສະຄຣິບຈະພະຍາຍາມສ້າງຕົວເຄື່ອນໄຫວ ເນຕັນນິມ, ຫຼັງຈາກນັ້ນເຄື່ອງກໍາເນີດຜູກມັດ 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 ທີ່ຂຶ້ນກັບຫ້ອງສະຫມຸດພາຍນອກອາດຈະບໍ່ຖືກສ້າງຂຶ້ນ, ຫຼືວ່າພວກມັນບໍ່ຈໍາເປັນຕ້ອງສ້າງສໍາລັບການຕັ້ງຄ່ານີ້. ນີ້ບໍ່ໄດ້ຫມາຍຄວາມວ່າ simulator ບໍ່ໄດ້ປະກອບຫຼືໂມດູນປະກອບຈະບໍ່ເຮັດວຽກຢ່າງຖືກຕ້ອງ.

3.4.2 ການກໍ່ສ້າງດ້ວຍ Bake

ຖ້າທ່ານໃຊ້ bake ຂ້າງເທິງເພື່ອເອົາລະຫັດແຫຼ່ງຈາກ repositories ໂຄງການ, ທ່ານສາມາດສືບຕໍ່ໃຊ້ມັນເພື່ອສ້າງ 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 ສາມາດໄດ້ຮັບການປະກອບໂດຍເຄື່ອງມື bake ບໍ່ແມ່ນຢູ່ໃນທຸກເວທີ. ໃນກໍລະນີນີ້, ຂໍ້ຄວາມແບບນີ້ຈະປາກົດ:

>> 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 ຕ້ອງການພຽງແຕ່ຖ້າທ່ານຕ້ອງການສ້າງການຜູກມັດ Python ທີ່ມີການປັບປຸງ. ສໍາລັບຜູ້ໃຊ້ສ່ວນໃຫຍ່ບໍ່ມີຄວາມຈໍາເປັນສໍາລັບການນີ້ (ຢ່າງຫນ້ອຍຈົນກ່ວາພວກເຂົາປ່ຽນ ns-3), ດັ່ງນັ້ນຄໍາເຕືອນດັ່ງກ່າວສາມາດຖືກລະເລີຍຢ່າງປອດໄພສໍາລັບໃນປັດຈຸບັນ.

ຖ້າມັນລົ້ມເຫລວ, ຄໍາສັ່ງຕໍ່ໄປນີ້ຈະໃຫ້ຄໍາແນະນໍາແກ່ເຈົ້າກ່ຽວກັບຄວາມເພິ່ງພາອາໄສທີ່ຂາດຫາຍໄປ:

$ ./bake.py show

ການຂຶ້ນກັບຕ່າງໆຂອງແພັກເກດທີ່ເຈົ້າພະຍາຍາມສ້າງຈະຖືກລະບຸໄວ້.

3.4.3 ສ້າງດ້ວຍ Waf

ເຖິງຈຸດນີ້, ເພື່ອເລີ່ມຕົ້ນການກໍ່ສ້າງ ns-3, ພວກເຮົາໃຊ້ສະຄິບ build.py, ຫຼືເຄື່ອງມື bake. ເຄື່ອງມືເຫຼົ່ານີ້ແມ່ນເປັນປະໂຫຍດສໍາລັບການກໍ່ສ້າງ 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 ຢູ່ນອກໄດເລກະທໍລີທ້ອງຖິ່ນ (ເພື່ອຄວາມສະດວກຂອງທ່ານ). ຄໍາສັ່ງທໍາອິດເຮັດຄວາມສະອາດຈາກການກໍ່ສ້າງທີ່ຜ່ານມາ, ນີ້ແມ່ນປົກກະຕິແລ້ວບໍ່ຈໍາເປັນຢ່າງເຂັ້ມງວດ, ແຕ່ມັນເປັນການປະຕິບັດທີ່ດີ (ຍັງເບິ່ງການສ້າງໂປຣໄຟລ໌ຂ້າງລຸ່ມນີ້); ນີ້ຈະເປັນການລຶບຫ້ອງສະໝຸດທີ່ສ້າງຂຶ້ນໃນເມື່ອກ່ອນ ແລະໄຟລ໌ວັດຖຸທີ່ຢູ່ໃນໄດເລກະທໍລີ ສ້າງ/. ເມື່ອໂຄງການຖືກ configured ແລະລະບົບການກໍ່ສ້າງຈະກວດສອບການເພິ່ງພາອາໄສຕ່າງໆ, ທ່ານຄວນເຫັນຜົນໄດ້ຮັບທີ່ຄ້າຍຄືກັບຕໍ່ໄປນີ້:

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 bit "ຕັ້ງ ID ກຸ່ມໃນເວລາແລ່ນ" ສໍາລັບບາງໂຄງການ. ມັນບໍ່ໄດ້ຖືກເປີດໃຊ້ໂດຍຄ່າເລີ່ມຕົ້ນແລະດັ່ງນັ້ນຄຸນສົມບັດນີ້ປາກົດເປັນ "ບໍ່ໄດ້ເປີດໃຊ້". ສຸດທ້າຍ, ເພື່ອໃຫ້ໄດ້ຮັບບັນຊີລາຍຊື່ຂອງທາງເລືອກໃນການເປີດໃຊ້, ໃຊ້ Waf ກັບພາລາມິເຕີ --check-config.

ຕອນນີ້ໃຫ້ກັບຄືນໄປ ແລະປ່ຽນກັບໄປສ້າງ debug ທີ່ມີຕົວຢ່າງ ແລະການທົດສອບ.

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

ດຽວນີ້ລະບົບການກໍ່ສ້າງຖືກຕັ້ງຂຶ້ນ ແລະທ່ານສາມາດສ້າງເວີຊັນ debug ຂອງໂປຣແກຣມ 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 configure --disable-python. ນີ້ແມ່ນບາງຄໍາແນະນໍາແນະນໍາເພີ່ມເຕີມກ່ຽວກັບ Waf.

ການຈັດການຄວາມຜິດພາດໃນການສ້າງ

ns-3 ລຸ້ນຖືກທົດສອບຢູ່ໃນຕົວລວບລວມຂໍ້ມູນ C ++ ຫຼ້າສຸດທີ່ມີຢູ່ໃນເວລາຂອງການປ່ອຍ Linux ແລະ MacOS ທົ່ວໄປ. ຢ່າງໃດກໍຕາມ, ເມື່ອເວລາຜ່ານໄປ, ການແຈກຢາຍໃຫມ່ໄດ້ຖືກປ່ອຍອອກມາໂດຍ compilers ໃຫມ່, ແລະ compilers ໃຫມ່ເຫຼົ່ານີ້ມີແນວໂນ້ມທີ່ຈະ pedantic ຫຼາຍກ່ຽວກັບການເຕືອນໄພ. ns-3 configure ການກໍ່ສ້າງຂອງມັນເພື່ອປະຕິບັດການເຕືອນໄພທັງຫມົດເປັນຄວາມຜິດພາດ, ດັ່ງນັ້ນບາງຄັ້ງຖ້າຫາກວ່າທ່ານກໍາລັງດໍາເນີນການສະບັບເກົ່າຢູ່ໃນລະບົບໃຫມ່, ຄໍາເຕືອນ compiler ອາດຈະຢຸດເຊົາການກໍ່ສ້າງ.

ຕົວຢ່າງ, ກ່ອນຫນ້ານີ້ມີການປ່ອຍ ns‑3.28 ສໍາລັບ Fedora 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, ໃນ Waf ມີທາງເລືອກໃນການແກ້ໄຂບັນຫາເຫຼົ່ານີ້. ມັນປິດການຕັ້ງທຸງ "-Wrror" ໃນ g++ ແລະ clang++. ນີ້ແມ່ນຕົວເລືອກ "--disable-wrror" ແລະຕ້ອງຖືກນຳໃຊ້ໃນລະຫວ່າງການກຳນົດຄ່າ:

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

ຕັ້ງຄ່າຫຼືປະກອບ

ບາງຄໍາສັ່ງ Waf ມີຄວາມຫມາຍພຽງແຕ່ໃນໄລຍະການຕັ້ງຄ່າ, ແລະບາງອັນແມ່ນຖືກຕ້ອງພຽງແຕ່ໃນໄລຍະການກໍ່ສ້າງ. ຕົວຢ່າງ: ຖ້າທ່ານຕ້ອງການໃຊ້ຄຸນສົມບັດການຈໍາລອງ ns-3, ທ່ານສາມາດເປີດໃຊ້ການຕັ້ງຄ່າບິດ ໃຕ້ ການນໍາໃຊ້ sudo, ດັ່ງທີ່ໄດ້ອະທິບາຍຂ້າງເທິງ. ນີ້ຈະ override ຄໍາສັ່ງຂັ້ນຕອນການຕັ້ງຄ່າ, ແລະດັ່ງນັ້ນທ່ານສາມາດປ່ຽນການຕັ້ງຄ່າໂດຍໃຊ້ຄໍາສັ່ງຕໍ່ໄປນີ້, ເຊິ່ງປະກອບມີຕົວຢ່າງແລະການທົດສອບ.

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

ຖ້າທ່ານເຮັດສິ່ງນີ້ Waf ຈະເປີດຕົວ sudoເພື່ອປ່ຽນໂປຣແກມສ້າງຊັອກເກັດລະຫັດ emulation ເພື່ອດໍາເນີນການດ້ວຍການອະນຸຍາດ ຮາກ. ການ Waf ມີຫຼາຍທາງເລືອກອື່ນທີ່ມີຢູ່ສໍາລັບຂັ້ນຕອນການຕັ້ງຄ່າແລະການກໍ່ສ້າງ. ເພື່ອສຳຫຼວດຕົວເລືອກຂອງທ່ານ, ກະລຸນາໃສ່:

$ ./waf --help

ໃນພາກຕໍ່ໄປພວກເຮົາຈະນໍາໃຊ້ບາງທາງເລືອກທີ່ກ່ຽວຂ້ອງກັບການທົດສອບ.

ໂປຣໄຟລ໌ປະກອບ

ພວກເຮົາໄດ້ເຫັນແລ້ວວ່າທ່ານສາມາດຕັ້ງຄ່າແນວໃດ Waf ສໍາລັບການຊຸມນຸມ debug и ທີ່ດີທີ່ສຸດ:

$ ./waf --build-profile=debug

ຍັງມີໂປຣໄຟລ໌ການປະກອບລະດັບປານກາງ, ປ່ອຍ. ທາງເລືອກ -d ແມ່ນຄໍາສັບຄ້າຍຄືກັນກັບ --build-profile. ໂປຣໄຟລ໌ການກໍ່ສ້າງຄວບຄຸມການໃຊ້ການບັນທຶກ, ການຢືນຢັນ, ແລະສະຫຼັບການເພີ່ມປະສິດທິພາບການລວບລວມຂໍ້ມູນ:

ດັ່ງທີ່ເຈົ້າສາມາດເຫັນໄດ້, ການບັນທຶກ ແລະ ການຢືນຢັນແມ່ນມີຢູ່ໃນການສ້າງດີບັກເທົ່ານັ້ນ. ການປະຕິບັດທີ່ແນະນໍາແມ່ນການພັດທະນາສະຄິບຂອງທ່ານໃນໂຫມດດີບັກ, ຫຼັງຈາກນັ້ນດໍາເນີນການຊ້ໍາຊ້ອນ (ສໍາລັບການປ່ຽນແປງສະຖິຕິຫຼືພາລາມິເຕີ) ໃນໂປຣໄຟລ໌ການກໍ່ສ້າງທີ່ເຫມາະສົມ.

ຖ້າທ່ານມີລະຫັດທີ່ຄວນຈະດໍາເນີນການພຽງແຕ່ໃນບາງໂປຣໄຟລ໌ການກໍ່ສ້າງ, ໃຊ້ Code Wrapper Macro:

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

Compilers ແລະທຸງ

ໃນຕົວຢ່າງຂ້າງເທິງ Waf ເພື່ອສ້າງ ns-3 ໃຊ້ C++ compiler ຈາກ GCC ( g ++). ຢ່າງໃດກໍຕາມ, ທ່ານສາມາດປ່ຽນອັນທີ່ທ່ານໃຊ້ Waf C++ compiler, ໂດຍກໍານົດຕົວແປສະພາບແວດລ້ອມ CXX. ສໍາລັບຕົວຢ່າງ, ການນໍາໃຊ້ C ++ compiler Clang, clang ++,

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

ໃນທາງດຽວກັນ, ທ່ານສາມາດ configure ໄດ້ Waf ການນໍາໃຊ້ການລວບລວມການແຈກຢາຍໂດຍໃຊ້ distcc:

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

ຂໍ້ມູນເພີ່ມເຕີມກ່ຽວກັບ distcc ແລະການລວບລວມການແຈກຢາຍສາມາດພົບໄດ້ຢູ່ໃນຫນ້າໂຄງການໃນພາກເອກະສານ. ເພື່ອເພີ່ມທຸງ compiler ເມື່ອກຳນົດຄ່າ ns-3, ໃຫ້ໃຊ້ຕົວແປສະພາບແວດລ້ອມ CXXFLAGS_EXTRA.

ການຕັ້ງຄ່າ

Waf ສາມາດຖືກນໍາໃຊ້ເພື່ອຕິດຕັ້ງຫ້ອງສະຫມຸດໃນສະຖານທີ່ຕ່າງໆໃນລະບົບ. ໂດຍຄ່າເລີ່ມຕົ້ນ, ຫ້ອງສະຫມຸດທີ່ລວບລວມແລະປະຕິບັດໄດ້ແມ່ນຢູ່ໃນໄດເລກະທໍລີ ການກໍ່ສ້າງ, ແລະນັບຕັ້ງແຕ່ Waf ຮູ້ສະຖານທີ່ຂອງຫ້ອງສະຫມຸດແລະການປະຕິບັດການເຫຼົ່ານີ້, ບໍ່ຈໍາເປັນຕ້ອງຕິດຕັ້ງຫ້ອງສະຫມຸດຢູ່ບ່ອນອື່ນ.

ຖ້າຜູ້ໃຊ້ມັກຕິດຕັ້ງນອກໄດເລກະທໍລີກໍ່ສ້າງ, ພວກເຂົາສາມາດດໍາເນີນການຄໍາສັ່ງ ./waf ຕິດຕັ້ງ. ຄໍານໍາຫນ້າເລີ່ມຕົ້ນສໍາລັບການຕິດຕັ້ງແມ່ນ / usr / ທ້ອງຖິ່ນເພາະສະນັ້ນ ./waf ຕິດຕັ້ງ ຈະຕິດຕັ້ງໂຄງການໃນ / usr / local / bin, ຫ້ອງສະຫມຸດໃນ / usr / local / lib ແລະໄຟລ໌ header ໃນ /usr/local/include. ປົກກະຕິແລ້ວສິດ Superuser ຈະຕ້ອງຖືກຕັ້ງດ້ວຍຄໍານໍາຫນ້າເລີ່ມຕົ້ນ, ດັ່ງນັ້ນຄໍາສັ່ງປົກກະຕິຈະເປັນ sudo ./waf ຕິດຕັ້ງ. ເມື່ອເປີດຕົວ, Waf ຈະເລືອກໃຊ້ຫ້ອງສະຫມຸດທີ່ໃຊ້ຮ່ວມກັນໃນໄດເລກະທໍລີສ້າງ, ຫຼັງຈາກນັ້ນຊອກຫາຫ້ອງສະຫມຸດຕາມເສັ້ນທາງໄປຫາຫ້ອງສະຫມຸດທີ່ຖືກຕັ້ງຄ່າໃນສະພາບແວດລ້ອມທ້ອງຖິ່ນ. ດັ່ງນັ້ນເມື່ອຕິດຕັ້ງຫ້ອງສະຫມຸດຢູ່ໃນລະບົບ, ມັນເປັນການປະຕິບັດທີ່ດີທີ່ຈະກວດເບິ່ງວ່າຫ້ອງສະຫມຸດທີ່ຖືກຕ້ອງຖືກນໍາໃຊ້. ຜູ້​ໃຊ້​ສາ​ມາດ​ເລືອກ​ທີ່​ຈະ​ຕິດ​ຕັ້ງ​ທີ່​ມີ​ຄໍາ​ນໍາ​ຫນ້າ​ທີ່​ແຕກ​ຕ່າງ​ກັນ​ໂດຍ​ການ​ຜ່ານ​ທາງ​ເລືອກ​ໃນ​ລະ​ຫວ່າງ​ການ​ຕັ້ງ​ຄ່າ​ --prefixຕົວຢ່າງ:

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

ຖ້າຕໍ່ມາ, ຫຼັງຈາກການກໍ່ສ້າງ, ຜູ້ໃຊ້ເຂົ້າໄປໃນຄໍາສັ່ງການຕິດຕັ້ງ ./waf, ຄໍານໍາຫນ້າຈະຖືກນໍາໃຊ້ /opt/local.

ທີມງານ ./waf clean ຕ້ອງຖືກນໍາໃຊ້ກ່ອນທີ່ຈະ configure ໂຄງການຖ້າຫາກວ່າການຕິດຕັ້ງຈະນໍາໃຊ້ Waf ພາຍ​ໃຕ້​ຄໍາ​ນໍາ​ຫນ້າ​ທີ່​ແຕກ​ຕ່າງ​ກັນ​.

ດັ່ງນັ້ນ, ເພື່ອໃຊ້ ns-3 ບໍ່ຈໍາເປັນຕ້ອງໂທຫາ ./waf install. ຜູ້ໃຊ້ສ່ວນໃຫຍ່ຈະບໍ່ຕ້ອງການຄໍາສັ່ງນີ້ເພາະວ່າ Waf ຈະເກັບເອົາຫ້ອງສະຫມຸດໃນປະຈຸບັນຈາກໄດເລກະທໍລີສ້າງ, ແຕ່ຜູ້ໃຊ້ບາງຄົນອາດຈະເຫັນວ່າມັນເປັນປະໂຫຍດຖ້າກິດຈະກໍາຂອງພວກເຂົາກ່ຽວຂ້ອງກັບການເຮັດວຽກກັບບັນດາໂຄງການນອກໄດເລກະທໍລີ ns-3.

Waf ດຽວ

ໃນລະດັບສູງສຸດຂອງຕົ້ນໄມ້ແຫຼ່ງ ns-3, ມີພຽງແຕ່ຫນຶ່ງ script Waf. ເມື່ອທ່ານເລີ່ມເຮັດວຽກ, ທ່ານຈະໃຊ້ເວລາຫຼາຍໃນໄດເລກະທໍລີ scratch/ ຫຼືເລິກເຂົ້າໄປໃນsrc/... ແລະໃນເວລາດຽວກັນຕ້ອງດໍາເນີນການ Waf. ທ່ານພຽງແຕ່ສາມາດຈື່ບ່ອນທີ່ທ່ານຢູ່ແລະແລ່ນ Waf ດັ່ງຕໍ່ໄປນີ້:

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

ແຕ່ນີ້ຈະເປັນການ tedious ແລະມີຄວາມຜິດພາດ, ສະນັ້ນມີວິທີແກ້ໄຂທີ່ດີກວ່າ. ຫນຶ່ງໃນວິທີການທົ່ວໄປແມ່ນການນໍາໃຊ້ຕົວແກ້ໄຂຂໍ້ຄວາມເຊັ່ນ: emacs ຫຼື vim, ໃນສອງກອງປະຊຸມ terminal ຖືກເປີດ, ຫນຶ່ງຖືກນໍາໃຊ້ເພື່ອສ້າງ ns-3, ແລະທີສອງແມ່ນໃຊ້ເພື່ອແກ້ໄຂລະຫັດແຫຼ່ງ. ຖ້າເຈົ້າມີເທົ່ານັ້ນ ໝາກ ບານ, ຫຼັງຈາກນັ້ນຕົວແປສະພາບແວດລ້ອມສາມາດຊ່ວຍໄດ້:

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

$ cd scratch 
$ waff build

ໃນໄດເລກະທໍລີໂມດູນມັນອາດຈະເປັນການລໍ້ລວງທີ່ຈະເພີ່ມສະຄິບ waf trivial ເຊັ່ນ 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)

ນີ້ແມ່ນຂໍ້ຄວາມທີ່ສໍາຄັນສໍາລັບການກໍານົດ valgrind crashes, crashes ຫຼືຄວາມຜິດພາດ, ຊີ້ໃຫ້ເຫັນເຖິງບັນຫາກ່ຽວກັບລະຫັດຫຼືຄວາມບໍ່ສອດຄ່ອງລະຫວ່າງເຄື່ອງມືແລະລະຫັດ.

ນອກນັ້ນທ່ານຍັງຈະເຫັນຜົນຜະລິດສຸດທ້າຍຈາກ 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: ... " ອາດຈະແຕກຕ່າງກັນ, ນີ້ແມ່ນເລື່ອງປົກກະຕິ. ສິ່ງທີ່ສໍາຄັນແມ່ນວ່າເສັ້ນສະຫຼຸບໃນຕອນທ້າຍຂອງບົດລາຍງານສະແດງໃຫ້ເຫັນວ່າການທົດສອບທັງຫມົດຜ່ານ; ບໍ່ມີການທົດສອບລົ້ມເຫລວຫຼື crashed.) ແລະ Wafແລະ test.py ຈະຂະໜານກັນເຮັດວຽກໃນທົ່ວແກນປະມວນຜົນທີ່ມີຢູ່ຂອງເຄື່ອງ.

3.6 ແລ່ນສະຄຣິບ

ພວກເຮົາປົກກະຕິແລ່ນສະຄຣິບພາຍໃຕ້ການຄວບຄຸມ Waf. ນີ້ອະນຸຍາດໃຫ້ລະບົບການກໍ່ສ້າງເພື່ອຮັບປະກັນວ່າເສັ້ນທາງຫ້ອງສະຫມຸດທີ່ແບ່ງປັນໄດ້ຖືກຕັ້ງຢ່າງຖືກຕ້ອງແລະຫ້ອງສະຫມຸດສາມາດໃຊ້ໄດ້ໃນເວລາແລ່ນ. ເພື່ອດໍາເນີນການໂຄງການ, ພຽງແຕ່ນໍາໃຊ້ Waf ກັບພາລາມິເຕີ - -run. ໃຫ້ດໍາເນີນການທຽບເທົ່າ ns-3 ຂອງໂຄງການຢູ່ທົ່ວທຸກແຫ່ງ ສະ​ບາຍ​ດີ​ຊາວ​ໂລກໂດຍການພິມຕໍ່ໄປນີ້:

$ ./waf --run hello-simulator

Waf ທໍາອິດຈະກວດເບິ່ງວ່າໂຄງການຖືກສ້າງຂຶ້ນຢ່າງຖືກຕ້ອງແລະກໍ່ສ້າງຖ້າຈໍາເປັນ. ຈາກນັ້ນ Waf ຈະດໍາເນີນການໂຄງການທີ່ຜະລິດຜົນໄດ້ຮັບດັ່ງຕໍ່ໄປນີ້.

Hello Simulator

ຊົມເຊີຍ! ດຽວນີ້ເຈົ້າເປັນຜູ້ໃຊ້ ns-3!

ຂ້ອຍຄວນເຮັດແນວໃດຖ້າຂ້ອຍບໍ່ເຫັນຜົນ?

ຖ້າເຈົ້າເຫັນຂໍ້ຄວາມ Wafຊີ້ໃຫ້ເຫັນວ່າການກໍ່ສ້າງສໍາເລັດສົບຜົນສໍາເລັດ, ແຕ່ວ່າທ່ານບໍ່ເຫັນຜົນໄດ້ຮັບ "ສະບາຍດີ Simulator", ຫຼັງຈາກນັ້ນມີຄວາມເປັນໄປໄດ້ວ່າໃນພາກ [Build-with-Waf] ທ່ານໄດ້ປ່ຽນໂຫມດການກໍ່ສ້າງຂອງທ່ານເປັນ. ທີ່ດີທີ່ສຸດ, ແຕ່ພາດການສະຫຼັບກັບໄປໂໝດ debug. ຜົນຜະລິດຂອງຄອນໂຊນທັງໝົດທີ່ໃຊ້ໃນບົດສອນນີ້ໃຊ້ອົງປະກອບ ns-3 ພິເສດທີ່ດໍາເນີນການບັນທຶກ ແລະຖືກນໍາໃຊ້ເພື່ອພິມຂໍ້ຄວາມທີ່ກໍາຫນົດເອງໃສ່ console. ຜົນຜະລິດຈາກອົງປະກອບນີ້ຖືກປິດໃຊ້ງານໂດຍອັດຕະໂນມັດເມື່ອລະຫັດ optimized ຖືກລວບລວມ - ມັນແມ່ນ "optimized". ຖ້າ​ຫາກ​ວ່າ​ທ່ານ​ບໍ່​ເຫັນ​ຜົນ​ຜະ​ລິດ "Hello Simulator​"​, ໃຫ້​ໃສ່​ດັ່ງ​ຕໍ່​ໄປ​ນີ້​:

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

ເພື່ອປັບແຕ່ງ Waf ເພື່ອສ້າງສະບັບ debug ຂອງໂຄງການ ns-3, ເຊິ່ງລວມມີຕົວຢ່າງ ແລະການທົດສອບ. ຈາກນັ້ນທ່ານຄວນສ້າງລະຫັດສະບັບດີບັກປັດຈຸບັນຄືນໃໝ່ໂດຍການພິມ

$ ./waf

ໃນປັດຈຸບັນຖ້າຫາກວ່າທ່ານດໍາເນີນການໂຄງການ ສະບາຍດີ simulator, ທ່ານຄວນເຫັນຜົນໄດ້ຮັບທີ່ຄາດໄວ້.

3.6.1 ການໂຕ້ຖຽງແຖວຄໍາສັ່ງ

ເພື່ອຜ່ານ arguments ແຖວຄໍາສັ່ງໄປຫາໂປແກມ ns-3, ໃຊ້ຮູບແບບຕໍ່ໄປນີ້:

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

ແທນທີ່ ກັບຊື່ຂອງໂຄງການຂອງທ່ານແລະການໂຕ້ຖຽງ. ການໂຕ້ຖຽງ - -command-template ການ Waf ເປັນສູດສໍາລັບການກໍ່ສ້າງເສັ້ນຄໍາສັ່ງຕົວຈິງ Waf ໃຊ້ເພື່ອປະຕິບັດໂຄງການ. Waf ກວດເບິ່ງວ່າການກໍ່ສ້າງສໍາເລັດແລ້ວ, ກໍານົດເສັ້ນທາງຫ້ອງສະຫມຸດທີ່ໃຊ້ຮ່ວມກັນ, ຫຼັງຈາກນັ້ນໃຊ້ແມ່ແບບເສັ້ນຄໍາສັ່ງທີ່ສະຫນອງໃຫ້ແລະທົດແທນຊື່ໂຄງການສໍາລັບ %s placeholder ເພື່ອໂທຫາການປະຕິບັດ. ຖ້າທ່ານພົບວ່າ syntax ນີ້ສັບສົນ, ມີສະບັບທີ່ງ່າຍດາຍກວ່າທີ່ກ່ຽວຂ້ອງກັບໂຄງການ 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"

3.6.2 ການດີບັກ

ເພື່ອດໍາເນີນການໂຄງການ ns-3 ພາຍໃຕ້ຜົນປະໂຫຍດອື່ນ, ເຊັ່ນ: debugger (ຕົວຢ່າງ, gdb) ຫຼືເຄື່ອງມືທົດສອບຄວາມຊົງຈໍາ (ຕົວຢ່າງ: valgrind), ໃຊ້ຮູບແບບທີ່ຄ້າຍຄືກັນ - -command-template = "…". ສໍາລັບຕົວຢ່າງ, ດໍາເນີນການໃນ debugger ໄດ້ gdb ໂປຣແກຣມ hello-simulator ns-3 ຂອງທ່ານທີ່ມີການໂຕ້ຖຽງ:

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

ໃຫ້ສັງເກດວ່າຊື່ໂປຣແກຣມ ns-3 ມາພ້ອມກັບການໂຕ້ຖຽງ - -run, ແລະຜົນປະໂຫຍດການຄຸ້ມຄອງ (ທີ່ນີ້ gdb) ເປັນ token ທໍາອິດໃນການໂຕ້ຖຽງ - -command-template. ທາງເລືອກ - -args informs gdbວ່າສ່ວນທີ່ເຫຼືອຂອງເສັ້ນຄໍາສັ່ງເປັນຂອງໂປແກມ "ຕ່ໍາ". (ບາງສະບັບ gdb ບໍ່ເຂົ້າໃຈທາງເລືອກ - -args. ໃນກໍລະນີນີ້, ເອົາການໂຕ້ຖຽງໂຄງການອອກຈາກ - -command-template ແລະໃຊ້ຊຸດຄໍາສັ່ງ gdb ໂຕ້ຖຽງ.) ພວກ​ເຮົາ​ສາ​ມາດ​ລວມ​ສູດ​ນີ້​ແລະ​ອັນ​ທີ່​ຜ່ານ​ມາ​ເພື່ອ​ດໍາ​ເນີນ​ການ​ທົດ​ສອບ​ພາຍ​ໃຕ້​ການ debugger ໄດ້​:

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