index.rst revision b62ec17f 
1LSQUIC Documentation
2====================
3
4This is the documentation for LSQUIC_ |release|, last updated |today|.
5
6LiteSpeed QUIC (LSQUIC) Library is an open-source implementation of QUIC
7and HTTP/3 functionality for servers and clients.  LSQUIC is:
8
9- fast;
10
11- flexible; and
12
13- production-ready.
14
15Most of the code in this distribution has been  used in our own products
16-- `LiteSpeed Web Server`_, `LiteSpeed Web ADC`_, and OpenLiteSpeed_ --
17since 2017.
18
19Currently supported QUIC versions are Q043, Q046, Q050, ID-27, ID-28,
20ID-29, ID-30, and ID-31.
21Support for newer versions will be added soon after they are released.
22
23LSQUIC is licensed under the `MIT License`_; see LICENSE in the source
24distribution for details.
25
26Features
27--------
28
29LSQUIC supports nearly all QUIC and HTTP/3 features, including
30
31- DPLPMTUD
32- ECN
33- Spin bits (allowing network observer to calculate a connection's RTT)
34- Path migration
35- NAT rebinding
36- Push promises
37- TLS Key updates
38- Extensions:
39
40 - :ref:`apiref-datagrams`
41 - Loss bits extension (allowing network observer to locate source of packet loss)
42 - Timestamps extension (allowing for one-way delay calculation, improving performance of some congestion controllers)
43 - Delayed ACKs (this reduces number of ACK frames sent and processed, improving throughput)
44 - QUIC grease bit to reduce ossification opportunities
45
46Architecture
47------------
48
49The LSQUIC library does not use sockets to receive and send packets; that is handled by the user-supplied callbacks.  The library also does not mandate the use of any particular event loop.  Instead, it has functions to help the user schedule events.  (Thus, using an event loop is not even strictly necessary.)  The various callbacks and settings are supplied to the engine constructor.
50LSQUIC keeps QUIC connections in several data structures in order to process them efficiently.  Connections that need processing are kept in two priority queues: one holds connections that are ready to be processed (or "ticked") and the other orders connections by their next timer value.  As a result, no connection is processed needlessly.
51
52.. _LSQUIC: https://github.com/litespeedtech/lsquic
53.. _`MIT License`: http://www.opensource.org/licenses/mit-license.php
54.. _`LiteSpeed Web Server`: https://www.litespeedtech.com/products/litespeed-web-server/
55.. _`LiteSpeed Web ADC`: https://www.litespeedtech.com/products/litespeed-web-adc/
56.. _OpenLiteSpeed: https://openlitespeed.org/
57
58Contents
59--------
60
61.. toctree::
62   :maxdepth: 2
63
64   gettingstarted
65   tutorial
66   apiref
67   internals
68
69Indices and tables
70==================
71
72* :ref:`genindex`
73* :ref:`search`
74