Loading docs/libcurl/curl_easy_setopt.3 +14 −12 Original line number Original line Diff line number Diff line Loading @@ -284,15 +284,16 @@ be prefixed with [protocol]:// since any such prefix will be ignored. The proxy's port number may optionally be specified with the separate option proxy's port number may optionally be specified with the separate option \fICURLOPT_PROXYPORT\fP. \fICURLOPT_PROXYPORT\fP. \fBNOTE:\fP when you tell the library to use an HTTP proxy, libcurl will When you tell the library to use an HTTP proxy, libcurl will transparently transparently convert operations to HTTP even if you specify an FTP URL convert operations to HTTP even if you specify an FTP URL etc. This may have etc. This may have an impact on what other features of the library you can an impact on what other features of the library you can use, such as use, such as \fICURLOPT_QUOTE\fP and similar FTP specifics that don't work \fICURLOPT_QUOTE\fP and similar FTP specifics that don't work unless you unless you tunnel through the HTTP proxy. Such tunneling is activated with tunnel through the HTTP proxy. Such tunneling is activated with \fICURLOPT_HTTPPROXYTUNNEL\fP. \fICURLOPT_HTTPPROXYTUNNEL\fP. \fBNOTE2:\fP libcurl respects the environment variables \fBhttp_proxy\fP, libcurl respects the environment variables \fBhttp_proxy\fP, \fBftp_proxy\fP, \fBftp_proxy\fP, \fBall_proxy\fP etc, if any of those is set. \fBall_proxy\fP etc, if any of those is set. The \fICURLOPT_PROXY\fP option does however override any possibly set environment variables. Starting with 7.14.1, the proxy host string can be specified the exact same Starting with 7.14.1, the proxy host string can be specified the exact same way as the proxy environment variables, include protocol prefix (http://) and way as the proxy environment variables, include protocol prefix (http://) and Loading Loading @@ -667,7 +668,7 @@ existing for this "session" only. Pass a char * to a cookie string. Cookie can be either in Netscape / Mozilla Pass a char * to a cookie string. Cookie can be either in Netscape / Mozilla format or just regular HTTP-style header (Set-Cookie: ...) format. If cURL format or just regular HTTP-style header (Set-Cookie: ...) format. If cURL cookie engine was not enabled it will enable its cookie engine. Passing a cookie engine was not enabled it will enable its cookie engine. Passing a magic string \&"ALL" will erase all cookies known by cURL. magic string \&"ALL" will erase all cookies known by cURL. (Added in 7.14.1) .IP CURLOPT_HTTPGET .IP CURLOPT_HTTPGET Pass a long. If the long is non-zero, this forces the HTTP request to get back Pass a long. If the long is non-zero, this forces the HTTP request to get back to GET. usable if a POST, HEAD, PUT or a custom request have been used to GET. usable if a POST, HEAD, PUT or a custom request have been used Loading @@ -688,10 +689,11 @@ Enforce HTTP 1.0 requests. .IP CURL_HTTP_VERSION_1_1 .IP CURL_HTTP_VERSION_1_1 Enforce HTTP 1.1 requests. Enforce HTTP 1.1 requests. .IP CURLOPT_IGNORE_CONTENT_LENGTH .IP CURLOPT_IGNORE_CONTENT_LENGTH Ignore the Content-Length header. This is useful for Apache 1.x which will Ignore the Content-Length header. This is useful for Apache 1.x (and similar report incorrect content length for files over 2 gigabytes. If this option servers) which will report incorrect content length for files over 2 is used, curl will not be able to accurately report progress, and will gigabytes. If this option is used, curl will not be able to accurately report simply stop the download when the server ends the connection. progress, and will simply stop the download when the server ends the connection. (added in 7.14.1) .RE .RE .SH FTP OPTIONS .SH FTP OPTIONS .IP CURLOPT_FTPPORT .IP CURLOPT_FTPPORT Loading Loading
docs/libcurl/curl_easy_setopt.3 +14 −12 Original line number Original line Diff line number Diff line Loading @@ -284,15 +284,16 @@ be prefixed with [protocol]:// since any such prefix will be ignored. The proxy's port number may optionally be specified with the separate option proxy's port number may optionally be specified with the separate option \fICURLOPT_PROXYPORT\fP. \fICURLOPT_PROXYPORT\fP. \fBNOTE:\fP when you tell the library to use an HTTP proxy, libcurl will When you tell the library to use an HTTP proxy, libcurl will transparently transparently convert operations to HTTP even if you specify an FTP URL convert operations to HTTP even if you specify an FTP URL etc. This may have etc. This may have an impact on what other features of the library you can an impact on what other features of the library you can use, such as use, such as \fICURLOPT_QUOTE\fP and similar FTP specifics that don't work \fICURLOPT_QUOTE\fP and similar FTP specifics that don't work unless you unless you tunnel through the HTTP proxy. Such tunneling is activated with tunnel through the HTTP proxy. Such tunneling is activated with \fICURLOPT_HTTPPROXYTUNNEL\fP. \fICURLOPT_HTTPPROXYTUNNEL\fP. \fBNOTE2:\fP libcurl respects the environment variables \fBhttp_proxy\fP, libcurl respects the environment variables \fBhttp_proxy\fP, \fBftp_proxy\fP, \fBftp_proxy\fP, \fBall_proxy\fP etc, if any of those is set. \fBall_proxy\fP etc, if any of those is set. The \fICURLOPT_PROXY\fP option does however override any possibly set environment variables. Starting with 7.14.1, the proxy host string can be specified the exact same Starting with 7.14.1, the proxy host string can be specified the exact same way as the proxy environment variables, include protocol prefix (http://) and way as the proxy environment variables, include protocol prefix (http://) and Loading Loading @@ -667,7 +668,7 @@ existing for this "session" only. Pass a char * to a cookie string. Cookie can be either in Netscape / Mozilla Pass a char * to a cookie string. Cookie can be either in Netscape / Mozilla format or just regular HTTP-style header (Set-Cookie: ...) format. If cURL format or just regular HTTP-style header (Set-Cookie: ...) format. If cURL cookie engine was not enabled it will enable its cookie engine. Passing a cookie engine was not enabled it will enable its cookie engine. Passing a magic string \&"ALL" will erase all cookies known by cURL. magic string \&"ALL" will erase all cookies known by cURL. (Added in 7.14.1) .IP CURLOPT_HTTPGET .IP CURLOPT_HTTPGET Pass a long. If the long is non-zero, this forces the HTTP request to get back Pass a long. If the long is non-zero, this forces the HTTP request to get back to GET. usable if a POST, HEAD, PUT or a custom request have been used to GET. usable if a POST, HEAD, PUT or a custom request have been used Loading @@ -688,10 +689,11 @@ Enforce HTTP 1.0 requests. .IP CURL_HTTP_VERSION_1_1 .IP CURL_HTTP_VERSION_1_1 Enforce HTTP 1.1 requests. Enforce HTTP 1.1 requests. .IP CURLOPT_IGNORE_CONTENT_LENGTH .IP CURLOPT_IGNORE_CONTENT_LENGTH Ignore the Content-Length header. This is useful for Apache 1.x which will Ignore the Content-Length header. This is useful for Apache 1.x (and similar report incorrect content length for files over 2 gigabytes. If this option servers) which will report incorrect content length for files over 2 is used, curl will not be able to accurately report progress, and will gigabytes. If this option is used, curl will not be able to accurately report simply stop the download when the server ends the connection. progress, and will simply stop the download when the server ends the connection. (added in 7.14.1) .RE .RE .SH FTP OPTIONS .SH FTP OPTIONS .IP CURLOPT_FTPPORT .IP CURLOPT_FTPPORT Loading
