Skip to content

Commit

Permalink
Merge pull request cloudflare#8 from pthatcherg/reference-ietf-doc
Browse files Browse the repository at this point in the history 
Reference IETF docs
  • Loading branch information
@pthatcherg
pthatcherg authored May 15, 2019
2 parents 36be296 + a438c4d commit 8b899b5
Show file tree
Hide file tree
Showing 2 changed files with 27 additions and 47 deletions.
9 changes: 8 additions & 1 deletion include/respec-config.js
View file
Original file line number Diff line number Diff line change
Expand Up @@ -62,13 +62,20 @@ var respecConfig = {
"status": "11 March 2019. Internet draft (work in progress)",
"publisher": "IETF"
},
"WEB-TRANSPORT-QUIC": {
"title": "WebTransport over QUIC"
"href": "https://tools.ietf.org/html/draft-vvv-webtransport-quic-00",
"authors": [
"V. Vasiliev"
]
},
"WEB-TRANSPORT-HTTP3": {
"title": "WebTransport over HTTP/3"
"href": "https://tools.ietf.org/html/draft-vvv-webtransport-http3-00",
"authors": [
"V. Vasiliev"
]
}
},
"TLS13": {
"title": "The Transport Layer Security (TLS) Protocol Version 1.3",
"href": "https://tools.ietf.org/html/rfc8446",
Expand Down
65 changes: 19 additions & 46 deletions index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -1041,81 +1041,54 @@ <h2>Constructors</h2>
<a>throw</a> an <code>NotSupportedError</code> and abort these steps.
</li>
<li>
Let <var>quictransport</var> be a newly constructed
Let <var>transport</var> be a newly constructed
<code><a>QuicTransport</a></code> object.
</li>
<li>Let <var>quictransport</var> have a <dfn>[[\OutgoingStreams]]</dfn>
<li>Let <var>transport</var> have a <dfn>[[\OutgoingStreams]]</dfn>
internal slot representing a sequence of <code><a>OutgoingStream</a></code>
objects, initialized to empty.
</li>
<li>Let <var>quictransport</var> have a <dfn>[[\IncomingStreams]]</dfn>
<li>Let <var>transport</var> have a <dfn>[[\IncomingStreams]]</dfn>
internal slot representing a sequence of <code><a>IncomingStream</a></code>
objects, initialized to empty.
</li>
<li>
Let <var>quictransport</var> have a <dfn>[[\WebTransportState]]</dfn>
Let <var>transport</var> have a <dfn>[[\WebTransportState]]</dfn>
internal slot, initialized to <code>"connecting"</code>.
</li>
<li>Let <var>quictransport</var> have a <dfn>[[\ReceivedDatagrams]]</dfn>
<li>Let <var>transport</var> have a <dfn>[[\ReceivedDatagrams]]</dfn>
internal slot representing a queue of <code>Uint8Array</code>, initialized to empty.
</li>
<li>Let <var>quictransport</var> have a <dfn>[[\ReceiveDatagramsPromise]]</dfn>
<li>Let <var>transport</var> have a <dfn>[[\ReceiveDatagramsPromise]]</dfn>
internal slot representing a <code>Promise&lt;sequence&lt;Uint8Array&gt;&gt;?</code>,
initialized to null.
</li>
<li>Run these steps in parallel:
<ol>
<!-- TODO: Figure out a way to convey the origin in an encrypted manner
and then use a non-empty value like so:
Let <var>serializedOrigin<var> be the empty string ,<code>""</code>.
Let <var>serializedOrigin<var> be <var>quictransport<var>'s
<a href="https://html.spec.whatwg.org/multipage/webappapis.html#relevant-settings-object">relevant settings object</a>'s
<a href="https://html.spec.whatwg.org/multipage/webappapis.html#concept-settings-object-origin">origin</a>,
<a href="https://html.spec.whatwg.org/multipage/origin.html#ascii-serialisation-of-an-origin">serialized</a>.
The user agent MUST include a QUIC transport parameter with ID of web_origin(0x3330)
and value of <var>serializedOrigin</var>.
-->
<li>Establish a QUIC connection to the address identified by the
given host and port.
During connection establishment, use of this API must be indicated
by selecting the ALPN [[!ALPN]] token "wq" in the crypto handshake
and including a QUIC transport parameter with ID web_client(0x333C)
and empty value.
<!-- TODO: register "wq" with IANA. -->
</li>
<li>If the connection fails, set <var>quictransport</var>'s <a>[[\WebTransportState]]</a>
internal slot to <code>"failed"</code> and abort these steps.
</li>
<li>Let <var>joinedAcceptedOrigins</var> be the QUIC transport parameter provided
by the server with ID web_accepted_origins(0x333A). If the transport parameter is
absent, set <var>quictransport</var>'s <a>[[\WebTransportState]]</a>
internal slot to <code>"failed"</code> and abort these steps.
<!-- TODO: register 0x333A with IANA -->
</li>
<li>
Let <var>serializedAcceptedOrigins</var> be
<var>joinedAcceptedOrigins</var> split by the separator
<code>","</code>.
</li>
<li>
Let <var>serializedOrigin</var> be <var>quictransport</var>'s
Let <var>clientOrigin</var> be <var>transport</var>'s
<a href="https://html.spec.whatwg.org/multipage/webappapis.html#relevant-settings-object">relevant settings object</a>'s
<a href="https://html.spec.whatwg.org/multipage/webappapis.html#concept-settings-object-origin">origin</a>,
<a href="https://html.spec.whatwg.org/multipage/origin.html#ascii-serialisation-of-an-origin">serialized</a>.
</li>
<li>If <var>serializedOrigin</var> is a member of <var>serializedAcceptedOrigins</var>
or <var>joinedAcceptedOrigins</var> is equal to <code>"*"</code>,
set <var>quictransport</var>'s <a>[[\WebTransportState]]</a>
internal slot to <code>"connected"</code> and abort these steps.
<li>
Establish a QUIC connection to the address identified by the
given host and port following the procedures in
[[WEB-TRANSPORT-QUIC]] section 3 and using <var>clientOrigin</var>
as the "origin of the client" referenced in section 3.2.
</li>
<li>
If the connection fails, set <var>transport</var>'s <a>[[\WebTransportState]]</a>
internal slot to <code>"failed"</code> and abort these steps.
</li>
<li>
Set <var>quictransport</var>'s <a>[[\WebTransportState]]</a>
internal slot to <code>"failed"</code>.
Set <var>transport</var>'s <a>[[\WebTransportState]]</a>
internal slot to <code>"connected"</code>.
</li>
</ol>
</li>
<li>
Return <var>quictransport</var>.
Return <var>transport</var>.
</li>
</ol>
<dl data-link-for="QuicTransport" data-dfn-for="QuicTransport" class=
Expand Down

0 comments on commit 8b899b5

Please sign in to comment.