1 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. 2 SPDX-License-Identifier: curl 3 Long: haproxy-clientip 4 Help: Sets client IP in HAProxy PROXY protocol v1 header 5 Protocols: HTTP 6 Added: 8.2.0 7 Category: http proxy 8 Example: --haproxy-clientip $IP 9 See-also: proxy 10 Multi: single 11 --- 12 Sets a client IP in HAProxy PROXY protocol v1 header at the beginning of the 13 connection. 14 15 For valid requests, IPv4 addresses must be indicated as a series of exactly 16 4 integers in the range [0..255] inclusive written in decimal representation 17 separated by exactly one dot between each other. Heading zeroes are not 18 permitted in front of numbers in order to avoid any possible confusion 19 with octal numbers. IPv6 addresses must be indicated as series of 4 hexadecimal 20 digits (upper or lower case) delimited by colons between each other, with the 21 acceptance of one double colon sequence to replace the largest acceptable range 22 of consecutive zeroes. The total number of decoded bits must exactly be 128. 23 24 Otherwise, any string can be accepted for the client IP and get sent. 25 26 It replaces --haproxy-protocol if used, it is not necessary to specify both flags. 27 28 This option is primarily useful when sending test requests to 29 verify a service is working as intended. 30