From a6366a865c74dc3ef5f25755dff35f75953fee4d Mon Sep 17 00:00:00 2001 From: Tom Henderson Date: Sun, 6 Oct 2024 11:59:46 -0700 Subject: [PATCH] doc: Update AUTHORS, CHANGES.md, and RELEASE_NOTES for ns-3.43 --- AUTHORS | 15 +++++++++++-- CHANGES.md | 22 ++++++++++--------- RELEASE_NOTES.md | 56 +++++++++++++++++++++++++++++++++++------------- 3 files changed, 66 insertions(+), 27 deletions(-) diff --git a/AUTHORS b/AUTHORS index 573414e17..cafc1a638 100644 --- a/AUTHORS +++ b/AUTHORS @@ -30,12 +30,14 @@ Mehdi Benamor (mehdi.benamor@telecom-bretagne.eu) Apoorva Bhargava (apoorvabhargava13@gmail.com) Avakash Bhat (avakash261@gmail.com) Kavya Bhat (kavyabhat@gmail.com) +Sanjay Bhat (sanjubhat2004@gmail.com) Raj Bhattacharjea (raj.b@gatech.edu) Mathew Bielejeski (bielejeski1@llnl.gov) Timo Bingmann (timo.bingmann@student.kit.edu) Doug Blough (doug.blough@gatech.edu) Julien Boite (juboite@gmail.com) Biljana Bojovic (bbojovic@cttc.es) +Andreas Boltres (andreas.boltres@partner.kit.edu) Elena Borovkova (borokovaes@iitp.ru) Rahul Bothra (rrbothra@gmail.com) Caleb Bowers (caleb.bowers@nel.navy.mil, cbowers1020@gmail.com) @@ -44,7 +46,6 @@ Matthew Bradbury (matt-bradbury@live.co.uk) Dan Broyles (muxman@sbcglobal.net) Jonathan Brugge (j.d.brugge@student.utwente.nl) Junling Bu (linlinjavaer@gmail.com) -Alessio Bugetti (alessiobugetti98@gmail.com) Elena Buchatskaia (borovkovaes@iitp.ru) Alessio Bugetti (alessiobugetti98@gmail.com) Nuno Cardoso (nunopcardoso@gmail.com) @@ -76,6 +77,7 @@ Christophe Delahaye (christophe.delahaye@orange.com) Sébastien Deronne (sebastien.deronne@gmail.com) Ameya Deshpande (ameyanrd@outlook.com) Zhiheng Dong (dzh2077@gmail.com) +@donghuiyong at GitLab.com Christoph Döpmann (doepmanc@informatik.hu-berlin.de) Jordan Dorham (dorham1@llnl.gov) Craig Dowell (craigdo@ee.washington.edu) @@ -96,8 +98,10 @@ Piotr Gawlowicz (gawlowicz.p@gmail.com) Eric Gamess (egamess@gmail.com) Shiva Gantha (ganthashiva@gmail.com) Yida Gao (yidapb@gmail.com) +Vikas Gaur (vikasgaurdws@gmail.com) Thomas Geithner (thomas.geithner@dai-labor.de) Ashim Ghosh (ashim.atiit@gmail.com) +@Ghostyhands at GitLab.com Martin Giachino (martin.giachino@gmail.com,giachino@fing.edu.uy) Nichit Bodhak Goel (nichit93@gmail.com) Tom Goff (tgoff@tgoff.net) @@ -144,6 +148,7 @@ Chandrakant Jena (chandrakant.barcelona@gmail.com) Liu Jian (liujatp@gmail.com) Sascha Alexander Jopen (jopen@informatik.uni-bonn.de) Piotr Jurkiewicz (piotr.jerzy.jurkiewicz@gmail.com) +Kakadus1 (j.dittrich2303@gmail.com) Evgeny Kalishenko (ydginster@gmail.com) Raghuram Kannan (raghuramkannan40@gmail.com) Vignesh Kannan (vignesh2496@gmail.com) @@ -152,6 +157,7 @@ Tanmay Kathpalia (tanmay.kathpalia@landisgyr.com) Konstantinos Katsaros (dinos.katsaros@gmail.com) Bhaskar Kataria (www.bhaskar.com7@gmail.com) Nils Kattenbeck (nils.kattenbeck@rwth-aachen.de) +Nakayama Kenjiro (nakayamakenjiro@gmail.com) Morteza Kheirkhah (m.kheirkhah@sussex.ac.uk) Jörg Christian Kirchhof (christian.kirchhof@rwth-aachen.de) Ohad Klausner @@ -261,6 +267,7 @@ Manoj Kumar Rana (manoj24.rana@gmail.com) Andrea Ranieri (andreran@uno.it) Bruno Ranieri (Yrrsinn@googlemail.com) Deepti Rajagopal (deeptir96@gmail.com) +Satyarth Ratnani (satyarthratnani@gmail.com) Varun Reddy (varunamarreddy@gmail.com) Ken Renard (kenneth.renard@arl.army.mil) Getachew Redieteab (getachew.redieteab@orange.com) @@ -270,7 +277,7 @@ Jakub Rewienski (jrewienski@gmail.com) Matias Richart (mrichart@fing.edu.uy) George F. Riley (riley@ece.gatech.edu) Juergen Rinas (jrinas@gmx.de) -Robert-ML +@Robert-ML at GitLab.com Sebastian Rohde (sebastian.rohde@tu-dortmund.de) Karsten Roscher (sfx@rocktale.de) Ali Rostami (a.rostami@rutgers.edu) @@ -300,6 +307,7 @@ Muyuan Shen (shmy315@gmail.com) Guowang Shi (shiguowang2007@gmail.com) Phillip Sitbon (phillip.sitbon@gmail.com) Pedro Silva (pmms@inesctec.pt) +Aniket Singh (aniketsingh84646@gmail.com) Siddharth Singh (siddharth12375@gmail.com) Anirudh Sivaraman (sk.anirudh@gmail.com) Steven Smith (smith84@llnl.gov) @@ -313,6 +321,7 @@ Ewgenij Starostin (estar@cs.tu-berlin.de) Greg Steinbrecher (grs@fb.com) YunQiang Su (wzssyqa@gmail.com) Brian Swenson (bswenson3@gatech.edu) +Jay C. Surani (jaysurani333@gmail.com) Lalith Suresh (suresh.lalith@gmail.com) Szymon Szott (szott@kt.agh.edu.pl) Mohit P. Tahiliani (tahiliani.nitk@gmail.com) @@ -331,6 +340,7 @@ Quincy Tse (quincy.tse@gmail.com) Frederic Urbani (frederic.urbani@inria.fr) Andras Varga (andras@omnetpp.org) Shrinidhi Anil Varna (shrinidhi99.varna@gmail.com) +Silviu-Leonard Vatamanelu (silviu48vatamanelu@gmail.com) Sebastien Vincent (vincent@clarinet.u-strasbg.fr) Guillaume Vu-Brugier (gvubrugier@gmail.com) Tom Wambold (tom5760@gmail.com) @@ -343,6 +353,7 @@ Florian Westphal (fw@strlen.de) He Wu (mdzz@u.washington.edu) Xiuchao Wu (xiuchao@amazon.com) Aron Wussler (aron@wussler.it) +wzfelix Heran Yang (heran55@126.com) Yoshihiko Yazawa (yoshiyaz@gmail.com) Menglei Zhang (menglei@nyu.edu) diff --git a/CHANGES.md b/CHANGES.md index 612ee0851..ba16b292b 100644 --- a/CHANGES.md +++ b/CHANGES.md @@ -13,37 +13,38 @@ Note that users who upgrade the simulator across versions, or who work directly This file is a best-effort approach to solving this issue; we will do our best but can guarantee that there will be things that fall through the cracks, unfortunately. If you, as a user, can suggest improvements to this file based on your experience, please contribute a patch or drop us a note on ns-developers mailing list. -Changes from ns-3.42 to ns-3-dev --------------------------------- +Changes from ns-3.42 to ns-3.43 +------------------------------- ### New API -* (tcp) A new trace source `TcpSocketBase::LastRtt` has been added for tracing the last RTT sample observed. The existing trace source `TcpSocketBase::Rtt` is still providing the smoothed RTT, although it had been incorrectly documented as providing the last RTT. +* (applications) A new trace source `BulkSendApplication::TcpRetransmission` has been added for tracing TCP retranmissions. * (core) Added `LaplacianRandomVariable` class implementing the Laplacian random variable, and `LargestExtremeValueRandomVariable` class implementing the Largest Extreme Value random variable. -* (wifi) Added a new trace source to `WifiPhy`: **PhyRxMacHeaderEnd**, which is fired when the reception of the MAC header of an MPDU is completed and provides the MAC header and the remaining PSDU duration. The trace source is actually fired when the new **NotifyMacHdrRxEnd** attribute of `WifiPhy` is set to true (it is set to false by default). * (lr-wpan) Added a new test to `lr-wpan-cca-test.cc` suite. The added test demonstrates a known CCA vulnerability window. +* (tcp) A new trace source `TcpSocketBase::LastRtt` has been added for tracing the last RTT sample observed. The existing trace source `TcpSocketBase::Rtt` is still providing the smoothed RTT, although it had been incorrectly documented as providing the last RTT. +* (wifi) Added a new trace source to `WifiPhy`: **PhyRxMacHeaderEnd**, which is fired when the reception of the MAC header of an MPDU is completed and provides the MAC header and the remaining PSDU duration. The trace source is actually fired when the new **NotifyMacHdrRxEnd** attribute of `WifiPhy` is set to true (it is set to false by default). * (wifi) WifiHelper::SetStandard() method now accepts selected string values in addition to enum argument. * (wifi) Added a new method **SetPcapCaptureType** to `WifiPhyHelper` to control how PCAPs are generated for MLD devices. ### Changes to existing API * (core) Deprecated struct `TypeTraits`. Functionality provided by the standard library header `` should be used instead. +* (core) Add `AddDeprecatedName` to TypeId. This allows for TypeIds to transition to name TypeIds that use namespaces while still supporting the old name. +* (energy) Energy module TypeId now uses the name that includes the namespace `ns3::energy`, the old name is now deprecated. +* (energy) Documentation was extended and reformatted. +* (lr-wpan) Lr-wpan module TypeId now uses the name that includes the namespace `ns3::lrwpan`, the old name is now deprecated. * (lr-wpan) Attribute `macBeaconPayload` in `MacPibAttributes` is now a std::vector instead of a packet pointer. * (lr-wpan) Removes the word `address` from the MAC address prefix when `LOG_PREFIX_FUNC` is used. * (lr-wpan) Removes the word `address` from the CSMA-CA logs prefix when `LOG_PREFIX_FUNC` is used. -* (wifi) The `WifiHelper::AssignStreams()` method has been made static. * (lr-wpan) Added `AssignStreams` function to the MAC. * (lr-wpan) Attribute `macRxOnWhenIdle` added to the supported attributes in `MacPibAttributes`. * (lr-wpan) Attribute `macPromiscuousMode` added to the supported attributes in `MacPibAttributes`. * (lr-wpan) Attribute `macAssociatePermit` added to the supported attributes in `MacPibAttributes`. * (lr-wpan) Attribute `pCurrentChannel` added to the supported attributes in `MacPibAttributes`. * (lr-wpan) Attribute `pCurrentPage` added to the supported attributes in `MacPibAttributes`. -* (wifi) Attribute `ChannelSettings` has been changed to allow configuration of non-contiguous operating channels by specifying each 80 MHz segment. It has changed from TupleValue to AttributeContainerValue, but the configuration of contiguous channels using a StringValue still works as before. * (lr-wpan) Documentation was extended and reformatted. -* (core) Add `AddDeprecatedName` to TypeId. This allows for TypeIds to transition to name TypeIds that use namespaces while still supporting the old name. -* (energy) Energy module TypeId now uses the name that includes the namespace `ns3::energy`, the old name is now deprecated. -* (energy) Documentation was extended and reformatted. -* (lr-wpan) Lr-wpan module TypeId now uses the name that includes the namespace `ns3::lrwpan`, the old name is now deprecated. +* (wifi) The `WifiHelper::AssignStreams()` method has been made static. +* (wifi) Attribute `ChannelSettings` has been changed to allow configuration of non-contiguous operating channels by specifying each 80 MHz segment. It has changed from TupleValue to AttributeContainerValue, but the configuration of contiguous channels using a StringValue still works as before. ### Changes to build system @@ -53,6 +54,7 @@ Changes from ns-3.42 to ns-3-dev * (lr-wpan) Beacons are now transmitted using CSMA-CA when requested from a beacon request command. * (lr-wpan) Upon a beacon request command, beacons are transmitted after a jitter to reduce the probability of collisions. +* (tcp) TCP Proportional Rate Reduction (PRR) recovery has been aligned to the updates in draft-ietf-tcpm-prr-rfc6937bis Changes from ns-3.41 to ns-3.42 ------------------------------- diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md index 1112f8760..719e70102 100644 --- a/RELEASE_NOTES.md +++ b/RELEASE_NOTES.md @@ -13,8 +13,19 @@ a [GitLab.com issue tracker](https://gitlab.com/nsnam/ns-3-dev/-/issues) number, and references prefixed by '!' refer to a [GitLab.com merge request](https://gitlab.com/nsnam/ns-3-dev/-/merge_requests) number. -Release 3-dev -------------- +Release 3.43 +------------ + +This release is mainly a maintenance release and the API is generally +consistent with the previous ns-3.42 release. See the file CHANGES.md +for changed model behavior and build system aspects. The GPLv2 license +identifiers in the headers of each file have been changed to use SPDX +identifiers. The minimum GCC version supported is now version 10.1. + +### Availability + +This release is available from: + ### Supported platforms @@ -27,38 +38,51 @@ requirements (Note: not all ns-3 features are available on all systems): - (macOS only) Xcode 13.1.6 or later - (Windows only) Msys2/MinGW64 and Msys2/UCRT64 toolchains or WSL2 -This release has discontinued support for g++-9 and clang-10 compilers and for Python 3.6 and 3.7. - Python API requires [Cppyy](https://cppyy.readthedocs.io/en/latest/installation.html) and has only been tested on Linux. As of this release, the latest known version to work with ns-3 is cppyy==3.1.2. +The required Doxygen version for documentation generation is version 1.11. + ### New user-visible features -- (lr-wpan) !2082 - MAC SET GET attributes added +- (applications) !2027 - BulkSendApplication: Added TCP retransmission trace consuming TcpSocketBase's TCP retransmission trace - (core) !1904 - Added support for Laplacian and Largest Extreme Value random variables (`LaplacianRandomVariable`, `LargestExtremeValueRandomVariable`) -- (wifi) - Added support for 80+80 MHz -- (lr-wpan) !2123 - CCA vulnerability window test and doc - (core) !2018 - `AddDeprecatedName` is now supported in TypeId. - (energy) !2018 - Energy module now uses the `ns3::energy` namespace in its TypeId. +- (lr-wpan) !2082 - MAC SET GET attributes added +- (lr-wpan) !2123 - CCA vulnerability window test and doc - (lr-wpan) !2163 - Lr-wpan module now uses the `ns3::lrwpan` namespace in its TypeId. -- (internet) !2027 - TcpSocketBase: Added TCP retransmission trace -- (applications) !2027 - BulkSendApplication: Added TCP retransmission trace consuming TcpSocketBase's TCP retransmission trace +- (tcp) !2027 - TcpSocketBase: Added TCP retransmission trace - (tcp) !2059 - Aligns PRR implementation with RFC 6937 bis-08. Added a new param `isDupAck` to `DoRecovery` method, removed `ReductionBound` attribute from `TcpPrrRecovery`. -- (wifi) It is now possible to control how PCAPs are generated for MLD: either a single PCAP +- (wifi) !2068 - Introduce use of weak type aliases for quantities representing SI units, +in preparation for future conversion to strongly typed units and quantities +- (wifi) - Added support for 80+80 MHz channel configuration +- (wifi) - It is now possible to control how PCAPs are generated for MLD: either a single PCAP per device, or a PCAP file per PHY, or a PCAP file per link. By default, a single PCAP is generated per PHY for MLD. The configuration of this parameter has no impact for SLD. ### Bugs fixed +- (core) #1118 - Demangle EnumValue typenames for Doxygen +- (core) #1122 - Handle deserializing empty strings in ATTRIBUTE_VALUE_IMPLEMENT +- (config-store, core) #1091 - Fix handling of deprecated and obsolete attributes +- (flow-monitor) #1097 - Add logging of max. and min. packet delay in FlowMonitor - (lr-wpan) !2001 - Beacon improvements and fixes - (lr-wpan) !2042 - Beacon improvements and jitter addition +- (mobility) #1101 - Use std::abs() instead of abs() +- (tcp) #1126 - Fix bytesAcked calculation in ProcessAck +- (tcp) #805 - Update NextSeg() conditions for SACK as per RFC +- (tcp) #1011 - Forbid ECN-marking of retransmissions, window probes and pure ACKs +- (tcp) #1043 - Fix BBR incorrect minRtt updates +- (tcp) #1113 - Fix integer overflow on first Hystart event +- (tcp) !2083 - Consider segmentSize send limit while checking cwnd for cwnd rate-limit +- (uan) !2087 - Fix Thorp attenuation formula +- (uan) !2088 - Fix PER calculation of M-QAM +- (uan) !2121 - Wrong Eb/N0 calculation in UanPhyPerCommonModes::CalcPer() +- (uan) !2127 - Fix bug in energy update in UanPhyGen::RxEndEvent() +- (wifi) #1095 - Fix reception of WIFI_MOD_CLASS_HR_DSSS - (wifi) Avoid firing WifiMac::DroppedMpdu trace twice in some cases - (wifi) Fix assignment of AIDs to non-AP STAs/MLDs to ensure they are unique - (wifi) Fix starting Sequence Number when ADDBA Response arrives after timeout -- (uan) !2087 - Fix Thorp attenuation formula -- (uan) !2088 - Fix PER calculation of M-QAM -- (uan) !2127 - Fix bug in energy update in UanPhyGen::RxEndEvent() -- (uan) !2121 - Wrong Eb/N0 calculation in UanPhyPerCommonModes::CalcPer() -- (wifi) !2068 - Introduce use of weak type aliases for SI units - (wifi) Fix default association manager not properly handling non-AP MLDs not supporting 160 MHz operations - (wifi) Fix round robin multi-user scheduler sending Basic/BSRP TFs to EMLSR clients using another link - (wifi) Fix round robin multi-user scheduler sending Basic/BSRP TFs when no TID is mapped in the UL direction @@ -67,6 +91,8 @@ per device, or a PCAP file per PHY, or a PCAP file per link. By default, a singl - (wifi) Fix retrieval of buffer status info from QoS Null frames sent in TB PPDUs in the multi-link case - (wifi) Avoid repeatedly sending BSRP TF in a TXOP when access is requested by MU scheduler - (wifi) Fix Txop Link entity swapping in some specific cases +- (wifi) Fix incorrect configuration of wifi-spectrum-saturation-example.cc +- (wifi) Fix output formatting for wifi-spectrum-per-example.cc Release 3.42 ------------