Add support for Simple Two-Way Active Measurement Protocol (STAMP)

[cscarpitta]

This PR adds the support for the Simple Two-Way Active Measurement Protocol (STAMP) to Scapy. STAMP enables the measurement of both one-way and round-trip performance metrics, like delay, delay variation, and packet loss.

This PR implements the main specifications of STAMP described in RFC 8762 and the STAMP Test Session Identifier (SSID) defined in Section 3 of RFC 8972.

Signed-off-by: Carmine Scarpitta carmine.scarpitta@uniroma2.it

[codecov]

Codecov Report

Merging #3742 (997d33e) into master (799f272) will increase coverage by 0.05%.
The diff coverage is 86.48%.

@@            Coverage Diff             @@
##           master    #3742      +/-   ##
==========================================
+ Coverage   86.00%   86.05%   +0.05%     
==========================================
  Files         299      301       +2     
  Lines       68111    68341     +230     
==========================================
+ Hits        58579    58811     +232     
+ Misses       9532     9530       -2     

Impacted Files	Coverage Δ
scapy/contrib/stamp.py	86.48% <86.48%> (ø)
scapy/arch/windows/__init__.py	67.16% <0.00%> (-0.56%)	⬇️
scapy/contrib/automotive/ecu.py	94.33% <0.00%> (-0.34%)	⬇️
scapy/pipetool.py	84.10% <0.00%> (-0.23%)	⬇️
scapy/config.py	80.55% <0.00%> (ø)
scapy/layers/mspac.py	93.67% <0.00%> (ø)
scapy/fields.py	91.34% <0.00%> (+0.53%)	⬆️
scapy/layers/kerberos.py	70.93% <0.00%> (+1.02%)	⬆️
scapy/layers/dcerpc.py	78.62% <0.00%> (+1.88%)	⬆️

[cscarpitta]

@gpotter2 Many thanks for the quick review. I addressed all your suggestions and force-updated the branch.

[cscarpitta]

@gpotter2 I updated the PR to fix some docstring warnings reported by Sphinx

[cscarpitta]

Build doc is failing with the following error:

Theme error:
An error happened in rendering the page advanced_usage.
Reason: ValueError('too many values to unpack (expected 3)')
ERROR: InvocationError for command /home/runner/work/scapy/scapy/.tox/docs/bin/sphinx-build -W --keep-going -b html . _build/html (exited with code 2)

This is due to a bug in sphinx_rtd_theme, which does not work correctly with the latest sphinx version.

The problem is described here: sphinx-doc/sphinx#10853 (comment)
There is an open PR to fix the problem in sphinx_rtd_theme: readthedocs/sphinx_rtd_theme#1344

Maybe we need a workaround waiting for the PR to be merged?

[gpotter2]

PR is looking good, just two minor questions !

[cscarpitta]

@gpotter2 Thank you for the great review! I added source port binding and force-pushed the branch.