Artifactspublic-v0

curl

master
ply4 git calls156 ms288 KiB2 cachedprotocol v2
80 lines2.0 KiBRaw

NAME

CURLMOPT_MAXCONNECTS - size of connection cache

SYNOPSIS

c
#include <curl/curl.h>

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

DESCRIPTION

Pass a long indicating the max, the maximum amount of connections that libcurl may keep alive in its connection cache after use. By default libcurl enlarges the size for each added easy handle to make it fit twice the number of added easy handles.

By setting this option, you prevent the cache size from growing beyond the limit set by you.

When the cache is full on a set limit, curl closes the oldest connection present in the cache to prevent the number of connections from increasing.

When the cache is full on the default limit, curl closes the oldest connection present in the cache only if it has not been used for at least a second. This is done because the number of added transfer can vary greatly, depending on how the application uses them.

This option is for the multi handle's use only, when using the easy interface you should instead use the CURLOPT_MAXCONNECTS(3) option.

See CURLMOPT_MAX_TOTAL_CONNECTIONS(3) for limiting the number of active connections.

Changing this value when there are transfers in progress is possible, and 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

See DESCRIPTION

%PROTOCOLS%

EXAMPLE

c
int main(void)
{
  CURLM *m = curl_multi_init();
  /* only keep 10 connections in the cache */
  curl_multi_setopt(m, CURLMOPT_MAXCONNECTS, 10L);
}

%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_MAXCONNECTS
5Section: 3
6Source: libcurl
7See-also:
8 - CURLMOPT_MAX_HOST_CONNECTIONS (3)
9 - CURLOPT_MAXCONNECTS (3)
10Protocol:
11 - All
12Added-in: 7.16.3
13---
15# NAME
17CURLMOPT_MAXCONNECTS - size of connection cache
19# SYNOPSIS
21~~~c
22#include <curl/curl.h>
24CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_MAXCONNECTS, long max);
25~~~
27# DESCRIPTION
29Pass a long indicating the **max**, the maximum amount of connections that
30libcurl may keep alive in its connection cache after use. By default libcurl
31enlarges the size for each added easy handle to make it fit twice the number
32of added easy handles.
34By setting this option, you prevent the cache size from growing beyond the
35limit set by you.
37When the cache is full on a set limit, curl closes the oldest connection
38present in the cache to prevent the number of connections from increasing.
40When the cache is full on the default limit, curl closes the oldest connection
41present in the cache only if it has not been used for at least a second. This
42is done because the number of added transfer can vary greatly, depending on
43how the application uses them.
45This option is for the multi handle's use only, when using the easy interface
46you should instead use the CURLOPT_MAXCONNECTS(3) option.
48See CURLMOPT_MAX_TOTAL_CONNECTIONS(3) for limiting the number of active
49connections.
51Changing this value when there are transfers in progress is possible, and the
52new value is then used the next time checks are performed. Lowering the value
53does not close down any active transfers, it prevents new ones from being
54made.
56# DEFAULT
58See DESCRIPTION
60# %PROTOCOLS%
62# EXAMPLE
64~~~c
65int main(void)
67 CURLM *m = curl_multi_init();
68 /* only keep 10 connections in the cache */
69 curl_multi_setopt(m, CURLMOPT_MAXCONNECTS, 10L);
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 · 156 ms
CallStatusSizeTime0156 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 · hit5 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=149
git.response.bytes=293470
git.response.cache=HIT
git.response.duration_ms=5
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.1 KiB149 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=1118
git.response.cache=MISS
git.response.duration_ms=149
git.fetch.wants=5973fa8c55cd6e76df0415ed3aa11fd9fee20eb9
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=1118
git.pkt.payload.max=1097
git.sideband.band1.bytes=1096
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
a5e3347fbd2df485
Request
10fbbbd3…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format