mirrors/uquic
1
0
Fork 0
mirror of https://github.com/refraction-networking/uquic.git synced 2025-04-03 20:27:35 +03:00
Code Issues Projects Releases Packages Wiki Activity
Low-level access to the QUIC Initial Packet for mimicry purposes, hard fork of quic-go. https://quic.tlsfingerprint.io
3348 commits 12 branches 6 tags 19 MiB
Find a file
Marten Seemann 9b5a20e772 remove some unused functions
2019-02-27 19:31:53 +09:00
.circleci update CIs to Go 1.12 2019-02-27 09:51:11 +09:00
.travis fix Travis configuration to actually run the integration tests 2018-11-01 18:14:34 +07:00
benchmark split the Session.Close(error) in Close() and CloseWithError(error) 2018-07-06 15:51:35 +07:00
docs add gopher-logo 2016-05-03 10:27:59 +02:00
example use the self-signed certificate for the example server and client 2018-12-13 14:42:25 +06:30
h2quic simplify closing the http.ResponseBody using that CancelRead is a no-op 2019-01-24 16:00:12 +07:00
integrationtests don't run the version negotiation tests with race detector 2019-02-08 13:56:49 +08:00
internal remove some unneccessary type conversions 2019-02-27 19:30:55 +09:00
vendor use (a modified version of) the standard library TLS implementation 2019-02-22 13:33:56 +08:00
.editorconfig add editorconfig 2016-04-15 12:13:33 +02:00
.gitignore add debug.test (dvelve output) to gitignore 2016-05-03 14:26:50 +02:00
.gometalinter.json run gometalinter with staticcheck instead of megacheck 2019-01-22 14:55:12 +07:00
.travis.yml update CIs to Go 1.12 2019-02-27 09:51:11 +09:00
appveyor.yml update CIs to Go 1.12 2019-02-27 09:51:11 +09:00
buffer_pool.go make putting back packet buffers a member function of packetBuffer 2019-01-01 09:50:35 +07:00
buffer_pool_test.go make putting back packet buffers a member function of packetBuffer 2019-01-01 09:50:35 +07:00
Changelog.md release 0.10 2018-08-28 09:12:35 +07:00
client.go cut coalesed packets in the session 2019-02-27 10:03:34 +09:00
client_test.go cut coalesed packets in the session 2019-02-27 10:03:34 +09:00
codecov.yml use Genny to generate typed lists, based on Go standard library code 2018-03-30 15:12:09 +07:00
conn.go add a LocalAddr to the Session 2017-03-10 00:07:27 +07:00
conn_test.go send Version Negotiation packets in a separate Go routine 2018-11-27 17:19:21 +07:00
crypto_stream.go implement the crypto stream for post-handshake crypto messages 2019-02-06 22:51:44 +08:00
crypto_stream_manager.go ignore post-handshake CRYPTO frames 2019-01-26 16:41:01 +08:00
crypto_stream_manager_test.go ignore post-handshake CRYPTO frames 2019-01-26 16:41:01 +08:00
crypto_stream_test.go implement the crypto stream for post-handshake crypto messages 2019-02-06 22:51:44 +08:00
frame_sorter.go move tracking of the final stream offset to the stream 2019-01-23 12:48:37 +07:00
frame_sorter_test.go move tracking of the final stream offset to the stream 2019-01-23 12:48:37 +07:00
framer.go use tls-tris instead of mint 2018-10-26 16:18:49 +07:00
framer_test.go remove some unneccessary type conversions 2019-02-27 19:30:55 +09:00
interface.go remove the error return value from Stream.CancelWrite 2019-01-24 16:00:12 +07:00
LICENSE add Google to license file 2016-12-14 11:54:01 +01:00
mock_ack_frame_source_test.go always send ACKs in the correct packet number space 2019-01-11 11:12:07 +07:00
mock_crypto_data_handler_test.go fix the file name of the mock crypto data handler 2018-11-17 08:08:48 +07:00
mock_crypto_stream_test.go when the encryption level changes, reject data on that crypto stream 2018-10-26 17:09:52 +07:00
mock_frame_source_test.go handle the crypto stream separately in the packet packer 2018-10-01 11:25:57 -07:00
mock_multiplexer_test.go delete unused connections from the multiplexer 2019-01-14 11:33:14 +07:00
mock_packer_test.go add a function to pass the retry token to the packet packer 2019-02-02 09:24:37 +08:00
mock_packet_handler_manager_test.go add a function to close the packet handler map 2019-01-24 18:09:46 +07:00
mock_packet_handler_test.go cut coalesed packets in the session 2019-02-27 10:03:34 +09:00
mock_quic_session_test.go cut coalesed packets in the session 2019-02-27 10:03:34 +09:00
mock_receive_stream_internal_test.go remove the error return value from Stream.CancelRead 2019-01-24 16:00:11 +07:00
mock_sealing_manager_test.go drop support for gQUIC 2018-10-30 10:20:39 +07:00
mock_send_stream_internal_test.go remove the error return value from Stream.CancelWrite 2019-01-24 16:00:12 +07:00
mock_session_runner_test.go immediately remove sessions that were closed remotely 2018-11-16 21:22:32 +07:00
mock_stream_getter_test.go create internal interfaces for send and receive streams 2018-01-10 08:56:13 +07:00
mock_stream_internal_test.go remove the error return value from Stream.CancelWrite 2019-01-24 16:00:12 +07:00
mock_stream_manager_test.go implement and use the MAX_STREAMS frame 2018-11-10 09:38:50 +07:00
mock_stream_sender_test.go queue stream-level window updates from the flow controller directly 2018-05-08 15:17:45 +09:00
mock_unknown_packet_handler_test.go also use the multiplexer for the server 2018-08-08 10:03:22 +07:00
mock_unpacker_test.go move parsing of the extended header to the unpacker 2018-12-14 16:46:40 +06:30
mockgen.go return the Opener from the crypto setup 2018-12-14 16:46:40 +06:30
mockgen_private.sh move the mockgen cleanup commands to the mockgen script 2018-08-11 12:45:48 +07:00
multiplexer.go delete unused connections from the multiplexer 2019-01-14 11:33:14 +07:00
multiplexer_test.go move listening from the multiplexer to the packet handler map 2018-08-08 10:03:20 +07:00
packet_handler_map.go cut coalesed packets in the session 2019-02-27 10:03:34 +09:00
packet_handler_map_test.go cut coalesed packets in the session 2019-02-27 10:03:34 +09:00
packet_packer.go use separate packet number spaces for sending packets 2019-02-11 20:13:05 +08:00
packet_packer_test.go move cutting of coalesced packets to the wire package 2019-02-23 10:24:42 +08:00
packet_unpacker.go move frame parsing to the session 2019-01-03 18:53:36 +07:00
packet_unpacker_test.go move cutting of coalesced packets to the wire package 2019-02-23 10:24:42 +08:00
quic_suite_test.go drop support for gQUIC 2018-10-30 10:20:39 +07:00
README.md update README with the new Go version requirement 2019-02-22 13:34:04 +08:00
receive_stream.go remove some defer statements in the stream 2019-01-24 16:59:13 +07:00
receive_stream_test.go remove the error return value from Stream.CancelRead 2019-01-24 16:00:11 +07:00
send_stream.go remove some unused functions 2019-02-27 19:31:53 +09:00
send_stream_test.go remove the error return value from Stream.CancelWrite 2019-01-24 16:00:12 +07:00
server.go cut coalesed packets in the session 2019-02-27 10:03:34 +09:00
server_test.go cut coalesed packets in the session 2019-02-27 10:03:34 +09:00
session.go cut coalesed packets in the session 2019-02-27 10:03:34 +09:00
session_test.go remove some unused functions 2019-02-27 19:31:53 +09:00
stream.go rename the RST_STREAM frame to RESET_STREAM frame 2018-11-04 12:26:02 +07:00
stream_test.go drop support for gQUIC 2018-10-30 10:20:39 +07:00
streams_map.go return a net.Error when opening streams 2019-01-06 17:18:43 +07:00
streams_map_generic_helper.go implement and use the MAX_STREAMS frame 2018-11-10 09:38:50 +07:00
streams_map_incoming_bidi.go don't delete a stream until it has been accepted 2019-01-23 17:24:10 +07:00
streams_map_incoming_generic.go don't delete a stream until it has been accepted 2019-01-23 17:24:10 +07:00
streams_map_incoming_generic_test.go don't delete a stream until it has been accepted 2019-01-23 17:24:10 +07:00
streams_map_incoming_uni.go don't delete a stream until it has been accepted 2019-01-23 17:24:10 +07:00
streams_map_outgoing_bidi.go return a net.Error when opening streams 2019-01-06 17:18:43 +07:00
streams_map_outgoing_generic.go return a net.Error when opening streams 2019-01-06 17:18:43 +07:00
streams_map_outgoing_generic_test.go return a net.Error when opening streams 2019-01-06 17:18:43 +07:00
streams_map_outgoing_uni.go return a net.Error when opening streams 2019-01-06 17:18:43 +07:00
streams_map_test.go don't delete a stream until it has been accepted 2019-01-23 17:24:10 +07:00
window_update_queue.go never increase the flow control limit for the crypto stream 2018-09-19 09:00:23 -04:00
window_update_queue_test.go never increase the flow control limit for the crypto stream 2018-09-19 09:00:23 -04:00

README.md

A QUIC implementation in pure Go

Godoc Reference Travis Build Status CircleCI Build Status Windows Build Status Code Coverage

quic-go is an implementation of the QUIC protocol in Go. It roughly implements the IETF QUIC draft, although we don't fully support any of the draft versions at the moment.

Version compatibility

Since quic-go is under active development, there's no guarantee that two builds of different commits are interoperable. The QUIC version used in the master branch is just a placeholder, and should not be considered stable.

If you want to use quic-go as a library in other projects, please consider using a tagged release. These releases expose experimental QUIC versions, which are guaranteed to be stable.

Google QUIC

quic-go used to support both the QUIC versions supported by Google Chrome and QUIC as deployed on Google's servers, as well as IETF QUIC. Due to the divergence of the two protocols, we decided to not support both versions any more.

The master branch only supports IETF QUIC. For Google QUIC support, please refer to the gquic branch.

Guides

We currently support Go 1.12+.

Installing and updating dependencies:

go get -t -u ./...

Running tests:

go test ./...

HTTP mapping

We're currently not implementing the HTTP mapping as described in the QUIC over HTTP draft. The HTTP mapping here is a leftover from Google QUIC.

QUIC without HTTP/2

Take a look at this echo example.

Usage

As a server

See the example server. Starting a QUIC server is very similar to the standard lib http in go:

http.Handle("/", http.FileServer(http.Dir(wwwDir)))
h2quic.ListenAndServeQUIC("localhost:4242", "/path/to/cert/chain.pem", "/path/to/privkey.pem", nil)

As a client

See the example client. Use a h2quic.RoundTripper as a Transport in a http.Client.

http.Client{
  Transport: &h2quic.RoundTripper{},
}

Contributing

We are always happy to welcome new contributors! We have a number of self-contained issues that are suitable for first-time contributors, they are tagged with help wanted. If you have any questions, please feel free to reach out by opening an issue or leaving a comment.