Artifactspublic-v0

curl

master
ply4 git calls687 ms288 KiB1 cachedprotocol v2
81 lines2.0 KiBRaw

NAME

CURLOPT_HAPROXY_CLIENT_IP - set HAProxy PROXY protocol client IP

SYNOPSIS

c
#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HAPROXY_CLIENT_IP,
                          char *client_ip);

DESCRIPTION

When this parameter is set to a valid IPv4 or IPv6 numerical address in its printable ASCII string version, the library sends this as the client address in the HAProxy PROXY protocol v1 header at beginning of the connection.

The client address is reported upstream as the source and destination address of the non-existing client connection (since 8.20.0).

This option is an alternative to CURLOPT_HAPROXYPROTOCOL(3) as that one cannot use a specified address.

Using this option multiple times makes the last set string override the previous ones. Set it to NULL to disable its use again.

The application does not have to keep the string around after setting this option.

As with most libcurl options, the user of this option must make sure that the correct data (address) is passed on. libcurl does little to no verification.

Note that if you want to send a different HAProxy client IP in a subsequent request, you need to make sure that it is done over a fresh connection as libcurl does not send it again while reusing connections.

DEFAULT

NULL, no HAProxy header is sent

%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_HAPROXY_CLIENT_IP, "1.1.1.1");
    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_HAPROXY_CLIENT_IP
5Section: 3
6Source: libcurl
7Protocol:
8 - All
9See-also:
10 - CURLOPT_HAPROXYPROTOCOL (3)
11 - CURLOPT_PROXY (3)
12Added-in: 8.2.0
13---
15# NAME
17CURLOPT_HAPROXY_CLIENT_IP - set HAProxy PROXY protocol client IP
19# SYNOPSIS
21~~~c
22#include <curl/curl.h>
24CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HAPROXY_CLIENT_IP,
25 char *client_ip);
26~~~
28# DESCRIPTION
30When this parameter is set to a valid IPv4 or IPv6 numerical address in its
31printable ASCII string version, the library sends this as the client address
32in the HAProxy PROXY protocol v1 header at beginning of the connection.
34The client address is reported upstream as the source *and* destination address
35of the non-existing client connection (since 8.20.0).
37This option is an alternative to CURLOPT_HAPROXYPROTOCOL(3) as that one cannot
38use a specified address.
40Using this option multiple times makes the last set string override the
41previous ones. Set it to NULL to disable its use again.
43The application does not have to keep the string around after setting this
44option.
46As with most libcurl options, the user of this option must make sure that the
47*correct* data (address) is passed on. libcurl does little to no verification.
49Note that if you want to send a *different* HAProxy client IP in a subsequent
50request, you need to make sure that it is done over a fresh connection as
51libcurl does not send it again while reusing connections.
53# DEFAULT
55NULL, no HAProxy header is sent
57# %PROTOCOLS%
59# EXAMPLE
61~~~c
62int main(void)
64 CURL *curl = curl_easy_init();
65 if(curl) {
66 CURLcode result;
67 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
68 curl_easy_setopt(curl, CURLOPT_HAPROXY_CLIENT_IP, "1.1.1.1");
69 result = curl_easy_perform(curl);
70 }
72~~~
74# %AVAILABILITY%
76# RETURN VALUE
78curl_easy_setopt(3) returns a CURLcode indicating success or error.
80CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
81libcurl-errors(3).
Diagnostics4 git calls · 687 ms
CallStatusSizeTime0687 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=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 B2 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=UPDATING
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 · hit4 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=681
git.response.bytes=293470
git.response.cache=HIT
git.response.duration_ms=4
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 KiB681 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=1139
git.response.cache=MISS
git.response.duration_ms=681
git.fetch.wants=f9fdba66b5cc917f88cb2ad709599eaf3e224231
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=1139
git.pkt.payload.max=1118
git.sideband.band1.bytes=1117
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
a5e3437e688b6e2a
Request
f4286179…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format