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. Thu Aug 18 -- code freeze on ns-3-dev, ns-3.12 RC1 posted
3. Wed Aug 24 -- ns-3.12 released (Note: Date slipped until bug 1251 is fixed)

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.

Bugs being worked

The following bugs (strike-through text below) were addressed during the last week of changes to ns-3.12:

• 272 documentation (Tom)
• 388 documentation (Tom)
• 707 Build OpenSolaris
• 756 Graceful build failure when libraries broken
• 827 Wifi (Ruben) Update RELEASE NOTES
• 845 ConfigStore (Mathieu; patch is pending)
• 904 Packet const methods Wontfix
• 928 variable length array
• 929 variable length array
• 962 path to attributes has bogus entries May be invalid
• 1010 Patch UAN module (Andrea)
• 1039 TCP Nagle and RTO (Adrian) (also bug 1227 is a duplicate)
• 1043 LTE constructor problem (Giuseppe, patch pending)
• 1046 DSDV: NULL callback
• 1047 multicast > 16 interfaces
• 1050 variable length array duplicate of 928/929?
• 1055 possible UAN bug (Andrea)
• 1082 LogComponentEnable() does not provide error handling
• 1107 monolithic python bindings (Gustavo) related to 1240
• 1112 TCP deadlock (Adrian)
• 1127 Netanim compatibility for xcode 4 and wiki updates (John, probably wontfix)
• 1134 Energy attribute spelling error (Tony)
• 1163 forgot to increment ephemeral port (John)
• 1164 IPV4 TCP Bind an already used port failed but without setting errno
• 1166 ns-3 TCP DCE problems with RST (Adrian)
• 1168 BridgeNetDevice: Default ExpirationTime not realistic (Gustavo)
• 1172 Implement trivial XML output feature for Animation Interface (John, probably wontfix)
• 1173 Valgrind detects memory leaks from Click when using ns-3-click (Ruben and Lalith)
• 1176 modules document fails to build
• 1177 The auto generated man pages have some error
• 1179 Add LTE trace hooks for supporting visualizer (Giuseppe)
• 1180 LTE: Add TX/RX trace support (Giuseppe)
• 1186 Ipv4Header lacks DSCP and ECN Needs patch
• 1192 Some test cases fail to clean up properly (missing DoTeardown) (Mathieu, Claudio)
• 1212 attribute path documentation broken (Mitch)
• 1216 RvBatteryModel segfalts if the update event happens before load changes (Andrea)
• 1217 simple-odfm-wimax-phy creates UniformVariable in a critical path (Flavio)
• 1218 Supply a mechanism to build python binding for multi-version of python
• 1220 FdReader always stops with NS_FATAL_ERROR (Tom G.)
• 1226 Incomplete YansWifiChannel Python bindings
• 1227 TCP minRTO too low (Adrian)
• 1228 modular build problem
• 1229 Multiplication overflow in WaypointMobilityModel::EndMobility method
• 1237 code cleanups related to include
• 1238 documentation
• 1239 Add assertion that reference count never overflows
• 1240 remove monolithic python bindings from waf
• 1241 documentation
• 1243 Exiting waf shell should not generate report on what modules are built
• 1246 config store needs examples and tests
• 1247 waf --enable-shared-and-static

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 did not complete in time for ns-3.12.

• Dynamic Source Routing (DSR)
• TDMA model
• 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
• ObjectMap, to add a map to the attribute system instead of a vector

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