Unverified Commit cc67b0a2 authored by Daniel Stenberg's avatar Daniel Stenberg
Browse files

CURLOPT_ACCEPT_ENCODING.3: list them comma-separated [ci skip]

parent 0e7e5e1a
Loading
Loading
Loading
Loading
+11 −3
Original line number Diff line number Diff line
@@ -45,10 +45,14 @@ Alternatively, you can specify exactly the encoding or list of encodings you
want in the response. Four encodings are supported: \fIidentity\fP, meaning
non-compressed, \fIdeflate\fP which requests the server to compress its
response using the zlib algorithm, \fIgzip\fP which requests the gzip
algorithm and (since curl 7.57.0) \fIbr\fP which is brotli.
algorithm and (since curl 7.57.0) \fIbr\fP which is brotli.  Provide them in
the string as a comma-separated list of accepted encodings, like:

Set this option to NULL to explicitly disable it, which makes libcurl not send
an Accept-Encoding: header and not decompress contents automatically.
  "br, gzip, deflate".

Set \fICURLOPT_ACCEPT_ENCODING(3)\fP to NULL to explicitly disable it, which
makes libcurl not send an Accept-Encoding: header and not decompress received
contents automatically.

You can also opt to just include the Accept-Encoding: header in your request
with \fICURLOPT_HTTPHEADER(3)\fP but then there will be no automatic
@@ -88,6 +92,10 @@ if(curl) {
.fi
.SH AVAILABILITY
This option was called CURLOPT_ENCODING before 7.21.6

The specific libcurl you're using must have been built with zlib to be able to
decompress gzip and deflate responses and with the brotli library to
decompress brotli responses.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.