Artifactspublic-v0

curl

master
ply4 git calls171 ms288 KiB2 cachedprotocol v2
77 lines1.9 KiBRaw

NAME

CURLOPT_MAXCONNECTS - maximum connection cache size

SYNOPSIS

c
#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_MAXCONNECTS, long amount);

DESCRIPTION

Pass a long. The set amount is the maximum number of connections that libcurl may keep alive in its connection cache after use. The default is 5, and there is not much point in changing this value unless you are perfectly aware of how this works. This concerns connections using any of the protocols that support persistent connections.

When reaching the maximum limit, curl closes the oldest connection present in the cache to prevent the number of connections from increasing.

If you already have performed transfers with this curl handle, setting a smaller CURLOPT_MAXCONNECTS(3) than before may cause open connections to get closed unnecessarily.

If you add this easy handle to a multi handle, this setting is not acknowledged, and you must instead use curl_multi_setopt(3) and the CURLMOPT_MAXCONNECTS(3) option.

DEFAULT

5

%PROTOCOLS%

EXAMPLE

c
int main(void)
{
  CURL *curl = curl_easy_init();
  if(curl) {
    CURLcode result;
    curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
    /* limit the connection cache for this handle to no more than 3 */
    curl_easy_setopt(curl, CURLOPT_MAXCONNECTS, 3L);
    result = curl_easy_perform(curl);
  }
}

%AVAILABILITY%

RETURN VALUE

curl_easy_setopt(3) returns a CURLcode indicating success or error.

CURLE_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: CURLOPT_MAXCONNECTS
5Section: 3
6Source: libcurl
7See-also:
8 - CURLMOPT_MAXCONNECTS (3)
9 - CURLMOPT_MAX_HOST_CONNECTIONS (3)
10 - CURLMOPT_MAX_TOTAL_CONNECTIONS (3)
11 - CURLOPT_MAXREDIRS (3)
12Protocol:
13 - All
14Added-in: 7.7
15---
17# NAME
19CURLOPT_MAXCONNECTS - maximum connection cache size
21# SYNOPSIS
23~~~c
24#include <curl/curl.h>
26CURLcode curl_easy_setopt(CURL *handle, CURLOPT_MAXCONNECTS, long amount);
27~~~
29# DESCRIPTION
31Pass a long. The set *amount* is the maximum number of connections that
32libcurl may keep alive in its connection cache after use. The default is 5,
33and there is not much point in changing this value unless you are perfectly
34aware of how this works. This concerns connections using any of the protocols
35that support persistent connections.
37When reaching the maximum limit, curl closes the oldest connection present in
38the cache to prevent the number of connections from increasing.
40If you already have performed transfers with this curl handle, setting a
41smaller CURLOPT_MAXCONNECTS(3) than before may cause open connections to get
42closed unnecessarily.
44If you add this easy handle to a multi handle, this setting is not
45acknowledged, and you must instead use curl_multi_setopt(3) and the
46CURLMOPT_MAXCONNECTS(3) option.
48# DEFAULT
52# %PROTOCOLS%
54# EXAMPLE
56~~~c
57int main(void)
59 CURL *curl = curl_easy_init();
60 if(curl) {
61 CURLcode result;
62 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
63 /* limit the connection cache for this handle to no more than 3 */
64 curl_easy_setopt(curl, CURLOPT_MAXCONNECTS, 3L);
65 result = curl_easy_perform(curl);
66 }
68~~~
70# %AVAILABILITY%
72# RETURN VALUE
74curl_easy_setopt(3) returns a CURLcode indicating success or error.
76CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
77libcurl-errors(3).
Diagnostics4 git calls · 171 ms
CallStatusSizeTime0171 ms
discover200152 B2 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=2
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 · hit3 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=166
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.0 KiB166 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=1025
git.response.cache=MISS
git.response.duration_ms=166
git.fetch.wants=96df2614a148f8610f6fb2aec1718789980a4fab
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=1025
git.pkt.payload.max=1004
git.sideband.band1.bytes=1003
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
a5e32b53ce525094
Request
c2a271b9…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format