Artifactspublic-v0

curl

master
ply4 git calls87 ms288 KiB3 cachedprotocol v2
83 lines2.0 KiBRaw

NAME

CURLMOPT_NETWORK_CHANGED - signal network changed

SYNOPSIS

c
#include <curl/curl.h>

CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_NETWORK_CHANGED,
                            long value);

DESCRIPTION

Pass a long with a bitmask to tell libcurl how the multi handle should react. The following values in the mask are defined. All bits not mentioned are reserved for future extensions.

This option can be set at any time and repeatedly. Each call only affects the currently cached connections and DNS information. Any connection created or DNS information added afterwards is cached the usual way again. Phrasing it another way: the option is not persisted but setting it serves as a "trigger" to clear the caches.

The call affects only the connection and DNS cache of the multi handle itself and not the ones owned by SHARE handles.

CURLMNWC_CLEAR_ALL

Clear everything. (Added in 8.20.0)

CURLMNWC_CLEAR_CONNS

No longer reuse any existing connection in the multi handle's connection cache. This closes all connections that are not in use. Ongoing transfers continue on the connections they operate on.

CURLMNWC_CLEAR_DNS

Clear the multi handle's DNS cache. Ongoing transfers keep using their already resolved addresses, but future name resolutions are performed again.

DEFAULT

0, which has no effect.

%PROTOCOLS%

EXAMPLE

c
int main(void)
{
  CURLM *m = curl_multi_init();
  /* do transfers on the multi handle */
  /* do not reuse existing connections */
  curl_multi_setopt(m, CURLMOPT_NETWORK_CHANGED, CURLMNWC_CLEAR_CONNS);
}

%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_NETWORK_CHANGED
5Section: 3
6Source: libcurl
7See-also:
8 - CURLOPT_FRESH_CONNECT (3)
9 - CURLOPT_FORBID_REUSE (3)
10Protocol:
11 - All
12Added-in: 8.16.0
13---
15# NAME
17CURLMOPT_NETWORK_CHANGED - signal network changed
19# SYNOPSIS
21~~~c
22#include <curl/curl.h>
24CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_NETWORK_CHANGED,
25 long value);
26~~~
28# DESCRIPTION
30Pass a long with a bitmask to tell libcurl how the multi handle should react.
31The following values in the mask are defined. All bits not mentioned are
32reserved for future extensions.
34This option can be set at any time and repeatedly. Each call only affects the
35*currently* cached connections and DNS information. Any connection created or
36DNS information added afterwards is cached the usual way again. Phrasing it
37another way: the option is not persisted but setting it serves as a "trigger"
38to clear the caches.
40The call affects only the connection and DNS cache of the multi handle itself
41and not the ones owned by SHARE handles.
43## CURLMNWC_CLEAR_ALL
45Clear everything. (Added in 8.20.0)
47## CURLMNWC_CLEAR_CONNS
49No longer reuse any existing connection in the multi handle's connection
50cache. This closes all connections that are not in use. Ongoing transfers
51continue on the connections they operate on.
53## CURLMNWC_CLEAR_DNS
55Clear the multi handle's DNS cache. Ongoing transfers keep using their already
56resolved addresses, but future name resolutions are performed again.
58# DEFAULT
600, which has no effect.
62# %PROTOCOLS%
64# EXAMPLE
66~~~c
67int main(void)
69 CURLM *m = curl_multi_init();
70 /* do transfers on the multi handle */
71 /* do not reuse existing connections */
72 curl_multi_setopt(m, CURLMOPT_NETWORK_CHANGED, CURLMNWC_CLEAR_CONNS);
74~~~
76# %AVAILABILITY%
78# RETURN VALUE
80curl_multi_setopt(3) returns a CURLMcode indicating success or error.
82CURLM_OK (0) means everything was OK, non-zero means an error occurred, see
83libcurl-errors(3).
Diagnostics4 git calls · 87 ms
CallStatusSizeTime087 ms
discover200152 B3 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
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 · hit3 ms
git.upload-pack ls-refs
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=3
git.response.bytes=149
git.response.cache=HIT
git.response.duration_ms=3
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 · hit22 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=3
git.response.bytes=293470
git.response.cache=HIT
git.response.duration_ms=22
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 KiB · hit62 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=62
git.response.bytes=1127
git.response.cache=HIT
git.response.duration_ms=62
git.fetch.wants=a2a44c359df8b02c7212d7b28535aff8b30b14af
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=1127
git.pkt.payload.max=1106
git.sideband.band1.bytes=1105
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
a5e3671c8af61de6
Request
6dbfe127…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format