Skip to content

Mid-stream trailers #313

Closed
Closed

Description

@mnot

As discussed in #220 and quicwg/base-drafts#3265, mid-stream trailers (i.e., those that arrive before the end of the payload body) are interesting.

A few things to discuss:

  • What are some potential use cases?

  • We recently stopped automatically combining trailers into headers, as that created a lot of issues. What about these -- are they yet again distinct from trailers as well as headers? Or can they be "downgraded" into trailers automatically? In other words, when transitioning from a hop that supports these from one that doesn't, are they just dropped onto the floor?

  • Related - is the expectation that implementations will create separate APIs for these, or would it be that trailers are just available / writable early?

  • What relationship does one of these have to the payload body? E.g., could I write one that "knows" exactly where in the body it occurs, so that it could sign a chunk of the body relative to it? Or could a handling implementation change its ordering in relation to body bytes?

Activity

  1. ioggstream commented on Feb 10, 2020

    @ioggstream
    Contributor

    Some preliminary considerations.

    Potential use cases for mid-stream trailers

    • Incremental checksums eg. MICE
    • Service management (eg. convey the ETA of the transfer, ...)
    • Sending signatures of partial body (in mid-stream) has some complexities respect to sending a signature of the whole message in the header/trailer section, and requires a security assessment.

    Combining

    • mid-stream trailers, when used for integrity can't be dropped without informing the user agent
    • They probably need to be defined as 1#field-item because mid-stream trailers will be sent multiple times (eg. one per chunk)
    • Whenever they are tied to the partial transmitted representation, they will eventually be unuseful when merged, unless they have some associative property

    Relationship with payload body

    • They will be especially useful when tied to a portion of the body
    • They will be significantly less useful when not tied to a portion of the body
  2. wenbozhu commented on Feb 10, 2020

    @wenbozhu

    Potential use cases

    • mostly limited to long-lived streaming traffic, i.e. long-lived "uploading/downloading"
    • in-band signaling support such as load reporting, app-level flow-control, authn update etc

    Semantics

    • trailers are a special case of mid-stream metadata, e.g. only trailers are able to convey the status of the entire transaction or the entire resource (body)
    • our experience is that in-order delivery is useful and often assumed, since the underlying transport (for HTTP body) is in-order and reliable. Out-of-order metadata is likely a use case for connection-level metadata, IMO
    • with the above assumption on in-order delivery, you really only need one API for delivering in-stream or trailer metadata

    Multi-part

    • without in-stream metadata, you would have to use multipart (with all the overhead)
    • for structured data, the original content-type can be preserved, e.g. JSON stream; and for media data, the content-type may have to be application/octet-stream
  3. davidben commented on Mar 17, 2020

    @davidben

    Copying over the questions from @vasilvv over in httpwg/http-extensions#986, as they are good ones:

    1. What does "semantic model of being equivalent to trailers" mean here?
    2. Would the proposed frames require a new form of flow control?
    3. Are the proposed frames supposed to be associated with a specific position in HTTP response body?
    4. How would this interact with caching?
  4. royfielding commented on Jun 11, 2020

    @royfielding
    Member
    1. The semantic model of trailers is that they provide additional metadata that may (or may not) be useful to recipients but was not available prior to the initial body data sent. How the are useful and what they might contain would be defined by the field name. A recipient is free to drop the trailer metadata.
    2. A mid-stream trailer frame would have the same role in flow control as a HEADERS frame, which is none at the current time.
    3. The proposed frames would not have any specific position, but the values inside trailer fields might identify specific positions (on their own, regardless of framing).
    4. A cache would either drop the values or store them separately as trailer fields in the order received.
  5. LPardue commented on Jun 11, 2020

    @LPardue
    Contributor

    A mid-stream trailer frame would have the same role in flow control as a HEADERS frame, which is none at the current time.

    HTTP/2's flow control only cares about DATA frames. But all frames are subject to TCP's flow control. In HTTP/3, all frames are sent on streams which is subject to QUIC's flow control.

    Responding to the original question, I don't know what a "new form of flow control" would look like and I don't see how one would improve things.

  6. mnot commented on Jun 24, 2020

    @mnot
    MemberAuthor

    What's the minimal change that would need to happen to semantics to enable this in a future version of HTTP (or an extension to an existing one)?

  7. MikeBishop commented on Jul 8, 2020

    @MikeBishop
    Contributor

    I think you would need to make "trailer part" less special, and simply say that a version of HTTP can define a way to carry additional field sections during or after the body. H1-H3 currently define a way to carry only one such block, but an extension could provide more.

  8. added this to the pre-reorg milestone on Aug 20, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Type

No type

Projects

No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions