Macro cargo::try_old_curl_http2_pipewait

source ·
macro_rules! try_old_curl_http2_pipewait {
    ($multiplexing:expr, $handle:expr) => { ... };
}
Expand description

Enable HTTP/2 and pipewait to be used as it’ll allow true multiplexing which makes downloads much faster.

Currently Cargo requests the http2 feature of the curl crate which means it should always be built in. On OSX, however, we ship cargo still linked against the system libcurl. Building curl with ALPN support for HTTP/2 requires newer versions of OSX (the SecureTransport API) than we want to ship Cargo for. By linking Cargo against the system libcurl then older curl installations won’t use HTTP/2 but newer ones will. All that to basically say we ignore errors here on OSX, but consider this a fatal error to not activate HTTP/2 on all other platforms.

pipewait is an option which indicates that if there’s a bunch of parallel requests to the same host they all wait until the pipelining status of the host is known. This means that we won’t initiate dozens of connections but rather only one. Once the main one is opened we realized that pipelining is possible and multiplexing is possible. All in all this reduces the number of connections down to a more manageable state.