Skip to content

Commit 47c49c3

Browse files
authored
State clearly what lengths mean for stream and datagram data moved (#395)
* State clearly what lengths mean for stream and datagram data moved * lose user
1 parent 65c9758 commit 47c49c3

File tree

1 file changed

+9
-7
lines changed

1 file changed

+9
-7
lines changed

draft-ietf-quic-qlog-quic-events.md

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1167,10 +1167,11 @@ between the different layers. This helps make clear the flow of data, how long
11671167
data remains in various buffers, and the overheads introduced by individual
11681168
layers. The event has Base importance level; see {{Section 9.2 of QLOG-MAIN}}.
11691169

1170-
For example, it can be useful to understand when when data moves from an
1170+
This event relates to stream data only. There are no packet or frame headers and
1171+
length values in the `length` or `raw` fields MUST reflect that.
1172+
1173+
For example, it can be useful to understand when data moves from an
11711174
application protocol (e.g., HTTP) to QUIC stream buffers and vice versa.
1172-
Similarly, when data moves from the application protocol layer into a
1173-
user-facing application such as a web browser.
11741175

11751176
The `stream_data_moved` event can provide insight into whether received data on
11761177
a QUIC stream is moved to the application protocol immediately (for example per
@@ -1208,8 +1209,7 @@ QUICStreamDataMoved = {
12081209
* $$quic-streamdatamoved-extension
12091210
}
12101211

1211-
$DataLocation /= "user" /
1212-
"application" /
1212+
$DataLocation /= "application" /
12131213
"transport" /
12141214
"network"
12151215

@@ -1226,9 +1226,11 @@ clear the flow of data, how long data remains in various buffers, and the
12261226
overheads introduced by individual layers. The event has Base importance level;
12271227
see {{Section 9.2 of QLOG-MAIN}}.
12281228

1229+
This event relates to datagram data only. There are no packet or frame headers and
1230+
length values in the `length` or `raw` fields MUST reflect that.
1231+
12291232
For example, passing from the application protocol (e.g., WebTransport) to QUIC
1230-
Datagram Frame buffers and vice versa. Similarly, when data moves from the
1231-
application protocol layer into a user-facing application such as a web browser.
1233+
Datagram Frame buffers and vice versa.
12321234

12331235
The `datagram_data_moved` event can provide insight into whether received data
12341236
in a QUIC Datagram Frame is moved to the application protocol immediately (for

0 commit comments

Comments
 (0)