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 was released September 17, 2014. New feature code should be ready for merge by no later than 5 September.

Release candidates

A second release candidate (rc2) was posted on Mon. Sept. 15. This became the ns-3.21 release on Sept. 17.

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

• 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()
• rescan bindings

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?

Documentation improvements

• improve documentation on linking ns-3 with other libraries (Tom Henderson)
  • Deferring to ns-3.22
• Wifi documentation patch from Sebastien Deronne (Daniel L) merged
• Fix tutorial first.cc and documentation to explicitly call out the need for StopApplication() (Tommaso and/or Tom) Merged (documentation only)