Return to HTTP3.md CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / curl / docs

Annotation of embedaddon/curl/docs/HTTP3.md, revision 1.1

1.1     ! misho       1: # HTTP3 (and QUIC)
        !             2: 
        !             3: ## Resources
        !             4: 
        !             5: [HTTP/3 Explained](https://daniel.haxx.se/http3-explained/) - the online free
        !             6: book describing the protocols involved.
        !             7: 
        !             8: [QUIC implementation](https://github.com/curl/curl/wiki/QUIC-implementation) -
        !             9: the wiki page describing the plan for how to support QUIC and HTTP/3 in curl
        !            10: and libcurl.
        !            11: 
        !            12: [quicwg.org](https://quicwg.org/) - home of the official protocol drafts
        !            13: 
        !            14: ## QUIC libraries
        !            15: 
        !            16: QUIC libraries we're experimenting with:
        !            17: 
        !            18: [ngtcp2](https://github.com/ngtcp2/ngtcp2)
        !            19: 
        !            20: [quiche](https://github.com/cloudflare/quiche)
        !            21: 
        !            22: ## Experimental!
        !            23: 
        !            24: HTTP/3 and QUIC support in curl is considered **EXPERIMENTAL** until further
        !            25: notice. It needs to be enabled at build-time.
        !            26: 
        !            27: Further development and tweaking of the HTTP/3 support in curl will happen in
        !            28: in the master branch using pull-requests, just like ordinary changes.
        !            29: 
        !            30: # ngtcp2 version
        !            31: 
        !            32: ## Build with OpenSSL
        !            33: 
        !            34: Build (patched) OpenSSL
        !            35: 
        !            36:      % git clone --depth 1 -b OpenSSL_1_1_1d-quic-draft-27 https://github.com/tatsuhiro-t/openssl
        !            37:      % cd openssl
        !            38:      % ./config enable-tls1_3 --prefix=<somewhere1>
        !            39:      % make
        !            40:      % make install_sw
        !            41: 
        !            42: Build nghttp3
        !            43: 
        !            44:      % cd ..
        !            45:      % git clone https://github.com/ngtcp2/nghttp3
        !            46:      % cd nghttp3
        !            47:      % autoreconf -i
        !            48:      % ./configure --prefix=<somewhere2> --enable-lib-only
        !            49:      % make
        !            50:      % make install
        !            51: 
        !            52: Build ngtcp2
        !            53: 
        !            54:      % cd ..
        !            55:      % git clone https://github.com/ngtcp2/ngtcp2
        !            56:      % cd ngtcp2
        !            57:      % autoreconf -i
        !            58:      % ./configure PKG_CONFIG_PATH=<somewhere1>/lib/pkgconfig:<somewhere2>/lib/pkgconfig LDFLAGS="-Wl,-rpath,<somewhere1>/lib" --prefix=<somewhere3>
        !            59:      % make
        !            60:      % make install
        !            61: 
        !            62: Build curl
        !            63: 
        !            64:      % cd ..
        !            65:      % git clone https://github.com/curl/curl
        !            66:      % cd curl
        !            67:      % ./buildconf
        !            68:      % LDFLAGS="-Wl,-rpath,<somewhere1>/lib" ./configure --with-ssl=<somewhere1> --with-nghttp3=<somewhere2> --with-ngtcp2=<somewhere3> --enable-alt-svc
        !            69:      % make
        !            70: 
        !            71: ## Build with GnuTLS
        !            72: 
        !            73: Build (patched) GnuTLS
        !            74: 
        !            75:      % git clone --depth 1 -b tmp-quic https://gitlab.com/gnutls/gnutls.git
        !            76:      % cd gnutls
        !            77:      % ./bootstrap
        !            78:      % ./configure --disable-doc --prefix=<somewhere1>
        !            79:      % make
        !            80:      % make install
        !            81: 
        !            82: Build nghttp3
        !            83: 
        !            84:      % cd ..
        !            85:      % git clone https://github.com/ngtcp2/nghttp3
        !            86:      % cd nghttp3
        !            87:      % autoreconf -i
        !            88:      % ./configure --prefix=<somewhere2> --enable-lib-only
        !            89:      % make
        !            90:      % make install
        !            91: 
        !            92: Build ngtcp2
        !            93: 
        !            94:      % cd ..
        !            95:      % git clone https://github.com/ngtcp2/ngtcp2
        !            96:      % cd ngtcp2
        !            97:      % autoreconf -i
        !            98:      % ./configure PKG_CONFIG_PATH=<somewhere1>/lib/pkgconfig:<somewhere2>/lib/pkgconfig LDFLAGS="-Wl,-rpath,<somewhere1>/lib" --prefix=<somewhere3>
        !            99:      % make
        !           100:      % make install
        !           101: 
        !           102: Build curl
        !           103: 
        !           104:      % cd ..
        !           105:      % git clone https://github.com/curl/curl
        !           106:      % cd curl
        !           107:      % ./buildconf
        !           108:      % ./configure --without-ssl --with-gnutls=<somewhere1> --with-nghttp3=<somewhere2> --with-ngtcp2=<somewhere3> --enable-alt-svc
        !           109:      % make
        !           110: 
        !           111: # quiche version
        !           112: 
        !           113: ## build
        !           114: 
        !           115: Clone quiche and BoringSSL:
        !           116: 
        !           117:      % git clone --recursive https://github.com/cloudflare/quiche
        !           118: 
        !           119: Build BoringSSL (it needs to be built manually so it can be reused with curl):
        !           120: 
        !           121:      % cd quiche/deps/boringssl
        !           122:      % mkdir build
        !           123:      % cd build
        !           124:      % cmake -DCMAKE_POSITION_INDEPENDENT_CODE=on ..
        !           125:      % make
        !           126:      % cd ..
        !           127:      % mkdir -p .openssl/lib
        !           128:      % cp build/crypto/libcrypto.a build/ssl/libssl.a .openssl/lib
        !           129:      % ln -s $PWD/include .openssl
        !           130: 
        !           131: Build quiche:
        !           132: 
        !           133:      % cd ../..
        !           134:      % QUICHE_BSSL_PATH=$PWD/deps/boringssl cargo build --release --features pkg-config-meta
        !           135: 
        !           136: Build curl:
        !           137: 
        !           138:      % cd ..
        !           139:      % git clone https://github.com/curl/curl
        !           140:      % cd curl
        !           141:      % ./buildconf
        !           142:      % ./configure LDFLAGS="-Wl,-rpath,$PWD/../quiche/target/release" --with-ssl=$PWD/../quiche/deps/boringssl/.openssl --with-quiche=$PWD/../quiche/target/release --enable-alt-svc
        !           143:      % make
        !           144: 
        !           145: ## Run
        !           146: 
        !           147: Use HTTP/3 directly:
        !           148: 
        !           149:     curl --http3 https://nghttp2.org:8443/
        !           150: 
        !           151: Upgrade via Alt-Svc:
        !           152: 
        !           153:     curl --alt-svc altsvc.cache https://quic.aiortc.org/
        !           154: 
        !           155: See this [list of public HTTP/3 servers](https://bagder.github.io/HTTP3-test/)