Revision as of 15:06, 24 November 2012

This page summarizes the ongoing release planning for ns-3.16. The ns-3 release process is listed here and here.

Release schedule

• Wed Nov 21 -- new feature freeze
  • keeping open for possible BRITE and LTE scheduler inclusion
• Wed Dec 5 -- code freeze on ns-3-dev
• Wed Dec 12 -- ns-3.16 released

Proposed supported platforms

• Linux Ubuntu 12.10
• Linux Fedora 17
• Linux Ubuntu 12.04 LTS
• Ubuntu 10.04.3 LTS
• Mac OS X Mountain Lion 10.8.2
• FreeBSD 9
• FreeBSD 8.2

Packaging

Source tarball ns-allinone-3.16.tar.bz2.

Tarball unpacks to ns-allinone-3.16 which contains, at top level:

  bake          bakefile.xml  build.py  doc       generate-binary.py
  bakeconf.xml  bake.py       examples  source    test 

The source/ directory contains:

 click       netanim        nsc           pybindgen  
 gccxml-ns3  ns-3.16        openflow-ns3  pygccxml

The new user will call 'build.py' which is a wrapper around 'bake.py' and will build all ns-3 components. From that point forward, the user may recurse into the ns-3.16 directory and work from there using ./waf as usual (if all work is ns-3-based and just uses the libraries such nsc and netanim built initially from build.py). If the user wants to work with additional packages (Direct Code Execution), he/she will reconfigure at the bake.py level and download additional components. If the user wants to edit or patch the ns-3 supporting modules (e.g. nsc or netanim) he/she will need to do more work at the bake level.

new feature reviews

merged already

• bake: http://codereview.appspot.com/6761057/
  • Background: http://planete.inria.fr/software/bake/index.html
  • Integration plan: BakeIntegration
  • App Store long-term goal: App Store Technical Requirements

window is still open

• LTE MAC Schedulers by Dizhi Zhou (GSoC 2012): http://codereview.appspot.com/6591047
• BRITE topology generator integration: http://codereview.appspot.com/6499120/

likely sliding to ns-3.17

• Node/NetDevice Start/Stop: http://codereview.appspot.com/6530051/#ps16007
• GSOC code review for HLA interfaces: http://codereview.appspot.com/6458160/
• GSOC code review for NAT and Netfilter: http://codereview.appspot.com/6454146/
• Low resolution radio model: code review
• Brian Panneton's antenna model updates http://mailman.isi.edu/pipermail/ns-developers/2012-April/010322.html
• New IEEE 802.11b indoor wireless channel models for (HMM and BEAR)
• Longley-Rice and ITU terrain-aware propagation models
• TCP Echo Code review here, needs updating
• Finishing ns-3-click-mac extensions -> Blocked by queue API resolution
• Monitor mode support (Update from Bjorn)
• UAN Mobility Model merge (from previous GSOC)
  • blocked on resolving changes to WaypointMobilityModel API
• Switched Ethernet device: http://codereview.appspot.com/5615049/
• HTTP traffic generator: http://codereview.appspot.com/4940041/
• GPSR: http://codereview.appspot.com/5401042
• TMix and Delaybox: http://code.google.com/p/tmix-ns3/

Bugs being worked

Simulation core

Bugs or issues involving things that are not related to protocol or channel models.

• 1237 Code cleanup related to includes Vedran Miletić
• 582 Tags are not serialized and deserialized from Packet::Serialize and Packet::Deserialize Peter Barnes
  • Patchset 1: Add class Hash: generic hash function interface http://codereview.appspot.com/6357056/
  • Patchset 2: Add hashes to TypeId. http://codereview.appspot.com/6344063/
  • Patchset 3: Refactor PacketTagList http://codereview.appspot.com/6354061/
• 938 Doxygen cleanup Vedran Miletić and Tom Henderson
• 1192 Some test cases fail to clean up properly (missing DoTeardown) Claudio Freire
• NetDevice queue feedback Ruben Merz, Frederic Urbani, and Tom Henderson
  • explained here: http://mailman.isi.edu/pipermail/ns-developers/2011-July/009170.html
• Object::Stop patch http://mailman.isi.edu/pipermail/ns-developers/2012-May/010392.html
• FdReader device refactoring (Alina Quereilhac)

Bugs in ns-3 models

Open bugs will be worked on a best-effort basis.