Difference between revisions of "Ns-3.26"

From Nsnam
Jump to: navigation, search
(→‎Release and development schedule)
(update for ns-3.26)
Line 1: Line 1:
 
{{TOC}}
 
{{TOC}}
  
−
This page summarizes the release planning for ns-3.26 (planned for June 2016; rescheduled to early July 2016).  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.26 (originally planned for June 2016; rescheduled to July 2016).  The ns-3 release process is listed [http://www.nsnam.org/developers/release-process/ here] and [[Release Process | here]].
  
−
= Release goals =
+
This page has been recently revised and some original goals for ns-3.26 have slipped to a new [[ns-3.27]] page.
  
−
The following goals have been identified by maintainers.
+
= Schedule =
  
−
== Build system ==
+
The revised schedule is as follows:
  
−
* <s>Upgrade Waf and bake build systems according to [[BakeIntegration | this functional specification for supporting contributed code]]</s> <i>Deferred to post-ns-3.26; no Waf changes are anticipated in the initial phase.</i>
+
* July 15:  Merge any remaining new features
 +
* July 22:  Code freeze
 +
* around July 25:  Release
 +
 
 +
= Remaining new features =
 +
 
 +
Maintainers are working on finalizing the following new features:
 +
 
 +
== Wifi ==
 +
 
 +
* Introduce WiFi QoS support (https://codereview.appspot.com/302880043/)  (Stefano Avallone)
 +
** Status:  Finalizing reviews; expected to add shortly
 +
* 802.11e TXOP (https://codereview.appspot.com/293190043/) (Sebastien Deronne)
 +
** Status:  needs to follow the QoS in WiFi patch
 +
* RRPAA rate control (https://codereview.appspot.com/254440043/) (Matias Richart)
 +
** Status:  finalize review comments/questions
 +
* SpectrumWifiPhy (https://codereview.appspot.com/293380043/) (Tom Henderson)
 +
** Status:  Sebastien asked for code de-duplication with YansWifiPhy
 +
* Wi-Fi scanning support (https://www.nsnam.org/bugzilla/show_bug.cgi?id=2399) (Tom Henderson)
 +
** Status:  Need to add an example
 +
 
 +
== traffic-control module ==
 +
 
 +
Stefano Avallone (stavallo@unina.it) is leading ns-3.26 development for traffic control, and has the following remaining goals:
 +
 
 +
* Add support for Byte Queue Limits (see bug 2428)
 +
* porting and polishing fq-codel (see bug 2430)
 +
* reviewing [https://www.nsnam.org/bugzilla/show_bug.cgi?id=2261 PIE contribution] (in progress)
 +
* introduce mq (a multi-queue queue disc configured by default on wifi, along with fq-codel)
 +
 
 +
== ns-3 core ==
 +
 
 +
* Support DES metrics (https://codereview.appspot.com/301230043/) (Peter Barnes)
 +
** Status:  Awaiting initial review
 +
 
 +
== TCP ==
 +
 
 +
* Hamilton TCP (http://mailman.isi.edu/pipermail/ns-developers/2016-April/013541.html) (Natale Patriciello)
 +
** Status:  Natale asked to finalize this review.
 +
 
 +
TCP SACK (https://codereview.appspot.com/299130043/) is proposed to be held for merging to ns-3-dev just after ns-3.26 is released.
 +
 
 +
== applications ==
 +
 
 +
* Trace replay application (https://codereview.appspot.com/289550043/) (Tommaso Pecorella)
 +
** Status:  Needs final review
 +
 
 +
== UAN ==
 +
 
 +
* UAN Raw application (https://www.nsnam.org/bugzilla/show_bug.cgi?id=2410)
 +
** Status:  needs final review
 +
 
 +
= Bug fixing =
 +
 
 +
These will be largely handled in the bug tracker and we will handle as many as possible in the time remaining.
  
 
== ns-3 core ==
 
== ns-3 core ==
Line 31: Line 85:
 
== network module ==
 
== network module ==
  
−
There are a large number of patches pending on the Packet class and its friends; Tom H intends to work through them with Mathieu and with patch contributors.
+
There are a large number of patches pending on the Packet classes. This proposal was made recently on ns-developers:
−
 
+
−
This proposal was made recently on ns-developers:
+
  
 
* <s>we apply the patch in bug 2308 (LTE) if the LTE maintainers approve it</s> <i>Update:  Patch to 2308 was applied, but issues were later found and the bug is reopened</i>
 
* <s>we apply the patch in bug 2308 (LTE) if the LTE maintainers approve it</s> <i>Update:  Patch to 2308 was applied, but issues were later found and the bug is reopened</i>
Line 59: Line 111:
 
== TCP models ==
 
== TCP models ==
  
−
Natale Patriciello, Anh Nguyen, Tom Henderson, Matthieu Coudron, and Amir Modarresi are working on the following.
+
Open tracker issues
−
 
+
−
0) Already added.
+
−
 
+
−
TCP BIC, Veno, Scalable, Vegas, YeAH, and Illinois have already been merged.
+
−
 
+
−
1) Open tracker issues
+
  
 
* 2263:  Support processing multiple TCP options in 1 header
 
* 2263:  Support processing multiple TCP options in 1 header
Line 79: Line 125:
 
* 2214:  TCP ScheduleNow for data transfer
 
* 2214:  TCP ScheduleNow for data transfer
 
* 1783:  experiencing drops during FastRec causes Tcp cw to blow up
 
* 1783:  experiencing drops during FastRec causes Tcp cw to blow up
−
 
−
2) Try to merge as many remaining TCP congestion control variants as are ready or nearly ready.
 
−
* CUBIC
 
−
* <strike>YeAH</strike> (merged)
 
−
* <strike>Illinois</strike> (merged)
 
−
* H-TCP:  http://mailman.isi.edu/pipermail/ns-developers/2016-April/013541.html
 
−
 
−
3) work on SACK:  <s>https://codereview.appspot.com/283880043/</s> Updated in late May to this issue:  https://codereview.appspot.com/299130043/
 
−
* General Scoreboard
 
−
* Tcp option SACK management
 
−
* Tcp option SACK implementation
 
−
 
−
MPTCP will not be merged for ns-3.26.
 
−
 
−
== traffic-control module ==
 
−
 
−
Stefano Avallone (stavallo@unina.it) is leading ns-3.26 development for traffic control, and has the following goals:
 
−
 
−
* Add support for Byte Queue Limits (see bug 2428)
 
−
* porting and polishing fq-codel (see bug 2430)
 
−
* reviewing [https://www.nsnam.org/bugzilla/show_bug.cgi?id=2261 PIE contribution] (in progress)
 
−
* introduce mq (a multi-queue queue disc configured by default on wifi, along with fq-codel)
 
−
* [https://www.nsnam.org/bugzilla/show_bug.cgi?id=2241 user priorities and QoS API]
 
−
* <s>provide a better solution for a couple of issues introduced by the requeue mechanism</s> Merged
 
  
 
== lte module ==
 
== lte module ==
Line 117: Line 139:
 
=== lte maintenance items ===
 
=== lte maintenance items ===
  
−
<s>Manuel Ricardo plans to work on bug 2308 (how tags are used) in May.</s> <i> Issue reopened</i>
+
Manuel Ricardo is handling bug 2308 (how tags are used).
  
−
Biljana will coordinate the remaining LTE bug responses on a best-effort basis:
+
Other LTE bug responses needed for below:
  
 
* 2339:  PUSCH transmit power scaled incorrectly
 
* 2339:  PUSCH transmit power scaled incorrectly
Line 140: Line 162:
  
 
== wifi module ==
 
== wifi module ==
−
 
−
Wifi continues to undergo significant development activity.
 
−
 
−
Sebastien Deronne is working on these extensions:
 
−
* [https://www.nsnam.org/bugzilla/show_bug.cgi?id=2381 support for 802.11e TXOP]
 
−
* extension of MPDU aggregation and block ack support (multi-tid, delayed response, …)
 
−
 
−
Tom Henderson is working on these extensions:
 
−
* SpectrumWifiPhy (bug 2400)
 
−
* TOS setting so that Wi-Fi QoS can read it (also Stefano Avallone has a proposal)
 
−
* support for selecting best beacon to associate with (also, channel roaming)
 
−
* support for separate LAA Wifi Coexistence module
 
−
 
−
Matias Richart is working on [https://codereview.appspot.com/254440043/ RRPAA rate control]
 
−
 
−
===wifi maintenance items===
 
  
 
Tom Henderson would like to accomplish the following:
 
Tom Henderson would like to accomplish the following:
 
* resolve bug 2369 on immediate access vs backoff
 
* resolve bug 2369 on immediate access vs backoff
−
* EDCA open bugs (2222, 2229)
+
* EDCA open bugs (2222)
−
* allow mesh to run over 802.11n/ac
+
  
 
current wifi issue list:
 
current wifi issue list:
Line 166: Line 171:
  
 
== lr-wpan module ==
 
== lr-wpan module ==
−
 
−
Tommaso is aiming to get Vishwesh's code merged from GSOC 2015.
 
−
 
−
Other than that, the following bugs are open:
 
  
 
* 2088 SetMcpsDataIndicationCallback stops UDP data
 
* 2088 SetMcpsDataIndicationCallback stops UDP data
Line 181: Line 182:
 
== internet module ==
 
== internet module ==
  
−
Tommaso is coordinating the below new feature work.
 
−
* DHCP support: https://www.nsnam.org/bugzilla/show_bug.cgi?id=2280
 
−
* increased support for ARP/ND changes in bug 2145
 
−
* Krishna's code from 2014 GSOC
 
−
 
−
See also the proposal to add TOS byte:
 
−
https://codereview.appspot.com/294280043/
 
−
 
−
=== maintenance issues for internet ===
 
−
Some recent internet bugs:
 
 
- 2209 ICMP message forwarding not based in incoming interface
 
- 2209 ICMP message forwarding not based in incoming interface
 
- 2180 is possible to register same route multiple times
 
- 2180 is possible to register same route multiple times
Line 198: Line 189:
 
- 1984 expose additional random variables to configuration system
 
- 1984 expose additional random variables to configuration system
  
−
bug 2057 is considered to be high priority
+
bug 2057, 2102 is considered to be high priority
  
 
== applications module ==
 
== applications module ==
−
 
−
For application module, we have a backlog of contributed code reviews related to new applications:
 
−
 
−
* MPEG traffic generator
 
−
* trace replay application
 
−
* web browsing application
 
−
 
−
and we also have these maintenance issues:
 
  
 
* 2178 add Rx trace source to UdpEchoServer
 
* 2178 add Rx trace source to UdpEchoServer
Line 218: Line 201:
 
== uan module ==
 
== uan module ==
  
−
Federico Guerra plans to integrate [https://www.nsnam.org/bugzilla/show_bug.cgi?id=2299 WOSS with the UAN module].
+
* 2007 SetRxThresholdDb is marked deprecated but is used by the model
−
 
+
−
Hossam Khader has also been active with patches and new proposals; see issues 2404, 2405, 2410, 2413.
+
−
 
+
−
== other ==
+
−
 
+
−
Chip Webb is working on improving support for Ethernet (full duplex links, switches and mixed L2/L3 networks)
+
−
 
+
−
= Release and development schedule =
+
−
 
+
−
The following schedule is planned (sliding about 5 weeks from original plan):
+
−
 
+
−
* <s>May 11, 2016</s> <s>June 22:</s> July 13?  New feature deadline.
+
−
* <s>May 25, 2016</s> <s>July 1:</s> July 20?  Planned code freeze date.
+
−
* <s>June 1, 2016</s> <s>July 6:</s> July 27?  Scheduled release date for ns-3.26
+
−
 
+
−
= Help wanted =
+
−
 
+
−
If you would like to help prepare the ns-3.26 release in some way, please contact Tom Henderson (tomhend@u.washington.edu).
+
−
 
+
−
Also, please check back at a later date as specific tasks may be listed here.
+

Revision as of 13:45, 8 July 2016

Main Page - Current Development - Developer FAQ - Tools - Related Projects - Project Ideas - Summer Projects

Installation - Troubleshooting - User FAQ - HOWTOs - Samples - Models - Education - Contributed Code - Papers

This page summarizes the release planning for ns-3.26 (originally planned for June 2016; rescheduled to July 2016). The ns-3 release process is listed here and here.

This page has been recently revised and some original goals for ns-3.26 have slipped to a new ns-3.27 page.

Schedule

The revised schedule is as follows:

  • July 15: Merge any remaining new features
  • July 22: Code freeze
  • around July 25: Release

Remaining new features

Maintainers are working on finalizing the following new features:

Wifi

traffic-control module

Stefano Avallone (stavallo@unina.it) is leading ns-3.26 development for traffic control, and has the following remaining goals:

  • Add support for Byte Queue Limits (see bug 2428)
  • porting and polishing fq-codel (see bug 2430)
  • reviewing PIE contribution (in progress)
  • introduce mq (a multi-queue queue disc configured by default on wifi, along with fq-codel)

ns-3 core

TCP

TCP SACK (https://codereview.appspot.com/299130043/) is proposed to be held for merging to ns-3-dev just after ns-3.26 is released.

applications

UAN

Bug fixing

These will be largely handled in the bug tracker and we will handle as many as possible in the time remaining.

ns-3 core

For ns-3.26, only maintenance on core (dealing with bug reports/open issues) is planned.

Tom Henderson would like to finish off:

  • Attribute/TraceSource deprecation (bugs 2149 and 2344)
  • refactor chi-squared tests for random number generation (bug 1927)
  • Matt's test.py contributions (bug 2291)
  • bug 2086 on attribute accessibility
  • bug 1962 on random variable stream GetStream() returning -1
  • bug 1939 on aggregating same object to two nodes Merged
  • bug 1604 on Config::GetDefault

Peter Barnes intends to continue working on:

  • Bug 938 - missing Doxygen in ns-3
  • Bug 1764 - can't compile without pthread
  • Bug 1972 - CommandLine duplicate argument handling

network module

There are a large number of patches pending on the Packet classes. This proposal was made recently on ns-developers:

  • we apply the patch in bug 2308 (LTE) if the LTE maintainers approve it Update: Patch to 2308 was applied, but issues were later found and the bug is reopened
  • we apply the patch in bug 2069 (fix size of m_used variable)
  • we open a 'feature request/PATCH WANTED' for removal of ByteTags
  • we study the implications of the expansion of tag size recently (bug 2361) and either update documentation or change the code
  • we add a 'best current practice' note to the documentation, on tag usage, as suggested by Tommaso. (perhaps modifying this section:
 https://www.nsnam.org/docs/release/3.25/models/html/packets.html#adding-and-removing-tags)

In addition, the following maintenance/bugs should be dealt with:

  • bug 2415: PacketMetadata Class Locks up Example
  • bug 2407: Packet Metadata bad state with small packet size
  • bug 2253: Alexander Krotov reported a bug: https://www.nsnam.org/bugzilla/show_bug.cgi?id=2253
  • bug 2221: Packet tag size increased by 1 byte recently due to a Wi-Fi requirement; what should we do about this? is the previous 20 byte limit sacred?
  • bug 2198: proposed const addition
  • bug 2078: Tommaso found problems in metadata usage
  • bug 2102: another metadata bug reported
  • bug 1643: this has lingered with a patch for a while
  • bug 1535: this Packet::AddAtEnd() in TCP is still around; the TCP buffers still use this
  • bug 1407: packet header printing disabled

TCP models

Open tracker issues

  • 2263: Support processing multiple TCP options in 1 header
  • 2122: decouple TcpTxBuffer variables
  • 2264: Possibility to setup Initial Sequence Number
  • 1529: randomize TCP initial sequence number
  • 2285: loss of TCP 3-way handshake calls receive callback to fire
  • 1167: TCP socket deferring CLOSE forever
  • 2133: In TCP close procedure, assert fail when receive in FIN_WAIT_2
  • 2278: in TcpSocketBase, need to advance NextTxSequence
  • 2256: TCPTxBuffer should be able to tell BytesInFlight
  • 2220: RAM usage reduction through reduction of retx events
  • 2214: TCP ScheduleNow for data transfer
  • 1783: experiencing drops during FastRec causes Tcp cw to blow up

lte module

No major changes planned for ns-3.26. Base support for LAA Wifi Coexistence module will be added (Biljana). Deferred to post-ns-3.26

With regard to two large patches previously proposed for code review, neither probably will make it to ns-3.26:

Tom and Tommaso will try to review and merge the IPv6 support:

lte maintenance items

Manuel Ricardo is handling bug 2308 (how tags are used).

Other LTE bug responses needed for below:

  • 2339: PUSCH transmit power scaled incorrectly
  • 2282: Resources from UDP flows not realized
  • 2277: EpcTftClassifier::Classify blindly assumes L4 header
  • 2172: Out-of-bounds array access
  • 2161: Error in removing a bearer in epc-mme class
  • 2152: Uplink HARQ retransmissions out of synch at MAC layer
  • 2151: Redundancy version in uplink HARQ not generated properly
  • 2140: TraceFadingLossModel could use a wrong value
  • 2113: LTE RLC AM: all status reports indicate no more than one NACK
  • 2107: PCAP printing for S1U and X2
  • 2091: Race condition in LteUePhy::GenerateCqiRsrpRsrq
  • 2048: PfFfMacScheduler assigns dlinfo even if no resources available
  • 1861: Problem when send UDP packet size between 1473-1478 bytes
  • 1840: SINR->CQI->MCS conversion in the UL
  • 1515: REM shows increased SINR when co-located eNBs have same EARFCN
  • 1460: LTE-EPC/RPM different SINR values
  • 1438: lena-simple-epc with AM mode

wifi module

Tom Henderson would like to accomplish the following:

  • resolve bug 2369 on immediate access vs backoff
  • EDCA open bugs (2222)

current wifi issue list: https://www.nsnam.org/bugzilla/buglist.cgi?component=wifi&product=ns-3&query_format=advanced&resolution=---

lr-wpan module

  • 2088 SetMcpsDataIndicationCallback stops UDP data
  • 2033 IFS are not currently implemented
  • 1934 CCA interrupted by incoming packet
  • 1933 CCA mode should be configurable
  • 1924 sensing radius and CCA
  • 1879 LR-WPAN association primitive
  • 1809 lr-wpan features needed

internet module

- 2209 ICMP message forwarding not based in incoming interface - 2180 is possible to register same route multiple times - 2102 global routing and bridging is reopened - 2064 UDP socket GetMtu() needed - 2057 ARP and NDISC caches should be updated by L4 - 1984 expose additional random variables to configuration system

bug 2057, 2102 is considered to be high priority

applications module

  • 2178 add Rx trace source to UdpEchoServer
  • 2111 add receiver timestamp to SeqTsHeader (we seem to have agreed to make a new header?)
  • 2106 add SetSocket API
  • 1977 v4ping verbose output when not explicitly stopped
  • 1899 add sequence number header (possibly related to 2111?)

uan module

  • 2007 SetRxThresholdDb is marked deprecated but is used by the model
Retrieved from "https://www.nsnam.org/mediawiki/index.php?title=Ns-3.26&oldid=10089"