Difference between revisions of "Contributed Code"

From Nsnam
Jump to: navigation, search
(netns3 added to contributed code)
m (Contributed code not maintained by the project)
(38 intermediate revisions by 6 users not shown)
Line 1: Line 1:
 
{{TOC}}
 
{{TOC}}
 
There are several ways to contribute code to ns-3:
 
There are several ways to contribute code to ns-3:
# [http://www.nsnam.org/contributing.html#contribute Contribute to the main tree]
+
# [http://www.nsnam.org/developers/contributing-code/ Contribute to the main tree]
 
# Send contributed code to one of the maintainers, for archiving on the project website (and listing here)
 
# Send contributed code to one of the maintainers, for archiving on the project website (and listing here)
 
# Maintain or archive your code at your own site and add a link here
 
# Maintain or archive your code at your own site and add a link here
Line 7: Line 7:
 
== Contributed code under review for the main tree ==
 
== Contributed code under review for the main tree ==
  
The preferred place for contributed code to end up is in our main tree.  See section 2 of the
+
The preferred place for contributed code to end up is in our main tree.  See the [[Current_Development#Code_reviews | Current Development page]] and [https://groups.google.com/forum/?fromgroups#!forum/ns-3-reviews code review discussions] for a listing of all code that is under review for the main tree..
[[Current_Development]] page for a listing of all code that is under review for the main tree.
+
 
+
== Contributed code in src/contrib ==
+
 
+
Please note that the src/contrib/ directory in ns-3 is a place for experimental code or code that the maintainers have not yet committed to accepting into the main tree.  Some ns-3 code (such as statistics code) started out by living in the src/contrib/ directory while it was being evaluated.  This is an alternate target for contributing your code.
+
  
 
== Contributed code not maintained by the project ==
 
== Contributed code not maintained by the project ==
Line 22: Line 17:
 
|+ Contributions
 
|+ Contributions
 
! Contribution !! Contributor !! Status !! Link   
 
! Contribution !! Contributor !! Status !! Link   
 +
|-
 +
! OpenNet:  An emulator for Software-Defined Wireless Local Area Network and Software-Defined LTE Backhaul Network
 +
|  Min-Cheng Chan, Ting-Hsuan Hsieh || ns-3.22 version || [https://github.com/dlinknctu/OpenNet GitHub site]
 +
|-
 +
! Tmix and DelayBox
 +
|  Old Dominion || ns-3.13/3.14.1/3.21 versions || [http://code.google.com/p/tmix-ns3/ project website]
 +
|-
 +
! Synchronized Network Emulation
 +
|  RWTH Aachen || ns-3.7 version || [http://www.comsys.rwth-aachen.de/projects/slicetime/ project website]
 +
|-
 +
! NEMO/MIP simulator
 +
|  Hajime Tazaki || announced [http://mailman.isi.edu/pipermail/ns-developers/2010-November/008455.html here] || [http://code.nsnam.org/thehajime/ns-3-dce-quagga-umip/ code repository]
 +
|-
 +
! Content Addressable Networks DHT
 +
|  Vijay K. Gurbani et al. || announced [http://mailman.isi.edu/pipermail/ns-developers/2010-November/008460.html here] || [https://open-innovation.alcatel-lucent.com/svn/ns-3-can code repository]
 
|-
 
|-
 
! Pastry DHT Port
 
! Pastry DHT Port
Line 31: Line 41:
 
! Linux namespaces and ns-3
 
! Linux namespaces and ns-3
 
|  Tom Goff || demo code || [http://www.nsnam.org/wiki/index.php/HOWTO_use_Linux_namespaces_with_ns-3 wiki page]  
 
|  Tom Goff || demo code || [http://www.nsnam.org/wiki/index.php/HOWTO_use_Linux_namespaces_with_ns-3 wiki page]  
 +
|-
 +
! ndnSIM: Named Data Networking (NDN) module for ns-3
 +
|  Alexander Afanasyev et al. || released || [http://ndnsim.net ndnSIM homepage]
 +
|-
 +
! WiFi Dynamic Frequency Allocation feature
 +
|  Raad Qandah || patch against ns-3.11 || [http://www.nsnam.org/contributed/Dynamic-Wifi-Frequency-Allocation-Feature.tar.gz Download tarball]
 +
|-
 +
! Fisheye State Routing with Node Degree Based Route Computation
 +
|  [mailto:r311b712@ku.edu Ralph Baird] || zip archive (tested with ns-3.20) || [http://www.nsnam.org/contributed/fsr.zip  Download zip archive]
 +
|-
 +
! CRE-NS3:  Cognitive radio extension for ns-3
 +
|  Abdulla Al-Ali and Kaushik Chowdhury || GitHub code (tested with ns-3.17) || [http://www.devasque.com/crens3/  Web site]
 +
|-
 +
! Examples of using the [https://github.com/steinwurf/kodo Steinwurf C++ Kodo library] (network coding) [http://kodo-ns3-examples.readthedocs.org/en/latest/index.html with ns-3]
 +
| Nestor Hernandez || github (tracking ns-3-dev) || [http://kodo-ns3-examples.readthedocs.org/en/latest/# Project web site]
 +
|-
 +
! Multipath TCP from Morteza Kheirkhah
 +
|  [mailto:M.Kheirkhah@sussex.ac.uk Morteza Kheirkhah] || GitHub code (tested with ns-3.19) || [https://github.com/mkheirkhah/mptcp  GitHub repo]
 +
|-
 +
! Blackhole attack simulation in ns-3 using AODV
 +
|  [mailto:tahiliani@nitk.ac.in Shalini Satre and Mohit P. Tahiliani] || Patches for ns-3.20 to ns-3.25 || [http://mohittahiliani.blogspot.in/2014/12/ns-3-blackhole-attack-simulation-in-ns-3.html  Patch and sample program]
 +
|-
 +
! [[RadioWatcher]] (Provides real-time layer2
 +
information from a Wifi device)
 +
|  Fraunhofer FKIE ([mailto:christoph.fuchs@fkie.fraunhofer.de contact: Christoph Fuchs]) || tgz archive (tested with ns-3.23) || [http://www.nsnam.org/contributed/RadioWatcher.tgz  Download archive]
 +
|-
 +
! Distance vector routing
 +
|  [mailto:west@sd.keio.ac.jp Hiroaki Nishi] || Patches for ns-3.21 || [https://github.com/westlab/ns3dvrp GitHub repository]
 +
|-
 +
! OpenFlow 1.3 module
 +
|  [mailto:luciano@lrc.ic.unicamp.br Luciano Jerez Chaves] || Patches for ns-3.24 || [http://www.lrc.ic.unicamp.br/ofswitch13/ website]
 +
|-
 +
! OpenFlow DCE SDN framework
 +
|  [mailto:j.ivey@gatech.edu Jared Ivey] || DCE modifications || [https://github.com/jaredivey/dce-python-sdn GitHub repo]
 +
|-
 +
! Topology Generator
 +
|  [mailto:jeffrey.young@inl.gov Jeffrey Young] || GitHub repository (tested with ns-3.25) || [https://github.com/idaholab/Topology_Generator GitHub repo]
 +
|-
 +
! Code Generator (command-line/XML topology generator)
 +
|  [mailto:jeffrey.young@inl.gov Jeffrey Young] || GitHub repository (tested with ns-3.25) || [https://github.com/idaholab/Code_Generator GitHub repo]
 +
|-
 +
! Wormhole Attack Simulation using ns3
 +
|  Rahul Hada || GitHub repository (tested with ns-3.20) || [https://github.com/rahulhada/ns3-wormhole-attack GitHub repo]
 +
|-
 +
! Overlay ICN (O-ICN) simulator
 +
|  [mailto:suvrat.a@tcs.com Suvrat Agrawal], and [mailto:s.samar@tcs.com Samar Shailendra] || Github repository; tested with ns3.24 || [https://github.com/TCS-Research/OICNSIM/ GitHub repo]
 +
|-
 +
! TCP Wave from TLCSat Group
 +
|  [mailto:ahmed.said@uniroma2.it Ahmed Abdelsalam], and [mailto:roseti@ing.uniroma2.it Cesare Roseti] || Group Webpage /Github repository; tested with ns3.23 || [https://github.com/Ahmed1978/TCPWave GitHub repo]; [http://tlcsat.uniroma2.it/tcpwave TLCSat page]
 
|}
 
|}
  

Revision as of 21:32, 16 January 2017

Main Page - Current Development - Developer FAQ - Tools - Related Projects - Project Ideas - Summer Projects

Installation - Troubleshooting - User FAQ - HOWTOs - Samples - Models - Education - Contributed Code - Papers

There are several ways to contribute code to ns-3:

  1. Contribute to the main tree
  2. Send contributed code to one of the maintainers, for archiving on the project website (and listing here)
  3. Maintain or archive your code at your own site and add a link here

Contributed code under review for the main tree

The preferred place for contributed code to end up is in our main tree. See the Current Development page and code review discussions for a listing of all code that is under review for the main tree..

Contributed code not maintained by the project

Not all code will end up being merged-- some is being maintained by third party sites or maintainers. This section can be used to list this other code. Note also that if you want the ns-3 project to maintain a tarball of your scripts or models for long-term archiving, we can list it here.

Contributions
Contribution Contributor Status Link
OpenNet: An emulator for Software-Defined Wireless Local Area Network and Software-Defined LTE Backhaul Network Min-Cheng Chan, Ting-Hsuan Hsieh ns-3.22 version GitHub site
Tmix and DelayBox Old Dominion ns-3.13/3.14.1/3.21 versions project website
Synchronized Network Emulation RWTH Aachen ns-3.7 version project website
NEMO/MIP simulator Hajime Tazaki announced here code repository
Content Addressable Networks DHT Vijay K. Gurbani et al. announced here code repository
Pastry DHT Port Charilaos Papadopoulos early beta Personal Website
Access point address manager Francesco Malandrino details Download ap-address-manager.cc/h
Linux namespaces and ns-3 Tom Goff demo code wiki page
ndnSIM: Named Data Networking (NDN) module for ns-3 Alexander Afanasyev et al. released ndnSIM homepage
WiFi Dynamic Frequency Allocation feature Raad Qandah patch against ns-3.11 Download tarball
Fisheye State Routing with Node Degree Based Route Computation Ralph Baird zip archive (tested with ns-3.20) Download zip archive
CRE-NS3: Cognitive radio extension for ns-3 Abdulla Al-Ali and Kaushik Chowdhury GitHub code (tested with ns-3.17) Web site
Examples of using the Steinwurf C++ Kodo library (network coding) with ns-3 Nestor Hernandez github (tracking ns-3-dev) Project web site
Multipath TCP from Morteza Kheirkhah Morteza Kheirkhah GitHub code (tested with ns-3.19) GitHub repo
Blackhole attack simulation in ns-3 using AODV Shalini Satre and Mohit P. Tahiliani Patches for ns-3.20 to ns-3.25 Patch and sample program
RadioWatcher (Provides real-time layer2

information from a Wifi device)

Fraunhofer FKIE (contact: Christoph Fuchs) tgz archive (tested with ns-3.23) Download archive
Distance vector routing Hiroaki Nishi Patches for ns-3.21 GitHub repository
OpenFlow 1.3 module Luciano Jerez Chaves Patches for ns-3.24 website
OpenFlow DCE SDN framework Jared Ivey DCE modifications GitHub repo
Topology Generator Jeffrey Young GitHub repository (tested with ns-3.25) GitHub repo
Code Generator (command-line/XML topology generator) Jeffrey Young GitHub repository (tested with ns-3.25) GitHub repo
Wormhole Attack Simulation using ns3 Rahul Hada GitHub repository (tested with ns-3.20) GitHub repo
Overlay ICN (O-ICN) simulator Suvrat Agrawal, and Samar Shailendra Github repository; tested with ns3.24 GitHub repo
TCP Wave from TLCSat Group Ahmed Abdelsalam, and Cesare Roseti Group Webpage /Github repository; tested with ns3.23 GitHub repo; TLCSat page

Archived repositories

These ns-3 repositories may be of interest to future users; many of them are prototypes that were never merged to the main tree and have been abandoned.