Commit d2bcf1e3 authored by Desmond O. Chang's avatar Desmond O. Chang Committed by Jay Satiro
Browse files

url: add option CURLOPT_SUPPRESS_CONNECT_HEADERS 



- Add new option CURLOPT_SUPPRESS_CONNECT_HEADERS to allow suppressing
  proxy CONNECT response headers from the user callback functions
  CURLOPT_HEADERFUNCTION and CURLOPT_WRITEFUNCTION.

- Add new tool option --suppress-connect-headers to expose
  CURLOPT_SUPPRESS_CONNECT_HEADERS and allow suppressing proxy CONNECT
  response headers from --dump-header and --include.

Assisted-by: Jay Satiro
Assisted-by: default avatar <CarloCannas@users.noreply.github.com>
Closes https://github.com/curl/curl/pull/783
parent ec1d0ed1

docs/cmdline-opts/Makefile.am

+2 −1
Original line number Diff line number Diff line
@@ -59,7 +59,8 @@ DPAGES = abstract-unix-socket.d anyauth.d append.d basic.d cacert.d capath.d cer 
  service-name.d show-error.d silent.d socks4a.d socks4.d socks5.d	\

  socks5-gssapi-nec.d socks5-gssapi-service.d socks5-hostname.d		\

  speed-limit.d speed-time.d ssl-allow-beast.d ssl.d ssl-no-revoke.d	\

  ssl-reqd.d sslv2.d sslv3.d stderr.d tcp-fastopen.d tcp-nodelay.d	\

  ssl-reqd.d sslv2.d sslv3.d stderr.d suppress-connect-headers.d	\

  tcp-fastopen.d tcp-nodelay.d						\

  telnet-option.d tftp-blksize.d tftp-no-options.d time-cond.d		\

  tls-max.d \

  tlsauthtype.d tlspassword.d tlsuser.d tlsv1.0.d tlsv1.1.d tlsv1.2.d	\

docs/cmdline-opts/proxytunnel.d

+3 −0
Original line number Diff line number Diff line
@@ -8,3 +8,6 @@ to attempt to tunnel through the proxy instead of merely using it to do 
HTTP-like operations. The tunnel approach is made with the HTTP proxy CONNECT

request and requires that the proxy allows direct connect to the remote port

number curl wants to tunnel through to.



To suppress proxy CONNECT response headers when curl is set to output headers

use --suppress-connect-headers.

docs/cmdline-opts/suppress-connect-headers.d

0 → 100644
+8 −0
Original line number Diff line number Diff line 
Long: suppress-connect-headers

Help: Suppress proxy CONNECT response headers

See-also: dump-header include proxytunnel

---

When --proxytunnel is used and a CONNECT request is made don't output proxy

CONNECT response headers. This option is meant to be used with --dump-header or

--include which are used to show protocol headers in the output. It has no

effect on debug options such as --verbose or --trace, or any statistics.

docs/libcurl/curl_easy_setopt.3

+2 −0
Original line number Diff line number Diff line
@@ -137,6 +137,8 @@ Data pointer to pass to the chunk callbacks. See \fICURLOPT_CHUNK_DATA(3)\fP 
Callback for wildcard matching. See \fICURLOPT_FNMATCH_FUNCTION(3)\fP

.IP CURLOPT_FNMATCH_DATA

Data pointer to pass to the wildcard matching callback. See \fICURLOPT_FNMATCH_DATA(3)\fP

.IP CURLOPT_SUPPRESS_CONNECT_HEADERS

Suppress proxy CONNECT response headers from user callbacks. See \fICURLOPT_SUPPRESS_CONNECT_HEADERS(3)\fP

.SH ERROR OPTIONS

.IP CURLOPT_ERRORBUFFER

Error message buffer. See \fICURLOPT_ERRORBUFFER(3)\fP

docs/libcurl/opts/CURLINFO_HEADER_SIZE.3

+3 −0
Original line number Diff line number Diff line
@@ -30,6 +30,9 @@ CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_HEADER_SIZE, long *sizep); 
.SH DESCRIPTION

Pass a pointer to a long to receive the total size of all the headers

received. Measured in number of bytes.



The total includes the size of any received headers suppressed by

\fICURLOPT_SUPPRESS_CONNECT_HEADERS(3)\fP.

.SH PROTOCOLS

All

.SH EXAMPLE