romenskiy2012/curl
1
0
Fork 0
mirror of https://github.com/curl/curl.git synced 2026-04-14 21:31:42 +03:00
Code Issues Projects Releases Packages Wiki Activity

CURLOPT_HAPROXY_CLIENT_IP.md: mention assuption on data format

Browse source 
The user is assumed to pass in correct data. I think we should start
clarifying this in more places.

Closes #21042
This commit is contained in:
Daniel Stenberg 2026-03-20 23:41:11 +01:00
parent 82009c4220
commit 7e0a9b309c
No known key found for this signature in database
GPG key ID: 5CC908FDB71E12C2
1 changed files with 6 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

9
docs/libcurl/opts/CURLOPT_HAPROXY_CLIENT_IP.md
View file

@ -27,9 +27,9 @@ CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HAPROXY_CLIENT_IP,
# DESCRIPTION
When this parameter is set to a valid IPv4 or IPv6 numerical address, the
library sends this address as client address in the HAProxy PROXY protocol v1
header at beginning of the connection.
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.
This option is an alternative to CURLOPT_HAPROXYPROTOCOL(3) as that one cannot
use a specified address.
@ -40,6 +40,9 @@ 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.