F5/unison
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

doc: Update AUTHORS, CHANGES.md, and RELEASE_NOTES.md for ns-3.41

Browse Source
This commit is contained in:
Tom Henderson
2024-02-02 12:16:17 -08:00
parent 35395b37ac
commit 10c929275e
3 changed files with 61 additions and 32 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
AUTHORS
View File

@@ -28,9 +28,11 @@ Pedro Bellotti (pedro177@gmail.com)
Mehdi Benamor (mehdi.benamor@telecom-bretagne.eu)
Apoorva Bhargava (apoorvabhargava13@gmail.com)
Avakash Bhat (avakash261@gmail.com)
Kavya Bhat (kavyabhat@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)
Elena Borovkova (borokovaes@iitp.ru)
@@ -42,6 +44,7 @@ Dan Broyles (muxman@sbcglobal.net)
Jonathan Brugge (j.d.brugge@student.utwente.nl)
Junling Bu (linlinjavaer@gmail.com)
Elena Buchatskaia (borovkovaes@iitp.ru)
Alessio Bugetti (alessiobugetti98@gmail.com)
Nuno Cardoso (nunopcardoso@gmail.com)
Gustavo Carneiro (gjc@inescporto.pt, gjcarneiro@gmail.com)
Scott Carpenter (scarpen@ncsu.edu)
@@ -160,6 +163,7 @@ Hossam Khader (hossamkhader@gmail.com)
Alexander Krotov (ilabdsf@yandex.ru)
Deepak Kumaraswamy (deepakkavoor99@gmail.com)
Mathieu Lacage (mathieu.lacage@inria.fr)
Andrea Lacava (thecave003@gmail.com)
Sandra Lagen (sandra.lagen@cttc.es)
Emmanuelle Laprise (emmmanuelle.laprise@bluekazoo.ca)
Harsh Lara (harshapplefan@gmail.com)
@@ -181,6 +185,7 @@ Federico Maguolo (maguolof@dei.unipd.it)
Antti Makela (zarhan@cc.hut.fi)
Francesco Malandrino (francesco.malandrino@gmail.com)
Rubén Martínez (rmartinez@deic.uab.cat)
Chaz Maschman
Ryan Mast (mast9@llnl.gov)
Fabian Mauchle (f1mauchl@hsr.ch)
Mauriyin (haoyin@uw.edu)
@@ -188,6 +193,7 @@ Andrey Mazo (mazo@iitp.ru)
Jonathan McCrohan (jmccroha@tcd.ie)
Andrew McGregor (andrewmcgr@gmail.com)
Miralem Mehic (miralemmehic@gmail.com)
Levente Mészáros (levy@omnetpp.org)
Vedran Miletić (rivanvx@gmail.com)
Saswat Mishra (clicksaswat@gmail.com)
Jens Mittag (jens.mittag@kit.edu)
@@ -242,6 +248,7 @@ Ovidiu Poncea (ovidiu.poncea@cs.pub.ro)
Anna Poon (poon2@llnl.gov)
Gauri Prasad
Vikas Pushkar (vikaskupushkar@gmail.com)
Martin Quinson (mquinson@debian.org)
Philipp Raich (philipp.raich@tuwien.ac.at)
Alberto Gallegos Ramonet (alramonet@is.tokushima-u.ac.jp)
Manoj Kumar Rana (manoj24.rana@gmail.com)
@@ -327,13 +334,13 @@ Florian Westphal (fw@strlen.de)
He Wu (mdzz@u.washington.edu)
Xiuchao Wu (xiuchao@amazon.com)
Aron Wussler (aron@wussler.it)
Heran Yang (heran55@126.com)
Yoshihiko Yazawa (yoshiyaz@gmail.com)
Menglei Zhang (menglei@nyu.edu)
Theodore Zhang (harryzwh@gmail.com)
Dizhi Zhou (dizhi.zhou@gmail.com)
Tolik Zinovyev (tolik@bu.edu)
Tommaso Zugno (tommasozugno@gmail.com)
Alessio Bugetti (alessiobugetti98@gmail.com)
hax0kartik (GCI 2019)
howie (GCI 2019)
InquisitivePenguin (GCI 2019)

40
CHANGES.md
View File

@@ -13,19 +13,24 @@ 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.40 to ns-3-dev
--------------------------------
Changes from ns-3.40 to ns-3.41
-------------------------------
### New API
* (spectrum) `SpectrumSignalParameters` is extended to include two new members called: `spectrumChannelMatrix` and `precodingMatrix` which are the key information needed to support MIMO simulations.
* (wifi) Added new attribute `ChannelAccessManager:GenerateBackoffIfTxopWithoutTx` to invoke the backoff procedure when an AC gains the right to start a TXOP but it does not transmit any frame, provided that the queue is not actually empty. No transmission may occur,e.g., due to constraints associated with EMLSR operations. This possibility is specified by the current draft revision of the IEEE 802.11 standard.
* (core) Added `BernoulliRandomVariable` class implementing the bernoulli random variable, and `BinomialRandomVariable` class implementing the binomial random variable.
* (core) Added wrapper around `UniformRandomVariable` to meet the C++11 requirements of UniformRandomBitGenerator.
* (core) Added method to `GetStopEvent()` from `Simulator`
* (internet) It is now possible to set the TOS field for IPv4 ICMP Echo Requests/Responses, via a new `Tos` attribute.
* (spectrum) `SpectrumSignalParameters` is extended to include two new members called: `spectrumChannelMatrix` and `precodingMatrix` which are the key information needed to support MIMO simulations.
* (spectrum) `SpectrumChannel::AssignStreams()` is added, to allow random variable stream assignment for all propagation loss and delay models added to the channel.
* (wifi) Added new attribute `ChannelAccessManager:GenerateBackoffIfTxopWithoutTx` to invoke the backoff procedure when an AC gains the right to start a TXOP but it does not transmit any frame, provided that the queue is not actually empty. No transmission may occur,e.g., due to constraints associated with EMLSR operations. This possibility is specified by the current draft revision of the IEEE 802.11 standard.
### Changes to existing API
* (core) Attributes that wrap enums must update the syntax for the `MakeEnumAccessor` method call. Where you once were able to write, for example (from attribute-test-suite.cc):
* (antenna) `UniformPlannarArray` has new attributes `NumVerticalPorts`, `NumHorizontalPorts`, and `IsDualPolarized`.
* (antenna) `GetNumberOfElements` is renamed to `GetNumElems` for the sake of simplifying the long lines of code that use complex mathematical expressions.
* (core) The EnumValue class now also supports enum class in addition to plain enums. As a result of this change, attributes that wrap enums must update the syntax for the `MakeEnumAccessor` method call. Where you once were able to write, for example (from attribute-test-suite.cc):
```cpp
MakeEnumAccessor(&AttributeObjectTest::m_enum),
@@ -36,24 +41,22 @@ Changes from ns-3.40 to ns-3-dev
```cpp
MakeEnumAccessor<Test_e>(&AttributeObjectTest::m_enum),
```
* (internet) Deprecated `Ipv4::WeakEsModel` and `Ipv4::GetWeakEsModel()`, `Ipv4::SetWeakEsModel(bool)` methods. Moved `Ipv6L3Protocol::StrongEndSystemModel` to `Ipv6::StrongEndSystemModel` and added `Ipv4::StrongEndSystemModel` with corresponding `GetStrongEndSystemModel()` and `SetStrongEndSystemModel(bool)` methods to improve end system model configuration options.
* (lr-wpan) Change the CapabilityField parameter in `LrWpanMac::MlmeAssociateRequest` and `LrWpanMac::MlmeAssociateIndication` to a standard bitmap.
* (lr-wpan) Change the MAC SuperframeField usage to a standard bitmap, this change impact parameters in the `BeaconPayloadHeader`.
* (lr-wpan) Create a new abstract class that defines the form of any Lr-wpan MAC layers (`LrWpanMacBase`).
* (lr-wpan) Add the capability to see the enum values of the MAC transition states in log prints for easier debugging.
* (lr-wpan) Group MAC status enumerations into a single `LrWpanMacStatus` enumeration in `lr-wpan-mac-base.h.`
* The spelling of the following files, classes, functions, constants, defines and enumerated values was corrected; this will affect existing users who were using them with the misspelling.
* (lte) Struct member `fdbetsFlowPerf_t::lastTtiBytesTrasmitted` in file `fdbet-ff-mac-scheduler.h` was renamed `fdbetsFlowPerf_t::lastTtiBytesTransmitted`.
* (lte) Struct member `tdbetsFlowPerf_t::lastTtiBytesTrasmitted` in file `tdbet-ff-mac-scheduler.h` was renamed `fdbetsFlowPerf_t::lastTtiBytesTransmitted`.
* (lte) Struct member `pfsFlowPerf_t::lastTtiBytesTrasmitted` in file `pf-ff-mac-scheduler.h` was renamed `fdbetsFlowPerf_t::lastTtiBytesTransmitted`.
* (lr-wpan) Change the CapabilityField parameter in `LrWpanMac::MlmeAssociateRequest` and `LrWpanMac::MlmeAssociateIndication` to a standard bitmap.
* (lr-wpan) Change the MAC SuperframeField usage to a standard bitmap, this change impact parameters in the `BeaconPayloadHeader`.
* (lr-wpan) Create a new abstract class that defines the form of any Lr-wpan MAC layers (`LrWpanMacBase`).
* (sixlowpan) Remove `ForceEtherType` and `EtherType` attributes, and use RFC 7973 EtherType for interfaces supporting an EtherType.
* (spectrum) `PhasedArraySpectrumPropagationLossModel::CalcRxPowerSpectralDensity` return type is changed from `Ptr<SpectrumValue>` to `Ptr<SpectrumSignalParameters>` to support MIMO, because when multiple transmit and receive antenna ports are present, it is not enough to have a single PSD (represented by `Ptr<SpectrumValue>`) but also the 3D channel matrix is needed per receive and transmit antenna port. Notice that `CalcRxPowerSpectralDensity` is typically called from within `MultiModelSpectrumChannel`, but if some external ns-3 module is calling directly this function, it can still access to its original return value through `Ptr<SpectrumSignalParameters>` which contains `Ptr<SpectrumValue>`.
* (wifi) The `HeConfiguration::MpduBufferSize` attribute is now obsolete. Use the `WifiMac::MpduBufferSize` attribute instead.
* (wifi) The `LinkSetupCanceled` trace source of `StaWifiMac` has been obsoleted because disassociation does not occur at link level for non-AP MLDs.
* (antenna) `UniformPlannarArray` has new attributes `NumVerticalPorts`, `NumHorizontalPorts`, and `IsDualPolarized`.
* (antenna) `GetNumberOfElements` is renamed to `GetNumElems` for the sake of simplifying the long lines of code that use complex mathematical expressions.
* (spectrum) `PhasedArraySpectrumPropagationLossModel::CalcRxPowerSpectralDensity` return type is changed from `Ptr<SpectrumValue>` to `Ptr<SpectrumSignalParameters>` to support MIMO, because when multiple transmit and receive antenna ports are present, it is not enough to have a single PSD (represented by `Ptr<SpectrumValue>`) but also the 3D channel matrix is needed per receive and transmit antenna port. Notice that `CalcRxPowerSpectralDensity` is typically called from within `MultiModelSpectrumChannel`, but if some external ns-3 module is calling directly this function, it can still access to its original return value through `Ptr<SpectrumSignalParameters>` which contains `Ptr<SpectrumValue>`.
* (wifi) The default value for `WifiRemoteStationManager::RtsCtsThreshold` has been increased from 65535 to 4692480.
* (lr-wpan) Add the capability to see the enum values of the MAC transition states in log prints for easier debugging.
* (sixlowpan) Remove `ForceEtherType` and `EtherType` attributes, and use RFC 7973 EtherType for interfaces supporting an EtherType.
* (lr-wpan) Group MAC status enumerations into a single `LrWpanMacStatus` enumeration in `lr-wpan-mac-base.h.`
* (internet) Deprecated `Ipv4::WeakEsModel` and `Ipv4::GetWeakEsModel()`, `Ipv4::SetWeakEsModel(bool)` methods. Moved `Ipv6L3Protocol::StrongEndSystemModel` to `Ipv6::StrongEndSystemModel` and added `Ipv4::StrongEndSystemModel` with corresponding `GetStrongEndSystemModel()` and `SetStrongEndSystemModel(bool)` methods to improve end system model configuration options.
* (wifi) `SpectrumWifiHelper::SpectrumChannelSwitched()` is now static
### Changes to build system
@@ -65,8 +68,9 @@ Changes from ns-3.40 to ns-3-dev
* Added guard rails for scratch targets missing or containing more than one `main` function.
### Changed behavior
* (internet) TCP Cubic (the default congestion control in ns-3) now supports TCP-friendliness by default (see RFC 9438 Section 4.3), making the congestion window growth somewhat more aggressive. This follows the default Linux behavior.
* (sixlowpan) Now uses RFC 7973 Ethertype by default
* (spectrum) SpectrumChannel objects and the loss/delay models attached are now automatically initialized (Object::Initialize) at time zero
* (tcp) TCP Cubic (the default congestion control in ns-3) now supports TCP-friendliness by default (see RFC 9438 Section 4.3), making the congestion window growth somewhat more aggressive. This follows the default Linux behavior.
* (wifi) Increase the duration of the timer started when waiting for an ADDBA_RESPONSE from 1ms to 5ms to better account for the time required by the recipient to access the medium and complete the frame exchange (which may involve protection with (MU-)RTS/CTS).
Changes from ns-3.39 to ns-3.40

42
RELEASE_NOTES.md
View File

@@ -13,34 +13,52 @@ 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.41
------------
### Supported platforms
This release is intended to work on systems with the following minimal
requirements (Note: not all ns-3 features are available on all systems):
- g++-9 or later, or LLVM/clang++-10 or later
- Python 3.6 or later
- CMake 3.13 or later
- (macOS only) Xcode 11 or later
- (Windows only) Msys2/MinGW64 toolchain or WSL2
Python API requires [Cppyy](https://cppyy.readthedocs.io/en/latest/installation.html) and works for Linux only. Specifically, avoid Cppyy version 3; stay with version 2.4.2 for this release.
### New user-visible features
- (antenna) !1337 - `UniformPlanarArray` is extended to support multiple horizontal and vertical antenna ports, and dual-polarized antennas.
- (core) !1364 - The `MakeEnumAccessor` was changed to support `enum class` types
- (core) !1802 - Added support for Bernoulli and Binomial random variables (`BernoulliRandomVariable`, `BinomialRandomVariable`)
- (internet) #1001 - TCP Cubic now supports Reno-friendly operation by default.
- (internet) !1817 - Resolved inconsistency in behavior regarding the Strong End System Model between IPv4 and IPv6. Attributes `Ipv6L3Protocol::StrongEndSystemModel` and `Ipv4::WeakEsModel` have been aligned to provide a consistent user experience and avoid confusion
- (lr-wpan) !1686 - Change CapabilityField to standard bitmap
- (lr-wpan) !1698 - Change SuperframeField to standard bitmap
- (lr-wpan) !1706 - Create MAC layer abstraction (decoupling, alternative MACs)
- (wifi) Added support for BlockAck buffer size of up to 1024 MPDUs (EHT STAs only)
- (antenna) !1337 - `UniformPlanarArray` is extended to support multiple horizontal and vertical antenna ports, and dual-polarized antennas.
- (spectrum)!1337 - `ThreeGppSpectrumPropagationLossModel` and `ThreeGppChannelModel` are extended to support multi-port and dual-polarized antenna arrays which is a basis for enabling 3GPP MIMO simulations in ns-3.
- (wifi) - Align default RTS threshold to 802.11-2020
- (wifi) - Added EHT support for Ideal rate manager
- (wifi) - Reduce error rate model precision to fix infinite loop when Ideal rate manager is used with EHT
- (lr-wpan) !1711 - Add `pCurrentPage` and `pCurrentChannel` attributes to MLME-GET.request primitive
- (lr-wpan) !1706 - Create MAC layer abstraction (decoupling, alternative MACs) via a new `LrWpanBase` class
- (lr-wpan) !1794 - Group MAC primitives status enumerations into a single enumeration
- (core) !1802 - Added support for Bernoulli and Binomial random variables (`BernoulliRandomVariable`, `BinomialRandomVariable`)
- (internet) !1817 - Resolved inconsistency in behavior regarding the Strong End System Model between IPv4 and IPv6. Attributes `Ipv6L3Protocol::StrongEndSystemModel` and `Ipv4::WeakEsModel` have been aligned to provide a consistent user experience and avoid confusion
- (spectrum)!1337 - `ThreeGppSpectrumPropagationLossModel` and `ThreeGppChannelModel` are extended to support multi-port and dual-polarized antenna arrays which is a basis for enabling 3GPP MIMO simulations in ns-3.
- (wifi) - Added support for BlockAck buffer size of up to 1024 MPDUs (EHT STAs only)
- (wifi) - Aligned default RTS threshold to 802.11-2020
- (wifi) - Added EHT support for Ideal rate manager
### Bugs fixed
- (lr-wpan) !1673 - Fixes PHY BUSY_RX -> RX_ON operation
- (lr-wpan) !1769 - `DoDispose` SIGSEGV and beacon fixes
- (network) !1746 - `PacketSocketClient` not scheduling `Send()` for packet bursts
- (network) !1793 - Fix string to MAC address parsing logic
- (tap-bridge) !1540 - Update examples to support modern Wi-Fi standards
- (tcp) !1788, !1825 - Fix several small issues with `examples/tcp/tcp-bbr-example.cc` and `examples/tcp/tcp-linux-reno.cc`
- (tcp) !1812 - Several small fixes to TCP retransmission logic were added, based on trace comparison with OMNeT++
- (tcp) #1026 - TcpRateLinux (delivery rate estimation) had an incorrect update to the rate sample
- (visualizer) !1730 - Fix label positioning in PyViz
- (wifi) - Fix agreement not always properly torn down when Block Ack inactivity timeout is elapsed
- (wifi) - Stop A-MSDU aggregation when an A-MSDU is found in the queue
- (lr-wpan) !1769 - `DoDispose` SIGSEGV and beacon fixes
- (wifi) - ReportAmpduTxStatus called twice when sending explicit BAR upon missed BlockAck
- (wifi) - Fix regression causing BlockAckReq frames to be sent with data rates instead of control rates