Download Latest Version v0.52.0 source code.tar.gz (629.0 kB)
Email in envelope

Get an email when there's a new version of A QUIC implementation in pure Go

Home / v0.52.0
Name Modified Size InfoDownloads / Week
Parent folder
README.md 2025-05-20 9.8 kB
0
v0.52.0 source code.tar.gz 2025-05-20 629.0 kB
0
v0.52.0 source code.zip 2025-05-20 866.1 kB
3 3 weekly downloads
Totals: 3 Items   1.5 MB 3

This release focus on HTTP/3 graceful shutdown using the GOAWAY mechnism.

On the server side graceful shutdown is initiated by calling the http3.Server.Shutdown method:

  • A single GOAWAY frame is sent, instructing the client to not issue any new requests (#5114).
  • New requests are rejected by resetting the streams using the H3_REQUEST_REJECTED reset error code: [#5116].
  • QUIC listeners created by the HTTP/3 server (i.e. when using http3.Server.ListenAndServe and ListenAndServeTLS) are immediately closed (#5101). QUIC listeners created by the application (i.e. when using http3.Server.ServeListener) are left running, it is the application's responsibility to close them, or use them in a new server instance (#5129).
  • Note that the during the graceful shutdown period, the server does not close existing connections, as this is racy in the presence of packet reordering.

On the client side, when receiving a GOAWAY frame:

  • No new streams will be opened on the new connection. Requests to the same origin will be sent on a freshly established QUIC connection.
  • Once all requests have completed / were cancelled, the underlying QUIC connection is closed: [#5143] and [#5145].

Breaking Changes

  • Transport.ConnContext now passes the ClientInfo to the callback, and allows rejecting handshakes by introducing an error return value: [#5122]. This allows applications to build more sophisticated DoS defenses. Thanks to @sukunrt!
  • Connections accepted from a Listener using the Listen and ListenAddr convenience functions now aren't closed when the listener is closed. This makes the shutdown behavior consistent with listeners created from a Transport, and the standard library's net.Listener: [#5108].

Other Notable Changes

  • The TLS ClientHello is now fragmented into multiple pieces, complicating Deep Packet Inspection of the handshake by middlebox: [#5107]. This behavior can be disabled by setting the QUIC_GO_DISABLE_CLIENTHELLO_SCRAMBLING environment variable.
  • Kernel control messages for ECN and for picking the correct network interface now work on big-endian platforms such as s390x: [#5094] and [#5105]. Thanks to @Zxilly!
  • The RTT estimate is now stored in the resumption token (and not in the TLS session ticket): [#5065]. Thanks to @tanghaowillow!

Fixes

  • http3: The Alt-Svc entry is now removed when http3.Server.Serve returns: [#5093].
  • http3: http3.Server.ServeQUICConn now returns http.ErrServerClosed when called on a closed server: [#5095].
  • http3: The datagram receive loop now doesn't prematurely return when receiving a datagram for an unknown stream: [#5136].
  • http3: Requests are now only retried when it can be guaranteed that the server didn't process the request: [#5141].
  • http3: Prevent a stream leak when the server sends too many 1xx responses: [#5144].

Behind The Scenes

As in the last couple of releases, we continued our ongoing effort to migrate away from the Ginkgo test suite (tracking issue #3652), mostly in the HTTP/3 package: [#5068], [#5069], [#5070], [#5073], [#5075], [#5078], [#5067], [#5081], [#5085], [#5096], [#5133]. There are still ~1400 LOC of Ginkgo tests to clean up, scattered across the code base.

Changelog

New Contributors

Full Changelog: https://github.com/quic-go/quic-go/compare/v0.51.0...v0.52.0

Source: README.md, updated 2025-05-20