Ns-3.22
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.22. The ns-3 release process is listed here and here.
The release manager is Tom Henderson. Please contact him if you would like to participate in any way in preparing the ns-3.22 release.
Release goals
1) make a major dent in the bug tracker. Can we clean out most issues on our actively maintained modules, including closing out feature requests for which we do not have anyone working on them?
2) continue the transition to a more modular build system. While a major change to the build system is not planned for ns-3.22, one goal is to start to allow modules outside the core of ns-3 to be maintained in separate places, and integrated using the 'bake' tool (rather than merge everything into ns-3-dev).
3) merge (into ns-3-dev or to a bake-enabled repository) as many new features as we can get ready, including all remaining features from 2013 and 2014 GSOC and SOCIS projects, and 2014 summer projects
Release and development schedule
ns-3.22 is planned for mid-January, 2015. ns-3 makes roughly three releases per year (Dec/Jan, Apr/May, and Aug/Sept timeframes).
This means that we ought to get most new features and major changes into the simulator by early December.
Some scheduled events are listed below.
week of Sept. 29, 2014
Implementation for documenting TracedValue and TracedCallback signatures.patches from 938 Doxygen sprint
week of October 6, 2014
week of October 13, 2014
Remove deprecated code (bug 1945)Patch stats data collection module: bugs 1997 and 1998
week of October 20, 2014
upgrade waf from 1.7.13 to 1.7.16
week of October 27 (or later)
week of Nov 1 (or later)
build.py documentation 1326- remove redefinition of PI, use M_PI 1995
- Minstrel patch: https://codereview.appspot.com/59710043/ (also fixes bug 1726)
- Wifi configure 802.11n patch bug 1906
- deheader ns-3 1832
- note, this may take some time to work through and test the large patch
- enable Wstrict-overflow=5 for gcc versions > 4.8.2 bug 1868
Packaging
ns-3.22 will be packaged as a source tarball as before: ns-allinone-3.22.tar.bz2.
The tarball will contain:
- Latest version of pybindgen
- Latest version of netanim
- ns-3.22
- bake
where bake is used to fetch optional ns-3 components, including DCE.
A patch from ns-3.21 to ns-3.22 will also be posted.
Whether ns-3.22 is prepared in other packaging (e.g. Debian) is to be determined.
Whether ns-3.22 will be distributed also as a Docker container is to be determined.
Release platforms
We usually try to keep pace with the latest popular versions of Linux, OS X, and FreeBSD. For the ns-3.22 release, we plan to support the following systems and compilers:
- OS X 10.10 Yosemite with latest Xcode
- Ubuntu 14.04 and 14.10 (gcc-4.8, 4.9)
- Fedora 20 and 21 (gcc-4.8, 4.9)
- Debian 7 (gcc-4.9)
- FreeBSD 10.1 (clang 3)
- some legacy platforms (to be determined); likely older Ubuntu LTS and CentOS systems, and OS X 10.9
New features
Developers are working or planning to work on the following new features for ns-3.22. Note: there is no guarantee that the features will be finished by the end of the year, so check back for progress/status.
Changes to the simulation core
Higher priority:
- Python 3 support (Siddharth Sankurdar)
- Synopsis: ns-3 is Python 2 based, and must be upgraded to support both Python 2 and 3
- Shared RngStream (Peter Barnes)
- Synopsis: Add API to allow multiple random variables to share an underlying RNG stream
- https://codereview.appspot.com/114060043/
Lower priority:
- Discuss changes due to Object Start/Stop discussion held at May developers meeting.
- This will likely slip until ns-3.23 release cycle.
- Changes to better support ns-3 on Windows Visual Studio
- https://codereview.appspot.com/8932044/
- This may slip until ns-3.23 release cycle.
Others to be determined
Statistics
- Add a basic statistics collector, and convert some existing stats helpers in LTE and WiFi to use the statistics framework (Tom Henderson and Li Li)
- A staging repository (containing the BasicStatsCollector and other collector types) is being kept at http://code.nsnam.org/safe/ns-3.21-collector
Internet module
- An implementation of MLDv2 for IPv6 (Krishna Teja Yadavalli and Tommaso Pecorella)
A number of changes relate to supporting AQM and ECN. This code may end up in the internet module or a new 'internet-queues' module.
- Move RED queue from network module to internet module
- pfifo_fast queue module
- Some code (lacking IPv6 support, and Sphinx documentation) is staged here: http://code.nsnam.org/tomh/ns-3-dev-aqm/rev/4e1543dc9d68
- Explicit Congestion Notification
- Brian Swenson started to implement it here: http://code.nsnam.org/brian/ns-3-dev/diff/a9858c40b539/src/internet/model/red-queue.cc
- FQ-Codel and SFQ-Codel models (Anh Nguyen and Dave Taht)
- http://www.nsnam.org/wiki/GSOC2014Bufferbloat
- This will require some refactoring to allow AQM queues that need access to the IP and transport headers to get access at the layer at which ns3::Queue operates
TCP
- TCP variants for satellite networks (Natale Patriciello)
The following were mentioned in the past but don't seem to be actively worked at the moment:
- RttEstimator improvements (Natale Patriciello)
- Multipath TCP (Morteza Kheirkhah Sabetghadam)
WiFi
- MPDU aggregation for 802.11n (Sebastien Deronne and Ghada Badawy, and others)
- https://codereview.appspot.com/164020043 (replacing previous review at https://codereview.appspot.com/14549044/)
Vehicular networks
- WAVE for 802.11 vehicular networks (Scott Carpenter and Junling Bu)
- Finish off the 2013 GSoC code merging
- VANET example (Scott Carpenter)
- Routes Mobility Model (Tiago Cerqueira)
Delay-tolerant networking
- Self-Delimiting Numeric Values (Dizhi Zhou and Ruben Martinez)
- Licklider Transport Protocol (Ruben Martinez)
- Bundle Protocol from SOCIS 2013 (Dizhi Zhou)
DSR
- LEAR extensions https://codereview.appspot.com/96130043/
CSMA improvements =
- https://codereview.appspot.com/109450044/ (Mehdi Moussouni)
Epidemic Routing
UAN WOSS
Satellite models
Software maintenance issues
Remove emu module from codebase (1945) (Tom Henderson)- Mesh test crashes for certain configurations
- Time arithmetic consistency
- Wstrict-overflow and gcc-4.9 (Tom Henderson and Peter Barnes)
- Remove unnecessary dependency on Application module in other modules (1941) Tommaso Pecorella
- Cleanup of remaining modules unnecessarily dependent on applications (aodv, mesh, olsr, lte)
Documentation improvements
- improve documentation on linking ns-3 with other libraries (Tom Henderson)
others to be determined
Bugs or issues in ns-3 core
- RandomVariableStream::GetStream returns -1 for all automatically assigned streams (1962) Peter Barnes
- Close Changing the simulation time resolution does not work well with attributes (954) ?
- Close feature request: non-doxygen trace source introspection program needed with status Resolved?
Bugs in models to fix
To be determined