|
|
(10 intermediate revisions by the same user not shown) |
Line 2: |
Line 2: |
| | | |
| This page summarizes the release planning for ns-3.22. The ns-3 release process is listed [http://www.nsnam.org/developers/release-process/ here] and [[Release Process | here]]. | | This page summarizes the release planning for ns-3.22. The ns-3 release process is listed [http://www.nsnam.org/developers/release-process/ here] and [[Release Process | here]]. |
| + | |
| + | * Release candidate 1: http://www.nsnam.org/release/ns-allinone-3.22.rc1.tar.bz2 |
| | | |
| = How you can help = | | = How you can help = |
Line 24: |
Line 26: |
| = Release and development schedule = | | = Release and development schedule = |
| | | |
− | ns-3.22 is planned for early February 2015. | + | ns-3.22 is planned for early February 2015. An initial release candidate is available for testing: |
| | | |
− | Already done items:
| + | * http://www.nsnam.org/release/ns-allinone-3.22.rc1.tar.bz2 |
| | | |
− | * <s>Implementation for documenting TracedValue and TracedCallback signatures.</s>
| + | = Packaging = |
− | * <s>patches from [https://www.nsnam.org/bugzilla/show_bug.cgi?id=938 938] Doxygen sprint</s>
| + | |
− | * <s>UdpSocketImpl patch; bug [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1957 1957]</s>
| + | |
− | * <s>HOWTO documentation update [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1343 1343]</s>
| + | |
− | * <s>Remove deprecated code [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1945 (bug 1945)]</s>
| + | |
− | ** <s>Described in: http://mailman.isi.edu/pipermail/ns-developers/2014-September/012296.html</s>
| + | |
− | * <s>Patch stats data collection module: bugs [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1997 1997] and [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1998 1998]</s>
| + | |
− | * 802.11n patches from Sebastien Derrone
| + | |
− | ** <s>[https://www.nsnam.org/bugzilla/show_bug.cgi?id=1968 1968]</s>
| + | |
− | ** <s>[https://www.nsnam.org/bugzilla/show_bug.cgi?id=1970 1970]</s>
| + | |
− | * <s>upgrade waf from 1.7.13 to 1.7.16</s>
| + | |
− | * <s>[https://www.nsnam.org/bugzilla/show_bug.cgi?id=1791 bug 1791], Tcp socket never deallocates when closing</s>
| + | |
− | * 802.11n patches from Sebastien Derrone
| + | |
− | ** <s>[https://www.nsnam.org/bugzilla/show_bug.cgi?id=1971 1971]</s>
| + | |
− | * <s>build.py documentation [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1326 1326]</s>
| + | |
− | * <s>remove redefinition of PI, use M_PI [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1995 1995]</s>
| + | |
− | * <s>Wifi configure 802.11n patch [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1906 bug 1906]</s>
| + | |
− | * <s>Minstrel patch: https://codereview.appspot.com/59710043/ (also fixes [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1726 bug 1726] and [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1989 bug 1989])</s>
| + | |
− | * <s>Fix waf --enable-gcov option [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1583 bug 1583]</s>
| + | |
− | * <s>Radvd do not consider the SendAdvert option and don't reply to RS [https://www.nsnam.org/bugzilla/show_bug.cgi?id=2016 bug 2016]</s>
| + | |
− | * <s>802.11n error rates [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1758 bug 1758]</s>
| + | |
− | * <s>Erroneous MCS field for 802.11n [https://www.nsnam.org/bugzilla/show_bug.cgi?id=2020 bug 2020]</s>
| + | |
− | * <s>add Packet::ToString() [https://www.nsnam.org/bugzilla/show_bug.cgi?id=2019 bug 2019]</s>
| + | |
− | * 802.11n patches from Sebastien Derrone
| + | |
− | ** <s>[https://www.nsnam.org/bugzilla/show_bug.cgi?id=1969 1969]</s>
| + | |
− | ** <s>[https://www.nsnam.org/bugzilla/show_bug.cgi?id=2026 2026]</s>
| + | |
− | ** <s>[https://www.nsnam.org/bugzilla/show_bug.cgi?id=2027 2027]</s>
| + | |
− | * <s>test result divergence for lte-frequency-reuse [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1986 bug 1986]</s>
| + | |
− | * <s>new CQI generation approach fix [https://www.nsnam.org/bugzilla/show_bug.cgi?id=2029 bug 2029]</s>
| + | |
− | * <s>WifiTxVector initialization [https://www.nsnam.org/bugzilla/show_bug.cgi?id=2030 bug 2030]</s>
| + | |
− | * <s>[https://www.nsnam.org/bugzilla/show_bug.cgi?id=1770 1770] mesh tests/examples crashing</s>
| + | |
− | | + | |
− | Some upcoming plans:
| + | |
− | | + | |
− | == week of January 19 ==
| + | |
− | | + | |
− | Try to complete new feature merges by Friday Jan 23.
| + | |
− | | + | |
− | ''Tentative'' list of additional features for this release:
| + | |
− | | + | |
− | 1) Wifi changes
| + | |
− | | + | |
− | There is a combined testing repo at http://code.nsnam.org/tomh/ns-3-dev-wifi-all that includes the following four features:
| + | |
− | * Wifi MPDU aggregation
| + | |
− | **'''Status''': testing repository for just this feature is available at http://code.nsnam.org/sderonne/a-mpdu-dev
| + | |
− | * VANET routing comparison script and WAVE BSM application
| + | |
− | **'''Status''': testing repository for just WAVE code is available at http://code.nsnam.org/tomh/ns-3-dev-wave
| + | |
− | * 1609.4 WAVE code
| + | |
− | **'''Status''': testing repository for just WAVE code is available at http://code.nsnam.org/tomh/ns-3-dev-wave
| + | |
− | * New Wifi power and rate control algorithms
| + | |
− | **'''Status''': testing repository for just this feature is available at http://code.nsnam.org/tomh/ns-3-dev-wifi-rate-control
| + | |
− | | + | |
− | 2) TV transmitter model
| + | |
− | | + | |
− | '''Status''': testing repository available at http://code.nsnam.org/tomh/ns-3-dev-tv-transmitter
| + | |
− | | + | |
− | The following features are not yet complete (code seems mostly complete, but is lacking complete tests/examples/documentation):
| + | |
− | | + | |
− | * Full duplex CSMA
| + | |
− | * TCP satellite extensions
| + | |
− | | + | |
− | == week of January 26 ==
| + | |
− | | + | |
− | Try to complete any bug fixes and core improvements by Friday Jan 30.
| + | |
− | | + | |
− | The following bugs/enhancements are being currently worked on, I believe:
| + | |
− | | + | |
− | * NixVector routing performance improvements
| + | |
− | * 2043 (doxygen)
| + | |
− | * 2041 (TCP RTO)
| + | |
− | * 2042 (gcc-4.9 compilation)
| + | |
− | * 1604 (GetDefault)
| + | |
− | * 1774 (wpan) patch pending
| + | |
− | * 1726 (minstrel) patch pending
| + | |
− | * 1801 (wifi attribute setting)
| + | |
− | * 2002 (core)
| + | |
− | * 761 (wifi) non standards compliant timeout values
| + | |
− | * 1726 (minstrel segfault)
| + | |
− | * Natale's test macros: https://codereview.appspot.com/137770043
| + | |
− | * src/core Doxygen warnings (Peter)
| + | |
− | * Python 3 support for our wscripts
| + | |
− | | + | |
− | = Packaging = | + | |
| | | |
| ns-3.22 will be packaged as a source tarball as before: ns-allinone-3.22.tar.bz2. | | ns-3.22 will be packaged as a source tarball as before: ns-allinone-3.22.tar.bz2. |
Line 142: |
Line 62: |
| = Testing repos = | | = Testing repos = |
| | | |
− | Some repositories, based on a recent copy of ns-3-dev, are available for testing specific features. | + | Some repositories, based on a recent copy of ns-3-dev, are available for testing specific features. '''Note:''' the below two features have slipped to ns-3.23. |
− | | + | |
− | == WAVE and vehicular networks ==
| + | |
− | | + | |
− | A repository to test [[Ns-3.22#Vehicular_networks | 1609.4 WAVE code and vanet-routing-compare example]] features is available here:
| + | |
− | * hg clone http://code.nsnam.org/tomh/ns-3-dev-wave
| + | |
− | * once built, you can run these new examples:
| + | |
− | <nowiki>
| + | |
− | $ ./waf --run vanet-routing-compare
| + | |
− | $ ./waf --run wave=simple-device
| + | |
− | $ ./test.py -s wave-mac-extension
| + | |
− | </nowiki>
| + | |
| | | |
| == Mobility Service Interface == | | == Mobility Service Interface == |
Line 175: |
Line 84: |
| hg clone http://code.nsnam.org/tomh/ns-3-dev-csmafd | | hg clone http://code.nsnam.org/tomh/ns-3-dev-csmafd |
| </pre> | | </pre> |
− |
| |
− | == MPDU aggregation ==
| |
− |
| |
− | Sebastien Deronne is working on preparing a testing repository; should be available shortly.
| |
| | | |
| = New features = | | = 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.
| + | No further features are planned. Check the [http://code.nsnam.org/ns-3-dev/file/2ebe49d34182/RELEASE_NOTES release notes] for a list of changes found in ns-3.22. |
− | | + | |
− | === Changes to the simulation core ===
| + | |
− | | + | |
− | Higher priority:
| + | |
− | * [[Python3_Project | Python 3 support]] (Siddharth Sankurdar)
| + | |
− | ** '''Synopsis:''' ns-3 is Python 2 based, and must be upgraded to support both Python 2 and 3
| + | |
− | ** '''Status:''' This is progressing well and should soon be ready. Details are at: https://bitbucket.org/ssanturkar/ns-3-python-port
| + | |
− | * Shared RngStream (Peter Barnes)
| + | |
− | ** '''Synopsis:''' Add API to allow multiple random variables to share an underlying RNG stream
| + | |
− | ** https://codereview.appspot.com/114060043/
| + | |
− | ** '''Status:''' No change recently.
| + | |
− | | + | |
− | Lower priority:
| + | |
− | * Discuss changes due to Object Start/Stop discussion held at [http://www.nsnam.org/docs/meetings/ns-3-developer-meeting-notes-May14.pdf May developers meeting].
| + | |
− | ** This will slip until ns-3.23 release cycle.
| + | |
− | * Changes to better support [[Ns-3_on_Visual_Studio_2012 | ns-3 on Windows Visual Studio]]
| + | |
− | ** https://codereview.appspot.com/8932044/
| + | |
− | ** This will 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
| + | |
− | ** '''Status:''' Still under development.
| + | |
− | | + | |
− | === Internet module ===
| + | |
− | | + | |
− | * An implementation of MLDv2 for IPv6 (Krishna Teja Yadavalli and Tommaso Pecorella)
| + | |
− | ** http://www.nsnam.org/wiki/GSOC2014MulticastIPv6
| + | |
− | ** https://codereview.appspot.com/121680043/
| + | |
− | | + | |
− | 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
| + | |
− | | + | |
− | '''Status:''' Tom Henderson is working on progressing the idea to add a TC sublayer, socialized by Natale Patriciello on the ns-developers list here: http://mailman.isi.edu/pipermail/ns-developers/2014-November/012398.html
| + | |
− | | + | |
− | === TCP ===
| + | |
− | | + | |
− | * TCP variants for satellite networks (Natale Patriciello)
| + | |
− | ** https://codereview.appspot.com/122010043/
| + | |
− | | + | |
− | The following were mentioned in the past but don't seem to be actively worked at the moment:
| + | |
− | * RttEstimator improvements (Natale Patriciello)
| + | |
− | * Multipath TCP ([mailto:M.Kheirkhah@sussex.ac.uk Morteza Kheirkhah Sabetghadam])
| + | |
− | | + | |
− | === WiFi ===
| + | |
− | | + | |
− | * MPDU aggregation for 802.11n ([mailto:sebastien.deronne@gmail.com Sebastien Deronne] and [mailto:gbadawy@gmail.com Ghada Badawy], and others)
| + | |
− | ** https://codereview.appspot.com/164020043 (replacing previous review at https://codereview.appspot.com/14549044/)
| + | |
− | ** '''Status:''' Sebastien Deronne will soon post a testing repository for this feature.
| + | |
− | * New power and rate control algorithms
| + | |
− | ** https://codereview.appspot.com/119130043
| + | |
− | ** '''Status:''' No change since code review.
| + | |
− | | + | |
− | === Vehicular networks ===
| + | |
− | | + | |
− | '''status:''' There is a 'testing repository' available to test Scott's example and Junling's WAVE code; see [[Ns-3.22#Testing_repos]].
| + | |
− | | + | |
− | * WAVE for 802.11 vehicular networks (Scott Carpenter and Junling Bu)
| + | |
− | ** Finish off the 2013 GSoC code merging
| + | |
− | * VANET example (Scott Carpenter)
| + | |
− | ** https://codereview.appspot.com/103470050/
| + | |
− | * [[RoutesMobilityModel | Routes Mobility Model]] (Tiago Cerqueira)
| + | |
− | | + | |
− | === Delay-tolerant networking ===
| + | |
− | | + | |
− | * Self-Delimiting Numeric Values (Dizhi Zhou and Ruben Martinez)
| + | |
− | ** https://codereview.appspot.com/97540043/
| + | |
− | * Licklider Transport Protocol (Ruben Martinez)
| + | |
− | * Bundle Protocol from SOCIS 2013 (Dizhi Zhou)
| + | |
− | | + | |
− | '''Status:''' No recent activity; will likely slip another release cycle.
| + | |
− | | + | |
− | === DSR ===
| + | |
− | | + | |
− | * LEAR extensions https://codereview.appspot.com/96130043/
| + | |
− | '''Status:''' Tomasz is working on addressing the review comments
| + | |
− | | + | |
− | === CSMA improvements ===
| + | |
− | * Full duplex mode proposal: https://codereview.appspot.com/187880044/
| + | |
− | * Bug fixes in half-duplex mode: https://codereview.appspot.com/109450044/ (Mehdi Moussouni)
| + | |
− | | + | |
− | '''Status:''' Tom Henderson posted a testing repository for the full duplex feature.
| + | |
− | | + | |
− | === Epidemic Routing ===
| + | |
− | * https://codereview.appspot.com/13831049/
| + | |
− | | + | |
− | '''Status:''' Still undergoing code review revisions.
| + | |
− | | + | |
− | === UAN WOSS ===
| + | |
− | * https://codereview.appspot.com/14677043/
| + | |
− | | + | |
− | === Satellite models ===
| + | |
− | * http://mailman.isi.edu/pipermail/ns-developers/2014-June/012071.html
| + | |
− | | + | |
− | '''Status:''' There hasn't been any recent activity so this will likely slip another release
| + | |
− | | + | |
− | === Spectrum module ===
| + | |
− | | + | |
− | * TV transmitter module
| + | |
− | ** code review issue: https://codereview.appspot.com/148810043/
| + | |
− | '''Status:''' Seems to be nearing completion; needs review from Nicola.
| + | |
− | | + | |
− | === Nix vector routing ===
| + | |
− | | + | |
− | * Performance improvements
| + | |
− | ** code review issue: https://codereview.appspot.com/183600043
| + | |
− | '''Status:''' under review
| + | |
− | | + | |
− | == Software maintenance issues ==
| + | |
− | * <s>[https://www.nsnam.org/bugzilla/show_bug.cgi?id=1945 Remove emu module from codebase (1945)] (Tom Henderson)</s>
| + | |
− | * <s>[https://www.nsnam.org/bugzilla/show_bug.cgi?id=1770 Mesh test crashes for certain configurations]</s>
| + | |
− | * [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1900 Time arithmetic consistency]
| + | |
− | * [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1868 Wstrict-overflow and gcc-4.9] (Tom Henderson and Peter Barnes)
| + | |
− | * [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1941 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 ==
| + | |
− | * [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1490 improve documentation on linking ns-3 with other libraries] (Tom Henderson)
| + | |
− | | + | |
− | ''others to be determined''
| + | |
− | | + | |
− | == Bugs or issues in ns-3 core ==
| + | |
− | | + | |
− | * [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1962 RandomVariableStream::GetStream returns -1 for all automatically assigned streams (1962)] Peter Barnes
| + | |
− | * Close [https://www.nsnam.org/bugzilla/show_bug.cgi?id=954 Changing the simulation time resolution does not work well with attributes (954)] ?
| + | |
− | * Close [https://www.nsnam.org/bugzilla/show_bug.cgi?id=764 feature request: non-doxygen trace source introspection program needed] with status Resolved?
| + | |
− | | + | |
− | == Bugs in models to fix ==
| + | |
− | | + | |
− | '' To be determined ''
| + | |
This page summarizes the release planning for ns-3.22. The ns-3 release process is listed here and here.
If you are interested in testing a particular feature that is planned for ns-3.22, see the section on this page for testing repos.
If you are interested in helping with a code review of a specific feature that you'd like to see in ns-3.22, please leave your comments on the code review pertaining to the feature of interest.
If you are interested to see that a specific bug be fixed, please email ns-developers mailing list, or the release manager. You will probably be asked to help with creating a patch or testing an existing patch for that bug, if so.
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
ns-3.22 is planned for early February 2015. An initial release candidate is available for testing:
ns-3.22 will be packaged as a source tarball as before: ns-allinone-3.22.tar.bz2.
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) would require a volunteer to prepare this.
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:
Some repositories, based on a recent copy of ns-3-dev, are available for testing specific features. Note: the below two features have slipped to ns-3.23.
Tiago Cerqueria has posted some code that uses Google Maps and Directions API to fetch waypoints for the ns-3 waypoint mobility model, corresponding to real-world routes provided by the service. There is a testing repository available for this code (the patchset in https://codereview.appspot.com/176430044/ is too large to download from Rietveld). To test, one must obtain an API key from Google, as described in the code review issue. One must also have installed GeographicLib, xerces-cpp, libcurl, and libdl.