Getting Started

Supported Platforms

LSQUIC compiles and runs on Linux, Windows, FreeBSD, Mac OS, and Android. It has been tested on i386, x86_64, and ARM (Raspberry Pi and Android).

Dependencies

LSQUIC library uses:

The accompanying demo command-line tools use libevent.

What’s in the box

  • src/liblsquic – the library
  • bin – demo client and server programs
  • tests – unit tests

Building

To build the library, follow instructions in the README file.

Demo Examples

Fetch Google home page:

./http_client -s www.google.com -p / -o version=h3-29

Run your own server (it does not touch the filesystem, don’t worry):

./http_server -c www.example.com,fullchain.pem,privkey.pem -s 0.0.0.0:4433

Grab a page from your server:

./http_client -H www.example.com -s 127.0.0.1:4433 -p /

You can play with various options, of which there are many. Use the -h command-line flag to see them.

More about LSQUIC

You may be also interested in this presentation about LSQUIC. Slides are available here.

Next steps

If you want to use LSQUIC in your program, check out the Tutorial and the API Reference.

Library Guts covers some library internals.