Difference between revisions of "Contributed Code"

From Nsnam
Jump to: navigation, search
(add zipf distribution to the contributed code list)
m (Contributed code not maintained by the project)
(48 intermediate revisions by 8 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 ==
  
See also:  http://www.nsnam.org/wiki/index.php/Reviews
+
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..
 +
 
 +
== 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.
  
 
{| border=1 cellspacing=0 cellpadding=3
 
{| border=1 cellspacing=0 cellpadding=3
  
 
|+ Contributions
 
|+ Contributions
! Contribution !! Contributor !! Status !! Link !! Assigned Maintainer
+
! Contribution !! Contributor !! Status !! Link
 
|-
 
|-
! drop tail queue with byte limits
+
! OpenNet:  An emulator for Software-Defined Wireless Local Area Network and Software-Defined LTE Backhaul Network
Salik Syed || accepted (changeset 7e0ff1be867a) || [http://www.nsnam.org/bugzilla/show_bug.cgi?id=457 bugzilla] || Craig Dowell
+
Min-Cheng Chan, Ting-Hsuan Hsieh || ns-3.22 version || [https://github.com/dlinknctu/OpenNet GitHub site]  
 
|-
 
|-
! access point address manager
+
! Tmix and DelayBox
Francesco Malandrino || Assigned || [http://www.nsnam.org/bugzilla/show_bug.cgi?id=471 bugzilla] || Mathieu Lacage
+
Old Dominion || ns-3.13/3.14.1/3.21 versions || [http://code.google.com/p/tmix-ns3/ project website]  
 
|-
 
|-
! Alternative ns-2 trace reader
+
! Synchronized Network Emulation
| Francesco Malandrino || Assigned || [http://www.nsnam.org/bugzilla/show_bug.cgi?id=473 bugzilla] || Mathieu Lacage
+
RWTH Aachen || ns-3.7 version || [http://www.comsys.rwth-aachen.de/projects/slicetime/ project website]  
 
|-
 
|-
! Association and de-association hooks for Wifi
+
! NEMO/MIP simulator
Francesco Malandrino  || Accepted (changeset a21c19c4cd81) || [http://www.nsnam.org/bugzilla/show_bug.cgi?id=487 bugzilla] || Mathieu Lacage
+
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]  
 
|-
 
|-
! Udp echo client modifications
+
! Content Addressable Networks DHT
| CITIC || Unassigned || [http://www.nsnam.org/bugzilla/show_bug.cgi?id=508 bugzilla] || Unassigned
+
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]
 
|-
 
|-
! Underwater acoustic device
+
! Pastry DHT Port
| Leonard Tracy || Being reviewed for ns-3.5 || http://code.nsnam.org/ltracy/ns-3-dev-uan || Craig Dowell
+
Charilaos Papadopoulos || early beta || [http://graphics.cs.aueb.gr/users/papado Personal Website]
 
|-
 
|-
! 802.11n extensions
+
! Access point address manager
| Mirko Banchi || Accepted in early May || http://code.nsnam.org/mirko/ns-3-80211n || Mathieu Lacage
+
Francesco Malandrino || [http://www.nsnam.org/bugzilla/show_bug.cgi?id=471 details] || [http://www.nsnam.org/contributed/ap-address-manager.tar.bz2 Download ap-address-manager.cc/h]
 
|-
 
|-
! 802.11s extensions
+
! Linux namespaces and ns-3
| Kirill || Being reviewed for ns-3.5 || http://forge.wenos.ru/hgprojects/ns3dev/ || Mathieu Lacage
+
Tom Goff || demo code || [http://www.nsnam.org/wiki/index.php/HOWTO_use_Linux_namespaces_with_ns-3 wiki page]
 
|-
 
|-
! zipf distribution
+
! ndnSIM: Named Data Networking (NDN) module for ns-3
| Francesco Malandrino || Assigned || http://www.nsnam.org/bugzilla/show_bug.cgi?id=578 || Michele Weigle
+
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]
 
|}
 
|}
  
== Contributed code not maintained by the project ==
+
== Archived repositories ==
  
{| border=1 cellspacing=0 cellpadding=3
+
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.
  
|+ Contributions
+
* [http://www.nsnam.org/contributed/ns-3-swig.tar.bz2 SWIG bindings for ns-3 (Craig Dowell)]
! Contribution !! Contributor !! Status !! Link 
+
* [http://www.nsnam.org/contributed/ns-3-nam.tar.bz2 nam (ns-2 network animator) for ns-3 (Mathieu Lacage)]
|-
+
* [http://www.nsnam.org/contributed/ns-3-yans.tar.bz2 yans port to ns-3 (Mathieu Lacage)]
! Pastry DHT Port
+
* [http://www.nsnam.org/contributed/ns-3-netlink.tar.bz2 ns-3 netlink sockets (Liu Jian)]
|  Charilaos Papadopoulos || early beta || [http://graphics.cs.aueb.gr/users/papado Personal Website]  
+
* [http://www.nsnam.org/contributed/quagga-porting.tar.bz2 quagga porting (Liu Jian)]
|-
+
* [http://www.nsnam.org/contributed/ns-3-para.tar.bz2 ns-3 parallelized branch (Hagen Paul Pfeifer)]
! NetAnim network animator
+
* [http://www.nsnam.org/contributed/ns-3-para-mpi.tar.bz2 MPI infrastructure (Hagen Paul Pfeifer)]
|  George Riley || Possibly in ns-3.5 || [[NetAnim]]
+
* [http://www.nsnam.org/contributed/ns-3-worker.tar.bz2 worker parallelization (Hagen Paul Pfeifer)]
|}
+
* [http://www.nsnam.org/contributed/ns-3-dev-http.tar.bz2 toy http model (Raj Bhattacharjea)]
 +
* [http://www.nsnam.org/contributed/ns-3-wifi-scanning.tar.bz2 experimental wifi scanning (Gustavo Carneiro)]

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.