Ns-3.12

Main Page - Roadmap - Summer Projects - Project Ideas - Developer FAQ - Tools - Related Projects

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

This page summarizes the ongoing release planning for ns-3.12. Tom Henderson, John Abraham, and Mitch Watrous will be jointly managing the release.

Proposed release schedule

1. May 25 -- ns-3.11 posted, ns-3.12 open phase begins.
2. Wed Aug 17 -- code freeze on ns-3-dev, ns-3.12 RC1 posted
3. Wed Aug 24 -- ns-3.12 released

Please see Release Process concerning general aspects of the release schedule.

Proposed supported platforms

• Ubuntu 11.04 (32/64 bit)
• Ubuntu 10.04 LTS (64 bit)
• Fedora Core 15 (32/64 bit)
• Mac OS X Lion and Snow Leopard (32 bit)

Packaging

We will use ns-allinone-3.12.tar.bz2 packaging as before.

Contributors can also prepare rpms and debs, but these can occur after the release, and there are some lingering issues regarding these packages:

• rpms for Fedora (Vedran Miletić)
  • discussed here: http://mailman.isi.edu/pipermail/ns-developers/2011-August/009234.html
• debs for Ubuntu/Debian (YunQiang Su)
  • discussed here: http://mailman.isi.edu/pipermail/ns-developers/2011-August/009222.html

Release blockers

None at this time.

New features being considered for ns-3.12

These should be reviewed quickly to see if they can be integrated to this release.

• Dynamic Source Routing (DSR)
• TDMA model
• ObjectMap, to add a map to the attribute system instead of a vector

Bugs being worked

We are trying to close these bugs for this release cycle (no guarantees that we will get them all):

• documentation (Tom)
• documentation (Tom)
• Build OpenSolaris
• Graceful build failure when libraries broken
• Wifi (Ruben) Update RELEASE NOTES
• ConfigStore (Mathieu; patch is pending)
• Packet const methods Wontfix
• variable length array
• variable length array
• path to attributes has bogus entries May be invalid
• Patch UAN module (Andrea)
• TCP Nagle and RTO (Adrian) (also bug 1227 is a duplicate)
• LTE constructor problem (Giuseppe, patch pending)
• DSDV: NULL callback
• multicast > 16 interfaces this just needs verification that it is closed
• variable length array duplicate of 928/929?
• possible UAN bug (Andrea)
• LogComponentEnable() does not provide error handling
• monolithic python bindings (Gustavo) related to 1240
• TCP deadlock (Adrian)
• Netanim compatibility for xcode 4 and wiki updates (John, probably wontfix)
• Energy attribute spelling error (Tony)
• forgot to increment ephemeral port (Adrian)
• IPV4 TCP Bind an already used port failed but without setting errno
• memset used with constant zero length parameter
• ns-3 TCP DCE problems with RST (Adrian)
• BridgeNetDevice: Default ExpirationTime not realistic (Gustavo)
• Implement trivial XML output feature for Animation Interface (John, probably wontfix)
• Valgrind detects memory leaks from Click when using ns-3-click (Ruben and Lalith)
• modules document fails to build
• The auto generated man pages have some error
• Add LTE trace hooks for supporting visualizer (Giuseppe)
• LTE: Add TX/RX trace support (Giuseppe)
• Ipv4Header lacks DSCP and ECN Needs patch
• Some test cases fail to clean up properly (missing DoTeardown) (Mathieu, Claudio)
• attribute path documentation broken (Mitch)
• RvBatteryModel segfalts if the update event happens before load changes (Andrea)
• simple-odfm-wimax-phy creates UniformVariable in a critical path (Flavio)
• Supply a mechanism to build python binding for multi-version of python
• FdReader always stops with NS_FATAL_ERROR (Tom G.)
• Incomplete YansWifiChannel Python bindings
• TCP minRTO too low (Adrian)
• modular build problem
• Multiplication overflow in WaypointMobilityModel::EndMobility method
• code cleanups related to include
• documentation
• Add assertion that reference count never overflows
• remove monolithic python bindings from waf
• documentation

Also, the collection of "set but not used" bugs (such as bugs 1147-1162). Note that the general solution for bug 1170 is still in work.

Also, the collection of RealtimeSimulatorImpl and TapBridge patches (Tom Goff is looking at):

• Simulator::Next useless depends on 631
• RealtimeSimulator and Ctrl-C
• Tap Bridge and Emu Net Devices Do Not Shut Down Properly
• stopping TapBridge
• Make realtime simulator last until stop

Active reviews sliding past ns-3.12

These are not going to complete in time for the ns-3.12 release.

• BRITE Integration
  • under revision
• LTE code from the Lena project
• NetDevice queue feedback
  • explained here: http://mailman.isi.edu/pipermail/ns-developers/2011-July/009170.html
• Animation interface changes (to support XML output)
• Virtual Access Point (VAP) for WiFi
  • needs updated to ns-3.11 code; needs review
• GetRelativeVelocity() for MobilityModel
  • needs review
• PhySimWifi
  • needs review
• thread-safe implementation of ScheduleWithContext
• simple wireless models
• Jamming model
• MPLS
• TCP Vegas (blocked by lack of progress on TCP congestion control architecture)
• RED for ns-3
  • Needs rebased to ns-3-dev; needs test code

ns-3.12 features merged

• IPv4 header Class MinMaxAvgTotalCalculator does not implement all the methods in its interface
• Fragmentation support for IPv4

ns-3.12 bugs fixed

This list needs updating.

• IPv4 header FragmentOffset field
• invalid tests pass

Feature requests

This lists some features that have been requested but for which a patch is needed.

• make spectrum model compatible with ns-3 WiFi
• ns-2 packet UID feature
• API for TOS bytes (issue 897) may wait for netfilter support
• Chord/DHT (authors are planning to revise code based on comments)
• app store and build system refactoring
• fragmentation for IPv4: being worked by Vedran Miletic and Tommaso Pecorella
• TDMA wireless model
  • being worked on by Hemanth Narra
• Netdevice queue state support
  • being worked on by Ruben Merz