Ns-3.21

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 release planning for ns-3.21. The ns-3 release process is listed here and here.

The release manager is Tom Henderson.

Release schedule

ns-3.21 is planned for September 17, 2014. New feature code should be ready for merge by no later than 5 September. An initial release candidate should be available by 12 September.

Release candidates

The first release candidate (rc1) was posted on Sept. 13. While this is considered to be nearly final and complete, the following minor issues are being addressed:

• platform-specific (OS X) issue with one of the LTE tests
• need more robust way for including fd-net-device module in LTE wscript (for FreeBSD)
• formatting the new CoDel chapter in the model library documentation
• add some documentation to the ns-3 tutorial regarding Simulator::Stop()

A second release candidate is planned for Mon. Sept 15.

Packaging

ns-3.21 will be packaged as a source tarball as before: ns-allinone-3.21.tar.bz2.

The tarball will contain:

• Latest version of pybindgen
• Latest version of netanim
• ns-3.21
• bake

where bake is used to fetch optional ns-3 components, including DCE.

A patch from ns-3.20 to ns-3.21 will also be posted.

Release platforms

We usually try to keep pace with the latest popular versions of Linux, OS X, and FreeBSD. For the ns-3.21 release, we plan to support the following systems and compilers:

• OS X 10.9 Mavericks with Xcode 5.1
• Ubuntu 14.04 (gcc-4.8)
• Fedora 20 (gcc-4.8)
• Debian 7 (gcc-4.9)
• Ubuntu 10.04 LTS (gcc-4.4)
• Ubuntu 12.04 LTS (gcc-4.6)
• Centos 6.4 (gcc-4.4)
• FreeBSD 9.3 (clang 3.3)

New features

Pending new features:

• Self-Delimiting Numeric Values (https://codereview.appspot.com/97540043/)
  • Update: Slipping to ns-3.22
• TCP options code from SOCIS TCP project (including window scale and timestamps)
  • Code review issue: https://codereview.appspot.com/110860043/
  • Update: A repo (http://code.nsnam.org/repositories/tomh/ns-3-dev-tcp-options-for-merge) is staged for final review; a few minor issues are being worked out for Friday Merged
  • RttEstimator improvements will slip until ns-3.22
• (enhancement) Add propagation delay capability to SimpleChannel (for testing purposes)
  • code review issue: https://codereview.appspot.com/132870043/ Merged
• CoDel queue support (from GSoC bufferbloat project)
  • Update: A repo (http://code.nsnam.org/repositories/tomh/ns-3-dev-codel-for-merge) is staged for final review Merged
  • FQ-CoDel and SFQ-CoDel will slip until ns-3.22
• Energy harvesting model
  • Code review issue: https://codereview.appspot.com/103750047/
  • Update: Cristiano has updated this and it appears ready for merging Merged
• LTE FFR models from GSoC project
  • Code review issue: https://codereview.appspot.com/130130043/
  • Update: Piotr has created a staging repo for final merge: http://code.nsnam.org/pgawlowicz/ns-3-dev/ Merged

WiFi-related:

• Wifi Sleep mode
  • Update: Stefano has created a final patch (emailed offlist), ready for merge with Cristiano's energy harvesting patch Merged
• MPDU aggregation
  • Will slip to ns-3.22
• new VANET example
  • Update: Not yet ready for merge, may slip to ns-3.22

Software maintenance issues

• Remove emu module from codebase (1945) (Tom Henderson)
  • Slipping this to ns-3.22
• Mesh test crashes for certain configurations
  • There is likely not enough time to finish this off before release
• Time arithmetic consistency
  • There is likely not enough time to finish this off before release
• Wstrict-overflow and gcc-4.9 (Tom Henderson and Peter Barnes)
  • slipping to ns-3.22
• Remove unnecessary dependency on Application module in other modules (1941) Tommaso Pecorella
  • Depends on merging of simple applications https://codereview.appspot.com/45320043 merged
  • Cleanup of remaining modules dependent on applications (aodv, mesh, olsr, lte) will slip to 3.22

Bugs or issues in ns-3 core

• Command line argument handling (1972) Peter Barnes (patch in bugzilla)
• GetInteger off-by-one (1964) Peter Barnes and Tom Henderson
• RandomVariableStream::GetStream returns -1 for all automatically assigned streams (1962) Peter Barnes
• Config::Path not parsed correctly (1959) Tom Henderson
• L4 protocol sockets should support BindToNetDevice over IPv6 (1824) Tommaso Pecorella - waiting comments
• AODV can not work on nodes with more than one NetDevice (1911) Tommaso Pecorella - waiting comments

Also Possible

• Close Changing the simulation time resolution does not work well with attributes (954) ?
• Apply patch for Storage of the log name in LogComponent (1652) ? duplicate of 1662, already merged
• Close feature request: non-doxygen trace source introspection program needed with status Resolved?

Bugs in models being worked by someone

TBD

Documentation improvements

• improve documentation on linking ns-3 with other libraries (Tom Henderson)
  • Not likely to be fully fixed for ns-3.21 but may take a stab at this, time permitting
• Wifi documentation patch from Sebastien Deronne (Daniel L)
• Fix tutorial first.cc and documentation to explicitly call out the need for StopApplication() (Tommaso and/or Tom)