← Commit list

32500f12c4

Viktor Szakats

2026-03-17

SUCCESS Duration: 317s

Subject

HTTP3.md: minor improvements

Binary

No binary (build failed)

Architecture & Compiler Flags

Architecture: x86_64-linux-gnu Compiler: gcc (Ubuntu 11.4.0-1ubuntu1~22.04.3) 11.4.0

—

Build Log

(log yok)

Commit Diff GitHub →

docs/HTTP3.md +39 -59

docs/HTTP3.md+39 -59

@@ -47,16 +47,16 @@ improvements.
	The build examples use `$NGHTTP3_VERSION` and `$NGTCP2_VERSION` as
	placeholders for the version you build.

-	## Build with OpenSSL
+	## Build with OpenSSL or fork

-	OpenSSL v3.5.0+ offers APIs for integration with ngtcp2 v1.12.0+. Earlier
-	versions do not work.
+	OpenSSL v3.5.0+ requires ngtcp2 v1.12.0+. Earlier versions do not work.

-	Build OpenSSL (version 3.5.0 or newer):
+	Build OpenSSL (v3.5.0+) or fork AWS-LC, BoringSSL, LibreSSL or quictls:

+	# Instructions for OpenSSL v3.5.0+
	% git clone --depth 1 -b openssl-$OPENSSL_VERSION https://github.com/openssl/openssl
	% cd openssl
-	% ./config --prefix=<somewhere1> --libdir=lib
+	% ./config --prefix=/path/to/openssl --libdir=lib
	% make
	% make install

@@ -67,7 +67,7 @@ Build nghttp3:
	% cd nghttp3
	% git submodule update --init
	% autoreconf -fi
-	% ./configure --prefix=<somewhere2> --enable-lib-only
+	% ./configure --prefix=/path/to/nghttp3 --enable-lib-only
	% make
	% make install

@@ -77,64 +77,28 @@ Build ngtcp2:
	% git clone -b $NGTCP2_VERSION https://github.com/ngtcp2/ngtcp2
	% cd ngtcp2
	% autoreconf -fi
-	% ./configure PKG_CONFIG_PATH=<somewhere1>/lib/pkgconfig:<somewhere2>/lib/pkgconfig LDFLAGS="-Wl,-rpath,<somewhere1>/lib" --prefix=<somewhere3> --enable-lib-only --with-openssl
+	# Change --with-openssl to --with-boringssl for AWS-LC and BoringSSL
+	% ./configure PKG_CONFIG_PATH=/path/to/openssl/lib/pkgconfig:/path/to/nghttp3/lib/pkgconfig LDFLAGS="-Wl,-rpath,/path/to/openssl/lib" --prefix=/path/to/ngtcp2 --enable-lib-only --with-openssl
	% make
	% make install

-	Build curl:
+	Build curl (with autotools):

	% cd ..
	% git clone https://github.com/curl/curl
	% cd curl
	% autoreconf -fi
-	% LDFLAGS="-Wl,-rpath,<somewhere1>/lib" ./configure PKG_CONFIG_PATH=<ngtcp2-root>/lib/pkgconfig --with-openssl=<somewhere1> --with-nghttp3=<somewhere2> --with-ngtcp2
-	% make
-	% make install
-
-	## Build with quictls
-
-	OpenSSL before version 3.5 does not offer the required APIs for building a
-	QUIC client. You need to use a TLS library that has such APIs and that works
-	with ngtcp2.
-
-	Build quictls (any `+quic` tagged version works):
-
-	% git clone --depth 1 -b openssl-3.1.4+quic https://github.com/quictls/openssl
-	% cd openssl
-	% ./config enable-tls1_3 --prefix=<somewhere1> --libdir=lib
-	% make
-	% make install
-
-	Build nghttp3:
-
-	% cd ..
-	% git clone -b $NGHTTP3_VERSION https://github.com/ngtcp2/nghttp3
-	% cd nghttp3
-	% git submodule update --init
-	% autoreconf -fi
-	% ./configure --prefix=<somewhere2> --enable-lib-only
+	% ./configure PKG_CONFIG_PATH=/path/to/openssl/lib/pkgconfig LDFLAGS="-Wl,-rpath,/path/to/openssl/lib" --with-openssl=/path/to/openssl --with-ngtcp2=/path/to/ngtcp2 --with-nghttp3=/path/to/nghttp3
	% make
	% make install

-	Build ngtcp2:
-
-	% cd ..
-	% git clone -b $NGTCP2_VERSION https://github.com/ngtcp2/ngtcp2
-	% cd ngtcp2
-	% autoreconf -fi
-	% ./configure PKG_CONFIG_PATH=<somewhere1>/lib/pkgconfig:<somewhere2>/lib/pkgconfig LDFLAGS="-Wl,-rpath,<somewhere1>/lib" --prefix=<somewhere3> --enable-lib-only
-	% make
-	% make install
-
-	Build curl:
+	Build curl (with CMake):

	% cd ..
	% git clone https://github.com/curl/curl
	% cd curl
-	% autoreconf -fi
-	% LDFLAGS="-Wl,-rpath,<somewhere1>/lib" ./configure PKG_CONFIG_PATH=<ngtcp2-root>/lib/pkgconfig --with-openssl=<somewhere1> --with-nghttp3=<somewhere2> --with-ngtcp2
-	% make
-	% make install
+	% PKG_CONFIG_PATH=/path/to/openssl/lib/pkgconfig:/path/to/ngtcp2/lib/pkgconfig:/path/to/nghttp3/lib/pkgconfig cmake -B bld -DOPENSSL_ROOT_DIR=/path/to/openssl -DUSE_NGTCP2=ON
+	% cmake --build bld

	## Build with GnuTLS

@@ -143,7 +107,7 @@ Build GnuTLS:
	% git clone --depth 1 https://gitlab.com/gnutls/gnutls
	% cd gnutls
	% ./bootstrap
-	% ./configure --prefix=<somewhere1>
+	% ./configure --prefix=/path/to/gnutls
	% make
	% make install

@@ -154,7 +118,7 @@ Build nghttp3:
	% cd nghttp3
	% git submodule update --init
	% autoreconf -fi
-	% ./configure --prefix=<somewhere2> --enable-lib-only
+	% ./configure --prefix=/path/to/nghttp3 --enable-lib-only
	% make
	% make install

@@ -164,20 +128,28 @@ Build ngtcp2:
	% git clone -b $NGTCP2_VERSION https://github.com/ngtcp2/ngtcp2
	% cd ngtcp2
	% autoreconf -fi
-	% ./configure PKG_CONFIG_PATH=<somewhere1>/lib/pkgconfig:<somewhere2>/lib/pkgconfig LDFLAGS="-Wl,-rpath,<somewhere1>/lib" --prefix=<somewhere3> --enable-lib-only --with-gnutls
+	% ./configure PKG_CONFIG_PATH=/path/to/gnutls/lib/pkgconfig:/path/to/nghttp3/lib/pkgconfig LDFLAGS="-Wl,-rpath,/path/to/gnutls/lib" --prefix=/path/to/ngtcp2 --enable-lib-only --with-gnutls
	% make
	% make install

-	Build curl:
+	Build curl (with autotools):

	% cd ..
	% git clone https://github.com/curl/curl
	% cd curl
	% autoreconf -fi
-	% ./configure PKG_CONFIG_PATH=<ngtcp2-root>/lib/pkgconfig --with-gnutls=<somewhere1> --with-nghttp3=<somewhere2> --with-ngtcp2
+	% ./configure PKG_CONFIG_PATH=/path/to/gnutls/lib/pkgconfig:/path/to/ngtcp2/lib/pkgconfig --with-gnutls=/path/to/gnutls --with-ngtcp2 --with-nghttp3=/path/to/nghttp3
	% make
	% make install

+	Build curl (with CMake):
+
+	% cd ..
+	% git clone https://github.com/curl/curl
+	% cd curl
+	% PKG_CONFIG_PATH=/path/to/gnutls/lib/pkgconfig:/path/to/ngtcp2/lib/pkgconfig:/path/to/nghttp3/lib/pkgconfig cmake -B bld -DCURL_USE_GNUTLS=ON -DUSE_NGTCP2=ON
+	% cmake --build bld
+
	## Build with wolfSSL

	Build wolfSSL:
@@ -185,7 +157,7 @@ Build wolfSSL:
	% git clone https://github.com/wolfSSL/wolfssl
	% cd wolfssl
	% autoreconf -fi
-	% ./configure --prefix=<somewhere1> --enable-quic --enable-session-ticket --enable-earlydata --enable-psk --enable-harden --enable-altcertchains
+	% ./configure --prefix=/path/to/wolfssl --enable-quic --enable-session-ticket --enable-earlydata --enable-psk --enable-harden --enable-altcertchains
	% make
	% make install

@@ -196,7 +168,7 @@ Build nghttp3:
	% cd nghttp3
	% git submodule update --init
	% autoreconf -fi
-	% ./configure --prefix=<somewhere2> --enable-lib-only
+	% ./configure --prefix=/path/to/nghttp3 --enable-lib-only
	% make
	% make install

@@ -206,20 +178,28 @@ Build ngtcp2:
	% git clone -b $NGTCP2_VERSION https://github.com/ngtcp2/ngtcp2
	% cd ngtcp2
	% autoreconf -fi
-	% ./configure PKG_CONFIG_PATH=<somewhere1>/lib/pkgconfig:<somewhere2>/lib/pkgconfig LDFLAGS="-Wl,-rpath,<somewhere1>/lib" --prefix=<somewhere3> --enable-lib-only --with-wolfssl
+	% ./configure PKG_CONFIG_PATH=/path/to/wolfssl/lib/pkgconfig:/path/to/nghttp3/lib/pkgconfig LDFLAGS="-Wl,-rpath,/path/to/wolfssl/lib" --prefix=/path/to/ngtcp2 --enable-lib-only --with-wolfssl
	% make
	% make install

-	Build curl:
+	Build curl (with autotools):

	% cd ..
	% git clone https://github.com/curl/curl
	% cd curl
	% autoreconf -fi
-	% ./configure PKG_CONFIG_PATH=<ngtcp2-root>/lib/pkgconfig --with-wolfssl=<somewhere1> --with-nghttp3=<somewhere2> --with-ngtcp2
+	% ./configure PKG_CONFIG_PATH=/path/to/wolfssl/lib/pkgconfig --with-wolfssl=/path/to/wolfssl --with-ngtcp2=/path/to/ngtcp2 --with-nghttp3=/path/to/nghttp3
	% make
	% make install

+	Build curl (with CMake):
+
+	% cd ..
+	% git clone https://github.com/curl/curl
+	% cd curl
+	% PKG_CONFIG_PATH=/path/to/wolfssl/lib/pkgconfig:/path/to/ngtcp2/lib/pkgconfig:/path/to/nghttp3/lib/pkgconfig cmake -B bld -DCURL_USE_WOLFSSL=ON -DUSE_NGTCP2=ON
+	% cmake --build bld
+
	# quiche version

	quiche support is EXPERIMENTAL