OBUDPST-56: Interface Stats, OBUDPST-57: Multi-key,

OBUDPST-58: Header Checksum

This change addresses the need to always handle interface
byte counters as 64-bit values, regardless of the machine
architecture. It also adds multi-key support for large
deployments and an optional PDU header checksum.
Additionally,...
- Several compiler warnings were cleaned up
- Alerts and warnings are now displayed for invalid
  control and data PDUs (but can also be suppressed)
- The max requestable bandwidth on the client (-B mbps)
  increased from 10000 to 32767
- The 64-bit ntohll/htonll macros were modified to allow
  for big-endian architectures
- A column for lost status feedback was added to export
- The authentication key size increased from 32 to 64
- New ErrorStatus error and warning values were added
- A column for interface Mbps was added to export
- A fix for upstream BW that is never deallocated

Author: Len Ciavattone

CHANGELOG.MD

@@ -3,7 +3,7 @@
 *The udpst utility conforms to TR-471 (Issue 4). The latest TR-471 specification can be found at
 https://www.broadband-forum.org/technical/download/TR-471.pdf*
 
-# 2024-04-21: [UDPST 8.2.0] (https://github.com/BroadbandForum/OBUDPST/releases/tag/v8.2.0)
+# 2024-07-11: [UDPST 8.2.0] (https://github.com/BroadbandForum/OBUDPST/releases/tag/v8.2.0)
 
 This release addresses the need to always handle interface byte counters as 64-bit values,
 regardless of the machine architecture (OBUDPST-56). Also, for improved management of large-scale
@@ -29,8 +29,8 @@ data PDUs (both can be suppressed via compilation flags, causing them to be sile
 * The maximum authentication key size was increase from 32 to 64
 * A new ErrorStatus error value for multi-key and warning value for invalid data PDUs was added
 * An additional column for interface Mbps (from "-E intf") was added to the metadata export
-* A fix was added for scenarios where a timeout occurs due to a lost test activation request and
-the allocated upstream bandwidth is not deallocated.
+* A fix was added for scenarios where a timeout occurs, due to a lost test activation request, and
+the allocated upstream bandwidth on the server is never deallocated
 
 # 2023-11-17: [UDPST 8.1.0] (https://github.com/BroadbandForum/OBUDPST/releases/tag/v8.1.0)
 

CMakeLists.txt

@@ -33,7 +33,7 @@ if(${CMAKE_VERSION} VERSION_GREATER "3.3.0")
 endif()
 set(CMAKE_INCLUDE_CURRENT_DIR ON)
 set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
-set(SOFTWARE_VER "8.2.0(Dev)")
+set(SOFTWARE_VER "8.2.0")
 
 INCLUDE (CheckIncludeFiles)
 INCLUDE (CheckFunctionExists)

README.md

@@ -2,7 +2,7 @@
 Open Broadband-UDP Speed Test (OB-UDPST) is a client/server software utility to
 demonstrate one approach of doing IP capacity measurements as described by:
 
-- Broadband Forum TR-471 Issue 3 (12/2022): _Maximum IP-Layer Capacity Metric,
+- Broadband Forum TR-471 Issue 4 (2024): _Maximum IP-Layer Capacity Metric,
 Related Metrics, and Measurements_, BBF TR-471,
 https://www.broadband-forum.org/technical/download/TR-471.pdf
 
@@ -734,7 +734,7 @@ receiver's clock).
 - OWD : The one-way delay of the datagram if the sender's and receiver's clocks
 are sufficiently synchronized, else it merely reflects the difference in the
 clocks (and could be negative). This value is in milliseconds.
-- IntfMbps : The interface Mbps when the `-E intf` option is used on the client.
+- IntfMbps : The client interface Mbps when the `-E intf` option is used.
 - RTTTxTime : The transmit timestamp used for RTT (Round-Trip Time)
 measurements and carried from the load receiver to the load sender in the
 periodic status feedback messages.
@@ -826,7 +826,7 @@ UDP checksum is being utilized.*
 Independent of whether the header checksum is enabled as an additional PDU
 integrity check (beyond size, format, etc.), new output messaging is displayed
 when an invalid PDU is received. A bad PDU during the control phase (whether a
-corrupted PDU or a rogue UDP datagram) will generate an ALERT and a bad PDU
+corrupted PDU or a rogue UDP datagram) will generate an ALERT while a bad PDU
 during the data phase will generate a WARNING (and result in a warning exit
 status and JSON ErrorStatus). In cases where the udpst control port on the
 server is exposed to the open Internet, and verbose is enabled, this may result