Pull request #27: On branch acm/Rel7.3.0/OBUDPST-33

Merge in OBUDPST/udpst from acm/Rel7.3.0/OBUDPST-33 to develop * commit '9a8bc29079b476468bc88a241b44a71402f86b75': CHANGELOG.MD edited online with Bitbucket On branch acm/Rel7.3.0/OBUDPST-33 Changes to be committed: modified: CHANGELOG.MD modified: CMakeLists.txt modified: README.md new file: ob-udpst_output_mapping_to_current_JSON_and_TR-471_info_model-v33-20211118_071424.pdf modified: protocol.md
BroadbandForum · Nov 19, 2021 · e926d7c · e926d7c
2 parents 04ee4c2 + 9a8bc29
commit e926d7c
Show file tree

Hide file tree

Showing 5 changed files with 26 additions and 5 deletions.
diff --git a/CHANGELOG.MD b/CHANGELOG.MD
@@ -1,8 +1,19 @@
-# CHANGELOG.MD for udpst 7.1.0 Release
+# CHANGELOG.MD for udpst 7.x.0 Releases
 
-*The udpst utility conforms to TR-471. The latest TR-471 specification can be found at
+*The udpst utility conforms to TR-471 and TR-471 Issue 2. The latest TR-471 specification can be found at
 https://www.broadband-forum.org/technical/download/TR-471.pdf *
 
+# 2021-11-17: [UDPST 7.3.0](https://github.com/BroadbandForum/OB-UDPST/releases/tag/v7.3.0)
+
+This release has a greatly expanded (optional) JSON-formatted version of the command-line output.
+
+Further, this release implements virtually all the TR-471 Issue 2 and TR-181 IPLayerCapacity{} data model elements.
+The File "ob-udpst_output_mapping_to_current_JSON and_TR-471_info model-v33-20211118_071424.pdf" provides the mapping
+where names differ in small ways, or where additional names are provided in the JSON format or STDOUT.
+
+We also include measurement of Ethernet Interface traffic during a test, to help identify when customer traffic was 
+present that might cause the IP-Layer Capacity measurement to under-estimate the maximum capacity.
+
 ## 2021-08-20: [UDPST 7.2.1](https://github.com/BroadbandForum/OB-UDPST/releases/tag/v7.2.1)
 
 This supplemental release incorporates results from recent testing, where two changes 

diff --git a/CMakeLists.txt b/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 "7.2.1")
+set(SOFTWARE_VER "7.3.0")
 
 INCLUDE (CheckIncludeFiles)
 INCLUDE (CheckFunctionExists)

diff --git a/README.md b/README.md
@@ -14,8 +14,8 @@ ITU-T Y.Sup60, https://www.itu.int/rec/T-REC-Y.Sup60/en
 - ETSI Technical Specification 103 222 Part 2 (08/2019): _Reference benchmarking and KPIs for High speed internet_, 
 ETSI TS 103 222-2, V.1.2.1, https://www.etsi.org/deliver/etsi_ts/103200_103299/10322202/01.02.01_60/ts_10322202v010201p.pdf
 
-- IETF IPPM Internet Draft (Approved version 12): _Metrics and Methods for One-way IP Capacity_, 
-https://datatracker.ietf.org/doc/draft-ietf-ippm-capacity-metric-method/
+- IETF RFC 9097: _Metrics and Methods for One-way IP Capacity_, 
+https://datatracker.ietf.org/doc/html/rfc9097
 
 - ETSI Technical Report  103 702 (2020-10): _Speech and multimedia Transmission Quality (STQ); 
 QoS parameters and test scenarios for assessing network capabilities in 5G performance measurements_,
@@ -270,6 +270,9 @@ the connection which closes the socket and deallocates it.
 **More Info**
 
 For much more detail on the test protocol, see the ./protocol.md file.
+Also, an Internet-Draft, 
+https://datatracker.ietf.org/doc/html/draft-morton-ippm-capacity-metric-protocol-02
+describes Protocol Version 8 in even more detail.
 
 ## Linux Socket Buffer Optimization
 For very high speeds (typically above 1 Gbps), the socket buffer maximums of
@@ -322,6 +325,9 @@ occurs, the error status will be 1 (one) and the most recent warning message
 will be included. If a hard error or failure occurs the error status will be
 -1 (negative one) and an error message will be included.
 
+The file "ob-udpst_output_mapping...pdf" provides a mapping between JSON key names,
+TR-471 names, TR-181 names, and the ob-udpst STDOUT names for various results.
+
 *Note: When stdout is not redirected to a file, JSON may appear clipped due to
 non-blocking console writes.*
 

diff --git a/ob-udpst_output_mapping_to_current_JSON_and_TR-471_info_model-v33-20211118_071424.pdf b/ob-udpst_output_mapping_to_current_JSON_and_TR-471_info_model-v33-20211118_071424.pdf
diff --git a/protocol.md b/protocol.md
@@ -1,5 +1,9 @@
 # Test Protocol Description ( version 8 )
 
+(An Internet-Draft, 
+https://datatracker.ietf.org/doc/html/draft-morton-ippm-capacity-metric-protocol-02
+describes Protocol Version 8 in even more detail.)
+
 ## Introduction 
 The udpst utility uses a unique Control protocol and test packet format. 
 All control message PDUs and test PDUs use UDP transport, with limited reliability