2020-05-13 05:08:05 +03:00
MsQuic
======
2020-11-09 19:45:40 +03:00
MsQuic is a Microsoft implementation of the [IETF QUIC ](https://datatracker.ietf.org/wg/quic/about/ )
2021-06-02 20:00:02 +03:00
protocol. It is cross-platform, written in C and designed to be a general purpose QUIC library.
2020-05-13 05:08:05 +03:00
2021-06-02 20:00:02 +03:00
[](https://microsoft.github.io/msquic/) [](https://dev.azure.com/ms/msquic/_build/latest?definitionId=347& branchName=main) [](https://dev.azure.com/ms/msquic/_build/latest?definitionId=347& branchName=main)  [](https://lgtm.com/projects/g/microsoft/msquic/context:cpp) [](https://bestpractices.coreinfrastructure.org/projects/4846) [](https://discord.gg/YGAtCwTSsc)
2021-02-26 21:19:38 +03:00
2020-05-13 05:08:05 +03:00
## Protocol Features
2021-08-04 02:26:44 +03:00
**RFC**: [9000 ](https://datatracker.ietf.org/doc/html/rfc9000 ), [9001 ](https://datatracker.ietf.org/doc/html/rfc9001 ), [9002 ](https://datatracker.ietf.org/doc/html/rfc9002 ) **Draft** : [Datagram ](https://tools.ietf.org/html/draft-ietf-quic-datagram ), [Version Negotiation ](https://tools.ietf.org/html/draft-ietf-quic-version-negotiation ), [Load Balancing ](https://tools.ietf.org/html/draft-ietf-quic-load-balancers ), [ACK Frequency ](https://tools.ietf.org/html/draft-ietf-quic-ack-frequency ), [Perf Testing ](https://datatracker.ietf.org/doc/html/draft-banks-quic-performance )
2021-06-02 20:00:02 +03:00
2020-11-09 19:45:40 +03:00
QUIC has many benefits when compared to existing "TLS over TCP" scenarios:
2020-05-13 05:08:05 +03:00
2020-11-09 19:45:40 +03:00
* All packets are encrypted and handshake is authenticated with TLS 1.3.
* Parallel streams of (reliable and unreliable) application data.
2020-05-13 05:08:05 +03:00
* Exchange application data in the first round trip (0-RTT).
2020-11-09 19:45:40 +03:00
* Improved congestion control and loss recovery.
2020-05-13 05:08:05 +03:00
* Survives a change in the clients IP address or port.
2020-10-01 00:56:32 +03:00
* Stateless load balancing.
2020-10-13 17:44:31 +03:00
* Easily extendable for new features and extensions.
2020-10-01 00:56:32 +03:00
2020-05-13 05:08:05 +03:00
## Library Features
2020-11-11 00:24:40 +03:00
MsQuic has several features that differentiates it from other QUIC implementations:
2020-05-13 05:08:05 +03:00
* Optimized for client and server.
* Optimized for maximal throughput and minimal latency.
* Asynchronous IO.
2020-11-11 00:24:40 +03:00
* Receive side scaling ([RSS](https://docs.microsoft.com/en-us/windows-hardware/drivers/network/introduction-to-receive-side-scaling)) support.
2020-05-13 05:08:05 +03:00
* UDP send and receive coalescing support.
# Documentation
2020-11-11 00:24:40 +03:00
* For platform support details, see the [Platforms docs ](./docs/Platforms.md ).
* For release details, see the [Release docs ](./docs/Release.md ).
* For performance data, see the [Performance dashboard ](https://aka.ms/msquicperformance ).
2021-08-04 02:26:44 +03:00
* For building the library, see the [Build docs ](./docs/BUILD.md ).
* For testing the library, see the [Testing docs ](./docs/TEST.md ).
* For using the API, see the [API docs ](./docs/API.md ) or the [Sample ](./src/tools/sample/sample.c ).
* For deploying QUIC, see the [Deployment docs ](./docs/Deployment.md ).
* For diagnosing issues, see the [Diagnostics docs ](./docs/Diagnostics.md ) and the [Trouble Shooting Guide ](./docs/TSG.md ).
2021-06-02 20:00:02 +03:00
* For other frequently asked questions, see the [FAQs ](./docs/FAQ.md ).
2020-05-13 05:08:05 +03:00
# Contributing
2021-08-04 02:26:44 +03:00
For information on contributing, please see our [contribution guidlines ](./.github/CONTRIBUTING.md ). Feel free to take a look at our [Good First Issues ](https://github.com/microsoft/msquic/labels/good%20first%20issue ) list if you're looking for somewhere to start. If you'd just like to talk, come chat with us [on Discord ](https://discord.gg/YGAtCwTSsc ).
