QUIC Glossary: TXKU, RXKU, KU

Reviewed-by: Tomas Mraz <tomas@openssl.org>
Reviewed-by: Matt Caswell <matt@openssl.org>
Reviewed-by: Paul Dale <pauli@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/21029)

diff --git a/doc/designs/quic-design/glossary.md b/doc/designs/quic-design/glossary.md
index 0a45cdc027b67414193e489836bf0ff76c76ac23..1f947ef37d417b530601819cf0ab0b51910b9bf7 100644 (file)
--- a/doc/designs/quic-design/glossary.md
+++ b/doc/designs/quic-design/glossary.md
@@ -82,6 +82,8 @@ may be maintained at a given time. See `quic_record_rx.h` for details.
 
 **KS:** See Keyslot.
 
+**KU:** Key update. See also TXKU, RXKU.
+
 **Locally-initiated:** Refers to a QUIC stream which was initiated by the local
 application rather than the remote peer.
 
@@ -188,6 +190,10 @@ provides indication of when flow control frames increasing a peer's flow control
 budget should be generated. Exists in both connection-level and stream-level
 instances.
 
+**RXKU:** RX key update. The detected condition whereby a received packet
+has a flipped Key Phase bit, meaning the peer has initiated a key update.
+Causes a solicited TXKU. See also TXKU.
+
 **RXL:** RXE list. See RXE.
 
 **RCMPPL:** The number of bytes left in a packet whose payload we are currently
@@ -213,6 +219,11 @@ Owned by the QTX.
 **TXFC:** TX flow control. This determines how much can be transmitted to the
 peer. Exists in both connection-level and stream-level instances.
 
+**TXKU:** TX key update. This refers to when a QTX signals a key update for the
+TX direction by flipping the Key Phase bit in an outgoing packet. A TXKU can be
+either spontaneous (locally initiated) or in solicited (in response to receiving
+an RXKU). See also RXKU.
+
 **TXL:** TXE list. See TXE.
 
 **TXP:** TX packetiser. This is responsible for generating yet-unencrypted