Artifactspublic-v0

curl

master
ply4 git calls172 ms288 KiB2 cachedprotocol v2
85 lines1.8 KiBRaw

NAME

CURLMOPT_PIPELINING - enable HTTP multiplexing

SYNOPSIS

c
#include <curl/curl.h>

CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_PIPELINING, long bitmask);

DESCRIPTION

Pass in the correct value in the bitmask parameter to instruct libcurl to enable multiplexing for this multi handle.

With multiplexing enabled, libcurl attempts to do multiple transfers over the same connection when doing parallel transfers to the same hosts.

CURLPIPE_NOTHING (0)

Make no attempts at multiplexing.

CURLPIPE_HTTP1 (1)

This bit is deprecated and has no effect since version 7.62.0.

CURLPIPE_MULTIPLEX (2)

If this bit is set, libcurl tries to multiplex the new transfer over an existing connection if possible. This requires HTTP/2 or HTTP/3.

DEFAULT

CURLPIPE_MULTIPLEX

%PROTOCOLS%

EXAMPLE

c
int main(void)
{
  CURLM *m = curl_multi_init();
  /* try HTTP/2 multiplexing */
  curl_multi_setopt(m, CURLMOPT_PIPELINING, CURLPIPE_MULTIPLEX);
}

HISTORY

The multiplex support bit was added in 7.43.0. HTTP/1 Pipelining support was disabled in 7.62.0.

Since 7.62.0, CURLPIPE_MULTIPLEX is enabled by default.

Before that, default was CURLPIPE_NOTHING.

%AVAILABILITY%

RETURN VALUE

curl_multi_setopt(3) returns a CURLMcode indicating success or error.

CURLM_OK (0) means everything was OK, non-zero means an error occurred, see libcurl-errors(3).

1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Title: CURLMOPT_PIPELINING
5Section: 3
6Source: libcurl
7See-also:
8 - CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE (3)
9 - CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE (3)
10 - CURLMOPT_MAXCONNECTS (3)
11 - CURLMOPT_MAX_HOST_CONNECTIONS (3)
12 - CURLMOPT_MAX_PIPELINE_LENGTH (3)
13 - CURLMOPT_PIPELINING_SITE_BL (3)
14Protocol:
15 - HTTP
16Added-in: 7.16.0
17---
19# NAME
21CURLMOPT_PIPELINING - enable HTTP multiplexing
23# SYNOPSIS
25~~~c
26#include <curl/curl.h>
28CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_PIPELINING, long bitmask);
29~~~
31# DESCRIPTION
33Pass in the correct value in the **bitmask** parameter to instruct libcurl to
34enable multiplexing for this multi handle.
36With multiplexing enabled, libcurl attempts to do multiple transfers over the
37same connection when doing parallel transfers to the same hosts.
39## CURLPIPE_NOTHING (0)
41Make no attempts at multiplexing.
43## CURLPIPE_HTTP1 (1)
45This bit is deprecated and has no effect since version 7.62.0.
47## CURLPIPE_MULTIPLEX (2)
49If this bit is set, libcurl tries to multiplex the new transfer over an
50existing connection if possible. This requires HTTP/2 or HTTP/3.
52# DEFAULT
54**CURLPIPE_MULTIPLEX**
56# %PROTOCOLS%
58# EXAMPLE
60~~~c
61int main(void)
63 CURLM *m = curl_multi_init();
64 /* try HTTP/2 multiplexing */
65 curl_multi_setopt(m, CURLMOPT_PIPELINING, CURLPIPE_MULTIPLEX);
67~~~
69# HISTORY
71The multiplex support bit was added in 7.43.0. HTTP/1 Pipelining support was
72disabled in 7.62.0.
74Since 7.62.0, **CURLPIPE_MULTIPLEX** is enabled by default.
76Before that, default was **CURLPIPE_NOTHING**.
78# %AVAILABILITY%
80# RETURN VALUE
82curl_multi_setopt(3) returns a CURLMcode indicating success or error.
84CURLM_OK (0) means everything was OK, non-zero means an error occurred, see
85libcurl-errors(3).
Diagnostics4 git calls · 172 ms
CallStatusSizeTime0172 ms
discover200152 B3 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=1
git.response.bytes=152
git.server.agent=gitty/1.0
git.server.object_format=sha1
git.server.caps=agent ls-refs fetch object-format
git.server.fetch=shallow filter sideband-all
git.protocol.version=2
git.pkt.frames=8
git.pkt.data=6
git.pkt.flush=2
git.pkt.delim=0
git.pkt.bytes=152
git.pkt.payload.max=34
ls-refs200149 B · hit2 ms
git.upload-pack ls-refs
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=2
git.response.bytes=149
git.response.cache=HIT
git.response.duration_ms=2
git.protocol.version=2
git.pkt.frames=3
git.pkt.data=2
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=149
git.pkt.payload.max=78
git.ls_refs.count=2
git.ls_refs.head=refs/heads/master
fetchblob:none · deepen 10200287 KiB · hit1 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=168
git.response.bytes=293470
git.response.cache=HIT
git.response.duration_ms=1
git.fetch.filter=blob:none
git.fetch.filter.requested=tree:0
git.fetch.filter.fallback=blob:none
git.fetch.filter.learned=false
git.fetch.wants=31c911efe5652725e930f4d2e60c9060e5f6646d
git.fetch.haves.count=0
git.fetch.deepen=10
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=10
git.pkt.data=8
git.pkt.flush=1
git.pkt.delim=1
git.pkt.bytes=293470
git.pkt.payload.max=65516
git.sideband.band1.bytes=293354
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=87
git.pack.bytes=293354
git.pack.ofs_delta=0
git.pack.ref_delta=1
git.pack.chain.max=1
git.pack.trailer=6a646bcda6740bab42e321b51998b52ea15146c0
git.pack.full=86
Open pack map
fetch200992 B168 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=992
git.response.cache=MISS
git.response.duration_ms=168
git.fetch.wants=93345f1f10a402224c7a57e9e34768bfd45c5f9b
git.fetch.haves.count=0
git.fetch.deepen=0
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=3
git.pkt.data=2
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=992
git.pkt.payload.max=971
git.sideband.band1.bytes=970
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0

Each row is one HTTP round trip ply made to the git server for this page, on one timeline. discover asks what the server speaks, ls-refs lists branch tips, fetch brings objects by id. A hit was served by Workers Cache. Tap a row for its wire details.

Remote
https://5ad2236b39de4c8bd8f6270ea63f3ea9.artifacts.cloudflare.net/git/public-v0/curl.git
Ref
refs/heads/master
Commit
31c911efe5652725e930f4d2e60c9060e5f6646d
cf-ray
a5e35488db31994c
Request
b5c0b4d2…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format