2015-06-19 10:07:32 -04:00
|
|
|
.\" **************************************************************************
|
|
|
|
|
.\" * _ _ ____ _
|
|
|
|
|
.\" * Project ___| | | | _ \| |
|
|
|
|
|
.\" * / __| | | | |_) | |
|
|
|
|
|
.\" * | (__| |_| | _ <| |___
|
|
|
|
|
.\" * \___|\___/|_| \_\_____|
|
|
|
|
|
.\" *
|
2019-03-03 05:17:52 -05:00
|
|
|
.\" * Copyright (C) 1998 - 2019, Daniel Stenberg, <daniel@haxx.se>, et al.
|
2015-06-19 10:07:32 -04:00
|
|
|
.\" *
|
|
|
|
|
.\" * This software is licensed as described in the file COPYING, which
|
|
|
|
|
.\" * you should have received as part of this distribution. The terms
|
2016-02-02 18:19:02 -05:00
|
|
|
.\" * are also available at https://curl.haxx.se/docs/copyright.html.
|
2015-06-19 10:07:32 -04:00
|
|
|
.\" *
|
|
|
|
|
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
|
|
|
|
|
.\" * copies of the Software, and permit persons to whom the Software is
|
|
|
|
|
.\" * furnished to do so, under the terms of the COPYING file.
|
|
|
|
|
.\" *
|
|
|
|
|
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
|
|
|
|
|
.\" * KIND, either express or implied.
|
|
|
|
|
.\" *
|
|
|
|
|
.\" **************************************************************************
|
|
|
|
|
.\"
|
|
|
|
|
.TH curl_easy_setopt 3 "25 Jun 2014" "libcurl 7.38.0" "libcurl Manual"
|
|
|
|
|
.SH NAME
|
|
|
|
|
curl_easy_setopt \- set options for a curl easy handle
|
|
|
|
|
.SH SYNOPSIS
|
|
|
|
|
#include <curl/curl.h>
|
|
|
|
|
|
|
|
|
|
CURLcode curl_easy_setopt(CURL *handle, CURLoption option, parameter);
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
\fIcurl_easy_setopt(3)\fP is used to tell libcurl how to behave. By setting
|
|
|
|
|
the appropriate options, the application can change libcurl's behavior. All
|
|
|
|
|
options are set with an \fIoption\fP followed by a \fIparameter\fP. That
|
|
|
|
|
parameter can be a \fBlong\fP, a \fBfunction pointer\fP, an \fBobject
|
|
|
|
|
pointer\fP or a \fBcurl_off_t\fP, depending on what the specific option
|
|
|
|
|
expects. Read this manual carefully as bad input values may cause libcurl to
|
|
|
|
|
behave badly! You can only set one option in each function call. A typical
|
|
|
|
|
application uses many \fIcurl_easy_setopt(3)\fP calls in the setup phase.
|
|
|
|
|
|
|
|
|
|
Options set with this function call are valid for all forthcoming transfers
|
|
|
|
|
performed using this \fIhandle\fP. The options are not in any way reset
|
|
|
|
|
between transfers, so if you want subsequent transfers with different options,
|
|
|
|
|
you must change them between the transfers. You can optionally reset all
|
|
|
|
|
options back to internal default with \fIcurl_easy_reset(3)\fP.
|
|
|
|
|
|
|
|
|
|
Strings passed to libcurl as 'char *' arguments, are copied by the library;
|
|
|
|
|
thus the string storage associated to the pointer argument may be overwritten
|
|
|
|
|
after \fIcurl_easy_setopt(3)\fP returns. The only exception to this rule is
|
|
|
|
|
really \fICURLOPT_POSTFIELDS(3)\fP, but the alternative that copies the string
|
|
|
|
|
\fICURLOPT_COPYPOSTFIELDS(3)\fP has some usage characteristics you need to
|
|
|
|
|
read up on.
|
|
|
|
|
|
|
|
|
|
The order in which the options are set does not matter.
|
|
|
|
|
|
|
|
|
|
Before version 7.17.0, strings were not copied. Instead the user was forced
|
|
|
|
|
keep them available until libcurl no longer needed them.
|
|
|
|
|
|
|
|
|
|
The \fIhandle\fP is the return code from a \fIcurl_easy_init(3)\fP or
|
|
|
|
|
\fIcurl_easy_duphandle(3)\fP call.
|
|
|
|
|
.SH BEHAVIOR OPTIONS
|
|
|
|
|
.IP CURLOPT_VERBOSE
|
|
|
|
|
Display verbose information. See \fICURLOPT_VERBOSE(3)\fP
|
|
|
|
|
.IP CURLOPT_HEADER
|
|
|
|
|
Include the header in the body output. See \fICURLOPT_HEADER(3)\fP
|
|
|
|
|
.IP CURLOPT_NOPROGRESS
|
|
|
|
|
Shut off the progress meter. See \fICURLOPT_NOPROGRESS(3)\fP
|
|
|
|
|
.IP CURLOPT_NOSIGNAL
|
|
|
|
|
Do not install signal handlers. See \fICURLOPT_NOSIGNAL(3)\fP
|
|
|
|
|
.IP CURLOPT_WILDCARDMATCH
|
|
|
|
|
Transfer multiple files according to a file name pattern. See \fICURLOPT_WILDCARDMATCH(3)\fP
|
|
|
|
|
.SH CALLBACK OPTIONS
|
|
|
|
|
.IP CURLOPT_WRITEFUNCTION
|
|
|
|
|
Callback for writing data. See \fICURLOPT_WRITEFUNCTION(3)\fP
|
|
|
|
|
.IP CURLOPT_WRITEDATA
|
|
|
|
|
Data pointer to pass to the write callback. See \fICURLOPT_WRITEDATA(3)\fP
|
|
|
|
|
.IP CURLOPT_READFUNCTION
|
|
|
|
|
Callback for reading data. See \fICURLOPT_READFUNCTION(3)\fP
|
|
|
|
|
.IP CURLOPT_READDATA
|
|
|
|
|
Data pointer to pass to the read callback. See \fICURLOPT_READDATA(3)\fP
|
|
|
|
|
.IP CURLOPT_IOCTLFUNCTION
|
|
|
|
|
Callback for I/O operations. See \fICURLOPT_IOCTLFUNCTION(3)\fP
|
|
|
|
|
.IP CURLOPT_IOCTLDATA
|
|
|
|
|
Data pointer to pass to the I/O callback. See \fICURLOPT_IOCTLDATA(3)\fP
|
|
|
|
|
.IP CURLOPT_SEEKFUNCTION
|
|
|
|
|
Callback for seek operations. See \fICURLOPT_SEEKFUNCTION(3)\fP
|
|
|
|
|
.IP CURLOPT_SEEKDATA
|
|
|
|
|
Data pointer to pass to the seek callback. See \fICURLOPT_SEEKDATA(3)\fP
|
|
|
|
|
.IP CURLOPT_SOCKOPTFUNCTION
|
|
|
|
|
Callback for sockopt operations. See \fICURLOPT_SOCKOPTFUNCTION(3)\fP
|
|
|
|
|
.IP CURLOPT_SOCKOPTDATA
|
|
|
|
|
Data pointer to pass to the sockopt callback. See \fICURLOPT_SOCKOPTDATA(3)\fP
|
|
|
|
|
.IP CURLOPT_OPENSOCKETFUNCTION
|
|
|
|
|
Callback for socket creation. See \fICURLOPT_OPENSOCKETFUNCTION(3)\fP
|
|
|
|
|
.IP CURLOPT_OPENSOCKETDATA
|
|
|
|
|
Data pointer to pass to the open socket callback. See \fICURLOPT_OPENSOCKETDATA(3)\fP
|
|
|
|
|
.IP CURLOPT_CLOSESOCKETFUNCTION
|
|
|
|
|
Callback for closing socket. See \fICURLOPT_CLOSESOCKETFUNCTION(3)\fP
|
|
|
|
|
.IP CURLOPT_CLOSESOCKETDATA
|
|
|
|
|
Data pointer to pass to the close socket callback. See \fICURLOPT_CLOSESOCKETDATA(3)\fP
|
|
|
|
|
.IP CURLOPT_PROGRESSFUNCTION
|
|
|
|
|
OBSOLETE callback for progress meter. See \fICURLOPT_PROGRESSFUNCTION(3)\fP
|
|
|
|
|
.IP CURLOPT_PROGRESSDATA
|
|
|
|
|
Data pointer to pass to the progress meter callback. See \fICURLOPT_PROGRESSDATA(3)\fP
|
|
|
|
|
.IP CURLOPT_XFERINFOFUNCTION
|
|
|
|
|
Callback for progress meter. See \fICURLOPT_XFERINFOFUNCTION(3)\fP
|
|
|
|
|
.IP CURLOPT_XFERINFODATA
|
|
|
|
|
Data pointer to pass to the progress meter callback. See \fICURLOPT_XFERINFODATA(3)\fP
|
|
|
|
|
.IP CURLOPT_HEADERFUNCTION
|
|
|
|
|
Callback for writing received headers. See \fICURLOPT_HEADERFUNCTION(3)\fP
|
|
|
|
|
.IP CURLOPT_HEADERDATA
|
|
|
|
|
Data pointer to pass to the header callback. See \fICURLOPT_HEADERDATA(3)\fP
|
|
|
|
|
.IP CURLOPT_DEBUGFUNCTION
|
|
|
|
|
Callback for debug information. See \fICURLOPT_DEBUGFUNCTION(3)\fP
|
|
|
|
|
.IP CURLOPT_DEBUGDATA
|
|
|
|
|
Data pointer to pass to the debug callback. See \fICURLOPT_DEBUGDATA(3)\fP
|
|
|
|
|
.IP CURLOPT_SSL_CTX_FUNCTION
|
|
|
|
|
Callback for SSL context logic. See \fICURLOPT_SSL_CTX_FUNCTION(3)\fP
|
|
|
|
|
.IP CURLOPT_SSL_CTX_DATA
|
|
|
|
|
Data pointer to pass to the SSL context callback. See \fICURLOPT_SSL_CTX_DATA(3)\fP
|
|
|
|
|
.IP CURLOPT_CONV_TO_NETWORK_FUNCTION
|
|
|
|
|
Callback for code base conversion. See \fICURLOPT_CONV_TO_NETWORK_FUNCTION(3)\fP
|
|
|
|
|
.IP CURLOPT_CONV_FROM_NETWORK_FUNCTION
|
|
|
|
|
Callback for code base conversion. See \fICURLOPT_CONV_FROM_NETWORK_FUNCTION(3)\fP
|
|
|
|
|
.IP CURLOPT_CONV_FROM_UTF8_FUNCTION
|
|
|
|
|
Callback for code base conversion. See \fICURLOPT_CONV_FROM_UTF8_FUNCTION(3)\fP
|
|
|
|
|
.IP CURLOPT_INTERLEAVEFUNCTION
|
|
|
|
|
Callback for RTSP interleaved data. See \fICURLOPT_INTERLEAVEFUNCTION(3)\fP
|
|
|
|
|
.IP CURLOPT_INTERLEAVEDATA
|
|
|
|
|
Data pointer to pass to the RTSP interleave callback. See \fICURLOPT_INTERLEAVEDATA(3)\fP
|
|
|
|
|
.IP CURLOPT_CHUNK_BGN_FUNCTION
|
|
|
|
|
Callback for wildcard download start of chunk. See \fICURLOPT_CHUNK_BGN_FUNCTION(3)\fP
|
|
|
|
|
.IP CURLOPT_CHUNK_END_FUNCTION
|
|
|
|
|
Callback for wildcard download end of chunk. See \fICURLOPT_CHUNK_END_FUNCTION(3)\fP
|
|
|
|
|
.IP CURLOPT_CHUNK_DATA
|
|
|
|
|
Data pointer to pass to the chunk callbacks. See \fICURLOPT_CHUNK_DATA(3)\fP
|
|
|
|
|
.IP CURLOPT_FNMATCH_FUNCTION
|
|
|
|
|
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
|
2016-04-28 05:33:25 -04:00
|
|
|
.IP CURLOPT_SUPPRESS_CONNECT_HEADERS
|
|
|
|
|
Suppress proxy CONNECT response headers from user callbacks. See \fICURLOPT_SUPPRESS_CONNECT_HEADERS(3)\fP
|
2018-02-14 12:20:43 -05:00
|
|
|
.IP CURLOPT_RESOLVER_START_FUNCTION
|
|
|
|
|
Callback to be called before a new resolve request is started. See \fICURLOPT_RESOLVER_START_FUNCTION(3)\fP
|
|
|
|
|
.IP CURLOPT_RESOLVER_START_DATA
|
|
|
|
|
Data pointer to pass to resolver start callback. See \fICURLOPT_RESOLVER_START_DATA(3)\fP
|
2015-06-19 10:07:32 -04:00
|
|
|
.SH ERROR OPTIONS
|
|
|
|
|
.IP CURLOPT_ERRORBUFFER
|
|
|
|
|
Error message buffer. See \fICURLOPT_ERRORBUFFER(3)\fP
|
|
|
|
|
.IP CURLOPT_STDERR
|
|
|
|
|
stderr replacement stream. See \fICURLOPT_STDERR(3)\fP
|
|
|
|
|
.IP CURLOPT_FAILONERROR
|
|
|
|
|
Fail on HTTP 4xx errors. \fICURLOPT_FAILONERROR(3)\fP
|
2016-09-22 16:15:13 -04:00
|
|
|
.IP CURLOPT_KEEP_SENDING_ON_ERROR
|
|
|
|
|
Keep sending on HTTP >= 300 errors. \fICURLOPT_KEEP_SENDING_ON_ERROR(3)\fP
|
2015-06-19 10:07:32 -04:00
|
|
|
.SH NETWORK OPTIONS
|
|
|
|
|
.IP CURLOPT_URL
|
|
|
|
|
URL to work on. See \fICURLOPT_URL(3)\fP
|
|
|
|
|
.IP CURLOPT_PATH_AS_IS
|
|
|
|
|
Disable squashing /../ and /./ sequences in the path. See \fICURLOPT_PATH_AS_IS(3)\fP
|
|
|
|
|
.IP CURLOPT_PROTOCOLS
|
|
|
|
|
Allowed protocols. See \fICURLOPT_PROTOCOLS(3)\fP
|
|
|
|
|
.IP CURLOPT_REDIR_PROTOCOLS
|
|
|
|
|
Protocols to allow redirects to. See \fICURLOPT_REDIR_PROTOCOLS(3)\fP
|
2015-08-22 21:49:26 -04:00
|
|
|
.IP CURLOPT_DEFAULT_PROTOCOL
|
|
|
|
|
Default protocol. See \fICURLOPT_DEFAULT_PROTOCOL(3)\fP
|
2015-06-19 10:07:32 -04:00
|
|
|
.IP CURLOPT_PROXY
|
|
|
|
|
Proxy to use. See \fICURLOPT_PROXY(3)\fP
|
2016-12-17 12:09:28 -05:00
|
|
|
.IP CURLOPT_PRE_PROXY
|
|
|
|
|
Socks proxy to use. See \fICURLOPT_PRE_PROXY(3)\fP
|
2015-06-19 10:07:32 -04:00
|
|
|
.IP CURLOPT_PROXYPORT
|
|
|
|
|
Proxy port to use. See \fICURLOPT_PROXYPORT(3)\fP
|
|
|
|
|
.IP CURLOPT_PROXYTYPE
|
|
|
|
|
Proxy type. See \fICURLOPT_PROXYTYPE(3)\fP
|
|
|
|
|
.IP CURLOPT_NOPROXY
|
|
|
|
|
Filter out hosts from proxy use. \fICURLOPT_NOPROXY(3)\fP
|
|
|
|
|
.IP CURLOPT_HTTPPROXYTUNNEL
|
|
|
|
|
Tunnel through the HTTP proxy. \fICURLOPT_HTTPPROXYTUNNEL(3)\fP
|
2016-01-25 08:37:24 -05:00
|
|
|
.IP CURLOPT_CONNECT_TO
|
|
|
|
|
Connect to a specific host and port. See \fICURLOPT_CONNECT_TO(3)\fP
|
2017-04-27 09:18:49 -04:00
|
|
|
.IP CURLOPT_SOCKS5_AUTH
|
|
|
|
|
Socks5 authentication methods. See \fICURLOPT_SOCKS5_AUTH(3)\fP
|
2015-06-19 10:07:32 -04:00
|
|
|
.IP CURLOPT_SOCKS5_GSSAPI_SERVICE
|
|
|
|
|
Socks5 GSSAPI service name. \fICURLOPT_SOCKS5_GSSAPI_SERVICE(3)\fP
|
|
|
|
|
.IP CURLOPT_SOCKS5_GSSAPI_NEC
|
|
|
|
|
Socks5 GSSAPI NEC mode. See \fICURLOPT_SOCKS5_GSSAPI_NEC(3)\fP
|
|
|
|
|
.IP CURLOPT_PROXY_SERVICE_NAME
|
2016-04-08 16:45:08 -04:00
|
|
|
Proxy authentication service name. \fICURLOPT_PROXY_SERVICE_NAME(3)\fP
|
2016-12-01 07:05:04 -05:00
|
|
|
.IP CURLOPT_HAPROXYPROTOCOL
|
2018-05-18 11:47:47 -04:00
|
|
|
Send an HAProxy PROXY protocol v1 header. See \fICURLOPT_HAPROXYPROTOCOL(3)\fP
|
2015-06-19 10:07:32 -04:00
|
|
|
.IP CURLOPT_SERVICE_NAME
|
2016-04-08 16:45:08 -04:00
|
|
|
Authentication service name. \fICURLOPT_SERVICE_NAME(3)\fP
|
2015-06-19 10:07:32 -04:00
|
|
|
.IP CURLOPT_INTERFACE
|
|
|
|
|
Bind connection locally to this. See \fICURLOPT_INTERFACE(3)\fP
|
|
|
|
|
.IP CURLOPT_LOCALPORT
|
|
|
|
|
Bind connection locally to this port. See \fICURLOPT_LOCALPORT(3)\fP
|
|
|
|
|
.IP CURLOPT_LOCALPORTRANGE
|
|
|
|
|
Bind connection locally to port range. See \fICURLOPT_LOCALPORTRANGE(3)\fP
|
|
|
|
|
.IP CURLOPT_DNS_CACHE_TIMEOUT
|
|
|
|
|
Timeout for DNS cache. See \fICURLOPT_DNS_CACHE_TIMEOUT(3)\fP
|
|
|
|
|
.IP CURLOPT_DNS_USE_GLOBAL_CACHE
|
|
|
|
|
OBSOLETE Enable global DNS cache. See \fICURLOPT_DNS_USE_GLOBAL_CACHE(3)\fP
|
2018-09-06 03:16:02 -04:00
|
|
|
.IP CURLOPT_DOH_URL
|
|
|
|
|
Use this DOH server for name resolves. See \fICURLOPT_DOH_URL(3)\fP
|
2015-06-19 10:07:32 -04:00
|
|
|
.IP CURLOPT_BUFFERSIZE
|
2016-12-20 05:48:15 -05:00
|
|
|
Ask for alternate buffer size. See \fICURLOPT_BUFFERSIZE(3)\fP
|
2015-06-19 10:07:32 -04:00
|
|
|
.IP CURLOPT_PORT
|
|
|
|
|
Port number to connect to. See \fICURLOPT_PORT(3)\fP
|
2016-04-18 18:48:56 -04:00
|
|
|
.IP CURLOPT_TCP_FASTOPEN
|
|
|
|
|
Enable TFO, TCP Fast Open. See \fICURLOPT_TCP_FASTOPEN(3)\fP
|
2015-06-19 10:07:32 -04:00
|
|
|
.IP CURLOPT_TCP_NODELAY
|
|
|
|
|
Disable the Nagle algorithm. See \fICURLOPT_TCP_NODELAY(3)\fP
|
|
|
|
|
.IP CURLOPT_ADDRESS_SCOPE
|
|
|
|
|
IPv6 scope for local addresses. See \fICURLOPT_ADDRESS_SCOPE(3)\fP
|
|
|
|
|
.IP CURLOPT_TCP_KEEPALIVE
|
|
|
|
|
Enable TCP keep-alive. See \fICURLOPT_TCP_KEEPALIVE(3)\fP
|
|
|
|
|
.IP CURLOPT_TCP_KEEPIDLE
|
|
|
|
|
Idle time before sending keep-alive. See \fICURLOPT_TCP_KEEPIDLE(3)\fP
|
|
|
|
|
.IP CURLOPT_TCP_KEEPINTVL
|
|
|
|
|
Interval between keep-alive probes. See \fICURLOPT_TCP_KEEPINTVL(3)\fP
|
|
|
|
|
.IP CURLOPT_UNIX_SOCKET_PATH
|
|
|
|
|
Path to a Unix domain socket. See \fICURLOPT_UNIX_SOCKET_PATH(3)\fP
|
2017-01-08 17:51:08 -05:00
|
|
|
.IP CURLOPT_ABSTRACT_UNIX_SOCKET
|
|
|
|
|
Path to an abstract Unix domain socket. See \fICURLOPT_ABSTRACT_UNIX_SOCKET(3)\fP
|
2015-06-19 10:07:32 -04:00
|
|
|
.SH NAMES and PASSWORDS OPTIONS (Authentication)
|
|
|
|
|
.IP CURLOPT_NETRC
|
|
|
|
|
Enable .netrc parsing. See \fICURLOPT_NETRC(3)\fP
|
|
|
|
|
.IP CURLOPT_NETRC_FILE
|
|
|
|
|
\&.netrc file name. See \fICURLOPT_NETRC_FILE(3)\fP
|
|
|
|
|
.IP CURLOPT_USERPWD
|
|
|
|
|
User name and password. See \fICURLOPT_USERPWD(3)\fP
|
|
|
|
|
.IP CURLOPT_PROXYUSERPWD
|
|
|
|
|
Proxy user name and password. See \fICURLOPT_PROXYUSERPWD(3)\fP
|
|
|
|
|
.IP CURLOPT_USERNAME
|
|
|
|
|
User name. See \fICURLOPT_USERNAME(3)\fP
|
|
|
|
|
.IP CURLOPT_PASSWORD
|
|
|
|
|
Password. See \fICURLOPT_PASSWORD(3)\fP
|
|
|
|
|
.IP CURLOPT_LOGIN_OPTIONS
|
|
|
|
|
Login options. See \fICURLOPT_LOGIN_OPTIONS(3)\fP
|
|
|
|
|
.IP CURLOPT_PROXYUSERNAME
|
|
|
|
|
Proxy user name. See \fICURLOPT_PROXYUSERNAME(3)\fP
|
|
|
|
|
.IP CURLOPT_PROXYPASSWORD
|
|
|
|
|
Proxy password. See \fICURLOPT_PROXYPASSWORD(3)\fP
|
|
|
|
|
.IP CURLOPT_HTTPAUTH
|
|
|
|
|
HTTP server authentication methods. See \fICURLOPT_HTTPAUTH(3)\fP
|
|
|
|
|
.IP CURLOPT_TLSAUTH_USERNAME
|
|
|
|
|
TLS authentication user name. See \fICURLOPT_TLSAUTH_USERNAME(3)\fP
|
2016-11-16 12:49:15 -05:00
|
|
|
.IP CURLOPT_PROXY_TLSAUTH_USERNAME
|
|
|
|
|
Proxy TLS authentication user name. See \fICURLOPT_PROXY_TLSAUTH_USERNAME(3)\fP
|
2015-06-19 10:07:32 -04:00
|
|
|
.IP CURLOPT_TLSAUTH_PASSWORD
|
|
|
|
|
TLS authentication password. See \fICURLOPT_TLSAUTH_PASSWORD(3)\fP
|
2016-11-16 12:49:15 -05:00
|
|
|
.IP CURLOPT_PROXY_TLSAUTH_PASSWORD
|
|
|
|
|
Proxy TLS authentication password. See \fICURLOPT_PROXY_TLSAUTH_PASSWORD(3)\fP
|
2015-06-19 10:07:32 -04:00
|
|
|
.IP CURLOPT_TLSAUTH_TYPE
|
|
|
|
|
TLS authentication methods. See \fICURLOPT_TLSAUTH_TYPE(3)\fP
|
2016-11-16 12:49:15 -05:00
|
|
|
.IP CURLOPT_PROXY_TLSAUTH_TYPE
|
|
|
|
|
Proxy TLS authentication methods. See \fICURLOPT_PROXY_TLSAUTH_TYPE(3)\fP
|
2015-06-19 10:07:32 -04:00
|
|
|
.IP CURLOPT_PROXYAUTH
|
|
|
|
|
HTTP proxy authentication methods. See \fICURLOPT_PROXYAUTH(3)\fP
|
|
|
|
|
.IP CURLOPT_SASL_IR
|
|
|
|
|
Enable SASL initial response. See \fICURLOPT_SASL_IR(3)\fP
|
|
|
|
|
.IP CURLOPT_XOAUTH2_BEARER
|
|
|
|
|
OAuth2 bearer token. See \fICURLOPT_XOAUTH2_BEARER(3)\fP
|
2018-02-25 14:17:25 -05:00
|
|
|
.IP CURLOPT_DISALLOW_USERNAME_IN_URL
|
|
|
|
|
Don't allow username in URL. See \fICURLOPT_DISALLOW_USERNAME_IN_URL(3)\fP
|
2002-09-18 11:26:42 -04:00
|
|
|
.SH HTTP OPTIONS
|
2004-02-27 04:02:06 -05:00
|
|
|
.IP CURLOPT_AUTOREFERER
|
2014-06-21 09:45:50 -04:00
|
|
|
Automatically set Referer: header. See \fICURLOPT_AUTOREFERER(3)\fP
|
2011-04-14 16:59:34 -04:00
|
|
|
.IP CURLOPT_ACCEPT_ENCODING
|
2014-06-21 09:45:50 -04:00
|
|
|
Accept-Encoding and automatic decompressing data. See \fICURLOPT_ACCEPT_ENCODING(3)\fP
|
2011-04-14 16:59:34 -04:00
|
|
|
.IP CURLOPT_TRANSFER_ENCODING
|
2014-06-21 09:45:50 -04:00
|
|
|
Request Transfer-Encoding. See \fICURLOPT_TRANSFER_ENCODING(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_FOLLOWLOCATION
|
2014-06-21 09:45:50 -04:00
|
|
|
Follow HTTP redirects. See \fICURLOPT_FOLLOWLOCATION(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_UNRESTRICTED_AUTH
|
2014-10-30 18:40:05 -04:00
|
|
|
Do not restrict authentication to original host. \fICURLOPT_UNRESTRICTED_AUTH(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_MAXREDIRS
|
2014-06-21 09:45:50 -04:00
|
|
|
Maximum number of redirects to follow. See \fICURLOPT_MAXREDIRS(3)\fP
|
2008-10-16 17:02:38 -04:00
|
|
|
.IP CURLOPT_POSTREDIR
|
2014-06-21 09:45:50 -04:00
|
|
|
How to act on redirects after POST. See \fICURLOPT_POSTREDIR(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_PUT
|
2018-04-17 15:17:57 -04:00
|
|
|
Issue an HTTP PUT request. See \fICURLOPT_PUT(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_POST
|
2018-04-17 15:17:57 -04:00
|
|
|
Issue an HTTP POST request. See \fICURLOPT_POST(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_POSTFIELDS
|
2014-06-21 09:45:50 -04:00
|
|
|
Send a POST with this data. See \fICURLOPT_POSTFIELDS(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_POSTFIELDSIZE
|
2014-06-21 09:45:50 -04:00
|
|
|
The POST data is this big. See \fICURLOPT_POSTFIELDSIZE(3)\fP
|
2004-03-12 03:55:47 -05:00
|
|
|
.IP CURLOPT_POSTFIELDSIZE_LARGE
|
2014-06-21 09:45:50 -04:00
|
|
|
The POST data is this big. See \fICURLOPT_POSTFIELDSIZE_LARGE(3)\fP
|
2007-10-15 14:32:01 -04:00
|
|
|
.IP CURLOPT_COPYPOSTFIELDS
|
2014-06-21 09:45:50 -04:00
|
|
|
Send a POST with this data - and copy it. See \fICURLOPT_COPYPOSTFIELDS(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_HTTPPOST
|
2014-06-21 09:45:50 -04:00
|
|
|
Multipart formpost HTTP POST. See \fICURLOPT_HTTPPOST(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_REFERER
|
2014-06-21 09:45:50 -04:00
|
|
|
Referer: header. See \fICURLOPT_REFERER(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_USERAGENT
|
2014-06-21 09:45:50 -04:00
|
|
|
User-Agent: header. See \fICURLOPT_USERAGENT(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_HTTPHEADER
|
2014-06-21 09:45:50 -04:00
|
|
|
Custom HTTP headers. See \fICURLOPT_HTTPHEADER(3)\fP
|
2014-02-04 17:37:29 -05:00
|
|
|
.IP CURLOPT_HEADEROPT
|
2014-06-21 09:45:50 -04:00
|
|
|
Control custom headers. See \fICURLOPT_HEADEROPT(3)\fP
|
2014-01-31 02:10:07 -05:00
|
|
|
.IP CURLOPT_PROXYHEADER
|
2014-06-21 09:45:50 -04:00
|
|
|
Custom HTTP headers sent to proxy. See \fICURLOPT_PROXYHEADER(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_HTTP200ALIASES
|
2014-06-21 09:45:50 -04:00
|
|
|
Alternative versions of 200 OK. See \fICURLOPT_HTTP200ALIASES(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_COOKIE
|
2014-06-21 09:45:50 -04:00
|
|
|
Cookie(s) to send. See \fICURLOPT_COOKIE(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_COOKIEFILE
|
2014-06-21 09:45:50 -04:00
|
|
|
File to read cookies from. See \fICURLOPT_COOKIEFILE(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_COOKIEJAR
|
2014-06-21 09:45:50 -04:00
|
|
|
File to write cookies to. See \fICURLOPT_COOKIEJAR(3)\fP
|
2004-02-27 04:02:06 -05:00
|
|
|
.IP CURLOPT_COOKIESESSION
|
2014-06-21 09:45:50 -04:00
|
|
|
Start a new cookie session. See \fICURLOPT_COOKIESESSION(3)\fP
|
2005-07-27 18:17:14 -04:00
|
|
|
.IP CURLOPT_COOKIELIST
|
2014-06-21 09:45:50 -04:00
|
|
|
Add or control cookies. See \fICURLOPT_COOKIELIST(3)\fP
|
2019-03-03 05:17:52 -05:00
|
|
|
.IP CURLOPT_ALTSVC
|
|
|
|
|
Specify the Alt-Svc: cache file name. See \fICURLOPT_ALTSVC(3)\fP
|
|
|
|
|
.IP CURLOPT_ALTSVC_CTRL
|
|
|
|
|
Enable and configure Alt-Svc: treatment. See \fICURLOPT_ALTSVC_CTRL(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_HTTPGET
|
2018-04-17 15:17:57 -04:00
|
|
|
Do an HTTP GET request. See \fICURLOPT_HTTPGET(3)\fP
|
2017-06-21 17:35:08 -04:00
|
|
|
.IP CURLOPT_REQUEST_TARGET
|
|
|
|
|
Set the request target. \fICURLOPT_REQUEST_TARGET(3)\fP
|
2019-07-21 17:48:58 -04:00
|
|
|
.IP CURLOPT_H3
|
|
|
|
|
Specify HTTP/3 behavior. \fICURLOPT_H3(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_HTTP_VERSION
|
2014-06-21 09:45:50 -04:00
|
|
|
HTTP version to use. \fICURLOPT_HTTP_VERSION(3)\fP
|
2018-12-17 09:46:56 -05:00
|
|
|
.IP CURLOPT_HTTP09_ALLOWED
|
|
|
|
|
Allow HTTP/0.9 responses. \fICURLOPT_HTTP09_ALLOWED(3)\fP
|
2005-08-24 06:57:28 -04:00
|
|
|
.IP CURLOPT_IGNORE_CONTENT_LENGTH
|
2014-06-21 13:46:45 -04:00
|
|
|
Ignore Content-Length. See \fICURLOPT_IGNORE_CONTENT_LENGTH(3)\fP
|
2007-02-12 16:13:47 -05:00
|
|
|
.IP CURLOPT_HTTP_CONTENT_DECODING
|
2014-06-21 09:45:50 -04:00
|
|
|
Disable Content decoding. See \fICURLOPT_HTTP_CONTENT_DECODING(3)\fP
|
2007-02-12 16:13:47 -05:00
|
|
|
.IP CURLOPT_HTTP_TRANSFER_DECODING
|
2014-06-21 09:45:50 -04:00
|
|
|
Disable Transfer decoding. See \fICURLOPT_HTTP_TRANSFER_DECODING(3)\fP
|
2014-02-13 04:49:27 -05:00
|
|
|
.IP CURLOPT_EXPECT_100_TIMEOUT_MS
|
2014-06-21 09:45:50 -04:00
|
|
|
100-continue timeout. See \fICURLOPT_EXPECT_100_TIMEOUT_MS(3)\fP
|
2018-12-06 04:18:03 -05:00
|
|
|
.IP CURLOPT_TRAILERFUNCTION
|
|
|
|
|
Set callback for sending trailing headers. See
|
|
|
|
|
\fICURLOPT_TRAILERFUNCTION(3)\fP
|
|
|
|
|
.IP CURLOPT_TRAILERDATA
|
|
|
|
|
Custom pointer passed to the trailing headers callback. See
|
|
|
|
|
\fICURLOPT_TRAILERDATA(3)\fP
|
2015-06-19 09:47:06 -04:00
|
|
|
.IP CURLOPT_PIPEWAIT
|
|
|
|
|
Wait on connection to pipeline on it. See \fICURLOPT_PIPEWAIT(3)\fP
|
2015-10-23 03:16:00 -04:00
|
|
|
.IP CURLOPT_STREAM_DEPENDS
|
|
|
|
|
This HTTP/2 stream depends on another. See \fICURLOPT_STREAM_DEPENDS(3)\fP
|
|
|
|
|
.IP CURLOPT_STREAM_DEPENDS_E
|
|
|
|
|
This HTTP/2 stream depends on another exclusively. See
|
|
|
|
|
\fICURLOPT_STREAM_DEPENDS_E(3)\fP
|
|
|
|
|
.IP CURLOPT_STREAM_WEIGHT
|
|
|
|
|
Set this HTTP/2 stream's weight. See \fICURLOPT_STREAM_WEIGHT(3)\fP
|
2009-12-31 17:38:10 -05:00
|
|
|
.SH SMTP OPTIONS
|
|
|
|
|
.IP CURLOPT_MAIL_FROM
|
2014-06-21 09:45:50 -04:00
|
|
|
Address of the sender. See \fICURLOPT_MAIL_FROM(3)\fP
|
2009-12-31 17:38:10 -05:00
|
|
|
.IP CURLOPT_MAIL_RCPT
|
2014-06-21 09:45:50 -04:00
|
|
|
Address of the recipients. See \fICURLOPT_MAIL_RCPT(3)\fP
|
2012-01-07 09:10:40 -05:00
|
|
|
.IP CURLOPT_MAIL_AUTH
|
2014-06-21 09:45:50 -04:00
|
|
|
Authentication address. See \fICURLOPT_MAIL_AUTH(3)\fP
|
2009-01-26 17:43:06 -05:00
|
|
|
.SH TFTP OPTIONS
|
2009-11-23 04:31:55 -05:00
|
|
|
.IP CURLOPT_TFTP_BLKSIZE
|
2014-06-21 09:45:50 -04:00
|
|
|
TFTP block size. See \fICURLOPT_TFTP_BLKSIZE(3)\fP
|
2015-08-17 11:54:47 -04:00
|
|
|
.IP CURLOPT_TFTP_NO_OPTIONS
|
2015-08-24 00:15:01 -04:00
|
|
|
Do not send TFTP options requests. See \fICURLOPT_TFTP_NO_OPTIONS(3)\fP
|
2002-09-18 11:26:42 -04:00
|
|
|
.SH FTP OPTIONS
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_FTPPORT
|
2014-06-21 09:45:50 -04:00
|
|
|
Use active FTP. See \fICURLOPT_FTPPORT(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_QUOTE
|
2014-06-21 09:45:50 -04:00
|
|
|
Commands to run before transfer. See \fICURLOPT_QUOTE(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_POSTQUOTE
|
2014-06-21 09:45:50 -04:00
|
|
|
Commands to run after transfer. See \fICURLOPT_POSTQUOTE(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_PREQUOTE
|
2014-06-21 09:45:50 -04:00
|
|
|
Commands to run just before transfer. See \fICURLOPT_PREQUOTE(3)\fP
|
2007-08-30 16:34:57 -04:00
|
|
|
.IP CURLOPT_APPEND
|
2014-06-21 09:45:50 -04:00
|
|
|
Append to remote file. See \fICURLOPT_APPEND(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_FTP_USE_EPRT
|
2014-06-21 09:45:50 -04:00
|
|
|
Use EPTR. See \fICURLOPT_FTP_USE_EPRT(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_FTP_USE_EPSV
|
2014-06-21 09:45:50 -04:00
|
|
|
Use EPSV. See \fICURLOPT_FTP_USE_EPSV(3)\fP
|
2010-01-01 09:44:44 -05:00
|
|
|
.IP CURLOPT_FTP_USE_PRET
|
2014-06-21 09:45:50 -04:00
|
|
|
Use PRET. See \fICURLOPT_FTP_USE_PRET(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_FTP_CREATE_MISSING_DIRS
|
2014-10-30 18:40:05 -04:00
|
|
|
Create missing directories on the remote server. See \fICURLOPT_FTP_CREATE_MISSING_DIRS(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_FTP_RESPONSE_TIMEOUT
|
2014-06-21 09:45:50 -04:00
|
|
|
Timeout for FTP responses. See \fICURLOPT_FTP_RESPONSE_TIMEOUT(3)\fP
|
2006-07-25 18:45:21 -04:00
|
|
|
.IP CURLOPT_FTP_ALTERNATIVE_TO_USER
|
2014-06-21 09:45:50 -04:00
|
|
|
Alternative to USER. See \fICURLOPT_FTP_ALTERNATIVE_TO_USER(3)\fP
|
2005-09-04 01:16:06 -04:00
|
|
|
.IP CURLOPT_FTP_SKIP_PASV_IP
|
2014-06-21 09:45:50 -04:00
|
|
|
Ignore the IP address in the PASV response. See \fICURLOPT_FTP_SKIP_PASV_IP(3)\fP
|
2004-09-16 17:45:16 -04:00
|
|
|
.IP CURLOPT_FTPSSLAUTH
|
2014-06-21 09:45:50 -04:00
|
|
|
Control how to do TLS. See \fICURLOPT_FTPSSLAUTH(3)\fP
|
2007-01-05 18:11:14 -05:00
|
|
|
.IP CURLOPT_FTP_SSL_CCC
|
2014-06-21 09:45:50 -04:00
|
|
|
Back to non-TLS again after authentication. See \fICURLOPT_FTP_SSL_CCC(3)\fP
|
2005-01-25 17:13:12 -05:00
|
|
|
.IP CURLOPT_FTP_ACCOUNT
|
2014-06-21 09:45:50 -04:00
|
|
|
Send ACCT command. See \fICURLOPT_FTP_ACCOUNT(3)\fP
|
2006-03-13 19:05:15 -05:00
|
|
|
.IP CURLOPT_FTP_FILEMETHOD
|
2014-06-21 09:45:50 -04:00
|
|
|
Specify how to reach files. See \fICURLOPT_FTP_FILEMETHOD(3)\fP
|
2010-01-21 08:58:30 -05:00
|
|
|
.SH RTSP OPTIONS
|
|
|
|
|
.IP CURLOPT_RTSP_REQUEST
|
2014-06-21 09:45:50 -04:00
|
|
|
RTSP request. See \fICURLOPT_RTSP_REQUEST(3)\fP
|
2010-01-21 08:58:30 -05:00
|
|
|
.IP CURLOPT_RTSP_SESSION_ID
|
2014-06-21 09:45:50 -04:00
|
|
|
RTSP session-id. See \fICURLOPT_RTSP_SESSION_ID(3)\fP
|
2010-01-21 08:58:30 -05:00
|
|
|
.IP CURLOPT_RTSP_STREAM_URI
|
2014-06-21 09:45:50 -04:00
|
|
|
RTSP stream URI. See \fICURLOPT_RTSP_STREAM_URI(3)\fP
|
2010-01-21 08:58:30 -05:00
|
|
|
.IP CURLOPT_RTSP_TRANSPORT
|
2014-06-21 09:45:50 -04:00
|
|
|
RTSP Transport: header. See \fICURLOPT_RTSP_TRANSPORT(3)\fP
|
2010-01-21 08:58:30 -05:00
|
|
|
.IP CURLOPT_RTSP_CLIENT_CSEQ
|
2014-06-25 16:30:36 -04:00
|
|
|
Client CSEQ number. See \fICURLOPT_RTSP_CLIENT_CSEQ(3)\fP
|
2010-01-21 08:58:30 -05:00
|
|
|
.IP CURLOPT_RTSP_SERVER_CSEQ
|
2014-06-21 09:45:50 -04:00
|
|
|
CSEQ number for RTSP Server->Client request. See \fICURLOPT_RTSP_SERVER_CSEQ(3)\fP
|
2002-09-18 11:26:42 -04:00
|
|
|
.SH PROTOCOL OPTIONS
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_TRANSFERTEXT
|
2014-06-21 09:45:50 -04:00
|
|
|
Use text transfer. See \fICURLOPT_TRANSFERTEXT(3)\fP
|
2007-12-02 18:38:23 -05:00
|
|
|
.IP CURLOPT_PROXY_TRANSFER_MODE
|
2014-06-21 09:45:50 -04:00
|
|
|
Add transfer mode to URL over proxy. See \fICURLOPT_PROXY_TRANSFER_MODE(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_CRLF
|
2014-06-21 09:45:50 -04:00
|
|
|
Convert newlines. See \fICURLOPT_CRLF(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_RANGE
|
2014-06-21 09:45:50 -04:00
|
|
|
Range requests. See \fICURLOPT_RANGE(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_RESUME_FROM
|
2014-06-21 09:45:50 -04:00
|
|
|
Resume a transfer. See \fICURLOPT_RESUME_FROM(3)\fP
|
2004-01-05 17:29:29 -05:00
|
|
|
.IP CURLOPT_RESUME_FROM_LARGE
|
2014-06-21 09:45:50 -04:00
|
|
|
Resume a transfer. See \fICURLOPT_RESUME_FROM_LARGE(3)\fP
|
2018-11-01 14:16:15 -04:00
|
|
|
.IP CURLOPT_CURLU
|
|
|
|
|
Set URL to work on with CURLU *. See \fICURLOPT_CURLU(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_CUSTOMREQUEST
|
2014-06-21 09:45:50 -04:00
|
|
|
Custom request/method. See \fICURLOPT_CUSTOMREQUEST(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_FILETIME
|
2014-06-21 09:45:50 -04:00
|
|
|
Request file modification date and time. See \fICURLOPT_FILETIME(3)\fP
|
2014-10-30 14:22:25 -04:00
|
|
|
.IP CURLOPT_DIRLISTONLY
|
|
|
|
|
List only. See \fICURLOPT_DIRLISTONLY(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_NOBODY
|
2014-06-21 09:45:50 -04:00
|
|
|
Do not get the body contents. See \fICURLOPT_NOBODY(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_INFILESIZE
|
2014-06-21 09:45:50 -04:00
|
|
|
Size of file to send. \fICURLOPT_INFILESIZE(3)\fP
|
2004-01-05 17:29:29 -05:00
|
|
|
.IP CURLOPT_INFILESIZE_LARGE
|
2014-06-21 09:45:50 -04:00
|
|
|
Size of file to send. \fICURLOPT_INFILESIZE_LARGE(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_UPLOAD
|
2014-06-21 09:45:50 -04:00
|
|
|
Upload data. See \fICURLOPT_UPLOAD(3)\fP
|
2018-08-18 10:17:05 -04:00
|
|
|
.IP CURLOPT_UPLOAD_BUFFERSIZE
|
|
|
|
|
Set upload buffer size. See \fICURLOPT_UPLOAD_BUFFERSIZE(3)\fP
|
2017-09-02 12:47:10 -04:00
|
|
|
.IP CURLOPT_MIMEPOST
|
|
|
|
|
Post/send MIME data. See \fICURLOPT_MIMEPOST(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_MAXFILESIZE
|
2014-06-21 09:45:50 -04:00
|
|
|
Maximum file size to get. See \fICURLOPT_MAXFILESIZE(3)\fP
|
2004-01-05 17:29:29 -05:00
|
|
|
.IP CURLOPT_MAXFILESIZE_LARGE
|
2014-06-21 09:45:50 -04:00
|
|
|
Maximum file size to get. See \fICURLOPT_MAXFILESIZE_LARGE(3)\fP
|
2004-02-09 08:51:52 -05:00
|
|
|
.IP CURLOPT_TIMECONDITION
|
2014-06-21 09:45:50 -04:00
|
|
|
Make a time conditional request. See \fICURLOPT_TIMECONDITION(3)\fP
|
2004-02-09 08:51:52 -05:00
|
|
|
.IP CURLOPT_TIMEVALUE
|
2014-06-21 14:43:04 -04:00
|
|
|
Time value for the time conditional request. See \fICURLOPT_TIMEVALUE(3)\fP
|
2018-01-25 17:05:24 -05:00
|
|
|
.IP CURLOPT_TIMEVALUE_LARGE
|
|
|
|
|
Time value for the time conditional request. See \fICURLOPT_TIMEVALUE_LARGE(3)\fP
|
2002-09-18 11:26:42 -04:00
|
|
|
.SH CONNECTION OPTIONS
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_TIMEOUT
|
2014-06-21 09:45:50 -04:00
|
|
|
Timeout for the entire request. See \fICURLOPT_TIMEOUT(3)\fP
|
2007-02-05 17:51:32 -05:00
|
|
|
.IP CURLOPT_TIMEOUT_MS
|
2014-06-21 09:45:50 -04:00
|
|
|
Millisecond timeout for the entire request. See \fICURLOPT_TIMEOUT_MS(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_LOW_SPEED_LIMIT
|
2014-06-21 09:45:50 -04:00
|
|
|
Low speed limit to abort transfer. See \fICURLOPT_LOW_SPEED_LIMIT(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_LOW_SPEED_TIME
|
2014-06-21 14:43:04 -04:00
|
|
|
Time to be below the speed to trigger low speed abort. See \fICURLOPT_LOW_SPEED_TIME(3)\fP
|
2006-06-22 17:36:53 -04:00
|
|
|
.IP CURLOPT_MAX_SEND_SPEED_LARGE
|
2014-10-30 18:40:05 -04:00
|
|
|
Cap the upload speed to this. See \fICURLOPT_MAX_SEND_SPEED_LARGE(3)\fP
|
2006-06-22 17:36:53 -04:00
|
|
|
.IP CURLOPT_MAX_RECV_SPEED_LARGE
|
2014-10-30 18:40:05 -04:00
|
|
|
Cap the download speed to this. See \fICURLOPT_MAX_RECV_SPEED_LARGE(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_MAXCONNECTS
|
2014-11-02 05:26:21 -05:00
|
|
|
Maximum number of connections in the connection pool. See \fICURLOPT_MAXCONNECTS(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_FRESH_CONNECT
|
2014-06-21 09:45:50 -04:00
|
|
|
Use a new connection. \fICURLOPT_FRESH_CONNECT(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_FORBID_REUSE
|
2014-06-21 09:45:50 -04:00
|
|
|
Prevent subsequent connections from re-using this. See \fICURLOPT_FORBID_REUSE(3)\fP
|
2019-04-14 17:20:01 -04:00
|
|
|
.IP CURLOPT_MAXAGE_CONN
|
|
|
|
|
Limit the age of connections for reuse. See \fICURLOPT_MAXAGE_CONN(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_CONNECTTIMEOUT
|
2014-06-21 09:45:50 -04:00
|
|
|
Timeout for the connection phase. See \fICURLOPT_CONNECTTIMEOUT(3)\fP
|
2007-02-05 17:51:32 -05:00
|
|
|
.IP CURLOPT_CONNECTTIMEOUT_MS
|
2014-06-21 09:45:50 -04:00
|
|
|
Millisecond timeout for the connection phase. See \fICURLOPT_CONNECTTIMEOUT_MS(3)\fP
|
2003-12-22 05:53:55 -05:00
|
|
|
.IP CURLOPT_IPRESOLVE
|
2014-06-21 09:45:50 -04:00
|
|
|
IP version to resolve to. See \fICURLOPT_IPRESOLVE(3)\fP
|
2006-06-20 03:03:29 -04:00
|
|
|
.IP CURLOPT_CONNECT_ONLY
|
2014-06-21 09:45:50 -04:00
|
|
|
Only connect, nothing else. See \fICURLOPT_CONNECT_ONLY(3)\fP
|
2010-11-08 03:46:48 -05:00
|
|
|
.IP CURLOPT_USE_SSL
|
2014-06-21 09:45:50 -04:00
|
|
|
Use TLS/SSL. See \fICURLOPT_USE_SSL(3)\fP
|
2010-11-08 03:53:35 -05:00
|
|
|
.IP CURLOPT_RESOLVE
|
2014-06-21 09:45:50 -04:00
|
|
|
Provide fixed/fake name resolves. See \fICURLOPT_RESOLVE(3)\fP
|
2013-09-07 12:45:50 -04:00
|
|
|
.IP CURLOPT_DNS_INTERFACE
|
2014-06-21 09:45:50 -04:00
|
|
|
Bind name resolves to this interface. See \fICURLOPT_DNS_INTERFACE(3)\fP
|
2013-09-07 12:45:50 -04:00
|
|
|
.IP CURLOPT_DNS_LOCAL_IP4
|
2014-06-21 14:43:04 -04:00
|
|
|
Bind name resolves to this IP4 address. See \fICURLOPT_DNS_LOCAL_IP4(3)\fP
|
2013-09-07 12:45:50 -04:00
|
|
|
.IP CURLOPT_DNS_LOCAL_IP6
|
2014-06-21 14:43:04 -04:00
|
|
|
Bind name resolves to this IP6 address. See \fICURLOPT_DNS_LOCAL_IP6(3)\fP
|
2015-03-18 18:20:49 -04:00
|
|
|
.IP CURLOPT_DNS_SERVERS
|
|
|
|
|
Preferred DNS servers. See \fICURLOPT_DNS_SERVERS(3)\fP
|
2018-03-17 15:10:04 -04:00
|
|
|
.IP CURLOPT_DNS_SHUFFLE_ADDRESSES
|
|
|
|
|
Shuffle addresses before use. See \fICURLOPT_DNS_SHUFFLE_ADDRESSES(3)\fP
|
2012-01-21 18:00:55 -05:00
|
|
|
.IP CURLOPT_ACCEPTTIMEOUT_MS
|
2014-06-21 09:45:50 -04:00
|
|
|
Timeout for waiting for the server's connect back to be accepted. See \fICURLOPT_ACCEPTTIMEOUT_MS(3)\fP
|
2018-02-21 15:16:50 -05:00
|
|
|
.IP CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS
|
|
|
|
|
Timeout for happy eyeballs. See \fICURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS(3)\fP
|
2018-09-07 04:28:57 -04:00
|
|
|
.IP CURLOPT_UPKEEP_INTERVAL_MS
|
2018-04-18 11:40:17 -04:00
|
|
|
Sets the interval at which connection upkeep are performed. See
|
2018-09-07 04:28:57 -04:00
|
|
|
\fICURLOPT_UPKEEP_INTERVAL_MS(3)\fP
|
2002-09-18 11:26:42 -04:00
|
|
|
.SH SSL and SECURITY OPTIONS
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_SSLCERT
|
2014-06-21 09:45:50 -04:00
|
|
|
Client cert. See \fICURLOPT_SSLCERT(3)\fP
|
2016-11-16 12:49:15 -05:00
|
|
|
.IP CURLOPT_PROXY_SSLCERT
|
|
|
|
|
Proxy client cert. See \fICURLOPT_PROXY_SSLCERT(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_SSLCERTTYPE
|
2014-06-21 09:45:50 -04:00
|
|
|
Client cert type. See \fICURLOPT_SSLCERTTYPE(3)\fP
|
2016-11-16 12:49:15 -05:00
|
|
|
.IP CURLOPT_PROXY_SSLCERTTYPE
|
|
|
|
|
Proxy client cert type. See \fICURLOPT_PROXY_SSLCERTTYPE(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_SSLKEY
|
2014-06-21 09:45:50 -04:00
|
|
|
Client key. See \fICURLOPT_SSLKEY(3)\fP
|
2016-11-16 12:49:15 -05:00
|
|
|
.IP CURLOPT_PROXY_SSLKEY
|
|
|
|
|
Proxy client key. See \fICURLOPT_PROXY_SSLKEY(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_SSLKEYTYPE
|
2014-06-21 09:45:50 -04:00
|
|
|
Client key type. See \fICURLOPT_SSLKEYTYPE(3)\fP
|
2016-11-16 12:49:15 -05:00
|
|
|
.IP CURLOPT_PROXY_SSLKEYTYPE
|
|
|
|
|
Proxy client key type. See \fICURLOPT_PROXY_SSLKEYTYPE(3)\fP
|
2007-08-30 16:34:57 -04:00
|
|
|
.IP CURLOPT_KEYPASSWD
|
2014-06-21 09:45:50 -04:00
|
|
|
Client key password. See \fICURLOPT_KEYPASSWD(3)\fP
|
2016-11-16 12:49:15 -05:00
|
|
|
.IP CURLOPT_PROXY_KEYPASSWD
|
|
|
|
|
Proxy client key password. See \fICURLOPT_PROXY_KEYPASSWD(3)\fP
|
2014-02-11 01:44:27 -05:00
|
|
|
.IP CURLOPT_SSL_ENABLE_ALPN
|
2014-06-21 09:45:50 -04:00
|
|
|
Enable use of ALPN. See \fICURLOPT_SSL_ENABLE_ALPN(3)\fP
|
2014-02-11 01:44:27 -05:00
|
|
|
.IP CURLOPT_SSL_ENABLE_NPN
|
2014-10-30 18:40:05 -04:00
|
|
|
Enable use of NPN. See \fICURLOPT_SSL_ENABLE_NPN(3)\fP
|
2004-02-27 04:02:06 -05:00
|
|
|
.IP CURLOPT_SSLENGINE
|
2014-06-21 09:45:50 -04:00
|
|
|
Use identifier with SSL engine. See \fICURLOPT_SSLENGINE(3)\fP
|
2004-02-27 04:02:06 -05:00
|
|
|
.IP CURLOPT_SSLENGINE_DEFAULT
|
2014-06-21 09:45:50 -04:00
|
|
|
Default SSL engine. See \fICURLOPT_SSLENGINE_DEFAULT(3)\fP
|
2015-02-14 10:57:07 -05:00
|
|
|
.IP CURLOPT_SSL_FALSESTART
|
|
|
|
|
Enable TLS False Start. See \fICURLOPT_SSL_FALSESTART(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_SSLVERSION
|
2014-06-21 09:45:50 -04:00
|
|
|
SSL version to use. See \fICURLOPT_SSLVERSION(3)\fP
|
2016-11-16 12:49:15 -05:00
|
|
|
.IP CURLOPT_PROXY_SSLVERSION
|
|
|
|
|
Proxy SSL version to use. See \fICURLOPT_PROXY_SSLVERSION(3)\fP
|
2015-03-06 11:07:28 -05:00
|
|
|
.IP CURLOPT_SSL_VERIFYHOST
|
|
|
|
|
Verify the host name in the SSL certificate. See \fICURLOPT_SSL_VERIFYHOST(3)\fP
|
2016-11-16 12:49:15 -05:00
|
|
|
.IP CURLOPT_PROXY_SSL_VERIFYHOST
|
|
|
|
|
Verify the host name in the proxy SSL certificate. See \fICURLOPT_PROXY_SSL_VERIFYHOST(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_SSL_VERIFYPEER
|
2014-06-21 09:45:50 -04:00
|
|
|
Verify the SSL certificate. See \fICURLOPT_SSL_VERIFYPEER(3)\fP
|
2016-11-16 12:49:15 -05:00
|
|
|
.IP CURLOPT_PROXY_SSL_VERIFYPEER
|
|
|
|
|
Verify the proxy SSL certificate. See \fICURLOPT_PROXY_SSL_VERIFYPEER(3)\fP
|
2015-03-06 11:07:28 -05:00
|
|
|
.IP CURLOPT_SSL_VERIFYSTATUS
|
|
|
|
|
Verify the SSL certificate's status. See \fICURLOPT_SSL_VERIFYSTATUS(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_CAINFO
|
2014-06-21 09:45:50 -04:00
|
|
|
CA cert bundle. See \fICURLOPT_CAINFO(3)\fP
|
2016-11-16 12:49:15 -05:00
|
|
|
.IP CURLOPT_PROXY_CAINFO
|
|
|
|
|
Proxy CA cert bundle. See \fICURLOPT_PROXY_CAINFO(3)\fP
|
2008-06-06 16:52:32 -04:00
|
|
|
.IP CURLOPT_ISSUERCERT
|
2014-06-21 09:45:50 -04:00
|
|
|
Issuer certificate. See \fICURLOPT_ISSUERCERT(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_CAPATH
|
2014-06-21 09:45:50 -04:00
|
|
|
Path to CA cert bundle. See \fICURLOPT_CAPATH(3)\fP
|
2016-11-16 12:49:15 -05:00
|
|
|
.IP CURLOPT_PROXY_CAPATH
|
|
|
|
|
Path to proxy CA cert bundle. See \fICURLOPT_PROXY_CAPATH(3)\fP
|
2008-06-06 14:40:21 -04:00
|
|
|
.IP CURLOPT_CRLFILE
|
2014-06-21 09:45:50 -04:00
|
|
|
Certificate Revocation List. See \fICURLOPT_CRLFILE(3)\fP
|
2016-11-16 12:49:15 -05:00
|
|
|
.IP CURLOPT_PROXY_CRLFILE
|
|
|
|
|
Proxy Certificate Revocation List. See \fICURLOPT_PROXY_CRLFILE(3)\fP
|
2011-01-19 06:54:17 -05:00
|
|
|
.IP CURLOPT_CERTINFO
|
2014-06-21 14:43:04 -04:00
|
|
|
Extract certificate info. See \fICURLOPT_CERTINFO(3)\fP
|
2014-11-06 04:14:33 -05:00
|
|
|
.IP CURLOPT_PINNEDPUBLICKEY
|
|
|
|
|
Set pinned SSL public key . See \fICURLOPT_PINNEDPUBLICKEY(3)\fP
|
2016-11-25 08:17:22 -05:00
|
|
|
.IP CURLOPT_PROXY_PINNEDPUBLICKEY
|
|
|
|
|
Set the proxy's pinned SSL public key. See
|
|
|
|
|
\fICURLOPT_PROXY_PINNEDPUBLICKEY(3)\fP
|
2011-01-19 06:54:17 -05:00
|
|
|
.IP CURLOPT_RANDOM_FILE
|
2014-06-21 09:45:50 -04:00
|
|
|
Provide source for entropy random data. See \fICURLOPT_RANDOM_FILE(3)\fP
|
2011-01-19 06:54:17 -05:00
|
|
|
.IP CURLOPT_EGDSOCKET
|
2014-06-21 09:45:50 -04:00
|
|
|
Identify EGD socket for entropy. See \fICURLOPT_EGDSOCKET(3)\fP
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_SSL_CIPHER_LIST
|
2014-06-21 09:45:50 -04:00
|
|
|
Ciphers to use. See \fICURLOPT_SSL_CIPHER_LIST(3)\fP
|
2016-11-16 12:49:15 -05:00
|
|
|
.IP CURLOPT_PROXY_SSL_CIPHER_LIST
|
|
|
|
|
Proxy ciphers to use. See \fICURLOPT_PROXY_SSL_CIPHER_LIST(3)\fP
|
2018-05-29 10:12:52 -04:00
|
|
|
.IP CURLOPT_TLS13_CIPHERS
|
|
|
|
|
TLS 1.3 cipher suites to use. See \fICURLOPT_TLS13_CIPHERS(3)\fP
|
|
|
|
|
.IP CURLOPT_PROXY_TLS13_CIPHERS
|
|
|
|
|
Proxy TLS 1.3 cipher suites to use. See \fICURLOPT_PROXY_TLS13_CIPHERS(3)\fP
|
2006-09-11 13:18:18 -04:00
|
|
|
.IP CURLOPT_SSL_SESSIONID_CACHE
|
2014-06-21 09:45:50 -04:00
|
|
|
Disable SSL session-id cache. See \fICURLOPT_SSL_SESSIONID_CACHE(3)\fP
|
2012-02-06 16:12:06 -05:00
|
|
|
.IP CURLOPT_SSL_OPTIONS
|
2014-06-21 09:45:50 -04:00
|
|
|
Control SSL behavior. See \fICURLOPT_SSL_OPTIONS(3)\fP
|
2016-11-16 12:49:15 -05:00
|
|
|
.IP CURLOPT_PROXY_SSL_OPTIONS
|
|
|
|
|
Control proxy SSL behavior. See \fICURLOPT_PROXY_SSL_OPTIONS(3)\fP
|
2007-07-01 18:01:18 -04:00
|
|
|
.IP CURLOPT_KRBLEVEL
|
2014-06-21 09:45:50 -04:00
|
|
|
Kerberos security level. See \fICURLOPT_KRBLEVEL(3)\fP
|
2011-07-19 13:10:43 -04:00
|
|
|
.IP CURLOPT_GSSAPI_DELEGATION
|
2014-06-21 09:45:50 -04:00
|
|
|
Disable GSS-API delegation. See \fICURLOPT_GSSAPI_DELEGATION(3)\fP
|
2006-11-02 17:10:18 -05:00
|
|
|
.SH SSH OPTIONS
|
|
|
|
|
.IP CURLOPT_SSH_AUTH_TYPES
|
2014-06-21 09:45:50 -04:00
|
|
|
SSH authentication types. See \fICURLOPT_SSH_AUTH_TYPES(3)\fP
|
2017-08-05 05:26:04 -04:00
|
|
|
.IP CURLOPT_SSH_COMPRESSION
|
|
|
|
|
Enable SSH compression. See \fICURLOPT_SSH_COMPRESSION(3)\fP
|
2007-10-03 04:00:42 -04:00
|
|
|
.IP CURLOPT_SSH_HOST_PUBLIC_KEY_MD5
|
2014-06-21 09:45:50 -04:00
|
|
|
MD5 of host's public key. See \fICURLOPT_SSH_HOST_PUBLIC_KEY_MD5(3)\fP
|
2006-11-02 17:10:18 -05:00
|
|
|
.IP CURLOPT_SSH_PUBLIC_KEYFILE
|
2014-06-21 09:45:50 -04:00
|
|
|
File name of public key. See \fICURLOPT_SSH_PUBLIC_KEYFILE(3)\fP
|
2006-11-02 17:10:18 -05:00
|
|
|
.IP CURLOPT_SSH_PRIVATE_KEYFILE
|
2014-06-21 09:45:50 -04:00
|
|
|
File name of private key. See \fICURLOPT_SSH_PRIVATE_KEYFILE(3)\fP
|
2009-07-22 18:49:01 -04:00
|
|
|
.IP CURLOPT_SSH_KNOWNHOSTS
|
2014-06-21 09:45:50 -04:00
|
|
|
File name with known hosts. See \fICURLOPT_SSH_KNOWNHOSTS(3)\fP
|
2009-07-22 18:49:01 -04:00
|
|
|
.IP CURLOPT_SSH_KEYFUNCTION
|
2014-06-21 09:45:50 -04:00
|
|
|
Callback for known hosts handling. See \fICURLOPT_SSH_KEYFUNCTION(3)\fP
|
2009-07-22 18:49:01 -04:00
|
|
|
.IP CURLOPT_SSH_KEYDATA
|
2014-06-21 09:45:50 -04:00
|
|
|
Custom pointer to pass to ssh key callback. See \fICURLOPT_SSH_KEYDATA(3)\fP
|
2002-11-20 14:11:22 -05:00
|
|
|
.SH OTHER OPTIONS
|
2003-11-04 07:55:53 -05:00
|
|
|
.IP CURLOPT_PRIVATE
|
2014-06-21 09:45:50 -04:00
|
|
|
Private pointer to store. See \fICURLOPT_PRIVATE(3)\fP
|
2004-02-25 07:20:41 -05:00
|
|
|
.IP CURLOPT_SHARE
|
2014-06-21 09:45:50 -04:00
|
|
|
Share object to use. See \fICURLOPT_SHARE(3)\fP
|
2007-06-27 16:15:48 -04:00
|
|
|
.IP CURLOPT_NEW_FILE_PERMS
|
2014-06-21 09:45:50 -04:00
|
|
|
Mode for creating new remote files. See \fICURLOPT_NEW_FILE_PERMS(3)\fP
|
2007-06-27 16:15:48 -04:00
|
|
|
.IP CURLOPT_NEW_DIRECTORY_PERMS
|
2014-10-30 18:40:05 -04:00
|
|
|
Mode for creating new remote directories. See \fICURLOPT_NEW_DIRECTORY_PERMS(3)\fP
|
2004-02-27 04:02:06 -05:00
|
|
|
.SH TELNET OPTIONS
|
|
|
|
|
.IP CURLOPT_TELNETOPTIONS
|
2014-06-21 09:45:50 -04:00
|
|
|
TELNET options. See \fICURLOPT_TELNETOPTIONS(3)\fP
|
2002-03-04 05:09:48 -05:00
|
|
|
.SH RETURN VALUE
|
2014-06-25 16:30:36 -04:00
|
|
|
\fICURLE_OK\fP (zero) means that the option was set properly, non-zero means an
|
2004-02-27 10:34:06 -05:00
|
|
|
error occurred as \fI<curl/curl.h>\fP defines. See the \fIlibcurl-errors(3)\fP
|
2002-04-12 07:39:27 -04:00
|
|
|
man page for the full list with descriptions.
|
2004-06-03 07:19:35 -04:00
|
|
|
|
|
|
|
|
If you try to set an option that libcurl doesn't know about, perhaps because
|
|
|
|
|
the library is too old to support it or the option was removed in a recent
|
2014-06-25 16:30:36 -04:00
|
|
|
version, this function will return \fICURLE_UNKNOWN_OPTION\fP. If support for
|
|
|
|
|
the option was disabled at compile-time, it will return
|
|
|
|
|
\fICURLE_NOT_BUILT_IN\fP.
|
2014-11-25 08:25:02 -05:00
|
|
|
.SH EXAMPLE
|
|
|
|
|
.nf
|
|
|
|
|
CURL *curl = curl_easy_init();
|
|
|
|
|
if(curl) {
|
|
|
|
|
CURLcode res;
|
|
|
|
|
curl_easy_setopt(curl, CURLOPT_URL, "http://example.com");
|
|
|
|
|
res = curl_easy_perform(curl);
|
|
|
|
|
curl_easy_cleanup(curl);
|
2015-08-24 23:49:01 -04:00
|
|
|
}
|
2014-11-25 08:25:02 -05:00
|
|
|
.fi
|
2002-03-04 05:09:48 -05:00
|
|
|
.SH "SEE ALSO"
|
2014-10-21 04:26:40 -04:00
|
|
|
.BR curl_easy_init "(3), " curl_easy_cleanup "(3), " curl_easy_reset "(3), "
|
2015-08-31 10:03:53 -04:00
|
|
|
.BR curl_easy_getinfo "(3), " curl_multi_setopt "(3), "
|
