Artifactspublic-v0

curl

master
ply4 git calls334 ms288 KiB2 cachedprotocol v2
75 lines1.8 KiBRaw

NAME

CURLOPT_DNS_SHUFFLE_ADDRESSES - shuffle IP addresses for hostname

SYNOPSIS

c
#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_DNS_SHUFFLE_ADDRESSES, long onoff);

DESCRIPTION

Pass a long set to 1 to enable this option.

When a name is resolved and more than one IP address is returned, this function shuffles the order of all returned addresses so that they are used in a random order. This is similar to the ordering behavior of the legacy gethostbyname function which is no longer used on most platforms.

Addresses are not reshuffled if name resolution is completed using the DNS cache. CURLOPT_DNS_CACHE_TIMEOUT(3) can be used together with this option to reduce DNS cache timeout or disable caching entirely if frequent reshuffling is needed.

Since the addresses returned are randomly reordered, the order is not in accordance with RFC 3484 or any other deterministic order that may be generated by the system's name resolution implementation. This may have performance impacts and may cause IPv4 to be used before IPv6 or vice versa.

DEFAULT

0 (disabled)

%PROTOCOLS%

EXAMPLE

c
int main(void)
{
  CURL *curl = curl_easy_init();
  if(curl) {
    CURLcode result;
    curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
    curl_easy_setopt(curl, CURLOPT_DNS_SHUFFLE_ADDRESSES, 1L);

    result = curl_easy_perform(curl);

    /* always cleanup */
    curl_easy_cleanup(curl);
  }
}

%AVAILABILITY%

RETURN VALUE

CURLE_OK or an error such as CURLE_UNKNOWN_OPTION.

1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Title: CURLOPT_DNS_SHUFFLE_ADDRESSES
5Section: 3
6Source: libcurl
7See-also:
8 - CURLOPT_DNS_CACHE_TIMEOUT (3)
9 - CURLOPT_IPRESOLVE (3)
10Protocol:
11 - All
12Added-in: 7.60.0
13---
15# NAME
17CURLOPT_DNS_SHUFFLE_ADDRESSES - shuffle IP addresses for hostname
19# SYNOPSIS
21~~~c
22#include <curl/curl.h>
24CURLcode curl_easy_setopt(CURL *handle, CURLOPT_DNS_SHUFFLE_ADDRESSES, long onoff);
25~~~
27# DESCRIPTION
29Pass a long set to 1 to enable this option.
31When a name is resolved and more than one IP address is returned, this
32function shuffles the order of all returned addresses so that they are used in
33a random order. This is similar to the ordering behavior of the legacy
34gethostbyname function which is no longer used on most platforms.
36Addresses are not reshuffled if name resolution is completed using the DNS
37cache. CURLOPT_DNS_CACHE_TIMEOUT(3) can be used together with this
38option to reduce DNS cache timeout or disable caching entirely if frequent
39reshuffling is needed.
41Since the addresses returned are randomly reordered, the order is not in
42accordance with RFC 3484 or any other deterministic order that may be
43generated by the system's name resolution implementation. This may have
44performance impacts and may cause IPv4 to be used before IPv6 or vice versa.
46# DEFAULT
480 (disabled)
50# %PROTOCOLS%
52# EXAMPLE
54~~~c
55int main(void)
57 CURL *curl = curl_easy_init();
58 if(curl) {
59 CURLcode result;
60 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
61 curl_easy_setopt(curl, CURLOPT_DNS_SHUFFLE_ADDRESSES, 1L);
63 result = curl_easy_perform(curl);
65 /* always cleanup */
66 curl_easy_cleanup(curl);
67 }
69~~~
71# %AVAILABILITY%
73# RETURN VALUE
75CURLE_OK or an error such as CURLE_UNKNOWN_OPTION.
Diagnostics4 git calls · 334 ms
CallStatusSizeTime0334 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=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 · 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 · hit2 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=329
git.response.bytes=293470
git.response.cache=HIT
git.response.duration_ms=2
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 KiB329 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=1031
git.response.cache=MISS
git.response.duration_ms=329
git.fetch.wants=87d3fd82ef7d1b123d253ba3b260e641424d7d05
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=1031
git.pkt.payload.max=1010
git.sideband.band1.bytes=1009
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
a5e3443a09206e2a
Request
da7c0c14…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format