https://github.com/nibanks/msh3

Minimal HTTP/3 library on top of MsQuic
https://github.com/nibanks/msh3

c client http networking server

Last synced: 6 days ago
JSON representation

Minimal HTTP/3 library on top of MsQuic

• Host: GitHub
• URL: https://github.com/nibanks/msh3
• Owner: nibanks
• License: mit
• Created: 2022-02-11T21:20:35.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-09-16T16:13:32.000Z (about 2 months ago)
• Last Synced: 2024-09-16T19:47:32.280Z (about 2 months ago)
• Topics: c, client, http, networking, server
• Language: C++
• Homepage:
• Size: 295 KB
• Stars: 56
• Watchers: 6
• Forks: 6
• Open Issues: 8
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# msh3

[![Build](https://github.com/nibanks/msh3/actions/workflows/build.yml/badge.svg)](https://github.com/nibanks/msh3/actions/workflows/build.yml)

[![](https://img.shields.io/static/v1?label=RFC&message=9114&color=brightgreen)](https://tools.ietf.org/html/rfc9114)

[![](https://img.shields.io/static/v1?label=RFC&message=9204&color=brightgreen)](https://tools.ietf.org/html/rfc9204)

Minimal HTTP/3 library on top of [microsoft/msquic](https://github.com/microsoft/msquic) and [litespeedtech/ls-qpack](https://github.com/litespeedtech/ls-qpack). Currently supports:

- Sending and receiving request headers and payload.

- Static qpack encoding.

- Server validation can be optionally disabled ("unsecure" mode).

# API

## Client

```c

const MSH3_REQUEST_IF Callbacks = { HeaderReceived, DataReceived, Complete, Shutdown, DataSend };

const MSH3_HEADER Headers[] = {

    { ":method", 7, "GET", 3 },

    { ":path", 5, Path, strlen(Path) },

    { ":scheme", 7, "https", 5 },

    { ":authority", 10, Host, strlen(Host) },

    { "accept", 6, "*/*", 3 },

};

const size_t HeadersCount = sizeof(Headers)/sizeof(MSH3_HEADER);

MSH3_API* Api = MsH3ApiOpen();

if (Api) {

    MSH3_CONNECTION* Connection = MsH3ConnectionOpen(Api, Host, Port, Unsecure);

    if (Connection) {

        MSH3_REQUEST* Request = MsH3RequestOpen(Connection, &Callbacks, NULL, Headers, HeadersCount, MSH3_REQUEST_FLAG_FIN);

        if (Request) {

            // ...

            MsH3RequestClose(Request);

        }

        MsH3ConnectionClose(Connection);

    }

    MsH3ApiClose(Api);

}

```

## Server

> **TODO** - Add documentation

# Build

```Bash

git clone --recursive https://github.com/nibanks/msh3

cd msh3 && mkdir build && cd build

```

### Linux

```Bash

cmake -G 'Unix Makefiles' ..

cmake --build .

```

### Windows

```Bash

cmake -G 'Visual Studio 17 2022' -A x64 ..

cmake --build .

```

# Run

```

msh3app outlook.office.com

msh3app www.cloudflare.com

msh3app www.google.com

msh3app nghttp2.org:4433

```