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=Q050

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.

Next steps

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

Internals covers some library internals.