From d0c8e1424173499973bc5ca240732a8d44a23255 Mon Sep 17 00:00:00 2001 From: Tom Henderson Date: Sat, 27 Sep 2025 08:40:25 -0700 Subject: [PATCH] doc: Update AUTHORS, CHANGES.md, and RELEASE_NOTES for ns-3.46 --- AUTHORS | 8 ++++++-- CHANGES.md | 11 ++++++++--- RELEASE_NOTES.md | 15 ++++++++++++++- 3 files changed, 28 insertions(+), 6 deletions(-) diff --git a/AUTHORS b/AUTHORS index 5dc729f2a..f958becfd 100644 --- a/AUTHORS +++ b/AUTHORS @@ -74,6 +74,7 @@ Luis Cortes (cortes@gatech.edu) Luca Costantino (luca.costantino@gmail.com) Matthieu Coudron (matthieu.coudron@lip6.fr) Michael R. Davis (mrdvt92@yahoo.com) +@DavisRobertson1 at GitLab.com Alexander D'souza (moijes12@gmail.com) Ankit Deepak (adadeepak8@gmail.com) Christophe Delahaye (christophe.delahaye@orange.com) @@ -156,6 +157,7 @@ Evgeny Kalishenko (ydginster@gmail.com) Raghuram Kannan (raghuramkannan40@gmail.com) Vignesh Kannan (vignesh2496@gmail.com) Nihar Kapasi (niharkkapasi@gmail.com) +Arnav Kapoor (kapoorarnav43@gmail.com) Ouassim Karrakchou (okarr102@uottawa.ca) Tanmay Kathpalia (tanmay.kathpalia@landisgyr.com) Konstantinos Katsaros (dinos.katsaros@gmail.com) @@ -185,6 +187,7 @@ Andrea Lacava (thecave003@gmail.com) Sandra Lagen (sandra.lagen@cttc.es) Emmanuelle Laprise (emmmanuelle.laprise@bluekazoo.ca) Harsh Lara (harshapplefan@gmail.com) +Hugo Le Dirach (hugo.le_dirach@onera.fr) Mattia Lecci (mattia.lecci@gmail.com) Ben Lee (limjcst@163.com) Robin Lee (xinyashuai1987@163.com) @@ -241,6 +244,7 @@ Niwedita (niwedita.dakshana2017@gmail.com) Michael Nowatkowski (nowatkom@gmail.com) Anh Nguyen (annguyen@ittc.ku.edu) Duy Nguyen (duy@soe.ucsc.edu) +Ryo Okuda (c611901200@tokushima-u.ac.jp) Alfonso Oliveira (af.oliveira.16@gmail.com) Wouter Overmeire (lodagro@gmail.com) Luis Pacheco (luisbelem@gmail.com) @@ -262,6 +266,7 @@ Colin Perkins (csp@csperkins.org) Eduardo Pinto (epmcj@hotmail.com) Giuseppe Piro (g.piro@poliba.it) Randall Plate (rplate@spawar.navy.mil) +Max Plekh (mplekh@gmail.com) Yana Podkosova (yanapdk@rambler.ru) Michele Polese (michele.polese@gmail.com) Ovidiu Poncea (ovidiu.poncea@cs.pub.ro) @@ -273,6 +278,7 @@ Philipp Raich (philipp.raich@tuwien.ac.at) Alberto Gallegos Ramonet (alramonet@is.tokushima-u.ac.jp) Manoj Kumar Rana (manoj24.rana@gmail.com) Andrea Ranieri (andreran@uno.it) +Ashish Reddy (ashishajr@gmail.com) Bruno Ranieri (Yrrsinn@googlemail.com) Deepti Rajagopal (deeptir96@gmail.com) Satyarth Ratnani (satyarthratnani@gmail.com) @@ -379,5 +385,3 @@ La Tuan Minh (GCI 2019) Parth Pratim (GCI 2018) ra1nst0rm3d (GCI 2019) SaiMyGuy (GCI 2019) -Ryo Okuda (c611901200@tokushima-u.ac.jp) -Hugo Le Dirach (hugo.le_dirach@onera.fr) diff --git a/CHANGES.md b/CHANGES.md index fe6428669..e64b9407e 100644 --- a/CHANGES.md +++ b/CHANGES.md @@ -16,9 +16,11 @@ This file is a best-effort approach to solving this issue; we will do our best b ### New API -* (wifi) Added a new `EarlyTxopEndDetect` attribute to `EhtFrameExchangeManager` to control whether the Duration/ID value of the frame being transmitted or received by a device shall be used to early detect the end of an ongoing TXOP (held by another device). * (spectrum) Added the base `WraparoundModel`, which is retrieved from the associated objects of a spectrum channel, and then used to wraparound the transmitter mobility model during transmissions. * (spectrum) Added the `HexagonalWraparoundModel`, which implements the wraparound for a hexagonal cell deployment, typical of cellular networks. +* (wifi) Added a `StaticWifiSetupHelper` to (optionally) setup Wi-Fi devices (associations, block ack agreements, EMLSR mode) at simulation start time, without actually exchanging management frames over the air. +to DisableScanning` attribute to `StaWifiMac` to disable channel scanning; it can be useful to set this attribute to false when a static setup is performed. +* (wifi) Added a new `EarlyTxopEndDetect` attribute to `EhtFrameExchangeManager` to control whether the Duration/ID value of the frame being transmitted or received by a device shall be used to early detect the end of an ongoing TXOP (held by another device). * (wifi) Added a new `DisableScanning` attribute to `StaWifiMac` to disable channel scanning; it can be useful to set this attribute to false when a static setup is performed. ### Changes to existing API @@ -26,17 +28,18 @@ This file is a best-effort approach to solving this issue; we will do our best b The wimax module was removed and moved to the ns-3 App Store. * (antenna) Reformatted documentation. -* (documentation) Improve models documentation look and feel +* (documentation) Improve models documentation look and feel. * (internet) Added check for longest prefix match in GlobalRouting. -* (internet) ArpCache::Flush() and NdiscCache::Flush() no longer remove autogenerated entries * (lr-wpan) Debloat MAC PD-DATA.indication and reduce packet copies. * (zigbee) Added group table. * (zigbee) Added Groupcast (Multicast) support. +* (zigbee) Added basic APS layer support. * (mobility) Mobility models now implement a Copy() function. * (propagation) MatrixPropagationLossModels are now associated per NodeId, and not per mobility model objects. * (propagation) Removed ThreeGppPropagationLossModel prologue function, added temporarily for ns-3.45 wraparound support. * (spectrum) MobilityModels associated to devices are not passed to receptor in SpectrumChannel. A virtual mobility model object, created from a copy and subject to wraparound is passed in its place. * (spectrum) SpectrumSignalParameters now includes an entry for the transmitter virtual mobility model. +* (zigbee) Several callback type definitions were moved from global to class scope, for the ZigbeeAps and ZigbeeNwk classes. ### Changes to build system @@ -49,7 +52,9 @@ The wimax module was removed and moved to the ns-3 App Store. ### Changed behavior +* (internet) ArpCache::Flush() and NdiscCache::Flush() no longer remove autogenerated entries. * (internet) The Ipv[4,6]RawSocket now reflects the Linux implementation, meaning that fragmented packets are reassembled (fragments are not anymore received by the socket), and packets that are simply forwarded are not received by the socket either (fixes #809). +* (wifi) WiFi backoffs are now reset only if PHY went to sleep or off for more than a threshold, improving performance and compliance with standards. ## Changes from ns-3.44 to ns-3.45 diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md index eb095d527..f710422f3 100644 --- a/RELEASE_NOTES.md +++ b/RELEASE_NOTES.md @@ -25,6 +25,14 @@ requirements (Note: not all ns-3 features are available on all systems): - (macOS only) Xcode 16.2 or later - (Windows only) Msys2/MinGW64, Msys2/UCRT64 and ClangCL/MSVC toolchains, or WSL2 +Note that the minimum C++ compiler versions have increased since the last release. + +The version of clang-format enforced by the check-style-clang-format.py script for +this release is version 20 only; the previous ns-3 release was compatible with versions 15-19. + +Version 20 of the clang-tidy linter is now supported and recommended, although versions 15-19 +are still compatible. + 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.5.0. @@ -37,17 +45,22 @@ The wimax module was removed and moved to the ns-3 App Store. - (antenna) !2516 - Reformatted documentation - (documentation) !2519 - Improve models documentation look and feel - (core) A stacktrace will now be printed on fatal errors in supported platforms. -- (wifi) !2524 - Fix corrupted radiotap header when EHT is used. - (zigbee) !2512 - Added Groupcast (Multicast) support +- (zigbee) Added basic APS layer support - (spectrum) !2452 - Added new wraparound model support for spectrum channels, and the hexagonal wraparound model, typical of cellular deployments ### Bugs fixed +- (examples) #1146 - Fixed three-gpp-v2v-channel-example to prevent pathloss from being incorrectly accumulated over time - (internet) #851 - NeighborCacheHelper entries are no longer removed due to LinkUp events +- (internet) #809 - Fixed IPv4,6 Raw Socket fragmentation issue - (internet) #1251 - Added check for longest prefix match in GlobalRouting +- (stats) #295 - Added 100 ms timeout for sqlite3 operations to prevent hangs +- (wifi) !2524 - Fix corrupted radiotap header when EHT is used. - (wifi) Block transmission on other EMLSR links as soon as it is detected that the main PHY is receiving an A-MPDU, to prevent that the EMLSR client starts an UL TXOP before the end of the A-MPDU - (wifi) EMLSR clients can switch to listening operations when receiving the MAC header of a broadcast frame that is not a Trigger Frame nor a Multi-STA BA - (wifi) Immediate channel access should not be postponed by a backoff slot if channel access is requested at a slot boundary +- (wifi) Reset backoffs only if PHY went to sleep or off for more than a threshold ## Release 3.45