Skip to content

Commit 61ef6cf

Browse files
committed
docs(conventions): record that DTLS records chain like TLS's (#2535)
The Chained Records ruling on protocol-family-grouping.rst named DTLS as not chaining; DTLS records sharing a datagram are now chained layers too.
1 parent 1e572f1 commit 61ef6cf

1 file changed

Lines changed: 7 additions & 6 deletions

File tree

‎docs/source/contributing/conventions/protocol-family-grouping.rst‎

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -230,12 +230,13 @@ are all ``False``; only ``frame.protochain`` matches them.
230230
Chained Records
231231
~~~~~~~~~~~~~~~
232232

233-
**TLS and SSLv2 records sharing a TCP segment are chained layers, not a list on one
234-
layer** (:issue:`2517`, :issue:`2567`): each record dissected after the first is the
235-
previous record's payload, so a TLS record's dynamic alias names its own version -- a
236-
``ServerHello`` then a ``ChangeCipherSpec`` read ``TCP:TLS 1.3:TLS 1.2`` -- and an SSLv2
237-
``CLIENT-HELLO`` then a ``CLIENT-MASTER-KEY`` read ``TCP:SSLv2:SSLv2``. DTLS does not
238-
chain: two DTLS records in one datagram read ``DTLS 1.2:Raw`` (:issue:`2535`).
233+
**TLS and SSLv2 records sharing a TCP segment, and DTLS records sharing a UDP datagram,
234+
are chained layers, not a list on one layer** (:issue:`2517`, :issue:`2567`,
235+
:issue:`2535`): each record dissected after the first is the previous record's payload,
236+
so a TLS or DTLS record's dynamic alias names its own version -- a ``ServerHello`` then a
237+
``ChangeCipherSpec`` read ``TCP:TLS 1.3:TLS 1.2``, and a DTLS 1.2 record then a DTLS 1.3
238+
unified-header record read ``UDP:DTLS 1.2:DTLS 1.3`` -- and an SSLv2 ``CLIENT-HELLO``
239+
then a ``CLIENT-MASTER-KEY`` read ``TCP:SSLv2:SSLv2``.
239240

240241
.. _protocol-family-canonical-names:
241242

0 commit comments

Comments
 (0)