Artifactspublic-v0

curl

master
ply4 git calls288 ms288 KiB2 cachedprotocol v2
80 lines2.3 KiBRaw

NAME

CURLMOPT_MAX_HOST_CONNECTIONS - max number of connections to a single host

SYNOPSIS

c
#include <curl/curl.h>

CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_MAX_HOST_CONNECTIONS,
                            long max);

DESCRIPTION

Pass a long to indicate max, the maximum amount of simultaneously open connections libcurl may hold a single host (a host being the same as a hostname + port number pair). For each new transfer to the same host, libcurl might open a new connection up to the limit set by CURLMOPT_MAX_HOST_CONNECTIONS(3). When the limit is reached, new sessions are kept pending until a connection becomes available.

The default max value is 0, unlimited. This set limit is also used for proxy connections, and then the proxy is considered to be the host for which this limit counts.

When more transfers are added to the multi handle than what can be performed due to the set limit, they are queued up waiting for their chance.

While a transfer is queued up internally waiting for a connection, the CURLOPT_TIMEOUT_MS(3) timeout is counted inclusive of the waiting time, meaning that if you set a too narrow timeout the transfer might never even start before it times out. The CURLOPT_CONNECTTIMEOUT_MS(3) time is also similarly still treated as a per-connect timeout and might expire even before making a new connection is permitted.

Changing this value while there are transfers in progress is possible. The new value is then used the next time checks are performed. Lowering the value does not close down any active transfers, it prevents new ones from being made.

DEFAULT

0

%PROTOCOLS%

EXAMPLE

c
int main(void)
{
  CURLM *m = curl_multi_init();
  /* do no more than 2 connections per host */
  curl_multi_setopt(m, CURLMOPT_MAX_HOST_CONNECTIONS, 2L);
}

%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_MAX_HOST_CONNECTIONS
5Section: 3
6Source: libcurl
7See-also:
8 - CURLMOPT_MAXCONNECTS (3)
9 - CURLMOPT_MAX_TOTAL_CONNECTIONS (3)
10Protocol:
11 - All
12Added-in: 7.30.0
13---
15# NAME
17CURLMOPT_MAX_HOST_CONNECTIONS - max number of connections to a single host
19# SYNOPSIS
21~~~c
22#include <curl/curl.h>
24CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_MAX_HOST_CONNECTIONS,
25 long max);
26~~~
28# DESCRIPTION
30Pass a long to indicate **max**, the maximum amount of simultaneously open
31connections libcurl may hold a single host (a host being the same as a
32hostname + port number pair). For each new transfer to the same host, libcurl
33might open a new connection up to the limit set by
34CURLMOPT_MAX_HOST_CONNECTIONS(3). When the limit is reached, new sessions are
35kept pending until a connection becomes available.
37The default **max** value is 0, unlimited. This set limit is also used for
38proxy connections, and then the proxy is considered to be the host for which
39this limit counts.
41When more transfers are added to the multi handle than what can be performed
42due to the set limit, they are queued up waiting for their chance.
44While a transfer is queued up internally waiting for a connection, the
45CURLOPT_TIMEOUT_MS(3) timeout is counted inclusive of the waiting time,
46meaning that if you set a too narrow timeout the transfer might never even
47start before it times out. The CURLOPT_CONNECTTIMEOUT_MS(3) time is also
48similarly still treated as a per-connect timeout and might expire even before
49making a new connection is permitted.
51Changing this value while there are transfers in progress is possible. The new
52value is then used the next time checks are performed. Lowering the value does
53not close down any active transfers, it prevents new ones from being
54made.
56# DEFAULT
60# %PROTOCOLS%
62# EXAMPLE
64~~~c
65int main(void)
67 CURLM *m = curl_multi_init();
68 /* do no more than 2 connections per host */
69 curl_multi_setopt(m, CURLMOPT_MAX_HOST_CONNECTIONS, 2L);
71~~~
73# %AVAILABILITY%
75# RETURN VALUE
77curl_multi_setopt(3) returns a CURLMcode indicating success or error.
79CURLM_OK (0) means everything was OK, non-zero means an error occurred, see
80libcurl-errors(3).
Diagnostics4 git calls · 288 ms
CallStatusSizeTime0288 ms
discover200152 B5 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=3
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 · hit5 ms
git.upload-pack ls-refs
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=5
git.response.bytes=149
git.response.cache=HIT
git.response.duration_ms=5
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 · hit3 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=280
git.response.bytes=293470
git.response.cache=HIT
git.response.duration_ms=3
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
fetch2001.2 KiB280 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=1227
git.response.cache=MISS
git.response.duration_ms=280
git.fetch.wants=184830fd5d4699c630e86a8ddde11bf9d7e340ca
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=1227
git.pkt.payload.max=1206
git.sideband.band1.bytes=1205
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
a5e374c33f35a140
Request
4f68e213…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format