mirrors/uquic
1
0
Fork 0
mirror of https://github.com/refraction-networking/uquic.git synced 2025-04-05 13:17:36 +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
5265 commits 12 branches 6 tags 19 MiB
Find a file
Marten Seemann aa68b3015d remove the metrics package 
Recording every sent and received packet in OpenCensus is quite expensive.
Arguably, the metrics needs depend on the application, so that's where the
implementation of a metrics collector should live anyway.
2021-02-05 16:38:39 +08:00
.circleci remove the metrics package 2021-02-05 16:38:39 +08:00
.githooks only run gofumpt on .go files in pre-commit hook 2021-01-06 10:48:41 +08:00
.github/workflows update qtls and CI to Go 1.16rc1 2021-01-29 13:19:36 +08:00
benchmark run gofumpt, enable the gofumpt linter 2020-10-26 09:33:35 +07:00
docs add gopher-logo 2016-05-03 10:27:59 +02:00
example remove support for quic-trace 2020-12-05 23:13:45 +07:00
fuzzing reject DATAGRAM frames if datagram support is not enabled 2020-12-09 15:31:23 +07:00
http3 reenable key updates for HTTP/3 2021-01-20 14:51:42 +08:00
integrationtests remove the metrics package 2021-02-05 16:38:39 +08:00
internal Merge pull request #2940 from lucas-clemente/packet-number-skipping-cryptographic-random 2021-01-17 14:38:16 +08:00
interop run gofumpt, enable the gofumpt linter 2020-10-26 09:33:35 +07:00
logging add a RestoredTransportParameters method to the logging interface 2021-01-15 17:13:46 +08:00
qlog fix qlogging of the packet payload length 2021-01-19 11:09:34 +08:00
quicvarint rename ReadVarint / WriteVarInt / VarIntLen to Read / Write / Len 2021-01-02 00:15:07 +08:00
.editorconfig add editorconfig 2016-04-15 12:13:33 +02:00
.gitignore add common temporary file patterns to .gitignore 2020-11-30 12:59:35 +07:00
.golangci.yml run gofumpt, enable the gofumpt linter 2020-10-26 09:33:35 +07:00
.travis.yml read the ECN bits 2020-09-15 10:51:22 +07:00
buffer_pool.go simplify content storage in packed packets 2020-02-20 16:25:54 +07:00
buffer_pool_test.go simplify content storage in packed packets 2020-02-20 16:25:54 +07:00
Changelog.md introduce a quic.Config.HandshakeIdleTimeout, remove HandshakeTimeout 2020-12-08 16:12:39 +07:00
client.go remove unused initialVersion variable in session 2020-12-18 12:00:17 +07:00
client_test.go remove unused initialVersion variable in session 2020-12-18 12:00:17 +07:00
closed_session.go simplify the connection, rename it to sendConn 2020-08-09 19:24:04 +07:00
closed_session_test.go simplify the connection, rename it to sendConn 2020-08-09 19:24:04 +07:00
codecov.yml remove support for quic-trace 2020-12-05 23:13:45 +07:00
config.go Merge pull request #2162 from lucas-clemente/datagram 2020-12-17 11:22:40 +07:00
config_test.go Merge pull request #2162 from lucas-clemente/datagram 2020-12-17 11:22:40 +07:00
conn.go introduce an ECNCapablePacketConn interface to determine ECN support 2020-09-15 14:41:06 +07:00
conn_ecn.go use golang.org/x/sys/unix instead of syscall 2020-12-06 12:06:15 +07:00
conn_ecn_test.go use golang.org/x/sys/unix instead of syscall 2020-12-06 12:06:15 +07:00
conn_generic.go set the UDP receive buffer size on Windows 2020-11-21 17:49:39 +07:00
conn_helper_darwin.go use golang.org/x/sys/unix instead of syscall 2020-12-06 12:06:15 +07:00
conn_helper_linux.go use golang.org/x/sys/unix instead of syscall 2020-12-06 12:06:15 +07:00
conn_id_generator.go only use the conn ID backwards compatibility mode with draft-29 2020-10-22 20:33:17 +07:00
conn_id_generator_test.go only use the conn ID backwards compatibility mode with draft-29 2020-10-22 20:33:17 +07:00
conn_id_manager.go immediately remove reset tokens when retiring a connection ID 2020-11-22 10:21:20 +07:00
conn_id_manager_test.go immediately remove reset tokens when retiring a connection ID 2020-11-22 10:21:20 +07:00
conn_test.go use a mock net.PacketConn in tests 2020-09-27 15:13:07 +07:00
conn_windows.go use golang.org/x/sys/unix instead of syscall 2020-12-06 12:06:15 +07:00
crypto_stream.go use the correct error code for crypto stream errors 2020-05-14 17:12:07 +07:00
crypto_stream_manager.go add the exhaustive linter 2020-10-05 13:47:57 +07:00
crypto_stream_manager_test.go process the NewSessionTicket TLS message 2019-04-01 11:45:20 +09:00
crypto_stream_test.go run gofumpt, enable the gofumpt linter 2020-10-26 09:33:35 +07:00
datagram_queue.go implement receiving of DATAGRAM frames 2020-12-09 15:31:23 +07:00
datagram_queue_test.go implement receiving of DATAGRAM frames 2020-12-09 15:31:23 +07:00
frame_sorter.go rewrite the frame sorter 2020-05-25 13:10:26 +07:00
frame_sorter_test.go fix seed generation in frame sorter tests 2020-06-01 09:59:54 +07:00
framer.go rename ReadVarint / WriteVarInt / VarIntLen to Read / Write / Len 2021-01-02 00:15:07 +08:00
framer_test.go rename DataBlockedFrame.DataLimit to MaximumData 2020-07-02 16:41:43 +07:00
go.mod remove the metrics package 2021-02-05 16:38:39 +08:00
go.sum remove the metrics package 2021-02-05 16:38:39 +08:00
interface.go Merge pull request #2162 from lucas-clemente/datagram 2020-12-17 11:22:40 +07:00
LICENSE add Google to license file 2016-12-14 11:54:01 +01:00
mock_ack_frame_source_test.go bundle ACK frames when packing a packet 2020-06-01 09:56:06 +07:00
mock_crypto_data_handler_test.go run go generate ./... 2019-03-05 13:42:56 +09:00
mock_crypto_stream_test.go run go generate ./... 2019-03-05 13:42:56 +09:00
mock_frame_source_test.go bundle ACK frames when packing a packet 2020-06-01 09:56:06 +07:00
mock_multiplexer_test.go read the ECN bits 2020-09-15 10:51:22 +07:00
mock_packer_test.go allow an amplification factor of 3.x 2020-11-06 14:16:11 +07:00
mock_packet_handler_manager_test.go immediately remove reset tokens when retiring a connection ID 2020-11-22 10:21:20 +07:00
mock_packet_handler_test.go remove Session.Close() 2020-01-26 17:41:53 +07:00
mock_packetconn_test.go use a mock net.PacketConn in tests 2020-09-27 15:13:07 +07:00
mock_quic_session_test.go implement receiving of DATAGRAM frames 2020-12-09 15:31:23 +07:00
mock_receive_stream_internal_test.go run go generate ./... 2019-03-05 13:42:56 +09:00
mock_sealing_manager_test.go implement unpacking of 0-RTT packets 2019-12-30 18:39:21 +04:00
mock_send_conn_test.go simplify the connection, rename it to sendConn 2020-08-09 19:24:04 +07:00
mock_send_stream_internal_test.go return ackhandler.Frames from sendStream.popStreamFrame 2019-08-31 17:34:54 +07:00
mock_sender_test.go don't generate new packets when the send queue is full 2021-01-17 16:18:17 +08:00
mock_session_runner_test.go immediately remove reset tokens when retiring a connection ID 2020-11-22 10:21:20 +07:00
mock_stream_getter_test.go run go generate ./... 2019-03-05 13:42:56 +09:00
mock_stream_internal_test.go return ackhandler.Frames from sendStream.popStreamFrame 2019-08-31 17:34:54 +07:00
mock_stream_manager_test.go move the transport parameter stream limit check to the parser 2020-12-18 13:00:33 +07:00
mock_stream_sender_test.go run go generate ./... 2019-03-05 13:42:56 +09:00
mock_token_store_test.go add the TokenStore to the quic.Config, store received tokens 2019-08-13 10:52:59 +07:00
mock_unknown_packet_handler_test.go fix race condition when closing the server after a Read failed 2019-05-10 09:47:52 +09:00
mock_unpacker_test.go pass the time a packet was received to the short header opener 2019-08-11 13:33:02 +07:00
mockgen.go introduce an interface for the send queue, use a mock in session tests 2021-01-17 16:18:17 +08:00
mockgen_private.sh move all dependencies on qtls to a separate package 2020-08-18 14:26:23 +07:00
multiplexer.go use a mock net.PacketConn in tests 2020-09-27 15:13:07 +07:00
multiplexer_test.go use a mock net.PacketConn in tests 2020-09-27 15:13:07 +07:00
packet_handler_map.go make sure the server is stopped before closing all server sessions 2021-01-25 15:28:42 +08:00
packet_handler_map_test.go Merge pull request #2897 from lucas-clemente/immediately-delete-stateless-reset-tokens 2020-12-04 10:14:28 +07:00
packet_packer.go preallocate a slice of one frame when packing a packet 2021-01-20 17:52:32 +08:00
packet_packer_test.go preallocate a slice of one frame when packing a packet 2021-01-20 17:52:32 +08:00
packet_unpacker.go Merge pull request #2903 from lucas-clemente/fix-packet-number-decoding 2020-12-04 09:20:22 +07:00
packet_unpacker_test.go fix decoding of packet numbers in different packet number spaces 2020-12-03 23:35:27 +07:00
quic_suite_test.go link to the wiki explaining the UDP receive buffer size 2020-12-04 09:16:22 +07:00
README.md use a pkg.go.dev instead of a GoDoc badge 2021-01-04 15:57:51 +08:00
receive_stream.go run gofumpt, enable the gofumpt linter 2020-10-26 09:33:35 +07:00
receive_stream_test.go increase the threshold for the receive stream deadline test 2020-09-11 17:10:16 +07:00
retransmission_queue.go add the exhaustive linter 2020-10-05 13:47:57 +07:00
retransmission_queue_test.go rename MaxDataFrame.ByteOffset to MaximumData 2020-07-02 16:41:43 +07:00
send_conn.go read the ECN bits 2020-09-15 10:51:22 +07:00
send_conn_test.go use a mock net.PacketConn in tests 2020-09-27 15:13:07 +07:00
send_queue.go increase the size of the send queue 2021-01-20 14:45:18 +08:00
send_queue_test.go increase the size of the send queue 2021-01-20 14:45:18 +08:00
send_stream.go complete a stream that has frames in flight if it is canceled 2021-01-17 15:54:33 +08:00
send_stream_test.go complete a stream that has frames in flight if it is canceled 2021-01-17 15:54:33 +08:00
server.go make sure the server is stopped before closing all server sessions 2021-01-25 15:28:42 +08:00
server_test.go Merge pull request #2162 from lucas-clemente/datagram 2020-12-17 11:22:40 +07:00
session.go Merge pull request #3015 from lucas-clemente/prioritize-receiving-packets 2021-01-23 19:39:40 +08:00
session_test.go prioritize receiving packets over sending out more packets 2021-01-20 12:47:56 +08:00
stream.go run gofumpt, enable the gofumpt linter 2020-10-26 09:33:35 +07:00
stream_deadline_error.go use the os.ErrDeadlineExceeded for stream deadline errors on Go 1.15 2020-08-31 14:50:07 +07:00
stream_deadline_error_go115.go use the os.ErrDeadlineExceeded for stream deadline errors on Go 1.15 2020-08-31 14:50:07 +07:00
stream_deadline_error_test.go use the os.ErrDeadlineExceeded for stream deadline errors on Go 1.15 2020-08-31 14:50:07 +07:00
stream_test.go drop support for gQUIC 2018-10-30 10:20:39 +07:00
streams_map.go move the transport parameter stream limit check to the parser 2020-12-18 13:00:33 +07:00
streams_map_generic_helper.go remove nolint commands that show up in GoDoc 2019-11-16 18:52:25 +08:00
streams_map_incoming_bidi.go use a single map in the incoming streams map 2020-11-20 16:26:14 +07:00
streams_map_incoming_generic.go use a single map in the incoming streams map 2020-11-20 16:26:14 +07:00
streams_map_incoming_generic_test.go reject DATAGRAM frames if datagram support is not enabled 2020-12-09 15:31:23 +07:00
streams_map_incoming_uni.go use a single map in the incoming streams map 2020-11-20 16:26:14 +07:00
streams_map_outgoing_bidi.go send STREAMS_BLOCKED frame when MAX_STREAMS frame allows too few streams 2020-10-30 15:28:09 +07:00
streams_map_outgoing_generic.go send STREAMS_BLOCKED frame when MAX_STREAMS frame allows too few streams 2020-10-30 15:28:09 +07:00
streams_map_outgoing_generic_test.go fix flaky streams map test on Windows 2021-01-20 11:45:06 +08:00
streams_map_outgoing_uni.go send STREAMS_BLOCKED frame when MAX_STREAMS frame allows too few streams 2020-10-30 15:28:09 +07:00
streams_map_test.go move the transport parameter stream limit check to the parser 2020-12-18 13:00:33 +07:00
token_store.go define a quic.TokenStore interface and provide a LRU implementation 2019-08-13 10:30:31 +07:00
token_store_test.go define a quic.TokenStore interface and provide a LRU implementation 2019-08-13 10:30:31 +07:00
window_update_queue.go rename MaxStreamDataFrame.ByteOffset to MaximumStreamData 2020-07-02 16:41:43 +07:00
window_update_queue_test.go rename MaxStreamDataFrame.ByteOffset to MaximumStreamData 2020-07-02 16:41:43 +07:00
zero_rtt_queue.go dequeue all 0-RTT packets to the session in one go 2021-01-09 13:34:05 +08:00
zero_rtt_queue_test.go dequeue all 0-RTT packets to the session in one go 2021-01-09 13:34:05 +08:00

README.md

A QUIC implementation in pure Go

PkgGoDev Travis Build Status CircleCI Build Status Windows Build Status Code Coverage

quic-go is an implementation of the QUIC protocol in Go. It implements the IETF QUIC draft-29 and draft-32.

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.

When using quic-go as a library, please always use a tagged release. Only these releases use the official draft version numbers.

Guides

We currently support Go 1.14+, with Go modules support enabled.

Running tests:

go test ./...

QUIC without HTTP/3

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)))
http3.ListenAndServeQUIC("localhost:4242", "/path/to/cert/chain.pem", "/path/to/privkey.pem", nil)

As a client

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

http.Client{
  Transport: &http3.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.