No description
Find a file
Dmitri Tikhonov b55a5117d9 Release 2.14.6
- [BUGFIX] Fix amplification mitigation in 0-RTT case.
- [BUGFIX] IETF mini connection should not tickable if cannot send
  a packet due to amplification.
- [BUGFIX] Fail if active_connection_id_limit TP is smaller than 2.
- [BUGFIX] Qlog server certificates for IETF QUIC connections.
- [BUGFIX] Uninitialized struct padding usage in tokgen (benign).
- [BUGFIX] Incorrect argument to shi_lookup() (benign).
2020-05-06 09:38:32 -04:00
docs Release 2.14.6 2020-05-06 09:38:32 -04:00
include Release 2.14.6 2020-05-06 09:38:32 -04:00
src Release 2.14.6 2020-05-06 09:38:32 -04:00
test Release 2.14.6 2020-05-06 09:38:32 -04:00
tools Release 1.21.0 2019-04-12 10:50:45 -04:00
wincompat Resuscitate Windows build (#61) 2019-01-30 15:28:35 -05:00
.cirrus.yml Use later version of BoringSSL 2020-04-01 14:41:35 -04:00
.gitmodules Release 2.13.0 2020-03-12 09:02:56 -04:00
.nojekyll Switch to readthedocs.org for hosting documentation 2020-02-20 16:56:57 -05:00
.travis.yml Use later version of BoringSSL 2020-04-01 14:41:35 -04:00
APIs.txt Release 2.8.7 2020-01-09 11:52:25 -05:00
BUILD-WINDOWS.md Fixed minor errors in windows build instructions 2020-02-26 17:47:55 +01:00
CHANGELOG Release 2.14.6 2020-05-06 09:38:32 -04:00
CMakeLists.txt Add experimental support for delayed ACKs extension 2020-02-21 14:26:25 -05:00
CONTRIBUTORS.txt Release 2.8.7 2020-01-09 11:52:25 -05:00
Dockerfile Release 2.4.5 2019-10-08 15:54:01 -04:00
EXAMPLES.txt Release 2.8.7 2020-01-09 11:52:25 -05:00
LICENSE Release 2.8.7 2020-01-09 11:52:25 -05:00
LICENSE.chrome LSQUIC Client: Initial release 2017-09-22 17:00:03 -04:00
print-glibc-version.sh Latest changes 2018-07-10 11:51:45 -04:00
README.md Use later version of BoringSSL 2020-04-01 14:41:35 -04:00

Build Status Build Status Build status

LiteSpeed QUIC (LSQUIC) Library README

Description

LiteSpeed QUIC (LSQUIC) Library is an open-source implementation of QUIC and HTTP/3 functionality for servers and clients. Most of the code in this distribution is used in our own products: LiteSpeed Web Server, LiteSpeed ADC, and OpenLiteSpeed. We think it is free of major problems. Nevertheless, do not hesitate to report bugs back to us. Even better, send us fixes and improvements!

Currently supported QUIC versions are Q043, Q046, Q050, ID-25, and ID-27. Support for newer versions will be added soon after they are released.

Documentation

Documentation is available at https://lsquic.readthedocs.io/en/latest/.

In addition, see example programs for API usage and EXAMPLES.txt for some compilation and run-time options.

Requirements

To build LSQUIC, you need CMake, zlib, and BoringSSL. The example program uses libevent to provide the event loop.

Building BoringSSL

BoringSSL is not packaged; you have to build it yourself. The process is straightforward. You will need go installed.

  1. Clone BoringSSL by issuing the following command:
git clone https://boringssl.googlesource.com/boringssl
cd boringssl

You may need to install pre-requisites like zlib and libevent.

  1. Use specific BoringSSL version
git checkout bfe527fa35735e8e045cbfb42b012e13ca68f9cf
  1. Compile the library
cmake . &&  make

Remember where BoringSSL sources are:

BORINGSSL=$PWD

If you want to turn on optimizations, do

cmake -DCMAKE_BUILD_TYPE=Release . && make

Building LSQUIC Library

LSQUIC's http_client, http_server, and the tests link BoringSSL libraries statically. Following previous section, you can build LSQUIC as follows:

  1. Get the source code
git clone https://github.com/litespeedtech/lsquic.git
cd lsquic
git submodule init
git submodule update
  1. Compile the library
# $BORINGSSL is the top-level BoringSSL directory from the previous step
cmake -DBORINGSSL_DIR=$BORINGSSL .
make
  1. Run tests
make test

Building with Docker

The library and the example client and server can be built with Docker.

Initialize Git submodules:

cd lsquic
git submodule init
git submodule update

Build the Docker image:

docker build -t lsquic .

Then you can use the examples from the command line. For example:

sudo docker run -it --rm lsquic http_client -s www.google.com  -p / -o version=Q046
sudo docker run -p 12345:12345/udp -v /path/to/certs:/mnt/certs -it --rm lsquic http_server -c www.example.com,/mnt/certs/chain,/mnt/certs/key

Platforms

The library has been tested on the following platforms:

  • Linux
    • i386
    • x86_64
    • ARM (Raspberry Pi 3)
  • FreeBSD
    • i386
  • MacOS
    • x86_64
  • Windows (this needs updating for the server part, now broken)
    • x86_64

Have fun,

LiteSpeed QUIC Team.

Copyright (c) 2017 - 2020 LiteSpeed Technologies Inc